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