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;

Replies are listed 'Best First'.
Re: Re: flower box comments
by chromatic (Archbishop) on Nov 18, 2003 at 03:43 UTC

    It also would not be hard* to write a parser to extract POD from the code.

    * In the sense that someone else has already done it. :)