Updated comments and documentation.

Author: kmvanbrunt

cmd2/cmd2.py

@@ -332,8 +332,7 @@ class Cmd:
     DEFAULT_EDITOR: ClassVar[str | None] = utils.find_editor()
     DEFAULT_PROMPT: ClassVar[str] = "(Cmd) "
 
-    # Default category used for documented commands (those with a docstring,
-    # help function, or argparse decorator) defined in this class that have
+    # Default category for commands defined in this class which have
     # not been explicitly categorized with the @with_category decorator.
     # This value is inherited by subclasses but they can set their own
     # DEFAULT_CATEGORY to place their commands into a custom category.
@@ -4292,13 +4291,13 @@ def do_help(self, args: argparse.Namespace) -> None:
                 self.poutput(Text(self.doc_leader, style=Cmd2Style.HELP_LEADER))
             self.poutput()
 
-            # Print any categories first and then the remaining documented commands.
-            sorted_categories = sorted(cmds_cats.keys(), key=utils.DEFAULT_STR_SORT_KEY)
-            all_cmds = {category: cmds_cats[category] for category in sorted_categories}
-
             # Used to provide verbose table separation for better readability.
             previous_table_printed = False
 
+            # Print commands grouped by category
+            sorted_categories = sorted(cmds_cats.keys(), key=utils.DEFAULT_STR_SORT_KEY)
+            all_cmds = {category: cmds_cats[category] for category in sorted_categories}
+
             for category, commands in all_cmds.items():
                 if previous_table_printed:
                     self.poutput()
@@ -4309,6 +4308,7 @@ def do_help(self, args: argparse.Namespace) -> None:
             if previous_table_printed and help_topics:
                 self.poutput()
 
+            # Print help topics table
             self.print_topics(self.MISC_HEADER, help_topics, 15, 80)
 
         else:

cmd2/command_set.py

@@ -27,8 +27,7 @@ class CommandSet:
     ``do_``, ``help_``, and ``complete_`` functions differ only in that self is the CommandSet instead of the cmd2 app
     """
 
-    # Default category used for documented commands (those with a docstring,
-    # help function, or argparse decorator) defined in this CommandSet that have
+    # Default category for commands defined in this CommandSet which have
     # not been explicitly categorized with the @with_category decorator.
     # This value is inherited by subclasses but they can set their own
     # DEFAULT_CATEGORY to place their commands into a custom category.

docs/features/initialization.md

@@ -20,7 +20,7 @@ Certain things must be initialized within the `__init__()` method of your class
 
 The `cmd2.Cmd` class provides several class-level variables that can be overridden in subclasses to change default behavior across all instances of that class.
 
-- **DEFAULT_CATEGORY**: The default help category for documented commands defined in the class that haven't been explicitly categorized. (Default: `"Cmd2 Commands"`)
+- **DEFAULT_CATEGORY**: The default help category for commands defined in the class which haven't been explicitly categorized. (Default: `"Cmd2 Commands"`)
 - **DEFAULT_EDITOR**: The default editor program used by the `edit` command.
 - **DEFAULT_PROMPT**: The default prompt string. (Default: `"(Cmd) "`)
 - **MISC_HEADER**: Header for the help section listing miscellaneous help topics. (Default: `"Miscellaneous Help Topics"`)