Expand macro parameters in the comments.

[Yamakaky]

macro_rules! test {
  (name:ident) => {
    /// A struct named $name.
    struct $name;
  }
}

[bluss]

@Yamakaky Can you clarify what you mean?

[Yamakaky]

Sorry: I would like for test!(Name) to expand the comment to /// A struct named Name.

[bluss]

I see, thank you, that would be a general Rust feature and not just rustdoc, then.

[leoschwarz]

This might break backward compatibility (if docs are also to be covered by that guarantee) since people might have used $s in their docs already not intending them to be replaced. Also if there is no variable found should it just leave the $word unchanged there or should a warning or error be emitted?

This feature probably requires a RFC. Relevant discussion: rust-lang/rfcs#1516

[Dynisious]

Any new word on this topic? I feel it could be a useful change for a number of cases e.g. a macros which creates functions in my case.

[jhg]

Any news on this? In some cases structs or functions created by a macro only have a generic doc comment when could give more details.