#plugin #documentation #external #file

nightly doc_file

将 Rust crate 的文档移入外部文件

4 个版本 (2 个破坏性更新)

使用旧的 Rust 2015

0.2.0 2014 年 12 月 19 日
0.1.0 2014 年 12 月 11 日
0.0.2 2014 年 12 月 9 日
0.0.1 2014 年 12 月 8 日

#69 in #external

MIT 许可证

5KB
87 代码行,不包括注释

doc_file

Build Status

将 Rust crate 的文档移入外部文件。

为什么?

这是一个对 rust-lang/rust#15470 的概念性实现。我希望在树外解决疑问并发现问题,然后将这些贡献回 rustc 本身。

示例用法

#![feature(phase)]

// Paths are relative to the source file.
#![doc_file = "example_crate.markdown"]

#[phase(plugin)] extern crate doc_file;

#[doc_file = "complicated_thing.markdown"]
pub struct ComplicatedThing;

打开问题

语法 #[doc_file = "..."] 稍显丑陋。理想情况下,它应该类似于 #[doc(file = "...")]

无运行时依赖