rsb: Move content of duplicate section

Move "Controlling the Tools Build" section and "Building Tools and
RTEMS" chapter to "Project Sets" chapter and "RTEMS" section.
This commit is contained in:
Sebastian Huber 2019-01-10 12:52:25 +01:00
parent 9e18bcba87
commit f95699b71f
4 changed files with 24 additions and 66 deletions

View File

@ -1,37 +0,0 @@
.. SPDX-License-Identifier: CC-BY-SA-4.0
.. Copyright (C) 2012, 2018 Chris Johns <chrisj@rtems.org>
Building Tools and RTEMS
========================
The Quick Start section of the RTEMS Users Guide covers the typical
information and process needed to build both an RTEMS toolset and
RTEMS itself. This section has information on specific configuration
options that may be needed.
Controlling the Build
---------------------
Build sets can be controlled via the command line to enable and disable various
features. There is no definitive list of build options that can be listed
because they are implemented with the configuration scripts. The best way to
find what is available is to grep the configuration files. for ``with`` and
``without``.
Following are currently available:
``--without-rtems``
Do not build RTEMS when building an RTEMS build set.
``--without-cxx``
Do not build a C++ compiler.
``--with-ada``
Attempt to build an Ada compiler. You need a native GNAT installed.
``--with-fortran``
Attempt to build a Fortran compiler.
``--with-objc``
Attempt to build a C++ compiler.

View File

@ -29,7 +29,6 @@ RTEMS Source Builder (|version|).
source-builder source-builder
why-build-from-source.rst why-build-from-source.rst
building-tools-and-rtems.rst
project-sets project-sets
cross-canadian-cross cross-canadian-cross
third-party-packages third-party-packages

View File

@ -29,6 +29,12 @@ various tools. You can specialise these in your private configurations to make
use of them. If you add new generic configurations please contribute them back use of them. If you add new generic configurations please contribute them back
to the project to the project
Build sets can be controlled via the command line to enable
(``--with-<feature>``) and disable (``--without-<feature>``) various features.
There is no definitive list of build options that can be listed because they
are implemented with the configuration scripts. The best way to find what is
available is to grep the configuration files for ``with`` and ``without``.
Bare Metal Bare Metal
---------- ----------
@ -134,6 +140,24 @@ and the following uses the version control heads for ``binutils``, ``gcc``,
--macros=snapshots/binutils-gcc-newlib-gdb-head.mc \ --macros=snapshots/binutils-gcc-newlib-gdb-head.mc \
4.11/rtems-sparc 4.11/rtems-sparc
Following features can be enabled/disabled via the command line for the RTEMS
build sets:
``--without-rtems``
Do not build RTEMS when building an RTEMS build set.
``--without-cxx``
Do not build a C++ compiler.
``--with-ada``
Attempt to build an Ada compiler. You need a native GNAT installed.
``--with-fortran``
Attempt to build a Fortran compiler.
``--with-objc``
Attempt to build a C++ compiler.
Patches Patches
------- -------

View File

@ -76,31 +76,3 @@ configuration can read the remaining sections.
If you think you have found a problem please see :ref:`Bugs, Crashes, and If you think you have found a problem please see :ref:`Bugs, Crashes, and
Build Failures`. Build Failures`.
Controlling the Tools Build
---------------------------
Build sets can be controlled via the command line to enable and disable various
features. There is no definitive list of build options that can be listed
because they are implemented with the configuration scripts. The best way to
find what is available is to grep the configuration files. for ``with`` and
``without``.
Following are currently available:
``--without-rtems``
Do not build RTEMS when building an RTEMS build set.
``--without-cxx``
Do not build a C++ compiler.
``--with-ada``
Attempt to build an Ada compiler. You need a native GNAT installed.
``--with-fortran``
Attempt to build a Fortran compiler.
``--with-objc``
Attempt to build a C++ compiler.