[PATCH 21.5] #'expand-file-name documentation
Marcus Harnisch <[email protected]> Tue, 21 Jul 2015 21:45:24 +0200
| Newsgroups | gmane.emacs.xemacs.patches |
|---|---|
| Message-ID | <[email protected]> |
Hi all As discussed on xemacs-beta, here a proposal for a doc string fix to get things going. Best regards Marcus diff -r cb65bfaf7110 src/ChangeLog --- a/src/ChangeLog Fri Mar 27 16:05:15 2015 +0100 +++ b/src/ChangeLog Tue Jul 21 21:44:04 2015 +0200 @@ -1,3 +1,8 @@ +2015-07-21 Marcus Harnisch <[email protected]> + + * fileio.c (expand-file-name): Document behavior for + file names that expand to locations above (outside) `/' + 2015-06-22 Michael Sperber <[email protected]> * redisplay-xlike-inc.c (XFT_FROB_LISP_COLOR): Use diff -r cb65bfaf7110 src/fileio.c --- a/src/fileio.c Fri Mar 27 16:05:15 2015 +0100 +++ b/src/fileio.c Tue Jul 21 21:44:04 2015 +0200 @@ -721,6 +721,10 @@ file names in the file system. An initial `~/' expands to your home directory. An initial `~USER/' expands to USER's home directory. +Behavior with file names that expand to locations above (outside) `/' +via parent reference `..' is not well specified and returned results +could be considered unintuitive. It is normally easy to work around +this limitation at application level. See also the function `substitute-in-file-name'. */ (name, default_directory))