General javadoc style: sentences should end with a dot and @param don't need the dash