[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: mark expensive tests

From: Simon Michael
Subject: Re: mark expensive tests
Date: Tue, 12 Jan 2016 08:55:33 -0800
User-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.11; rv:45.0) Gecko/20100101 Thunderbird/45.0a2

On 1/9/16 4:09 AM, Achim Gratz wrote:
> John Wiegley writes:
>>>>>>> Achim Gratz <address@hidden> writes:
>>> Org has "make help" and "make helpall" and it's all placed directly and
>>> easily readable in the main Makefile (which then provides the actual make
>>> machinery via includes).
>> Except that no one would know to use those as targets (am I building help, or
>> getting help?). The README is a better place.
> One doesn't preclude the other, of course.  The point was that Makefile
> could be way more self-documenting if better documentation of its
> targets was the goal.

http://www.cmcrossroads.com/print/article/self-documenting-makefiles is
a nice system.
https://github.com/simonmichael/hledger/blob/master/help-system.mk is a
tweaked version, used by

$ make
Makefile:39: -------------------- hledger make rules --------------------
Makefile:41: make [help] -- list documented rules in this makefile. make
-n RULE shows more detail.
Makefile:217: (INSTALLING:)
Makefile:219: make install -- download dependencies and install hledger
executables to ~/.local/bin or equivalent (with stack)
Makefile:244: (BUILDING:)
Makefile:248: make build -- download dependencies and build hledger
executables (with stack)

reply via email to

[Prev in Thread] Current Thread [Next in Thread]