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: Fri, 28 May 2004 09:28:59 +0200 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <20040528092401.752F.JMBARRANQUERO@wke.es> References: <20040527152017.0849.JMBARRANQUERO@wke.es> <3099-Thu27May2004202140+0300-eliz@gnu.org> 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 1085732824 4189 80.91.224.253 (28 May 2004 08:27:04 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 28 May 2004 08:27:04 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Fri May 28 10:26:51 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 1BTchX-0004J2-00 for ; Fri, 28 May 2004 10:26:51 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1BTchW-0000qK-00 for ; Fri, 28 May 2004 10:26:50 +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 1BTcgP-0008CL-Rx for emacs-devel@quimby.gnus.org; Fri, 28 May 2004 04:25:41 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.34) id 1BTcgA-0008Bn-SB for emacs-devel@gnu.org; Fri, 28 May 2004 04:25:26 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.34) id 1BTcfe-000874-Nw for emacs-devel@gnu.org; Fri, 28 May 2004 04:25:25 -0400 Original-Received: from [62.22.181.117] (helo=idefix.laley.net) by monty-python.gnu.org with esmtp (Exim 4.34) id 1BTbnY-0007qH-32; Fri, 28 May 2004 03:29:10 -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 LSNJZ3ZH; Fri, 28 May 2004 09:28:50 +0200 Original-To: "Eli Zaretskii" In-Reply-To: <3099-Thu27May2004202140+0300-eliz@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:24063 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:24063 On Thu, 27 May 2004 20:21:41 +0200 "Eli Zaretskii" wrote: > They don't need to be identical: once a port overloads the standard > definition with another one, the doc string is replaced as well. That was my thinking too, but I think Kai's got a point. > 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. I think for the local versions it'll be better to do what Stefan suggests: a generic part and a specific one. The default one seems already right. > > 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, That's what "converting directory separatos to the Windows style" was meant to suggest ;) > with a reference to w32-shell-dos-semantics. Good idea. Juanma