Re: Are comments allowed before package declarations in modules?
- From: foskey@xxxxxxxxxx (ken Foskey)
- Date: Wed, 27 Feb 2008 06:55:04 +1100
On Tue, 2008-02-26 at 12:35 -0500, Jonathan Mast wrote:
I seem to have a vague memory about Perl not allowing comments before
program statements, but I'm not sure. I really want to add a lot of
comments at the top of a rather large module, but I'm unsure if thats safe.
The perl best practices book recommends that the documentation (POD)
appears at the end of the module. I don't personally like this
recommendation because it makes it easier for the programmer to forget
to maintain the documentation.
--
Ken Foskey
FOSS developer
.
- References:
- Are comments allowed before package declarations in modules?
- From: Jonathan Mast
- Are comments allowed before package declarations in modules?
- Prev by Date: Re: scalar / hash problem in HTML::Parser
- Next by Date: Re: looping thru delete check boxes
- Previous by thread: Re: Are comments allowed before package declarations in modules?
- Next by thread: Why doesn't this work: matching capturing
- Index(es):