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