使用--document-private-items生成rustdoc时slog::info宏冗余内容的解决方法

以下几种方案可消除slog::info宏生成的冗余文档内容：

• 用#[doc(hidden)]标记宏展开私有项
  若能定位到宏生成的私有结构体、函数等，可手动为其添加#[doc(hidden)]属性，rustdoc会自动忽略这些项。不过宏展开内容多为编译器自动生成，定位起来可能需要额外步骤。

• 调整rustdoc过滤规则
  在Cargo.toml中配置rustdoc参数，排除特定依赖或模块：

  [package.metadata.docs.rs]
  rustdoc-args = ["--document-private-items", "--exclude", "slog::*"]
  

  也可根据实际情况更精准地指定要排除的宏生成路径。

• 限定slog宏的使用范围
  避免全局导入slog宏，改为在需要的模块内局部导入，缩小宏展开的范围，减少冗余文档生成：

  mod target_module {
      #[macro_use]
      extern crate slog;
      // 仅在此模块内使用slog相关宏
  }
  

• 添加--ignore-dependencies参数
  若无需生成依赖库的文档，可在生成文档时添加该参数，rustdoc只会处理你的代码文档，不会包含slog等依赖的宏展开内容：

  cargo doc --document-private-items --ignore-dependencies
  

• 升级slog版本
  部分旧版本slog的宏可能存在文档生成逻辑缺陷，尝试升级至最新稳定版，看是否已修复宏展开导致的冗余问题。

内容的提问来源于stack exchange，提问作者Samuel Hapak