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: Thu, 27 May 2004 20:21:41 +0200 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <3099-Thu27May2004202140+0300-eliz@gnu.org> References: <20040527152017.0849.JMBARRANQUERO@wke.es> Reply-To: Eli Zaretskii NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1085800414 19032 80.91.224.253 (29 May 2004 03:13:34 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 29 May 2004 03:13:34 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Sat May 29 05:13:28 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 1BTuHn-00037E-00 for ; Sat, 29 May 2004 05:13:27 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1BTuHn-0000t5-00 for ; Sat, 29 May 2004 05:13:27 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.34) id 1BTPZV-0001Fk-LX for emacs-devel@quimby.gnus.org; Thu, 27 May 2004 14:25:41 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.34) id 1BTPZ2-00018v-Lc for emacs-devel@gnu.org; Thu, 27 May 2004 14:25:12 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.34) id 1BTPYS-0000z3-16 for emacs-devel@gnu.org; Thu, 27 May 2004 14:25:08 -0400 Original-Received: from [192.114.186.23] (helo=aragorn.inter.net.il) by monty-python.gnu.org with esmtp (Exim 4.34) id 1BTPYR-0000yD-7y for emacs-devel@gnu.org; Thu, 27 May 2004 14:24:35 -0400 Original-Received: from zaretski (pns03-196-231.inter.net.il [80.230.196.231]) by aragorn.inter.net.il (MOS 3.4.6-GR) with ESMTP id CYO35359; Thu, 27 May 2004 20:23:35 +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: <20040527152017.0849.JMBARRANQUERO@wke.es> (message from Juanma Barranquero on Thu, 27 May 2004 16:05:36 +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:24122 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:24122 > Date: Thu, 27 May 2004 16:05:36 +0200 > From: Juanma Barranquero > > Four years ago, the docstring for convert-standard-filename (in files.el) > was changed, but the ones in w32-fns.el and dos-fns.el were not. > > Now, it's trivial to fix them to be identical again. They don't need to be identical: once a port overloads the standard definition with another one, the doc string is replaced as well. So we could have a doc string that describes what that function does on the specific platform where it runs. The default doc string should be left as it is now, IMHO. > In other words, I'd change the docstring for the w32-fns.el version to > read: > > "Convert a standard file's name to something suitable for Windows. > > Returns FILENAME after replacing invalid characters with ! and > converting directory separators to the Windows style (if needed). > It also turns Cygwin-style /cygdrive/x/ pathnames to x:/ paths." I think that's good, but I'd also mention the conversion of slashes to backslashes, with a reference to w32-shell-dos-semantics.