added more javadoc.  A few tests still on the to-do list...