-
Notifications
You must be signed in to change notification settings - Fork 164
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
Add embedded targets to docs.rs #256
Conversation
(rust_highfive has picked a reviewer for you, use r? to override) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Sounds like a good idea. It would be even better if we used #[doc(cfg)]
throughout the crate, then we only have to build for thumbv8-hf but users would see which features are available when.
Cargo.toml
Outdated
targets = ["thumbv8m.main-none-eabihf", | ||
"thumbv6m-none-eabi", | ||
"thumbv7em-none-eabi", | ||
"thumbv7em-none-eabihf", | ||
"thumbv7m-none-eabi", | ||
"thumbv8m.base-none-eabi", | ||
"thumbv8m.main-none-eabi" |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
targets = ["thumbv8m.main-none-eabihf", | |
"thumbv6m-none-eabi", | |
"thumbv7em-none-eabi", | |
"thumbv7em-none-eabihf", | |
"thumbv7m-none-eabi", | |
"thumbv8m.base-none-eabi", | |
"thumbv8m.main-none-eabi" | |
targets = [ | |
"thumbv8m.main-none-eabihf", | |
"thumbv6m-none-eabi", | |
"thumbv7em-none-eabi", | |
"thumbv7em-none-eabihf", | |
"thumbv7m-none-eabi", | |
"thumbv8m.base-none-eabi", | |
"thumbv8m.main-none-eabi", |
7ba20b0
to
398de5c
Compare
Signed-off-by: Hugues de Valon <hugues.devalon@arm.com>
398de5c
to
51dfa4d
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
bors r+
Build succeeded: |
Could a quick patch release be done for that to be up on |
Hopefully we can get 0.7 out soon which will include this. |
Since rust-embedded/cortex-m#256 (released in v0.7) the docs links from cortex-m to this crate link to the target specific version. As these targets are not included on this crate the links fail. For example; see the links to RO on this page https://docs.rs/cortex-m/0.7.3/cortex_m/peripheral/cpuid/struct.RegisterBlock.html
Some modules of this repo are gated by the various targets and hence docs.rs does not show the documentation for them! Like the Armv8-M ones for example and the
cmse
module.docs.rs now allows building for specific target and since this PR even for targets available via
rustup
!The
stm32f3_discovery
crate does it, look at "Platform" on docs.rs.So I think it would be very neat to have on
cortex-m
and I proposing to add the following targets. The first one will show by default, I choosed the latest and greatest for that 😄I tested locally with
cargo doc --target ...
for all of them.