[PATCH 5/8] c-user: Generate initialization manager docs

[Sebastian Huber]

The documentation is a consolidation of the comments in Doxygen markup
and the documentation sources in Sphinx markup.  The documentation was
transfered to interface specification items.  The documentation source
files were generated from the items by a script.

Update #3993.
---
 c-user/initialization/directives.rst   | 68 ++++++++++++++++++--------
 c-user/initialization/introduction.rst | 36 +++++++++++---
 2 files changed, 78 insertions(+), 26 deletions(-)

diff --git a/c-user/initialization/directives.rst b/c-user/initialization/directives.rst
index 97dea46..7f67b9b 100644
--- a/c-user/initialization/directives.rst
+++ b/c-user/initialization/directives.rst
@@ -1,41 +1,69 @@
 .. SPDX-License-Identifier: CC-BY-SA-4.0
 
+.. Copyright (C) 2015, 2021 embedded brains GmbH (http://www.embedded-brains.de)
 .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
 
+.. This file is part of the RTEMS quality process and was automatically
+.. generated.  If you find something that needs to be fixed or
+.. worded better please post a report or patch to an RTEMS mailing list
+.. or raise a bug report:
+..
+.. https://www.rtems.org/bugs.html
+..
+.. For information on updating and regenerating please refer to the How-To
+.. section in the Software Requirements Engineering chapter of the
+.. RTEMS Software Engineering manual.  The manual is provided as a part of
+.. a release.  For development sources please refer to the online
+.. documentation at:
+..
+.. https://docs.rtems.org
+
+.. _InitializationManagerDirectives:
+
 Directives
 ==========
 
-This section details the Initialization Manager's directives.  A subsection is
-dedicated to each of this manager's directives and describes the calling
-sequence, related constants, usage, and status codes.
+This section details the directives of the Initialization Manager. A subsection
+is dedicated to each of this manager's directives and lists the calling
+sequence, parameters, description, return values, and notes of the directive.
+
+.. Generated from spec:/rtems/init/if/initialize-executive
 
 .. raw:: latex
 
-   \clearpage
+    \clearpage
 
+.. index:: rtems_initialize_executive()
 .. index:: initialize RTEMS
 .. index:: start multitasking
-.. index:: rtems_initialize_executive
 
-.. _rtems_initialize_executive:
+.. _InterfaceRtemsInitializeExecutive:
+
+rtems_initialize_executive()
+----------------------------
+
+Initializes the system and starts multitasking.
+
+.. rubric:: CALLING SEQUENCE:
+
+.. code-block:: c
+
+    void rtems_initialize_executive( void );
+
+.. rubric:: DESCRIPTION:
 
-INITIALIZE_EXECUTIVE - Initialize RTEMS
----------------------------------------
+Iterates through the system initialization linker set and invokes the
+registered handlers.  The final step is to start multitasking.
 
-CALLING SEQUENCE:
-    .. code-block:: c
+.. rubric:: NOTES:
 
-        void rtems_initialize_executive(void);
+Errors in the initialization sequence are usually fatal and lead to a system
+termination.
 
-DIRECTIVE STATUS CODES:
-    NONE - This function will not return to the caller.
+.. rubric:: CONSTRAINTS:
 
-DESCRIPTION:
-    Iterates through the system initialization linker set and invokes the
-    registered handlers.  The final step is to start multitasking.
+The following constraints apply to this directive:
 
-NOTES:
-    This directive should be called by :c:func:`boot_card()` only.
+* This directive should be called by :c:func:`boot_card` only.
 
-    This directive *does not return* to the caller.  Errors in the
-    initialization sequence are usually fatal and lead to a system termination.
+* The directive will not return to the caller.
diff --git a/c-user/initialization/introduction.rst b/c-user/initialization/introduction.rst
index 88805f2..173e60f 100644
--- a/c-user/initialization/introduction.rst
+++ b/c-user/initialization/introduction.rst
@@ -1,15 +1,39 @@
 .. SPDX-License-Identifier: CC-BY-SA-4.0
 
+.. Copyright (C) 2015, 2021 embedded brains GmbH (http://www.embedded-brains.de)
 .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
 
+.. This file is part of the RTEMS quality process and was automatically
+.. generated.  If you find something that needs to be fixed or
+.. worded better please post a report or patch to an RTEMS mailing list
+.. or raise a bug report:
+..
+.. https://www.rtems.org/bugs.html
+..
+.. For information on updating and regenerating please refer to the How-To
+.. section in the Software Requirements Engineering chapter of the
+.. RTEMS Software Engineering manual.  The manual is provided as a part of
+.. a release.  For development sources please refer to the online
+.. documentation at:
+..
+.. https://docs.rtems.org
+
+.. Generated from spec:/rtems/init/if/group
+
+.. _InitializationManagerIntroduction:
+
 Introduction
 ============
 
-The Initialization Manager is responsible for initializing the Board Support
-Package, RTEMS, device drivers, the root filesystem and the application.  The
-:ref:`RTEMSAPIClassicFatal` is responsible for the system
-shutdown.
+.. The following list was generated from:
+.. spec:/rtems/init/if/initialize-executive
+
+The Initialization Manager is responsible for initializing the system.
 
-The Initialization Manager provides only one directive:
+The system initialization includes the initialization of the Board Support
+Package, RTEMS, device drivers, the root filesystem, and the application. The
+:ref:`RTEMSAPIClassicFatal` is responsible for the system shutdown. The
+directives provided by the Initialization Manager are:
 
-- :ref:`rtems_initialize_executive`
+* :ref:`InterfaceRtemsInitializeExecutive` - Initializes the system and starts
+  multitasking.
-- 
2.26.2