[Buildroot] [PATCH 1/2] help: add a way to document targets declared in local.mk/external.mk

[Thomas Petazzoni]

Hello,

On Tue, 8 Mar 2016 21:54:55 +0100, Arnout Vandecappelle wrote:
> On 11/18/15 15:37, Jérôme Pouiller wrote:
> > It is handy to use local.mk or external.mk to add specific targets
> > for current project. However, until now, it not possible to add help
> > message these targets.
> > This patch add LOCAL_HELP variable. This variable is aimed to be assigned
> > from any .mk files. Its content is displayed with 'make help'.
> >
> > For exemple:
> >    LOCAL_HELP += "flash                  - Flash target"
> >    LOCAL_HELP += "chroot                 - Chroot into target/"
> >    LOCAL_HELP += "qemu                   - Run image with qemu"
> >    LOCAL_HELP += "install-nfs            - Extract rootfs in \$$NFSROOT (=$(NFSROOT))"
> >    LOCAL_HELP += "`printf '%-22s%s' '$(var)-feature' ' - Call $(var) feature'`"
> >    LOCAL_HELP += "Please contact support at company.com in case of problem."
> >
> > Signed-off-by: Jérôme Pouiller <jezz at sysmic.org>
> 
>   Looks good to me, except that I don't like the name 'LOCAL'. I'd prefer e.g. 
> ADDITIONAL.

Wouldn't EXTERNAL_HELP be even better, suggesting that its main
use-case is for BR2_EXTERNAL ?

Thomas
-- 
Thomas Petazzoni, CTO, Free Electrons
Embedded Linux, Kernel and Android engineering
http://free-electrons.com