more javadocs, still more to do. couple additions to the TODO list
more additions to the TODO list