稳定版上的 Rustdoc 合并 doctests(已解决)问题

主要观点:1.85.1 Rust 版本发布,带来 rustdoc 合并 doctests 功能的修复。
关键信息:

  • rustdoc 用于生成文档,新增合并 doctests 功能可减少运行 doctests 的时间。
  • 合并 doctests 功能曾因多种原因在未被注意的情况下被添加、审查、测试和合并,如 rustdoc 测试套件使用 nightly,是个庞大的 pull 请求等。
  • 修复该问题需满足在 stable 上工作且不允许用户在非 nightly 环境中使用 nightly 功能,解决方案是将 nightly 代码放在一个 crate 中,用户代码放在另一个 crate 中,且“nightly 代码 crate”通过设置RUSTC_BOOTSTRAP=1环境变量使 nightly 检查成功,从而使合并 doctests 能在 stable rustc 下工作。
    重要细节:
  • 示例代码展示了在不同 crate 中的代码结构及处理方式。
  • 修复相关内容可在#137899查看。
  • 文中提到感谢@notriddle和 rustdoc 团队的快速修复和审查。
  • 最后还配有一张作者猫监督的图片及 RSS 相关信息。
阅读 5
0 条评论