macros - 如果宏是在模块中定义的，我该如何正确编写宏文档？

Question

我在模块中定义了一个宏，它工作正常。现在，我试图用一个例子来记录所说的宏。 Apparently ，我需要手动指定 crate 行来请求宏:

/// ```
/// # #[macro_use] extern crate foo;
/// // Some code
/// ```

但是，我现在收到一条错误消息:

error: an `extern crate` loading macros must be at the crate root

显然，示例代码已加载到宏模块中，并且似乎与 macro_use 不兼容...

我不敢相信每个人都直接在根模块中编写宏...对吧？

Answer 1

好吧，添加一个主函数就可以了。我的示例代码不需要运行任何东西(只需编译)，所以我什至没有费心去添加一个 main 函数，但显然添加它会将代码放在一个虚拟的“crate root”中，并且它接受 macro_use.耶!

所以我所做的只是添加:

/// # fn main() { }