Avoid use of docsrs cfg

cfg is a global namespace, and we don't want to trigger this in
dependencies.

Author: ctz

.github/workflows/ci.yml

@@ -87,7 +87,7 @@ jobs:
       - name: cargo doc (all features)
         run: cargo doc --locked --all-features --document-private-items
         env:
-          RUSTDOCFLAGS: ${{ matrix.rust_channel == 'nightly' && '-Dwarnings --cfg=docsrs' || '-Dwarnings' }}
+          RUSTDOCFLAGS: ${{ matrix.rust_channel == 'nightly' && '-Dwarnings --cfg=webpki_docsrs' || '-Dwarnings' }}
 
   package:
     name: Cargo Package

Cargo.toml

@@ -58,7 +58,7 @@ include = [
 
 [package.metadata.docs.rs]
 all-features = true
-rustdoc-args = ["--cfg", "docsrs"]
+rustdoc-args = ["--cfg", "webpki_docsrs"]
 
 [package.metadata.cargo_check_external_types]
 allowed_external_types = [
@@ -116,3 +116,6 @@ harness = false
 
 [package.metadata.cargo-semver-checks.lints]
 enum_variant_marked_deprecated = "warn"
+
+[lints.rust]
+unexpected_cfgs = { level = "warn", check-cfg = ['cfg(webpki_docsrs)'] }

src/lib.rs

@@ -44,7 +44,7 @@
     clippy::upper_case_acronyms
 )]
 // Enable documentation for all features on docs.rs
-#![cfg_attr(docsrs, feature(doc_cfg, doc_auto_cfg))]
+#![cfg_attr(webpki_docsrs, feature(doc_cfg, doc_auto_cfg))]
 
 #[cfg(any(feature = "std", test))]
 extern crate std;