如何生成适用于所有平台的 Cargo 文档？

Question

cargo 命令行工具使我能够为我的 crate 生成文档，但是我有以下结构:

#[cfg(target-platform("windows")]
mod winstuff {
     /// Explanation of Windows-specific tasks
}

#[cfg(target-platfrom("linux")]
mod linstuff {
    /// Explanation of Linux-specific tasks
}

当我运行cargo docs --no-deps命令时，只会生成对应平台的模块文档。如何能够为所有平台生成文档呢？

- Valarauca

---

我认为这个问题没有简单的解决方案；正式的 Rust 文档甚至没有记录 std::os::windows 模块，因为正是由于这个问题。GitHub 上的讨论暗示 docs.rs 有一个解决方案，但我找不到详细信息。 - Aurora0001

每个箱的文档在docs.rs的右上角有一个平台选择器。请注意，此处的“crate”指的是软件包或库。 - bluss

doc.rs正在使用构建脚本为每个平台手动生成文档。根据cargo问题跟踪器的说法，目前还没有解决方案。 - Valarauca

Answer 1

这是一个已知的错误，目前尚无解决方法。

- Valarauca