Re: convert-standard-filename's doc

[Juanma Barranquero <jmbarranquero@wke.es>]

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