- Several cleanups, translations

- got rid of pdf_get_info() which was ancient


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@32114 c90b9560-bf6c-de11-be94-00142212c4b1

functions/pdf.xml

@@ -398,38 +398,6 @@ fclose($fp);
    </sect1>
   </partintro>
 
-  <refentry id="function.pdf-get-info">
-   <refnamediv>
-    <refname>pdf_get_info</refname>
-    <refpurpose>Returns an empty info structure for a pdf document</refpurpose>
-   </refnamediv>
-   <refsect1>
-    <title>Description</title>
-    <funcsynopsis>
-     <funcprototype>
-      <funcdef>info <function>pdf_get_info</function></funcdef>
-      <paramdef>string <parameter>filename</parameter></paramdef>
-     </funcprototype>
-    </funcsynopsis>
-    <para>
-     The <function>pdf_get_info</function> function returns an
-     empty info structure for the pdf document. It should be filled
-     with appropriate information like the author, subject etc. of
-     the document.
-
-    <note><simpara>
-     This functions is not available if pdflib 2.x support is activated.
-    </simpara></note></para>
-
-    <para>
-     See also <function>pdf_set_info_creator</function>,
-              <function>pdf_set_info_author</function>,
-              <function>pdf_set_info_keywords</function>,
-              <function>pdf_set_info_title</function>,
-              <function>pdf_set_info_subject</function>.</para>
-   </refsect1>
-  </refentry>
-
   <refentry id="function.pdf-set-info">
    <refnamediv>
     <refname>pdf_set_info</refname>
@@ -493,31 +461,23 @@ pdf_close($pdfdoc);
      <funcprototype>
       <funcdef>int <function>pdf_open</function></funcdef>
       <paramdef>int <parameter>file</parameter></paramdef>
-      <paramdef>int <parameter>info</parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
      The <function>pdf_open</function> function opens
      a new pdf document. The corresponding file has to be opened
      with <function>fopen</function> and the file descriptor passed
-     as argument <parameter>file</parameter>. <parameter>info</parameter>
-     is the info structure that has to be created with
-     <function>pdf_get_info</function>. The info structure will be deleted
-     within this function.
-
+     as argument <parameter>file</parameter>.
+     If you do not pass any parameters, the document will be created in memory
+     and outputed page by page either to stdout or to the web browser.
     <note><simpara>
      The return value is needed as the first parameter in all other
      functions writing to the pdf document.
     </simpara></note>
 
-    <note><simpara>
-     This function does not allow the second parameter if pdflib 2.0 support
-     is activated.
-    </simpara></note></para>
-
+    </para>
     <para>
      See also <function>fopen</function>,
-              <function>pdf_get_info</function>,
               <function>pdf_close</function>.</para>
 
    </refsect1>
@@ -538,21 +498,7 @@ pdf_close($pdfdoc);
     </funcsynopsis>
     <para>
      The <function>pdf_close</function> function closes the pdf document.
-
-    <note><simpara>Due to an unclean implementation of the pdflib 0.6 the
-     internal closing of the document also closes the file. This should
-     not be done because pdflib did not open the file, but expects an
-     already open file when <function>pdf_open</function> is called.
-     Consequently it shouldn't close the file. In order to fix this
-     just take out line 190 of the file p_basic.c in the pdflib 0.6
-     source distribution until the next release of pdflib will fix
-     this.
-    </simpara></note>
-
-    <note><simpara>
-     This function works properly without any patches to pdflib if 
-     pdflib 2.0 support is activated.
-    </simpara></note></para>
+    </para>
 
     <para>
      See also <function>pdf_open</function>,
@@ -581,7 +527,7 @@ pdf_close($pdfdoc);
      page with height <parameter>height</parameter> and width
      <parameter>width</parameter>. In order to create a valid
      document you must call this function and
-     <function>pdf_end_page</function>.</para>
+     <function>pdf_end_page</function> at least once.</para>
 
     <para>
      See also <function>pdf_end_page</function>.</para>
@@ -628,11 +574,12 @@ pdf_close($pdfdoc);
     </funcsynopsis>
     <para>
      The <function>pdf_show</function> function outputs the
-     string <parameter>text</parameter> at the current position
+     string <parameter>text</parameter> at the current text position
      using the current font.</para>
 
     <para>
      See also <function>pdf_show_xy</function>,
+              <function>pdf_show_boxed</function>,
               <function>pdf_set_text_pos</function>,
               <function>pdf_set_font</function>.</para>
 
@@ -702,7 +649,8 @@ pdf_close($pdfdoc);
      (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>).</para>
 
     <para>
-     See also <function>pdf_show</function>.</para>
+     See also <function>pdf_show</function>,
+              <function>pdf_show_boxed</function>.</para>
 
    </refsect1>
   </refentry>