Weekly pre-formatted manpage generation

Tue May 8 08:10:09 PDT 2007

I don't think this has been discussed before (or if it has, I can't find
any references to it).  I'm also not sure if this should go to ports@ or
doc@ or bin@ or what...

There are some of us who use weekly_catman_enable="yes" in periodic.conf
to rebuild pre-formatted manpages once a week.  I thought tinderbox
would catch some of these -- doh!

Regardless, it appears to me that there's a lot of ports which have
broken manpages in some way, and in one case (I think lang/perl5), some
missing directories which `catman.local | su -fm man` cannot create due
to preceeding directory permissions.

Below is output I get once a week from a few of my boxes (most have the
same ports installed, give or take a couple).  Sadly I have no way of
easily determining which manpages need fixing or what's broken and why,
because pipes are being used.  But at least these warnings/errors are
reproducable.

Any feedback is appreciated.  :)

-- 
| Jeremy Chadwick                                    jdc at parodius.com |
| Parodius Networking                           http://www.parodius.com/ |
| UNIX Systems Administrator                      Mountain View, CA, USA |
| Making life hard for others since 1977.                  PGP: 4BD6C0CB |

=== SNIP ===

Rebuilding whatis database:

Reformatting manual pages:
<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
mdoc warning: Empty input line #91
<standard input>:108: warning [p 2, 6.5i]: can't break line
<standard input>:68: warning [p 1, 6.0i]: can't break line
Usage: .Ft function_type ... (#284)
Usage: .Ft function_type ... (#348)
<standard input>:45: warning [p 1, 5.2i]: can't break line
<standard input>:45: warning [p 1, 5.2i]: can't break line
<standard input>:45: warning [p 1, 5.2i]: can't break line
<standard input>:52: warning [p 1, 7.0i]: cannot adjust line
mdoc warning: A .Bl directive has no matching .El (#87)
mdoc warning: A .Bd directive has no matching .Ed (#40)
mdoc warning: .Fx: Unknown FreeBSD version `6.3' (#125)
mdoc warning: extraneous .El call (#96)
<standard input>:254: warning [p 3, 3.3i]: can't break line
mdoc warning: A .Bl directive has no matching .El (#56)
mdoc warning: A .Bl directive has no matching .El (#156)
mdoc warning: Empty input line #179
mdoc warning: A .Bl directive has no matching .El (#75)
mdoc warning: A .Bl directive has no matching .El (#56)
<standard input>:13: warning [p 1, 1.2i]: can't break line
mdoc warning: Empty input line #19
mdoc warning: Using a macro as first argument cancels effect of .Ic (#165)
mdoc warning: Using a macro as first argument cancels effect of .Ic (#170)
mdoc warning: Using a macro as first argument cancels effect of .Ic (#151)
mdoc warning: Using a macro as first argument cancels effect of .Ic (#156)
mdoc warning: A .Bl directive has no matching .El (#158)
mdoc warning: A .Bl directive has no matching .El (#215)
mdoc warning: A .Bl directive has no matching .El (#230)
mdoc warning: A .Bl directive has no matching .El (#262)
mdoc warning: A .Bl directive has no matching .El (#284)
mdoc warning: Empty input line #300
mdoc warning: Empty input line #308
<standard input>:930: warning [p 8, 7.3i, div `3tbd25,1', 0.2i]: can't break line
<standard input>:938: a newline character is not allowed in an escape name
<standard input>:17: warning [p 1, 1.5i]: can't break line
<standard input>:17: warning [p 1, 1.7i]: can't break line
<standard input>:519: warning [p 6, 0.0i, div `3tbd1,2', 0.5i]: can't break line
<standard input>:520: warning [p 6, 0.0i, div `3tbd1,2', 1.2i]: can't break line
<standard input>:521: warning [p 6, 0.0i, div `3tbd1,2', 1.7i]: can't break line
<standard input>:529: warning [p 6, 0.0i, div `3tbd2,2', 0.3i]: can't break line
<standard input>:575: warning [p 6, 0.0i, div `3tbd8,1', 0.0i]: can't break line
<standard input>:672: warning [p 6, 0.0i, div `3tbd21,2', 0.3i]: can't break line
<standard input>:720: warning [p 7, 1.7i, div `3tbd1,1', 0.0i]: can't break line
<standard input>:723: warning [p 7, 1.7i, div `3tbd1,2', 0.5i]: can't break line
<standard input>:724: warning [p 7, 1.7i, div `3tbd1,2', 0.8i]: can't break line
<standard input>:725: warning [p 7, 1.7i, div `3tbd1,2', 1.5i]: can't break line
<standard input>:726: warning [p 7, 1.7i, div `3tbd1,2', 1.8i]: can't break line
<standard input>:727: warning [p 7, 1.7i, div `3tbd1,2', 2.2i]: can't break line
<standard input>:728: warning [p 7, 1.7i, div `3tbd1,2', 2.8i]: can't break line
<standard input>:729: warning [p 7, 1.7i, div `3tbd1,2', 3.3i]: can't break line
<standard input>:741: warning [p 7, 1.7i, div `3tbd3,1', 0.0i]: can't break line
<standard input>:3822: warning [p 44, 4.3i]: can't break line
<standard input>:3823: warning [p 44, 5.8i]: can't break line
<standard input>:3823: warning [p 44, 6.2i]: can't break line
<standard input>:3823: warning [p 44, 6.5i]: can't break line
<standard input>:3823: warning [p 44, 6.8i]: can't break line
<standard input>:3823: warning [p 44, 7.2i]: can't break line
<standard input>:3823: warning [p 44, 7.5i]: can't break line
<standard input>:3824: warning [p 44, 8.0i]: can't break line
<standard input>:3824: warning [p 44, 8.5i]: can't break line
<standard input>:3824: warning [p 44, 8.8i]: can't break line
<standard input>:3824: warning [p 44, 9.2i]: can't break line
<standard input>:3824: warning [p 44, 9.7i]: can't break line
<standard input>:3824: warning [p 44, 10.0i]: can't break line
<standard input>:3824: warning [p 45, 0.3i]: can't break line
<standard input>:3824: warning [p 45, 1.3i]: can't break line
<standard input>:3824: warning [p 45, 1.7i]: can't break line
<standard input>:3824: warning [p 45, 2.2i]: can't break line
<standard input>:3824: warning [p 45, 2.5i]: can't break line
<standard input>:266: a space character is not allowed in an escape name
<standard input>:267: a newline character is not allowed in an escape name
<standard input>:139: warning [p 1, 1.8i]: can't break line
<standard input>:139: warning [p 1, 2.2i]: can't break line
<standard input>:139: warning [p 1, 2.3i]: can't break line
<standard input>:179: warning [p 1, 9.7i]: can't break line
<standard input>:185: warning [p 1, 10.3i]: can't break line
<standard input>:193: warning [p 2, 0.3i]: can't break line
<standard input>:195: warning [p 2, 0.7i]: can't break line
<standard input>:195: warning [p 2, 1.5i]: can't break line
<standard input>:197: warning [p 2, 2.5i]: can't break line
<standard input>:201: warning [p 2, 3.3i]: can't break line
<standard input>:245: warning [p 2, 9.7i]: can't break line
<standard input>:286: warning [p 3, 1.7i]: can't break line
<standard input>:1128: a space character is not allowed in an escape name
<standard input>:1181: a space character is not allowed in an escape name
<standard input>:287: a space character is not allowed in an escape name
<standard input>:143: warning [p 2, 2.2i]: can't break line
rm /usr/local/man/cat1/csup.1.gz
<standard input>:1: can't open `man3/gettext.3': No such file or directory
<standard input>:1: can't open `man3/ngettext.3': No such file or directory
<standard input>:1: can't open `man3/gettext.3': No such file or directory
<standard input>:1: can't open `man3/ngettext.3': No such file or directory
<standard input>:730: warning [p 9, 9.8i]: cannot adjust line
<standard input>:155: warning [p 1, 7.0i]: cannot adjust line
<standard input>:156: warning [p 1, 7.2i]: cannot adjust line
<standard input>:159: warning [p 1, 7.5i]: cannot adjust line
<standard input>:160: warning [p 1, 7.7i]: cannot adjust line
<standard input>:161: warning [p 1, 7.8i]: cannot adjust line
<standard input>:214: warning [p 2, 0.2i]: cannot adjust line
<standard input>:253: warning [p 2, 3.0i]: cannot adjust line
catman: /usr/local/lib/perl5/5.8.8/man/cat3: mkdir: Permission denied
catman: /usr/local/lib/perl5/5.8.8/perl/man/cat3: mkdir: Permission denied