Rust: मैक्रो विस्तार के लिए टिप्पणियाँ

macro_rules! foo_macro {
    ($name:ident) => {
        pub struct $name;
    }
}

/// Doc comment for Foo struct.
foo_macro!(Foo);

/// Doc comment for Bar struct.
foo_macro!(Bar);

इस मामूली कोड नमूने में उपयोगकर्ता मैक्रो विस्तार के माध्यम से एक संरचना बनाना चाहता है और प्रत्येक अलग मैक्रो आमंत्रण के लिए एक अनूठी टिप्पणी लिखना चाहता है।
इसका मतलब है कि स्ट्रक्चर फू और बार के लिए एक अनूठी टिप्पणी जो वर्तमान में जंग संकलक में संभव नहीं है जब सक्षम किया जाता है:

#![warn(missing_docs)]

निम्नलिखित चेतावनियों के साथ:

warning: missing documentation for a struct
  --> src/activation_fn.rs:9:3
   |
9  |        pub struct $name;
   |        ^^^^^^^^^^^^^^^^^
...
14 | foo_macro!(Foo);
   | ---------------- in this macro invocation
   |
note: lint level defined here
  --> src/lib.rs:1:9
   |
1  | #![warn(missing_docs)]
   |         ^^^^^^^^^^^^

warning: missing documentation for a struct
  --> src/activation_fn.rs:9:3
   |
9  |        pub struct $name;
   |        ^^^^^^^^^^^^^^^^^
...
17 | foo_macro!(Bar);
   | ---------------- in this macro invocation
   |
note: lint level defined here
  --> src/lib.rs:1:9
   |
1  | #![warn(missing_docs)]
   |         ^^^^^^^^^^^^

हालांकि यह स्पष्ट रूप से काम करता है:

macro_rules! foo_macro {
    /// Unified comment for any macro expansion which is bad!
    ($name:ident) => {
        pub struct $name;
    }
}

foo_macro!(Foo);
foo_macro!(Bar);