[Buildroot] [PATCH 1/2] help: add a way to document targets declared in local.mk/external.mk
Arnout Vandecappelle
arnout at mind.be
Tue Mar 8 21:21:49 UTC 2016
On 03/08/16 22:02, Thomas Petazzoni wrote:
> 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 ?
Works for me as well. Additional is a word we're currently not using at all,
so perhaps reusing external is better.
Regards,
Arnout
--
Arnout Vandecappelle arnout at mind be
Senior Embedded Software Architect +32-16-286500
Essensium/Mind http://www.mind.be
G.Geenslaan 9, 3001 Leuven, Belgium BE 872 984 063 RPR Leuven
LinkedIn profile: http://www.linkedin.com/in/arnoutvandecappelle
GPG fingerprint: 7493 020B C7E3 8618 8DEC 222C 82EB F404 F9AC 0DDF
More information about the buildroot
mailing list