manual/getting started: rework 'System requirements' section

This patch reworks the requirements section of the manual as follows:
- some general rewording
- move configuration editor dependencies above the download tools, as this
  is the first thing people come in contact with.
- move sentence regarding -dev packages to configuration editor dependencies
  and restrict to 'libraries'.
- clarify the download tools part.

Signed-off-by: Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
This commit is contained in:
Thomas De Schampheleire 2014-08-12 22:20:10 +02:00 committed by Thomas Petazzoni
parent 713134fc92
commit 9c353541ff

View File

@ -6,13 +6,11 @@
Buildroot is designed to run on Linux systems. Buildroot is designed to run on Linux systems.
Buildroot needs some software to be already installed on the host While Buildroot itself will build most host packages it needs for the
system; here are the lists of the mandatory and optional packages compilation, certain standard Linux utilities are expected to be
(package names may vary between distributions). already installed on the host system. Below you will find an overview of
the mandatory and optional packages (note that package names may vary
Take care to _install both runtime and development data_, especially between distributions).
for the libraries that may be packaged in 2 distinct packages.
[[requirement-mandatory]] [[requirement-mandatory]]
@ -45,14 +43,25 @@ for the libraries that may be packaged in 2 distinct packages.
=== Optional packages === Optional packages
* Configuration interface dependencies:
+
For these libraries, you need to install both runtime and development
data, which in many distributions are packaged separately. The
development packages typically have a _-dev_ or _-devel_ suffix.
+
** +ncurses5+ to use the 'menuconfig' interface
** +qt4+ to use the 'xconfig' interface
** +glib2+, +gtk2+ and +glade2+ to use the 'gconfig' interface
* Source fetching tools: * Source fetching tools:
+ +
In the official tree, most of the package sources are retrieved In the official tree, most of the package sources are retrieved using
using +wget+; a few are only available through their +git+, +mercurial+, +wget+ from _ftp_, _http_ or _https_ locations. A few packages are only
+svn+ or +cvs+ repository. available through a version control system. Moreover, Buildroot is
+ capable of downloading sources via other tools, like +rsync+ or +scp+
All other source fetching methods are implemented and may be used in a (refer to xref:download-infra[] for more details). If you enable
development context (further details: refer to xref:download-infra[]). packages using any of these methods, you will need to install the
corresponding tool on the host system:
+ +
** +bazaar+ ** +bazaar+
** +cvs+ ** +cvs+
@ -62,11 +71,6 @@ development context (further details: refer to xref:download-infra[]).
** +scp+ ** +scp+
** +subversion+ ** +subversion+
* Configuration interface dependencies (requires development libraries):
** +ncurses5+ to use the 'menuconfig' interface
** +qt4+ to use the 'xconfig' interface
** +glib2+, +gtk2+ and +glade2+ to use the 'gconfig' interface
* Java-related packages, if the Java Classpath needs to be built for * Java-related packages, if the Java Classpath needs to be built for
the target system: the target system:
** The +javac+ compiler ** The +javac+ compiler