search

rust-lang / rust

Empowering everyone to build reliable and efficient software.
https://www.rust-lang.org
Other
95.38k stars 12.29k forks source link

Tracking Issue for `-Z normalize-docs` #82692

Open jyn514 opened 3 years ago

jyn514 commented 3 years ago

This is a tracking issue for the rustdoc feature -Z normalize-docs. This normalizes projections like <Vec<T> as IntoIterator>::IntoIter to std::vec::IntoIter<T> in the generated documentation.

About tracking issues

Tracking issues are used to record the overall progress of implementation. They are also used as hubs connecting to other relevant issues, e.g., bugs or open design questions. A tracking issue is however not meant for large scale discussion, questions, or bug reports about a feature. Instead, open a dedicated issue for the specific matter and add the relevant feature gate label.

Steps

Unresolved Questions

No unresolved questions known, this is "just hard".

Implementation history

jyn514 commented 1 year ago

@workingjubilee hmm, I'm not sure why you marked this as A-cli? The intention is to remove the flag completely when the blocking issues are fixed, and have this always on.

workingjubilee commented 1 year ago

:shrug:

fmease commented 2 months ago

Apart from marking the impl as https://github.com/rust-lang/rust/labels/S-tracking-impl-incomplete / “incomplete” (buggy), I'm marking it as https://github.com/rust-lang/rust/labels/S-tracking-design-concerns because there have been lots of discussions around the question whether we want to normalize/evaluate constant expressions in rustdoc at all[^1] (“intent” vs. “representation”) and by extension the same concern applies to types. See #102456, #99630, Zulip discussion.

[^1]: Or rather only if the corresponding item was marked with a new attribute.