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

Remove ability to check bin-only targets, to fix doc = false issue. #663

Merged
merged 1 commit into from
Feb 13, 2024

Conversation

obi1kenobi
Copy link
Owner

Because of a complex web of edge cases, we can either choose to continue to support our legacy behavior of allowing bin-only targets to be semver-checked, or we can support semver-checking lib targets that set doc = false. Semver-checking bin-only targets doesn't make a lot of sense, since they cannot be used as a library anyway. This functionality was always slated for removal, I just wish we had more time to deprecate & warn on it before just ripping it out like this.

Now we're in a tight spot, and this is definitely the lesser evil -- we're making the tool work for library users who produce an API that can reasonably be checked and used as such.

Fixes #660.

Because of a complex web of edge cases, we can _either_ choose to continue to support our legacy behavior of allowing bin-only targets to be semver-checked, _or_ we can support semver-checking lib targets that set `doc = false`. Semver-checking bin-only targets doesn't make a lot of sense, since they cannot be used as a library anyway. This functionality was always slated for removal, I just wish we had more time to deprecate & warn on it before just ripping it out like this.

Now we're in a tight spot, and this is definitely the lesser evil -- we're making the tool work for library users who produce an API that can reasonably be checked and used as such.

Fixes #660.
@obi1kenobi obi1kenobi enabled auto-merge (squash) February 13, 2024 14:51
@obi1kenobi obi1kenobi added A-cli Area: engine around the lints C-enhancement Category: raise the bar on expectations M-breaking-change Meta: Implementing or merging this will introduce a breaking change. labels Feb 13, 2024
@obi1kenobi obi1kenobi merged commit 84567e2 into main Feb 13, 2024
33 checks passed
@obi1kenobi obi1kenobi deleted the fix_doc_false branch February 13, 2024 14:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A-cli Area: engine around the lints C-enhancement Category: raise the bar on expectations M-breaking-change Meta: Implementing or merging this will introduce a breaking change.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Crates with doc = false on their lib target cannot be semver-checked
1 participant