Actually, I think much better advice is to view this as a good reason to always use mixed case in your subroutine names!

When the "style" shifted from &sub() [Perl4] to just sub() [Perl5], I don't think the documentation and warnings caught up with the problems that resulted. There are probably some warnings that should be added, like you noted, and some advice that needs to be updated and strenthened in the docs.

        - tye (but my friends call me "Tye")