diff --git a/doc/asdf.texinfo b/doc/asdf.texinfo index 1b38f74af858f1df723a8c663c3c46f795899e1b..ee6a1fc4d2681385fa022460669f7a8bd1ea9f0f 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}