Clarify correct specification of dependency on serde (#525)

Closes #494

Cargo.toml

@@ -52,7 +52,7 @@ time = "0.1.42"
 
 [dev-dependencies]
 env_logger = "0.6"
-serde_derive = "1.0"
+serde = { version = "1.0", features = ["derive"] }
 tokio-tcp = "0.1"
 libflate = "0.1"
 doc-comment = "0.3"

examples/async_multiple_requests.rs

@@ -4,11 +4,11 @@ extern crate futures;
 extern crate reqwest;
 extern crate tokio;
 extern crate serde;
-#[macro_use] extern crate serde_derive;
 extern crate serde_json;
 
 use futures::Future;
 use reqwest::async::{Client, Response};
+use serde::Deserialize;
 
 #[derive(Deserialize, Debug)]
 struct Slideshow {

examples/json_typed.rs

@@ -4,9 +4,11 @@
 //! Rust compile-time type system guaranties though it requires a little bit
 //! more code.
 extern crate reqwest;
-#[macro_use] extern crate serde_derive;
+extern crate serde;
 extern crate serde_json;
 
+use serde::{Deserialize, Serialize};
+
 #[derive(Debug, Serialize, Deserialize)]
 struct Post {
     id: Option<i32>,

src/async_impl/request.rs

@@ -428,6 +428,7 @@ pub(crate) fn replace_headers(dst: &mut HeaderMap, src: HeaderMap) {
 mod tests {
     use super::Client;
     use std::collections::BTreeMap;
+    use serde::Serialize;
 
     #[test]
     fn add_query_append() {

src/error.rs

@@ -9,10 +9,11 @@ use {StatusCode, Url};
 /// # Examples
 ///
 /// ```
-/// #[macro_use]
-/// extern crate serde_derive;
+/// extern crate serde;
 /// extern crate reqwest;
 ///
+/// use serde::Deserialize;
+///
 /// #[derive(Deserialize)]
 /// struct Simple {
 ///    key: String

src/lib.rs

@@ -193,9 +193,6 @@ extern crate mime_guess;
 #[cfg(feature = "default-tls")]
 extern crate native_tls;
 extern crate serde;
-#[cfg(test)]
-#[macro_use]
-extern crate serde_derive;
 extern crate serde_json;
 extern crate serde_urlencoded;
 extern crate time;

src/request.rs

@@ -582,6 +582,7 @@ mod tests {
     use {body, Client, Method};
     use header::{ACCEPT, HOST, HeaderMap, HeaderValue, CONTENT_TYPE};
     use std::collections::{BTreeMap, HashMap};
+    use serde::Serialize;
     use serde_json;
     use serde_urlencoded;
 

src/response.rs

@@ -186,9 +186,10 @@ impl Response {
     ///
     /// ```rust
     /// # extern crate reqwest;
-    /// # #[macro_use] extern crate serde_derive;
+    /// # extern crate serde;
     /// #
     /// # use reqwest::Error;
+    /// # use serde::Deserialize;
     /// #
     /// #[derive(Deserialize)]
     /// struct Ip {