NetCube-Systems-Austria/kumquat-buildroot
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
a930d9cef6
kumquat-buildroot/docs/manual
History
Yann E. MORIN a930d9cef6 toolchain: linker options with a $ sign are not supported 
As reported in bug #7172 [0], setting BR2_TARGET_LDFLAGS to a value
containing a $ sign can lead to unexpected results.

This is because it is very hard to know when the $ sign gets evaluated:
  - in the Buildroot-level make
  - in the shell called by the Buildroot-level make
  - in the package's own build-system, either at configure time, in the
    Makefile, in a shell in the Makefile...

So, it is very difficult to know how much escaping that would need.

A proposal is to use a shell variable to pass such values unmolested.
But it is not that simple either, since it still contains a $ sign, and
there is not much certainty as to when it would be evaluated.

Instead, just document this limitation, both in the help text for
BR2_TARGET_LDFLAGS, and in the known-issues section in the manual.

Does not really fix #7172, but at least the limitation is documented.

[0] https://bugs.buildroot.org/show_bug.cgi?id=7172

Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr>
Cc: Mike Zick <minimod@morethan.org>
Reviewed-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
2014-07-31 23:51:39 +02:00
..
adding-packages-autotools.txt pkg-autotools: add support for <pkg>_AUTORECONF_ENV 2014-07-23 23:49:10 +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: enhance doc for BR2_TOOLCHAIN_HEADERS_AT_LEAST_X_Y 2014-07-27 15:06:44 +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/adding-packages-perl.txt: remove the trailing slash sign from description of PERL_SITE variable 2014-07-31 23:17:07 +02:00
adding-packages-python.txt pkg-python: add staging installation support 2014-07-16 22:27:34 +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 docs/manual: add sob line for patch series 2014-07-29 20:23:58 +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: (faq-boot-hang-after-starting) fix config entries 2014-06-22 19:21:31 +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 toolchain: linker options with a $ sign are not supported 2014-07-31 23:51:39 +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: add requirements for graph generation 2014-06-22 19:14:52 +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