Remove the never type documentation #945

Activity

1. ehuss commented on Jan 25, 2021

   

   ehuss

   on Jan 25, 2021

   Contributor

   More actions

   FWIW, there was a renewed effort at rust-lang/rust#79470 to attempt to stabilize it.

   I don't think it should be removed, because it is stable as a function return type.
2. Havvy commented on Jan 25, 2021

   

   Havvy

   on Jan 25, 2021

   ContributorAuthor

   More actions

   Its usage there is not as a type, but as a stand-in for not return a type.

   I wonder how long it'll be until it can be actually stabilized.
3. crlf0710 commented on Mar 13, 2021

   

   crlf0710

   on Mar 13, 2021

   Member

   More actions

   Maybe, instead of removing, we can mark them as nightly-only and strip or gray them out when building the reference for stable Rust. For the people doing their daily work on nightly Rust, maybe it's worth giving them a version of reference for the broader language.
4. Havvy commented on Mar 13, 2021

   

   Havvy

   on Mar 13, 2021

   ContributorAuthor

   More actions

   That's supposed to be the purview of The Unstable Book. Otherwise, trying to document things that are going to change is a lot of churn and we don't have the manpower for that.
5. ehuss commented on Sep 30, 2025

   

   ehuss

   on Sep 30, 2025

   Contributor

   More actions

   I'm going to close as we have reworked the never type chapter a little bit to focus about it being only as a return type, and its coercion behavior. If and when never is stabilized, we'll be able to rework it as appropriate.

   https://doc.rust-lang.org/1.90.0/reference/types/never.html
6. ehuss

   closed this as completedon Sep 30, 2025