My emacs+doxymacs doing it semi-automatic - I dont know how, but hope these tags @param will show flyhelp at mouse pointer when moving over params. Eclipse doing that but not emacs currently. Its all that I need. Often forgot parameters description and orders.

But agree often documentation older than code. Its very fast older and add many noise.