The javadoc @return tag is used for this purpose.

We were on a project where the client insisted on Javadoc comments for every public class and method.

Part of my OOAD project grades -- given weekly -- were based upon their javadoc comments and their code style.