[Buildroot] [PATCH 07/13] docs/manual: update informations about C library in internal backend
Yann E. MORIN
yann.morin.1998 at free.fr
Sun Feb 23 16:21:20 UTC 2014
Thomas, All,
On 2014-02-23 16:04 +0100, Thomas Petazzoni spake thusly:
> Now that we have eglibc and glibc support in the internal backend, and
> no longer marked as experimental, a little bit of rewording is
> needed. It is no longer necessary to indicate that uClibc was
> historically supported as the only C library, and that the glibc
> support is experimental. We also update the rest of the description to
> be less uClibc specific.
>
> Signed-off-by: Thomas Petazzoni <thomas.petazzoni at free-electrons.com>
> ---
> docs/manual/configure.txt | 30 +++++++++++-------------------
> 1 file changed, 11 insertions(+), 19 deletions(-)
>
> diff --git a/docs/manual/configure.txt b/docs/manual/configure.txt
> index 89df3d9..b566e8a 100644
> --- a/docs/manual/configure.txt
> +++ b/docs/manual/configure.txt
> @@ -68,12 +68,10 @@ The _internal toolchain backend_ is the backend where Buildroot builds
> by itself a cross-compilation toolchain, before building the userspace
> applications and libraries for your target embedded system.
>
> -This backend is the historical backend of Buildroot, and has been
> -limited for a long time to the usage of the
> -http://www.uclibc.org[uClibc C library]. Support for the _eglibc_ C
> -library has been added in 2013 and is at this point considered
> -experimental. See the _External toolchain backend_ for another
> -solution to use _glibc_ or _eglibc_.
> +This backend supports several C libraries:
> +http://www.uclibc.org[uClibc], the
s/the// since you don't do it for the other two.
> +http://www.gnu.org/software/libc/libc.html[glibc] and
> +http://www.eglibc.org[eglibc].
>
> Once you have selected this backend, a number of options appear. The
> most important ones allow to:
> @@ -96,18 +94,7 @@ most important ones allow to:
> the C library might be using interfaces that are not provided by
> your Linux kernel.
Unrelated to your patch, but what about:
[...] the C library might be using interfaces, or exposing thos
interfaces to applications, that are not provided by the running
Linux kernel.
> - * Change the version and the configuration of the uClibc C library
> - (if uClibc is selected). The default options are usually
> - fine. However, if you really need to specifically customize the
> - configuration of your uClibc C library, you can pass a specific
> - configuration file here. Or alternatively, you can run the +make
> - uclibc-menuconfig+ command to get access to uClibc's configuration
> - interface. Note that all packages in Buildroot are tested against
> - the default uClibc configuration bundled in Buildroot: if you
> - deviate from this configuration by removing features from uClibc,
> - some packages may no longer build.
> -
> - * Change the version of the GCC compiler and binutils.
> + * Change the version of the GCC compiler, binutils and the C library.
>
> * Select a number of toolchain options (uClibc only): whether the
> toolchain should have largefile support (i.e support for files
> @@ -118,7 +105,12 @@ most important ones allow to:
> libraries visible in Buildroot menus will change: many applications
> and libraries require certain toolchain options to be enabled. Most
> packages show a comment when a certain toolchain option is required
> - to be able to enable those packages.
> + to be able to enable those packages. If needed, you can further
> + refine the uClibc configuration by running +make
> + uclibc-menuconfig+. Note however that all packages in Buildroot are
> + tested against the default uClibc configuration bundled in
> + Buildroot: if you deviate from this configuration by removing
> + features from uClibc, some packages may no longer build.
>
> It is worth noting that whenever one of those options is modified,
> then the entire toolchain and system must be rebuilt. See
Otherwise, looks good.
Regards,
Yann E. MORIN.
--
.-----------------.--------------------.------------------.--------------------.
| Yann E. MORIN | Real-Time Embedded | /"\ ASCII RIBBON | Erics' conspiracy: |
| +33 662 376 056 | Software Designer | \ / CAMPAIGN | ___ |
| +33 223 225 172 `------------.-------: X AGAINST | \e/ There is no |
| http://ymorin.is-a-geek.org/ | _/*\_ | / \ HTML MAIL | v conspiracy. |
'------------------------------^-------^------------------^--------------------'
More information about the buildroot
mailing list