Front page | perl.perl5.porters |
Postings from December 2004
Re: perlpodtut
Thread Previous
|
Thread Next
From:
Russ Allbery
Date:
December 24, 2004 11:17
Subject:
Re: perlpodtut
Message ID:
87ekhf4ic6.fsf@windlord.stanford.edu
Michael G Schwern <schwern@pobox.com> 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
ordering.
--
Russ Allbery (rra@stanford.edu) <http://www.eyrie.org/~eagle/>
Thread Previous
|
Thread Next