Add --cfg docsrs to all rustdoc invocations
#2390
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
github-actions
bot
added
the
S-waiting-on-review
Nemo157
reviewed
Jan 23, 2024
Nemo157
reviewed
Jan 23, 2024
syphar
approved these changes
Jan 31, 2024
There was a problem hiding this comment.
I agree, from what I see this has become the de-facto standard, so setting it by default is a good idea.
You could see this as a breaking change, but only if
- someone used the feature name
docsrsfor something else, or - the feature exists for future usage, but shouldn't be used yet.
Also having @epage on this topic makes me lean towards seeing these as edge-cases, and merging & deploying this.
|
Good thinking through those cases and I agree that those are edge enough cases that for a service like docs.rs it seems fine for moving forward. |
github-actions
bot
added
S-waiting-on-deploy
bors
added a commit
to rust-lang/cargo
that referenced
this pull request
Feb 1, 2024
Add `docsrs` cfg as a well known `--check-cfg` Now that rust-lang/docs.rs#2390 has been merged we can add the `docsrs` cfg in Cargo well known --check-cfg "list". The `docsrs` cfg used by at least [3k project on GitHub](https://github.com/search?q=lang%3Atoml+%2Frustdoc-args+%3D+%5C%5B%22--cfg%22%2C+%22docsrs%22%5C%5D%2F+NOT+is%3Afork&type=code&repo=&langOverride=&start_value=1) alone; including the cfg will help reduce the impact of enabling by default this feature. > We include it here (in Cargo) instead of rustc, since there is a much closer relationship between Cargo and docs.rs than rustc and docs.rs. In particular, all users of docs.rs use Cargo, but not all users of rustc (like Rust-for-Linux) use docs.rs. This is part of the last remaining bits of the `--check-cfg` feature. r? `@epage`
syphar
removed
the
S-waiting-on-deploy
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Fixes #2389