Created on 2003-09-18.00:00:00 last changed 171 months ago
[ Batavia (2009-05): ]
A spot-check of List 2 suggests the issue is still relevant, and a review of List 3 still seems called-for.
Move to NAD Editorial.
[ Batavia: We feel that the references in List 2 above should be changed from Remarks to Notes. We also feel that those items in List 3 need to be double checked for the same change. Alan and Pete to review. ]
[ Pete: I changed the paragraphs marked "Note" and "Notes" to use "Remark" and "Remarks". Fixed as editorial. This change has been in the WD since the post-Redmond mailing, in 2004. Recommend NAD. ]
[ post San Francisco: Howard: reopened, needs attention. ]
[ Bellevue: Specifics of list 3: First 2 items correct in std (22.1.1.2, 22.1.1.5) Third item should be non-normative (27.5.2.4.5), which Pete will handle editorially. ]
[ Definitely a real problem. The big problem is there's material that doesn't quite fit any of the named paragraph categories (e.g. Effects). Either we need a new kind of named paragraph, or we need to put more material in unnamed paragraphs jsut after the signature. We need to talk to the Project Editor about how to do this. ]
The text in 17.3.1.1, p1 says:
"Paragraphs labelled "Note(s):" or "Example(s):" are informative, other
paragraphs are normative."
The library section makes heavy use of paragraphs labeled "Notes(s),"
some of which are clearly intended to be normative (see list 1), while
some others are not (see list 2). There are also those where the intent
is not so clear (see list 3).
List 1 -- Examples of (presumably) normative Notes:
[allocator.members], p3,
[allocator.members], p10,
[string.cons], p11,
[locale.cons], p11,
[deque.modifiers], p2,
[alg.min.max], p3,
[complex.ops], p15,
[streambuf.virt.get], p7.
List 2 -- Examples of (presumably) informative Notes:
[new.delete.placement], p3,
[string.replace], p14,
[locale.codecvt.virtuals], p3,
[alg.foreach], p4,
[complex.member.ops], p1,
[ios.base.storage], p6.
List 3 -- Examples of Notes that are not clearly either normative
or informative:
[locale.cons], p8,
[locale.statics], p6,
[streambuf.virt.put], p4.
None of these lists is meant to be exhaustive.
History | |||
---|---|---|---|
Date | User | Action | Args |
2010-10-21 18:28:33 | admin | set | messages: + msg2584 |
2010-10-21 18:28:33 | admin | set | messages: + msg2583 |
2010-10-21 18:28:33 | admin | set | messages: + msg2582 |
2010-10-21 18:28:33 | admin | set | messages: + msg2581 |
2010-10-21 18:28:33 | admin | set | messages: + msg2580 |
2010-10-21 18:28:33 | admin | set | messages: + msg2579 |
2003-09-18 00:00:00 | admin | create |