Comment inclure la documentation pour les cas de correspondance uniques dans les macros?

Question

Il est possible d'écrire une documentation pour les cas de correspondance individuels d'une macro exportée.

/// This macro does stuff // this works 
#[macro_export] 
macro_rules! macro{ 
    /// Today it's time for cats // error: no rules expected the token `[` 
    (cat) => { ... }; 
    /// Today it's time for dogs // error: no rules expected the token `[` 
    (dog) => { ... }; 
    /// Why not both // error: no rules expected the token `[` 
    (cats and dogs) => { ... }; 
} 

Est-ce quelque chose comme ceci possible ou dois-je faire comme ceci:

/// This macro does stuff 
/// `(cat)` - Today it's time for cats 
/// `(dog)` - Today it's time for dogs 
/// `(cats and dogs)` - Why not both 
#[macro_export] 
macro_rules! macro{ 
    (cat) => { ... }; 
    (dog) => { ... }; 
    (cats and dogs) => { ... }; 
} 

Answer 1

Vous ne pouvez pas. Le seul endroit où vous pouvez joindre une documentation à une macro est la macro dans son ensemble.