使用 rustdoc 生成降价文档?

cas*_*cas 9 rustdoc

有没有办法从///评论中在 doc/ 中生成单个降价文件?

多个降价文件(doc/main.mddoc/foo.md等)也很好。

我是 Rust 的新手,虽然生成的 HTML 文档很好,但我主要使用命令行,真的不想为了阅读文档而在我的终端和 Web 浏览器之间切换。这打破了流程并使我离开了区域。此外,md 很容易转换为手册页,或转换为 TeX 以用于打印或 PDF 文档。

(我已经习惯了中止与按Ctrl-Z的vim或者使用其他终端选项卡,并运行manperldocpydoc等文本模式浏览器,如lynx,也不links是我不擅长的选项-导航显得笨拙,输出是对我的200多列丑如果我忘记使用该-width选项,则终端窗口不支持 javascript)

bk1*_*138 2

货物自述文件可能适合你。您运行后cargo readme -i foo.rs > FOO.md,它会使用 foo.rs 中的文档注释内容填充 FOO.md。通过 reddit找到的。