+2012-03-20 Yannick Moy <moy@adacore.com>
+
+ * gnat_rm.texi, sem_attr.ads: Update documentation.
+
2012-03-19 Yannick Moy <moy@adacore.com>
* sem_ch6.adb: Minor code clean up.
* Unconstrained_Array::
* Universal_Literal_String::
* Unrestricted_Access::
+* Valid_Scalars::
* VADS_Size::
* Value_Size::
* Wchar_T_Size::
* Unconstrained_Array::
* Universal_Literal_String::
* Unrestricted_Access::
+* Valid_Scalars::
* VADS_Size::
* Value_Size::
* Wchar_T_Size::
to create a unconstrained pointer and then return that value to the
caller.
+@node Valid_Scalars
+@unnumberedsec Valid_Scalars
+@findex Valid_Scalars
+@noindent
+The @code{'Valid_Scalars} attribute is intended to make it easier to
+check the validity of scalar subcomponents of composite objects. It
+is defined for any prefix @code{X} that denotes a scalar or composite
+object (after any implicit dereference), that is not of classwide type
+or of a formal generic type with an unknown discriminant.
+@code{X'Valid_Scalars} yields True if and only if @code{X'Valid}
+yields True, if @code{X} is a scalar object, or @code{Y'Valid} yields
+True for every scalar subcomponent @code{Y} of @code{X}, if @code{X}
+is a composite object. If computing the value of
+@code{X'Valid_Scalars} involves evaluations of subtype predicates, it
+is unspecified in which order these evaluations take place, or if they
+take place at all in case the result is False. The value of this
+attribute is of the predefined type Boolean.
+
@node VADS_Size
@unnumberedsec VADS_Size
@cindex @code{Size}, VADS compatibility
-------------------
Attribute_Valid_Scalars => True,
- -- Typ'Valid_Scalars applies to ???
+ -- Obj'Valid_Scalars applies to objects of scalar types, on which it is
+ -- equivalent to Obj'Valid, and objects of array and record types, on
+ -- which it amounts to applying 'Valid to each subcomponent of Obj. It
+ -- does not apply to prefixes of classwide type, or of a formal generic
+ -- type that has an unknown discriminant (which could be instantiated
+ -- with a classwide type).
----------------
-- Value_Size --