Is there better (or more complete) documentation for the Java software?
This is being prepared. At the meantime, there are several self explanatory examples, from which you can learn almost anything that you need to start building queries and programs against the HHDB. Start with a simple tweaking of existing example, and we can assure you that you will be able to use the full power of the software in no time.