Generated Documentation

[hughsaunders]

As a user I would like up to date documentation that is in synch with the code so that I can use-bash lib without having to refer to the code unless I want to.

As a developer I would like documentation to be generated from comments so that I can modify librarires and their documentation in a single location.