updated documentation

Function documentation now Javadoc style