[PHP-DOC] cvs: phpdoc /en/reference/paradox/functions px-create-fp.xml

[Uwe Steinmann]

steinm          Wed Feb  8 06:34:10 2006 UTC

  Modified files:              
    /phpdoc/en/reference/paradox/functions      px-create-fp.xml 
  Log:
  - added note that this function may issue a warning if the tablename
    isn't set
  - use none deprecated functions on example
  
  
http://cvs.php.net/viewcvs.cgi/phpdoc/en/reference/paradox/functions/px-create-fp.xml?r1=1.3&r2=1.4&diff_format=u
Index: phpdoc/en/reference/paradox/functions/px-create-fp.xml
diff -u phpdoc/en/reference/paradox/functions/px-create-fp.xml:1.3 
phpdoc/en/reference/paradox/functions/px-create-fp.xml:1.4
--- phpdoc/en/reference/paradox/functions/px-create-fp.xml:1.3  Mon Jun 20 
08:12:15 2005
+++ phpdoc/en/reference/paradox/functions/px-create-fp.xml      Wed Feb  8 
06:34:10 2006
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/paradox.xml, last change in rev  -->
 <refentry id="function.px-create-fp">
  <refnamediv>
@@ -20,16 +20,22 @@
    with <function>fopen</function>. Make sure the file is writable. The first
    parameter is the return value of <function>px_new</function>.
    <option>fielddesc</option> is an array containing one element for each
-   field containing its specification. Each field specification is an array
+   field specification. A field specification is an array
    itself with either two or three elements.The first element is always a
    string value used as the name of the field. It may not be larger than ten
    characters. The second element contains the field type which is one of the
    constants listed in the table
    <link linkend="paradox.table-fieldtypes">Constants for field types</link>.
-   In the case of a character field, you will have to provide a third element
-   specifying the length of the field.
+   In the case of a character field or bcd field, you will have to provide a
+   third element
+   specifying the length respectively the precesion of the field.
   </para>
   <note>
+   <para>Calling this functions issues a warning about an empty tablename which
+    can be savely ignored. Just set the tablename afterwards with
+    <function>px_set_parameter</function>.</para>
+  </note>
+  <note>
    <para>This function is highly experimental, due to insufficient
     documentation of the paradox file format. Database files created with this
     function can be opened by <function>px_open_fp</function> and has been
@@ -61,7 +67,7 @@
 if(!px_create_fp($pxdoc, $fp, $fields)) {
   /* Error handling */
 }
-px_set_tablename($pxdoc, "testtable");
+px_set_parameter($pxdoc, "tablename", "testtable");
 for($i=-50; $i<50; $i++) {
   $rec = array($i, -$i);
   px_put_record($pxdoc, $rec);