Fix cfg information in Rust docs

- support building Rust docs for docs.rs in `Makefile`

.github/workflows/ci.yml

@@ -193,9 +193,9 @@ jobs:
  - uses: actions-rs/toolchain@v1
  with:
  profile: minimal
- toolchain: stable
+ toolchain: nightly
 
- - run: make cargo.doc private=yes open=no
+ - run: make cargo.doc private=yes docsrs=yes open=no
 
 
 

Makefile

@@ -42,14 +42,17 @@ test: test.cargo test.book
 # Generate crates documentation from Rust sources.
 #
 # Usage:
-# make cargo.doc [crate=<crate-name>] [private=(yes|no)]
+# make cargo.doc [crate=<crate-name>]
+# [private=(yes|no)] [docsrs=(no|yes)]
 # [open=(yes|no)] [clean=(no|yes)]
 
 cargo.doc:
 ifeq ($(clean),yes)
  @rm -rf target/doc/
 endif
- cargo doc $(if $(call eq,$(crate),),--workspace,-p $(crate)) \
+ $(if $(call eq,$(docsrs),yes),RUSTDOCFLAGS='--cfg docsrs',) \
+ cargo $(if $(call eq,$(docsrs),yes),+nightly,) doc \
+ $(if $(call eq,$(crate),),--workspace,-p $(crate)) \
  --all-features \
  $(if $(call eq,$(private),no),,--document-private-items) \
  $(if $(call eq,$(open),no),,--open)

src/lib.rs

@@ -108,7 +108,7 @@
  unused_results,
  variant_size_differences
 )]
-#![cfg_attr(docsrs, feature(doc_cfg))]
+#![cfg_attr(docsrs, feature(doc_auto_cfg))]
 
 pub mod cli;
 mod cucumber;