summaryrefslogtreecommitdiffstats
path: root/user
diff options
context:
space:
mode:
authorChris Johns <chrisj@rtems.org>2016-03-21 10:27:52 +1100
committerAmar Takhar <verm@darkbeer.org>2016-05-02 20:51:27 -0400
commit5353914b846b76b1f4a29c3219d0741e1cddea1b (patch)
tree5f33b10c033d171f62dbd31fad9182a9ef7ea5ac /user
parent924c5429b06587adcf799192d22eaa71e9b16319 (diff)
downloadrtems-docs-5353914b846b76b1f4a29c3219d0741e1cddea1b.tar.bz2
Updates from user reviews.
Diffstat (limited to 'user')
-rw-r--r--user/start/development.rst34
-rw-r--r--user/start/windows.rst17
2 files changed, 28 insertions, 23 deletions
diff --git a/user/start/development.rst b/user/start/development.rst
index 15000d9..057dd3d 100644
--- a/user/start/development.rst
+++ b/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
-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:
+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
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[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'
make[1]: Nothing to be done for 'all-am'.
diff --git a/user/start/windows.rst b/user/start/windows.rst
index 307e137..ee7e34f 100644
--- a/user/start/windows.rst
+++ b/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
- 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
config: tools/rtems-binutils-2.24-1.cfg