develooper Front page | perl.perl5.porters | Postings from December 2004

Re: perlpodtut

Thread Previous | Thread Next
Russ Allbery
December 24, 2004 11:17
Re: perlpodtut
Message ID:
Michael G Schwern <> writes:
> On Fri, Dec 24, 2004 at 11:12:05AM +0100, Juerd wrote:

>> And there are F, S, X and Z, but they're rarely used so not worth
>> explaining in a simple tutorial.

> F<> is, I think, what you're supposed to use for URLs and email addresses
> and the like (in addition to filenames).

L<> should be used for URLs (they're a link, after all).  I wasn't aware
there was any markup used for e-mail addresses.  I do think explaining F<>
is worthwhile; after all, the pod2man man page mentions it explicitly.

>>     =head1 LICENSE
>>     This is released under the Artistic License. See L<perlartistic>.

> Since people like to cut & paste, this should probably be the standard
> "same as Perl" wording plus a copyright notice.

This should be =head1 COPYRIGHT AND LICENSE to fit what's done elsewhere,
and it comes after AUTHOR so that it's the last thing in the man page
except for HISTORY if any.  See the pod2man man page for the section

Russ Allbery (             <>

Thread Previous | Thread Next Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About