documenting the new option parsing code