update comments
Test the public API for synonyms and long/short options
Fix typo in docstrings