8000 Use `cargo doc --document-private-items` by bradjc · Pull Request #4068 · tock/tock · GitHub
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

Use cargo doc --document-private-items #4068

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

Merged
merged 5 commits into from
Jul 8, 2024
Merged

Use cargo doc --document-private-items #4068

merged 5 commits into from
Jul 8, 2024

Conversation

bradjc
Copy link
Contributor
@bradjc bradjc commented Jul 8, 2024

Pull Request Overview

I think when we added --document-hidden-items we really meant to use --document-private-items. This change not only doesn't require an unstable flag, it also generates better docs (fixes #4064) and checks more of our documentation.

I had to make a few fixes for cargo doc to succeed on hail.

Testing Strategy

travis

TODO or Help Wanted

n/a

Documentation Updated

  • Updated the relevant files in /docs, or no updates are required.

Formatting

  • Ran make prepush.

lschuermann
lschuermann previously approved these changes Jul 8, 2024
@github-actions github-actions bot added nrf Change pertains to the nRF5x family of MCUs. risc-v RISC-V architecture WG-OpenTitan In the purview of the OpenTitan working group. labels Jul 8, 2024
@brghena
Copy link
Contributor
brghena commented Jul 8, 2024

Is this good to go @bradjc, or are there more changes coming?

@bradjc
Copy link
Contributor Author
bradjc commented Jul 8, 2024

All good if it passes CI

@brghena brghena added this pull request to the merge queue Jul 8, 2024
Merged via the queue into master with commit 25e001c Jul 8, 2024
18 checks passed
@brghena brghena deleted the doc-private branch July 8, 2024 03:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
kernel nrf Change pertains to the nRF5x family of MCUs. risc-v RISC-V architecture WG-OpenTitan In the purview of the OpenTitan working group.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Doc: -Z unstable-options --document-hidden-items causes Kernel struct to not be documented.
4 participants
0