From 0516ba53bdfd7a77dc372b473d47a3d3ea00a937 Mon Sep 17 00:00:00 2001
From: Andrew Wood <ivarch657@gmail.com>
Date: Tue, 10 Dec 2024 23:08:00 +0000
Subject: [PATCH] Remove the example with "dialog" and add a more usual use
 case with tar.

---
 docs/pv.1    | 12 +++++-------
 docs/pv.1.md | 15 +++++++--------
 2 files changed, 12 insertions(+), 15 deletions(-)

diff --git a/docs/pv.1 b/docs/pv.1
index fa13459..9bb6a29 100644
--- a/docs/pv.1
+++ b/docs/pv.1
@@ -502,15 +502,14 @@ cat file | pv \-\-size 12345 | nc \-w 1 somewhere.com 3000
 .EE
 .in
 .PP
-A more complicated example using numeric output to feed into the
-\fBdialog\fR(1) program for a full-screen progress display:
+To watch the progress of creating a tar.gz archive:
 .PP
 .in +4
 .EX
-(tar cf \- . \e
-| pv \-\-numeric \-\-size $(du \-sb . | awk '{print $1}') \e
-| gzip \-9 > out.tgz) 2>&1 \e
-| dialog \-\-gauge 'Progress' 7 70
+tar cf \- directory/ \e
+| pv \-\-size $(du \-sb directory/ | awk '{print $1}') \e
+| gzip \-9 \e
+> out.tar.gz
 .EE
 .in
 .PP
@@ -689,7 +688,6 @@ Alternatively, use the issue tracker linked from the
 .\"
 .SH "SEE ALSO"
 .BR cat (1),
-.BR dialog (1),
 .BR splice (2),
 .BR fdatasync (2),
 .BR open (2)
diff --git a/docs/pv.1.md b/docs/pv.1.md
index bf662d1..41dc36e 100644
--- a/docs/pv.1.md
+++ b/docs/pv.1.md
@@ -520,13 +520,12 @@ the expected size to **pv**:
 
     cat file | pv --size 12345 | nc -w 1 somewhere.com 3000
 
-A more complicated example using numeric output to feed into the
-**dialog**(1) program for a full-screen progress display:
+To watch the progress of creating a tar.gz archive:
 
-    (tar cf - . \
-    | pv --numeric --size $(du -sb . | awk '{print $1}') \
-    | gzip -9 > out.tgz) 2>&1 \
-    | dialog --gauge 'Progress' 7 70
+    tar cf - directory/ \
+    | pv --size $(du -sb directory/ | awk '{print $1}') \
+    | gzip -9 \
+    > out.tar.gz
 
 Taking an image of a disk, skipping errors:
 
@@ -672,8 +671,8 @@ page](https://www.ivarch.com/programs/pv.shtml).
 
 # SEE ALSO
 
-**cat**(1), **dialog**(1), **splice**(2), **fdatasync**(2), **open**(2)
-(for **O_DIRECT**)
+**cat**(1), **splice**(2), **fdatasync**(2), **open**(2) (for
+**O_DIRECT**)
 
 # COPYRIGHT