Skip to content

Make docblock <code> elements inline so they behave better - #163623

Open
GuillaumeGomez wants to merge 1 commit into
rust-lang:mainfrom
GuillaumeGomez:code-inline
Open

GuillaumeGomez wants to merge 1 commit into
rust-lang:mainfrom
GuillaumeGomez:code-inline

Conversation

@GuillaumeGomez

@GuillaumeGomez GuillaumeGomez commented Oct 1, 2026 •

Copy link
Copy Markdown
Member

Fixes #133075.

Whole problem description is in #133075 with nice screenshots so not going to duplicate its content here (although I'll add review comments on my PR to help the review 😉 ).

r? @lolbinarycat

@rustbot

rustbot commented Oct 1, 2026

Copy link
Copy Markdown
Collaborator

Some changes occurred in HTML/CSS/JS.

cc @lolbinarycat

@rustbot rustbot added A-rustdoc-js Area: Rustdoc's JS front-end S-waiting-on-review Status: Awaiting review from the assignee but also interested parties. T-rustdoc Relevant to the rustdoc team, which will review and decide on the PR/issue. labels Oct 1, 2026
@rustbot rustbot added the T-rustdoc-frontend Relevant to the rustdoc-frontend team, which will review and decide on the web UI/UX output. label Oct 1, 2026
@@ -499,6 +499,9 @@ code, pre, .code-header, .type-signature {
border-radius: 3px;
padding: 0 0.125em;
}
.docblock code {
padding: 2px 0.125em;

@GuillaumeGomez GuillaumeGomez Oct 1, 2026 •

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Difference between inline-block and inline is that the box-sizing: border-box; isn't taken into account anymore, so we lose ~4px in height (a GUI test failed because of that, yeay person who wrote it!). So to compensate, I added the 2px padding on top and bottom.

View changes since the review

@@ -0,0 +1,93 @@
// This test ensures that `<code>` in docblocks are `display: inline` so comma are

@GuillaumeGomez GuillaumeGomez Oct 1, 2026 •

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hopefully the comments in this file makes sense as I tried to explain how I tested this behaviour.

View changes since the review

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A-rustdoc-js Area: Rustdoc's JS front-end S-waiting-on-review Status: Awaiting review from the assignee but also interested parties. T-rustdoc Relevant to the rustdoc team, which will review and decide on the PR/issue. T-rustdoc-frontend Relevant to the rustdoc-frontend team, which will review and decide on the web UI/UX output.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

rustdoc: single comma is put on newline if it occurs after item in double ticks

3 participants