You might also look into Doxygen, which seems to be popular for all sorts of programming languages, particularly for inline parseable comments a la Javadoc.

Chris
M-x auto-bs-mode