diff --git a/docs.html b/docs.html
index 1b0b94cf..10c1e157 100644
--- a/docs.html
+++ b/docs.html
@@ -13219,9 +13219,17 @@ the divide-and-conquer method provides slightly different results than the stand
-Caveat: to find approximate solutions (eg. minimum norm, least squares) to underdetermined, overdetermined, or rank deficient systems of linear equations,
+Caveats:
+
+-
+to find approximate solutions to underdetermined, overdetermined, or rank deficient systems of linear equations,
using solve() can be considerably faster and/or more accurate
+-
+if the given matrix A is square-sized and seldom rank deficient, using inv() or inv_sympd() with the
inv_opts::allow_approx option is faster
+
+
+
Examples: