Re: Ways of commenting subroutines

[busunsl]

Most of the time I just use a one-liner for commenting subs.

I try to adhere to the following rules:

Use a self-explaining name for the sub, this will also explain the return value(s).
Use self-explaining names for the parameters, they are pulled in at the top of the sub, so they are seen immediately.
For subs used outside of the modules use pod.