pathmtu/pathmtu.c: Document the `--verbose' option.

It wasn't supposed to be a secret.

diff --git a/pathmtu/pathmtu.1.in b/pathmtu/pathmtu.1.in
index 942c6b1ecfcb97d15eff95835ecda0b013234a3e..03cd53311074313b8f7c0d240b5a880dec939f89 100644 (file)
--- a/pathmtu/pathmtu.1.in
+++ b/pathmtu/pathmtu.1.in
@@ -37,6 +37,7 @@ pathmtu \- discover path MTU to a given host
 .SH "SYNOPSIS"
 .
 .B pathmtu
 .SH "SYNOPSIS"
 .
 .B pathmtu

+.RB [ \-v ]

 .RB [ \-H
 .IR header ]
 .RB [ \-m
 .RB [ \-H
 .IR header ]
 .RB [ \-m


@@ -156,6 +157,12 @@ assumes that the timeout means that the remote host
 .I did
 receive the packet.  The default timeout is 8 seconds.
 .TP
 .I did
 receive the packet.  The default timeout is 8 seconds.
 .TP

+.B "\-v, \-\-verbose"
+Write a running human-readable commentary to standard error about the
+progress of the operation.  Usually,
+.B pathmtu
+does its job silently unless there are errors.
+.TP

 .BI "\-H, \-\-header=" header
 Sets the packet header, in hexadecimal.  If you set an explicit port
 number, it may be worth setting the packet header too, so as not to
 .BI "\-H, \-\-header=" header
 Sets the packet header, in hexadecimal.  If you set an explicit port
 number, it may be worth setting the packet header too, so as not to

diff --git a/pathmtu/pathmtu.c b/pathmtu/pathmtu.c
index 7c4f1d8d096edc8fa1bf70286d7d0cd4b48a505a..6d988031c474a520fcc0b7b57f6886fe3854b55b 100644 (file)
--- a/pathmtu/pathmtu.c
+++ b/pathmtu/pathmtu.c
@@ -695,7 +695,7 @@ static void version(FILE *fp)
 
 static void usage(FILE *fp)
 {
 
 static void usage(FILE *fp)
 {

-  pquis(fp, "Usage: $ [-H HEADER] [-m METHOD]\n\
+  pquis(fp, "Usage: $ [-v] [-H HEADER] [-m METHOD]\n\

         [-r SECS] [-g FACTOR] [-t SECS] HOST [PORT]\n");
 }
 
         [-r SECS] [-g FACTOR] [-t SECS] HOST [PORT]\n");
 }
 


@@ -718,6 +718,7 @@ Options in full:\n\
 -m, --method=METHOD    Use METHOD to probe for MTU.\n\
 -r, --retransmit=SECS  Retransmit if no reply after SEC.\n\
 -t, --timeout=SECS     Give up expecting a reply after SECS.\n\
 -m, --method=METHOD    Use METHOD to probe for MTU.\n\
 -r, --retransmit=SECS  Retransmit if no reply after SEC.\n\
 -t, --timeout=SECS     Give up expecting a reply after SECS.\n\

+-v, --verbose          Write a running commentary to stderr.\n\

 -H, --header=HEX       Packet header, in hexadecimal.\n\
 \n\
 Probe methods:\n\
 -H, --header=HEX       Packet header, in hexadecimal.\n\
 \n\
 Probe methods:\n\