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 #[doc(cfg(...))] attributes #1554

Merged
merged 1 commit into from
Oct 16, 2021

Conversation

arqunis
Copy link
Member

@arqunis arqunis commented Oct 16, 2021

Description

This removes all uses of the #[doc(cfg(...))] attribute. The purpose of this attribute was to tell rustdoc to add an annotation, which would inform users what features an item (module, struct, trait, method, etc.) needed. However, in the latest Nightly, this attribute is implicit when #![feature(doc_cfg)] is enabled. Thus, our usage of this attribute is unnecessary and we can remove it.

Type of Change

This is an enhancement to the library's code by removing clutter, which is related to documentation.

How Has This Been Tested?

This has been tested by ensuring existing annotations haven't been removed.

@arqunis arqunis added enhancement An improvement to Serenity. docs Related to documentation. labels Oct 16, 2021
@kangalio
Copy link
Collaborator

What a bliss not to have to duplicate all of the cfg's anymore 😌

@arqunis arqunis merged commit b295206 into serenity-rs:current Oct 16, 2021
@arqunis arqunis deleted the remove_doc_cfg branch October 16, 2021 19:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Related to documentation. enhancement An improvement to Serenity.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants