aboutsummaryrefslogtreecommitdiff
path: root/libbuild2/build/script/script.hxx
diff options
context:
space:
mode:
Diffstat (limited to 'libbuild2/build/script/script.hxx')
-rw-r--r--libbuild2/build/script/script.hxx17
1 files changed, 12 insertions, 5 deletions
diff --git a/libbuild2/build/script/script.hxx b/libbuild2/build/script/script.hxx
index f8306e1..ec603a7 100644
--- a/libbuild2/build/script/script.hxx
+++ b/libbuild2/build/script/script.hxx
@@ -81,13 +81,20 @@ namespace build2
//
variable_map vars;
- // Temporary directory for the script run (see build2::script::
- // environment::temp_dir for details).
+ // Temporary directory for the script run.
//
// Currently this directory is removed regardless of the script
- // execution success or failure. Later, to ease the troubleshooting,
- // we may invent the build2 option suppressing the directory removal
- // on failure.
+ // execution success or failure. Later, to help with troubleshooting,
+ // we may invent an option that suppresses the removal of temporary
+ // files in general.
+ //
+ // This directory is available to the user via the $~ special
+ // variable. Note, however, that the following filesystem entry
+ // prefixes are reserved:
+ //
+ // stdin*
+ // stdout*
+ // stderr*
//
auto_rmdir temp_dir;