diff --git a/src/error.rs b/src/error.rs
index f9fe511..0e482e6 100644
--- a/src/error.rs
+++ b/src/error.rs
@@ -88,15 +88,16 @@
         }
     }
 
-    /// Creates an error which spans the items provided with the specified
-    /// message.
+    /// Creates an error with the specified message spanning the given syntax
+    /// tree node.
     ///
-    /// Unlike the `new` constructor this constructors takes a spanned item (the
-    /// first argument here). This allows the `Error` returned to attempt to
-    /// ensure it spans all the tokens inside of `tokens`. While you typically
-    /// can use the `Spanned` trait with the above `new` constructor
-    /// implementation limitations today mean that this constructor may provide
-    /// a higher-quality error message on stable Rust.
+    /// Unlike the `Error::new` constructor, this constructor takes an argument
+    /// `tokens` which is a syntax tree node. This allows the resulting `Error`
+    /// to attempt to span all tokens inside of `tokens`. While you would
+    /// typically be able to use the `Spanned` trait with the above `Error::new`
+    /// constructor, implementation limitations today mean that
+    /// `Error::new_spanned` may provide a higher-quality error message on
+    /// stable Rust.
     ///
     /// When in doubt it's recommended to stick to `Error::new` (or
     /// `ParseStream::error`)!