Clean up "README.md" file of enumcapsulate-macros crate

Author: regexident

macros/README.md

@@ -79,10 +79,6 @@ enum Enum { /* ... */ }
 > }
 > ```
 
-### `#[derive(AsVariant)]`
-
-The `AsVariant` derive macro requires the variant's field type to implement `Clone`.
-
 ## Macro helper attributes
 
 Most of the derive macros support helper attributes:
@@ -91,7 +87,7 @@ Most of the derive macros support helper attributes:
 
 #### `#[enumcapsulate(exclude(…))]`
 
-Exclude this variant from trait derivation.
+Selectively opt out of `enumcapsulate` trait derivations.
 
 - `#[enumcapsulate(exclude(…))]`
 
@@ -127,6 +123,24 @@ Exclude this variant from trait derivation.
 
     Exclude variant from specific `enumcapsulate` derive macros.
 
+> [!IMPORTANT]
+> This attribute is recognized by the following variant-based derive macros:
+>
+> - `AsVariant`
+> - `AsVariantMut`
+> - `AsVariantRef`
+> - `FromVariant`
+> - `IntoVariant`
+> - `From`
+> - `TryInto`
+>
+> … as well as the umbrella derive macro:
+>
+> - `Encapsulate`
+
+If you wish to opt out of a select few of `Encapsulate`'s trait derives,
+then you can do so by use of an `#[enumcapsulate(exclude(…))]` attribute:
+
 ```rust
 #[derive(Encapsulate)]
 enum Enum {
@@ -143,20 +157,6 @@ enum Enum {
 }
 ```
 
-This attribute is recognized by the following variant-based derive macros:
-
-- `AsVariant`
-- `AsVariantMut`
-- `AsVariantRef`
-- `FromVariant`
-- `IntoVariant`
-- `From`
-- `TryInto`
-
-… as well as the umbrella derive macro:
-
-- `Encapsulate`
-
 #### `#[enumcapsulate(field(… = …)]`
 
 Select a specific variant field as target for trait derivation.
@@ -169,6 +169,21 @@ Select a specific variant field as target for trait derivation.
 
     Select field with name `<name>` to be used as target.
 
+> [!IMPORTANT]
+> This attribute is recognized by the following variant-based derive macros:
+>
+> - `AsVariant`
+> - `AsVariantMut`
+> - `AsVariantRef`
+> - `FromVariant`
+> - `IntoVariant`
+> - `From`
+> - `TryInto`
+>
+> … as well as the umbrella derive macro:
+>
+> - `Encapsulate`
+
 ```rust
 #[derive(Encapsulate)]
 enum Enum {
@@ -188,19 +203,47 @@ enum Enum {
 >
 > Alternatively the variant can be excluded via `#[enumcapsulate(exclude)]`.
 
-This attribute is recognized by the following variant-based derive macros:
+##### `#[enumcapsulate(discriminant(value = …))]`
+
+Specify a memory representation for the generated discriminant type.
+
+> [!IMPORTANT]
+> This attribute is only recognized by the `VariantDiscriminant` derive macro.
+
+If you wish to specify a custom memory representation for the discriminant
+type generated by the `VariantDiscriminant` derive macro, then you can
+do so by use of an `#[enumcapsulate(discriminant(value = <expr>))]` attribute:
 
-- `AsVariant`
-- `AsVariantMut`
-- `AsVariantRef`
-- `FromVariant`
-- `IntoVariant`
-- `From`
-- `TryInto`
+```rust
+#[derive(VariantDiscriminant)]
+enum Enum {
+    #[enumcapsulate(discriminant(value = 42))]
+    VariantA(i32),
+    
+    VariantB { b: u32 },
+}
+```
 
-… as well as the umbrella derive macro:
+##### `#[enumcapsulate(discriminant(name = …))]`
 
-- `Encapsulate`
+Specify a custom name for the generated discriminant type.
+
+> [!IMPORTANT]
+> This attribute is only recognized by the `VariantDiscriminant` derive macro.
+
+If you wish to specify a custom name for the discriminant type
+generated by the `VariantDiscriminant` derive macro, then you can do
+so by use of an `#[enumcapsulate(discriminant(name = …))]` attribute:
+
+```rust
+#[derive(VariantDiscriminant)]
+enum Enum {
+    #[enumcapsulate(discriminant(name = CustomDiscriminant))]
+    VariantA(i32),
+    
+    VariantB { b: u32 },
+}
+```
 
 ## Generics