http://www.perlmonks.org?node_id=95350


in reply to Re: Commenting, was: Inline POD vs. EOF POD
in thread Inline POD vs. EOF POD

I'm not going to say that the perl source is a good example!

You can use naming conventions to include the actions related to vars/functions. Like translate_buffer_to_normalized_image. Well, names get pretty long but are self-explaining. And such names can give info about pre/post conditions...