From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Kai Grossjohann Newsgroups: gmane.emacs.devel Subject: Re: convert-standard-filename's doc Date: Fri, 28 May 2004 07:22:25 +0200 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <86u0y1nn1q.fsf@rumba.de.uu.net> References: <20040527152017.0849.JMBARRANQUERO@wke.es> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1085728766 27347 80.91.224.253 (28 May 2004 07:19:26 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 28 May 2004 07:19:26 +0000 (UTC) Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Fri May 28 09:19:20 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 1BTbeC-0000Tq-00 for ; Fri, 28 May 2004 09:19:20 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1BTbeC-0007nW-00 for ; Fri, 28 May 2004 09:19:20 +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 1BTa0s-0005jU-AY for emacs-devel@quimby.gnus.org; Fri, 28 May 2004 01:34:38 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.34) id 1BTa0L-0005ir-JR for emacs-devel@gnu.org; Fri, 28 May 2004 01:34:05 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.34) id 1BTZpD-00046S-7f for emacs-devel@gnu.org; Fri, 28 May 2004 01:23:07 -0400 Original-Received: from [80.91.224.249] (helo=main.gmane.org) by monty-python.gnu.org with esmtp (Exim 4.34) id 1BTZpC-00045b-5A for emacs-devel@gnu.org; Fri, 28 May 2004 01:22:34 -0400 Original-Received: from list by main.gmane.org with local (Exim 3.35 #1 (Debian)) id 1BTZpA-0002Eg-00 for ; Fri, 28 May 2004 07:22:32 +0200 Original-Received: from 139.4.37.213 ([139.4.37.213]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Fri, 28 May 2004 07:22:32 +0200 Original-Received: from kai by 139.4.37.213 with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Fri, 28 May 2004 07:22:32 +0200 X-Injected-Via-Gmane: http://gmane.org/ Original-To: emacs-devel@gnu.org Original-Lines: 22 Original-X-Complaints-To: usenet@sea.gmane.org X-Gmane-NNTP-Posting-Host: 139.4.37.213 User-Agent: Gnus/5.110003 (No Gnus v0.3) Emacs/21.3.50 (gnu/linux) Cancel-Lock: sha1:UC1hTOmkxskvgfEgvd+rBEDjH7M= 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:24060 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:24060 Juanma Barranquero writes: > 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 [...] > 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: [...] If I was working on Windows and wanted to develop some Lisp that work on Unix, and if I would read your Windows description, then I'd think that I don't want to call this function unconditionally, since Unix users will not want /cygdrive/foo thingies replaced. That's the wrong message, I think. Can you make it clear(er?) that this function is meant to be called unconditionally and will DTRT on each system? Kai