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: convert-standard-filename's doc Date: Thu, 27 May 2004 16:05:36 +0200 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <20040527152017.0849.JMBARRANQUERO@wke.es> 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 1085667073 26769 80.91.224.253 (27 May 2004 14:11:13 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 27 May 2004 14:11:13 +0000 (UTC) Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Thu May 27 16:10:52 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 1BTLau-0000dU-00 for ; Thu, 27 May 2004 16:10:52 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1BTLat-0001Tx-00 for ; Thu, 27 May 2004 16:10:52 +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 1BTLWx-0002kG-N4 for emacs-devel@quimby.gnus.org; Thu, 27 May 2004 10:06:47 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.34) id 1BTLWN-0002jm-0i for emacs-devel@gnu.org; Thu, 27 May 2004 10:06:11 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.34) id 1BTLVq-0002ei-0z for emacs-devel@gnu.org; Thu, 27 May 2004 10:06:10 -0400 Original-Received: from [62.22.181.117] (helo=idefix.laley.net) by monty-python.gnu.org with esmtp (Exim 4.34) id 1BTLVp-0002eE-DE for emacs-devel@gnu.org; Thu, 27 May 2004 10:05:37 -0400 Original-Received: from [172.17.221.23] (jsredondo.wk.org [172.17.221.23]) by idefix.laley.net with SMTP (Microsoft Exchange Internet Mail Service Version 5.5.2655.55) id LSNJZKZ9; Thu, 27 May 2004 16:05:30 +0200 Original-To: emacs-devel@gnu.org X-Mailer: Becky! ver. 2.08.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:24019 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:24019 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. But I wonder whether "Convert a standard file's name to something suitable for the current OS. This function's standard definition is trivial; it just returns the argument. However, on some systems, the function is redefined with a definition that really does change some file names to canonicalize certain patterns and to guarantee valid names." is a good description for a function which really *does* something. 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." (and add also a suitable docstring for the dos-fns.el version, of course). Juanma