!editorial comment 089
!topic  Annex D Suggested Corrections
!reference  ASIS 95-Annex D
!from  Dan Cooper 97-03-31
!keywords  Rationale
!discussion

I proof-read Annex D and have the following comments (identified as
page/line#); I suppose it's not really necessary to do any of them,
though, depending on your workload.

248/35: "Supple" should be "Supplement" (how did this happen?)

248/24, 249/38, 250/12, 250/21: 
       change dashes to "M dashes", ie, long horizontal bars

249/3: remove hard CR at the end of line

251/27-28: "Tools are vendor dependent, such that a given tool cannot
access Ada libraries from multiple vendors, or equivalent tools from
multiple vendors cannot access a given Ada library"

253/37: meaning not clear
253/49: meaning not clear

254/24: underbars needed?

254/45: change "hierarchies" to "a hierarchy"
255/14: change "names" to "terminology"
255/26: change "an" to "a"
256/29: change "to it, the" to "to it, and the"
256/37: change "has to be able to do so" to "must"
256/40: change "too" to "also"

255/18: unclear/awkward phrase, "is justified by maintenance"
255/21: unclear/awkward phrase, "even if they should be as few as possible"

256/14: change warning to ASISWG to an assertion, 
        "ASIS must be aware...and must make consistent use..."

257/2: remove hard FF at end of page

258/25: change "to provide" to "from providing"
258/37: change "full" to "fully"
258/39: delete "that"

259/7 and 10: change "are" to "is"

260/25: delete opinion?

261/4: this statement anticipates standardization, but how will it read
forever afterwards?

263/12: reference #6, should more info be provided?

263/22: reference #11, should say "U.S." Department of Defense, per the
actual document; also to preserve alphabetical ordering of references

263/24: reference #12, should be moved to become #3 in alphabetical order
(but this will cause renumber of the remaining references)

---------------------------------------------------

Overall hint: I have found it helpful, along with spell-checking, to also
search for "  " (space/space pair) and replace it with a single space --
at least in non-courier code text. I saw a couple of occurrences in the
English text, eg, 224/22.

!resolution  Accept.

Corrections were made in ASIS version 2.0.M, except for the questions
asked in comments about lines 261/4 and 263/12, where no changes were
necessary.