Ok... blow by blow ;-)

" you are not suppose to be reading the POD while you are reading the code"

But I am suppost to document while coding

It's hard enough to keep the POD current with the code

I know.. that's why you shouldn't over-use it :-)

I'll leave it intact, thank you. ;)

Be brave! Drop tradition! hehe..

BTW: Are you sure the second one looks better? Must be a matter of taste? ;-)