Updates from user reviews.

common/rtemsstyle.sty

@@ -17,6 +17,7 @@
 \usepackage{minted}
 \fvset{
 breaklines=true,
+breakanywhere=true,
 linenos,
 numbersep=5pt,
 gobble=0,

user/start/development.rst

@@ -239,17 +239,19 @@ Clone the RTEMS respository:
   Resolving deltas: 100% (390053/390053), done.
   Checking connectivity... done.
 
-The developers version of the code from git requires ``bootstrapping``. This is
+The developers version of the code from git requires we ``bootstrap`` the
-an ``autoconf`` and ``automake`` bootstrap to create the various files generated
+source code. This is an ``autoconf`` and ``automake`` bootstrap to create the
-by ``autoconf`` and ``automake``. RTEMS does not keep these generated files
+various files generated by ``autoconf`` and ``automake``. RTEMS does not keep
-under version control. The bootstrap process is slow so to speed it up the RSB
+these generated files under version control. The bootstrap process is slow so
-provides a command that can perform the bootstrap in parallel using your
+to speed it up the RSB provides a command that can perform the bootstrap in
-available cores:
+parallel using your available cores. We need to enter the cloned source
+directory then run the bootsrap commands:
 
 .. code-block:: shell
 
+  $ cd rtems
   $ ./bootstrap -c && ./bootstrap -p && \
-              $HOME/development/rtems/rsb/rsb/source-builder/sb-bootstrap
+              $HOME/development/rtems/rsb/source-builder/sb-bootstrap
   removing automake generated Makefile.in files
   removing configure files
   removing aclocal.m4 files
@@ -440,10 +442,6 @@ Build RTEMS using two cores:
   checking build system type... x86_64-pc-linux-gnu
   checking host system type... sparc-unknown-rtems4.12
    ......
-  cp paranoia.exe paranoia.ralf
-  make[6]: Leaving directory '/home/chris/development/rtems/kernel/erc32/sparc-rtems4.12/c/erc32/testsuites/samples/paranoia'
-  Making all in nsecs
-  make[6]: Entering directory '/home/chris/development/rtems/kernel/erc32/sparc-rtems4.12/c/erc32/testsuites/samples/nsecs'
   sparc-rtems4.12-gcc -B../../../../../erc32/lib/ -specs bsp_specs -qrtems -DHAVE_CONFIG_H -I. -I/home/chris/development/rtems/kernel/rtems/c/src/../../testsuites/samples/nsecs -I.. -I/home/chris/development/rtems/kernel/rtems/c/src/../../testsuites/samples/../support/include   -mcpu=cypress -O2 -g -ffunction-sections -fdata-sections -Wall -Wmissing-prototypes -Wimplicit-function-declaration -Wstrict-prototypes -Wnested-externs -MT init.o -MD -MP -MF .deps/init.Tpo -c -o init.o /home/chris/development/rtems/kernel/rtems/c/src/../../testsuites/samples/nsecs/init.c
   sparc-rtems4.12-gcc -B../../../../../erc32/lib/ -specs bsp_specs -qrtems -DHAVE_CONFIG_H -I. -I/home/chris/development/rtems/kernel/rtems/c/src/../../testsuites/samples/nsecs -I.. -I/home/chris/development/rtems/kernel/rtems/c/src/../../testsuites/samples/../support/include   -mcpu=cypress -O2 -g -ffunction-sections -fdata-sections -Wall -Wmissing-prototypes -Wimplicit-function-declaration -Wstrict-prototypes -Wnested-externs -MT empty.o -MD -MP -MF .deps/empty.Tpo -c -o empty.o /home/chris/development/rtems/kernel/rtems/c/src/../../testsuites/samples/nsecs/empty.c
   mv -f .deps/empty.Tpo .deps/empty.Po
@@ -454,14 +452,14 @@ Build RTEMS using two cores:
      text    data     bss     dec     hex filename
    121392    1888    6624  129904   1fb70 nsecs.exe
   cp nsecs.exe nsecs.ralf
-  make[6]: Leaving directory '/home/chris/development/rtems/kernel/erc32/sparc-rtems4.12/c/erc32/testsuites/samples/nsecs'
+  make[6]: Leaving directory '/home/chris/development/rtems/kernel/erc32/sparc-rtems4.12/ c/erc32/testsuites/samples/nsecs'
-  make[5]: Leaving directory '/home/chris/development/rtems/kernel/erc32/sparc-rtems4.12/c/erc32/testsuites/samples'
+  make[5]: Leaving directory '/home/chris/development/rtems/kernel/erc32/sparc-rtems4.12/ c/erc32/testsuites/samples'
-  make[4]: Leaving directory '/home/chris/development/rtems/kernel/erc32/sparc-rtems4.12/c/erc32/testsuites/samples'
+  make[4]: Leaving directory '/home/chris/development/rtems/kernel/erc32/sparc-rtems4.12/ c/erc32/testsuites/samples'
-  make[4]: Entering directory '/home/chris/development/rtems/kernel/erc32/sparc-rtems4.12/c/erc32/testsuites'
+  make[4]: Entering directory '/home/chris/development/rtems/kernel/erc32/sparc-rtems4.12/ c/erc32/testsuites'
   make[4]: Nothing to be done for 'all-am'.
-  make[4]: Leaving directory '/home/chris/development/rtems/kernel/erc32/sparc-rtems4.12/c/erc32/testsuites'
+  make[4]: Leaving directory '/home/chris/development/rtems/kernel/erc32/sparc-rtems4.12/ c/erc32/testsuites'
-  make[3]: Leaving directory '/home/chris/development/rtems/kernel/erc32/sparc-rtems4.12/c/erc32/testsuites'
+  make[3]: Leaving directory '/home/chris/development/rtems/kernel/erc32/sparc-rtems4.12/ c/erc32/testsuites'
-  make[2]: Leaving directory '/home/chris/development/rtems/kernel/erc32/sparc-rtems4.12/c/erc32'
+  make[2]: Leaving directory '/home/chris/development/rtems/kernel/erc32/sparc-rtems4.12/ c/erc32'
   make[1]: Leaving directory '/home/chris/development/rtems/kernel/erc32/sparc-rtems4.12/c'
   make[1]: Entering directory '/home/chris/development/rtems/kernel/erc32'
   make[1]: Nothing to be done for 'all-am'.

user/start/windows.rst

@@ -50,7 +50,14 @@ characters. This can effect some of the tools used by RTEMS. It is recommended
 you keep the top level directories as short as possible when building the RTEMS
 tools and you also keep an eye on the path length when developing your
 application. The RTEMS built tools can handle much longer path lengths however
-some of the GNU tools such as those in the ``binutils`` package cannot.
+some of the GNU tools such as those in the ``binutils`` package cannot. The
+release packages of the RSB are too big to build RTEMS so you need to change
+that path to build.
+
+The MSYS2 GNU ``make`` has problems when using the `jobs` option. The RSB
+defaults to automatically using as many cores as the host machine has. To get a
+successful build on Windows it is recommended you add the ``--jobs=none``
+option to all RSB build set commands.
 
 POSIX Support
 ~~~~~~~~~~~~~
@@ -419,7 +426,7 @@ To build a set of RTEMS tools for the Intel ``i386`` architecture:
 .. code-block:: shell
 
    /c/opt/rtems/rsb/rtems
-  $ ../source-builder/sb-set-builder --prefix=/c/opt/rtems/4.11 4.11/rtems-i386
+  $ ../source-builder/sb-set-builder --prefix=/c/opt/rtems/4.11 --jobs=none 4.11/rtems-i386
   RTEMS Source Builder - Set Builder, 4.11 (01ac76f2f90f)
   Build Set: 4.11/rtems-i386
   Build Set: 4.11/rtems-autotools.bset
@@ -458,10 +465,10 @@ To build a set of RTEMS tools for the Intel ``i386`` architecture:
   Build Set: Time 0:01:20.234375
   config: devel/expat-2.1.0-1.cfg
   package: expat-2.1.0-x86_64-w64-mingw32-1
-  download:   http://downloads.sourceforge.net/project/expat/expat/2.1.0/expat-2.1.0.tar.gz -> sources/expat-2.1.0.tar.gz
+  download: http://downloads.sourceforge.net/project/expat/expat/2.1.0/expat-2.1.0.tar.gz -> sources/expat-2.1.0.tar.gz
-   redirect:  http://iweb.dl.sourceforge.net/project/expat/expat/2.1.0/expat-2.1.0.tar.gz
+   redirect: http://iweb.dl.sourceforge.net/project/expat/expat/2.1.0/expat-2.1.0.tar.gz
   downloading: sources/expat-2.1.0.tar.gz - 549.4kB of 549.4kB (100%)
-   building: expat-2.1.0-x86_64-w64-mingw32-1
+  building: expat-2.1.0-x86_64-w64-mingw32-1
   reporting: devel/expat-2.1.0-1.cfg -> expat-2.1.0-x86_64-w64-mingw32-1.txt
   reporting: devel/expat-2.1.0-1.cfg -> expat-2.1.0-x86_64-w64-mingw32-1.xml
   config: tools/rtems-binutils-2.24-1.cfg