normative notes
nad editorial
Martin Sebor

Created on 2003-09-18.00:00:00 last changed 149 months ago


Date: 2010-10-21.18:28:33

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

Date: 2010-10-21.18:28:33

[ 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. ]

Date: 2010-10-21.18:28:33

[ 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. ]

Date: 2010-10-21.18:28:33

[ post San Francisco: Howard: reopened, needs attention. ]

Date: 2010-10-21.18:28:33

[ Bellevue: Specifics of list 3: First 2 items correct in std (, Third item should be non-normative (, which Pete will handle editorially. ]

Date: 2010-10-21.18:28:33

[ 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. ]

Date: 2003-09-18.00:00:00

The text in, 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.

Date User Action Args
2010-10-21 18:28:33adminsetmessages: + msg2584
2010-10-21 18:28:33adminsetmessages: + msg2583
2010-10-21 18:28:33adminsetmessages: + msg2582
2010-10-21 18:28:33adminsetmessages: + msg2581
2010-10-21 18:28:33adminsetmessages: + msg2580
2010-10-21 18:28:33adminsetmessages: + msg2579
2003-09-18 00:00:00admincreate