Changeset 1accbe3 in rtems-docs

Timestamp:

03/15/17 01:34:19 (7 years ago)

Author:

Chris Johns <chrisj@…>

Branches:

5, master

Children:

f97be09

Parents:

91d6c96

git-author:

Chris Johns <chrisj@…> (03/15/17 01:34:19)

git-committer:

Chris Johns <chrisj@…> (03/15/17 04:03:41)

Message:

user: Add tool commands to the user manual.

Files:

• common/_static/my-styles.css (modified) (1 diff)
• user/index.rst (modified) (1 diff)
• user/tools/bsp-builder.rst (added)
• user/tools/build.rst (deleted)
• user/tools/exeinfo.rst (added)
• user/tools/index.rst (modified) (1 diff)
• user/tools/linker.rst (added)
• user/tools/symbols.rst (added)

common/_static/my-styles.css

@@ -112 +112 @@
 
 /*
+ * Option description name.
+ */
+.rst-content dl:not(.docutils) dt {
+    background: transparent;
+    color: #11111111;
+    border-top: 0px;
+}
+
+/*
  * Nav side-bar in RTEMS colours.
  */

user/index.rst

@@ -29 +29 @@
         hardware/index
 
+        tools/index
+
         support/index
         additional/index

user/tools/index.rst

@@ -1 +1 @@
 .. comment SPDX-License-Identifier: CC-BY-SA-4.0
 
-.. comment: Copyright (c) 2016 Chris Johns <chrisj@rtems.org>
+.. comment: Copyright (c) 2017 Chris Johns <chrisj@rtems.org>
 .. comment: All rights reserved.
 
-RTEMS Tools
-***********
+Tools
+*****
 
-The RTEMS kernel is cross-compiled on host computers and linked to 3rd party
-packages and application code and run on target hardware. This section details
-how to build asuitable cross-compiler and how to use the tools.
+The RTEMS kernel is developed on a host computer where the user's application
+code is cross-compiled to the target hardware's processor instructions and
+linked to the RTEMS kernel and language runtime libraries, and any 3rd party
+packages. RTEMS is not a multiprocess operating system and self hosting the
+types of tools need to create executables is not feasable. As a result a range
+of support tools are needed and they need run on the wide range of avaliable
+host computers users wish to develop on. This section details the tools
+available on host computers RTEMS users and developers need to create RTEMS
+executables.
+
+.. include:: linker.rst
+.. include:: symbols.rst
+.. include:: exeinfo.rst
+.. include:: trace-linker.rst
+.. include:: bsp-builder.rst