LPS-42068 javadocs for some important methods in portal-impl