LPS-43747 javadoc

Hi Eduardo, (cc'ing @codyhoag)
I've reviewed and edited the TemplateHandler Javadoc.I've still to review the PortletDisplayTemplateUtil Javadoc. But I thought you might want to take at look at the TemplateHandler changes in the meantime.

Thanks,
Jim