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

Improve synopsis presentation for function pointers with different language linkages #1002

Closed
tkoeppe opened this issue Nov 12, 2016 · 0 comments
Closed

Improve synopsis presentation for function pointers with different language linkages #1002

tkoeppe opened this issue Nov 12, 2016 · 0 comments

Comments

@tkoeppe
Copy link
Contributor

tkoeppe commented Nov 12, 2016 •
edited

We should clean up the synopses for at_exit, qsort, signal and such like to be clear that the language linkage of the function itself is not specified, but rather that we have overloads for the callback function parameter only. This may require some acrobatics, such as:

extern "C" using PredC = int(const void*, const void*);  // exposition only
extern "C++" using PredCXX = int(const void*, const void*);  // exposition only
void qsort(void*, size_t, size_t, PredC*);
void qsort(void*, size_t, size_t, PredCXX*);
tkoeppe added a commit to tkoeppe/draft that referenced this issue Nov 15, 2016
@tkoeppe
[cstdlib.syn, csignal.syn] Introduce exposition-only function types w…
37a40f3 
…ith C and C++ language linkage to improve the presentation of C library functions that take callbacks.

This change improves correctness, since we never meant to specify the language linkage of the function names, but only of the callback parameter type.

Fixes cplusplus#1002.
@tkoeppe tkoeppe mentioned this issue Nov 15, 2016
Merged
tkoeppe added a commit to tkoeppe/draft that referenced this issue Nov 15, 2016
@tkoeppe
[cstdlib.syn, csignal.syn] Introduce exposition-only function types w…
101b03f 
…ith C and C++ language linkage to improve the presentation of C library functions that take callbacks.

This change improves correctness, since we never meant to specify the language linkage of the function names, but only of the callback parameter type.

Fixes cplusplus#1002.
tkoeppe added a commit to tkoeppe/draft that referenced this issue Nov 15, 2016
@tkoeppe
[cstdlib.syn, csignal.syn] Introduce exposition-only function types w…
3b23055 
…ith C and C++ language linkage to improve the presentation of C library functions that take callbacks.

This change improves correctness, since we never meant to specify the language linkage of the function names, but only of the callback parameter type.

Fixes cplusplus#1002.
tkoeppe added a commit to tkoeppe/draft that referenced this issue Nov 16, 2016
@tkoeppe
[cstdlib.syn, csignal.syn] Introduce exposition-only function types w…
a620701 
…ith C and C++ language linkage to improve the presentation of C library functions that take callbacks.

This change improves correctness, since we never meant to specify the language linkage of the function names, but only of the callback parameter type.

Fixes cplusplus#1002.
tkoeppe added a commit to tkoeppe/draft that referenced this issue Nov 16, 2016
@tkoeppe
[cstdlib.syn, csignal.syn] Introduce exposition-only function types w…
913359c 
…ith C and C++ language linkage to improve the presentation of C library functions that take callbacks.

This change improves correctness, since we never meant to specify the language linkage of the function names, but only of the callback parameter type.

Fixes cplusplus#1002.
zygoloid pushed a commit that referenced this issue Nov 16, 2016
@tkoeppe @zygoloid
[cstdlib.syn, csignal.syn] Introduce exposition-only function types w…
9df9501 
…ith C and C++ language linkage to improve the presentation of C library functions that take callbacks. (#1049)

This change improves correctness, since we never meant to specify the language linkage of the function names, but only of the callback parameter type.

Fixes #1002.
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
1 participant
@tkoeppe