Documentation

Given the text of a Makefile, extract the list of targets and dependencies. Assumes a small subset of Makefile syntax, mostly that generated by gcc -MM.

parseMakefile "a: b c\nd : e" == [("a",["b","c"]),("d",["e"])]

Depend on the dependencies listed in a Makefile. Does not depend on the Makefile itself.

needMakefileDependencies file = need . concatMap snd . parseMakefile =<< liftIO (readFile file)

Depend on the dependencies listed in a Makefile. Does not depend on the Makefile itself. Use this function to indicate that you have already used the files in question.

neededMakefileDependencies file = needed . concatMap snd . parseMakefile =<< liftIO (readFile file)

Like shakeArgsWith, but instead of accumulating a list of flags, apply functions to a default value. Usually used to populate a record structure. As an example of a build system that can use either gcc or distcc for compiling:

import System.Console.GetOpt

data Flags = Flags {distCC :: Bool} deriving Eq
flags = [Option "" ["distcc"] (NoArg $ Right $ \x -> x{distCC=True}) "Run distributed."]

main = shakeArgsAccumulate shakeOptions flags (Flags False) $ \flags targets -> pure $ Just $ do
    if null targets then want ["result.exe"] else want targets
    let compiler = if distCC flags then "distcc" else "gcc"
    "*.o" %> \out -> do
        need ...
        cmd compiler ...
    ...

Now you can pass --distcc to use the distcc compiler.

Like shakeArgs but also takes a pruning function. If --prune is passed, then after the build has completed, the second argument is called with a list of the files that the build checked were up-to-date.

A version of shakeArgsPrune that also takes a list of extra options to use.