doc.servo.org - Unable to access core_foundation, core_graphics and core_text

[TitiAlone]

These functions seems to be undefined in the doc.servo.org repo.

See here (core_foundation).
Same result for core_graphics and core_text.

[SimonSapin]

This is most likely because we’re generating the docs on Linux, and we are conditionally building these crates based on the platform. We should look into disabling these conditions for rustdoc.

[edunham]

Hey @steveklabnik, what would you recommend as the best practices for this situation?

It would be straightforward enough to build the docs on all platforms, then have either linux/function/stuffor function/linux/stuff directories.

It would be less straightforward unless someone has built it already to merge platform-specific sections into a single page for each function's docs.

Or is there some "build all the things" switch we can flip in rustdoc?

[steveklabnik]

There basically are none.

@onur might be able to share what they do with docs.rs, but that's the only person I know of who's doing this kind of thing.

New Rustdoc seeks to make this the default, but that's not coming for a while.

[edunham]

Also from our chat in #rust-docs, one example of this being done is https://doc.rust-lang.org/libc

[onur]

Docs.rs is basically doing cargo doc --target={ARCH}. You need to install required rust-std component for the target architecture and if your library have a system dependency (openssl for example) you need to build this library for all target architectures.