added the @param designations for the new inputs