Updated documentation

Author: kmvanbrunt

cmd2/cmd2.py

@@ -3665,6 +3665,10 @@ def disable_command(self, command: str, message_to_print: str) -> None:
         Disable a command and overwrite its functions
         :param command: the command being disabled
         :param message_to_print: what to print when this command is run or help is called on it while disabled
+
+                                 The variable COMMAND_NAME can be used as a placeholder for the name of the
+                                 command being disabled.
+                                 ex: message_to_print = "{} is currently disabled".format(COMMAND_NAME)
         """
         import functools
 
@@ -3695,6 +3699,10 @@ def disable_category(self, category: str, message_to_print: str) -> None:
         :param category: the category to disable
         :param message_to_print: what to print when anything in this category is run or help is called on it
                                  while disabled
+
+                                 The variable COMMAND_NAME can be used as a placeholder for the name of the
+                                 command being disabled.
+                                 ex: message_to_print = "{} is currently disabled".format(COMMAND_NAME)
         """
         all_commands = self.get_all_commands()
 

examples/help_categories.py

@@ -7,6 +7,7 @@
 import argparse
 
 import cmd2
+from cmd2.cmd2 import COMMAND_NAME
 
 
 class HelpCategories(cmd2.Cmd):
@@ -143,7 +144,9 @@ def do_version(self, _):
     @cmd2.with_category("Command Management")
     def do_disable_commands(self, _):
         """Disable the Application Management commands"""
-        self.disable_category(self.CMD_CAT_APP_MGMT, "Application Management is currently disabled")
+        message_to_print = "{} is not available while {} commands are disabled".format(COMMAND_NAME,
+                                                                                       self.CMD_CAT_APP_MGMT)
+        self.disable_category(self.CMD_CAT_APP_MGMT, message_to_print)
         self.poutput("The Application Management commands have been disabled")
 
     @cmd2.with_category("Command Management")