[Buildroot] [PATCH] Makefile: document make <package>-dirclean
Thomas De Schampheleire
patrickdepinguin at gmail.com
Fri Jun 20 09:40:10 UTC 2014
Hi,
On Thu, Jun 19, 2014 at 10:10 PM, Yann E. MORIN <yann.morin.1998 at free.fr> wrote:
> Vivien, All,
>
> On 2014-06-19 14:48 -0400, Vivien Didelot spake thusly:
>> > > @@ -849,6 +849,7 @@ help:
>> > > @echo ' toolchain - build toolchain'
>> > > @echo ' <package>-rebuild - force recompile <package>'
>> > > @echo ' <package>-reconfigure - force reconfigure <package>'
>> > > + @echo ' <package>-dirclean - remove the whole <package>
>> > > build directory'
> [--SNIP--]
>> > I believe we should only document the _very important_ commands in
>> > the
>> > 'make help' text, and direct the user to the manual for the others.
>>
>> Having only a portion of commands is confusing.
>>
>> I would say, either put every package commands in `make help` or
>> no `make <package>-foo` commands at all.
>
> Well, I think we should still document a few important, usefull actions;
> see below.
>
>> > E.g.
>> > something like:
>> >
>> > $ make help
>> > [...]
>> > Build:
>> > all - make world
>> > toolchain - build toolchain
>> > <package>-rebuild - force recompile <package>
>> > <package>-reconfigure - force reconfigure <package>
>> > <package>-graph-depends - generate graph of the dependency
>> > tree for package
>> > See the manual
>> > [http://buildroot.net/downloads/manual/manual.html] for
>> > the complete list of per-package build actions.
>>
>> I'd remove the <package>-* command from `make help` and point to the
>> in-tree documentation instead (docs/manual/rebuilding-packages.txt).
>
> Note: everything in docs/manual/ is the source of the (on-line) manual.
> Although readable as-is, it only gets really properly readable once
> rendered into the manual.
>
> So, I would not point to the content of docs/manual/ but to the on-line
> manual, instead.
>
>> That'd look like:
>>
>> $ make help
>> [...]
>> Build:
>> all (or "world"?) - make world
>> toolchain - build toolchain
>> <package> - compile only <package>
>> <package>-<action> - See the manual [docs/manual/rebuilding-packages.txt]
>> for the list of per-package build actions.
>> [...]
>>
>> What do you think?
>
> 'world' is an internal goal. The entry point is the 'all' gaol, and also the
> default goal if no other is specified. I think we should not document
> 'world'.
>
> Adding '<package>' is OK, but we should keep 'rebuild', 'reconfigure'
> and 'graph-depends':
> - we want to prominently advertise the mere existence of 'graph-depends'
> to the unsuspecting user,
> - 'rebuild' and 'reconfigure' are important enough so we probably want
> to maintain them.
>
According to me, foo-dirclean is much more useful to the typical user
than foo-rebuild or foo-reconfigure. The latter two actions are
typically used for OVERRIDE_SRCDIR only, right? While -dirclean can be
used for any kind of (mis)action you performed.
So while I agree that some make targets should be listed to make sure
the unsuspecting user is aware that they exist, dirclean would
definitely be a part of this list, while rebuild/reconfigure need not
necessarily IMO.
Maybe we should create a list of all the possible targets (here in
this thread I mean) and then decide case-by-case if it's necessary to
list them in 'make help' or not?
Best regards,
Thomas
More information about the buildroot
mailing list