aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEric Botcazou <ebotcazou@adacore.com>2024-05-17 10:13:05 +0200
committerMarc Poulhiès <poulhies@adacore.com>2024-06-20 10:50:54 +0200
commit664e47e64cdb8b12dbf7051b9bda9fbac54fb27a (patch)
tree062dcd39ba4e9ce7ba573df1b75496c4006d63da
parent7e057326a901155bccc0ae559191220144a4f6b9 (diff)
downloadgcc-664e47e64cdb8b12dbf7051b9bda9fbac54fb27a.zip
gcc-664e47e64cdb8b12dbf7051b9bda9fbac54fb27a.tar.gz
gcc-664e47e64cdb8b12dbf7051b9bda9fbac54fb27a.tar.bz2
ada: Update Bit Ordering references in GNAT Reference Manual
They are still tailored to Ada 95 while the level of recommended support for Bit Ordering was changed in Ada 2005. gcc/ada/ * doc/gnat_rm/implementation_advice.rst (Representation Clauses): Remove >> marker and add end of sentence after code-block directive. (RM 13.5.3(7-8)): Update to Ada 2005 wording. * doc/gnat_rm/implementation_defined_characteristics.rst (RM 13.5.3(5)): Likewise. * gnat_rm.texi: Regenerate. * gnat_ugn.texi: Regenerate.
-rw-r--r--gcc/ada/doc/gnat_rm/implementation_advice.rst15
-rw-r--r--gcc/ada/doc/gnat_rm/implementation_defined_characteristics.rst4
-rw-r--r--gcc/ada/gnat_rm.texi31
-rw-r--r--gcc/ada/gnat_ugn.texi2
4 files changed, 24 insertions, 28 deletions
diff --git a/gcc/ada/doc/gnat_rm/implementation_advice.rst b/gcc/ada/doc/gnat_rm/implementation_advice.rst
index f2f34db..435cfa4 100644
--- a/gcc/ada/doc/gnat_rm/implementation_advice.rst
+++ b/gcc/ada/doc/gnat_rm/implementation_advice.rst
@@ -302,14 +302,15 @@ RM 13.1 (21-24): Representation Clauses
Followed. In fact, GNAT goes beyond the recommended level of support
by allowing nonstatic expressions in some representation clauses even
without the need to declare constants initialized with the values of
-such expressions.
-For example:
+such expressions. For example:
.. code-block:: ada
X : Integer;
Y : Float;
- for Y'Address use X'Address;>>
+ for Y'Address use X'Address;
+
+is accepted directly by GNAT.
"An implementation need not support a specification for the ``Size``
@@ -585,12 +586,10 @@ RM 13.5.3(7-8): Bit Ordering
"The recommended level of support for the non-default bit ordering is:
- If ``Word_Size`` = ``Storage_Unit``, then the implementation
- should support the non-default bit ordering in addition to the default
- bit ordering."
+ The implementation should support the nondefault bit ordering in addition
+ to the default bit ordering."
-Followed. Word size does not equal storage size in this implementation.
-Thus non-default bit ordering is not supported.
+Followed.
.. index:: Address, as private type
diff --git a/gcc/ada/doc/gnat_rm/implementation_defined_characteristics.rst b/gcc/ada/doc/gnat_rm/implementation_defined_characteristics.rst
index 0d3f340..54bcd0c 100644
--- a/gcc/ada/doc/gnat_rm/implementation_defined_characteristics.rst
+++ b/gcc/ada/doc/gnat_rm/implementation_defined_characteristics.rst
@@ -554,9 +554,7 @@ which contains a pointer to the dispatching table.
"If ``Word_Size`` = ``Storage_Unit``, the default bit
ordering. See 13.5.3(5)."
-``Word_Size`` (32) is not the same as ``Storage_Unit`` (8) for this
-implementation, so no non-default bit ordering is supported. The default
-bit ordering corresponds to the natural endianness of the target architecture.
+``Word_Size`` does not equal ``Storage_Unit`` in this implementation.
*
"The contents of the visible part of package ``System``. See 13.7(2)."
diff --git a/gcc/ada/gnat_rm.texi b/gcc/ada/gnat_rm.texi
index 0c15ad5..553e417 100644
--- a/gcc/ada/gnat_rm.texi
+++ b/gcc/ada/gnat_rm.texi
@@ -14363,21 +14363,24 @@ declared before the entity.”
Followed. In fact, GNAT goes beyond the recommended level of support
by allowing nonstatic expressions in some representation clauses even
without the need to declare constants initialized with the values of
-such expressions.
-For example:
+such expressions. For example:
@example
- X : Integer;
- Y : Float;
- for Y'Address use X'Address;>>
+X : Integer;
+Y : Float;
+for Y'Address use X'Address;
+@end example
+
+is accepted directly by GNAT.
+@quotation
-"An implementation need not support a specification for the `@w{`}Size`@w{`}
+“An implementation need not support a specification for the @code{Size}
for a given composite subtype, nor the size or storage place for an
object (including a component) of a given composite subtype, unless the
constraints on the subtype and its composite subcomponents (if any) are
-all static constraints."
-@end example
+all static constraints.”
+@end quotation
Followed. Size Clauses are not permitted on nonstatic components, as
described above.
@@ -14747,13 +14750,11 @@ Followed. There are no such components in GNAT.
“The recommended level of support for the non-default bit ordering is:
-If @code{Word_Size} = @code{Storage_Unit}, then the implementation
-should support the non-default bit ordering in addition to the default
-bit ordering.”
+The implementation should support the nondefault bit ordering in addition
+to the default bit ordering.”
@end quotation
-Followed. Word size does not equal storage size in this implementation.
-Thus non-default bit ordering is not supported.
+Followed.
@geindex Address
@geindex as private type
@@ -16787,9 +16788,7 @@ which contains a pointer to the dispatching table.
ordering. See 13.5.3(5).”
@end itemize
-@code{Word_Size} (32) is not the same as @code{Storage_Unit} (8) for this
-implementation, so no non-default bit ordering is supported. The default
-bit ordering corresponds to the natural endianness of the target architecture.
+@code{Word_Size} does not equal @code{Storage_Unit} in this implementation.
@itemize *
diff --git a/gcc/ada/gnat_ugn.texi b/gcc/ada/gnat_ugn.texi
index bba4f25..db06a77 100644
--- a/gcc/ada/gnat_ugn.texi
+++ b/gcc/ada/gnat_ugn.texi
@@ -29666,8 +29666,8 @@ to permit their use in free software.
@printindex ge
-@anchor{gnat_ugn/gnat_utility_programs switches-related-to-project-files}@w{ }
@anchor{d1}@w{ }
+@anchor{gnat_ugn/gnat_utility_programs switches-related-to-project-files}@w{ }
@c %**end of body
@bye