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.

Sign up for GitHub

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

Jump to bottom

[support.types] Mixed-up description of <cstddef> #1404

Closed
jensmaurer opened this issue Jan 25, 2017 · 1 comment
Closed

[support.types] Mixed-up description of <cstddef> #1404

jensmaurer opened this issue Jan 25, 2017 · 1 comment
Assignees
@jensmaurer

Comments

@jensmaurer
Copy link
Member

jensmaurer commented Jan 25, 2017 •
edited

In [support.types], we show the synopsis of <cstddef> in 18.2.1 with no prose and the synopsis of <cstdlib> in 18.2.2 with prose following.

The issue is that the prose that follows claims to talk only about <cstdlib>, but that's a lie: It refers to 18.2.3 [support.types.nullptr], 18.2.4 [support.types.layout], but those two sections talk about nullptr and offsetof, respectively, two items defined in <cstddef>, not in <cstdlib>.

We're also missing the boilerplate sentence

The contents and meaning of the header <cstdlib> are the same as the C standard library header <stdlib.h>, except ...

for <cstddef>.

Proposal: Clone this sentence for <cstddef>, to follow its synopsis.
@jensmaurer
Copy link
Member Author

It turns out that <cstdlib> does define NULL and size_t, so the references to 18.2.3 [support.types.nullptr], 18.2.4 [support.types.layout] are fine.

@jensmaurer jensmaurer self-assigned this Jan 31, 2017
jensmaurer added a commit to jensmaurer/draft that referenced this issue Jan 31, 2017
@jensmaurer
[support.types] Properly describe <cstddef> header
b4f3fe6 
After the synopsis for <cstddef>, add a sentence (cloned from cstdlib.syn)
that the contents are the same as <stddef.h> except for wchar_t,
[support.types.nullptr], and [support.types.layout].

Fixes cplusplus#1404.
@jensmaurer jensmaurer mentioned this issue Jan 31, 2017
Merged
zygoloid pushed a commit that referenced this issue Feb 4, 2017
@jensmaurer @zygoloid
[support.types] Properly describe <cstddef> header (#1415)
3f01332 
After the synopsis for <cstddef>, add a sentence (cloned from cstdlib.syn)
that the contents are the same as <stddef.h> except for wchar_t,
[support.types.nullptr], and [support.types.layout].

Fixes #1404.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees

@jensmaurer jensmaurer

Labels
None yet
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
1 participant
@jensmaurer