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.
This commit is contained in:
Pyfisch
2015-10-27 19:19:05 +01:00
parent d16ef6d9d4
commit 4c756a9304
33 changed files with 1209 additions and 1209 deletions

View File

@@ -1,22 +1,22 @@
header! {
#[doc="`From` header, defined in [RFC7231](http://tools.ietf.org/html/rfc7231#section-5.5.1)"]
#[doc=""]
#[doc="The `From` header field contains an Internet email address for a"]
#[doc="human user who controls the requesting user agent. The address ought"]
#[doc="to be machine-usable."]
#[doc="# ABNF"]
#[doc="```plain"]
#[doc="From = mailbox"]
#[doc="mailbox = <mailbox, see [RFC5322], Section 3.4>"]
#[doc="```"]
#[doc=""]
#[doc="# Example"]
#[doc="```"]
#[doc="use hyper::header::{Headers, From};"]
#[doc=""]
#[doc="let mut headers = Headers::new();"]
#[doc="headers.set(From(\"webmaster@example.org\".to_owned()));"]
#[doc="```"]
/// `From` header, defined in [RFC7231](http://tools.ietf.org/html/rfc7231#section-5.5.1)
///
/// The `From` header field contains an Internet email address for a
/// human user who controls the requesting user agent. The address ought
/// to be machine-usable.
/// # ABNF
/// ```plain
/// From = mailbox
/// mailbox = <mailbox, see [RFC5322], Section 3.4>
/// ```
///
/// # Example
/// ```
/// use hyper::header::{Headers, From};
///
/// let mut headers = Headers::new();
/// headers.set(From("webmaster@example.org".to_owned()));
/// ```
// FIXME: Maybe use mailbox?
(From, "From") => [String]