kumquat-buildroot/docs
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
..
css website: add Bootstrap and JQuery frameworks 2014-03-03 21:40:47 +01:00
images website: Add a Google+ presence 2014-03-28 22:48:01 +01:00
js website: remove remaining references to uclibc.org 2014-05-25 21:46:51 +02:00
manual toolchain: linker options with a $ sign are not supported 2014-07-31 23:51:39 +02:00
about.html website: new website ! 2014-03-03 21:40:50 +01:00
contribute.html website: rework Contribute page to avoid duplication with manual 2014-05-25 21:45:02 +02:00
copyright.txt trivial: update buildroot e-mail address to buildroot@buildroot.org 2014-02-12 20:39:15 +01:00
docs.html website: remove remaining references to uclibc.org 2014-05-25 21:46:51 +02:00
download.html Update for 2014.05 2014-05-31 09:52:49 +02:00
favicon.ico docs: add favicon / robots.txt 2011-04-04 22:21:47 +02:00
footer.html website: new website ! 2014-03-03 21:40:50 +01:00
git.html website: new website ! 2014-03-03 21:40:50 +01:00
header.html website: add alt-tags to images 2014-05-25 21:51:57 +02:00
index.html website: add alt-tags to images 2014-05-25 21:51:57 +02:00
news.html docs/news.html: add 2014.05 announcement link 2014-06-01 09:49:24 +02:00
robots.txt docs: add favicon / robots.txt 2011-04-04 22:21:47 +02:00
sponsors.html website: new website ! 2014-03-03 21:40:50 +01:00
support.html website: fix typos and HTML on support page 2014-05-25 21:48:01 +02:00