diff --git a/src/lib.rs b/src/lib.rs
index b8b807a8..67bf5a0f 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -275,6 +275,9 @@ pub fn min<T: Ord>(a: T, b: T) -> T {
 }
 
 /// The absolute value of `a`.
+///
+/// Deprecated: Use [Matrix::abs] or [Real::abs] instead.
+#[deprecated(note = "use `Matrix::abs` or `Real::abs` instead")]
 #[inline]
 pub fn abs<T: Signed>(a: &T) -> T {
     a.abs()