Hi Janne, hi Jakob, Janne Johansson wrote on Sat, Oct 30, 2010 at 10:03:51PM +0200:
> The word "slave" will not appear in the manpage when the nsd.conf > source looks like it does. OK schwarze@; but please make sure this is also sent upstream, ideally coordinated with the rest of the cleanup (Jakob?). This is indeed a manual formatting bug. It is not specific to OpenBSD. It happens with groff-1.15, groff-1.20 and mandoc. The point is that a single quote in column 1 is a macro control character, see here: $ mandoc -Tlint /usr/src/usr.sbin/nsd/nsd.conf.5 [...] /usr/src/usr.sbin/nsd/nsd.conf.5:349:2: ERROR: skipping unknown macro: unknown macro: 'Slave'. ... This is not the only ERROR in nsd.conf(5) causing information loss. The man(7) source code quality of the nsd documentation is very poor in general and far from meeting OpenBSD quality standards. This stuff is in dire need of cleanup, but of course the cleanup has to be fed back upstream. The page nsd.conf.5 alone yields eight ERRORs, at least three of which are very serious, and 161 WARNINGs on top of that, though most of the latter are just trailing whitespace. Yours, Ingo > Index: nsd.conf.5 > =================================================================== > RCS file: /cvs/src/usr.sbin/nsd/nsd.conf.5,v > retrieving revision 1.2 > diff -u -r1.2 nsd.conf.5 > --- nsd.conf.5 1 Oct 2010 20:45:09 -0000 1.2 > +++ nsd.conf.5 30 Oct 2010 20:00:09 -0000 > @@ -345,8 +345,7 @@ > file, which may have different security policies, can be split apart. > .SH "NSD CONFIGURATION FOR BIND9 HACKERS" > BIND9 is a name server implementation with its own configuration > -file format, named.conf(5). BIND9 types zones as 'Master' or > -'Slave'. > +file format, named.conf(5). BIND9 types zones as 'Master' or 'Slave'. > .SS "Slave zones" > For a slave zone, the master servers are listed. The master servers are > queried for zone data, and are listened to for update notifications.
