From 5353914b846b76b1f4a29c3219d0741e1cddea1b Mon Sep 17 00:00:00 2001 From: Chris Johns Date: Mon, 21 Mar 2016 10:27:52 +1100 Subject: Updates from user reviews. --- user/start/development.rst | 34 ++++++++++++++++------------------ user/start/windows.rst | 17 ++++++++++++----- 2 files changed, 28 insertions(+), 23 deletions(-) (limited to 'user') 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 -- cgit v1.2.3