diff --git a/docs/pv.1 b/docs/pv.1
index 97e5144..4c73e4b 100644
--- a/docs/pv.1
+++ b/docs/pv.1
@@ -1,14 +1,68 @@
 .TH PV 1 "October 2024" Linux "User Manuals"
 .SH NAME
 pv \- monitor the progress of data through a pipe
-.SH SYNOPSIS
-.B pv
-[\fIOPTION\fR]...
-[\fIFILE\fR]...
-.br
-.B pv
-[\fI\-h\fR|\fI\-V\fR]
 
+.SH SYNOPSIS
+.SY pv
+.OP \-pteIrab8kTvnq
+.OP \-A NUM
+.OP \-F FORMAT
+.OP \-Wgl0fc
+.OP \-D SEC
+.OP \-s SIZE
+.OP \-i SEC
+.OP \-m SEC
+.OP \-w WIDTH
+.OP \-H HEIGHT
+.OP \-N NAME
+.OP \-o FILE
+.OP \-L RATE
+.OP \-B BYTES
+.OP \-CESYKX
+.OP \-Z BYTES
+.OP \-U FILE
+.OP \-P FILE
+.RI [ FILE
+\&.\|.\|.\&]
+
+.SY pv
+.B \-R
+.I PID
+.OP \-pteIrabT
+.OP \-A NUM
+.OP \-F FORMAT
+.OP \-s SIZE
+.OP \-i SEC
+.OP \-w WIDTH
+.OP \-H HEIGHT
+.OP \-N NAME
+.OP \-L RATE
+.OP \-B BYTES
+
+.SY pv
+.B \-d
+.I PID:FD
+.OP \-pteIrab8kTvnq
+.OP \-F FORMAT
+.OP \-i SEC
+.OP \-w WIDTH
+.OP \-H HEIGHT
+
+.SY pv
+.B \-d
+.I PID
+.OP \-pteIrab8kTvnq
+.OP \-F FORMAT
+.OP \-i SEC
+.OP \-w WIDTH
+.OP \-H HEIGHT
+
+.SY pv
+.B \-h
+
+.SY pv
+.B \-V
+.YS
 
 .SH DESCRIPTION
 .B pv
diff --git a/docs/pv.1.md b/docs/pv.1.md
index 818a619..0bf222a 100644
--- a/docs/pv.1.md
+++ b/docs/pv.1.md
@@ -4,8 +4,25 @@ pv - monitor the progress of data through a pipe
 
 # SYNOPSIS
 
-**pv** \[*OPTION*\]\... \[*FILE*\]\...\
-**pv** \[*-h*\|*-V*\]
+**pv** \[ **-pteIrab8kTvnq** \] \[ **-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* . . .\]
+
+**pv** **-R** *PID* \[ **-pteIrabT** \] \[ **-A** NUM \] \[ **-F**
+FORMAT \] \[ **-s** SIZE \] \[ **-i** SEC \] \[ **-w** WIDTH \] \[
+**-H** HEIGHT \] \[ **-N** NAME \] \[ **-L** RATE \] \[ **-B** BYTES \]
+
+**pv** **-d** *PID:FD* \[ **-pteIrab8kTvnq** \] \[ **-F** FORMAT \] \[
+**-i** SEC \] \[ **-w** WIDTH \] \[ **-H** HEIGHT \]
+
+**pv** **-d** *PID* \[ **-pteIrab8kTvnq** \] \[ **-F** FORMAT \] \[
+**-i** SEC \] \[ **-w** WIDTH \] \[ **-H** HEIGHT \]
+
+**pv** **-h**
+
+**pv** **-V**
 
 # DESCRIPTION