SPUG: PAUSE's pod2html broken?

Mon Dec 30 14:15:50 CST 2002

SPUGsters,

I'm working on my usual New Year's Resolution, of uploading some of my
software to CPAN (and finally doing it this year!), and I've just run
into a POD-snag.  So I'm hoping somebody can tell me what's going wrong.

My AUTHOR and LICENSE sections are coded specifically for the three
major formatters, pod2text, pod2html, and pod2man, and in my testing
using those programs, the results all come out correctly.  However,
when the documentation is viewed on CPAN itself, at
http://search.cpan.org/author/YUMPY/Lingua-EN-Namegame-0.02/Namegame.pm,
the =html segments are missing!

So I'm wondering if CPAN uses a formatter with a name other than "html",
which would account for my '=for html' segments being skipped.

Here's the code I'm using, which works for all the indicated formatters
in my testing (but note that roff calls pod2man, "for historical reasons"):

=head1 AUTHOR

=for roff
.nf
\fBTim Maher\fP
\fICEO\fP, \fBConsultix\fP
yumpy at cpan.org
http://www.teachmeperl.com
.fi

=for html
<B>Tim Maher</B><BR>
<I>CEO</I>, <B>Consultix</B><BR>
yumpy at cpan.org<BR>
<A HREF="http://www.teachmeperl.com">http://www.teachmeperl.com</A><BR>

=for text
Tim Maher
CEO, Consultix
yumpy at cpan.org
http://www.teachmeperl.com

=head1 LICENSE

This module is free software;
you can redistribute it and/or modify it under the same terms as Perl itself.

=cut

And here's how it looks when run through pod2text:

AUTHOR
    Tim Maher
    CEO, Consultix
    yumpy at cpan.org
    http://www.teachmeperl.com

LICENSE
    Copyright (c) 2002, Timothy F. Maher.  All rights reserved. 

    This module is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself.

But here's (the text version of) how it looks on CPAN;

AUTHOR

LICENSE

    This module is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself.

And here's how it looks (which is correct) when run through pod2html
on my end:
  <html>
  <h1><a name="author">AUTHOR</a></h1>
  <B>Tim Maher</B><BR>
  <I>CEO</I>, <B>Consultix</B><BR>
  yumpy at cpan.org<BR>
  <A HREF="http://www.teachmeperl.com">http://www.teachmeperl.com</A><BR><p>
  </p>
  <hr />
  <h1><a name="license">LICENSE</a></h1>
  Copyright &copy; 2002, Timothy F. Maher.  All rights reserved.<p>This module is free software;
  you can redistribute it and/or modify it under the same terms as Perl itself.</p>
  </body>
  </html>

Any ideas?

-Tim
*----------------------------------------------------------------------------*
| Tim Maher, CEO, CONSULTIX  (206) 781-UNIX; (866) DOC-PERL; (866) DOC-LINUX |
|  Ph.D. & JAWCAR ("Just Another White Camel Award Recipient")               |
|  tim at consultix-inc.com  teachmeunix.com  teachmeperl.com  teachmelinux.net |
*-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+*
| MAHER  CLASSES: Minimal Perl: 1/27; UNIX: 1/28; Perl: 2/10; Modules: 2/13; |
| DAMIAN CLASSES: Munging: 1/13; Regexes: 1/15; BioInfo: 1/15; OOP: 1/17;    |
*----------------------------------------------------------------------------*

 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
     POST TO: spug-list at pm.org       PROBLEMS: owner-spug-list at pm.org
      Subscriptions; Email to majordomo at pm.org:  ACTION  LIST  EMAIL
  Replace ACTION by subscribe or unsubscribe, EMAIL by your Email-address
 For daily traffic, use spug-list for LIST ;  for weekly, spug-list-digest
     Seattle Perl Users Group (SPUG) Home Page: http://seattleperl.org