[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Guidelines and template for dpANS Common Lisp reviewers
Guidelines for reviewers of draft proposed American National Standard for
* The Public Review Comment Form appended below should make it easy to
follow most of these guidelines.
* As of the date of this posting, there are exactly two months until the
close of the public review period, November 23, 1992. Early comments are
not required, but will definitely be helpful.
* Be sure to identify the author(s) of the review comment. Include
organization information and contact information (mail, e-mail,
phone, and/or fax information).
* If you have comments about multiple topics, please number them
individually so that we may refer to them unambiguously. Don't send
each comment as a separate message, as it will increase our
bookkeeping overhead and take time away from the technical response.
If you do make multiple submissions, please identify in each
subsequent set of comments that you are continuing your previous
comments, and resume numbering of your comments from where you left
off in the previous so that confusion about `your comment number 1'
does not occur.
* It will save us work if you e-mail us a copy of your comments as well
as submitting them in hardcopy form to X3. However, note that your
comments *must* be received through official X3 channels before we
can act upon them.
Official review comments MUST be sent to EACH of the following TWO
1. X3 Secretariat, Attn.: Lynn Barra
1250 Eye Street NW, Suite 200, Washington, DC 20005-3922.
2. American National Standards Institute, Attn: BSR Center
11 West 42nd St. 13th Floor, New York, NY 10036.
The Internet mail address for submitting comments is
firstname.lastname@example.org; however, note that comments sent only to this
address are unofficial, and may be ignored if hardcopy is not sent to
the above addresses.
For each comment you submit:
* Include as specific as possible a reference to dpANS CL (page,
section, paragraph, etc.). For example: "p.37-983, section
22.214.171.124.7" or "p.37-983, Description of FOO, paragraph 3".
To refer to multiple pages, use ".." rather than "-" to avoid
confusion with the hyphens in a section name, e.g. "p.37-983..984".
Additional references may be provided to other supporting material,
such as "Common Lisp: The Language" (CLtL1) or X3J13 documents. If
you use CLtL as a reference, make sure you specify which edition, i.e.
refer to CLtL1 or CLtL2 rather than just CLtL. "Common Lisp: The
Language, Second Edition" (CLtL2) may be cited for explanatory
purposes, but note that this is not an official document of X3J13
(CLtL1, on the other hand, was the official base document from which
X3J13 derived the dpANS).
* Include a description of the problem. Try to be specific. We
probably won't take any action in response to vague complaints like
"the language is too big" or "LOOP is broken".
* If you report technical problems in the language, it would be helpful
if you could also summarize what changes you think should be made
to correct the problem and the rationale for such changes.
In some extreme cases, it may be appropriate to attach as supporting
documentation a draft proposal in the usual X3J13 cleanup format.
If you want to do this and need help, please contact us at the
electronic mail address above.
Keep in mind that the committee weighs the benefits of any proposed
change against conversion costs for existing implementations and
applications, so we are unlikely to consider suggestions for changes
that are not intended to fix a specific problem.
* When you suggest specifc changes to the language, it would be helpful
(both to you and to us) for you to describe the expected costs (both to
implementors and users) of taking the suggestion, the benefits of taking
the suggestion, and the ill effects of not taking the suggestion.
* Requests for clarifications are welcome, for example if you find parts
of the document where the intent is unclear, or apparent omissions or
* We also welcome comments about other problems of an editorial
nature, such as typographical errors.
dpANS Common Lisp Public Review Comment Form
[Please fill out a separate form for each comment (they may be
concatenated in a single mail message -- use the line of dashes as a
delimiter). Commentary in [square brackets] may be deleted. Comments
MUST be mailed to BOTH:
X3 Secretariat, Attn.: Lynn Barra
1250 Eye Street NW, Suite 200, Washington, DC 20005-3922 USA.
American National Standards Institute, Attn: BSR Center
11 West 42nd St. 13th Floor, New York, NY 10036 USA.
In addition, they may be emailed to email@example.com to speed up
City: State: ZIP/Postal code:
Phone number: Fax number:
[A sequence number unique among your comments.]
dpANS draft version:
[From upper-left corner of each page.]
Type of comment: ___ Editorial ___ Technical
[Note that X3J13 is only required to respond to technical comments.]
Suggested committee action:
[1. None. Comment is "for your information only".
2. None at this time. Note for future work.
3. Note an ambiguity in the spec, but don't try to correct it.
4. Change the specification.
5. Other (please specify).
For cases 3 and 4, filling in the "Suggested change" field will be
[Please be specific and detailed. Optionally include expected costs and
benefits of accepting the suggestion, and/or ill effects of not
[Not required, but specific wording changes are helpful. If you wish,
you may attach an X3J13 Cleanup Proposal; FTP
parcftp.xerox.com:/pub/cl/cleanup/proposal-format for the template.]