New option "--extra-display" (#3, #4).

docs/NEWS.md

@@ -1,5 +1,6 @@
 ### UNRELEASED
 
+ * *feature:* new **--extra-display** option to update window and process titles ([#3](https://codeberg.org/a-j-wood/pv/issues/3), [#4](https://codeberg.org/a-j-wood/pv/issues/4))
  * *fix:* correct failure to report file positions in **--watchfd** ([#118](https://codeberg.org/a-j-wood/pv/issues/118))
  * *i18n:* Russian translations added
  * *cleanup:* tests added for **--watchfd** ([#10](https://codeberg.org/a-j-wood/pv/issues/10))

docs/pv.1

@@ -10,6 +10,7 @@ pv \- monitor the progress of data through a pipe
 .OP \-pteIrab8kTv
 .OP \-A NUM
 .OP \-F FORMAT
+.OP \-x SPEC
 .OP \-Wgl0fc
 .OP \-D SEC
 .OP \-s SIZE
@@ -303,6 +304,19 @@ to determine the output format.  See the
 .B FORMATTING
 section below.
 .TP
+.BI \-x\  SPEC \fR,\ \fB\-\-extra\-display\  SPEC
+As well as displaying progress to the terminal, also write it to \fISPEC\fR.
+The \fISPEC\fR must start with a comma-separated list of destinations, and
+can optionally be followed by a colon and a format string.
+The destinations can be \fBwindowtitle\fR or \fBwindow\fR for the xterm
+window title, and \fBprocesstitle\fR, \fBproctitle\fR, \fBprocess\fR, or
+\fBproc\fR for the process title displayed by \fBps\fR(1).
+If a format string is not supplied, the same format is used as for the
+terminal.
+For example, \*(lq\fB\-x\~'window,process:%t\~%b\~%r'\fR\*(rq will show the
+elapsed time, bytes transferred, and rate, in both the window title and the
+process title.
+.TP
 .B \-v, \-\-stats
 At the end of the transfer, write an additional line showing the transfer
 rate minimum, maximum, mean, and standard deviation.  The values are always

docs/pv.1.md

@@ -7,10 +7,11 @@ pv - monitor the progress of data through a pipe
 **pv** \[*OPTION*\]\... \[*FILE*\]\...
 
 **pv** \[ **-pteIrab8kTv** \] \[ **-A** NUM \] \[ **-F** FORMAT \] \[
-**-Wgl0fc** \] \[ **-D** SEC \] \[ **-s** SIZE \] \[ **-i** SEC \] \[
-**-m** SEC \] \[ **-w** WIDTH \] \[ **-H** HEIGHT \] \[ **-N** NAME \]
-[ **-o** FILE \] \[ **-L** RATE \] \[ **-B** BYTES \] \[ **-CESYKX** \]
-[ **-Z** BYTES \] \[ **-U** FILE \] \[ **-P** FILE \] \[*FILE* . . .\]
+**-x** SPEC \] \[ **-Wgl0fc** \] \[ **-D** SEC \] \[ **-s** SIZE \] \[
+**-i** SEC \] \[ **-m** SEC \] \[ **-w** WIDTH \] \[ **-H** HEIGHT \] \[
+**-N** NAME \] \[ **-o** FILE \] \[ **-L** RATE \] \[ **-B** BYTES \] \[
+**-CESYKX** \] \[ **-Z** BYTES \] \[ **-U** FILE \] \[ **-P** FILE \]
+[*FILE* . . .\]
 
 **pv** **-n** \[ **-trbv** \] \[ **-Wl0** \] \[ **-D** SEC \] \[ **-s**
 SIZE \] \[ **-i** SEC \] \[ **-o** FILE \] \[ **-L** RATE \] \[ **-B**
@@ -177,6 +178,20 @@ display types that are explicitly switched on will be shown.
     **-T**, and **-A**, and instead use the format string *FORMAT* to
     determine the output format. See the **FORMATTING** section below.
 
+**-x SPEC, \--extra-display SPEC**
+
+:   As well as displaying progress to the terminal, also write it to
+    *SPEC*. The *SPEC* must start with a comma-separated list of
+    destinations, and can optionally be followed by a colon and a format
+    string. The destinations can be **windowtitle** or **window** for
+    the xterm window title, and **processtitle**, **proctitle**,
+    **process**, or **proc** for the process title displayed by
+    **ps**(1). If a format string is not supplied, the same format is
+    used as for the terminal. For example,
+    "**-x \'window,process:%t %b %r\'**" will show the elapsed time,
+    bytes transferred, and rate, in both the window title and the
+    process title.
+
 **-v, \--stats**
 
 :   At the end of the transfer, write an additional line showing the