From b2d47cd439c555b51f995e34923122cbf725beca Mon Sep 17 00:00:00 2001 From: Josh Holtrop Date: Sun, 27 Feb 2022 16:05:28 -0500 Subject: [PATCH] Document ^^/ prefix --- doc/user_guide.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/doc/user_guide.md b/doc/user_guide.md index 3fb5a0c..99cdc25 100644 --- a/doc/user_guide.md +++ b/doc/user_guide.md @@ -835,6 +835,9 @@ files. Source and target paths passed to a Builder (e.g. Program) can begin with "^/" to indicate that Rscons should expand those paths to be relative to the Environment's build root. +If a source or target path passed to a Builder begins with "^^/", it is +expanded to be relative to the Rscons top-level build directory (but outside +the Environment's build root). ###> Construction Variables @@ -882,7 +885,8 @@ The `target` parameter is the path to the output file or directory. The `sources` parameter is the path or paths to the input file(s) to be used by the builder. In the `target` and `sources` parameters, the user can explicitly refer to a -path within the Environment's build root by beginning the path with "^/". +path within the Environment's build root by beginning the path with "^/", or to +a path within the Rscons top-level built directory by beginning with "^^/". The `vars` parameter is an optional Hash which can include construction variables to be used for this build target. Any construction variable values specified in this parameter will override