machinekit/machinekit — pull request #400 by luminize (2014-12-21 20:55:22+00:00)
Title: docs: changes for easier collaboration and better view ability 

Regarding better documentation #100

- changed .txt files to .asciidoc for better viewing in github portal
- this makes it easy with collaborating workflow via the github portal
- now generated docs from components are available

I have made a script to make `.asciidoc` files when the components are made during a full build. These `.asciidoc` files will end up in the documentation `/docs/src/hal/` and its subdirectories. Very easy to get at least basic documentation even on a BeagleBone for example (but not tested yet).

This will ensure that components that are updated (also documentation section in .comp file) will end up in more up-to-date `.asciidoc` files. The components documentation is now easy to find outside the manpages (which were not easy to find and refer to).

All these `.asciidoc` files we can later on use to gather the info in a more searchable way, and perhaps better generation of `.html` files without the bulky latex dependencies when building documentation.