in reply to flower box comments

The commenting style your group uses is not bad, it states the purpose of the subroutine clearly. And it would not be hard to write a parser to extract documentations from the code either.

Just a side note on the code shown -
return @recs;
Won't it be more efficient if return reference instead?
return \@recs;