[.courtesy cc of this posting sent to cited author via email]
In comp.lang.perl.misc,
phil@freed.com (Phil Freed) writes:
:I've just built 5.001m under Solaris 2.4/Sparc, and got the following cryptic
:warnings from pod2man:
:
: ../perl -I ../lib ../pod/pod2man ExtUtils/MakeMaker.pm >
: /usr/local/lib/perl5/man/man3/ExtUtils::MakeMaker.3
:
:``-n'' should be [CB]<-n> ref at ../pod/pod2man line 267, <> chunk 448.
:Unrecognized directive: head
:Unrecognized directive: head
:``-I'' should be [CB]<-I> ref at ../pod/pod2man line 267, <> chunk 466.
:``-I'' should be [CB]<-I> ref at ../pod/pod2man line 267, <> chunk 466.
:Unrecognized directive: head
:``-D'' should be [CB]<-D> ref at ../pod/pod2man line 267, <> chunk 474.
:
:and
:
: ../perl -I ../lib ../pod/pod2man IPC/Open2.pm >
: /usr/local/lib/perl5/man/man3/IPC::Open2.3
:
:``-v'' should be [CB]<-v> ref at ../pod/pod2man line 267, <> chunk 13.
:
:These are the only two modules that report any probelms A quick glance at the
:pod2man code indicates that it will take some tracing to understand what's
:going on; I figure I'll get to this on my next day off (in January, probably
:around the year 2007). Has anyone here seen this and solved it already?
It's simple: I expect that flag options should be set up in
bold. Perhaps I should just automatically do this for /\s-\w\s/
sequences, but I was trying to avoid that, because you don't
know if it's
I'm going --aren't you?
The B<-f>I<file> flag will...
The B<-filter> I<program> option will...
So I decided to may someone SAY what should be bold instead of guessing.
But pod is supposed to be simple, and I notice other module writers are
never doing an installman, so they often mess this (and other stuff,
like L<refs>) up, despite the docs. I guess I should at least
document this.
--tom
--
Tom Christiansen Perl Consultant, Gamer, Hiker tchrist@mox.perl.com
All language designers are arrogant. Goes with the territory... :-)
--Larry Wall in <1991Jul13.010945.19157@netlabs.com
In comp.lang.perl.misc,
phil@freed.com (Phil Freed) writes:
:I've just built 5.001m under Solaris 2.4/Sparc, and got the following cryptic
:warnings from pod2man:
:
: ../perl -I ../lib ../pod/pod2man ExtUtils/MakeMaker.pm >
: /usr/local/lib/perl5/man/man3/ExtUtils::MakeMaker.3
:
:``-n'' should be [CB]<-n> ref at ../pod/pod2man line 267, <> chunk 448.
:Unrecognized directive: head
:Unrecognized directive: head
:``-I'' should be [CB]<-I> ref at ../pod/pod2man line 267, <> chunk 466.
:``-I'' should be [CB]<-I> ref at ../pod/pod2man line 267, <> chunk 466.
:Unrecognized directive: head
:``-D'' should be [CB]<-D> ref at ../pod/pod2man line 267, <> chunk 474.
:
:and
:
: ../perl -I ../lib ../pod/pod2man IPC/Open2.pm >
: /usr/local/lib/perl5/man/man3/IPC::Open2.3
:
:``-v'' should be [CB]<-v> ref at ../pod/pod2man line 267, <> chunk 13.
:
:These are the only two modules that report any probelms A quick glance at the
:pod2man code indicates that it will take some tracing to understand what's
:going on; I figure I'll get to this on my next day off (in January, probably
:around the year 2007). Has anyone here seen this and solved it already?
It's simple: I expect that flag options should be set up in
bold. Perhaps I should just automatically do this for /\s-\w\s/
sequences, but I was trying to avoid that, because you don't
know if it's
I'm going --aren't you?
The B<-f>I<file> flag will...
The B<-filter> I<program> option will...
So I decided to may someone SAY what should be bold instead of guessing.
But pod is supposed to be simple, and I notice other module writers are
never doing an installman, so they often mess this (and other stuff,
like L<refs>) up, despite the docs. I guess I should at least
document this.
--tom
--
Tom Christiansen Perl Consultant, Gamer, Hiker tchrist@mox.perl.com
All language designers are arrogant. Goes with the territory... :-)
--Larry Wall in <1991Jul13.010945.19157@netlabs.com