Documented how to override the build-in command category.

Author: kmvanbrunt

cmd2/cmd2.py

@@ -337,6 +337,8 @@ class Cmd:
     # 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.
+    # Subclasses can also reassign cmd2.Cmd.DEFAULT_CATEGORY to rename
+    # the category used for the framework's built-in commands.
     DEFAULT_CATEGORY: ClassVar[str] = "Cmd2 Commands"
 
     # Header for table listing help topics not related to a command.

docs/features/help.md

@@ -90,7 +90,19 @@ class Plugin(cmd2.CommandSet):
 
 When using inheritance, `cmd2` uses the `DEFAULT_CATEGORY` of the class where the command was
 actually defined. This means built-in commands (like `help`, `history`, and `quit`) stay in the
-`"cmd2 Commands"` category, while your commands move to your custom category.
+`"Cmd2 Commands"` category, while your commands move to your custom category.
+
+If you want to rename the built-in category itself, you can do so by reassigning
+`cmd2.Cmd.DEFAULT_CATEGORY` at the class level within your `Cmd` subclass:
+
+```py
+class MyApp(cmd2.Cmd):
+    # Rename the framework's built-in category
+    cmd2.Cmd.DEFAULT_CATEGORY = 'Shell Commands'
+
+    # Set the category for your own commands
+    DEFAULT_CATEGORY = 'Application Commands'
+```
 
 For a complete demonstration of this functionality, see the
 [default_categories.py](https://github.com/python-cmd2/cmd2/blob/main/examples/default_categories.py)

examples/default_categories.py

@@ -36,6 +36,9 @@ class CategoryApp(cmd2.Cmd):
     # This sets the default category for all commands defined in this class
     DEFAULT_CATEGORY = "Application Commands"
 
+    # This overrides the category for the cmd2 built-in commands
+    cmd2.Cmd.DEFAULT_CATEGORY = "Cmd2 Shell Commands"
+
     def __init__(self) -> None:
         super().__init__()
         # Register a command set to show how its categories integrate