From: Juanma Barranquero <jmbarranquero@wke.es>
Subject: convert-standard-filename's doc
Date: Thu, 27 May 2004 16:05:36 +0200 [thread overview]
Message-ID: <20040527152017.0849.JMBARRANQUERO@wke.es> (raw)
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
"Convert a standard file's name to something suitable for the current OS.
This function's standard definition is trivial; it just returns the argument.
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."
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:
"Convert a standard file's name to something suitable for Windows.
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."
(and add also a suitable docstring for the dos-fns.el version, of course).
Juanma
next reply other threads:[~2004-05-27 14:05 UTC|newest]
Thread overview: 27+ messages / expand[flat|nested] mbox.gz Atom feed top
2004-05-27 14:05 Juanma Barranquero [this message]
2004-05-27 18:21 ` convert-standard-filename's doc Eli Zaretskii
2004-05-27 22:19 ` Stefan Monnier
2004-05-28 9:02 ` Eli Zaretskii
2004-05-28 16:19 ` Stefan Monnier
2004-05-29 11:40 ` Eli Zaretskii
2004-05-28 9:27 ` Juanma Barranquero
2004-05-28 13:51 ` Kai Grossjohann
2004-05-28 18:26 ` Juanma Barranquero
2004-05-29 11:13 ` Kai Grossjohann
2004-05-29 14:24 ` Eli Zaretskii
2004-05-29 14:47 ` Kai Grossjohann
2004-05-29 17:55 ` Juanma Barranquero
2004-05-30 21:53 ` {Spam?} " Stefan Monnier
2004-05-31 7:05 ` Eli Zaretskii
2004-05-31 7:39 ` Juanma Barranquero
2004-05-29 12:08 ` Eli Zaretskii
2004-05-28 16:21 ` Stefan Monnier
2004-05-29 0:49 ` Juanma Barranquero
2004-05-29 17:02 ` Richard Stallman
2004-05-29 17:56 ` Juanma Barranquero
2004-05-29 11:18 ` Kai Grossjohann
2004-05-30 14:30 ` Richard Stallman
2004-05-28 7:28 ` Juanma Barranquero
2004-05-29 10:16 ` Eli Zaretskii
2004-05-28 5:22 ` Kai Grossjohann
2004-05-28 9:32 ` Juanma Barranquero
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.gnu.org/software/emacs/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20040527152017.0849.JMBARRANQUERO@wke.es \
--to=jmbarranquero@wke.es \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).