I agree with your point, comments easily grow out of date, but I see competing tools like doxygen or javadoc being used. Do you have any experience with those?

I personally hate them because of the amount of noisy fluff they bring.