On Sat, Mar 01, 2014 at 09:34:10PM +0100, Denis Fondras wrote:
> Hi all,
> 
> I've just discovered that OpenBSD vmstat(8) can use wait and count
> arguments without using -c/-w. Here is a small patch to mention this
> usage in the manual :
> 
> Regards,
> Denis
> 
> --- vmstat.8.orig       Sun Feb 23 15:50:17 2014
> +++ vmstat.8    Sun Feb 23 15:54:24 2014
> @@ -45,6 +45,11 @@
>  .Op Fl N Ar system
>  .Op Fl w Ar wait
>  .Op Ar disk ...
> +.Nm vmstat
> +.Op Ar wait Op Ar count
> +.Op Fl M Ar core
> +.Op Fl N Ar system
> +.Op Ar disk ...
>  .Sh DESCRIPTION
>  .Nm
>  reports certain kernel statistics kept about process, virtual memory,
> 

hi. i don;t much like adding another synopsis for this. it's just makes
it more complicated, without adding much.

i note usage() and SYNOPSIS are already out of sync here ;( i had no
idea we had split synopsis up this way.

i guess, properly, we should somehow show stuff like: [[-c] count]
or just reword the description of the options to say under which
circumstances it's optional.

and looking at BUGS:

     This manual page lacks an incredible amount of detail.

we could just paste this into all our pages ;)

before doing anything, i'd like to ask if anyone knows of a reason why
we wouldn;t document this, or the history of when this was added?

i'll think on it a bit more.

jmc

Reply via email to