From 974c8434e9288d8eb4a0004a77b67b6b2a451b70 Mon Sep 17 00:00:00 2001
From: David Tolnay <dtolnay@gmail.com>
Date: Wed, 19 Apr 2017 10:42:15 -0700
Subject: [PATCH] Add example of Error::Message

---
 serde_test/Cargo.toml   |  4 ++++
 serde_test/src/error.rs | 41 ++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 44 insertions(+), 1 deletion(-)

diff --git a/serde_test/Cargo.toml b/serde_test/Cargo.toml
index 7f1c2602..d1ed3f84 100644
--- a/serde_test/Cargo.toml
+++ b/serde_test/Cargo.toml
@@ -15,5 +15,9 @@ publish = false # this branch contains breaking changes
 [dependencies]
 serde = { version = "0.9", path = "../serde" }
 
+[dev-dependencies]
+serde = { version = "0.9", path = "../serde", features = ["rc"] }
+serde_derive = { version = "0.9", path = "../serde_derive" }
+
 [badges]
 travis-ci = { repository = "serde-rs/serde" }
diff --git a/serde_test/src/error.rs b/serde_test/src/error.rs
index 034a019a..91cfabfa 100644
--- a/serde_test/src/error.rs
+++ b/serde_test/src/error.rs
@@ -13,10 +13,49 @@ use serde::{ser, de};
 
 use token::Token;
 
-/// Error returned by the test `Serializer` and `Deserializer`.
+/// Error expected in `assert_ser_tokens_error` and `assert_de_tokens_error`.
 #[derive(Clone, PartialEq, Debug)]
 pub enum Error {
     /// A custom error.
+    ///
+    /// ```rust
+    /// # #[macro_use]
+    /// # extern crate serde_derive;
+    /// #
+    /// # extern crate serde_test;
+    /// #
+    /// # fn main() {
+    /// use std::sync::{Arc, Mutex};
+    /// use std::thread;
+    ///
+    /// use serde_test::{assert_ser_tokens_error, Token, Error};
+    ///
+    /// #[derive(Serialize)]
+    /// struct Example {
+    ///     lock: Arc<Mutex<u32>>,
+    /// }
+    ///
+    /// let example = Example { lock: Arc::new(Mutex::new(0)) };
+    /// let lock = example.lock.clone();
+    ///
+    /// let _ = thread::spawn(move || {
+    ///     // This thread will acquire the mutex first, unwrapping the result
+    ///     // of `lock` because the lock has not been poisoned.
+    ///     let _guard = lock.lock().unwrap();
+    ///
+    ///     // This panic while holding the lock (`_guard` is in scope) will
+    ///     // poison the mutex.
+    ///     panic!()
+    /// }).join();
+    ///
+    /// let expected = &[
+    ///     Token::Struct("Example", 1),
+    ///     Token::Str("lock"),
+    /// ];
+    /// let error = Error::Message("lock poison error while serializing".to_owned());
+    /// assert_ser_tokens_error(&example, expected, error);
+    /// # }
+    /// ```
     Message(String),
 
     /// `Deserialize` was expecting a struct of one name, and another was found.