rust - 如何为私人物品生成文档
问题描述
我有一个项目:
main.rs
module_1/mod.rs
module_2/mod.rs
module_2/module_3/mod.rs
当我运行时cargo doc
,我只有文档main.rs
,而不是模块。
在我的main.rs
我有:
mod module_1;
mod module_2;
fn main() {
...
}
我尝试使用 ///
or记录模块//!
。
我在 's 帮助中找不到rustdoc
如何做到这一点。
有人可以解释一下吗?
解决方案
这是因为这些模块是私有的,并且默认行为是仅记录公共成员。
从Rust 1.29.0 开始,cargo doc
支持--document-private-items
, 来记录私有项目。
在 1.29 之前,rustdoc
已经支持 flag --document-private-items
,这意味着您可以使用 为您的项目生成文档cargo rustdoc -- --document-private-items
,但cargo doc
不支持 flag。
推荐阅读
- cryptocurrency - 加密货币交易交易所从哪里获取实时数据?
- extract - 如何使用 OSMOSIS 提取多面数据
- apache - Apache2 - apache2.conf - AH00526:语法错误允许和拒绝必须后跟“来自”
- csvtoarray - 将 csv 行文件内容转换为 java 对象数组
- ios - Flutter ios构建失败,android工作
- rest - RESTful API 设计:涉及多个资源的操作
- kubernetes - 如何仅将 Flux helmrelease 部署到 1 个环境
- algorithm - 为什么在 Kruskal 算法的运行时间证明中,最大边数小于节点数的平方?
- node.js - 运行单元测试管道时出现 Github 操作错误
- sql - 从数据库表中获取名称以在 select 语句中使用,而不是 databasename