Date: Tue, 8 May 2007 08:10:07 -0700 From: Jeremy Chadwick <koitsu@FreeBSD.org> To: freebsd-ports@freebsd.org Subject: Weekly pre-formatted manpage generation Message-ID: <20070508151007.GA57154@icarus.home.lan>
next in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20070508151007.GA57154>