Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Missing std lib HTML docs #2494

Closed
Thomasdezeeuw opened this issue Sep 18, 2020 · 8 comments · Fixed by rust-lang/rust#76884
Closed

Missing std lib HTML docs #2494

Thomasdezeeuw opened this issue Sep 18, 2020 · 8 comments · Fixed by rust-lang/rust#76884
Labels

Comments

@Thomasdezeeuw
Copy link

Problem

Maybe its a problem with my local setup, but I've been missing the HTML docs (in .rustup/toolchains/nightly-x86_64-apple-darwin/share/doc/rust/html/index.html) since the 2020-09-11 nightly. Running rustup doc gives the following error:

error: couldn't open browser
error: caused by: command 'open' did not execute successfully; exit code: 1
command stderr:
The file /Users/thomas/.rustup/toolchains/nightly-x86_64-apple-darwin/share/doc/rust/html/index.html does not exist.

Steps

  1. Update to a recent nightly, I'm using rustc 1.48.0-nightly (f3c923a13 2020-09-17).
  2. Run rustup doc.

Notes

Output of rustup --version: rustup 1.22.1 (b01adbbc3 2020-07-08).
Output of rustup show:

Default host: x86_64-apple-darwin
rustup home:  /Users/thomas/.rustup

installed toolchains
--------------------

stable-x86_64-apple-darwin
nightly-2020-09-11-x86_64-apple-darwin
nightly-x86_64-apple-darwin

active toolchain
----------------

nightly-x86_64-apple-darwin (default)
rustc 1.48.0-nightly (f3c923a13 2020-09-17)
@kinnison
Copy link
Contributor

If you run rustup +nightly component list --installed is the rust-docs component listed?

@Thomasdezeeuw
Copy link
Author

rustup +nightly component list --installed

cargo-x86_64-apple-darwin
clippy-x86_64-apple-darwin
miri-x86_64-apple-darwin
rls-x86_64-apple-darwin
rust-docs-x86_64-apple-darwin
rust-src
rust-std-x86_64-apple-darwin
rustc-x86_64-apple-darwin
rustfmt-x86_64-apple-darwin

@Thomasdezeeuw
Copy link
Author

I see its missing rust-docs, but when I do rustup component add rust-docs, I get the following:

rustup component add rust-docs
info: component 'rust-docs' for target 'x86_64-apple-darwin' is up to date

@kinnison
Copy link
Contributor

The rust-docs component is arch specific, which is why it's listed as rust-docs-x86_64-apple-darwin so that's good that it's installed, but worrisome that the location isn't working, hmm

Could you please go into your .rustup/toolchains/nightly-x86_64-apple-darwin/lib/rustlib directory and find the file: manifest-rust-docs-x86_64-apple-darwin and either attach it if it's big, or paste it in a comment if it's small?

Also, once you've done that, try to see if anything listed in that manifest is present on the filesystem. Paths are relative to the toolchain directory (.rustup/toolchains/nightly-...)

@Thomasdezeeuw
Copy link
Author

manifest-rust-docs-x86_64-apple-darwin contains:

dir:share/doc/rust/html

The directory (~/.rustup/toolchains/nightly-x86_64-apple-darwin/share/doc/rust/html) exists with the following files:

Permissions Size User   Date Modified Name
.rw-r--r--  1.4M thomas 18 Sep 10:57  error-index.html
.rw-r--r--   334 thomas 18 Sep 10:57  robots.txt
drwxr-xr-x     - thomas 18 Sep 10:57  rustc

But its missing the std directory which usually contains the docs for the std lib.

@kinnison
Copy link
Contributor

Interesting. @Mark-Simulacrum Do you have any insight as to why this might be happening? I think there've been changes to docs packages recently in master?

@Mark-Simulacrum
Copy link
Member

rust-lang/rust#76884 should fix this for macOS and a few other triples.

bors added a commit to rust-lang-ci/rust that referenced this issue Sep 18, 2020
…oalbini

Add host triples to target lists

This PR is primarily intended to fix rust-lang/rustup#2494, which is the second commit. That bug was introduced by rust-lang#76415, and incompletely fixed by rust-lang#76639. (rust-lang#76639 added host triples, which gave us compilers, but missed that we also need documentation and other target-only things). However, it also removes duplicate macOS CI builders.

r? `@pietroalbini`
@Thomasdezeeuw
Copy link
Author

Docs are available again, thanks @Mark-Simulacrum @kinnison.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants