From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Luc Teirlinck Newsgroups: gmane.emacs.bugs Subject: Re: convert-standard-filename documentation is insufficient Date: Mon, 8 Nov 2004 15:58:22 -0600 (CST) Message-ID: <200411082158.iA8LwMZ11187@raven.dms.auburn.edu> NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1099951160 3864 80.91.229.6 (8 Nov 2004 21:59:20 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 8 Nov 2004 21:59:20 +0000 (UTC) Cc: bug-gnu-emacs@gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Nov 08 22:59:10 2004 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1CRHXZ-0002JN-00 for ; Mon, 08 Nov 2004 22:59:09 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CRHfw-00053q-G7 for geb-bug-gnu-emacs@m.gmane.org; Mon, 08 Nov 2004 17:07:48 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1CRHfu-00052a-EY for bug-gnu-emacs@gnu.org; Mon, 08 Nov 2004 17:07:46 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1CRHft-00052A-Iv for bug-gnu-emacs@gnu.org; Mon, 08 Nov 2004 17:07:45 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CRHft-000527-GQ for bug-gnu-emacs@gnu.org; Mon, 08 Nov 2004 17:07:45 -0500 Original-Received: from [131.204.53.104] (helo=manatee.dms.auburn.edu) by monty-python.gnu.org with esmtp (Exim 4.34) id 1CRHXR-0006R3-BP; Mon, 08 Nov 2004 16:59:01 -0500 Original-Received: from raven.dms.auburn.edu (raven.dms.auburn.edu [131.204.53.29]) by manatee.dms.auburn.edu (8.12.10/8.12.10) with ESMTP id iA8LwtFu024945; Mon, 8 Nov 2004 15:58:55 -0600 (CST) Original-Received: (from teirllm@localhost) by raven.dms.auburn.edu (8.11.7p1+Sun/8.11.7) id iA8LwMZ11187; Mon, 8 Nov 2004 15:58:22 -0600 (CST) X-Authentication-Warning: raven.dms.auburn.edu: teirllm set sender to teirllm@dms.auburn.edu using -f Original-To: Stefan Monnier X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: main.gmane.org gmane.emacs.bugs:9632 X-Report-Spam: http://spam.gmane.org/gmane.emacs.bugs:9632 Alternately, we could just put in a link to the Elisp manual. All the user has to do is click mouse-2 or press RETURN on the link. Also the first line needs to be shortened since it is 72 characters, 5 longer than the maximum allowed 67. I first suggested doing this by replacing `something' by `one'. An alternative is to delete "current" in front of OS. It is redundant. Which _other_ operating system could be meant? That would give: "Convert a standard file's name to something suitable for the OS. This means to guarantee valid names and perhaps to canonicalize certain patterns. This function's standard definition is trivial; it just returns the argument. However, 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' See `(elisp)Standard File Names' for more details." Sincerely, Luc.