manual: high-level restructuring
authorThomas De Schampheleire <patrickdepinguin@gmail.com>
Tue, 12 Aug 2014 20:20:06 +0000 (22:20 +0200)
committerThomas Petazzoni <thomas.petazzoni@free-electrons.com>
Sun, 17 Aug 2014 19:09:52 +0000 (21:09 +0200)
commit569db405741dfee119ebb211722f588557b83542
tree41f6fe67c0b5d1b5f114d7a4a07c4e53921c05bd
parent7fa43f911be83555df8789e4739816e762e1ff26
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>
22 files changed:
docs/manual/advanced.txt
docs/manual/appendix.txt
docs/manual/beyond-buildroot.txt
docs/manual/ccache-support.txt
docs/manual/contribute.txt
docs/manual/developer-guide.txt
docs/manual/download-location.txt
docs/manual/faq-troubleshooting.txt
docs/manual/get-involved.txt
docs/manual/going-further.txt
docs/manual/how-buildroot-works.txt
docs/manual/introduction.txt
docs/manual/known-issues.txt
docs/manual/legal-notice.txt
docs/manual/manual.mk
docs/manual/manual.txt
docs/manual/package-make-target.txt
docs/manual/starting-up.txt
docs/manual/using-buildroot-debugger.txt
docs/manual/using-buildroot-development.txt
docs/manual/using-buildroot-toolchain.txt
docs/manual/working-with.txt