about summary refs log tree commit diff
path: root/src/libstore/build.hh
diff options
context:
space:
mode:
authorEelco Dolstra <e.dolstra@tudelft.nl>2005-01-20T16·01+0000
committerEelco Dolstra <e.dolstra@tudelft.nl>2005-01-20T16·01+0000
commit6a0a2d559336b3a7a165fb0f87f5e70caa9d8d72 (patch)
tree0ec39aaa3ed200d9d0fa5be37eed0a7f7b2a218e /src/libstore/build.hh
parent6bb5efadeceb8c4666c227a44113709bb47d23cb (diff)
* Terminology fixes.
Diffstat (limited to 'src/libstore/build.hh')
-rw-r--r--src/libstore/build.hh20
1 files changed, 10 insertions, 10 deletions
diff --git a/src/libstore/build.hh b/src/libstore/build.hh
index bfc0157330f7..ed83d678ec66 100644
--- a/src/libstore/build.hh
+++ b/src/libstore/build.hh
@@ -3,20 +3,20 @@
 
 #include "derivations.hh"
 
-/* Perform the specified derivations, if necessary.  That is, do
-   whatever is necessary to create the output paths of the derivation.
-   If the output paths already exists, we're done.  If they have
-   substitutes, we can use those instead.  Otherwise, the build action
-   described by the derivation is performed, after recursively
-   building any sub-derivations. */
+/* Ensure that the output paths of the derivation are valid.  If they
+   are already valid, this is a no-op.  Otherwise, validity can
+   be reached in two ways.  First, if the output paths have
+   substitutes, then those can be used.  Second, the output paths can
+   be created by running the builder, after recursively building any
+   sub-derivations. */
 void buildDerivations(const PathSet & drvPaths);
 
-/* Ensure that a path exists, possibly by instantiating it by
-   realising a substitute. */
+/* Ensure that a path is valid.  If it is not currently valid, it may
+   be made valid by running a substitute (if defined for the path). */
 void ensurePath(const Path & storePath);
 
-/* Read a derivation store expression, after ensuring its existence
-   through ensurePath(). */
+/* Read a derivation, after ensuring its existence through
+   ensurePath(). */
 Derivation derivationFromPath(const Path & drvPath);
 
 /* Place in `paths' the set of all store paths in the file system