Join GitHub today
GitHub is home to over 36 million developers working together to host and review code, manage projects, and build software together.Sign up
Tracking issue for rustdoc deprecations/cleanup #44136
In a recent @rust-lang/dev-tools meeting, we chatted about some compatibility issues with
As such, we want to deprecate and then remove some things that we don't believe anyone is using, and provide better support for some things people are doing, but in a hacky way.
Summary of plans, to be checked off as they're done:
More details below.
In addition, when it's closer to ship the new rustdoc, the various HTML and CSS flags will probably be replaced by a real templating system, and so we'll need to introduce some messaging there. That's not part of this ticket, however.
This was referenced
Nov 28, 2017
referenced this issue
May 11, 2018
I occasionally document a Rust binary crate with this:
These days I get a warning about deprecated flags per this issue.
I can use the incantation below instead, but that isn't quite the same: there's a "Re-exports" section tacked on the front page that arguably doesn't make much sense for a binary crate.