in reply to 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.

Replies are listed 'Best First'.
Re: Re: flower box comments
by cleverett (Friar) on Nov 17, 2003 at 08:12 UTC
    I avoid documenting private subroutines with POD.

    POD implies public.

[reply]
      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]

      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.

[reply]
[d/l]
        PodMaster sez:

        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]

In Section Seekers of Perl Wisdom