Rod Waldhoff's Weblog  

< Tuesday, 8 April 2003 >
Jason Horman's WikiDoclet #
Found a link to WikiDoclet on Erik Thauvin's weblog. This is a custom doclet that allows one to write JavaDoc comments with TWiki-style markup rather than HTML markup. For example, one could write:
/**
 * First Para.
 *
 * Second Para.
 *    * bullet one
 *       * _sub_ bullet
 *    * bullet two
 */
instead of:
/**
 * First Para.
 * <p />
 * Second Para.
 * <ul>
 *   <li>
 *    bullet one
 *    <ul>
 *     <li><i>sub</i> bullet</li>
 *    </ul>
 *   </li>
 *   <li>bullet two</li>
 * </ul>
 */

Neat, huh? Wish I'd thought of that.

I haven't tried it yet, but it seems like a really useful tool for those who find that HTML formatting within JavaDoc comments interrupts the flow of coding.

Great Zaurus Software #
My wife bought me a Sharp Zaurus for my birthday back in January, and I love it as much as James seems to love his new PowerBook. I've noticed that there are a few Zaurus bloggers around, so perhaps you'll find this interesting.

I've had to do a hard reboot a few times (most my fault, not the Zaurus's) and hence reinstall any apps that aren't included in Sharp's ROM. As a result I've whittled down my list of applications a number of times. Here (in no particular order) are the apps that make the cut:

embeddedkonsole
What's the point of having a linux box in your pocket if you can't get a console window? The Sharp supplied CD has a workable terminal application, but embeddedkonsole adds some neat features, notably support for multiple, tab navigated consoles.

MinIDE
A solid text editor, built with Java. To be honest I haven't tried many alternative editors on the Zaurus, but this sure beats the basic Text Editor or vi through the console. Calling it an IDE isn't too much of a stretch, you can invoke a compiler (any compiler) directly from the editor.

Opie-Reader
Opie-Reader is an "e-text" reader, which renders various compressed text formats. Using JPluck or something like it, you can copy web sites into a local .pdb archive and copy them over to your Zaurus for viewing with Opie-Reader.

Tiny Scheme
A Zaurus port of Tiny Scheme. A Scheme interpreter, interactive terminal and help files on your Zaurus. I've been using this to work through the exercises in Structure and Interpretation of Computer Programs, and my "computer lab" is significantly smaller than the book itself.

IQNotes
A great outline/tree editor, with an XML file format. A pretty good example of palmtop HCI design, in my opinion.

Java Compiler
Grab the classes.zip archive from a JDK 1.1 release and you can run your favorite Java tools (javac, jar, javap, etc.) via the Jeode EVM. (I've heard rumors of folks getting Kopi or Jikes running on the Zaurus as well, but I've never tried it personally. I'm unable to find any definitive links, but if you google you can find some hints.)

XSLT Support
There may be better ways to do this, but one easy way to get XSLT transform support on the Zaurus is to grab James Clark's XP xml parser and XT xslt processor. I've got stylesheets that transform various IQNotes generated documents into HTML reports (which I can then view right on the Zaurus with Opera). If anyone has had success getting a more modern XSLT system up and running on the Zaurus, I'd love to hear about it. I expect one could grab some C tools to do the job.

SSH
ssh or scp to or from your Zaurus. Very handy way to transfer files, or to have a big (remote) console and keyboard for editing files that are on the Zaurus.

See the Zaurus Software Index for a comprehensive directory of Zaurus software.

On a related note, I recently bought some compact flash cards and a desktop compact flash reader/writer with the intention of trying out Open Zaurus, but I haven't had a chance to install it yet.