initial javadoc mods...removed warnings from existing docs only.