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

[support.initlist] Reorganize like [support.srcloc] #5720

Open
JohelEGP opened this issue Aug 8, 2022 · 4 comments
Open

[support.initlist] Reorganize like [support.srcloc] #5720

JohelEGP opened this issue Aug 8, 2022 · 4 comments

Comments

@JohelEGP
Copy link
Contributor

JohelEGP commented Aug 8, 2022

Originating comment: #5713 (comment).

1659968613

What's titled as "Header <initializer_list> synopsis" is actually the class' synopsis. I suggest copying the format of [support.srcloc] instead:

1659968626

@tkoeppe
Copy link
Contributor

tkoeppe commented Aug 11, 2022

It looks like we've combined the header and the class synopsis here. Given how small the header is, what's the value in splitting the two? Is the status quo unclear or confusing?

@JohelEGP
Copy link
Contributor Author

https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2019/p1208r6.pdf used to look pretty much like [support.initlist] looks now, but that changed during #3037.
1660227190

@tkoeppe
Copy link
Contributor

tkoeppe commented Aug 11, 2022

Yes, I see. We had to fix the hanging paragraphs, but arguably source_location does that in a sligthly more principled way.

@tkoeppe
Copy link
Contributor

tkoeppe commented Aug 11, 2022

On the flip side, source_location requires excessive nesting for such a short subclause, so I'm not sure which way is better here.

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