adding return details to internal parsing method documentation