diff --git a/docs.html b/docs.html
index e6800a53..7802f220 100644
--- a/docs.html
+++ b/docs.html
@@ -8918,6 +8918,10 @@ Conversion of a <i>mat</i> object into <i>colvec</i>, <i>rowvec</i> or <i>std::v
 </li>
 <br>
 <li>
+<b>Caveat:</b> to convert an expression that results in a 1x1 matrix to a pure scalar value, use <a href="#as_scalar">as_scalar()</a>
+</li>
+<br>
+<li>
 Examples:
 <ul>
 <pre>