2012-11-11 04:14:42 +01:00
|
|
|
// -*- mode:doc; -*-
|
2013-02-13 13:59:02 +01:00
|
|
|
// vim: set syntax=asciidoc:
|
2012-11-11 04:14:42 +01:00
|
|
|
|
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
|
|
|
==== Location of downloaded packages
|
2011-10-10 10:46:39 +02:00
|
|
|
|
2012-12-29 05:42:33 +01:00
|
|
|
The various tarballs that are downloaded by Buildroot are all stored
|
|
|
|
|
in +BR2_DL_DIR+, which by default is the +dl+ directory. If you want
|
2011-10-10 10:46:39 +02:00
|
|
|
to keep a complete version of Buildroot which is known to be working
|
2012-11-27 12:59:17 +01:00
|
|
|
with the associated tarballs, you can make a copy of this directory.
|
2012-12-29 05:42:33 +01:00
|
|
|
This will allow you to regenerate the toolchain and the target
|
|
|
|
|
filesystem with exactly the same versions.
|
2011-10-10 10:46:39 +02:00
|
|
|
|
|
|
|
|
If you maintain several Buildroot trees, it might be better to have a
|
2012-12-29 05:42:33 +01:00
|
|
|
shared download location. This can be achieved by pointing the
|
2014-12-19 08:12:33 +01:00
|
|
|
+BR2_DL_DIR+ environment variable to a directory. If this is
|
2012-12-29 05:42:33 +01:00
|
|
|
set, then the value of +BR2_DL_DIR+ in the Buildroot configuration is
|
|
|
|
|
overridden. The following line should be added to +<~/.bashrc>+.
|
2011-10-10 10:46:39 +02:00
|
|
|
|
|
|
|
|
-----------------
|
2015-11-11 18:47:41 +01:00
|
|
|
export BR2_DL_DIR=<shared download location>
|
2011-10-10 10:46:39 +02:00
|
|
|
-----------------
|
2012-11-27 12:59:17 +01:00
|
|
|
|
|
|
|
|
The download location can also be set in the +.config+ file, with the
|
2014-02-04 16:18:51 +01:00
|
|
|
+BR2_DL_DIR+ option. Unlike most options in the .config file, this value
|
|
|
|
|
is overridden by the +BR2_DL_DIR+ environment variable.
|
