Archive for December, 2011

A short story about source code comments

A bug was reported in Tetzle, and the reporter helpfully tracked down why it was happening but was not sure what the purpose of the offending code was. I took a look at the code and said, “Beats the hell outta me!” I’m lazy, so of course it was not commented. I traced it through git all of the way to the very first release, and then had to track down my ancient notes about what the purpose was (it turns out Tetzle crashes if you delete the image of the current game, so it was preventing that but not clearing it on launch — kind of obvious, really). I fixed the code and added comments so that I would know what the purpose of that code is if I ever wonder in the future. The moral of the story is: comment your damn code, you’ll need it someday. Of course, I doubt I will be diligent about that, since I’ve run into this exact same situation before. :-P

Minor FocusWriter update

I’ve made a new release of FocusWriter, version 1.3.5.1, primarily to fix a data loss bug. The bug occurred when opening a file created by other RTF word processors that used multi-byte hex values, which FocusWriter did not handle properly. Also in this release is a Dutch translation, thanks to Robert Borst. Enjoy!

Follow

Get every new post delivered to your Inbox.