Christoph Grein writes:
> I've written a little program (Ada of course) and extracted
> all NOTEs from the RM.
You didn't need to do that, the RM formatter can do that via the Include
master command. (I added that and the matching Exclude in order to be able
to check if we were violating the rules about wording not allowed in
non-normative material.)
> In a first go, I found two candidates in one chapter (er, no,
> chapter is not the right word, I forget the correct
> vernacular;-), see appendix. Of course, the HTML is only a
> fragment, but Firefox displays it fine.
Yes.
> Is this about what you expect? ...
The form is fine, but I think these notes are clearly some that should NOT
move. These are about using the RM itself, not about the usage of the Ada
language. The description of the Usage category reads:
Advice and notes on the usage of the Ada programming language. This
material is informative.
My personal opinion is that we should only move notes that are clearly about
the usage of the Ada language and don't have other purposes. There are a lot
of notes that are mainly describing language design decisions which of
course have some effect on the usage of the language (almost everything
does, after all). Otherwise, we'd move 98% of the notes and that would be a
lot of work for somewhat dubious benefit. The same sort of thing applies to
the Examples (especially as the reformatting for ISO purposes partially
depends on the Examples category - ISO requires the examples to look much
like Notes, which is very different than the Ada format). If we move a lot
of examples, I'll have to redo the tools to be able to format examples found
in other categories properly.
> ... If so, eventually I will go through the rest of NOTEs in this way.
Tucker is assigned AI22-0097-1, but I doubt that he will complain if you do
it first. :-) Someone will have to move the results into the Google Doc for
AI22-0097-1, and my experience is that can chew up a lot of time (getting
the formatting right is necessary for the tools to work, and futzing with
formatting is a notorious time sink).
Randy.
________________________________________________________
You have received this message because you subscribed to the Ada-Comment
mailing list. To leave the Ada-Comment list, send an email with
'leave Ada-Comment' in the body to [email protected]. For help
on the other commands available, send 'help Ada-Comment' to the same address.
Problems? Send mail to [email protected]. This list is operated by the
Ada Resource Association, Inc., PO Box 8685, New York NY 10116-8685.
