On December 2, 2002 05:53 am, Lutz Jaenicke via RT wrote: > On Mon, Dec 02, 2002 at 10:55:26AM +0100, Alain Guibert via RT wrote: > > There is just an alert at some point: > > | installing man3/engine.3 > > | ../../util/pod2man.pl: Unrecognized pod directive in paragraph 34 > > | of engine.pod: head3 ../../util/pod2man.pl: Unrecognized pod > > | directive in paragraph 39 of engine.pod: head3 > > | ../../util/pod2man.pl: Unrecognized pod directive in paragraph 59 > > | of engine.pod: head3 ../../util/pod2man.pl: Unrecognized pod > > | directive in paragraph 62 of engine.pod: head3 > > | ../../util/pod2man.pl: Unrecognized pod directive in paragraph 69 > > | of engine.pod: head3 ../../util/pod2man.pl: Unrecognized pod > > | directive in paragraph 73 of engine.pod: head3 > > > > But the installation continues, and "man engine" is there after. > > Hmm. According to http://www.perldoc.com/perl5.6/pod/perlpod.html > there only exist =head1 and =head2, so the complaint is correct :-) > > Geoff???
Hmm, bollocks. I can't confess to having studied the perlpod documentation on this - I merely wondered if I could get away with a third level of header nesting and it "just worked" on my installation (ie. I got no warnings/errors and the resulting man-page rendered fine). Is this a limitation in (some versions of) 'pod2man' or is it a safety measure because of limitations in (some versions of) 'man'? It seems a shame to have to ditch something that works if it's a limitation in the version of the conversion tool being used. Lutz, you are the doc-god, what do you think we should do? I'm obviously the first to want a third level of header nesting, but I may not be the last ... Cheers, Geoff -- Geoff Thorpe [EMAIL PROTECTED] http://www.geoffthorpe.net/ The bastards have beaten off rationalism for now, but haven't eliminated our capacity for reason - to do that they'd have to make us forget how to both think and fear at the same time. ______________________________________________________________________ OpenSSL Project http://www.openssl.org Development Mailing List [EMAIL PROTECTED] Automated List Manager [EMAIL PROTECTED]
