Re: flower box comments

You're not missing anything, your group is misguided.

=head2 get_records

   my @foo = get_records( $dbh , "select * from BAR..." );

=cut

sub get_records { # ...
}
[download]

Now you run it through perldoc, pod2man, pod2text, pod2html ...

Comments are not documentation ;)

*links here*

MJD says "you can't just make shit up and expect the computer to know what you mean, retardo!"
I run a Win32 PPM repository for perl 5.6.x and 5.8.x -- I take requests (README).
** The third rule of perl club is a statement of fact: pod is sexy.

Comment on Re: flower box comments Download Code

Replies are listed 'Best First'.

Re: Re: flower box comments
by cleverett (Friar) on Nov 17, 2003 at 08:12 UTC

POD implies public.

[reply]

Re: Re: Re: flower box comments

by PodMaster (Abbot) on Nov 17, 2003 at 20:11 UTC

=for private =head2 get_records
   my @foo = get_records( $dbh , "select * from BAR..." );

=cut

=begin private

=head2 get_records

   my @foo = get_records( $dbh , "select * from BAR..." );

=end private

=cut
[download]

[reply]
[d/l]

Re: Re: Re: Re: flower box comments

by cleverett (Friar) on Nov 17, 2003 at 21:36 UTC

POD only implies pod and sexy.

=for private =head2 get_records
   my @foo = get_records( $dbh , "select * from BAR..." );

=cut

=begin private

=head2 get_records

   my @foo = get_records( $dbh , "select * from BAR..." );

=end private

=cut
[download]

It's OK PodMaster, I understand: somebody has to carry the B & D torch ...

[reply]
[d/l]


Pathologically Eclectic Rubbish Lister
	PerlMonks