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 -----------------------------------