Working on #46
Closes #46.

The perl script to auto-gen the API docs is half-baked and needs some work.
However, I may need to rethink my whole approach to documentation and consider an alternative formatting that would be easier to process.
For now, the docs are ok enough to close the issue.