diff --git a/src/lib.rs b/src/lib.rs
index 2907da822..eec5da83a 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -252,6 +252,13 @@ impl Url {
     /// # }
     /// # run().unwrap();
     /// ```
+    /// 
+    /// # Errors
+    ///
+    /// If the function can not parse an absolute URL from the given string,
+    /// a [`ParseError`] variant will be returned.
+    ///
+    /// [`ParseError`]: enum.ParseError.html
     #[inline]
     pub fn parse(input: &str) -> Result<Url, ::ParseError> {
         Url::options().parse(input)