Am 09.03.2024 um 06:33 schrieb Randy Brukardt:
... AI22-0055-1 (which is now approved and in Editorial Review -- I
did quite a bit of rewriting of the details of the changes as many were
incorrect [we don't want a Usage header in the middle of a list of notes!]
But I'm done with that now, the version in the Google Docs is pretty final -
pending review from other ARG members [especially John Barnes]).
Do you no longer persue the route of numbering insertions after line n
with n.1 ...?
I see in Ada 2022:
37 Optional advice given to the implementer. The word “should” is used
to indicate that the advice is a recommendation, not a requirement. It
is implementation defined whether or not a given recommendation is
obeyed. 38 NOTE Notes emphasize consequences of the rules described in
the (sub)clause or elsewhere. This material is informative. Examples 39
Examples illustrate the possible forms of the constructs described. This
material is informative.
Now in Ada 202y;
37
Optional advice given to the implementer. The word “should” is used to
indicate that the advice is a recommendation, not a requirement. It is
implementation defined whether or not a given recommendation is obeyed.
Usage
38 (37.1)
Advice and notes on the usage of Ada programming language. This material
is informative.
39(38)
NOTE Notes emphasize consequences of the rules described in the
(sub)clause or elsewhere. This material is informative.
Examples
40(39)
Examples illustrate the possible forms of the constructs described. This
material is informative.