rsb: Move "History" to own chapter

Move it to the end of the document.  It is auxiliary information.
This commit is contained in:
Sebastian Huber 2019-01-10 12:52:23 +01:00
parent e52906b556
commit 633a24fc69
3 changed files with 37 additions and 32 deletions

26
rsb/history.rst Normal file
View File

@ -0,0 +1,26 @@
.. SPDX-License-Identifier: CC-BY-SA-4.0
.. Copyright (C) 2012, 2016 Chris Johns <chrisj@rtems.org>
History
=======
The RTEMS Source Builder is a stand alone tool based on another tool called the
*SpecBuilder* written by Chris Johns. The *SpecBuilder* was written around 2010
for the RTEMS project to provide Chris with a way to build tools on hosts that
did not support RPMs. At the time the RTEMS tools maintainer only supported
*spec* files and these files held all the vital configuration data needed to
create suitable tool sets. The available SRPM and *spec* files by themselves
where of little use because a suitable ``rpm`` tool was needed to use them. At
the time the available versions of ``rpm`` for a number of non-RPM hosts were
broken and randomly maintained. The solution Chris settled on was to use the
*spec* files and to write a Python based tool that parsed the *spec* file
format creating a shell script that could be run to build the package. The
approach proved successful and Chris was able to track the RPM version of the
RTEMS tools on a non-RPM host for a number of years.
The *SpecBuilder* tool did not build tools or packages unrelated to the RTEMS
Project where no suitable *spec* file was available so another tool was
needed. Rather than start again Chris decided to take the parsing code for the
*spec* file format and build a new tool called the RTEMS Source Builder.

View File

@ -24,16 +24,17 @@ RTEMS Source Builder (|version|).
.. include:: ../common/header.rst .. include:: ../common/header.rst
.. toctree:: .. toctree::
:maxdepth: 5 :maxdepth: 5
:numbered: :numbered:
source-builder source-builder
building-tools-and-rtems.rst building-tools-and-rtems.rst
project-sets project-sets
cross-canadian-cross cross-canadian-cross
third-party-packages third-party-packages
configuration configuration
commands commands
bug-reporting bug-reporting
history
* :ref:`genindex` * :ref:`genindex`

View File

@ -133,28 +133,6 @@ own tool set that you install under your home directory. Avoiding installing
any extra packages as a super user is always helpful in maintaining a secure any extra packages as a super user is always helpful in maintaining a secure
computing environment. computing environment.
History
-------
The RTEMS Source Builder is a stand alone tool based on another tool called the
*SpecBuilder* written by Chris Johns. The *SpecBuilder* was written around 2010
for the RTEMS project to provide Chris with a way to build tools on hosts that
did not support RPMs. At the time the RTEMS tools maintainer only supported
*spec* files and these files held all the vital configuration data needed to
create suitable tool sets. The available SRPM and *spec* files by themselves
where of little use because a suitable ``rpm`` tool was needed to use them. At
the time the available versions of ``rpm`` for a number of non-RPM hosts were
broken and randomly maintained. The solution Chris settled on was to use the
*spec* files and to write a Python based tool that parsed the *spec* file
format creating a shell script that could be run to build the package. The
approach proved successful and Chris was able to track the RPM version of the
RTEMS tools on a non-RPM host for a number of years.
The *SpecBuilder* tool did not build tools or packages unrelated to the RTEMS
Project where no suitable *spec* file was available so another tool was
needed. Rather than start again Chris decided to take the parsing code for the
*spec* file format and build a new tool called the RTEMS Source Builder.
Controlling the Tools Build Controlling the Tools Build
--------------------------- ---------------------------