diff options
Diffstat (limited to 'pw.1')
| -rw-r--r-- | pw.1 | 35 |
1 files changed, 26 insertions, 9 deletions
@@ -578,13 +578,27 @@ direction. .SH COLON COMMANDS -First, some general remarks. Display refresh doesn't pause during the editing -of a colon command. If that is required, the suspend command must be used. -The space between the command and the argument may be omitted. After a command -is executed, a result message appears in its place. This message persists over -the poll interval period. The longer the poll interval -.RB ( -i " option), -the longer the result message persists. +First, some general remarks. + +The capture of snaphots, driving display refresh, doesn't pause during the +editing of a colon command. If that is desired, the suspend command must +be used first. + +The name of a colon command consists of lower-case letters. Currently, no +command has a name more than one letter long. The command may be followed +by an argument, which is separated from the command by exactly one space. +If the argument does not begin with a lower-case letter, then the space +may be omitted. If the command is followed by no characters at all, or +exactly one space, then its argument is effectively the empty string; +by convention, this is understood as there being no argument. + +When a command is executed, a message appears in its place, diagnosing +an error situation or confirming a successful result. When such a message +appears, it persists until a command is issued. If the command is Enter, +it has only the effect of dismissing the message and restoring the usual +status line, and not the usual effect of resuming +.I pw +out of suspended capture mode. Colon commands are saved in a history which may be navigated for recall using the up and down arrow keys or @@ -592,6 +606,8 @@ recall using the up and down arrow keys or and .BR Ctrl-N . +The commands are: + .IP "\fB:w\fP \fIfilename\fP" Write the currently displayed lines into the specified file. @@ -636,8 +652,9 @@ is disabled and the .B GREP status line disappears. If the optional .B ! -modifier is included in the command, then it pops the entire stack, -forgetting all the patterns and disabling grep mode. +modifier is added to the command, then it pops the entire stack, +forgetting all the patterns and disabling grep mode. The modifier +is not an argument and may not be separated from the command. .IP "\fB:i\fP \fIreal\fP" Set the poll interval to the number of seconds specified by |