diff --git a/functions/pdf.xml b/functions/pdf.xml
index 8e1545ab35..c2d9c6d795 100644
--- a/functions/pdf.xml
+++ b/functions/pdf.xml
@@ -33,6 +33,11 @@
     advise to consult the release notes of the used version of pdflib
     for possible changes.
    </simpara>
+   <simpara>
+     Any version of PHP4 after March, 9th 2000 do not support versions
+     of pdflib older than 3.0. PHP3 on the other hand should not be used
+     with version newer than 2.01.
+   </simpara>
    <simpara>
     Please consult the excellent documentation for
     pdflib shipped with the source distribution of pdflib.
@@ -618,8 +623,8 @@ fclose($fp);
     <funcsynopsis>
      <funcdef>void <function>pdf_begin_page</function></funcdef>
      <paramdef>int <parameter>pdf document</parameter></paramdef>
-     <paramdef>double <parameter>height</parameter></paramdef>
      <paramdef>double <parameter>width</parameter></paramdef>
+     <paramdef>double <parameter>height</parameter></paramdef>
     </funcsynopsis>
     <para>
      The <function>PDF_begin_page</function> function starts a new