Changeset 5353914 in rtems-docs

Timestamp:

03/20/16 23:27:52 (7 years ago)

Author:

Chris Johns <chrisj@…>

Branches:

4.11, 5, am, master

Children:

024e040

Parents:

924c542

git-author:

Chris Johns <chrisj@…> (03/20/16 23:27:52)

git-committer:

Amar Takhar <verm@…> (05/03/16 00:51:27)

Message:

Updates from user reviews.

Files:

• common/rtemsstyle.sty (modified) (1 diff)
• user/start/development.rst (modified) (3 diffs)
• user/start/windows.rst (modified) (3 diffs)

common/rtemsstyle.sty

@@ -18 +18 @@
 \fvset{
 breaklines=true,
+breakanywhere=true,
 linenos,
 numbersep=5pt,

user/start/development.rst

@@ -240 +240 @@
   Checking connectivity... done.
 
-The developers version of the code from git requires ``bootstrapping``. This is
-an ``autoconf`` and ``automake`` bootstrap to create the various files generated
-by ``autoconf`` and ``automake``. RTEMS does not keep these generated files
-under version control. The bootstrap process is slow so to speed it up the RSB
-provides a command that can perform the bootstrap in parallel using your
-available cores:
-
-.. code-block:: shell
-
+The developers version of the code from git requires we ``bootstrap`` the
+source code. This is an ``autoconf`` and ``automake`` bootstrap to create the
+various files generated by ``autoconf`` and ``automake``. RTEMS does not keep
+these generated files under version control. The bootstrap process is slow so
+to speed it up the RSB provides a command that can perform the bootstrap in
+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
@@ -441 +443 @@
   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
@@ -455 +453 @@
    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[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]: Entering directory '/home/chris/development/rtems/kernel/erc32/sparc-rtems4.12/c/erc32/testsuites'
+  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[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]: Nothing to be done for 'all-am'.
-  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[2]: Leaving directory '/home/chris/development/rtems/kernel/erc32/sparc-rtems4.12/c/erc32'
+  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[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'

user/start/windows.rst

@@ -51 +51 @@
 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
@@ -420 +427 @@
 
    /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
@@ -459 +466 @@
   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
-   redirect:  http://iweb.dl.sourceforge.net/project/expat/expat/2.1.0/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
   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