summaryrefslogtreecommitdiffstats
path: root/develenv/introduction.rst
diff options
context:
space:
mode:
authorChris Johns <chrisj@rtems.org>2016-10-27 16:12:50 -0700
committerChris Johns <chrisj@rtems.org>2016-10-27 16:13:03 -0700
commit9b53679540443784bc0dba6426b1a8a2da9f6b37 (patch)
treef049208fc21f94be6f5bb523789654878f3298cd /develenv/introduction.rst
parentcommon/waf.py: Improve Sphinx version parsing to work with their git master (diff)
downloadrtems-docs-9b53679540443784bc0dba6426b1a8a2da9f6b37.tar.bz2
Fix develenv. Needs more fixes.
Diffstat (limited to 'develenv/introduction.rst')
-rw-r--r--develenv/introduction.rst74
1 files changed, 32 insertions, 42 deletions
diff --git a/develenv/introduction.rst b/develenv/introduction.rst
index 8bb701e..3332bee 100644
--- a/develenv/introduction.rst
+++ b/develenv/introduction.rst
@@ -1,56 +1,46 @@
.. comment SPDX-License-Identifier: CC-BY-SA-4.0
+.. COMMENT: COPYRIGHT (c) 1989-2010.
+.. COMMENT: On-Line Applications Research Corporation (OAR).
+.. COMMENT: All rights reserved.
+
============
Introduction
============
-This document describes the RTEMS development
-environment. Discussions are provided for the following topics:
+This document describes the RTEMS development environment. Discussions are
+provided for the following topics:
- the directory structure used by RTEMS,
-- usage of the GNU Make utility within the RTEMS
- development environment,
+- usage of the GNU Make utility within the RTEMS development environment,
- sample applications, and
- the RTEMS specific utilities.
-RTEMS was designed as a reusable software component.
-Highly reusable software such as RTEMS is typically distributed
-in the form of source code without providing any support tools.
-RTEMS is the foundation for a complex family of facilities
-including board support packages, device drivers, and support
-libraries. The RTEMS Development Environment is not a CASE
-tool. It is a collection of tools designed to reduce the
-complexity of using and enhancing the RTEMS family. Tools are
-provided which aid in the management of the development,
-maintenance, and usage of RTEMS, its run-time support
-facilities, and applications which utilize the executive.
-
-A key component of the RTEMS development environment
-is the GNU family of free tools. This is robust set of
-development and POSIX compatible tools for which source code is
-freely available. The primary compilers, assemblers, linkers,
-and make utility used by the RTEMS development team are the GNU
-tools. They are highly portable supporting a wide variety of
-host computers and, in the case of the development tools, a wide
-variety of target processors.
-
-It is recommended that the RTEMS developer become
-familiar with the RTEMS Development Environment before
-proceeding with any modifications to the executive source tree.
-The source code for the executive is very modular and source
-code is divided amongst directories based upon functionality as
-well as dependencies on CPU and target board. This organization
-is aimed at isolating and minimizing non-portable code. This
-has the immediate result that adding support for a new CPU or
-target board requires very little "wandering" around the source
-tree.
-
-.. COMMENT: COPYRIGHT (c) 1989-2010.
-
-.. COMMENT: On-Line Applications Research Corporation (OAR).
-
-.. COMMENT: All rights reserved.
-
+RTEMS was designed as a reusable software component. Highly reusable software
+such as RTEMS is typically distributed in the form of source code without
+providing any support tools. RTEMS is the foundation for a complex family of
+facilities including board support packages, device drivers, and support
+libraries. The RTEMS Development Environment is not a CASE tool. It is a
+collection of tools designed to reduce the complexity of using and enhancing
+the RTEMS family. Tools are provided which aid in the management of the
+development, maintenance, and usage of RTEMS, its run-time support facilities,
+and applications which utilize the executive.
+
+A key component of the RTEMS development environment is the GNU family of free
+tools. This is robust set of development and POSIX compatible tools for which
+source code is freely available. The primary compilers, assemblers, linkers,
+and make utility used by the RTEMS development team are the GNU tools. They
+are highly portable supporting a wide variety of host computers and, in the
+case of the development tools, a wide variety of target processors.
+
+It is recommended that the RTEMS developer become familiar with the RTEMS
+Development Environment before proceeding with any modifications to the
+executive source tree. The source code for the executive is very modular and
+source code is divided amongst directories based upon functionality as well as
+dependencies on CPU and target board. This organization is aimed at isolating
+and minimizing non-portable code. This has the immediate result that adding
+support for a new CPU or target board requires very little "wandering" around
+the source tree.