From a41947cd7d6ea1786fe699bdb8c51737f9e239f4 Mon Sep 17 00:00:00 2001
From: David Lukes <dafydd.lukes@gmail.com>
Date: Sat, 10 Mar 2018 09:57:01 +0100
Subject: [PATCH] Enable doctests

Doctests were disabled globally because up until #2456, they were just
formatting examples which were not supposed to compile. Now that there
is one runnable doctest, I disabled the other ones individually (by
adding the ignore directive).

I also added some empty lines around the code blocks to avoid the
following warning and instead ignore the code blocks cleanly:

WARNING: ... Code block is not currently run as a test, but will in
future versions of rustdoc. Please ensure this code block is a runnable
test, or use the `ignore` directive.

See rust-lang/rust#28712 for further details.
---
 Cargo.toml    |  3 ---
 src/chains.rs | 14 ++++++++++----
 src/macros.rs |  9 ++++++---
 3 files changed, 16 insertions(+), 10 deletions(-)

diff --git a/Cargo.toml b/Cargo.toml
index 3be0c4ff7a8..4c4f7b450f5 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -10,9 +10,6 @@ license = "Apache-2.0/MIT"
 build = "build.rs"
 categories = ["development-tools"]
 
-[lib]
-doctest = false
-
 [[bin]]
 name = "rustfmt"
 path = "src/bin/main.rs"
diff --git a/src/chains.rs b/src/chains.rs
index 87100c7be41..de7b8334548 100644
--- a/src/chains.rs
+++ b/src/chains.rs
@@ -25,7 +25,8 @@
 //! E.g., `let foo = { aaaa; bbb; ccc }.bar.baz();`, we would layout for the
 //! following values of `chain_indent`:
 //! Block:
-//! ```
+//!
+//! ```ignore
 //! let foo = {
 //!     aaaa;
 //!     bbb;
@@ -33,8 +34,10 @@
 //! }.bar
 //!     .baz();
 //! ```
+//!
 //! Visual:
-//! ```
+//!
+//! ```ignore
 //! let foo = {
 //!               aaaa;
 //!               bbb;
@@ -47,13 +50,16 @@
 //! If the first item in the chain is a block expression, we align the dots with
 //! the braces.
 //! Block:
-//! ```
+//!
+//! ```ignore
 //! let a = foo.bar
 //!     .baz()
 //!     .qux
 //! ```
+//!
 //! Visual:
-//! ```
+//!
+//! ```ignore
 //! let a = foo.bar
 //!            .baz()
 //!            .qux
diff --git a/src/macros.rs b/src/macros.rs
index 6be6a1f2664..01eaa807d97 100644
--- a/src/macros.rs
+++ b/src/macros.rs
@@ -621,7 +621,8 @@ fn macro_style(mac: &ast::Mac, context: &RewriteContext) -> MacroStyle {
 
 /// Indent each line according to the specified `indent`.
 /// e.g.
-/// ```rust
+///
+/// ```rust,ignore
 /// foo!{
 /// x,
 /// y,
@@ -632,8 +633,10 @@ fn macro_style(mac: &ast::Mac, context: &RewriteContext) -> MacroStyle {
 /// ),
 /// }
 /// ```
+///
 /// will become
-/// ```rust
+///
+/// ```rust,ignore
 /// foo!{
 ///     x,
 ///     y,
@@ -864,7 +867,7 @@ impl MacroBranch {
 ///
 /// # Expected syntax
 ///
-/// ```
+/// ```ignore
 /// lazy_static! {
 ///     [pub] static ref NAME_1: TYPE_1 = EXPR_1;
 ///     [pub] static ref NAME_2: TYPE_2 = EXPR_2;