Javadoc updates

jetty-server/src/main/java/org/eclipse/jetty/server/SecureRequestCustomizer.java

@@ -177,12 +177,11 @@ public class SecureRequestCustomizer implements HttpConfiguration.Customizer
 
 
     /**
-     * <p>
      * Customizes the request attributes for general secure settings.
      * The default impl calls {@link Request#setSecure(boolean)} with true
      * and sets a response header if the Strict-Transport-Security options 
      * are set.
-     * </p>
+     * @param request the request being customized
      */
     protected void customizeSecure(Request request)
     {

jetty-server/src/main/java/org/eclipse/jetty/server/handler/ContextHandlerCollection.java

@@ -47,7 +47,7 @@ import org.eclipse.jetty.util.log.Logger;
 /** ContextHandlerCollection.
  *
  * This {@link org.eclipse.jetty.server.handler.HandlerCollection} is creates a
- * {@link org.eclipse.jetty.http.PathMap} to it's contained handlers based
+ * Map of contexts to it's contained handlers based
  * on the context path and virtual hosts of any contained {@link org.eclipse.jetty.server.handler.ContextHandler}s.
  * The contexts do not need to be directly contained, only children of the contained handlers.
  * Multiple contexts may have the same context path and they are called in order until one

jetty-servlet/src/main/java/org/eclipse/jetty/servlet/ServletMapping.java

@@ -69,8 +69,8 @@ public class ServletMapping
     
     /* ------------------------------------------------------------ */
     /** Test if the list of path specs contains a particular one.
-     * @param pathSpec
-     * @return
+     * @param pathSpec the test pathspec
+     * @return true if pathspec contains test spec
      */
     public boolean containsPathSpec (String pathSpec)
     {

jetty-websocket/websocket-common/src/main/java/org/eclipse/jetty/websocket/common/LogicalConnection.java

@@ -35,7 +35,7 @@ public interface LogicalConnection extends OutgoingFrames, SuspendToken
      * <p>
      * Basic usage: results in an non-blocking async write, then connection close.
      * 
-     * @see StatusCode
+     * @see org.eclipse.jetty.websocket.api.StatusCode
      * @see #close(int, String)
      */
     public void close();
@@ -49,7 +49,7 @@ public interface LogicalConnection extends OutgoingFrames, SuspendToken
      *            the status code
      * @param reason
      *            the (optional) reason. (can be null for no reason)
-     * @see StatusCode
+     * @see org.eclipse.jetty.websocket.api.StatusCode
      */
     public void close(int statusCode, String reason);
 

jetty-websocket/websocket-common/src/main/java/org/eclipse/jetty/websocket/common/scopes/WebSocketContainerScope.java

@@ -69,14 +69,14 @@ public interface WebSocketContainerScope
     /**
      * A Session has been opened
      * 
-     * @param the session that was opened
+     * @param session the session that was opened
      */
     public void onSessionOpened(WebSocketSession session);
     
     /**
      * A Session has been closed
      * 
-     * @param the session that was closed
+     * @param session the session that was closed
      */
     public void onSessionClosed(WebSocketSession session);