javadoc cleanup after review

apps/routerconsole/java/src/net/i2p/router/web/PluginUpdateChecker.java

@@ -17,18 +17,13 @@ import net.i2p.util.PartialEepGet;
 import net.i2p.util.VersionComparator;
 
 /**
- * Download and install a plugin.
+ * Check for an updated version of a plugin.
  * A plugin is a standard .sud file with a 40-byte signature,
  * a 16-byte version, and a .zip file.
- * Unlike for router updates, we need not have the public key
- * for the signature in advance.
  *
- * The zip file must have a standard directory layout, with
- * a plugin.config file at the top level.
- * The config file contains properties for the package name, version,
- * signing public key, and other settings.
- * The zip file will typically contain a webapps/ or lib/ dir,
- * and a webapps.config and/or clients.config file.
+ * So we get the current version and update URL for the installed plugin,
+ * then fetch the first 56 bytes of the URL, extract the version,
+ * and compare.
  *
  * @since 0.7.12
  * @author zzz

apps/routerconsole/java/src/net/i2p/router/web/WebAppConfiguration.java

@@ -16,7 +16,7 @@ import org.mortbay.jetty.servlet.WebApplicationContext;
  *  individual jars and not lib/*.jar specified in wrapper.config.
  *
  *  A sample line in webapps.config is:
- *     webapps.appname.path=foo.jar,$I2P/lib/bar.jar
+ *     webapps.appname.classpath=foo.jar,$I2P/lib/bar.jar
  *  Unless $I2P is specified the path will be relative to $I2P/lib for
  *  webapps in the installation and appDir/plugins/appname/lib for plugins.
  *

apps/routerconsole/java/src/net/i2p/router/web/WebAppStarter.java

@@ -15,13 +15,14 @@ import org.mortbay.jetty.servlet.WebApplicationContext;
 
 
 /**
- *  Start a webappapp classpath as specified in webapps.config.
+ *  Add, start or stop a webapp.
+ *  Add to the webapp classpath if specified in webapps.config.
  *
  *  Sadly, setting Class-Path in MANIFEST.MF doesn't work for jetty wars.
- *  We could look there ourselves, or look for another properties file in the war,
+ *  See WebAppConfiguration for more information.
  *  but let's just do it in webapps.config.
  *
- *  No, wac.addClassPath() does not work.
+ *  No, wac.addClassPath() does not work. For more info see:
  *
  *  http://servlets.com/archive/servlet/ReadMsg?msgId=511113&listName=jetty-support
  *