From 0a543515957ff47feba739e6f71062fb2fb99125 Mon Sep 17 00:00:00 2001 From: Martin Liska Date: Mon, 28 Jun 2021 13:53:49 +0200 Subject: sphinx: ada: port to Sphinx gcc/ada/ChangeLog: * doc/gnat-style.rst: Moved to... * doc/gnat-style/index.rst: ...here. * doc/gnat_rm.rst: Moved to... * doc/gnat_rm/index.rst: ...here. * doc/gnat_ugn.rst: Moved to... * doc/gnat_ugn/index.rst: ...here. * doc/share/latex_elements.py: Moved to... * doc/share/ada_latex_elements.py: ...here. * gcc-interface/Make-lang.in: * doc/Makefile: Removed. * doc/share/conf.py: Removed. * doc/share/gnu_free_documentation_license.rst: Removed. * gnat-style.texi: Removed. * gnat_rm.texi: Removed. * gnat_ugn.texi: Removed. * doc/gnat-style/conf.py: New file. * doc/gnat-style/gnu_free_documentation_license.rst: New file. * doc/gnat_rm/conf.py: New file. * doc/gnat_rm/gnu_free_documentation_license.rst: New file. * doc/gnat_ugn/conf.py: New file. * doc/gnat_ugn/gnu_free_documentation_license.rst: New file. * doc/share/adabaseconf.py: New file. * doc/gnat_rm/security_hardening_features.rst: Add role. * doc/gnat_ugn/platform_specific_information.rst: Remove duplicate definition of |nbsp|. --- gcc/ada/doc/gnat_ugn/conf.py | 26 +++++++++ .../gnat_ugn/gnu_free_documentation_license.rst | 1 + gcc/ada/doc/gnat_ugn/index.rst | 63 ++++++++++++++++++++++ .../doc/gnat_ugn/platform_specific_information.rst | 6 --- 4 files changed, 90 insertions(+), 6 deletions(-) create mode 100644 gcc/ada/doc/gnat_ugn/conf.py create mode 100644 gcc/ada/doc/gnat_ugn/gnu_free_documentation_license.rst create mode 100644 gcc/ada/doc/gnat_ugn/index.rst (limited to 'gcc/ada/doc/gnat_ugn') diff --git a/gcc/ada/doc/gnat_ugn/conf.py b/gcc/ada/doc/gnat_ugn/conf.py new file mode 100644 index 0000000..94e3c07 --- /dev/null +++ b/gcc/ada/doc/gnat_ugn/conf.py @@ -0,0 +1,26 @@ +# Configuration file for the Sphinx documentation builder. + +import sys +sys.path.append('../share') + +from adabaseconf import * + +name = 'gnat_ugn' +project = "GNAT User's Guide for Native Platforms" +authors = 'AdaCore' + +set_latex_elements(latex_elements, project) + +# Grouping the document tree into Texinfo files. List of tuples +# (source start file, target name, title, author, +# dir menu entry, description, category) +latex_documents = [ + ('index', f'{name}.tex', project, authors, 'manual'), +] + +texinfo_documents = [ + ('index', name, project, authors, None, None, None, True) +] + +tags.add(get_gnat_build_type()) +set_common(name, globals()) diff --git a/gcc/ada/doc/gnat_ugn/gnu_free_documentation_license.rst b/gcc/ada/doc/gnat_ugn/gnu_free_documentation_license.rst new file mode 100644 index 0000000..33c62cf --- /dev/null +++ b/gcc/ada/doc/gnat_ugn/gnu_free_documentation_license.rst @@ -0,0 +1 @@ +.. include:: ../../../../doc/gnu_free_documentation_license.rst diff --git a/gcc/ada/doc/gnat_ugn/index.rst b/gcc/ada/doc/gnat_ugn/index.rst new file mode 100644 index 0000000..d3d1dac --- /dev/null +++ b/gcc/ada/doc/gnat_ugn/index.rst @@ -0,0 +1,63 @@ +GNAT User's Guide for Native Platforms +====================================== + +.. only:: not latex + + *GNAT, The GNU Ada Development Environment* + + .. only:: PRO + + *GNAT Pro Edition* + + | Version |version| + | Date: |today| + + .. only:: GPL + + *GNAT Community Edition* + + | Version |version| + | Date: |today| + + .. only:: FSF + + .. raw:: texinfo + + @include gcc-common.texi + GCC version @value{version-GCC}@* + + AdaCore + + Permission is granted to copy, distribute and/or modify this document + under the terms of the GNU Free Documentation License, Version 1.3 or + any later version published by the Free Software Foundation; with no + Invariant Sections, with the Front-Cover Texts being + "GNAT User's Guide for Native Platforms", + and with no Back-Cover Texts. A copy of the license is + included in the section entitled :ref:`gnu_fdl`. + +.. toctree:: + :maxdepth: 3 + :numbered: + + about_this_guide + getting_started_with_gnat + the_gnat_compilation_model + building_executable_programs_with_gnat + gnat_utility_programs + gnat_and_program_execution + +.. raw:: latex + + \appendix + +.. toctree:: + :maxdepth: 3 + + A. Platform-Specific Information + B. Example of Binder Output + C. Elaboration Order Handling in GNAT + D. Inline Assembler + E. GNU Free Documentation License + + diff --git a/gcc/ada/doc/gnat_ugn/platform_specific_information.rst b/gcc/ada/doc/gnat_ugn/platform_specific_information.rst index 4d25dea..3ada65d 100644 --- a/gcc/ada/doc/gnat_ugn/platform_specific_information.rst +++ b/gcc/ada/doc/gnat_ugn/platform_specific_information.rst @@ -1,11 +1,5 @@ .. role:: switch(samp) -.. -- Non-breaking space in running text - -- E.g. Ada |nbsp| 95 - -.. |nbsp| unicode:: 0xA0 - :trim: - .. _Platform_Specific_Information: ***************************** -- cgit v1.1