Ronni Grapenthin - Tools (he / him / his) email:

University of Alaska Fairbanks Geophysical Institute 2156 Koyukuk Drive Fairbanks, AK-99775

sh2doc.pl - Auto--document for (shell) scripts with special comments

A couple years ago I was looking for a tool that would allow to keep the documentation and source of shell scripts in one file. Tools like this are common for many high level languages (javadoc for Java, doxygen for C/C++, etc.). After having invested a lot of time in web-searches I found that nothing existed so I wrote sh2doc.pl. It's a Perl script that parses files in certain directories for special comments. It creates an HTML index file that lists all documented files and a brief description of the code (if given in source). It also creates one HTML detail page for each documented script which contains the full documentation given in the source. It's certainly not super fancy, but fulfills my needs. Improvements are welcome!

Sample output | Download: sh2doc.tar.gz | github: https://github.com/rgrapenthin/sh2doc