On 2007-10-30 13:32, Giorgos Keramidas <[EMAIL PROTECTED]> 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

_______________________________________________
[email protected] mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-stable
To unsubscribe, send any mail to "[EMAIL PROTECTED]"

Reply via email to