style(headers): use regular doc-comments inside macros

A bug (rust-lang/rust#23812) in rustc prevented the use of normal
comments inside macros but this has been fixed.

src/header/common/transfer_encoding.rs

@@ -1,34 +1,34 @@
 use header::Encoding;
 
 header! {
-    #[doc="`Transfer-Encoding` header, defined in"]
-    #[doc="[RFC7230](http://tools.ietf.org/html/rfc7230#section-3.3.1)"]
-    #[doc=""]
-    #[doc="The `Transfer-Encoding` header field lists the transfer coding names"]
-    #[doc="corresponding to the sequence of transfer codings that have been (or"]
-    #[doc="will be) applied to the payload body in order to form the message"]
-    #[doc="body."]
-    #[doc=""]
-    #[doc="# ABNF"]
-    #[doc="```plain"]
-    #[doc="Transfer-Encoding = 1#transfer-coding"]
-    #[doc="```"]
-    #[doc=""]
-    #[doc="# Example values"]
-    #[doc="* `gzip, chunked`"]
-    #[doc=""]
-    #[doc="# Example"]
-    #[doc="```"]
-    #[doc="use hyper::header::{Headers, TransferEncoding, Encoding};"]
-    #[doc=""]
-    #[doc="let mut headers = Headers::new();"]
-    #[doc="headers.set("]
-    #[doc="    TransferEncoding(vec!["]
-    #[doc="        Encoding::Gzip,"]
-    #[doc="        Encoding::Chunked,"]
-    #[doc="    ])"]
-    #[doc=");"]
-    #[doc="```"]
+    /// `Transfer-Encoding` header, defined in
+    /// [RFC7230](http://tools.ietf.org/html/rfc7230#section-3.3.1)
+    /// 
+    /// The `Transfer-Encoding` header field lists the transfer coding names
+    /// corresponding to the sequence of transfer codings that have been (or
+    /// will be) applied to the payload body in order to form the message
+    /// body.
+    /// 
+    /// # ABNF
+    /// ```plain
+    /// Transfer-Encoding = 1#transfer-coding
+    /// ```
+    /// 
+    /// # Example values
+    /// * `gzip, chunked`
+    /// 
+    /// # Example
+    /// ```
+    /// use hyper::header::{Headers, TransferEncoding, Encoding};
+    /// 
+    /// let mut headers = Headers::new();
+    /// headers.set(
+    ///     TransferEncoding(vec![
+    ///         Encoding::Gzip,
+    ///         Encoding::Chunked,
+    ///     ])
+    /// );
+    /// ```
     (TransferEncoding, "Transfer-Encoding") => (Encoding)+
 
     transfer_encoding {