Re: [PATCH] emacs: Remove syntactic sugar from docstring of convert-standard-filename

[Eli Zaretskii]

> From: Adrian Aichner <adrian@xemacs.org>
> Date: Mon, 31 May 2004 12:15:51 +0200
> 
> I'd like to offer this little simplification.

Thanks, but this simplifies too much, IMHO:

> -  "Convert a standard file's name to something suitable for the current OS.
> +  "Convert a file's standard name to something suitable for the current OS.

We do mean to say "a name of a standard file", not "a standard name
of a file".  Here, ``standard file'' means a file whose name is
referenced verbatim in the Emacs sources.  An example is "~/.emacs".

> -However, on some systems, the function is redefined with a definition
> -that really does change some file names to canonicalize certain
> -patterns and to guarantee valid names."
> +However, on some systems, the function canonicalizes certain
> + patterns to guarantee valid names."

The function actually does both: it both canonicalizes certain
patterns and does additional changes to guarantee valid file names.