LPS-31740 javadoc

Re-sending the pull request https://github.com/jhinkey/liferay-portal/pull/23 as @jhinkey requested.

Thanks,
Josef