in reply to Recommended subroutine documentation style
Maybe not quite POD, but you might want to look at this and this for some ideas.
Have Fun.