summaryrefslogtreecommitdiff
path: root/docs/features/multiline_commands.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/features/multiline_commands.rst')
-rw-r--r--docs/features/multiline_commands.rst12
1 files changed, 12 insertions, 0 deletions
diff --git a/docs/features/multiline_commands.rst b/docs/features/multiline_commands.rst
new file mode 100644
index 00000000..d6502058
--- /dev/null
+++ b/docs/features/multiline_commands.rst
@@ -0,0 +1,12 @@
+Multiline Commands
+==================
+
+Command input may span multiple lines for the commands whose names are listed
+in the ``multiline_commands`` argument to ``cmd2.Cmd.__init__()``. These
+commands will be executed only after the user has entered a *terminator*. By
+default, the command terminator is ``;``; specifying the ``terminators``
+optional argument to ``cmd2.Cmd.__init__()`` allows different terminators. A
+blank line is *always* considered a command terminator (cannot be overridden).
+
+In multiline commands, output redirection characters like ``>`` and ``|`` are
+part of the command arguments unless they appear after the terminator.