helly Tue Nov 5 10:45:38 2002 EDT
Added files:
/phpdoc/en/reference/dba/functions dba-handlers.xml dba-list.xml
Modified files:
/phpdoc/en/reference/dba/functions dba-fetch.xml
/phpdoc/en/reference/dba reference.xml
Log:
Update to newly changes & additions
Index: phpdoc/en/reference/dba/functions/dba-fetch.xml
diff -u phpdoc/en/reference/dba/functions/dba-fetch.xml:1.3
phpdoc/en/reference/dba/functions/dba-fetch.xml:1.4
--- phpdoc/en/reference/dba/functions/dba-fetch.xml:1.3 Thu Apr 25 17:45:45 2002
+++ phpdoc/en/reference/dba/functions/dba-fetch.xml Tue Nov 5 10:45:37 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/dba.xml, last change in rev 1.2 -->
<refentry id="function.dba-fetch">
<refnamediv>
@@ -11,6 +11,7 @@
<methodsynopsis>
<type>string</type><methodname>dba_fetch</methodname>
<methodparam><type>string</type><parameter>key</parameter></methodparam>
+ <methodparam
+choice="opt"><type>int</type><parameter>skip</parameter></methodparam>
<methodparam><type>resource</type><parameter>handle</parameter></methodparam>
</methodsynopsis>
<para>
@@ -22,6 +23,11 @@
<parameter>Key</parameter> is the key the data is specified by.
</para>
<para>
+ <parameter>Skip</parameter> is the number of key-value pairs to
+ ignore when using cdb databases. This value is ignored for all other
+ databases which do not support multiple keys with the same name.
+ </para>
+ <para>
<parameter>Handle</parameter> is a database handle returned by
<function>dba_open</function>.
</para>
@@ -34,6 +40,14 @@
See also: <function>dba_exists</function>,
<function>dba_delete</function>, <function>dba_insert</function>,
and <function>dba_replace</function>.
+ </para>
+ <para>
+ <note>
+ <simpara>
+ The skip parameter is available since PHP 4.3 to support cdb's
+ capability of multiple keys having the same name.
+ </simpara>
+ </note>
</para>
</refsect1>
</refentry>
Index: phpdoc/en/reference/dba/reference.xml
diff -u phpdoc/en/reference/dba/reference.xml:1.3
phpdoc/en/reference/dba/reference.xml:1.4
--- phpdoc/en/reference/dba/reference.xml:1.3 Thu Apr 25 17:37:34 2002
+++ phpdoc/en/reference/dba/reference.xml Tue Nov 5 10:45:38 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
<reference id="ref.dba">
<title>Database (dbm-style) abstraction layer functions</title>
<titleabbrev>dba</titleabbrev>
@@ -91,7 +91,8 @@
Cdb is "a fast, reliable, lightweight package for creating and
reading constant databases." It is from the author of qmail and
can be found <ulink url="&url.cdb;">here</ulink>. Since it is
- constant, we support only reading operations.
+ constant, we support only reading operations. And since PHP4.3
+ we support writing (not updating) through the internal cdb library.
</entry>
</row>
@@ -104,7 +105,7 @@
<function>dba_popen</function> functions, one of the
handler names must be supplied as an argument. The actually
available list of handlers is displayed by invoking
- <function>phpinfo</function>.
+ <function>phpinfo</function> or <function>dba_handlers</function>.
</para>
</section>
@@ -172,6 +173,11 @@
<entry>
To enable support for cdb add
<option role="configure">--with-cdb[=DIR]</option>.
+ <note>
+ Since PHP 4.3 you can omit DIR to use the internal cdb library
+ that adds the cdb_make handler which allows creation of cdb files
+ and allows to access cdb files on the network using php's streams.
+ </note>
</entry>
</row>
Index: phpdoc/en/reference/dba/functions/dba-handlers.xml
+++ phpdoc/en/reference/dba/functions/dba-handlers.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- splitted from ./en/functions/dba.xml, last change in rev 1.2 -->
<refentry id="function.dba-handlers">
<refnamediv>
<refname>dba_handlers</refname>
<refpurpose>List handlers available</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>array</type><methodname>dba_handlers</methodname>
</methodsynopsis>
<para>
<function>dba_handlers</function> returns an array with all handlers
suppoerted by this extension.
</para>
<para>
When the internal cdb library is used you will see 'cdb' and 'cdb_make'.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
Index: phpdoc/en/reference/dba/functions/dba-list.xml
+++ phpdoc/en/reference/dba/functions/dba-list.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- splitted from ./en/functions/dba.xml, last change in rev 1.2 -->
<refentry id="function.dba-list">
<refnamediv>
<refname>dba_list</refname>
<refpurpose>List all open database files</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>array</type><methodname>dba_list</methodname>
</methodsynopsis>
<para>
<function>dba_list</function> returns an associative array with all
open databse files in the form resourceid=>filename.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
