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 16:24:06 +0200 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <7704-Sat29May2004162405+0300-eliz@gnu.org> References: <20040528092904.7532.JMBARRANQUERO@wke.es> <86k6ywk6co.fsf@rumba.de.uu.net> <20040528200923.5B69.LEKTU@mi.madritel.es> <86y8nbpjt8.fsf@rumba.de.uu.net> Reply-To: Eli Zaretskii NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1085839011 19042 80.91.224.253 (29 May 2004 13:56:51 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 29 May 2004 13:56:51 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Sat May 29 15:56:40 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 1BU4KG-0008AY-00 for ; Sat, 29 May 2004 15:56:40 +0200 Original-Received: from lists.gnu.org ([199.232.76.165]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1BU4KF-0006pz-00 for ; Sat, 29 May 2004 15:56:39 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1BU4KK-0002VD-So for emacs-devel@quimby.gnus.org; Sat, 29 May 2004 09:56:44 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1BU4KI-0002Tf-J3 for emacs-devel@gnu.org; Sat, 29 May 2004 09:56:42 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1BU4KC-0002T3-1C for emacs-devel@gnu.org; Sat, 29 May 2004 09:56:42 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1BU4KB-0002T0-TS for emacs-devel@gnu.org; Sat, 29 May 2004 09:56:36 -0400 Original-Received: from [192.114.186.23] (helo=aragorn.inter.net.il) by monty-python.gnu.org with esmtp (Exim 4.34) id 1BU4JU-0007Ya-4a for emacs-devel@gnu.org; Sat, 29 May 2004 09:55:52 -0400 Original-Received: from zaretski ([80.230.144.7]) by aragorn.inter.net.il (MOS 3.4.6-GR) with ESMTP id CZB70253; Sat, 29 May 2004 16:26:05 +0300 (IDT) Original-To: Kai Grossjohann X-Mailer: emacs 21.3.50 (via feedmail 8 I) and Blat ver 1.8.9 In-reply-to: <86y8nbpjt8.fsf@rumba.de.uu.net> (message from Kai Grossjohann on Sat, 29 May 2004 13:13:55 +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:24167 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:24167 > From: Kai Grossjohann > Date: Sat, 29 May 2004 13:13:55 +0200 > > 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. This doc string is fine with me, except ``remove invalid characters'' is not quite true; ``replace'' is closer. Also, I would add an explicit reference to w32-shell-dos-semantics. So: 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, replace invalid characters. On DOS, make sure to obey the 8.3 limitations. On Windows, turn Cygwin names into native names, and also turn slashes into backslashes if the shell requires it (see `w32-shell-dos-semantics').