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.
#
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
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.