docs/manual: remove references to largefile

Switch from the ACL package example to RRDTOOL since ACL has no dual
(depends + select) dependencies any more and doesn't fit the example
scenario.

Signed-off-by: Gustavo Zacarias <gustavo@zacarias.com.ar>
Reviewed-by: "Yann E. MORIN" <yann.morin.1998@free.fr>
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
This commit is contained in:
Gustavo Zacarias 2015-03-30 18:07:31 -03:00 committed by Thomas Petazzoni
parent f4716f79a0
commit 9d188366ea
2 changed files with 32 additions and 36 deletions

View File

@ -124,20 +124,21 @@ is not met.
An example illustrates both the usage of +select+ and +depends on+. An example illustrates both the usage of +select+ and +depends on+.
-------------------------- --------------------------
config BR2_PACKAGE_ACL config BR2_PACKAGE_RRDTOOL
bool "acl" bool "rrdtool"
select BR2_PACKAGE_ATTR depends on BR2_USE_WCHAR
depends on BR2_LARGEFILE select BR2_PACKAGE_FREETYPE
select BR2_PACKAGE_LIBART
select BR2_PACKAGE_LIBPNG
select BR2_PACKAGE_ZLIB
help help
POSIX Access Control Lists, which are used to define more RRDtool is the OpenSource industry standard, high performance
fine-grained discretionary access rights for files and data logging and graphing system for time series data.
directories.
This package also provides libacl.
http://savannah.nongnu.org/projects/acl http://oss.oetiker.ch/rrdtool/
comment "acl needs a toolchain w/ largefile" comment "rrdtool needs a toolchain w/ wchar"
depends on !BR2_LARGEFILE depends on !BR2_USE_WCHAR
-------------------------- --------------------------
@ -206,10 +207,10 @@ coding style].
==== Dependencies on target and toolchain options ==== Dependencies on target and toolchain options
Many packages depend on certain options of the toolchain: the choice of Many packages depend on certain options of the toolchain: the choice of
C library, C++ support, largefile support, thread support, RPC support, C library, C++ support, thread support, RPC support, IPv6 support,
IPv6 support, wchar support, or dynamic library support. Some packages wchar support, or dynamic library support. Some packages can only be
can only be built on certain target architectures, or if an MMU is built on certain target architectures, or if an MMU is available in the
available in the processor. processor.
These dependencies have to be expressed with the appropriate 'depends These dependencies have to be expressed with the appropriate 'depends
on' statements in the Config.in file. Additionally, for dependencies on on' statements in the Config.in file. Additionally, for dependencies on
@ -241,7 +242,7 @@ foo needs a toolchain w/ featA, featB, featC
for example: for example:
-------------------------- --------------------------
aircrack-ng needs a toolchain w/ largefile, threads mpd needs a toolchain w/ C++, threads, wchar
-------------------------- --------------------------
or or
@ -287,10 +288,6 @@ use in the comment.
** Dependency symbol: +BR2_INSTALL_LIBSTDCPP+ ** Dependency symbol: +BR2_INSTALL_LIBSTDCPP+
** Comment string: `C++` ** Comment string: `C++`
* largefile support
** Dependency symbol: +BR2_LARGEFILE+
** Comment string: +largefile+
* thread support * thread support
** Dependency symbol: +BR2_TOOLCHAIN_HAS_THREADS+ ** Dependency symbol: +BR2_TOOLCHAIN_HAS_THREADS+
** Comment string: +threads+ (unless +BR2_TOOLCHAIN_HAS_THREADS_NPTL+ ** Comment string: +threads+ (unless +BR2_TOOLCHAIN_HAS_THREADS_NPTL+

View File

@ -109,20 +109,19 @@ most important ones allow to:
* Change the version of the GCC compiler, binutils and the C library. * Change the version of the GCC compiler, binutils and the C library.
* Select a number of toolchain options (uClibc only): whether the * Select a number of toolchain options (uClibc only): whether the
toolchain should have largefile support (i.e. support for files toolchain should have IPv6 support, RPC support (used mainly for
larger than 2 GB on 32 bits systems), IPv6 support, RPC support NFS), wide-char support, locale support (for internationalization),
(used mainly for NFS), wide-char support, locale support (for C++ support or thread support. Depending on which options you choose,
internationalization), C++ support or thread support. Depending on the number of userspace applications and libraries visible in
which options you choose, the number of userspace applications and Buildroot menus will change: many applications and libraries require
libraries visible in Buildroot menus will change: many applications certain toolchain options to be enabled. Most packages show a comment
and libraries require certain toolchain options to be enabled. Most when a certain toolchain option is required to be able to enable
packages show a comment when a certain toolchain option is required those packages. If needed, you can further refine the uClibc
to be able to enable those packages. If needed, you can further configuration by running +make uclibc-menuconfig+. Note however that
refine the uClibc configuration by running +make all packages in Buildroot are tested against the default uClibc
uclibc-menuconfig+. Note however that all packages in Buildroot are configuration bundled in Buildroot: if you deviate from this
tested against the default uClibc configuration bundled in configuration by removing features from uClibc, some packages may no
Buildroot: if you deviate from this configuration by removing longer build.
features from uClibc, some packages may no longer build.
It is worth noting that whenever one of those options is modified, It is worth noting that whenever one of those options is modified,
then the entire toolchain and system must be rebuilt. See then the entire toolchain and system must be rebuilt. See
@ -178,8 +177,8 @@ Then, you have three solutions to use an external toolchain:
external toolchain uses the 'glibc' library, you only have to tell external toolchain uses the 'glibc' library, you only have to tell
whether your toolchain supports C\++ or not and whether it has whether your toolchain supports C\++ or not and whether it has
built-in RPC support. If your external toolchain uses the 'uClibc' built-in RPC support. If your external toolchain uses the 'uClibc'
library, then you have to tell Buildroot if it supports largefile, library, then you have to tell Buildroot if it supports IPv6,
IPv6, RPC, wide-char, locale, program invocation, threads and RPC, wide-char, locale, program invocation, threads and
C++. At the beginning of the execution, Buildroot will tell you if C++. At the beginning of the execution, Buildroot will tell you if
the selected options do not match the toolchain configuration. the selected options do not match the toolchain configuration.