From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Juanma Barranquero Newsgroups: gmane.emacs.devel Subject: Re: convert-standard-filename's doc Date: Sat, 29 May 2004 19:55:52 +0200 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <20040529194813.6952.LEKTU@mi.madritel.es> References: <20040528200923.5B69.LEKTU@mi.madritel.es> <86y8nbpjt8.fsf@rumba.de.uu.net> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="US-ASCII" Content-Transfer-Encoding: 7bit X-Trace: sea.gmane.org 1085853385 17723 80.91.224.253 (29 May 2004 17:56:25 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 29 May 2004 17:56:25 +0000 (UTC) Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Sat May 29 19:56:20 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 1BU84C-00013H-00 for ; Sat, 29 May 2004 19:56:20 +0200 Original-Received: from lists.gnu.org ([199.232.76.165]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1BU84B-0003RZ-00 for ; Sat, 29 May 2004 19:56:20 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1BU84H-0000Q8-Lp for emacs-devel@quimby.gnus.org; Sat, 29 May 2004 13:56:25 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1BU84E-0000Pk-Ut for emacs-devel@gnu.org; Sat, 29 May 2004 13:56:23 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1BU84E-0000PR-4J for emacs-devel@gnu.org; Sat, 29 May 2004 13:56:22 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1BU84E-0000PO-20 for emacs-devel@gnu.org; Sat, 29 May 2004 13:56:22 -0400 Original-Received: from [62.81.186.18] (helo=smtp08.retemail.es) by monty-python.gnu.org with esmtp (Exim 4.34) id 1BU83k-0005Q9-TS for emacs-devel@gnu.org; Sat, 29 May 2004 13:55:53 -0400 Original-Received: from [127.0.0.1] ([213.37.34.123]) by smtp08.retemail.es (InterMail vM.5.01.05.32 201-253-122-126-132-20030307) with ESMTP id <20040529175551.JLMR1181.smtp08.retemail.es@[127.0.0.1]> for ; Sat, 29 May 2004 19:55:51 +0200 Original-To: emacs-devel@gnu.org In-Reply-To: <86y8nbpjt8.fsf@rumba.de.uu.net> X-Mailer: Becky! ver. 2.09.01 [en] 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:24189 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:24189 On Sat, 29 May 2004 13:13:55 +0200, Kai Grossjohann wrote: > Hm. Now I've taken a look at the different definitions. What do you > think about the following docstring? > > Convert a standard file's name to something suitable for the current OS. > This means to guarantee valid names and perhaps to canonicalize certain > patterns. > > On Windows and DOS, remove invalid characters. On DOS, make sure to > obey the 8.3 format. On Windows, turn Cygwin names into native > names, and also turn slashes into backslashes if the shell requires it. I honestly don't like a function with three different implementations having the same docstring explaining its funcionality in every posible environment. Yes, I agree the first bit (the first two sentences) should be in all them. But after that I would add just valid info. On most cases, when I'm going to use a funcion on a Windows Emacs, I'm interested on what it does, not what it would do, were I to use it on GNU/Linux (or any other present or future environment)... BTW, shouldn't it mention that on DOS it strips trailing (back)?slashes and converts a leading . into _? It doesn't do these things on Windows. /L/e/k/t/u