>man perl56delta says
> See the section on "/www.plover.com/~mjd/perl/at-
> error.html" in the http: manpage for more details about
> the history here.
That shouldn't be an L<>. Leave it as is, and let the
translators do the right thing!
You should write your pod as close to plain text as you possible
can, with as few explicit markups as you can get away with. It
is up to the individual conversion to decide how things in your
text should be represented. That means letting the translator
figure out how to create paired quotes, how to fill and adjust
text, how to find a smaller font for words in all capitals,
etc. Since these were written to process Perl documentation,
most translators<footnote>If you're designing a general-purpose
pod translator, not one for Perl code, your criteria may
vary.</footnote> should also recognize unadorned items like
these and render them appropriately:
=over
=item *
FILEHANDLE
=item *
$scalar
=item *
@array
=item *
function()
=item *
manpage(3r)
=item *
[EMAIL PROTECTED]
=item *
http://foo.com/
=back
--tom
