X-Git-Url: http://repo.macrolet.net/gitweb/?a=blobdiff_plain;ds=sidebyside;f=doc%2Fmanual%2Fpathnames.texinfo;h=4eb43de0151d0dce0965ef32284a2342678552c0;hb=b0b221088b889b6d3ae67e551b93fe1a6cfec878;hp=f3bf30f665be6329647ff5a8630f47f837002cb9;hpb=74cfbf6d0572b7df1b3492563408a7cb3ae103cf;p=sbcl.git

diff --git a/doc/manual/pathnames.texinfo b/doc/manual/pathnames.texinfo
index f3bf30f..4eb43de 100644
--- a/doc/manual/pathnames.texinfo
+++ b/doc/manual/pathnames.texinfo
@@ -70,6 +70,24 @@ 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
@@ -87,6 +105,8 @@ particular, the core system's source files match the logical pathname
 @code{"SYS:SRC;**;*.*.*"}, and the contributed modules' source files
 match @code{"SYS:CONTRIB;**;*.*.*"}.
 
+@include fun-sb-ext-set-sbcl-source-location.texinfo
+
 @node Native Filenames
 @comment  node-name,  next,  previous,  up
 @section Native Filenames