fix issue with about text for subcommands

Author: cbeck88

conf_derive/src/subcommand_proc_macro_options/variant_item.rs

@@ -324,6 +324,11 @@ impl VariantItem {
         let command_name = &self.command_name;
         let aliases = &self.aliases;
 
+        // Generate .about() call if we have a doc string
+        let about_call = self.doc_string.as_ref().map(|doc| {
+            quote! { .about(#doc) }
+        });
+
         if let Some(ty) = self.variant_type.as_ref() {
             // Single unnamed field variant
             let inner_type = self.is_optional_type.as_ref().unwrap_or(ty);
@@ -334,6 +339,7 @@ impl VariantItem {
                   #parsers_ident.push(
                     <#inner_type as ::conf::Conf>::get_parser(#parsed_env_ident, program_options)?
                       .rename(#command_name)
+                      #about_call
                       #(.add_alias(#aliases))*
                   );
                 }
@@ -347,6 +353,7 @@ impl VariantItem {
                     #parsers_ident.push(
                         <#struct_name as ::conf::Conf>::get_parser(#parsed_env_ident, program_options)?
                             .rename(#command_name)
+                            #about_call
                             #(.add_alias(#aliases))*
                     );
                 }
@@ -357,6 +364,7 @@ impl VariantItem {
               #parsers_ident.push(
                 ::conf::Parser::new(::conf::ParserConfig::default(), vec![], &[], #parsed_env_ident)?
                   .rename(#command_name)
+                  #about_call
                   #(.add_alias(#aliases))*
               );
             })

src/parser.rs

@@ -231,7 +231,11 @@ impl Parser {
             command = command.after_help(after_help_text);
         }
 
-        command.build();
+        // Note: We intentionally do NOT call command.build() here.
+        // build() configures help args based on whether long_about is set.
+        // For subcommand parsers, .about() is called AFTER Parser::new() returns,
+        // so we must defer build() until all configuration is complete.
+        // clap will call build() automatically during try_get_matches_from().
 
         Ok(Self {
             options,
@@ -258,6 +262,17 @@ impl Parser {
         self
     }
 
+    /// Set the about text for a parser. (This is used by subcommands)
+    ///
+    /// The first line becomes the short `about` (shown in command listings),
+    /// and the full text becomes `long_about` (shown in subcommand --help).
+    pub fn about(mut self, about: impl Into<String>) -> Self {
+        let full_text = about.into();
+        let first_line = full_text.lines().next().unwrap_or("").to_string();
+        self.command = self.command.about(first_line).long_about(full_text);
+        self
+    }
+
     /// Get command associated to this parser
     pub fn get_command(&self) -> &Command {
         &self.command