Adds support for @deprecated

This PR fixes two issues:

1. `@deprecated` can optionally have text associated with it. It was previously throwing an error if there was any text.

2. There tag does not show in the output.  If `@deprecated` is found, **Deprecated:** [blah] is now in the output.

Tests were updated as well