LRDOCS-673 Javadoc

https://issues.liferay.com/browse/LRDOCS-673

I also added periods to the end of two sentence parameter descriptions, for consistency purposes.