Javadoc Inheritance and {@inheritDoc}

Ever wondered how to reconcile the way eclipse, javadoc and verification tools like checkstyle or PMD/CPD handle the validation of javadoc entries?

Use the tag {@inheritDoc} as in the example below:

public class DefaultRouteBuilder extends RouteBuilder {

	/** {@inheritDoc}
	 */
	@Override
	public void configure() throws Exception {
		// TODO Auto-generated method stub
	}

}

This will make all tools happy and will show whatever documentation the interface provides. This guy puts out a good explanation together with all alternatives, pros end cons.