summaryrefslogtreecommitdiff
path: root/docs/features/multiline_commands.rst
blob: d65020581c6baca48d90de341c90e0352ab662fa (plain)
1
2
3
4
5
6
7
8
9
10
11
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.