One of the nice things about writing documentation in pod (which can then be processed by perldoc) is there is a program that will check the syntax of your pod for you.
podchecker myprogram.pl will check your pod and let you know of any formatting problems with you pod - this is a very good way to make sure your perldoc stays well formatted! Enjoy, Ted -- Ted Pedersen http://www.d.umn.edu/~tpederse

