documenting internal parsing method