Repository navigation
rust stages for armv6/7-linux-gnueabi{hf} from static.rust-lang.org do not include rust-docs anymore #52133
Description
This is valid for >=rust-1.26.0, the rust-docs folder has been included before that version. For instance with rust-1.25.0 it was just fine. I know that there is a thing called rustup, but there are various reasons to prefere an install from the stage archives via install.sh
There were a few problems with cross compile and rust-docs in the past, this may be related somehow.
Please include rust-docs in the future, if there is a reason not to do that please communicate it. And also please check other archs for the same error, I can only speak for armv6/7! Thanks!
Activity
Mark-Simulacrum commentedon Jul 7, 2018
We no longer build documentation for these platforms; I believe the expectation is that users will use linux (x86_64-unknown-linux-gnu) documentation instead.
cc @alexcrichton
Auto merge of #52620 - mikhail-m1:51351, r=nikomatsakis
Rollup merge of rust-lang#52878 - mikhail-m1:master, r=kennytm
Rollup merge of rust-lang#52878 - mikhail-m1:master, r=kennytm
Rollup merge of rust-lang#52878 - mikhail-m1:master, r=kennytm
Rollup merge of rust-lang#52878 - mikhail-m1:master, r=kennytm
djc commentedon Aug 4, 2018
This is an issue in https://bugs.gentoo.org/660512.
So where is the policy described? rust-docs is still being published for seemingly obscure target triples like
i386-apple-ios, but not things likearmv6that people actually use, which seems a weird thing to do. Either it's something like one-per-OS or everything-for-tier-2.Mark-Simulacrum commentedon Aug 4, 2018
It might be a bug that we're publishing the ios docs -- cc @kennytm
Generally speaking the policy isn't described anywhere currently (though we should probably fix that).
djc commentedon Aug 21, 2018
So can we please get some clarity on why this got changed/what the policy should look like? I'm happy to help clarify a policy and/or put it in writing, I just don't want to encode stuff now that might turn out to be wrong later because I'm guessing at motivations for this particular change.
emilyalbini commentedon Aug 30, 2018
At the moment only tier 1 platforms gets the
rust-docscomponent packaged with rustup.The change was made in #49187 because building those docs took a long time on our CI system (which was timing out often at the time) and we guessed few people were using those. AFAIK nobody complained (except when the change broke rustup upgrades, but that's another story).
djc commentedon Aug 30, 2018
@pietroalbini thanks, that helps a lot! It would be nice if this was documented anywhere.
Mark-Simulacrum commentedon Jun 4, 2019
I don't think we're really tracking anything in particular here -- we don't have the CI budget today to produce this documentation and there's not much we can do here today. You can mostly work around it today (presuming you have the disk space), by doing something like
rustup toolchain install stable-x86_64-unknown-linux-gnuandrustup doc --toolchain stable-x86_64-unknown-linux-gnuI believe which should be sufficient for most use cases. Perhaps we ideally would default to the linux docs if we don't have the specific platform's docs but that's a rustup request more so than rust-lang/rust, I think.