# foo: reasonably general description of what foo does
sub foo {
    my $detailed_parameter_variable_name = shift;
    my $another_detailed_parameter_variable_name = shift;
    my $return_value_ref = {}; #hash of values to return
   ...
    return $return_value_ref;
}