Updated comments.

Author: kmvanbrunt

cmd2/argparse_custom.py

@@ -888,7 +888,8 @@ def attach_subcommand(
         # Use add_parser to register the subcommand name and any aliases
         new_parser = subparsers_action.add_parser(subcommand, **add_parser_kwargs)
 
-        # Ensure the parser and any nested subparsers have the correct 'prog' value.
+        # To ensure accurate usage strings, recursively update 'prog' values
+        # within the injected parser to match its new location in the command hierarchy.
         parser.update_prog(new_parser.prog)
 
         # Replace the parser created by add_parser() with our pre-configured one

cmd2/cmd2.py

@@ -275,7 +275,8 @@ def get(self, command_method: CommandFunc) -> Cmd2ArgumentParser | None:
             parent = self._cmd.find_commandset_for_command(command) or self._cmd
             parser = self._cmd._build_parser(parent, parser_builder)
 
-            # Ensure the parser and any nested subparsers have the correct 'prog' value.
+            # To ensure accurate usage strings, recursively update 'prog' values
+            # within the parser to match the command name.
             parser.update_prog(command)
 
             # If the description has not been set, then use the method docstring if one exists