[PATCH 0/1] Add generated glossary
Sebastian Huber
sebastian.huber at embedded-brains.de
Thu Feb 27 14:04:13 UTC 2020
This patch demonstrates the automatic generation of the general glossary and the
new glossary for the RTEMS Software Engineering manual. In a private repository
I have specification items for groups of glossary terms (e.g. the general
glossary) and glossary terms. I also have a prototype for a generator script
which reads the specification items and the Sphinx format sources. The script
outputs the glossary.rst files.
The licence and copyright information is aggregated from the individual
specification items, e.g.
SPDX-License-Identifier: CC-BY-SA-4.0
active: true
copyrights:
- Copyright (C) 1988, 1998 On-Line Applications Research Corporation (OAR)
derived: false
enabled-by: []
glossary-term: TCB
glossary-type: term
header: ''
level: 1.172
links:
- RTEMS-GLOS-GENERAL: y-DGLwoqVNRBlzUau_mx_yR3iKlhE02h2mRxK7VkLQE=
normative: true
ref: ''
reviewed: KJcc81zY_4KUf8oXIu-oJZ5DRMiFc9DoDsmhl9PZxac=
text: |
An acronym for @term{RTEMS-GLOS-TERM-TASKCONTROLBLOCK}.
type: glossary
The specification text can use macros to reference other specification items,
e.g. @term{RTEMS-GLOS-TERM-TASKCONTROLBLOCK} in the example above.
A contribution of the scripts and the specification items to the RTEMS Project
is currently blocked due to several undecided things related to the RTEMS
Qualification Project:
https://lists.rtems.org/pipermail/devel/2020-February/057246.html
Sebastian Huber (1):
eng: Add glossary
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
--
2.16.4
More information about the devel
mailing list