The source code for Jatalog is available on GitHub.

I originally published the article below on CodeProject in July 2016. I’ve been meaning to republish it on my personal blog for completeness, but haven’t come around to doing it until now.

CHIP-8 is an ancient¹ virtual machine specification² to write very simple cross platform games.

Writing a CHIP-8 interpreter is a bit of a rite of passage for hackers, so naturally I had to write my own.

In this article I present an AWK script I’ve been using for quite some time to create HTML documentation from the headers in my source code.

The script fulfils a similar role as tools like Javadoc and Doxygen, but is not as powerful.

The simplicity comes with some advantages though: AWK is widely available, so I can include the script with my source code and be sure that it will just work. Also, the input (and the output) tends to be simpler, which is ideal for the smaller hobby projects I’ve been spending my time on.

Over the years I’ve found myself looking at Tcl, and wondering what the fuss was about. Then I came across one of John Ousterhout’s articles in the Dr Dobb’s Journal and as I read through it, I was suddenly enlightened. Tcl is actually a very smart little language.