On 11/28/06, Robert Hicks <[EMAIL PROTECTED]> wrote:
Do you use the regular "#" or inline POD statements?

Both. # is proper for intimate comments of the implementation code,
like:

   $META ||= CPAN->new; # In case we re-eval ourselves we need the ||
   # from http://search.cpan.org/src/ANDK/CPAN-1.8802/lib/CPAN.pm

but some authors use it as well for multi-line comments
which are to be kept private to the documentation.

POD is good for documentation and multi-line comments. For example,
you see often things like

=begin comment

blah, blah,

=end comment

It is a way to deactivate pieces of code which are not ready yet or
which have been replaced by something else. Depending on the editor
you use and your skills with it, POD may be handier to comment such
blocks.

Regards,
Adriano Ferreira.

--
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
<http://learn.perl.org/> <http://learn.perl.org/first-response>


Reply via email to