Improve header generation when using --api flag

* Add support for the @alias tag.
* Include parameters for functions as well as methods.
Add tests for 09380b67
Merge pull request #122 from hughsk/api-context

Improve header generation when using --api flag