Date: Tue, 30 Oct 2007 14:16:03 +0200 From: Giorgos Keramidas <keramida@freebsd.org> To: Jeremy Chadwick <koitsu@freebsd.org> Cc: Andrew Lankford <lankfordandrew@charter.net>, stable@freebsd.org, current@freebsd.org Subject: Re: /usr/share/man/man8/MAKEDEV.8 Message-ID: <20071030121603.GA90748@kobe.laptop> In-Reply-To: <20071030113247.GA3941@kobe.laptop> References: <47240A15.8080305@charter.net> <20071028074248.GA1511@haakonia.hitnet.RWTH-Aachen.DE> <alpine.BSF.0.9999.0710280131220.2400@qbhto.arg> <4724BAD9.7000400@charter.net> <20071028164152.GA7516@eos.sc1.parodius.com> <E1ImBHh-000OiV-Mc@cs1.cs.huji.ac.il> <4724BEB3.5080905@charter.net> <20071029132447.GA2658@kobe.laptop> <20071029191836.GA58058@eos.sc1.parodius.com> <20071030113247.GA3941@kobe.laptop>
next in thread | previous in thread | raw e-mail | index | archive | help
On 2007-10-30 13:32, Giorgos Keramidas <keramida@ceid.upatras.gr> 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 % <standard input>:151: warning [p 1, 3.8i]: cannot adjust line % <standard input>:300: warning [p 2, 9.7i, div `an-div', 0.0i]: cannot adjust line % <standard input>: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 % <standard input>:45: warning [p 1, 5.2i]: can't break line % format man3/lwres_gnba.3.gz -> cat3/lwres_gnba.3.gz % <standard input>:45: warning [p 1, 5.2i]: can't break line % format man3/lwres_noop.3.gz -> cat3/lwres_noop.3.gz % <standard input>: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 % <standard input>: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 % <standard input>: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 % <standard input>: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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20071030121603.GA90748>