emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: convert-standard-filename's doc


From: Juanma Barranquero
Subject: Re: convert-standard-filename's doc
Date: Fri, 28 May 2004 09:28:59 +0200

On Thu, 27 May 2004 20:21:41 +0200
"Eli Zaretskii" <address@hidden> 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






reply via email to

[Prev in Thread] Current Thread [Next in Thread]