summaryrefslogtreecommitdiffstats
path: root/docs/manual
Commit message (Collapse)AuthorAgeFilesLines
* manual: clarify Tested-by/Reviewed-by/Acked-by tagsThomas De Schampheleire2014-03-021-4/+41
| | | | | | | | | | This patch updates the manual with more clarified descriptions of tags Tested-by, Reviewed-by, and Acked-by, as discussed on the Buildroot developer days in February 2014. Signed-off-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com> Acked-by: Samuel Martin <s.martin49@gmail.com> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* manual: document minimal kernel headers dependencyYann E. MORIN2014-03-011-0/+6
| | | | | | | | | | | Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Cc: Samuel Martin <s.martin49@gmail.com> Cc: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Cc: Arnout Vandecappelle <arnout@mind.be> Cc: Thomas De Schampheleire <patrickdepinguin@gmail.com> Acked-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com> Acked-by: Arnout Vandecappelle (Essensium/Mind) <arnout@mind.be> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* Merge branch 'next'Peter Korsgaard2014-02-284-12/+140
|\ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Conflicts: Makefile package/dmraid/Config.in package/gdb/Config.in.host package/linux-headers/linux-headers.mk package/python/python.mk package/python3/python3.mk package/rt-tests/Config.in package/sdl/sdl.mk package/systemd/systemd-01-fix-getty-unit.patch package/systemd/systemd-02-fix-page-size.patch package/systemd/systemd-03-uclibc-fix.patch package/udev/Config.in package/udisks/Config.in package/vlc/vlc.mk system/Config.in Quite some merge conflicts, hopefully I didn't screw up anything. Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
| * manual: adding packages perlFrancois Perrad2014-02-232-0/+122
| | | | | | | | | | Signed-off-by: Francois Perrad <francois.perrad@gadz.org> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
| * docs/manual: indicate how to handle BR2_TOOLCHAIN_HAS_THREADS_NPTLThomas Petazzoni2014-02-221-1/+6
| | | | | | | | | | | | Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Acked-by: Samuel Martin <s.martin49@gmail.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
| * manual: update /dev management section.eric.le.bihan.dev@free.fr2014-02-121-9/+11
| | | | | | | | | | | | | | | | | | | | This patch updates the /dev management section in the manual with information about eudev, which replaces udev. Signed-off-by: Eric Le Bihan <eric.le.bihan.dev@free.fr> Acked-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com> Acked-by: Samuel Martin <s.martin49@gmail.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
| * udev: convert to virtual packageeric.le.bihan.dev@free.fr2014-02-121-2/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This patch converts udev to a virtual package. For the moment, there is only one provider for the udev features: eudev. Packages meant to provide udev-like features must select the symbol BR2_PACKAGE_HAS_UDEV. Packages depending on BR2_ROOTFS_DEVICE_CREATION_DYNAMIC_UDEV or BR2_PACKAGE_UDEV have been converted to use the new symbol. [Peter: move legacy symbols under 2014.05] Signed-off-by: Eric Le Bihan <eric.le.bihan.dev@free.fr> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* | common-usage.txt: adjust documentation for renamed BR2_GRAPH_ variablesPeter Korsgaard2014-02-241-6/+6
| | | | | | | | Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* | manual: fix missing DL_DIR rename to BR2_DL_DIRYann E. MORIN2014-02-241-1/+1
| | | | | | | | | | | | | | | | There was one instance of DL_DIR that was left out. Fix that. Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Cc: Samuel Martin <s.martin49@gmail.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* | docs/manual: fix minor spelling/grammar mistakesThomas De Schampheleire2014-02-243-7/+7
| | | | | | | | | | | | | | | | | | This commit fixes a few minor spelling or grammar mistakes since the recent additions to the manual (commits 0b100de2cf36d81910ab53978b8a379214a683ea to 7cbb476661b0cfa213d8885f3fe5d58823e84286). Signed-off-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* | docs/manual: mention the per-package graph-depends targetThomas Petazzoni2014-02-231-0/+5
| | | | | | | | | | | | Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Reviewed-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* | docs/manual: document the usage of <pkg>_OVERRIDE_SRCDIRThomas Petazzoni2014-02-232-0/+86
| | | | | | | | | | | | [Peter: adjust wording as suggested by Yann] Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* | docs/manual: refresh informations about *-menuconfig targetsThomas Petazzoni2014-02-231-2/+4
| | | | | | | | | | | | Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Reviewed-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* | docs/manual: rephrase paragraph about unsupported external toolchainsThomas Petazzoni2014-02-231-17/+7
| | | | | | | | | | | | | | | | | | | | | | | | The ELDK now relies on Yocto, so it no longer has the funky non-standard way of doing multilib. Also, we didn't mention that Yocto toolchains/SDK are not suitable for usage with Buildroot. Therefore, this commit rewords this part of the documentation to explain that Yocto/OpenEmbedded SDKs cannot be used as external toolchains in Buildroot, and why. Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* | docs/manual: mention that custom toolchains is also useful for BR toolchainsThomas Petazzoni2014-02-231-8/+8
| | | | | | | | | | | | Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Reviewed-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* | docs/manual: update external toolchain examplesThomas Petazzoni2014-02-231-4/+3
| | | | | | | | | | | | | | | | | | Replace ADI by Analog Devices, which is clearer for most people, and remove the Xilinx external toolchains since we have deprecated them. Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Reviewed-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* | docs/manual: update informations about C library in internal backendThomas Petazzoni2014-02-231-19/+11
| | | | | | | | | | | | | | | | | | | | | | | | 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@free-electrons.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* | docs/manual: add section about build time graphingThomas Petazzoni2014-02-231-0/+47
| | | | | | | | | | Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* | docs/manual: add section about dependency graphsThomas Petazzoni2014-02-231-0/+52
| | | | | | | | | | | | Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Reviewed-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* | docs/manual: reference Python and Lua infras from the list of package ↵Thomas Petazzoni2014-02-231-0/+11
| | | | | | | | | | | | | | | | infrastructures [Peter: adjust wording as suggested by Yann] Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* | docs/manual: rephrase and expand part on when a full rebuild is necessaryThomas Petazzoni2014-02-231-22/+71
| | | | | | | | | | | | Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Reviewed-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* | docs/manual: rephrase part about rebuilding packagesThomas Petazzoni2014-02-231-17/+19
| | | | | | | | | | | | | | | | | | | | | | There is no need to tell people that they should remove stamp files: they should use the make <pkg>-reconfigure and make <pkg>-rebuild make targets instead. We still keep an explanation about stamp files, just to give the user an insight on how Buildroot works internally. Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Reviewed-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* | docs/manual: toolchain packages no longer use custom makefilesThomas Petazzoni2014-02-231-3/+0
| | | | | | | | | | | | Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Reviewed-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* | manual: add explanations on limitations about using O=...Yann E. MORIN2014-02-221-3/+9
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Using a relative path for O=... has limitations, since it is interpreted relative to the Buildroot tree, and thus may lead to unexpected results. For example, running this: make -C buildroot O=my-O will not create my-O in the current working directory, but as a sub-directory of the Buildroot tree, here in buildroot/my-O Explain this in the manual (as is similarly done for BR2_EXTERNAL). Also add a note that $(O) will be created if missing. Also change O=.. and -C .. to O=<...> and -C <...> to make it explicit this is an ellipse, not a relative path. Reported-by: Jérémy Rosen <jeremy.rosen@openwide.fr> Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Cc: Samuel Martin <s.martin49@gmail.com> Reviewed-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com> Acked-by: Samuel Martin <s.martin49@gmail.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* | manual: switch BR2_EXTERNAL examples to use absolute pathsYann E. MORIN2014-02-221-5/+5
| | | | | | | | | | | | | | | | | | | | | | | | | | | | Although it is possible to use relative paths, there are a few pitfalls when doing so. To avoid confusion for a (newcoming) user, use absolute paths in the manual (as is done in examples for $(O)), since it is guaranteed to be working without corner cases. [Peter: s/relatively/relative/ as suggested by Thomas] Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Cc: Samuel Martin <s.martin49@gmail.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* | manual/faq: add section about why no binary packagesYann E. MORIN2014-02-201-0/+100
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | It comes up every now and then on the list, so better be prepared to point at the manual, rather than rehash the same every time. Most of the chapter is a copy-paste of the report from the Buildroot Developpers Day in Pragues, 2011-10-28: http://lists.busybox.net/pipermail/buildroot/2011-November/047229.html We consider the opinions expressed in that report to be still valid now, two years later. Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Cc: Samuel Martin <s.martin49@gmail.com> Cc: Peter Korsgaard <jacmet@uclibc.org> Cc: Arnout Vandecappelle <arnout@mind.be> Cc: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Cc: Thomas De Schampheleire <patrickdepinguin@gmail.com> Cc: Baruch Siach <baruch@tkos.co.il> Cc: Danomi Manchego <danomimanchego123@gmail.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* | trivial: update buildroot e-mail address to buildroot@buildroot.orgThomas De Schampheleire2014-02-121-1/+1
|/ | | | | | | | | As the e-mail address buildroot@buildroot.org is now enabled, update the e-mail addresses in the source tree from @uclibc.org and @busybox.net to our own proper domain. Signed-off-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* infra: replace BUILDROOT_CONFIG with BR2_CONFIGArnout Vandecappelle2014-02-092-3/+3
| | | | | | | | | | | | | | | To make the naming consistent (all user-visible options should be prefixed with BR2_). An entry is added to Makefile.legacy to warn users who have set BUILDROOT_CONFIG but not BR2_CONFIG. Still export BUILDROOT_CONFIG but pointing to some phony value, to make sure that scripts that still use it fail in a predictable way. Signed-off-by: Arnout Vandecappelle (Essensium/Mind) <arnout@mind.be> Tested-by: Jérémy Rosen <jeremy.rosen@openwide.fr> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* infra: replace BUILDROOT_DL_DIR with BR2_DL_DIR.Arnout Vandecappelle2014-02-092-5/+5
| | | | | | | | | | | To make the naming consistent (all user-visible options should be prefixed BR2_). An entry is added to Makefile.legacy to warn users who have set BUILDROOT_DL_DIR but not BR2_DL_DIR. Signed-off-by: Arnout Vandecappelle (Essensium/Mind) <arnout@mind.be> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* manual: $(BR2_EXTERNAL)/{Config.in, external.mk} are mandatoryYann E. MORIN2014-02-081-0/+1
| | | | | | | | | | | The manual is a bit vague about whether Config.in and external.mk are mandatory or optional. Make it explicit in the manual that they are mandatory. Reported-by: Jérémy Rosen <jeremy.rosen@openwide.fr> Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* manual: Clarify wrapper and debugMaxime Hadjinlian2014-02-031-3/+4
| | | | | | | | | Try to clarify how the wrapper passes arguments and why. This is mainly because the output you can see when you build, does not reflect what is invoked by the wrapper. Signed-off-by: Maxime Hadjinlian <maxime.hadjinlian@gmail.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* manual: remove suggestion of aligning = signs in .mk filesThomas De Schampheleire2014-01-221-7/+1
| | | | | | | | It is not buildroot convention to align the = signs in .mk files, so this shouldn't be suggested in the manual. Signed-off-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* manual: clarify handling of deprecated featuresThomas De Schampheleire2014-01-211-1/+7
| | | | | Signed-off-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* manual: adding packages luarocksFrancois Perrad2014-01-132-0/+95
| | | | | | | | Signed-off-by: Francois Perrad <francois.perrad@gadz.org> [yann.morin.1998@free.fr: some cleanups and rephrasing] Signed-off-by: Yann E. MORIN <yann.morin.1998@free.fr> Cc: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* manual: add section about dealing efficiently with big image filesYann E. MORIN2014-01-091-0/+39
| | | | | | | | | | | | | | | As reported by Ryan, it is not well-known that most tools can deal efficiently with big sparse files. Add a section in the manual about this, with tar and cp used as examples, and a hinting to the man pages for the others. Reported-by: Ryan Barnett <rjbarnet@rockwellcollins.com> Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Cc: Ryan Barnett <rjbarnet@rockwellcollins.com> Cc: Peter Korsgaard <jacmet@uclibc.org> Cc: Thomas De Schampheleire <patrickdepinguin@gmail.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* manual: use current date/time for 'generated on'Yann E. MORIN2014-01-041-2/+2
| | | | | | | | | | | | | | | | Currently, the manual uses the last modification date and time of manual.txt in the generated manual. This is confusing, especially for long-checked-out repositories where the top-level manual.txt has not changed since the check out. Moreover, the manual explicitly states 'generated on', which is confusing at best. Use the current date and time instead. Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Cc: Samuel Martin <s.martin49@gmail.com> Acked-by: Samuel Martin <s.martin49@gmail.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* manual: fix uboot subdirectory in example layoutSimon Dawson2014-01-031-2/+2
| | | | | | | | | If U-Boot patches are nested under BR2_GLOBAL_PATCH_DIR, then the subdirectory should be called "uboot", and not "u-boot". Signed-off-by: Simon Dawson <spdawson@gmail.com> Acked-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* package: standardise Apache licensesSimon Dawson2014-01-021-0/+3
| | | | | | | | Apache licenses are referred to in a variety of ways; standardise these, choosing a form which does not contain whitespace. Signed-off-by: Simon Dawson <spdawson@gmail.com> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* graphs: support generating png graphsYann E. MORIN2013-12-291-0/+2
| | | | | | | | | | | | | | PDF files can not be easily embedded in other documents (eg. ODT, or HTML). Add support for generating PNG graphs, by setting the GRAPH_OUT=pdf|png on the command line: make GRAPH_OUT=png graph-build graph-depends The default is still to generate PDF graphs. Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Cc: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* Makefile: expose target 'graph-build' to generate the build-time graphsYann E. MORIN2013-12-291-0/+2
| | | | | | | | | | | | | | | Generate the build-time graphs by calling: make graph-build This generates the graphs in $(O)/graphs/ It is possible to use the alternate color-scheme by setting the variable GRAPH_ALT=1 on the command line: make GRAPH_ALT=1 graph-build Signed-off-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Cc: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* manual: update for multiple global patch dirsRyan Barnett2013-12-252-16/+96
| | | | | | | | | | | | | | Updating the documentation to reflect that multiple directories can now be specified for BR2_GLOBAL_PATCH_DIR. Along with giving an example use case of how to use multiple global patch directories. [Thomas: fix minor typo mentionned by Thomas De Schampheleire.] Signed-off-by: Ryan Barnett <rjbarnet@rockwellcollins.com> Cc: Thomas De Schampheleire <patrickdepinguin@gmail.com> Cc: Arnout Vandecappelle <arnout@mind.be> Reviewed-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
* manual: explain format of comment about udev /dev management dependencyThomas De Schampheleire2013-12-191-0/+17
| | | | | Signed-off-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* manual: clarify format of comments about dependency on Linux kernelThomas De Schampheleire2013-12-151-0/+16
| | | | | Signed-off-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* package: introduce Python package infrastructureThomas Petazzoni2013-12-152-0/+161
| | | | | | [Peter: fix s/BUILD_TYPE/SETUP_TYPE/ typo in manual as noted by Samuel] Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* manual: systemd does not require glibShawn Landden2013-12-091-1/+1
| | | | | | Signed-off-by: Shawn Landden <shawn@churchofgit.com> Reviewed-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* mention nconfigShawn Landden2013-12-092-3/+9
| | | | | Signed-off-by: Shawn Landden <shawn@churchofgit.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* Config.in: Add a menu around BR2_EXTERNAL configuration optionsPeter Korsgaard2013-12-081-4/+0
| | | | | | | | | | | | | | | To make it clear to the user that these options are external to Buildroot and no support is provided by the Buildroot community. With this, there's no need to recommend people to their options inside a menu, so remove that from the documentation. Kconfig nicely allows us to hide the menu completely if BR2_EXTERNAL isn't used, so make use of that to not confuse people. It would be nice if we could add some help text to explain the BR2_EXTERNAL stuff as well, but that isn't supported on menus :/ Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* docs/manual: add explanations about BR2_EXTERNALThomas Petazzoni2013-12-082-0/+140
| | | | | | | | | | | | This commit updates the manual to add details on how to use the BR2_EXTERNAL feature. [Peter: minor tweaks, fix asciidoc tag as pointed out by Samuel] Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Reviewed-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Acked-by: "Samuel Martin" <s.martin49@gmail.com> Acked-by: Ryan Barnett <rjbarnet@rockwellcollins.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* core: introduce the BR2_EXTERNAL variableThomas Petazzoni2013-12-081-0/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This commit introduces the BR2_EXTERNAL environment variable, which will allow to keep Buildroot customization (board-specific configuration files or root filesystem overlays, package Config.in and makefiles, as well as defconfigs) outside of the Buildroot tree. This commit only introduces the variable itself, and ensures that it is available within Config.in options. This allows us to use $BR2_EXTERNAL in a 'source' statement in Config.in. Following patches extend the usage of BR2_EXTERNAL to other areas (packages and defconfigs). In details, this commit: * Introduces the BR2_EXTERNAL Kconfig option. This option has no prompt, and is therefore not visible to the user and also not stored in the .config file. It is automatically set to the value of the BR2_EXTERNAL environment variable. The only purpose of this BR2_EXTERNAL Kconfig option is to allow $BR2_EXTERNAL to be properly expanded when used inside Kconfig source statements. * Calculates the BR2_EXTERNAL value to use. If passed on the command line, then this value is taken in priority, and saved to a .br-external hidden file in the output directory. If not passed on the command line, then we read the .br-external file from the output directory. This allows the user to not pass the BR2_EXTERNAL value at each make invocation. If no BR2_EXTERNAL value is passed, we define it to support/dummy-external, so that the kconfig code finds an existing $(BR2_EXTERNAL)/package/Config.in file to include. * Passes the BR2_EXTERNAL into the *config environment, so that its value is found when parsing/evaluating Config.in files and .config values. Signed-off-by: Arnout Vandecappelle (Essensium/Mind) <arnout@mind.be> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com> Reviewed-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Tested-by: "Yann E. MORIN" <yann.morin.1998@free.fr> Acked-by: Ryan Barnett <rjbarnet@rockwellcollins.com> Tested-by: "Samuel Martin" <s.martin49@gmail.com> Acked-by: "Samuel Martin" <s.martin49@gmail.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
* manual: remove package clean commandsThomas De Schampheleire2013-12-085-13/+1
| | | | | Signed-off-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com> Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
OpenPOWER on IntegriCloud