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

fix cargo doc failing on stable Rust #904

Merged
merged 1 commit into from
Oct 30, 2022
Merged

Conversation

bakape
Copy link
Contributor

@bakape bakape commented Oct 27, 2022

I assume this was a simple typo. I depend on this lib and can no longer run cargo doc on stable.

@bakape bakape requested a review from a team as a code owner October 27, 2022 14:55
@TommyCpp
Copy link
Contributor

/easycla

@linux-foundation-easycla
Copy link

linux-foundation-easycla bot commented Oct 29, 2022

CLA Signed

The committers listed above are authorized under a signed CLA.

@TommyCpp
Copy link
Contributor

Thanks for the fix. Just need to sign the CLA

@bakape
Copy link
Contributor Author

bakape commented Oct 30, 2022

Signed.

@djc djc merged commit 2d9739b into open-telemetry:main Oct 30, 2022
arpad-m added a commit to neondatabase/neon that referenced this pull request Jul 15, 2023
## Problem

`cargo +nightly doc` is giving a lot of warnings: broken links, naked
URLs, etc.

## Summary of changes

* update the `proc-macro2` dependency so that it can compile on latest
Rust nightly, see dtolnay/proc-macro2#391 and
dtolnay/proc-macro2#398
* allow the `private_intra_doc_links` lint, as linking to something
that's private is always more useful than just mentioning it without a
link: if the link breaks in the future, at least there is a warning due
to that. Also, one might enable
[`--document-private-items`](https://doc.rust-lang.org/cargo/commands/cargo-doc.html#documentation-options)
in the future and make these links work in general.
* fix all the remaining warnings given by `cargo +nightly doc`
* make it possible to run `cargo doc` on stable Rust by updating
`opentelemetry` and associated crates to version 0.19, pulling in a fix
that previously broke `cargo doc` on stable:
open-telemetry/opentelemetry-rust#904
* Add `cargo doc` to CI to ensure that it won't get broken in the
future.

Fixes #2557

## Future work
* Potentially, it might make sense, for development purposes, to publish
the generated rustdocs somewhere, like for example [how the rust
compiler does
it](https://doc.rust-lang.org/nightly/nightly-rustc/rustc_driver/index.html).
I will file an issue for discussion.
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

Successfully merging this pull request may close these issues.

None yet

3 participants