X-Git-Url: http://repo.macrolet.net/gitweb/?a=blobdiff_plain;f=doc%2Fmanual%2Fpathnames.texinfo;h=50c32607e6b0546a3778b4e5d4d735db0b902483;hb=4783db4884a231e8d217ce85feaa2c32a53ef6b9;hp=02687c8ef09fdfa28829a17f8dd794701d1340ab;hpb=2529c316d05494f2bcdeccf98c3a6298ecd08d7d;p=sbcl.git

diff --git a/doc/manual/pathnames.texinfo b/doc/manual/pathnames.texinfo
index 02687c8..50c3260 100644
--- a/doc/manual/pathnames.texinfo
+++ b/doc/manual/pathnames.texinfo
@@ -70,12 +70,30 @@ implementation-defined and so need documentation.
 @c * Other symbols and integers have implementation-defined meaning.
 @c   (19.2.2.4.6)
 
+@subsection Home Directory Specifiers
+
+SBCL accepts the keyword @code{:home} and a list of the form
+@code{(:home "username")} as a directory component immediately
+following @code{:absolute}.
+
+@code{:home} is represented in namestrings by @code{~/} and
+@code{(:home "username"} by @code{~username/} at the start of the
+namestring. Tilde-characters elsewhere in namestrings represent
+themselves.
+
+Home directory specifiers are resolved to home directory of the
+current or specified user by @code{native-namestring}, which is used
+by the implementation to translate pathnames before passing them on to
+operating system specific routines.
+
+Using @code{(:home "user")} form on Windows signals an error.
+
 @subsection The SYS Logical Pathname Host
 
 @cindex Logical pathnames
 @cindex Pathnames, logical
-@findex logical-pathname-translations
-@findex (setf logical-pathname-translations)
+@findex @cl{logical-pathname-translations}
+@findex @setf{@cl{logical-pathname-translations}}
 
 @c * The existence and meaning of SYS: logical pathnames is
 @c   implementation-defined.  (19.3.1.1.1)