diff --git a/doc/Xserver-spec.xml b/doc/Xserver-spec.xml
index 7736cb292..8be223e07 100644
--- a/doc/Xserver-spec.xml
+++ b/doc/Xserver-spec.xml
@@ -3057,6 +3057,9 @@ must deallocate the PixmapRec and all attached devPrivate blocks.
 If successful, it returns TRUE.
 See Xserver/fb/fbpixmap.c for the sample server implementation.</para>
 <para>
+Consumers should never ever call that proc directly, but call dixDestroyPixmap() instead.
+</para>
+<para>
 <blockquote><programlisting>
 
 	Bool