(podmaster: Why I hate too many #)Re^2: Why I Hate Nested If-Else blocks

in reply to Re: Why I Hate Nested If-Else blocks
in thread Why I Hate Nested If-Else blocks

Can you please explain the following to me?

##  _get_commands (nil) : listref
#
#   each Machine has its own list of Commands that should be 
#   executed in response to the user's input.   this routine returns 
#   a reference to that list.
#
[download]

What prompted you to do that? What I expect is the following?

=head1 FUNCTIONS ....

=head2 C<_get_commands (nil) : listref>

   each Machine has its own list of Commands that should be 
   executed in response to the user's input.   this routine returns 
   a reference to that list.

=cut
[download]

If you're going to bother writing more than two lines of documentation, please make it POD, that is what it is for.

____________________________________________________
** The Third rule of perl club is a statement of fact: pod is sexy.

In Section Meditations