kumquat-buildroot/docs/manual
Thomas De Schampheleire 54456cc698 infra: consistently use double dollar signs inside inner-xxx-targets
The inner-xxx-targets in the buildroot package infrastructures are
evaluated using $(eval) which causes variable references to be a bit
different than in regular make code. As we want most references to be
expanded only at the time of the $(eval) we should not use standard
references $(VAR) but rather use double dollar signs $$(VAR). This includes
function references like $(call), $(subst), etc. The only exception is the
reference to pkgdir/pkgname and numbered variables, which are parameters to
the inner block: $(1), $(2), etc.

This patch introduces consistent usage of double-dollar signs throughout the
different inner-xxx-targets blocks.

In some cases, this would potentially cause circular references, in
particular when the value of HOST_FOO_VAR would be obtained from the
corresponding FOO_VAR if HOST_FOO_VAR is not defined. In these cases, a test
is added to check for a host package (the only case where such constructions
are relevant; these are not circular).

Benefits of these changes are:
- behavior of variables is now again as expected. For example, setting
  $(2)_VERSION = virtual in pkg-virtual.mk will effectively work, while
  originally it would cause very odd results.

- The output of 'make printvars' is now much more useful. This target shows
  the value of all variables, and the expression that led to that value.
  However, if the expression was coming from an inner-xxx-targets block, and
  was using single dollar signs, it would show in printvars as
    VAR = value (value)
  while if double dollar signs are used, it would effectively look like
    VAR = value (actual expression)
  as is intended.
  This improvement is for example effective for FOO_DL_VERSION, FOO_RAWNAME,
  FOO_SITE_METHOD and FOO_MAKE.

The correctness of this patch has been verified using 'make printvars',
'make manual' and 'make legal-info' before and after applying this patch,
and comparing the output.

Insight-provided-by: Arnout Vandecappelle <arnout@mind.be>
Signed-off-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
2014-06-14 19:09:54 +02:00
..
adding-packages-autotools.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
adding-packages-cmake.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
adding-packages-conclusion.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
adding-packages-directory.txt docs/manual: add the virtual packages list 2014-06-08 17:11:47 +02:00
adding-packages-generic.txt replace github with GitHub 2014-06-04 23:14:08 +02:00
adding-packages-gettext.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
adding-packages-hooks.txt infra: Add PRE_*_HOOKS for every step 2014-05-08 22:00:47 +02:00
adding-packages-luarocks.txt manual: make consistent references to package metadata information 2014-06-04 23:15:06 +02:00
adding-packages-perl.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
adding-packages-python.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
adding-packages-tips.txt replace github with GitHub 2014-06-04 23:14:08 +02:00
adding-packages-virtual.txt docs/manual: add the virtual packages list 2014-06-08 17:11:47 +02:00
adding-packages.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
advanced.txt docs/manual: document how to use the cross debugger 2014-05-05 13:44:28 +02:00
appendix.txt docs/manual: add the virtual packages list 2014-06-08 17:11:47 +02:00
beyond-buildroot.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
ccache-support.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
common-usage.txt graphs/depends: do not draw transitive dependencies by default 2014-06-13 14:39:48 +02:00
configure.txt replace references to Busybox with BusyBox 2014-06-01 23:58:43 +02:00
contribute.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
customize-busybox-config.txt replace references to Busybox with BusyBox 2014-06-01 23:58:43 +02:00
customize-kernel-config.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
customize-outside-br.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
customize-packages.txt manual: Fix BR2_GLOBAL_PATCH_DIR example 2014-05-29 23:21:15 +02:00
customize-rootfs.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
customize-store.txt replace references to Busybox with BusyBox 2014-06-01 23:58:43 +02:00
customize-toolchain.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
customize-uclibc-config.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
customize.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
debugging-buildroot.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
developer-guide.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
download-infra.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
download-location.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
eclipse-integration.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
faq-troubleshooting.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
get-involved.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
getting.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
going-further.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
how-buildroot-works.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
introduction.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
known-issues.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
legal-notice.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
make-tips.txt manual: fix spelling mistakes 2014-06-01 17:28:05 +02:00
makedev-syntax.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
makeusers-syntax.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
manual.mk infra: consistently use double dollar signs inside inner-xxx-targets 2014-06-14 19:09:54 +02:00
manual.txt manual: remove contributor list and add copyright 2014-05-29 00:03:49 +02:00
package-make-target.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
patch-policy.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
prerequisite.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
rebuilding-packages.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
starting-up.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
using-buildroot-debugger.txt docs/manual: document how to use the cross debugger 2014-05-05 13:44:28 +02:00
using-buildroot-development.txt replace references to Busybox with BusyBox 2014-06-01 23:58:43 +02:00
using-buildroot-toolchain.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
using.txt replace references to Busybox with BusyBox 2014-06-01 23:58:43 +02:00
working-with.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00
writing-rules.txt manual: use one-line titles instead of two-line titles (trivial) 2014-05-02 10:27:59 +02:00