Changeset 27bcdfb in rtems-docs for user/start/releases.rst

Timestamp:

03/22/16 01:54:39 (7 years ago)

Author:

Chris Johns <chrisj@…>

Branches:

4.11, 5, am, master

Children:

2151927

Parents:

024e040

git-author:

Chris Johns <chrisj@…> (03/22/16 01:54:39)

git-committer:

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

Message:

Add a basics section to Getting Started. Rearrange the content.

File:

• user/start/releases.rst (modified) (7 diffs)

user/start/releases.rst

@@ -5 +5 @@
 
 Released Version
-----------------
+================
 .. index:: tarball
 .. index:: release
@@ -13 +13 @@
 older releases is provided using the RTEMS support channels.
 
-.. sidebar:: *GDB and Python*
-
-   RTEMS uses Python in GDB to aid debugging which means GDB needs to be built
-   with Python development libraries. Please check the RSB documentation and
-   install the packages specified for your host. Make sure a python development
-   package is included.
+Please read :ref:`development-hosts` before continuing.
 
 The following procedure assumes you have installed and configured your host
@@ -50 +45 @@
    kernel add the ``--without-rtems`` option to the RSB command line.
 
-   By default all the BSPs for an architecture are build. If you only wish to
+   By default all the BSPs for an architecture are built. If you only wish to
    have a specific BSP build you can specify the BSP list by providing to the
    RSB the option ``--with-rtemsbsp``. For example to build two BSPs for the
@@ -58 +53 @@
 
 RTEMS Tools Chain
-~~~~~~~~~~~~~~~~~
+-----------------
 
 Set up a suitable workspace to build the release in. On Unix:
@@ -94 +89 @@
  2016-03-21 10:50:11 (173 KB/s) - 'rtems-source-builder-4.11.0.tar.xz' saved [967056/967056]
 
-Unpack the RSB release tar file. On Unix:
+On Unix unpack the RSB release tar file using:
 
 .. code-block:: shell
@@ -101 +96 @@
  $ cd rtems-source-builder-4.11.0/rtems/
 
-When building on Windowss you need to shorten the path:
+On Windows you need to shorten the path (See :ref:`windows-path-length`) after
+you have unpacked the tar file:
 
 .. code-block:: shell
@@ -111 +107 @@
 Build a tool chain for the SPARC architecure. We are using the SPARC
 architecture in our example because GDB has a good simulator that lets us run
-and test the samples RTEMS builds by default:
+and test the samples RTEMS builds by default
+
+If building on Windows add ``--jobs=none`` to avoid GNU make issues on Windows.
 
 .. code-block:: shell