Show display params with Ctrl-G; restore with -p option.

1 files changed, 33 insertions, 0 deletions

diff --git a/pw.1 b/pw.1
index e043e0b..c751945 100644
--- a/pw.1
+++ b/pw.1
@@ -238,6 +238,16 @@ and
 characters which indicate line truncation and pane separation are
 shown in inverse video (dark foreground, light background).
 
+.IP \fBCtrl-G\fP
+Shows the status of the display parameters, in a form which can be
+given to the
+.B -p
+option as an argument in order to re-create the same configuration.
+The parameters are four non-negative integers, all in character units.
+The documentation for the
+.B -p
+option explains the numbers.
+
 .IP \fISpace\fP
 Suspend the acquisition of new snapshots.  In suspended mode,
 input continues to pass through the FIFO, but new snapshots of data aren't
@@ -744,6 +754,29 @@ option. If neither option is used, then
 .I pattern
 is interpreted as a BRE.
 
+.IP "\fB-p\fP [\fIinteger\fP[,\fIinteger\fP[,\fIinteger\fP[,\fIinteger\fP]]]]
+Specify the display parameters, as comma-separated non-negative integers.
+The meaning of these integer values is:
+.RS
+.IP 1.
+horizontal scroll position;
+.IP 2.
+width of left pane;
+.IP 3.
+width of middle pane; and
+.IP 4.
+middle pane view offset.
+.PP
+All four numbers are optional, and default to zero if omitted. Since
+.B -p
+requires an argument, the only way all four may be omitted is if a blank
+or empty argument is given.
+The
+.B Ctrl-G
+command displays these same parameters in the same format, so it is possible to
+set them up interactively and then copy the values shown by
+.BR Ctrl-G .
+
 .SH ENVIRONMENT
 
 .I pw