Re: convert-standard-filename's doc

[Eli Zaretskii]

> From: Kai Grossjohann <address@hidden>
> Date: Sat, 29 May 2004 13:13:55 +0200
> 
>     Convert a standard file's name to something suitable for the current OS.
>     This means to guarantee valid names and perhaps to canonicalize certain
>     patterns.
> 
>     On Windows and DOS, remove invalid characters.  On DOS, make sure to
>     obey the 8.3 format.  On Windows, turn Cygwin names into native
>     names, and also turn slashes into backslashes if the shell requires it.

This doc string is fine with me, except ``remove invalid characters''
is not quite true; ``replace'' is closer.  Also, I would add an
explicit reference to w32-shell-dos-semantics.  So:

    Convert a standard file's name to something suitable for the current OS.
    This means to guarantee valid names and perhaps to canonicalize certain
    patterns.

    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').