posix-compliance: Reference the generated content via the include file.

- Move the copyright to the top of the generated file.
- Add a glossary and references section.

posix-compliance/glossary.rst

@@ -0,0 +1,7 @@
+.. comment SPDX-License-Identifier: CC-BY-SA-4.0
+
+Glossary
+********
+
+.. glossary::
+   :sorted:

posix-compliance/index.rst

@@ -43,5 +43,9 @@ to the Community Project hosted at http://www.rtems.org/.
         :numbered:
 
         preface
-        generated-posix-compliance
+        posix-compliance
+        glossary
+        zreferences
 
+*       :ref:`genindex`
+*       :ref:`search`

posix-compliance/posix_rst.py

@@ -98,8 +98,7 @@ cat_columns = {
 }
 
 rst_defaults = {
-    'header': ['.. comment SPDX-License-Identifier: CC-BY-SA-4.0',
+    'header': ['',
-               '',
                'This chapter has a subsection per header file to detail the methods',
                'provided by RTEMS that are in that header file.',
                '']

posix-compliance/wscript

@@ -17,7 +17,8 @@ def gen_posix_rst(task):
     c.load(task.inputs[1].abspath())
     s = ['']
     for standard in posix_rst.standards:
-        s += ['',
+        s += ['.. comment SPDX-License-Identifier: CC-BY-SA-4.0',
+              '',
               posix_rst.standard_names[standard],
               '*' * len(posix_rst.standard_names[standard]),
                ''] + c.output(standard)

posix-compliance/zreferences.rst

@@ -0,0 +1,6 @@
+.. only:: html
+
+    References
+    **********
+
+.. bibliography:: ../common/refs.bib