From 4747ad7ed5294f91780646f2dd372349ed22f361 Mon Sep 17 00:00:00 2001
From: "Robert P. Goldman" <rpgoldman@real-time.com>
Date: Wed, 24 Nov 2010 08:41:18 -0600
Subject: [PATCH] Documentation of :here directive improved with guidance from
 Xach.

---
 doc/asdf.texinfo | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/doc/asdf.texinfo b/doc/asdf.texinfo
index 1b38f74a..ee6a1fc4 100644
--- a/doc/asdf.texinfo
+++ b/doc/asdf.texinfo
@@ -1904,8 +1904,12 @@ alone in its directory with the following contents:
 
 @subsection The :here directive
 
+The @code{:here} directive is an absolute pathname designator that
+refers to the directory containing the configuration file currently
+being processed.
+
 The @code{:here} directive is intended to simplify the delivery of
-complex libraries, and for easy configuration of projects shared through
+complex CL systems, and for easy configuration of projects shared through
 revision control systems, in accordance with our design principle that
 each participant should be able to provide all and only the information
 available to him or her.
@@ -1932,6 +1936,17 @@ contains the following:
    (:directory (:here "outlier/")))
 @end example
 
+Then when someone else (call her Y) checks out a copy of this
+repository, she need only add 
+@example
+(:include "/path/to/my/checkout/directory/asdf.conf")
+@end example
+to one of her previously-existing asdf source location configuration
+files, or invoke @code{initialize-source-registry} with a configuration
+form containing that s-expression.  ASDF will find the .conf file that X
+has provided, and then set up source locations within the working
+directory according to X's (relative) instructions.
+
 @section Shell-friendly syntax for configuration
 
 When considering environment variable @code{CL_SOURCE_REGISTRY}
-- 
GitLab