more review comment fixes
- repaired broken spec tests from option parsing change
- edits to yard docs