/*
 * Copyright 2012 The Netty Project
 *
 * The Netty Project licenses this file to you under the Apache License,
 * version 2.0 (the "License"); you may not use this file except in compliance
 * with the License. You may obtain a copy of the License at:
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations
 * under the License.
 */
package io.netty.handler.codec.http;


/**
 * An HTTP request.
 *
 * <h3>Accessing Query Parameters and Cookie</h3>
 * <p>
 * Unlike the Servlet API, a query string is constructed and decomposed by
 * {@link QueryStringEncoder} and {@link QueryStringDecoder}.  {@link Cookie}
 * support is also provided separately via {@link CookieDecoder}, {@link ClientCookieEncoder},
 * and {@link @ServerCookieEncoder}.
 *
 * @see HttpResponse
 * @see ClientCookieEncoder
 * @see ServerCookieEncoder
 * @see CookieDecoder
 */
public interface HttpRequest extends HttpMessage {

    /**
     * Returns the method of this request.
     */
    HttpMethod getMethod();

    /**
     * Sets the method of this request.
     */
    void setMethod(HttpMethod method);

    /**
     * Returns the URI (or path) of this request.
     */
    String getUri();

    /**
     * Sets the URI (or path) of this request.
     */
    void setUri(String uri);
}

@@ -1213,26 +1213,109 @@
   * 
-Returns the m
+Gets the %7B@link HttpMethod%7D of this %7B@link HttpRequest%7D.%0A     *%0A     * @return The %7B@link HttpM
 ethod
+%7D
  of 
@@ -1315,32 +1315,43 @@
 od%7D of this 
-r
+%7B@link HttpR
 equest
-.
+%7D
 %0A     */%0A   
@@ -1400,22 +1400,34 @@
 ets the 
-m
+%7B@link HttpM
 ethod
+%7D
  of this
@@ -1423,33 +1423,96 @@
 od%7D of this 
-r
+%7B@link HttpR
 equest
+%7D
 .%0A
+     *%0A     * @param The %7B@link HttpMethod%7D to set%0A
      */%0A    
@@ -1566,49 +1566,99 @@
   * 
-R
+G
 et
-urn
 s the 
-URI (or path) of this
+requested URI (or alternatively, path)%0A     *%0A     * @return The URI being
  request
 .%0A  
@@ -1645,33 +1645,34 @@
 RI being request
-.
+ed
 %0A     */%0A    Str
@@ -1722,29 +1722,92 @@
 (or 
-path) of this
+alternatively, path) being requested.%0A     *%0A     * @param uri The URI being
  request
 .%0A  
@@ -1802,17 +1802,18 @@
  request
-.
+ed
 %0A     */

Make HttpRequest's documentation easier to read