主要观点: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 相关信息。
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。