On Thu, 11 Jun 2009 20:41:50 -0700 (PDT) James Walker wrote:
>I'm sponsoring this familiarity case for Huajian Luo. The requested
>release binding is minor. The man page has been posted in the
>materials directory.
>
I find the pv(1) man page a little confusing...
1. What does:
"pv will copy each supplied FILE in turn to standard output
means standard input),"
at the start of the 3rd paragraph of the description mean? Is the
intent something like:
"pv will copy each supplied FILE in turn to standard output (-
means standard input),"?
2. The 2nd paragraph of the description says:
"To use it, insert it in a pipeline between two processes,"
but several of the examples show it as the first process in a
pipeline. Are the examples wrong, or is the description wrong?
3. The examples use several utilities that I haven't seen added to
Solaris yet. Is this case going to provide them as well? I noted
dialog (which is also in the See Also list), gpg, mcrypt, and nc;
but there may be others. If this case isn't going to provide them,
shouldn't we have an updated man page that doesn't refer to them?
4. The DISPLAY SWITCHES section of the OPTIONS sections starts with:
"If no display switches are specified, pv behaves as if -p, -t,
-e, had been given (i.e. everything is switched on)."
but there are other display switches in addition to -e, -p, and -t.
Is the output with no display switches equivalent to:
pv -e -p -t
or to?:
pv -b -e -p -r -t
5. Shouldn't -n and -q be listed in the OUTPUT MODIFIERS list instead
of the DISPLAY SWITCHES list? If not, add -n and -q to the last
command line in #4 above. (Except, see #6 below.)
6. Aren't -n and -q mutually exclusive? What happens if both are given
on the command line?
- Don
