From 8fd97fcdba9da64bfd0988122e012057d0a6ed40 Mon Sep 17 00:00:00 2001 From: Bob Duff Date: Mon, 19 Aug 2019 08:37:39 +0000 Subject: [PATCH] [Ada] Fix documentation for stream oriented attributes 2019-08-19 Bob Duff gcc/ada/ * doc/gnat_rm/implementation_advice.rst: Fix documentation for stream oriented attributes. * gnat_rm.texi: Regenerate. From-SVN: r274666 --- gcc/ada/ChangeLog | 6 +++ gcc/ada/doc/gnat_rm/implementation_advice.rst | 28 +++++++------- gcc/ada/gnat_rm.texi | 38 +++++++++---------- 3 files changed, 39 insertions(+), 33 deletions(-) diff --git a/gcc/ada/ChangeLog b/gcc/ada/ChangeLog index 46121c5ac9b..e59b7093e73 100644 --- a/gcc/ada/ChangeLog +++ b/gcc/ada/ChangeLog @@ -1,3 +1,9 @@ +2019-08-19 Bob Duff + + * doc/gnat_rm/implementation_advice.rst: Fix documentation for + stream oriented attributes. + * gnat_rm.texi: Regenerate. + 2019-08-19 Gary Dismukes * einfo.ads (E_Function, E_Procedure): Update comments to diff --git a/gcc/ada/doc/gnat_rm/implementation_advice.rst b/gcc/ada/doc/gnat_rm/implementation_advice.rst index b006f32e6bb..31376d92461 100644 --- a/gcc/ada/doc/gnat_rm/implementation_advice.rst +++ b/gcc/ada/doc/gnat_rm/implementation_advice.rst @@ -703,23 +703,23 @@ Followed. .. index:: Stream oriented attributes -RM 13.13.2(17): Stream Oriented Attributes -========================================== +RM 13.13.2(1.6): Stream Oriented Attributes +=========================================== + + "If not specified, the value of Stream_Size for an elementary type + should be the number of bits that corresponds to the minimum number of + stream elements required by the first subtype of the type, rounded up + to the nearest factor or multiple of the word size that is also a + multiple of the stream element size." - "If a stream element is the same size as a storage element, then the - normal in-memory representation should be used by ``Read`` and - ``Write`` for scalar objects. Otherwise, ``Read`` and ``Write`` - should use the smallest number of stream elements needed to represent - all values in the base range of the scalar type." +Followed, except that the number of stream elements is a power of 2. +The Stream_Size may be used to override the default choice. -Followed. By default, GNAT uses the interpretation suggested by AI-195, -which specifies using the size of the first subtype. However, such an implementation is based on direct binary -representations and is therefore target- and endianness-dependent. -To address this issue, GNAT also supplies an alternate implementation -of the stream attributes ``Read`` and ``Write``, -which uses the target-independent XDR standard representation -for scalar types. +representations and is therefore target- and endianness-dependent. To +address this issue, GNAT also supplies an alternate implementation of +the stream attributes ``Read`` and ``Write``, which uses the +target-independent XDR standard representation for scalar types. .. index:: XDR representation diff --git a/gcc/ada/gnat_rm.texi b/gcc/ada/gnat_rm.texi index 58ff6af0079..be31ed89584 100644 --- a/gcc/ada/gnat_rm.texi +++ b/gcc/ada/gnat_rm.texi @@ -577,7 +577,7 @@ Implementation Advice * RM 13.9(14-17); Unchecked Conversion: RM 13 9 14-17 Unchecked Conversion. * RM 13.11(23-25); Implicit Heap Usage: RM 13 11 23-25 Implicit Heap Usage. * RM 13.11.2(17); Unchecked Deallocation: RM 13 11 2 17 Unchecked Deallocation. -* RM 13.13.2(17); Stream Oriented Attributes: RM 13 13 2 17 Stream Oriented Attributes. +* RM 13.13.2(1.6); Stream Oriented Attributes: RM 13 13 2 1 6 Stream Oriented Attributes. * RM A.1(52); Names of Predefined Numeric Types: RM A 1 52 Names of Predefined Numeric Types. * RM A.3.2(49); Ada.Characters.Handling: RM A 3 2 49 Ada Characters Handling. * RM A.4.4(106); Bounded-Length String Handling: RM A 4 4 106 Bounded-Length String Handling. @@ -13845,7 +13845,7 @@ case the text describes what GNAT does and why. * RM 13.9(14-17); Unchecked Conversion: RM 13 9 14-17 Unchecked Conversion. * RM 13.11(23-25); Implicit Heap Usage: RM 13 11 23-25 Implicit Heap Usage. * RM 13.11.2(17); Unchecked Deallocation: RM 13 11 2 17 Unchecked Deallocation. -* RM 13.13.2(17); Stream Oriented Attributes: RM 13 13 2 17 Stream Oriented Attributes. +* RM 13.13.2(1.6); Stream Oriented Attributes: RM 13 13 2 1 6 Stream Oriented Attributes. * RM A.1(52); Names of Predefined Numeric Types: RM A 1 52 Names of Predefined Numeric Types. * RM A.3.2(49); Ada.Characters.Handling: RM A 3 2 49 Ada Characters Handling. * RM A.4.4(106); Bounded-Length String Handling: RM A 4 4 106 Bounded-Length String Handling. @@ -14846,7 +14846,7 @@ Followed. @geindex Unchecked deallocation -@node RM 13 11 2 17 Unchecked Deallocation,RM 13 13 2 17 Stream Oriented Attributes,RM 13 11 23-25 Implicit Heap Usage,Implementation Advice +@node RM 13 11 2 17 Unchecked Deallocation,RM 13 13 2 1 6 Stream Oriented Attributes,RM 13 11 23-25 Implicit Heap Usage,Implementation Advice @anchor{gnat_rm/implementation_advice rm-13-11-2-17-unchecked-deallocation}@anchor{235} @section RM 13.11.2(17): Unchecked Deallocation @@ -14861,28 +14861,28 @@ Followed. @geindex Stream oriented attributes -@node RM 13 13 2 17 Stream Oriented Attributes,RM A 1 52 Names of Predefined Numeric Types,RM 13 11 2 17 Unchecked Deallocation,Implementation Advice -@anchor{gnat_rm/implementation_advice rm-13-13-2-17-stream-oriented-attributes}@anchor{236} -@section RM 13.13.2(17): Stream Oriented Attributes +@node RM 13 13 2 1 6 Stream Oriented Attributes,RM A 1 52 Names of Predefined Numeric Types,RM 13 11 2 17 Unchecked Deallocation,Implementation Advice +@anchor{gnat_rm/implementation_advice rm-13-13-2-1-6-stream-oriented-attributes}@anchor{236} +@section RM 13.13.2(1.6): Stream Oriented Attributes @quotation -"If a stream element is the same size as a storage element, then the -normal in-memory representation should be used by @code{Read} and -@code{Write} for scalar objects. Otherwise, @code{Read} and @code{Write} -should use the smallest number of stream elements needed to represent -all values in the base range of the scalar type." +"If not specified, the value of Stream_Size for an elementary type +should be the number of bits that corresponds to the minimum number of +stream elements required by the first subtype of the type, rounded up +to the nearest factor or multiple of the word size that is also a +multiple of the stream element size." @end quotation -Followed. By default, GNAT uses the interpretation suggested by AI-195, -which specifies using the size of the first subtype. +Followed, except that the number of stream elements is a power of 2. +The Stream_Size may be used to override the default choice. + However, such an implementation is based on direct binary -representations and is therefore target- and endianness-dependent. -To address this issue, GNAT also supplies an alternate implementation -of the stream attributes @code{Read} and @code{Write}, -which uses the target-independent XDR standard representation -for scalar types. +representations and is therefore target- and endianness-dependent. To +address this issue, GNAT also supplies an alternate implementation of +the stream attributes @code{Read} and @code{Write}, which uses the +target-independent XDR standard representation for scalar types. @geindex XDR representation @@ -14916,7 +14916,7 @@ Rebuild the GNAT run-time library as documented in the @emph{GNAT and Libraries} section of the @cite{GNAT User's Guide}. @end itemize -@node RM A 1 52 Names of Predefined Numeric Types,RM A 3 2 49 Ada Characters Handling,RM 13 13 2 17 Stream Oriented Attributes,Implementation Advice +@node RM A 1 52 Names of Predefined Numeric Types,RM A 3 2 49 Ada Characters Handling,RM 13 13 2 1 6 Stream Oriented Attributes,Implementation Advice @anchor{gnat_rm/implementation_advice rm-a-1-52-names-of-predefined-numeric-types}@anchor{237} @section RM A.1(52): Names of Predefined Numeric Types -- 2.30.2