refactor parameter names to match Java coding styles, add Javadoc