Document traits from #[derive(...)]

[dns2utf8]

While documenting every public function of ThreadPool I had to implement #[derive(Clone) manually so I would be able to add an example.

I assume cargo doc has a default template for the derive-able traits.
So I propose something like this:

#[derive(Clone)
/// My custom doc
/// ```
/// let my = custom.example();
/// ```
#[derive(PartialEq, Eq)
/// My custom doc for both traits
/// ```
/// let my = custom.example();
/// ```
struct CustomStruct;

The template would have to include something like "yield" within the code it is generating.
In this case it should generate something equal to:

impl Clone for CustomStruct {
    /// My custom doc
    /// ```
    /// let my = custom.example();
    /// ```
    fn clone(&self) -> Self { CustomStruct }
}
/* similar for the other two traits */
struct CustomStruct;

What do you think?

[alexcrichton]

Thanks for the report! I think though this may be best located on the rust-lang/rust repo perhaps instead of Cargo?

[carols10cents]

Yep, this sounds like a job for rustdoc since cargo doc mostly just calls rustdoc. @dns2utf8 I've taken the liberty of moving this issue over to rust-lang/rust#44118 for you!

[dns2utf8]

Thank you 👍