http://www.perlmonks.org?node_id=307572

mandog has asked for the wisdom of the Perl Monks concerning the following question:

Some folks in my group favor comments in this style:

#--------------------------------------------------------- # Function: get_records (taken from process_member.pl) # Arguments: DB handle # sql query string # Returns: result array of SQL query #--------------------------------------------------------- sub get_records { my ( $db_handle_ref, $sql ) = @_; my @recs; # [...] return @recs; }

I have doubts about this style. Perhaps there is some advantage I am missing ?