From owner-freebsd-stable@FreeBSD.ORG Tue Oct 30 12:35:50 2007 Return-Path: Delivered-To: stable@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 31E0E16A41B; Tue, 30 Oct 2007 12:35:50 +0000 (UTC) (envelope-from keramida@freebsd.org) Received: from igloo.linux.gr (igloo.linux.gr [62.1.205.36]) by mx1.freebsd.org (Postfix) with ESMTP id 8AFBA13C4AC; Tue, 30 Oct 2007 12:35:49 +0000 (UTC) (envelope-from keramida@freebsd.org) Received: from kobe.laptop (vader.bytemobile-rio.ondsl.gr [83.235.57.37]) (authenticated bits=128) by igloo.linux.gr (8.14.1/8.14.1/Debian-9) with ESMTP id l9UCGOfw027167 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Tue, 30 Oct 2007 14:16:36 +0200 Received: from kobe.laptop (kobe.laptop [127.0.0.1]) by kobe.laptop (8.14.1/8.14.1) with ESMTP id l9UCG4dA090791; Tue, 30 Oct 2007 14:16:19 +0200 (EET) (envelope-from keramida@freebsd.org) Received: (from keramida@localhost) by kobe.laptop (8.14.1/8.14.1/Submit) id l9UCG3Un090790; Tue, 30 Oct 2007 14:16:03 +0200 (EET) (envelope-from keramida@freebsd.org) Date: Tue, 30 Oct 2007 14:16:03 +0200 From: Giorgos Keramidas To: Jeremy Chadwick Message-ID: <20071030121603.GA90748@kobe.laptop> References: <47240A15.8080305@charter.net> <20071028074248.GA1511@haakonia.hitnet.RWTH-Aachen.DE> <4724BAD9.7000400@charter.net> <20071028164152.GA7516@eos.sc1.parodius.com> <4724BEB3.5080905@charter.net> <20071029132447.GA2658@kobe.laptop> <20071029191836.GA58058@eos.sc1.parodius.com> <20071030113247.GA3941@kobe.laptop> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20071030113247.GA3941@kobe.laptop> X-Hellug-MailScanner: Found to be clean X-Hellug-MailScanner-SpamCheck: not spam, SpamAssassin (not cached, score=-4.117, required 5, autolearn=not spam, ALL_TRUSTED -1.80, AWL 0.28, BAYES_00 -2.60) X-Hellug-MailScanner-From: keramida@freebsd.org X-Spam-Status: No Cc: Andrew Lankford , stable@freebsd.org, current@freebsd.org Subject: Re: /usr/share/man/man8/MAKEDEV.8 X-BeenThere: freebsd-stable@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Production branch of FreeBSD source code List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 30 Oct 2007 12:35:50 -0000 On 2007-10-30 13:32, Giorgos Keramidas wrote: >> http://lists.freebsd.org/pipermail/freebsd-ports/2007-May/040648.html > > Very interesting. Maybe we can tweak 330.catman to display the filename > of the manpage which causes each error. Then we could use the periodic > script as an aid to start actually *fixing* the errors :) Neat. The base-system manpages which have errors or warnings are just a few of the hundreds we have. I just finished running a slightly modified version of `/etc/periodic/weekly/330.catman', which uses `catman -v' and the list of files with errors (after a bit of manual parsing) is now: % Reformatting manual pages: % /usr/share/man: not writable - will only be able to write to existing cat directories % man directory /usr/share/man % section man1 % format man1/readelf.1.gz -> cat1/readelf.1.gz % :151: warning [p 1, 3.8i]: cannot adjust line % :300: warning [p 2, 9.7i, div `an-div', 0.0i]: cannot adjust line % :300: warning [p 2, 9.7i]: cannot adjust line % section man2 % format man2/minherit.2.gz -> cat2/minherit.2.gz % mdoc warning: .Fx: Unknown FreeBSD version `2.2.0' (#132) % format man2/sctp_generic_recvmsg.2.gz -> cat2/sctp_generic_recvmsg.2.gz % mdoc warning: Empty input line #76 % format man2/sctp_generic_sendmsg.2.gz -> cat2/sctp_generic_sendmsg.2.gz % mdoc warning: Empty input line #51 % mdoc warning: Empty input line #88 % format man2/sctp_peeloff.2.gz -> cat2/sctp_peeloff.2.gz % mdoc warning: Empty input line #82 % section man3 % format man3/ether_aton.3.gz -> cat3/ether_aton.3.gz % mdoc warning: Empty input line #169 % format man3/gss_add_cred.3.gz -> cat3/gss_add_cred.3.gz % Not a \-mdoc command: .PP (#89) % format man3/gss_inquire_cred_by_mech.3.gz -> cat3/gss_inquire_cred_by_mech.3.gz % mdoc warning: Empty input line #72 % format man3/gss_inquire_mechs_for_name.3.gz -> cat3/gss_inquire_mechs_for_name.3.gz % mdoc warning: Empty input line #50 % format man3/gss_seal.3.gz -> cat3/gss_seal.3.gz % mdoc warning: A .Bl directive has no matching .El (#146) % format man3/gss_unseal.3.gz -> cat3/gss_unseal.3.gz % mdoc warning: A .Bl directive has no matching .El (#159) % format man3/gss_wrap_size_limit.3.gz -> cat3/gss_wrap_size_limit.3.gz % mdoc warning: A .Bl directive has no matching .El (#131) % format man3/lwres_gabn.3.gz -> cat3/lwres_gabn.3.gz % :45: warning [p 1, 5.2i]: can't break line % format man3/lwres_gnba.3.gz -> cat3/lwres_gnba.3.gz % :45: warning [p 1, 5.2i]: can't break line % format man3/lwres_noop.3.gz -> cat3/lwres_noop.3.gz % :45: warning [p 1, 5.2i]: can't break line % format man3/valloc.3.gz -> cat3/valloc.3.gz % mdoc warning: Extraneous .Ef (#49) % format man3/zlib.3.gz -> cat3/zlib.3.gz % :52: warning [p 1, 7.0i]: cannot adjust line % section man4 % format man4/mac.4.gz -> cat4/mac.4.gz % mdoc warning: extraneous .El call (#200) % format man4/md.4.gz -> cat4/md.4.gz % mdoc warning: Unknown keyword `-ofset' in .Bd macro (#68) % mdoc warning: Unknown keyword `indent' in .Bd macro (#68) % format man4/ng_netflow.4.gz -> cat4/ng_netflow.4.gz % :254: warning [p 3, 3.3i]: can't break line % section man5 % format man5/bluetooth.device.conf.5.gz -> cat5/bluetooth.device.conf.5.gz % :93: warning [p 1, 7.2i]: can't break line % format man5/quota.group.5.gz -> cat5/quota.group.5.gz % mdoc warning: Unknown keyword `-indent' in .Bl macro (#53) % mdoc warning: Unknown keyword `offset' in .Bl macro (#53) % section man8 % format man8/fwcontrol.8.gz -> cat8/fwcontrol.8.gz % mdoc warning: Empty input line #179 % format man8/ifmcstat.8.gz -> cat8/ifmcstat.8.gz % mdoc warning: A .Bl directive has no matching .El (#82) % section man9 % format man9/uio.9.gz -> cat9/uio.9.gz % mdoc warning: A .Bl directive has no matching .El (#129) % link cat9/zpfind.9.gz -> cat9/pfind.9.gz These are just the manpages of the base-system. I think I can handle most of them, so I started patching the non-contrib stuff. - Giorgos