Merge pull request dtolnay#146 from dtolnay/doctest

Enable testing of documentation examples

Author: dtolnay

.travis.yml

@@ -3,7 +3,11 @@ sudo: false
 
 matrix:
   include:
-    - rust: 1.15.0
+    - rust: 1.15.0 # oldest supported version
+      script: cargo build
+    - rust: 1.19.0 # first release with the --tests flag
+      script: cargo test --tests
+    - rust: 1.26.0 # first release on which our doc tests pass
     - rust: stable
     - rust: beta
     - rust: nightly

Cargo.toml

@@ -15,16 +15,16 @@ option, off by default, to also reimplement itself in terms of the upstream
 unstable API.
 """
 
-[lib]
-doctest = false
-
 [package.metadata.docs.rs]
 rustc-args = ["--cfg", "procmacro2_semver_exempt"]
 rustdoc-args = ["--cfg", "procmacro2_semver_exempt"]
 
 [dependencies]
 unicode-xid = "0.1"
 
+[dev-dependencies]
+quote = "0.6"
+
 [features]
 # When enabled: act as a shim around the nightly compiler's proc_macro crate.
 # This requires a nightly compiler.
@@ -38,3 +38,11 @@ default = ["proc-macro"]
 
 [badges]
 travis-ci = { repository = "alexcrichton/proc-macro2" }
+
+[patch.crates-io]
+# Our doc tests depend on quote which depends on proc-macro2. Without this line,
+# the proc-macro2 dependency of quote would be the released version of
+# proc-macro2. Quote would implement its traits for types from that proc-macro2,
+# meaning impls would be missing when tested against types from the local
+# proc-macro2.
+proc-macro2 = { path = "." }