On Fri, Jul 24, 2015 at 09:18:31PM -0400, Michael Reed wrote: > Hi, > > mdoc(7) states that the Cm macro should be used for "fixed strings > passed as arguments, unless Fl is more appropriate", which seems like a > better fit for the below cases than Ar. > > Regards, > Michael >
i'll let ingo and antoine decide what macros they want in here, but i have one comment: > Index: rcctl.8 > =================================================================== > RCS file: /cvs/src/usr.sbin/rcctl/rcctl.8,v > retrieving revision 1.20 > diff -u -p -r1.20 rcctl.8 > --- rcctl.8 15 Jul 2015 05:51:08 -0000 1.20 > +++ rcctl.8 25 Jul 2015 01:09:05 -0000 > @@ -86,21 +86,21 @@ but returns the default values. > .It Cm ls Ar lsarg > Display a list of services and daemons matching > .Ar lsarg . > -.Ar lsargs > +.Ar lsarg > can be one of: you're right to note that "...lsargs. lsargs ..." is not a great construction, but you're version is missing at least some punctuation. it'd be easier to say "... matching lsargs, which can be..." jmc > .Pp > .Bl -tag -width started -offset indent -compact > -.It Ar all > +.It Cm all > all services and daemons > -.It Ar faulty > +.It Cm faulty > enabled but stopped daemons > -.It Ar off > +.It Cm off > disabled services and daemons > -.It Ar on > +.It Cm on > enabled services and daemons > -.It Ar started > +.It Cm started > running daemons > -.It Ar stopped > +.It Cm stopped > stopped daemons > .El > .It Cm order Op Ar daemons > @@ -162,7 +162,7 @@ exits with 0 if the daemon or service is > .Nm Cm getdef Ar daemon | service Op Cm status > exits with 0 if the daemon or service is enabled by default > and 1 if it is not. > -.Nm Cm ls Ar faulty > +.Nm Cm ls faulty > exits with 1 if an enabled daemon is not running. > Otherwise, the > .Nm >
