首页
学习
活动
专区
圈层
工具
发布
首页
学习
活动
专区
圈层
工具
MCP广场
社区首页 >问答首页 >如何处理“the‘t parse code block as Rust code”rustdoc警告?

如何处理“the‘t parse code block as Rust code”rustdoc警告?
EN

Stack Overflow用户
提问于 2019-04-17 23:28:38
回答 1查看 261关注 0票数 0

我正在写一些rust文档示例(正在编译中):

代码语言:javascript
运行
复制
/// ```rust
/// # #[macro_use]
/// # extern crate ...
/// ...
/// ```

但是cargo doc给了我这个不正确的警告:

代码语言:javascript
运行
复制
warning: could not parse code block as Rust code
   --> srml/support/src/dispatch.rs:105:5
    |
105 |   ///    ```rust
    |  ________^
106 | | /// # #[macro_use]
    | |_
    |
    = note: error from rustc: unknown start of token: `
help: mark blocks that do not contain Rust code as text
    |
105 | ///    ```textrust
    |        ^^^^^^^

我是不是应该取消这个警告..还是这里有什么不对劲?

EN

回答 1

Stack Overflow用户

发布于 2019-04-17 23:41:54

您可以通过在代码块中使用有效的Rust代码来修复错误。

这会重现问题:

代码语言:javascript
运行
复制
///    ```rust
///
///    ```
pub fn foo() {}

不要在代码块前添加虚假的空格。在Markdown中,四个空格被视为代码的开头,因此您实际上完成了与HTML相同的操作:

代码语言:javascript
运行
复制
<code>```rust  ```</code>

正如它告诉您的,```不是有效的Rust代码。

票数 2
EN
页面原文内容由Stack Overflow提供。腾讯云小微IT领域专用引擎提供翻译支持
原文链接:

https://stackoverflow.com/questions/55731174

复制
相关文章

相似问题

领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档