[Buildroot] [PATCH] Makefile: document make <package>-dirclean

[Yann E. MORIN <yann.morin.1998@free.fr>]

Thomas?, Vivien, All,

On 2014-06-20 12:11 +0200, Thomas Petazzoni spake thusly:
> On Fri, 20 Jun 2014 11:40:10 +0200, Thomas De Schampheleire wrote:
> 
> > According to me, foo-dirclean is much more useful to the typical user
> > than foo-rebuild or foo-reconfigure.
> 
> I agree.
> 
> > 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.
> 
> Well, I also use -rebuild and -reconfigure when I directly hack into
> output/build/<pkg>-<version>/ to do a quick test.

Well, I must really be a "different" kind of person, then, as I use
-reconfigure and -rebuild quite agressively (especially with
OVERRIDE_SRC_DIR), but just use plain: rm -rf b<TAB>pac<TAB> (which
expands in the shell to build/package-version/ ) to do the -dirclean
stuff; that's so much faster! ;-)

> > 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.
> 
> True.
> 
> > 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?
> 
> Another possible solution would be to have a <pkg>-help target that
> lists all targets that are possible on a package, and then the main
> "make help" only references that.

OK, I like that. :-)

Regards,
Yann E. MORIN.

-- 
.-----------------.--------------------.------------------.--------------------.
|  Yann E. MORIN  | Real-Time Embedded | /"\ ASCII RIBBON | Erics' conspiracy: |
| +33 662 376 056 | Software  Designer | \ / CAMPAIGN     |  ___               |
| +33 223 225 172 `------------.-------:  X  AGAINST      |  \e/  There is no  |
| http://ymorin.is-a-geek.org/ | _/*\_ | / \ HTML MAIL    |   v   conspiracy.  |
'------------------------------^-------^------------------^--------------------'