[Buildroot] [PATCH 2/8] core/pkg-utils: add a macro to pretty-print a help entry
Arnout Vandecappelle
arnout at mind.be
Wed Mar 9 23:37:17 UTC 2016
On 03/09/16 23:22, Yann E. MORIN wrote:
> To ensure that all the help entries we display are all formatted the
> same, we currently indent the help texts manually.
>
> Also, when a br2-external tree wants to display local custom help, they
> have to rely on a hard-coded layout (if they want to match our iwn
> output, which is not mandatory).
>
> Add a macro to pretty-print make rules in the help texts.
>
> Signed-off-by: "Yann E. MORIN" <yann.morin.1998 at free.fr>
> Cc: Jérôme Pouiller <jezz at sysmic.org>
> Cc: Arnout Vandecappelle <arnout at mind.be>
> Cc: Thomas Petazzoni <thomas.petazzoni at free-electrons.com>
> ---
> package/pkg-utils.mk | 13 +++++++++++++
> 1 file changed, 13 insertions(+)
>
> diff --git a/package/pkg-utils.mk b/package/pkg-utils.mk
> index f88313a..873dbec 100644
> --- a/package/pkg-utils.mk
> +++ b/package/pkg-utils.mk
> @@ -104,6 +104,19 @@ define sep
>
> endef
>
> +# Pretty-print a make rule in the help text
> +#
> +# $(1): a list of double- or single-quoted string representing the rule
> +# and their help text, formatted as: "action : help for action"
> +# 'action' should be less than 22 characters, otherwise the help
> +# text will not be correctly indented.
> +#
> +define HELP_RULE
Most of our functions are lowercase. Perhaps print-help?
If we don't have the help-local indirection but directly do it in the
top-level help, then there's no need for an additional function.
Regards,
Arnout
> + for h in $(1); do \
> + printf " %-22s - %s\n" "$${h%% : *}" "$${h#* : }"; \
> + done
> +endef
> +
> # check-deprecated-variable -- throw an error on deprecated variables
> # example:
> # $(eval $(call check-deprecated-variable,FOO_MAKE_OPT,FOO_MAKE_OPTS))
>
--
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