From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: "Eli Zaretskii" Newsgroups: gmane.emacs.devel Subject: Re: convert-standard-filename's doc Date: Sat, 29 May 2004 14:08:17 +0200 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <9743-Sat29May2004140817+0300-eliz@gnu.org> References: <20040528092904.7532.JMBARRANQUERO@wke.es> <86k6ywk6co.fsf@rumba.de.uu.net> <20040528200923.5B69.LEKTU@mi.madritel.es> Reply-To: Eli Zaretskii NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1085833742 9025 80.91.224.253 (29 May 2004 12:29:02 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 29 May 2004 12:29:02 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Sat May 29 14:28:54 2004 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1BU2xK-0004up-00 for ; Sat, 29 May 2004 14:28:54 +0200 Original-Received: from lists.gnu.org ([199.232.76.165]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1BU2xK-0004rz-00 for ; Sat, 29 May 2004 14:28:54 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1BU2xP-0002yG-1n for emacs-devel@quimby.gnus.org; Sat, 29 May 2004 08:28:59 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1BU2xJ-0002uh-Gq for emacs-devel@gnu.org; Sat, 29 May 2004 08:28:53 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1BU2xG-0002sv-8B for emacs-devel@gnu.org; Sat, 29 May 2004 08:28:52 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1BU2xG-0002sW-5f for emacs-devel@gnu.org; Sat, 29 May 2004 08:28:50 -0400 Original-Received: from [192.114.186.23] (helo=aragorn.inter.net.il) by monty-python.gnu.org with esmtp (Exim 4.34) id 1BU2wf-0001Z8-TZ for emacs-devel@gnu.org; Sat, 29 May 2004 08:28:14 -0400 Original-Received: from zaretski ([80.230.144.7]) by aragorn.inter.net.il (MOS 3.4.6-GR) with ESMTP id CZB53021; Sat, 29 May 2004 14:10:16 +0300 (IDT) Original-To: Juanma Barranquero X-Mailer: emacs 21.3.50 (via feedmail 8 I) and Blat ver 1.8.9 In-reply-to: <20040528200923.5B69.LEKTU@mi.madritel.es> (message from Juanma Barranquero on Fri, 28 May 2004 20:26:12 +0200) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.4 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:24161 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:24161 > Date: Fri, 28 May 2004 20:26:12 +0200 > From: Juanma Barranquero > > Doing what you suggest means a longish docstring with much non-useful > info (non-useful for each system's users, I mean), and fixing all > versions of the docstring each time one of the functions is changed or a > new system added. We could have a short version in the doc string and a longer one in the manual. In any case, I think Kai is right saying that the doc string should give more emphasis to the fact that the function makes the file name a valid one for the underlying platform.