kumquat-buildroot/docs/manual
Yann E. MORIN 84c825f8e8 core: add the possibility to provide help for custom rules
When using a br2-external tree, it is possible (as stated in our manual)
to implement whatever arbitrary extra make rules (such as flashing a
board, or extracting the rootfs in an NFS export...). Some of those
extra rules might be exposed to the user as new entry points that the
user can call by itself.

However, there is no way for the br2-external to advertise those new
rules in the help text.

We add the possibility to do so, by adding a new make rule, called
help-custom, advertised in our own help info.

It is up to the br2-external tree to provide whatever help text is
deemed necessary. The format of the help is completely free-form.

Note that we need to provide an empty, dummy help-custom rule, since it
is always advertised (making it .PHONY does not work). Since this rule
is empty, make gently reports that there is "Nothing to be done for
`help-local'", which is pretty well fitting when help-local was not
provided (either because there's no br2-external tree, or when the
br2-external tree does not provide it.

Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr>
Cc: Jérôme Pouiller <jezz@sysmic.org>
Cc: Arnout Vandecappelle <arnout@mind.be>
Cc: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
2016-03-19 16:41:22 +01:00
..
adding-board-support.txt
adding-packages-asciidoc.txt
adding-packages-autotools.txt
adding-packages-cmake.txt
adding-packages-conclusion.txt
adding-packages-directory.txt arch: remove BR2_ARCH_HAS_ATOMICS option 2016-02-06 11:16:00 +01:00
adding-packages-generic.txt docs/manual: document format for specifying licenses 2016-03-06 21:52:57 +01:00
adding-packages-gettext.txt
adding-packages-hooks.txt
adding-packages-kconfig.txt docs/manual: document the new kconfig-package variable 2015-12-22 22:39:26 +01:00
adding-packages-kernel-module.txt
adding-packages-linux-kernel-spec-infra.txt
adding-packages-luarocks.txt
adding-packages-perl.txt
adding-packages-python.txt docs/manual: add "python-package CFFI backend" section 2016-02-23 17:25:06 +01:00
adding-packages-rebar.txt
adding-packages-tips.txt
adding-packages-virtual.txt
adding-packages.txt
advanced.txt
appendix.txt
beyond-buildroot.txt
ccache-support.txt
common-usage.txt docs/manual: update graph-depends documentation about --stop-on 2016-02-08 21:29:38 +01:00
configure-other-components.txt
configure.txt
contribute.txt docs/manual/contribute.txt: add formatting patches section 2016-02-24 00:04:19 +01:00
customize-configuration.txt
customize-device-permission-tables.txt
customize-directory-structure.txt
customize-outside-br.txt core: add the possibility to provide help for custom rules 2016-03-19 16:41:22 +01:00
customize-packages.txt
customize-patches.txt
customize-post-image.txt
customize-quick-guide.txt
customize-rootfs.txt
customize-users-tables.txt
customize.txt
debugging-buildroot.txt
download-infra.txt
download-location.txt docs/manual: fix bash export syntax in example code 2015-11-11 23:12:30 +01:00
eclipse-integration.txt
faq-troubleshooting.txt
getting.txt docs/manual: misc improvements to Vagrant usage documentation 2016-02-08 13:33:43 +01:00
how-buildroot-works.txt
introduction.txt
known-issues.txt
legal-notice.txt docs/manual: add section about patch licensing 2016-03-01 12:46:58 +01:00
make-tips.txt
makedev-syntax.txt docs/manual: makedev syntax accepts usernames and group names 2016-02-01 08:02:38 +01:00
makeusers-syntax.txt
manual.mk docs/manual: do not override BR2_EXTERNAL 2015-11-03 23:42:24 +01:00
manual.txt
package-make-target.txt
patch-policy.txt docs/manual: add section about patch licensing 2016-03-01 12:46:58 +01:00
prerequisite.txt
quickstart.txt
rebuilding-packages.txt
resources.txt
using-buildroot-debugger.txt
using-buildroot-development.txt
using-buildroot-toolchain.txt
writing-rules.txt