Stream: rustdoc

Topic: Deprecating doc(include)


view this post on Zulip Joshua Nelson (Dec 16 2020 at 00:40):

Per https://github.com/rust-lang/rust/issues/78835#issuecomment-742531894, I plan to deprecate doc(include) in the next beta release (and switch the standard library to doc = include_str! at the same time). To that end, I'm labeling all the doc(include) issues so I can close them when the feature eventually gets removed.

@GuillaumeGomez I'll make sure it goes through FCP at the time, but does all that sounds reasonable?

view this post on Zulip GuillaumeGomez (Dec 16 2020 at 10:06):

I think that doc(include) did a bit more, so let's be sure doc = include_str! does the same first (unless you already did?). But then, sure!

view this post on Zulip Mario Carneiro (Dec 16 2020 at 10:10):

Does this mean that we won't have to do doc = concat! indirectly in macros anymore? Because that would be great

view this post on Zulip Joshua Nelson (Dec 16 2020 at 13:12):

Mario Carneiro said:

Does this mean that we won't have to do doc = concat! indirectly in macros anymore? Because that would be great

correct

view this post on Zulip Joshua Nelson (Dec 16 2020 at 13:13):

https://rust-lang.zulipchat.com/#narrow/stream/122651-general/topic/docs.20based.20on.20macro.20input/near/220051691


Last updated: Oct 11 2021 at 22:34 UTC