=pod

=head2 POD-Example

=over

=item * if a list element is not defined the value from the option I<undef> is assigned to the element

=item * if a list element holds an empty string the value from the option I<empty_string> is assigned to the element

=item * white-spaces in list elements are replace with a simple spaces: 

    $element =~ s/\p{Space}/ /g;
    
=item * control characters are removed:

    $element =~ s/\p{Cntrl}//g;

=item * if the length of a list element is greater than the width of the screen the element is cut:

    $element = substr( $element, 0, $allowed_length - 3 ) . '...';

=back

=cut