From ab4dad49127bc65de7dd4af02db3cad437a477d6 Mon Sep 17 00:00:00 2001 From: Eric Botcazou Date: Mon, 28 May 2018 08:56:20 +0000 Subject: [PATCH] [Ada] Minor fixes and tweaks to comments in the Repinfo unit 2018-05-28 Eric Botcazou gcc/ada/ * repinfo.ads: Minor fixes and tweaks in comments. From-SVN: r260844 --- gcc/ada/ChangeLog | 4 ++++ gcc/ada/repinfo.ads | 18 +++++++++--------- 2 files changed, 13 insertions(+), 9 deletions(-) diff --git a/gcc/ada/ChangeLog b/gcc/ada/ChangeLog index 60ff2049086..bd50727f4f3 100644 --- a/gcc/ada/ChangeLog +++ b/gcc/ada/ChangeLog @@ -1,3 +1,7 @@ +2018-05-28 Eric Botcazou + + * repinfo.ads: Minor fixes and tweaks in comments. + 2018-05-28 Eric Botcazou * repinfo.adb (List_GCC_Expression): Remove Valop and replace calls to diff --git a/gcc/ada/repinfo.ads b/gcc/ada/repinfo.ads index a36736b621a..6cbd482d721 100644 --- a/gcc/ada/repinfo.ads +++ b/gcc/ada/repinfo.ads @@ -30,10 +30,10 @@ ------------------------------------------------------------------------------ -- This package contains the routines to handle back annotation of the --- tree to fill in representation information, and also the routine used --- by -gnatR to print this information. This unit is used both in the +-- tree to fill in representation information, and also the routines used +-- by -gnatR to output this information. This unit is used both in the -- compiler and in ASIS (it is used in ASIS as part of the implementation --- of the data decomposition annex). +-- of the Data Decomposition Annex). with Types; use Types; with Uintp; use Uintp; @@ -68,7 +68,7 @@ package Repinfo is -- needed in the case of sizes not known till runtime. ----------------------------- - -- Back-Annotation by Gigi -- + -- Back Annotation by Gigi -- ----------------------------- -- The following interface is used by gigi if Frontend_Layout is False @@ -82,13 +82,13 @@ package Repinfo is -- For E_Array_Type entities, the Component_Size field - -- For all record and array types and subtypes, the Esize field, - -- which contains the Size (more accurately the Object_Size) value - -- for the type or subtype. + -- For all record and array types and subtypes, the Esize and RM_Size + -- fields, which respectively contain the Object_Size and Value_Size + -- values for the type or subtype. -- For E_Component and E_Discriminant entities, the Esize (size -- of component) and Component_Bit_Offset fields. Note that gigi - -- does not back annotate Normalized_Position/First_Bit. + -- does not generally back annotate Normalized_Position/First_Bit. -- There are three cases to consider: @@ -111,7 +111,7 @@ package Repinfo is -- Note: the extended back annotation for the dynamic case is needed only -- for -gnatR3 output, and for proper operation of the ASIS DDA. Since it -- can be expensive to do this back annotation (for discriminated records - -- with many variable length arrays), we only do the full back annotation + -- with many variable-length arrays), we only do the full back annotation -- in -gnatR3 mode, or ASIS mode. In any other mode, the back-end just sets -- the value to Uint_Minus_1, indicating that the value of the attribute -- depends on discriminant information, but not giving further details. -- 2.30.2