javadocs

Some javadoc updates.  Also has README changes to the top level and java.  I took out brower and java specific stuff from the README, so I'm expecting we should put corresponding stuff into the browser readme (and node too)