Comment intégrer une variable de macro Rust dans la documentation?

Question

Je voudrais utiliser une variable macro dans la documentation générée par macro:

macro_rules! impl_foo { 
    ($name:ident) => { 
     /// Returns a new `$name`. 
     fn myfoo() -> $name { 

     } 
    }; 
} 

Cependant, ne sera pas remplacé par la variable. J'ai aussi essayé d'utiliser l'attribut #[doc]:

macro_rules! impl_foo { 
    ($name:ident) => { 
     #[doc = concat!("Returns a new `", $name, "`.")] 
     fn myfoo() -> $name { 

     } 
    }; 
} 

Celui-ci échoue même à analyser: unexpected token: 'concat'

Answer 1

Pour autant que je sache, le mieux que vous pouvez faire nécessite des répétitions pour l'instant:

macro_rules! impl_foo { 
    ($name:ident, $sname:expr) => { 
     #[doc = "Returns a new `"] 
     #[doc = $sname] 
     #[doc = "`."] 
     fn myfoo() -> $name { 
      42 
     } 
    }; 
} 

impl_foo!(u32, "u32"); 

Ce qui rend comme: