documentation on usize and isize incorrectly claims everything is 64-bit only

[psymar]

Location (URL)

https://doc.rust-lang.org/std/primitive.usize.html
https://doc.rust-lang.org/std/primitive.isize.html

Summary

Every single constant, function etc on the stdlib doc pages for usize and isize says "Available on 64-bit only." As a programmer relatively new to rust (been using rust about a year), there have been a few times this has tripped me up into thinking that code using these types cannot check against these constants on other architectures. The actual problem, as I now see looking at the source, is that it's defined for different pointer sizes but rustdoc only seems to see the last of these.

While this is apparently known issue with rustdoc's doc_auto_cfg feature, it looks like that's not getting fixed anytime soon as there's been no discussion in years; is there any chance the docs could be rewritten to not rely on this feature?

[workingjubilee]

...huh, I remember it not saying that some time ago.

[workingjubilee]

This regression is new in 1.93

before: https://doc.rust-lang.org/1.92.0/std/primitive.usize.html
after: https://doc.rust-lang.org/1.93.0/std/primitive.usize.html

[workingjubilee]

I'm not sure the docs before are ideal either, though.

[workingjubilee]

It's already fixed on nightly by #156426

See https://doc.rust-lang.org/nightly/std/primitive.usize.html

Sorry!