#######################################################
 # Usage:
 # Purpose:
 # Returns:
 # Parameters:
 # Throws:
 # Comments:
 # See Also:

##</code><code>##

=head1 SUBROUTINES/METHODS

=over

=item subroutine_xyz()

=over

=item Usage

my $retval = Module::subroutine_xyz( $arg );

=item Purpose

Do something in some manner;

=item Returns

Useful information about the return value;

=item Parameters

=over

=item $arg - some information which varies the operation of the subroutine;

=back

=back

=cut 

##</code><code>##

SUBROUTINES/METHODS
       subroutine_xyz()
           Usage
               my $retval = Module::subroutine_xyz( $arg );

           Purpose
               Do something in some manner;

           Returns
               Useful information about the return value;

           Parameters
               $arg - some information which varies the operation of the
               subroutine;