Mercurial > emacs
comparison src/fileio.c @ 98782:05eaa923b9eb
(Fexpand_file_name): Doc fix.
author | Chong Yidong <cyd@stupidchicken.com> |
---|---|
date | Thu, 16 Oct 2008 17:59:34 +0000 |
parents | 29ea4287708c |
children | 08f66a1134d9 |
comparison
equal
deleted
inserted
replaced
98781:33743665b315 | 98782:05eaa923b9eb |
---|---|
817 so are file name components followed by `..', along with the `..' itself; | 817 so are file name components followed by `..', along with the `..' itself; |
818 note that these simplifications are done without checking the resulting | 818 note that these simplifications are done without checking the resulting |
819 file names in the file system. | 819 file names in the file system. |
820 An initial `~/' expands to your home directory. | 820 An initial `~/' expands to your home directory. |
821 An initial `~USER/' expands to USER's home directory. | 821 An initial `~USER/' expands to USER's home directory. |
822 See also the function `substitute-in-file-name'. */) | 822 See also the function `substitute-in-file-name'. |
823 | |
824 For technical reasons, this function can return correct but | |
825 non-intuitive results for the root directory; for instance, | |
826 \(expand-file-name ".." "/") returns "/..". For this reason, use | |
827 (directory-file-name (file-name-directory dirname)) to traverse a | |
828 filesystem tree, not (expand-file-name ".." dirname). */) | |
823 (name, default_directory) | 829 (name, default_directory) |
824 Lisp_Object name, default_directory; | 830 Lisp_Object name, default_directory; |
825 { | 831 { |
826 /* These point to SDATA and need to be careful with string-relocation | 832 /* These point to SDATA and need to be careful with string-relocation |
827 during GC (via DECODE_FILE). */ | 833 during GC (via DECODE_FILE). */ |