AARDVARK
Aardvark is the X/Open bug eater. It is used to collect written
comments on specific review documents. Review comments or `bugs'
should be phrased wherever possible in terms of specific wording
changes. Bugs submitted in this way can then be more easily
discussed at relevant working group meetings, or voted on by email.
Aardvark automatically processes and collates bugs from
appropriately formatted email messages. This allows all bugs
from many sources relating to a single document to be collated
and presented in page order in a single Change Request Report.
To use Aardvark follow this procedure:
Send your issues by electronic mail to the appropriate group
in the following format:
Subject: BUG in <document_name>
@ page <no.> line <no.> section <no.> objection|comment|editorial [comment]
Problem:
Explain why here.
Be sure to add sufficient explanation for someone not
familiar with the problem to be able to make a decision.
Action:
Be specific. For example:
Change "leftmost character"
to "first character in the string"
(You can normally trust the editor to take care of formatting issues in such
changes, including use of the correct font et cetera, unless there is
something out of the ordinary)
NOTE that page and line numbers must not include spaces: 1-2,3,5-6
is valid, but 1-2 3 5-6 is interpreted as 1-2.
PLease DO NOT USE TABS, nor indent your text unnecessarily.
Multiple comments on one document should be submitted in a single
message. Simply separate each comment by a blank line, then
start again from the `@ page ...' line. The `@' character
must be at the beginning of a new line and be followed by a space.
In the special case where you wish to raise a single issue
which has similar ramifications at many places in the
document, but which can be discussed together, it is helpful
if you state the first instance with @ page and list later
instances in the bug report without an @ symbol, for example:
@ page 344 line 62 section printf objection Also scanf
Problem:
Terms used in printf, scanf, and similar interface specs are not
consistent. In various places the terms "conversion letter",
"conversion specifier", and "conversion character" are used
interchangeably. I believe the correct term is "conversion
character", as defined on page 344, line 59.
Action:
Here and also at
page 344 line 52 section printf objection
page 344 line 53 section printf objection
page 346 line 92 section printf objection
page 381 line 40-41 section scanf objection
page 382 line 43 section scanf objection
Change "specifier" or "conversion specifier(s)" or
"conversion letter" to "conversion character(s)"
If all goes well, Aardvark sends you a message
confirming the number of bugs it was able to process from your
message.
Malformed "@" lines are rejected; if this happens,
Aardvark tries to send you email telling you which lines it
could not process.
-------------------------- end of file -----------------------------------