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

[fs.definitions] needs overhaul #1534

Closed
zygoloid opened this issue Mar 13, 2017 · 2 comments
Closed

[fs.definitions] needs overhaul #1534

zygoloid opened this issue Mar 13, 2017 · 2 comments
Milestone

Comments

@zygoloid
Copy link
Member

[fs.definitions] thoroughly fails to follow the rules for a "Terms and definitions" clause in an ISO standard. The definitions are an inconsistent mix of half-sentences (with a trailing period but a leading lowercase word) and full sentences, or in some cases multiple sentences and even multiple paragraphs with nested lists.

Each definition should be rewritten to conform to this rule from the ISO directives: "The definition shall be written in such a form that it can replace the term in its context. It shall not start with an article ("the", "a") nor end with a full stop."

We should also merge these definitions into [definitions]. (Merging [intro.defs] and [definitions] is also probably required for ISO directive conformance, but I'd prefer to investigate whether it would be feasible to address that issue by splitting the standard into two Parts instead.)

@zygoloid zygoloid added this to the C++20 milestone Mar 13, 2017
@jwakely
Copy link
Member

jwakely commented Mar 14, 2017

It may be that many of these should not be in Terms & Definitions at all, but just introduced in prose with \term.

@jensmaurer
Copy link
Member

This seems to be fixed with the last-minute editorial changes or C++17.

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

3 participants