Mailing List Archive

pod2man barfs on =head
I downloaded a clean copy of the perl5.001m archive, built it and
installed on Sunos 4.1.3_U1.

As root I did "make install", said "no" to the question asking if I
wanted to link /usr/bin/perl to my local perl, and then
pod2man issued several messages like these:

../perl -I ../lib ../pod/pod2man ExtUtils/MakeMaker.pm >
/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.

Is this a bug in pod2man?

-Jim Avera (avera@hal.com)
Re: pod2man barfs on =head [ In reply to ]
> ../perl -I ../lib ../pod/pod2man ExtUtils/MakeMaker.pm >
>/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.

>Is this a bug in pod2man?

Not really, although it could be changed. The directives are not =head
but =head1 and =head2, and the other warnings are just me trying to get
better looking man pages.

--tom