search

cplusplus / draft

C++ standards drafts
http://www.open-std.org/jtc1/sc22/wg21/
5.67k stars 749 forks source link

Standard has hanging paragraphs, not permitted by ISO #377

Closed zygoloid closed 10 years ago

zygoloid commented 10 years ago

DIS 14882:2014 NB comment JP 18:

Hanging paragraphs can often be found in this DIS. ISO/IEC Directives do not allow hanging paragraphs.

zygoloid commented 10 years ago

NAD: Comment provides no examples, and a search through the standard does not find any. Some paragraphs have an indent after an example or note; this is fixed in the working draft but will not be fixed for C++14, and is not a hanging indent.

sigfpe commented 10 years ago

We need to fix the indented paragraphs after codes. The affected paragraphs are difficult to read. Compare with C++98 and C++03 documents.

On Thu, Aug 21, 2014 at 6:04 PM, Richard Smith notifications@github.com wrote:

NAD: Comment provides no examples, and a search through the standard does not find any. Some paragraphs have an indent after an example or note; this is fixed in the working draft but will not be fixed for C++14, and is not a hanging indent.

— Reply to this email directly or view it on GitHub https://github.com/cplusplus/draft/issues/377#issuecomment-53009552.

zygoloid commented 10 years ago

Yes. This is already fixed in head, we need to decide whether to take this change into the C++14 IS. My initial position is that I'm opposed:

Stefanus also indicated that he doesn't see this as sufficiently pressing to be worth fixing for C++14.

sigfpe commented 10 years ago

On Sun, Aug 24, 2014 at 10:15 PM, Richard Smith notifications@github.com wrote:

Yes. This is already fixed in head, we need to decide whether to take this change into the C++14 IS.

Yes, that is the suggestion: to make the correction in C++14 IS.

My initial position is that I'm opposed:

-- we've lived with this in our drafts for a couple of years

Drafts are generally to be incomplet, incorrekt, and, yes, ghastly formatted :-)

-- it's a disruptive change to the standard's document, and introduces risk of major formatting problems

Hmm, removing the misplaced indentation should be a matter of inserting \noindent.

-- we do not have sufficient time to gain confidence that no regressions have been introduced

Stefanus also indicated that he doesn't see this as sufficiently pressing to be worth fixing for C++14.

It is a serious disruption from previous published IS and really an impediment to readability.

— Reply to this email directly or view it on GitHub https://github.com/cplusplus/draft/issues/377#issuecomment-53227488.