On Sun, Mar 21, 2021 at 10:58:02PM +0000, Raf Czlonka wrote: > > Hi Laurie, > > I'd simply use the existing wording, without getting into details. > > While there, "braces" dominate the manual page, with a single > occurrence of "brackets" so let's change that too, for consistency. > > Regards, > > Raf >
hi. i could have sworn i recently discussed this documenting of multiple options with someone else, but cannot find the mails. anyway, a couple of points: - "a block of options that is enclosed in curly braces" can be shortened to "a block of options enclosed in curly braces". up to you. - if it is generally true that where multiple options can be given they are specified in the same way (curly braces) then it would be better just to say up front that this is the case, rather than repeating the text endlessly everywhere it's possible. in other respects i'm fine with the diff. jmc > Index: usr.sbin/httpd/httpd.conf.5 > =================================================================== > RCS file: /cvs/src/usr.sbin/httpd/httpd.conf.5,v > retrieving revision 1.114 > diff -u -p -r1.114 httpd.conf.5 > --- usr.sbin/httpd/httpd.conf.5 29 Oct 2020 12:30:52 -0000 1.114 > +++ usr.sbin/httpd/httpd.conf.5 21 Mar 2021 22:56:53 -0000 > @@ -155,7 +155,7 @@ see > .Xr patterns 7 . > .El > .Pp > -Followed by a block of options that is enclosed in curly brackets: > +Followed by a block of options that is enclosed in curly braces: > .Bl -tag -width Ds > .It Ic alias Ar name > Specify an additional alias > @@ -282,6 +282,7 @@ will neither display nor generate a dire > .El > .It Oo Ic no Oc Ic fastcgi Oo Ar option Oc > Enable FastCGI instead of serving files. > +Multiple options may be specified within curly braces. > Valid options are: > .Bl -tag -width Ds > .It Ic socket Oo Cm tcp Oc Ar socket Oo Ar port Oc >
