Changeset c075916 in rtems-docs

Timestamp:

03/23/16 02:18:56 (6 years ago)

Author:

Chris Johns <chrisj@…>

Branches:

4.11, 5, am, master

Children:

dc234b5

Parents:

2151927

git-author:

Chris Johns <chrisj@…> (03/23/16 02:18:56)

git-committer:

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

Message:

Corrections and improvements from Worth Burruss (thanks so much).

Location:

user/start

Files:

• depend.rst (modified) (2 diffs)
• windows.rst (modified) (8 diffs)

user/start/depend.rst

@@ -157 +157 @@
 operating systems.
 
+Building is known to work on `Windows 7 64bit Professional` and `Windows 10`.
+
 .. _windows-path-length:
 
@@ -235 +237 @@
 documentation on how to use ``pacman``. What is shown here is a just few
 examples of what you can do.
+
+.. sidebar:: **Pin MSYS2 Shell to Taskbar**
+
+   Pin the MSYS2 64bit Shell to the Taskbar so you always use it rather than
+   the 32bit Shell.
 
 Open a 64bit MSYS shell from the Start Menu:

user/start/windows.rst

@@ -9 +9 @@
 
 This section details how you create an RTEMS development environment on
-Windows. The installation documented here is on `Windows 7 64bit Professional`.
+Windows. The installation documented here is on `Windows 7 64bit
+Professional`. Building on `Windows 10` has been reported as working.
 
 Please see :ref:`microsoft-windows` before continuing.
+
+.. note::
+
+   If the RSB reports ``error: no hosts defaults found; please add`` you have
+   probably opened an MSYS2 32bit Shell. Close all 32bit Shell windows and open
+   the MSYS2 64bit Shell.
 
 RTEMS Tools
@@ -32 +39 @@
 another drive please subsitute ``/c`` with your drive letter.
 
-We build and install all RTEMS packages under the `prefix` we just created. Change to that
-directory and get a copy of the RSB:
+We build and install all RTEMS packages under the `prefix` we just
+created. Change to that directory and get a copy of the RSB:
 
 .. code-block:: shell
@@ -76 +83 @@
   $
 
-To build a set of RTEMS tools for the Intel ``i386`` architecture:
+To build a set of RTEMS tools for the Intel ``i386`` architecture. The build
+runs a single job rather a job per CPU in your machine and will take a long
+time so please be patient. The RSB creates a log file containing all the build
+output and it will be changing size. The RSB command to build ``i386`` tools
+is:
 
 .. code-block:: shell
 
    /c/opt/rtems/rsb/rtems
-  $ ../source-builder/sb-set-builder --prefix=/c/opt/rtems/4.11 --jobs=none 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
@@ -197 +209 @@
 .. code-block:: shell
 
+   /c
+  $ cd /c/opt/rtems
    /c/opt/rtems
   $ export PATH=/c/opt/rtems/4.11/bin:$PATH
@@ -234 +248 @@
 clean away any files, then generate the pre-install header file lists and
 finally we generate the ``autoconf`` and ``automake`` files using the RSB's
-bootstrap tool.
+bootstrap tool. First we clean any generated files that exist:
 
 .. code-block:: shell
@@ -243 +257 @@
   removing configure files
   removing aclocal.m4 files
+
+Then we generate the pre-install header file automake make files:
+
+.. code-block:: shell
+
    /c/opt/rtems/kernel/rtems
   $ ./bootstrap -p
@@ -269 +288 @@
   Generating ./cpukit/zlib/preinstall.am
    /c/opt/rtems/kernel/rtems
+
+Finally we run the RSB's parallel ``bootstrap`` command:
+
+.. code-block:: shell
+
   $ /c/opt/rtems/rsb/source-builder/sb-bootstrap
   RTEMS Source Builder - RTEMS Bootstrap, 4.11 (76188ee494dd)
@@ -315 +339 @@
 
 Configure the RTEMS kernel to build ``pc686`` BSP for the ``i386`` target with
-netwoeking disabled, We will build the externel libBSD stack later:
+networking disabled, We will build the external libBSD stack later:
 
 .. code-block:: shell