On Tuesday 14 December 2004 20:54, Darren Duncan wrote: > For a context, my most recent CPAN upload is > http://search.cpan.org/~duncand/Locale-KeyedText-1.01_1/ and its POD > sections start out with the "=encoding utf8" command paragraph. > > I tested this distro and it passes its test suite fine, both under > Perl 5.8.1RC3 and Perl 5.8.6. However, under both the 'make' stage > gives the following error when manifying the POD: > > Manifying blib/man3/Locale::KeyedText.3 > lib/Locale/KeyedText.pm:10: Unknown command paragraph "=encoding utf8"
Do you get an error or a warning? Does the installation fail?
If I am right, you just get a warning because pod2man (or any other tool you happend to be using to do the conversion) doesn support '=encoding utf8'.
I get the same problem with some of my documenation that contains '=head5'.
Cheers, Nadim.
It was just a warning; 'make test' continued to work fine, as did 'make dist'. I did not try 'make install' but I assume that isn't necessary for testing. While this was a warning, I did take it seriously.
A later developed concern is that the HTML documentation on search.cpan.org that was generated from the POD is not interpreting it correctly. Perhaps it is out of date, since the diff tool on the same server does work. But it is disconcerting nonetheless and I prefer that my documentation appears as intended. I already filled out the search.cpan.org feedback form on this.
Thanks for your input. For now I will treat the podtoman warning as a non-issue.
-- Darren Duncan
