in reply to Re^3: Easily catalog subroutines with a synopsis commentin thread Easily catalog subroutines with a synopsis comment
I agree, if you document all your subroutines as you describe, the synopsis line is redundant.