diff --git a/build/boost/doc/example/reference.cpp b/build/boost/doc/example/reference.cpp
index 6dc62b7..1fb520c 100644
--- a/build/boost/doc/example/reference.cpp
+++ b/build/boost/doc/example/reference.cpp
@@ -96,7 +96,7 @@ class base
 
 struct name : base, mock::object // equivalent to using MOCK_BASE_CLASS
 {
-    typedef base base_type;      // this is required for MOCK_METHOD to work when not using MOCK_BASE_CLASS
+    typedef base base_type;      // this is required for the shortest form of MOCK_METHOD to work when not using MOCK_BASE_CLASS
 };
 //]
 }
diff --git a/build/boost/doc/reference.qbk b/build/boost/doc/reference.qbk
index e125015..104154b 100644
--- a/build/boost/doc/reference.qbk
+++ b/build/boost/doc/reference.qbk
@@ -42,6 +42,8 @@ Synopsis :
  MOCK_CLASS( name )            // defines a class
  MOCK_BASE_CLASS( name, base ) // defines a class deriving from a base class
 
+The preferred form for defining a mock class is with using MOCK_CLASS and MOCK_BASE_CLASS, however using a regular struct or class is also perfectly fine.
+
 Example :
 
 [class_example_1]
@@ -58,8 +60,6 @@ Example :
 
 [class_example_4]
 
-The preferred form for defining a mock class is with using MOCK_CLASS and MOCK_BASE_CLASS, however equivalent alternatives exist without the macros.
-
 Example :
 
 [class_example_5]