I know this is nitpicking. In Perl documentation comments should be before the function. They're not Python docstrings.