Day 31 brought my December Adventure to a close for another year. I spent much of the day trying to work out how to write up day 30’s plptools-focused AI experiment (about which I remain deeply conflicted), and reflecting on the past month of adventuring. I also managed to squeeze in a last couple of tasks: enabling Doxygen builds for plptools, and designing and printing a holder for 2 AA batteries (a must when daily-driving my two favorite writing devices—a Psion, or Pomera DM30).

Since I’ve a fair few thoughts about where to take everything I’ve worked on in my adventures, I’ll cover these in a follow-up post.

Doxygen

In plptools, the current group of maintainers have inherited a C++ codebase that’s very much of its era, making it hard to follow at times. With a view to helping us (and newcomers) understand what’s going on, I’d like to encourage a gradual process of adding documentation (especially class-level documentation) to the project. To help with this, I added a simple Doxygen configuration to the project and set up documentation builds in our CI.

You can view the (sparse) documentation here.

Battery Holder

There’s a myriad designs for AA battery holders out there, but I couldn’t find any simple screw-cap tubes—something that would fit in a pencil case—so I designed my own:

I’d like to update the design to add a rubber o-ring to help the screw lid to stay closed and give it a water-tight seal but, so far, I’m pretty pleased with the design. I plan to publish the STL files in the coming days.