From owner-svn-src-all@FreeBSD.ORG Mon Nov 24 09:20:01 2014 Return-Path: Delivered-To: svn-src-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 8EC1DFC; Mon, 24 Nov 2014 09:20:01 +0000 (UTC) Received: from smarthost1.greenhost.nl (smarthost1.greenhost.nl [195.190.28.81]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 10AC967B; Mon, 24 Nov 2014 09:20:01 +0000 (UTC) Received: from smtp.greenhost.nl ([213.108.104.138]) by smarthost1.greenhost.nl with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.72) (envelope-from ) id 1Xspna-0006B3-9n; Mon, 24 Nov 2014 10:19:52 +0100 Content-Type: text/plain; charset=iso-8859-15; format=flowed; delsp=yes To: "Baptiste Daroussin" , "Joel Dahl" Subject: Re: 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 References: <201411232100.sANL00cG078781@svn.freebsd.org> <20141123210412.GG68776@ivaldir.etoilebsd.net> <20141124072316.GA27782@ymer.vnode.se> Date: Mon, 24 Nov 2014 10:19:08 +0100 MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: "Ronald Klop" Message-ID: In-Reply-To: <20141124072316.GA27782@ymer.vnode.se> User-Agent: Opera Mail/12.17 (Win32) X-Authenticated-As-Hash: 398f5522cb258ce43cb679602f8cfe8b62a256d1 X-Virus-Scanned: by clamav at smarthost1.samage.net X-Spam-Level: / X-Spam-Score: -0.2 X-Spam-Status: No, score=-0.2 required=5.0 tests=ALL_TRUSTED, BAYES_50 autolearn=disabled version=3.3.2 X-Scan-Signature: 4868b52b90b9144be14ceb212c82ef23 Cc: svn-src-head@freebsd.org, svn-src-all@freebsd.org, src-committers@freebsd.org X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 24 Nov 2014 09:20:01 -0000 On Mon, 24 Nov 2014 08:23:17 +0100, Joel Dahl 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@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. ;-)