“货单”与“货物锈蚀”的区别

Question

根据doc.rust-lang.org

• cargo rustdoc

使用指定的自定义标志构建包的文档

• cargo doc

构建包的文档

这两者有什么区别呢？据我所知，cargo rustdoc就像cargo doc一样，但是它允许更多的lints--例如：

#![deny(rustdoc::broken_intra_doc_links)]

这是正确的吗？奇怪的是，在某些情况下，cargo rustdoc也会失败，而cargo doc不这样做。

some/folder on some-branch [$!] via  v1.60.0-nightly
❯ cargo doc
    Finished dev [unoptimized + debuginfo] target(s) in 0.53s

some/folder on some-branch [$!] via  v1.60.0-nightly
❯ cargo rustdoc
error: manifest path `some/folder/Cargo.toml` is a virtual manifest, but this command requires running against an actual package in this workspace

而且，cargo doc不支持添加-D选项，而cargo rustdoc则支持。

❯ cargo doc -- -D rustdoc::broken_intra_doc_links
error: Found argument '-D' which wasn't expected, or isn't valid in this context

USAGE:
    cargo doc [OPTIONS]

For more information try --help

Answer 1

它们的关系类似于cargo build和cargo rustc之间的关系：cargo doc对整个工作区执行所有通常的工作，包括依赖关系(默认情况下)。cargo rustdoc允许您将标志直接传递给rustdoc，并且只适用于单个机箱。

这里是cargo rustdoc的执行代码。这里是cargo doc的代码。唯一的区别是，cargo rustdoc总是指定不检查依赖项，而cargo doc允许您选择(默认情况下是这样，但可以指定标志--no-deps)，而cargo rustc允许在--之后将标志直接传递给rustdoc。