[Buildroot] [PATCH] docs/manual: add a 'Known issues' chapter

Samuel Martin s.martin49 at gmail.com
Sun Oct 6 18:37:18 UTC 2013


Thomas,

2013/10/6 Thomas Petazzoni <thomas.petazzoni at free-electrons.com>

> Add a 'Known issues' chapter, which lists the exceptions I have
> currently in the autobuilder scripts to avoid known problems from
> occuring. I believe it is more useful to document them rather than
> keeping them hidden in my autobuilder script.
>
> Signed-off-by: Thomas Petazzoni <thomas.petazzoni at free-electrons.com>
> ---
>  docs/manual/known-issues.txt | 32 ++++++++++++++++++++++++++++++++
>  docs/manual/manual.txt       |  2 ++
>  2 files changed, 34 insertions(+)
>  create mode 100644 docs/manual/known-issues.txt
>
> diff --git a/docs/manual/known-issues.txt b/docs/manual/known-issues.txt
> new file mode 100644
> index 0000000..f731f8f
> --- /dev/null
> +++ b/docs/manual/known-issues.txt
> @@ -0,0 +1,32 @@
> +// -*- mode:doc; -*-
> +// vim: set syntax=asciidoc:
> +
> +Known issues
> +============
> +
> +* 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 a glibc or
> +  eglibc based toolchain, or enable the appropriate options in the
> +  uClibc configuration.
> +
> +* The +xfsprogs+ package does not build with the default uClibc
> +  configuration used by the Buildroot toolchain backend. You need to
> +  either a glibc or eglibc based toolchain, or enable the appropriate
> +  options in the uClibc configuration.
>
+
> +* The +mrouted+ package does not build with the default uClibc
> +  configuration used by the Buildroot toolchain backend. You need to
> +  either a glibc or eglibc based toolchain, or enable the appropriate
> +  options in the uClibc configuration.
>

For all these 3 packages that miss options in the default uClibc
configuration,
there are comments in the Config.in files mentioning what are these missing
options.
It is weird to list them for ltp-testsuite, but not for xfsprog or mrouted.


> +
> +* The +libffi+ package is not supported on the SuperH 2 and ARC
> +  architectures.
> +
> +* The +prboom+ package triggers a compiler failure with the SuperH 4
> +  compiler from Soucery CodeBench, version 2012.09.
> +
> diff --git a/docs/manual/manual.txt b/docs/manual/manual.txt
> index 9685667..9ae658e 100644
> --- a/docs/manual/manual.txt
> +++ b/docs/manual/manual.txt
> @@ -23,6 +23,8 @@ include::working-with.txt[]
>
>  include::faq-troubleshooting.txt[]
>
> +include::known-issues.txt[]
> +
>  include::going-further.txt[]
>
>  include::developer-guide.txt[]
> --
>

Otherwise, you have my ack:
Acked-by: Samuel Martin <s.martin49 at gmail.com>

Regards,

-- 
Samuel
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.busybox.net/pipermail/buildroot/attachments/20131006/374f25c8/attachment-0002.html>


More information about the buildroot mailing list