user: Update Quick Start Guide

- Add support for release source archives
- Add building the BSP using the RSB
- Add building packages using the RSB
- Add an application

Closes #2998

1 files changed, 39 insertions, 33 deletions

diff --git a/user/start/bootstrap.rst b/user/start/bootstrap.rst
index 9fcf79b..1594f89 100644
--- a/user/start/bootstrap.rst
+++ b/user/start/bootstrap.rst
@@ -8,48 +8,54 @@
 Bootstrap the RTEMS Sources
 ===========================
 
-You installed the tool suite in your installation prefix and cloned two RTEMS
-repositories in the previous sections.  We installed the tool suite in
-:file:`$HOME/quick-start/rtems/5` and cloned the repositories in
-:file:`$HOME/quick-start/src`.
+You installed the tool suite in your installation prefix and made ready the
+source for two RTEMS source packages in the previous sections.  We installed
+the tool suite in :file:`$HOME/quick-start/rtems/5` and unpacked the RSB source
+in :file:`$HOME/quick-start/src`.
 
-If you use source archives of a released RTEMS version, then you can skip this
-section.
+You only need to *bootstrap* the RTEMS sources if you have used
+:ref:`QuickStartSources_Git` to get the sources. If you use source archives of
+a released RTEMS version you can skip this section and move to
+:ref:`QuickStartBSPBuild`.
 
 Before you can build a :ref:`Board Support Package (BSP) <BSPs>` for your
-target hardware, you have to bootstrap the build system in the RTEMS sources.
-This is only necessary, if you use a Git repository clone of the RTEMS sources.
-You have to do this after a fresh repository clone and sometimes after build
-system file updates (e.g.  after a ``git pull``).  If you are not a build
-system expert, then do the bootstrap after each update of build system files.
-This is a bit annoying, but improving the build system is a complex and time
-consuming undertaking.  Feel free to help the RTEMS Project to improve it.  For
-the bootstrap it is important that the right version of Autotools
-(:file:`autoconf` and :file:`automake`) are in your ``$PATH``.  The right
-version of Autotools is shipped with the RTEMS tool suite you already
-installed.
+target hardware from Git cloned RTEMS sources, you have to bootstrap the build
+system in the RTEMS sources.  This is only necessary if you use a Git
+repository clone of the RTEMS sources.  You have to do this after a fresh
+repository clone and sometimes after build system file updates (e.g.  after a
+``git pull``).  If you are not a build system expert, then do the bootstrap
+after each update of build system files.  This is a bit annoying, but improving
+the build system is a complex and time consuming undertaking.  Feel free to
+help the RTEMS Project to improve it.  For the bootstrap it is important that
+the right version of Autotools (:file:`autoconf` and :file:`automake`) are in
+your ``$PATH``.  The right version of Autotools is shipped with the RTEMS tool
+suite you already installed. Set the path to the tool suite installed under
+your selected *prefix*:
 
 .. code-block:: none
 
-    cd $HOME/quick-start/src/rtems
     export PATH=$HOME/quick-start/rtems/5/bin:"$PATH"
-    ./bootstrap -c
-    $HOME/quick-start/src/rsb/source-builder/sb-bootstrap
 
-These commands should output something like this (omitted lines are denoted by
-...):
+Change into the RTEMS source tree to *bootstrap* the build system:
+
+.. code-block:: none
+
+    cd $HOME/quick-start/src/rtems
+    ./rtems-bootstrap
+
+This command should output something like this (omitted lines are denoted by
+``...``):
 
 .. code-block:: none
 
-    removing automake generated Makefile.in files
-    removing configure files
-    removing aclocal.m4 files
-    $ $HOME/quick-start/src/rsb/source-builder/sb-bootstrap
-    RTEMS Source Builder - RTEMS Bootstrap, 5 (f07504d27192)
-      1/120: autoreconf: configure.ac
-      2/120: autoreconf: c/configure.ac
-      3/120: autoreconf: c/src/configure.ac
-      4/120: autoreconf: c/src/lib/libbsp/arm/configure.ac
+    RTEMS Bootstrap, 1.0
+      1/122: autoreconf: configure.ac
+      2/122: autoreconf: testsuites/configure.ac
+      3/122: autoreconf: testsuites/fstests/configure.ac
+      4/122: autoreconf: testsuites/smptests/configure.ac
+      5/122: autoreconf: testsuites/psxtests/configure.ac
+      6/122: autoreconf: testsuites/mptests/configure.ac
     ...
-    120/120: autoreconf: testsuites/tmtests/configure.ac
-    Bootstrap time: 0:00:48.744222
+    121/122: autoreconf: c/src/lib/libbsp/lm32/milkymist/configure.ac
+    122/122: autoreconf: c/src/make/configure.ac
+    Bootstrap time: 0:00:46.404643