minor javadoc updates

Author: ombre42

src/main/java/org/robotframework/remoteserver/RemoteServer.java

@@ -35,6 +35,8 @@
 /**
  * Remote server for Robot Framework implemented in Java. Takes one or more test
  * libraries and exposes their methods via XML-RPC using an embedded web server.
+ * To use a different web server, use
+ * {@link org.robotframework.remoteserver.servlet.RemoteServerServlet} instead.
  * 
  * @see <a
  *      href="https://github.com/ombre42/jrobotremoteserver/wiki">jrobotremoteserver
@@ -122,6 +124,12 @@ public void setHost(String hostName) {
         connector.setHost(hostName);
     }
 
+    /**
+     * Main method for command line usage.
+     * 
+     * @param args
+     * @throws Exception
+     */
     public static void main(String[] args) throws Exception {
         configureLogging();
         CommandLineHelper helper = new CommandLineHelper(args);
@@ -257,9 +265,8 @@ public void addLibrary(Class<?> clazz, int port) {
 
     /**
      * A non-blocking method for stopping the remote server that allows requests
-     * to complete within the given timeout before shutting down the server.
-     * This method exists to allow stopping the server remotely. New connections
-     * will not be accepted after calling this.
+     * to complete within the given timeout before shutting down the server. New
+     * connections will not be accepted after calling this.
      * 
      * @param timeoutMS
      *            the milliseconds to wait for existing request to complete

src/main/java/org/robotframework/remoteserver/servlet/RemoteServerServlet.java

@@ -39,7 +39,10 @@
 import org.robotframework.remoteserver.xmlrpc.TypeFactory;
 
 /**
- * This servlet uses the same instance of a test library to process all requests
+ * This servlet can be used with servlet containers such as GlassFish,
+ * WebSphere, Tiny Java Web Server, etc. The paths for the library mapping are
+ * relative to the servlet path. When a remote stop is performed,
+ * <code>System.exit(0)</code> is executed.
  */
 public class RemoteServerServlet extends XmlRpcServlet implements RemoteServerContext {
     private static final long serialVersionUID = -7981676271855172976L;
@@ -108,7 +111,7 @@ public void doPost(HttpServletRequest req, HttpServletResponse resp) throws Serv
          * when the client is Jython 2.5.x (old xmlrpclib using HTTP/1.0), the
          * server's sockets got stuck in FIN_WAIT_2 for some time, eventually
          * hitting the limit of open sockets on some Windows systems. adding
-         * this header gets Jetty to close the socket.
+         * this header gets the web server to close the socket.
          */
         String path = req.getPathInfo() == null ? req.getServletPath() : req.getPathInfo();
         path = cleanPath(path);