aboutsummaryrefslogtreecommitdiff
path: root/build2/context.hxx
diff options
context:
space:
mode:
Diffstat (limited to 'build2/context.hxx')
-rw-r--r--build2/context.hxx15
1 files changed, 8 insertions, 7 deletions
diff --git a/build2/context.hxx b/build2/context.hxx
index 5815f51..434b41f 100644
--- a/build2/context.hxx
+++ b/build2/context.hxx
@@ -41,13 +41,14 @@ namespace build2
//
// Serial load can perform arbitrary changes to the model. Exclusive load,
// however, can only perform "island appends". That is, it can create new
- // "nodes" (variables, scopes, etc) but not change already existing nodes or
- // invalidate any references to such (the idea here is that one should be
- // able to load additional buildfiles as long as they don't interfere with
- // the existing build state). The "islands" are identified by the
- // load_generation number (0 for initial/serial load). It is incremented in
- // case of a phase switch and is stored in various "nodes" (variables, etc)
- // to allow modifications "within the islands".
+ // "nodes" (variables, scopes, etc) but not (semantically) change already
+ // existing nodes or invalidate any references to such (the idea here is
+ // that one should be able to load additional buildfiles as long as they
+ // don't interfere with the existing build state). The "islands" are
+ // identified by the load_generation number (0 for the initial/serial
+ // load). It is incremented in case of a phase switch and can be stored in
+ // various "nodes" to verify modifications are only done "within the
+ // islands".
//
extern run_phase phase;
extern size_t load_generation;