2013-10-06 19:49:07 +02:00
|
|
|
// -*- mode:doc; -*-
|
|
|
|
// vim: set syntax=asciidoc:
|
|
|
|
|
manual: high-level restructuring
The structure of the buildroot manual is not always clear. There is a large
number of chapters, and some chapters seem to overlap. The distinction
between general usage and developer information is not always clear.
This patch restructures the manual into four large parts:
- getting started
- user guide
- developer guide
- appendix
Except for the names of these parts, the section names are not yet changed.
Content-wise there are no changes yet either. This will be handled in
subsequent patches.
In order to achieve the introduction of a new level 'parts' above
'chapters', the section indicators (=, ==, ===, ...) of several sections
have to be moved one level down. Additionally, the leveloffset indication to
asciidoc has to be removed. Finally, to maintain more or less the same level
of detail in the table of contents, the toc.section.depth attribute is
reduced as well. Note that for some sections, less detail is visible now.
Signed-off-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
2014-08-12 22:20:06 +02:00
|
|
|
== Known issues
|
2013-10-06 19:49:07 +02:00
|
|
|
|
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 00:57:15 +02:00
|
|
|
* It is not possible to pass extra linker options via +BR2_TARGET_LDFLAGS+
|
|
|
|
if such options contain a +$+ sign. For example, the following is known
|
|
|
|
to break: +BR2_TARGET_LDFLAGS="-Wl,-rpath=\'$ORIGIN/../lib'"+
|
|
|
|
|
2013-10-06 19:49:07 +02:00
|
|
|
* The +ltp-testsuite+ package does not build with the default uClibc
|
|
|
|
configuration used by the Buildroot toolchain backend. The LTP
|
|
|
|
testsuite uses several functions that are considered obsolete, such
|
|
|
|
as sigset() and others. uClibc configuration options such as
|
|
|
|
DO_XSI_MATH, UCLIBC_HAS_OBSOLETE_BSD_SIGNAL and
|
|
|
|
UCLIBC_SV4_DEPRECATED are needed if one wants to build the
|
|
|
|
+ltp-testsuite+ package with uClibc. You need to either use a glibc
|
2016-06-08 23:40:58 +02:00
|
|
|
based toolchain, or enable the appropriate options in the uClibc
|
|
|
|
configuration.
|
2013-10-06 19:49:07 +02:00
|
|
|
|
|
|
|
* The +xfsprogs+ package does not build with the default uClibc
|
|
|
|
configuration used by the Buildroot toolchain backend. You need to
|
2016-06-08 23:40:58 +02:00
|
|
|
either use a glibc based toolchain, or enable the appropriate
|
|
|
|
options in the uClibc configuration.
|
2013-10-06 19:49:07 +02:00
|
|
|
|
|
|
|
* The +mrouted+ package does not build with the default uClibc
|
|
|
|
configuration used by the Buildroot toolchain backend. You need to
|
2016-06-08 23:40:58 +02:00
|
|
|
either use a glibc based toolchain, or enable the appropriate
|
|
|
|
options in the uClibc configuration.
|
2013-10-06 19:49:07 +02:00
|
|
|
|
|
|
|
* The +libffi+ package is not supported on the SuperH 2 and ARC
|
|
|
|
architectures.
|
|
|
|
|
|
|
|
* The +prboom+ package triggers a compiler failure with the SuperH 4
|
2013-10-07 09:33:46 +02:00
|
|
|
compiler from Sourcery CodeBench, version 2012.09.
|
2013-10-06 19:49:07 +02:00
|
|
|
|