svn commit: r274925 - in head: lib/libc/sys lib/libdpv sbin/ipfw share/man/man4 share/man/man4/man4.arm share/man/man9 sys/boot/common sys/boot/i386/gptzfsboot usr.bin/dpv

[Baptiste Daroussin]

On Mon, Nov 24, 2014 at 10:19:08AM +0100, Ronald Klop wrote:
> On Mon, 24 Nov 2014 08:23:17 +0100, Joel Dahl <joel at vnode.se> wrote:
> 
> > On Sun, Nov 23, 2014 at 10:04:12PM +0100, Baptiste Daroussin wrote:
> >> On Sun, Nov 23, 2014 at 09:00:00PM +0000, Joel Dahl wrote:
> >> > Author: joel (doc committer)
> >> > Date: Sun Nov 23 21:00:00 2014
> >> > New Revision: 274925
> >> > URL: https://svnweb.freebsd.org/changeset/base/274925
> >> >
> >> > Log:
> >> >   Misc mdoc fixes:
> >> >
> >> >   - Remove superfluous paragraph macros.
> >> >   - Remove/fix empty or incorrect macros.
> >> >   - Sort sections into conventional order.
> >> >   - Terminate quoted strings properly.
> >> >   - Remove EOL whitespace.
> >> >
> >> > Modified:
> >> >   head/lib/libc/sys/poll.2
> >> >   head/lib/libdpv/dpv.3
> >> >   head/sbin/ipfw/ipfw.8
> >> >   head/share/man/man4/gre.4
> >> >   head/share/man/man4/man4.arm/cgem.4
> >> >   head/share/man/man4/me.4
> >> >   head/share/man/man4/netmap.4
> >> >   head/share/man/man9/get_cyclecount.9
> >> >   head/share/man/man9/malloc.9
> >> >   head/share/man/man9/sleepqueue.9
> >> >   head/sys/boot/common/zfsloader.8
> >> >   head/sys/boot/i386/gptzfsboot/gptzfsboot.8
> >> >   head/usr.bin/dpv/dpv.1
> >> >
> >>
> >> [...]
> >>
> >> > +.Sh AUTHORS
> >> > +This manual page was written by
> >> > +.An Andriy Gapon Aq avg at FreeBSD.org .
> >>                        ^ There should be a Mt here to properly render  
> >> in html
> >>
> >> I just picked one in the middle of this commit. In general every mail  
> >> on any
> >> manpage Mt should be used.
> >
> > Sure. Feel free to go over our manpages and fix them. It's a minor issue.
> >
> > And while we're on the subject, there's a bit of background to this  
> > commit.
> > Back in 2012 I started fixing mandoc lint errors/warnings in our manpage
> > collection (excluding stuff from contrib/ and gnu/ etc.). I think I got  
> > them
> > down from around ~4000 issues to almost zero. Quite a few manpages didn't
> > even work with mandoc at the time, due to how many syntactical mdoc  
> > errors
> > they had. The situation is still good, but I re-ran my scripts yesterday  
> > and
> > found a slew of new warnings. I fixed a few obvious ones, but if someone  
> > with
> > more time on his hands wants to help, please go ahead. A good starting  
> > point
> > would probably the netmap.4 or ctl.conf.5 manpages, they seem to generate
> > quite a few warnings.
> >
> > I'd also be grateful if everyone ran mandoc -Tlint on their manpages  
> > before
> > committing. :-)
> >
> 
> A commit hook does magic for these kind of things. ;-)

Except that such commit hook will prevent updating openssl and/or kerberos :)

Regards,
Bapt
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 181 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/svn-src-head/attachments/20141124/fff6b52f/attachment.sig>