Bug in the online API docs


#1

Hi,
some parts of the online docs about the Rust APIs are not accesible and they show the classic 404 Error .

For example when doing a search

https://doc.rust-lang.org/std/?search=sse

the sections that are inside the libc:: namespace can’t be accessed via web ( still haven’t cecked the offline version and/or all the other namespaces )

As an example the following link is well formed and suggested by the search engine but it doesn’t work ( Err 404 ) even when trying to access the page directly via said link

https://doc.rust-lang.org/libc/fn.FD_ISSET.html

Is this considered a bug ? Can you reproduce it ?


#2

I guess that’s because libc is not part of std?


#3

Like @troplin said, libstd is different from libc. https://crates.io/crates/libc has a documentation link that goes to http://doc.rust-lang.org/libc where you then need to specify a platform. That will lead you to something like http://doc.rust-lang.org/libc/x86_64-unknown-linux-gnu/libc/fn.FD_ISSET.html .


#4

so you are telling me that the search engine is generating links that can’t even be reached ?

What’s the point in having a search engine that is just making links to pages that don’t even exist ?!

There is no reference or note for libc being in a seprate crate, and Mozilla probably should just re-think the functionalities of that search engine .


#5

Ah now I see what you mean.
I think the libc documentation is a bit special, because it is per platform. Generally, rustdoc doesn’t generate dead links though. I think that they’ve somehow modified the rustdoc output.