Mercurial > emacs
changeset 36324:63c47fc9df21
(File Names): Add documentation of the tilde expansion in file names.
From Nelson H. F. Beebe <beebe@math.utah.edu>.
author | Eli Zaretskii <eliz@gnu.org> |
---|---|
date | Fri, 23 Feb 2001 11:23:10 +0000 |
parents | 7ecef0fc04b0 |
children | cf1b9eaadeaf |
files | man/files.texi |
diffstat | 1 files changed, 9 insertions(+), 1 deletions(-) [+] |
line wrap: on
line diff
--- a/man/files.texi Fri Feb 23 10:38:41 2001 +0000 +++ b/man/files.texi Fri Feb 23 11:23:10 2001 +0000 @@ -97,6 +97,8 @@ first slash in the double slash; the result is @samp{/x1/rms/foo}. @xref{Minibuffer File}. +@cindex environment variables in file names +@cindex expansion of environment variables @samp{$} in a file name is used to substitute environment variables. For example, if you have used the shell command @command{export FOO=rms/hacks} to set up an environment variable named @env{FOO}, then @@ -107,10 +109,16 @@ that shell commands to set environment variables affect Emacs only if done before Emacs is started. +@cindex home directory shorthand + You can use the @file{~/} in a file name to mean your home directory, +or @file{~@var{user-id}/} to mean the home directory of a user whose +login name is @code{user-id}. + To access a file with @samp{$} in its name, type @samp{$$}. This pair is converted to a single @samp{$} at the same time as variable substitution is performed for single @samp{$}. Alternatively, quote the -whole file name with @samp{/:} (@pxref{Quoted File Names}). +whole file name with @samp{/:} (@pxref{Quoted File Names}). File names +which begin with a literal @samp{~} should also be quoted with @samp{/:}. @findex substitute-in-file-name The Lisp function that performs the substitution is called