By default, Shake rebuilds everything that has changed. However, sometimes you want to rebuild things that haven't changed, or not rebuild things that have changed. To support this workflow Shake provides three modes:
RebuildNormalis the default setting, rebuild a rule if it's dependencies have changed.
RebuildNowforces a rule to rebuild even if it's dependencies haven't changed. If the rule changes, then that will in turn cause anything depending on that rule to rebuild too.
RebuildLatercauses a rule not to rebuild this run even if it's dependencies have changed. Note that in future runs, if the
RebuildLateris not set, the rule may rebuild.
By default all files are set to
RebuildNormal. To set all
.o files to rebuild regardless you can set
[(RebuildNow, "**/*.o")]. Where a file patches multiple patterns, the last one is applied.
To set these flags on the command line use
RebuildNormal). For example, to rebuild all
.o files pass
--rebuild=**/*.o. If you omit the pattern it defaults to
**, which matches everything.
There is currently no
RebuildNever flag to permanently mark a file as up-to-date. Such a flag could cause inconsistent builds, but more relevantly, it hasn't been implemented yet.
make tool has a number of features to force rebuilds or skip rebuilds, all fundamentally modelled on file modification times forming an order, which is quite a different model to Shake.
--always-makeconsiders all targets out-of-date and rebuilds everything. The Shake equivalent is
--assume-old=FILEdoes not remake the file
FILEeven if it is older than its prerequisites. The Shake equivalent is
--touchtouches files (marks them up to date without really changing them) instead of building them. The closest equivalent in Shake is
--skip, but that only applies to this run. A hypothetical
RebuildNeverflag would more accurately model this flag.
--assume-new=FILEpretends that the target file has just been modified. Shake doesn't really have an equivalent, as
--rebuildapplies to the rules to rebuild, whereas in Make this applies to the things that depend on it. In addition, Make often uses this flag in conjunction with dry-run, which Shake doesn't yet have.