Re: /usr/share/man/man8/MAKEDEV.8

On 2007-10-30 13:32, Giorgos Keramidas <keramida_at_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