diff --git a/doc/src/sgml/pgfreespacemap.sgml b/doc/src/sgml/pgfreespacemap.sgml
index 51f772a397..4519a66a8d 100644
--- a/doc/src/sgml/pgfreespacemap.sgml
+++ b/doc/src/sgml/pgfreespacemap.sgml
@@ -65,10 +65,12 @@
    whether a page is full or empty.
   </para>
 
-  <para>
-   NOTE: The interface was changed in version 8.4, to reflect the new FSM
-   implementation introduced in the same version.
-  </para>
+  <note>
+   <para>
+    The interface was changed in version 8.4, to reflect the new FSM
+    implementation introduced in the same version.
+   </para>
+  </note>
  </sect2>
 
  <sect2>