diff options
Diffstat (limited to 'src/libstore/build.hh')
| -rw-r--r-- | src/libstore/build.hh | 20 |
1 files changed, 10 insertions, 10 deletions
diff --git a/src/libstore/build.hh b/src/libstore/build.hh index bfc015733..ed83d678e 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 |