Updated macro documentation

README.md

@@ -31,7 +31,7 @@ Main Features
 - Multi-line commands
 - Special-character command shortcuts (beyond cmd's `?` and `!`)
 - Command aliasing similar to bash `alias` command
-- Macros, which are similar to aliases, but can take arguments when called
+- Macros, which are similar to aliases, but they can contain argument placeholders
 - Ability to load commands at startup from an initialization script
 - Settable environment parameters
 - Parsing commands with arguments using `argparse`, including support for sub-commands

cmd2/cmd2.py

@@ -2431,7 +2431,7 @@ def macro_list(self, args: argparse.Namespace) -> None:
     # Top-level parser for macro
     macro_description = ("Manage macros\n"
                          "\n"
-                         "A macro is similar to an alias, but it can take arguments when called.")
+                         "A macro is similar to an alias, but it can contain argument placeholders.")
     macro_epilog = ("See also:\n"
                     "  alias")
     macro_parser = ACArgumentParser(description=macro_description, epilog=macro_epilog, prog='macro')
@@ -2443,7 +2443,7 @@ def macro_list(self, args: argparse.Namespace) -> None:
     macro_create_help = "create or overwrite a macro"
     macro_create_description = "Create or overwrite a macro"
 
-    macro_create_epilog = ("A macro is similar to an alias, but it can take arguments when called.\n"
+    macro_create_epilog = ("A macro is similar to an alias, but it can contain argument placeholders.\n"
                            "Arguments are expressed when creating a macro using {#} notation where {1}\n"
                            "means the first argument.\n"
                            "\n"

docs/settingchanges.rst

@@ -75,10 +75,8 @@ Macros
 ======
 
 ``cmd2`` provides a feature that is similar to aliases called macros. The major difference between macros and aliases
-is that macros are intended to take arguments when called. These can be useful if you need to run a complex command
-frequently with different arguments that appear in various parts of the command.
-
-Arguments are expressed when creating a macro using {#} notation where {1} means the first argument.
+is that macros can contain argument placeholders. Arguments are expressed when creating a macro using {#} notation
+where {1} means the first argument.
 
 The following creates a macro called my_macro that expects two arguments:
 

setup.py

@@ -28,7 +28,7 @@
     - Multi-line commands
     - Special-character command shortcuts (beyond cmd's `?` and `!`)
     - Command aliasing similar to bash `alias` command
-    - Macros, which are similar to aliases, but can take arguments when called
+    - Macros, which are similar to aliases, but they can contain argument placeholders
     - Ability to load commands at startup from an initialization script
     - Settable environment parameters
     - Parsing commands with arguments using `argparse`, including support for sub-commands