rustdoc: update formatting of fn signatures and where clauses to match style rfcs #41084
Conversation
|
@rust-lang/docs |
|
Good for me. Thanks! |
- add spaces to output so stripping lines and breaking spaces renders the same - add commas to where clauses in rustdoc tests to match the new output
...so that we don't indent the next line by one extra space
|
Okay, i think i have both passing tests and proper formatting this time. If you want to browse a full rendering of std with this, i've got that hosted here, at least while this PR is open. Some other examples, including some crates i picked out specifically to render with this, are available as well, again, at least while this PR is open. If you find some rendering weirdness (at least with where clauses and fn signatures), let me know. |
|
This looks great @QuietMisdreavus! :) @bors r=frewsxcxv, GuillaumeGomez |
|
📌 Commit bfd01b7 has been approved by |
|
🔒 Merge conflict |
|
Oh dear. Do i need to try merging this with a fresh master to see what it's talking about? EDIT: Oh, i see it now, it was done before the hoedown/pulldown switch. |
|
Nah. This is a homu issue. You can remove the merge commit I'd you want. We'll need to restart bors |
|
@bors r=frewsxcxv,GuillaumeGomez |
|
📌 Commit 8dd4c44 has been approved by |
|
⌛ Testing commit 8dd4c44 with merge d616f47... |
…cxv,GuillaumeGomez rustdoc: update formatting of fn signatures and where clauses to match style rfcs Recent updates to style RFCs ([where clauses](rust-lang/style-team#38), [function definitions](rust-lang/style-team#39)) changed the "canonical" style for these items, so this is a rustdoc update to make it emit that style where necessary. This is mainly a conversion from visual indent to block indent, which helps out in situations where there was excessive indent causing lines to wrap regardless. Samples:        fixes #41025 and #40687 r? @rust-lang/docs
|
☀️ Test successful - status-appveyor, status-travis |
Recent updates to style RFCs (where clauses, function definitions) changed the "canonical" style for these items, so this is a rustdoc update to make it emit that style where necessary. This is mainly a conversion from visual indent to block indent, which helps out in situations where there was excessive indent causing lines to wrap regardless.
Samples:
fixes #41025 and #40687
r? @rust-lang/docs