diff --git a/SWIG/Doc/engineering.html b/SWIG/Doc/engineering.html
index a1ef03639..411bf1f8e 100644
--- a/SWIG/Doc/engineering.html
+++ b/SWIG/Doc/engineering.html
@@ -414,7 +414,6 @@ There are three different concepts of "module" involved, defined separately
 for SWIG, Guile, and Libtool.  To avoid horrible confusion, we explicitly
 prefix the context, e.g., "guile-module".
 
-
 <h3>Linkage</h3>
 
 <p>
@@ -486,6 +485,17 @@ user's foo.i.  At this time, we must say:
 
 in foo.i.  This may change in the future.
 
+<h3>Smobs</h3>
+
+<p>
+For pointer types, SWIG can use Guile smobs if given the command-line option
+"-with-smobs".  Ultimately this will be the default (and only) behavior and
+the command-line option will no longer be supported.  Ideally, "-with-smobs"
+will not even make it to beta.
+
+<p>
+[insert smob implementation overview here (Matthias Koeppe?)]
+
 <h2>11. Miscellaneous </h2>
 
 <ul>