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 a...@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. :-) -- Joel _______________________________________________ svn-src-all@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"
