Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Standard has hanging paragraphs, not permitted by ISO #377

Closed
zygoloid opened this issue Aug 22, 2014 · 4 comments
Closed

Standard has hanging paragraphs, not permitted by ISO #377

zygoloid opened this issue Aug 22, 2014 · 4 comments

Comments

@zygoloid
Copy link
Member

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
Copy link
Member Author

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
Copy link

sigfpe commented Aug 22, 2014

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
#377 (comment).

@zygoloid
Copy link
Member Author

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:

  • we've lived with this in our drafts for a couple of years
  • it's a disruptive change to the standard's document, and introduces risk of major formatting problems
  • 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.

@sigfpe
Copy link

sigfpe commented Aug 25, 2014

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
#377 (comment).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants