On Mon, Mar 03, 2014 at 04:03:08PM +0000, Jason McIntyre wrote: > 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
no one has replied, so i'll just say i don;t want to do this. i already dislike that we've split SYNOPSIS into two forms (where neither freebsd or netbsd have), and i don;t see a third form adding much. and i don;t see a way to add this to SYNOPSIS correctly without adding a third form ;) i think trying to document it is just going to make for more confusing text. think of it as a trick that only you know! sorry, jmc
