docs(lib): fix rustdoc warnings

src/header/common/accept.rs

@@ -12,7 +12,8 @@ header! {
     /// in-line image
     ///
     /// # ABNF
-    /// ```plain
+    ///
+    /// ```text
     /// Accept = #( media-range [ accept-params ] )
     ///
     /// media-range    = ( "*/*"
@@ -40,6 +41,7 @@ header! {
     ///     ])
     /// );
     /// ```
+    ///
     /// ```
     /// use hyper::header::{Headers, Accept, qitem};
     /// use hyper::mime;

src/header/common/accept_charset.rs

@@ -12,7 +12,8 @@ header! {
     /// those charsets.
     ///
     /// # ABNF
-    /// ```plain
+    ///
+    /// ```text
     /// Accept-Charset = 1#( ( charset / "*" ) [ weight ] )
     /// ```
     ///

src/header/common/accept_encoding.rs

@@ -11,7 +11,8 @@ header! {
     /// preferred.
     ///
     /// # ABNF
-    /// ```plain
+    ///
+    /// ```text
     /// Accept-Encoding  = #( codings [ weight ] )
     /// codings          = content-coding / "identity" / "*"
     /// ```

src/header/common/accept_language.rs

@@ -10,7 +10,8 @@ header! {
     /// response.
     ///
     /// # ABNF
-    /// ```plain
+    ///
+    /// ```text
     /// Accept-Language = 1#( language-range [ weight ] )
     /// language-range  = <language-range, see [RFC4647], Section 2.1>
     /// ```
@@ -20,6 +21,7 @@ header! {
     /// * `en-us;q=1.0, en;q=0.5, fr`
     ///
     /// # Examples
+    ///
     /// ```
     /// use hyper::header::{Headers, AcceptLanguage, LanguageTag, qitem};
     ///
@@ -33,6 +35,7 @@ header! {
     ///     ])
     /// );
     /// ```
+    ///
     /// ```
     /// # extern crate hyper;
     /// # #[macro_use] extern crate language_tags;

src/header/common/accept_ranges.rs

@@ -9,7 +9,8 @@ header! {
     /// supports range requests for the target resource.
     ///
     /// # ABNF
-    /// ```plain
+    ///
+    /// ```text
     /// Accept-Ranges     = acceptable-ranges
     /// acceptable-ranges = 1#range-unit / \"none\"
     ///
@@ -26,12 +27,14 @@ header! {
     /// let mut headers = Headers::new();
     /// headers.set(AcceptRanges(vec![RangeUnit::Bytes]));
     /// ```
+    ///
     /// ```
     /// use hyper::header::{Headers, AcceptRanges, RangeUnit};
     ///
     /// let mut headers = Headers::new();
     /// headers.set(AcceptRanges(vec![RangeUnit::None]));
     /// ```
+    ///
     /// ```
     /// use hyper::header::{Headers, AcceptRanges, RangeUnit};
     ///
@@ -62,7 +65,8 @@ header! {
 /// representation's media type.
 ///
 /// # ABNF
-/// ```plain
+///
+/// ```text
 /// range-unit       = bytes-unit / other-range-unit
 /// bytes-unit       = "bytes"
 /// other-range-unit = token

src/header/common/access_control_allow_credentials.rs

@@ -13,7 +13,8 @@ use header::{Header, Raw};
 /// > match the following ABNF:
 ///
 /// # ABNF
-/// ```plain
+///
+/// ```text
 /// Access-Control-Allow-Credentials: "Access-Control-Allow-Credentials" ":" "true"
 /// ```
 ///
@@ -25,6 +26,7 @@ use header::{Header, Raw};
 /// * "true"
 ///
 /// # Examples
+///
 /// ```
 /// # extern crate hyper;
 /// # fn main() {

src/header/common/access_control_allow_headers.rs

@@ -9,14 +9,16 @@ header! {
     /// during the actual request.
     ///
     /// # ABNF
-    /// ```plain
+    ///
+    /// ```text
     /// Access-Control-Allow-Headers: "Access-Control-Allow-Headers" ":" #field-name
     /// ```
     ///
     /// # Example values
     /// * `accept-language, date`
     ///
     /// # Examples
+    ///
     /// ```
     /// # extern crate hyper;
     /// # extern crate unicase;
@@ -32,6 +34,7 @@ header! {
     /// );
     /// # }
     /// ```
+    ///
     /// ```
     /// # extern crate hyper;
     /// # extern crate unicase;

src/header/common/access_control_allow_methods.rs

@@ -9,14 +9,16 @@ header! {
     /// actual request.
     ///
     /// # ABNF
-    /// ```plain
+    ///
+    /// ```text
     /// Access-Control-Allow-Methods: "Access-Control-Allow-Methods" ":" #Method
     /// ```
     ///
     /// # Example values
     /// * `PUT, DELETE, XMODIFY`
     ///
     /// # Examples
+    ///
     /// ```
     /// use hyper::header::{Headers, AccessControlAllowMethods};
     /// use hyper::Method;
@@ -26,6 +28,7 @@ header! {
     ///     AccessControlAllowMethods(vec![Method::Get])
     /// );
     /// ```
+    ///
     /// ```
     /// use hyper::header::{Headers, AccessControlAllowMethods};
     /// use hyper::Method;

src/header/common/access_control_allow_origin.rs

@@ -8,10 +8,11 @@ use header::{Header, Raw};
 ///
 /// The `Access-Control-Allow-Origin` header indicates whether a resource
 /// can be shared based by returning the value of the Origin request header,
-/// "*", or "null" in the response.
+/// `*`, or `null` in the response.
 ///
 /// # ABNF
-/// ```plain
+///
+/// ```text
 /// Access-Control-Allow-Origin = "Access-Control-Allow-Origin" ":" origin-list-or-null | "*"
 /// ```
 ///

src/header/common/access_control_expose_headers.rs

@@ -8,14 +8,16 @@ header! {
     /// API of a CORS API specification.
     ///
     /// # ABNF
-    /// ```plain
+    ///
+    /// ```text
     /// Access-Control-Expose-Headers = "Access-Control-Expose-Headers" ":" #field-name
     /// ```
     ///
     /// # Example values
     /// * `ETag, Content-Length`
     ///
     /// # Examples
+    ///
     /// ```
     /// # extern crate hyper;
     /// # extern crate unicase;
@@ -34,6 +36,7 @@ header! {
     /// );
     /// # }
     /// ```
+    ///
     /// ```
     /// # extern crate hyper;
     /// # extern crate unicase;

src/header/common/access_control_max_age.rs

@@ -6,14 +6,17 @@ header! {
     /// preflight request can be cached in a preflight result cache.
     ///
     /// # ABNF
-    /// ```plain
+    ///
+    /// ```text
     /// Access-Control-Max-Age = \"Access-Control-Max-Age\" \":\" delta-seconds
     /// ```
     ///
     /// # Example values
+    ///
     /// * `531`
     ///
     /// # Examples
+    ///
     /// ```
     /// use hyper::header::{Headers, AccessControlMaxAge};
     ///

src/header/common/access_control_request_headers.rs

@@ -9,14 +9,16 @@ header! {
     /// during the actual request.
     ///
     /// # ABNF
-    /// ```plain
+    ///
+    /// ```text
     /// Access-Control-Allow-Headers: "Access-Control-Allow-Headers" ":" #field-name
     /// ```
     ///
     /// # Example values
     /// * `accept-language, date`
     ///
     /// # Examples
+    ///
     /// ```
     /// # extern crate hyper;
     /// # extern crate unicase;
@@ -32,6 +34,7 @@ header! {
     /// );
     /// # }
     /// ```
+    ///
     /// ```
     /// # extern crate hyper;
     /// # extern crate unicase;

src/header/common/access_control_request_method.rs

@@ -7,14 +7,16 @@ header! {
     /// The `Access-Control-Request-Method` header indicates which method will be
     /// used in the actual request as part of the preflight request.
     /// # ABNF
-    /// ```plain
+    ///
+    /// ```text
     /// Access-Control-Request-Method: \"Access-Control-Request-Method\" \":\" Method
     /// ```
     /// 
     /// # Example values
     /// * `GET`
     /// 
     /// # Examples
+    ///
     /// ```
     /// use hyper::header::{Headers, AccessControlRequestMethod};
     /// use hyper::Method;

src/header/common/allow.rs

@@ -9,7 +9,8 @@ header! {
     /// with the resource.
     ///
     /// # ABNF
-    /// ```plain
+    ///
+    /// ```text
     /// Allow = #method
     /// ```
     ///
@@ -19,6 +20,7 @@ header! {
     /// * ``
     ///
     /// # Examples
+    ///
     /// ```
     /// use hyper::header::{Headers, Allow};
     /// use hyper::Method;
@@ -28,6 +30,7 @@ header! {
     ///     Allow(vec![Method::Get])
     /// );
     /// ```
+    ///
     /// ```
     /// use hyper::header::{Headers, Allow};
     /// use hyper::Method;

src/header/common/authorization.rs

@@ -14,7 +14,8 @@ use header::{Header, Raw};
 /// agent for the realm of the resource being requested.
 ///
 /// # ABNF
-/// ```plain
+///
+/// ```text
 /// Authorization = credentials
 /// ```
 ///
@@ -23,6 +24,7 @@ use header::{Header, Raw};
 /// * `Bearer fpKL54jvWmEGVoRdCNjG`
 ///
 /// # Examples
+///
 /// ```
 /// use hyper::header::{Headers, Authorization};
 ///
@@ -42,6 +44,7 @@ use header::{Header, Raw};
 ///    )
 /// );
 /// ```
+///
 /// ```
 /// use hyper::header::{Headers, Authorization, Bearer};
 ///

src/header/common/cache_control.rs

@@ -11,12 +11,14 @@ use header::parsing::{from_comma_delimited, fmt_comma_delimited};
 /// not imply that the same directive is to be given in the response.
 ///
 /// # ABNF
-/// ```plain
+///
+/// ```text
 /// Cache-Control   = 1#cache-directive
 /// cache-directive = token [ "=" ( token / quoted-string ) ]
 /// ```
 ///
 /// # Example values
+///
 /// * `no-cache`
 /// * `private, community="UCI"`
 /// * `max-age=30`
@@ -30,6 +32,7 @@ use header::parsing::{from_comma_delimited, fmt_comma_delimited};
 ///     CacheControl(vec![CacheDirective::MaxAge(86400u32)])
 /// );
 /// ```
+///
 /// ```
 /// use hyper::header::{Headers, CacheControl, CacheDirective};
 ///

src/header/common/connection.rs

@@ -59,7 +59,8 @@ header! {
     /// message.
     ///
     /// # ABNF
-    /// ```plain
+    ///
+    /// ```text
     /// Connection        = 1#connection-option
     /// connection-option = token
     ///
@@ -70,12 +71,14 @@ header! {
     /// ```
     ///
     /// # Examples
+    ///
     /// ```
     /// use hyper::header::{Headers, Connection};
     ///
     /// let mut headers = Headers::new();
     /// headers.set(Connection::keep_alive());
     /// ```
+    ///
     /// ```
     /// # extern crate hyper;
     /// # extern crate unicase;