(with the rationale that it would say only /** Returns the canonical name. */) if a typical reader may have no idea what the term “canonical name” means! 7.3.2 Exception: overrides Javadoc is not always

so cheap that you normally wouldn’t bother caching its return value when calling it in a loop. A canonical example is an inline method that just returns one of the class’s member variables. class MyClass