Re: [PATCH] Makefile: implement help target

From: Sverre Rabbelier <srabbelier@gmail.com>
Date: Sep 28, 2010, 14:48 UTC
Message-ID: <AANLkTin9JZ1CErBaZjyLXBuBaX4Da7-2dgzotex+bu8X@mail.gmail.com>
In-Reply-To: <c16e8df7c8e9b562ce0e6cd6e543a83779cd2b25.1285684868.git.git@drmicha.warpmail.net>

Heya,

On Tue, Sep 28, 2010 at 16:44, Michael J Gruber <git@drmicha.warpmail.net> wrote:

> with automatic help text collection from lines starting with "#H# " and
> preceding a make target.

I don't know about the "#H#" in particular, but documenting what each target does is a Good Thing (tm) in the first place, re-using that documentation for 'make help' is even better.

> We could sort differently, of course, or at a category key (build, doc, etc.)

I think just sorting alphabetically would be a good start. Maybe pipe the whole thing through sort?

-- 
Cheers,

Sverre Rabbelier