diff options
author | Marc Poulhiès <poulhies@adacore.com> | 2023-10-23 10:08:35 +0200 |
---|---|---|
committer | Marc Poulhiès <poulhies@adacore.com> | 2023-11-21 10:57:40 +0100 |
commit | c6cd629ffbf895542dcf6e603ab112818cd9afd7 (patch) | |
tree | 9592275001af9acbf00478ea49d51ea1bff5b59a | |
parent | fee5b643574e16cb2860ab6d6e26ccb0ed60f91a (diff) | |
download | gcc-c6cd629ffbf895542dcf6e603ab112818cd9afd7.zip gcc-c6cd629ffbf895542dcf6e603ab112818cd9afd7.tar.gz gcc-c6cd629ffbf895542dcf6e603ab112818cd9afd7.tar.bz2 |
ada: Fix misplaced index directive in documentation
The index directive must be located before the indexed element, at least
for the generated texinfo to be correct. See:
https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#directive-index
This was reported along with changes done in https://inbox.sourceware.org/gcc-patches/20230223102714.3606058-3-arsen@aarsen.me/
gcc/ada/
* doc/gnat_ugn/the_gnat_compilation_model.rst: Move index
directives.
* gnat_ugn.texi: Regenerate.
-rw-r--r-- | gcc/ada/doc/gnat_ugn/the_gnat_compilation_model.rst | 11 | ||||
-rw-r--r-- | gcc/ada/gnat_ugn.texi | 28 |
2 files changed, 25 insertions, 14 deletions
diff --git a/gcc/ada/doc/gnat_ugn/the_gnat_compilation_model.rst b/gcc/ada/doc/gnat_ugn/the_gnat_compilation_model.rst index ed24fed..fd15459 100644 --- a/gcc/ada/doc/gnat_ugn/the_gnat_compilation_model.rst +++ b/gcc/ada/doc/gnat_ugn/the_gnat_compilation_model.rst @@ -226,9 +226,9 @@ possible encoding schemes: ``16#A345#``. This scheme is compatible with use of the full Wide_Character set. -*Upper-Half Coding* - .. index:: Upper-Half Coding +.. index:: Upper-Half Coding +*Upper-Half Coding* The wide character with encoding ``16#abcd#`` where the upper bit is on (in other words, 'a' is in the range 8-F) is represented as two bytes, ``16#ab#`` and ``16#cd#``. The second byte cannot be a format control @@ -236,9 +236,9 @@ possible encoding schemes: be also used for shift-JIS or EUC, where the internal coding matches the external coding. -*Shift JIS Coding* - .. index:: Shift JIS Coding +.. index:: Shift JIS Coding +*Shift JIS Coding* A wide character is represented by a two-character sequence, ``16#ab#`` and ``16#cd#``, with the restrictions described for upper-half encoding as @@ -247,10 +247,9 @@ possible encoding schemes: conversion. Only characters defined in the JIS code set table can be used with this encoding method. +.. index:: EUC Coding *EUC Coding* - .. index:: EUC Coding - A wide character is represented by a two-character sequence ``16#ab#`` and ``16#cd#``, with both characters being in the upper half. The internal diff --git a/gcc/ada/gnat_ugn.texi b/gcc/ada/gnat_ugn.texi index 78f8849..3859709 100644 --- a/gcc/ada/gnat_ugn.texi +++ b/gcc/ada/gnat_ugn.texi @@ -19,7 +19,7 @@ @copying @quotation -GNAT User's Guide for Native Platforms , Oct 26, 2023 +GNAT User's Guide for Native Platforms , Nov 10, 2023 AdaCore @@ -1363,22 +1363,30 @@ characters (using uppercase letters) of the wide character code. For example, ESC A345 is used to represent the wide character with code @code{16#A345#}. This scheme is compatible with use of the full Wide_Character set. - -@item `Upper-Half Coding' +@end table @geindex Upper-Half Coding + +@table @asis + +@item `Upper-Half Coding' + The wide character with encoding @code{16#abcd#} where the upper bit is on (in other words, ‘a’ is in the range 8-F) is represented as two bytes, @code{16#ab#} and @code{16#cd#}. The second byte cannot be a format control character, but is not required to be in the upper half. This method can be also used for shift-JIS or EUC, where the internal coding matches the external coding. - -@item `Shift JIS Coding' +@end table @geindex Shift JIS Coding + +@table @asis + +@item `Shift JIS Coding' + A wide character is represented by a two-character sequence, @code{16#ab#} and @code{16#cd#}, with the restrictions described for upper-half encoding as @@ -1386,11 +1394,15 @@ described above. The internal character code is the corresponding JIS character according to the standard algorithm for Shift-JIS conversion. Only characters defined in the JIS code set table can be used with this encoding method. - -@item `EUC Coding' +@end table @geindex EUC Coding + +@table @asis + +@item `EUC Coding' + A wide character is represented by a two-character sequence @code{16#ab#} and @code{16#cd#}, with both characters being in the upper half. The internal @@ -29568,8 +29580,8 @@ to permit their use in free software. @printindex ge -@anchor{d1}@w{ } @anchor{gnat_ugn/gnat_utility_programs switches-related-to-project-files}@w{ } +@anchor{d1}@w{ } @c %**end of body @bye |