Anyone who has ever opened up GCC4TI or TIGCC will probably be familiar with this little snippet of 68k C:

// Delete or comment out the items you do not need.
#define COMMENT_STRING         "Place your comment here."
#define COMMENT_PROGRAM_NAME   "Place your program name here."
#define COMMENT_VERSION_STRING "Place your version string here."
#define COMMENT_VERSION_NUMBER 0,0,0,0 /* major, minor, revision, subrevision */
#define COMMENT_AUTHORS        "Place your author name(s) here."

I always fill these out when I create new projects, but recently I wondered: why am I bothering? I knew of no programs that could actually display this information: were there any? I would bet that most remaining 68k developers probably don't bother either.

After a few IRC conversations in #ti with Lionel, I learned that these "program comments" (as I always have referred to them) were part of the dextrefi specification designed by Kevin Kofler and others back in 2002. The idea was to store metadata in a data extension header for shells to be able to access and display. However, very few 68k file managers have ever implemented this specification.

My original idea was to add it to Memory Usage (which already sort of contains a file browser of its own). However, I realized that the small diagnostic program I had created to make sure I was accessing program comments correctly was worthy of it's own release.

And so that is why I am posting about "Comments", a simple little utility that, if passed the name of an assembly program as a command line argument, will check if that assembly program has a data extenison header, and if it does display associated metadata. Here are some screenshots of it running on itself:

It's available from Cemetech and has been uploaded to
This sounds very nice, this actually gives those comments a reason Smile
Though I dont have a 68K calc XD
Released version 0.2- this is just a minor update that adds some more explicit error messages. Now, comments will tell you if the file you point it at doesn't exist, or does exist but isn't an assembly program (and therefore contains no program metadata).

This is stuff I added while merging comments with Memory Usage, so it's not a coincidence I'm updating both at the same time.
Register to Join the Conversation
Have your own thoughts to add to this or any other topic? Want to ask a question, offer a suggestion, share your own programs and projects, upload a file to the file archives, get help with calculator and computer programming, or simply chat with like-minded coders and tech and calculator enthusiasts via the site-wide AJAX SAX widget? Registration for a free Cemetech account only takes a minute.

» Go to Registration page
Page 1 of 1
» All times are UTC - 5 Hours
You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum