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

confused collection of synopses for <cstdlib> #542

Closed
zygoloid opened this issue Oct 7, 2015 · 4 comments
Closed

confused collection of synopses for <cstdlib> #542

zygoloid opened this issue Oct 7, 2015 · 4 comments

Comments

@zygoloid
Copy link
Member

zygoloid commented Oct 7, 2015

We do not present a single unified view of the header anywhere. Instead, we have six (!) separate tables with the title "Header synopsis" distributed across 5 library clauses, and none of them describes the complete contents of the header. In some places we say that the table describes some of the contents of the header. In some places we incorrectly say it describes the complete contents.

Ideally, we should have a single place where we say what is actually in this header.
@zygoloid
Copy link
Member Author

zygoloid commented Oct 7, 2015

Similarly, [c.malloc] claims to provide a synopsis for but misses most of the contents. The complete contents in this case are listed in [c.strings]

@tkoeppe tkoeppe mentioned this issue Nov 20, 2015
Closed
@tkoeppe
Copy link
Contributor

tkoeppe commented Nov 20, 2015

What do you mean by "describe what is in this header"? If the following wording says that something from the header is replaced by something else (e.g. strchr), should the synopsis show the C original or a synthetic version with the C++ changes applied?

@timsong-cpp
Copy link
Contributor

...and none of the six tables contains NULL, which is supposed to be defined by <cstdlib>.

@tkoeppe
Copy link
Contributor

tkoeppe commented Nov 18, 2016

Those were dark days. The draft looks much different now.

@tkoeppe tkoeppe closed this as completed Nov 18, 2016
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
3 participants
@zygoloid @tkoeppe @timsong-cpp