develooper Front page | perl.perl5.porters | Postings from October 2005

Pod Synopsis

Thread Next
From:
Alan Olsen
Date:
October 5, 2005 13:35
Subject:
Pod Synopsis
Message ID:
KAEAKKDCGJLBMIFKDKGCCEKFCAAA.olsena@odscompanies.com
I found an odd discrepancy in the pod docs.

In "Programming Perl" 3rd edition page 644, it describes the SYNOPSIS
section as "A one-line description of what your program or module does
(purportedly)."

In the online Perl docs (which appear to be from the Module POD data), it is
a code example. ( For example
http://cpan.uwinnipeg.ca/htdocs/perl/File/Find.html )

I assume the Programming Perl description is "no longer operative".

----------------------------------
The ODS Companies

Alan Olsen

Software Engineer
(503) 228-6554

http://www.odscompanies.com <http://www.odscompanies.com/>



This message is intended for the sole use of the individual and entity to
whom it is addressed, and may contain information that is privileged,
confidential and exempt from disclosure under applicable law. If you are not
the intended addressee, nor authorized to receive for the intended
addressee, you are hereby notified that you may not use, copy, disclose or
distribute to anyone the message or any information contained in the
message. If you have received this message in error, please immediately
advise the sender by reply email and delete the message.


Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About