[PATCH 1/1] eng: Add glossary

Sebastian Huber sebastian.huber at embedded-brains.de
Thu Feb 27 14:04:14 UTC 2020


Update #3853.
---
 c-user/glossary.rst | 51 +++++++++++++++++++++++++++++++++++++++++++-
 eng/glossary.rst    | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 eng/index.rst       |  1 +
 3 files changed, 112 insertions(+), 1 deletion(-)
 create mode 100644 eng/glossary.rst

diff --git a/c-user/glossary.rst b/c-user/glossary.rst
index c9a1dfb..d0996e8 100644
--- a/c-user/glossary.rst
+++ b/c-user/glossary.rst
@@ -1,6 +1,6 @@
 .. SPDX-License-Identifier: CC-BY-SA-4.0
 
-.. Copyright (C) 2017 embedded brains GmbH (http://www.embedded-brains.de)
+.. Copyright (C) 2017, 2019 embedded brains GmbH (http://www.embedded-brains.de)
 .. Copyright (C) 1988, 1998 On-Line Applications Research Corporation (OAR)
 
 Glossary
@@ -9,6 +9,9 @@ Glossary
 .. glossary::
     :sorted:
 
+    ABI
+        An acronym for Application Binary Interface.
+
     active
         A term used to describe an object which has been created by an
         application.
@@ -85,6 +88,9 @@ Glossary
         the passing of arguments, the call and return mechanism, and the register
         set which must be preserved.
 
+    CCB
+        An acronym for Change Control Board.
+
     Central Processing Unit
         This term is equivalent to the terms processor and microprocessor.
 
@@ -157,6 +163,10 @@ Glossary
         The act of loading a task's context onto the CPU and transferring control
         of the CPU to that task.
 
+    Doorstop
+        `Doorstop <https://github.com/doorstop-dev/doorstop>`_ is a
+        requirements management tool.
+
     dormant
         The state entered by a task after it is created and before it has been
         started.
@@ -165,6 +175,9 @@ Glossary
         A term used to describe memory which can be accessed at two different
         addresses.
 
+    EARS
+        An acronym for Easy Approach to Requirements Syntax.
+
     embedded
         An application that is delivered as a hidden part of a larger system.
         For example, the software in a fuel-injection control system is an
@@ -222,10 +235,20 @@ Glossary
     freed
         A resource that has been released by the application to RTEMS.
 
+    GCC
+        An acronym for `GNU Compiler Collection <https://gcc.gnu.org/>`_.
+
     global
         An object that has been created with the GLOBAL attribute and exported to
         all nodes in a multiprocessor system.
 
+    GNAT
+        *GNAT* is the :term:`GNU` compiler for Ada, integrated into the
+        :term:`GCC`.
+
+    GNU
+        An acronym for `GNU's Not Unix <https://www.gnu.org/>`_.
+
     handler
         The equivalent of a manager, except that it is internal to RTEMS and
         forms part of the core.  A handler is a collection of routines which
@@ -287,6 +310,9 @@ Glossary
     ISR
         An acronym for :term:`Interrupt Service Routine`.
 
+    ISVV
+        An acronym for Independent Software Verification and Validation.
+
     kernel
         In this document, this term is used as a synonym for executive.
 
@@ -548,6 +574,10 @@ Glossary
         The manipulation of an object which does not reside on the same node as
         the calling task.
 
+    ReqIF
+        An acronym for
+        `Requirements Interchange Format <https://www.omg.org/spec/ReqIF/About-ReqIF/>`_.
+
     resource
         A hardware or software entity to which access must be controlled.
 
@@ -573,6 +603,9 @@ Glossary
     RS-232
         A standard for serial communications.
 
+    RTEMS
+        An acronym for Real-Time Executive for Multiprocessor Systems.
+
     running
         The state of a rate monotonic timer while it is being used to delineate a
         period.  The timer exits this state by either expiring or being canceled.
@@ -650,6 +683,19 @@ Glossary
         A real-time system in which a missed deadline does not compromise the
         integrity of the system.
 
+    software item
+        This term has the same meaning as :term:`software product`.
+
+    software product
+        The *software product* is the :term:`RTEMS` real-time operating system.
+
+    source code
+        This project uses the *source code* definition of the
+        `Linux Information Project <http://www.linfo.org/source_code.html>`_:
+        "Source code (also referred to as source or code) is the version of
+        software as it is originally written (i.e., typed into a computer) by a
+        human in plain text (i.e., human readable alphanumeric characters)."
+
     sporadic task
         A task which executes at irregular intervals and must comply with a hard
         deadline.  A minimum period of time between successive iterations of the
@@ -787,5 +833,8 @@ Glossary
         Message queues, regions, and semaphores have a wait queue associated with
         them.
 
+    YAML
+        An acronym for `YAML Ain't Markup Language <https://yaml.org/>`_.
+
     yield
         When a task voluntarily releases control of the processor.
diff --git a/eng/glossary.rst b/eng/glossary.rst
new file mode 100644
index 0000000..c58e67f
--- /dev/null
+++ b/eng/glossary.rst
@@ -0,0 +1,61 @@
+.. SPDX-License-Identifier: CC-BY-SA-4.0
+
+.. Copyright (C) 2017, 2019 embedded brains GmbH (http://www.embedded-brains.de)
+
+Glossary
+********
+
+.. glossary::
+    :sorted:
+
+    ABI
+        An acronym for Application Binary Interface.
+
+    API
+        An acronym for Application Programming Interface.
+
+    CCB
+        An acronym for Change Control Board.
+
+    Doorstop
+        `Doorstop <https://github.com/doorstop-dev/doorstop>`_ is a
+        requirements management tool.
+
+    EARS
+        An acronym for Easy Approach to Requirements Syntax.
+
+    GCC
+        An acronym for `GNU Compiler Collection <https://gcc.gnu.org/>`_.
+
+    GNAT
+        *GNAT* is the :term:`GNU` compiler for Ada, integrated into the
+        :term:`GCC`.
+
+    GNU
+        An acronym for `GNU's Not Unix <https://www.gnu.org/>`_.
+
+    ISVV
+        An acronym for Independent Software Verification and Validation.
+
+    ReqIF
+        An acronym for
+        `Requirements Interchange Format <https://www.omg.org/spec/ReqIF/About-ReqIF/>`_.
+
+    RTEMS
+        An acronym for Real-Time Executive for Multiprocessor Systems.
+
+    software item
+        This term has the same meaning as :term:`software product`.
+
+    software product
+        The *software product* is the :term:`RTEMS` real-time operating system.
+
+    source code
+        This project uses the *source code* definition of the
+        `Linux Information Project <http://www.linfo.org/source_code.html>`_:
+        "Source code (also referred to as source or code) is the version of
+        software as it is originally written (i.e., typed into a computer) by a
+        human in plain text (i.e., human readable alphanumeric characters)."
+
+    YAML
+        An acronym for `YAML Ain't Markup Language <https://yaml.org/>`_.
diff --git a/eng/index.rst b/eng/index.rst
index ed314a9..a317727 100644
--- a/eng/index.rst
+++ b/eng/index.rst
@@ -37,4 +37,5 @@ RTEMS Software Engineering (|version|)
     appendix-a
     function_and_variable
     concept
+    glossary
     zreferences
-- 
2.16.4



More information about the devel mailing list