diff --git a/reference/pthreads/threaded/lock.xml b/reference/pthreads/threaded/lock.xml
index de83d5f9dd..5ff82e2119 100644
--- a/reference/pthreads/threaded/lock.xml
+++ b/reference/pthreads/threaded/lock.xml
@@ -10,7 +10,8 @@
  <refsynopsisdiv>
   <warning>
    <para>
-    This method has been removed in pthreads v3.
+    This method has been removed in pthreads v3. The
+    <methodname>Threaded::synchronized</methodname> method should now be used.
    </para>
   </warning>
  </refsynopsisdiv>
diff --git a/reference/pthreads/threaded/unlock.xml b/reference/pthreads/threaded/unlock.xml
index e3d49df834..31e42fc793 100644
--- a/reference/pthreads/threaded/unlock.xml
+++ b/reference/pthreads/threaded/unlock.xml
@@ -10,7 +10,8 @@
  <refsynopsisdiv>
   <warning>
    <para>
-    This method has been removed in pthreads v3.
+    This method has been removed in pthreads v3. The
+    <methodname>Threaded::synchronized</methodname> method should now be used.
    </para>
   </warning>
  </refsynopsisdiv>