Date: Fri, 28 Jun 2019 20:53:54 +1000 (EST) From: Bruce Evans <brde@optusnet.com.au> To: Cy Schubert <cy@freebsd.org> Cc: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: Re: svn commit: r349503 - head/contrib/ipfilter/man Message-ID: <20190628202903.J1192@besplex.bde.org> In-Reply-To: <201906280428.x5S4SXhf094525@repo.freebsd.org> References: <201906280428.x5S4SXhf094525@repo.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Fri, 28 Jun 2019, Cy Schubert wrote: > Log: > Document the -B, binary logfile, and the -C config file options. > Reference the ipmon.5 man page and ipmon.conf. > > PR: 238816 > MFC after: 1 week > > Modified: > head/contrib/ipfilter/man/ipmon.8 > > Modified: head/contrib/ipfilter/man/ipmon.8 > ============================================================================== > --- head/contrib/ipfilter/man/ipmon.8 Fri Jun 28 04:18:10 2019 (r349502) > +++ head/contrib/ipfilter/man/ipmon.8 Fri Jun 28 04:28:32 2019 (r349503) > @@ -7,6 +7,10 @@ ipmon \- monitors /dev/ipl for logged packets > [ > .B \-abBDFhnpstvxX -B was misdocumented as a flag here, and still is. > ] [ > +.B "\-B <binarylogfile>" > +] [ This file isn't written in mdoc. This gives errors starting with misformatting the SYNOPIS. The most obvious ones are: - split lines are not properly indented - splitting is done in bad places (after '[' for [ <filename> ] - unusual quoting. mdoc would not put angle brackets and spaces around 'filename. These brackets and spaces seem to be mostly hard-coded using .B and literals. - bad rendering or for square brackets around NSI. These square brackets mean optional options as usual, but are not rendered normally. The .B macro apparently gives normal rendering for outer square brackets, but the inner square brackets around NSI use the same rendering as the letters. - various misorderings: -N before -L, -f after -[NLoOPS; NSI randomly ordered. The recent fixes to the usage message have the correct order for [-NLf], and different misformatting for split lines, so are hard to compare with the man page. This commit makes the usage message out of date again. Bruce
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20190628202903.J1192>