I am presenting on YUI Doc tomorrow at YUIConf. This is an excellent language neutral tool for generating documentation from comments, I highly recommend you check it out.
I cover the tool, some pest practices, etc. I’ll post the video as soon as its available, but in the meantime I have create a project on github that shows you a simple example of using YUI Doc as part of your build.