Lowering doc-comments
This phase of processing converts an input sequence of fine-grained tokens to a new sequence of fine-grained tokens.
The new sequence is the same as the input sequence,
except that each Line_comment or Block_comment token whose style is inner doc or outer doc is replaced with the following sequence:
Punctuationwith mark #WhitespacePunctuationwith mark ! (omitted if the comment token's style is outer doc)Punctuationwith mark [Identwith represented ident docPunctuationwith mark =WhitespaceRaw_string_literalwith the comment token's body as the represented string and empty suffixPunctuationwith mark ]
Note: the whitespace tokens aren't observable by anything currently described in this writeup, but they explain the
spacingin the tokens that proc-macros see.