diff --git a/system/doc/reference_manual/expressions.md b/system/doc/reference_manual/expressions.md
index 4b6da265577c..9c4f8056f0b2 100644
--- a/system/doc/reference_manual/expressions.md
+++ b/system/doc/reference_manual/expressions.md
@@ -1683,6 +1683,10 @@ More examples are provided in [Programming Examples](`e:system:funs.md`).
 catch Expr
 ```
 
+> #### Warning {: .warning }
+>
+> The `catch` expression is deprecated. Use [`try`](expressions.md#try) instead.
+
 Returns the value of `Expr` unless an exception is raised during the evaluation. In
 that case, the exception is caught. The return value depends on the class of the
 exception: