> I'll take on the first item (check javadoc) for now if that's okay;
> it should help me get a better overview of the code.

ok.

> Are there any specific requests for the javadoc, other than making
> sure it's correct and complete?

Nothing that I know. Note, that not all packages come in to the
documentation, only those that are "public" to user.

Roman

P.S. Thanks for the fix. I will review and incorporate it into the sources
over the weekend. Therefore the JayBird 1.5.4 is delayed at least until next
weekend.