didou Sun Jan 14 03:48:41 2007 UTC
Modified files:
/phpdoc/en language-snippets.ent
/phpdoc/en/reference/dbm reference.xml
/phpdoc/en/reference/dbm/functions dblist.xml dbmclose.xml
dbmdelete.xml dbmexists.xml
dbmfetch.xml dbmfirstkey.xml
dbminsert.xml dbmnextkey.xml
dbmopen.xml dbmreplace.xml
Log:
dbm: switch to new docstyle
# And encourage people to use PDO instead of DBA as a replacement ;)
http://cvs.php.net/viewvc.cgi/phpdoc/en/language-snippets.ent?r1=1.180&r2=1.181&diff_format=u
Index: phpdoc/en/language-snippets.ent
diff -u phpdoc/en/language-snippets.ent:1.180
phpdoc/en/language-snippets.ent:1.181
--- phpdoc/en/language-snippets.ent:1.180 Sun Jan 14 03:15:21 2007
+++ phpdoc/en/language-snippets.ent Sun Jan 14 03:48:41 2007
@@ -1,4 +1,4 @@
-<!-- $Revision: 1.180 $ -->
+<!-- $Revision: 1.181 $ -->
<!-- Keep 'em sorted -->
@@ -239,6 +239,12 @@
own font identifiers registered with <function>imageloadfont</function>.
</para></listitem></varlistentry>'>
+<!-- DBM notes -->
+
+<!ENTITY dbm.dbm-identifier.description '<varlistentry><term><parameter>
+dbm_identifier</parameter></term><listitem><para>The DBM link identifier,
+returned by <function>dbmopen</function>.</para></listitem></varlistentry>'>
+
<!-- Date and time entities -->
<!ENTITY date.timezone.errors.description '<para>
Every call to a date/time function will generate a
<constant>E_NOTICE</constant>
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/dbm/reference.xml?r1=1.12&r2=1.13&diff_format=u
Index: phpdoc/en/reference/dbm/reference.xml
diff -u phpdoc/en/reference/dbm/reference.xml:1.12
phpdoc/en/reference/dbm/reference.xml:1.13
--- phpdoc/en/reference/dbm/reference.xml:1.12 Sat Sep 9 19:28:30 2006
+++ phpdoc/en/reference/dbm/reference.xml Sun Jan 14 03:48:41 2007
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.12 $ -->
+<!-- $Revision: 1.13 $ -->
<!-- State: deprecated -->
<reference id="ref.dbm">
@@ -19,15 +19,14 @@
</para>
<note>
<para>
- However, dbm support is deprecated and you are encouraged to use the
- <link linkend="ref.dba">Database (dbm-style) abstraction layer
functions</link>
- instead.
+ DBM support is deprecated and you are encouraged to use the
+ <link linkend="ref.pdo">PHP Data Objects</link> extension instead.
</para>
</note>
<note>
<para>
This extension has been removed from PHP and is no longer available as
- of PHP 5.0.0.
+ of PHP 5.0.0.
</para>
</note>
</section>
@@ -86,7 +85,7 @@
</example>
</para>
</section>
- </partintro>
+ </partintro>
&reference.dbm.functions;
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/dbm/functions/dblist.xml?r1=1.5&r2=1.6&diff_format=u
Index: phpdoc/en/reference/dbm/functions/dblist.xml
diff -u phpdoc/en/reference/dbm/functions/dblist.xml:1.5
phpdoc/en/reference/dbm/functions/dblist.xml:1.6
--- phpdoc/en/reference/dbm/functions/dblist.xml:1.5 Sun Jan 14 03:20:22 2007
+++ phpdoc/en/reference/dbm/functions/dblist.xml Sun Jan 14 03:48:41 2007
@@ -1,17 +1,23 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
<refentry id="function.dblist">
<refnamediv>
<refname>dblist</refname>
<refpurpose>Describes the DBM-compatible library being used</refpurpose>
</refnamediv>
- <refsect1>
- <title>Description</title>
+ <refsect1 role="description">
+ &reftitle.description;
<methodsynopsis>
<type>string</type><methodname>dblist</methodname>
<void/>
</methodsynopsis>
<para>
+ Describes the GDBM version.
+ </para>
+ </refsect1>
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
<example>
<title>Getting the information on the command line</title>
<programlisting role="shell">
@@ -23,6 +29,12 @@
</example>
</para>
</refsect1>
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ Returns a string describing the GDBM version.
+ </para>
+ </refsect1>
</refentry>
<!-- Keep this comment at the end of the file
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/dbm/functions/dbmclose.xml?r1=1.4&r2=1.5&diff_format=u
Index: phpdoc/en/reference/dbm/functions/dbmclose.xml
diff -u phpdoc/en/reference/dbm/functions/dbmclose.xml:1.4
phpdoc/en/reference/dbm/functions/dbmclose.xml:1.5
--- phpdoc/en/reference/dbm/functions/dbmclose.xml:1.4 Sun Jan 14 03:20:22 2007
+++ phpdoc/en/reference/dbm/functions/dbmclose.xml Sun Jan 14 03:48:41 2007
@@ -1,12 +1,12 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
<refentry id="function.dbmclose">
<refnamediv>
<refname>dbmclose</refname>
<refpurpose>Closes a dbm database</refpurpose>
</refnamediv>
- <refsect1>
- <title>Description</title>
+ <refsect1 role="description">
+ &reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>dbmclose</methodname>
<methodparam><type>resource</type><parameter>dbm_identifier</parameter></methodparam>
@@ -15,6 +15,28 @@
Unlocks and closes the specified database.
</para>
</refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ &dbm.dbm-identifier.description;
+ </variablelist>
+ </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ &return.success;
+ </para>
+ </refsect1>
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>dbmopen</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
</refentry>
<!-- Keep this comment at the end of the file
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/dbm/functions/dbmdelete.xml?r1=1.4&r2=1.5&diff_format=u
Index: phpdoc/en/reference/dbm/functions/dbmdelete.xml
diff -u phpdoc/en/reference/dbm/functions/dbmdelete.xml:1.4
phpdoc/en/reference/dbm/functions/dbmdelete.xml:1.5
--- phpdoc/en/reference/dbm/functions/dbmdelete.xml:1.4 Sun Jan 14 03:20:22 2007
+++ phpdoc/en/reference/dbm/functions/dbmdelete.xml Sun Jan 14 03:48:41 2007
@@ -1,12 +1,12 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
<refentry id="function.dbmdelete">
<refnamediv>
<refname>dbmdelete</refname>
<refpurpose>Deletes the value for a key from a DBM database</refpurpose>
</refnamediv>
- <refsect1>
- <title>Description</title>
+ <refsect1 role="description">
+ &reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>dbmdelete</methodname>
<methodparam><type>resource</type><parameter>dbm_identifier</parameter></methodparam>
@@ -15,10 +15,38 @@
<para>
Deletes the value for <parameter>key</parameter> in the database.
</para>
+ </refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ &dbm.dbm-identifier.description;
+ <varlistentry>
+ <term><parameter>key</parameter></term>
+ <listitem>
+ <para>
+ The key, as a string
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
<para>
+ &return.success;
Returns &false; if the key didn't exist in the database.
</para>
</refsect1>
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>dbminsert</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
</refentry>
<!-- Keep this comment at the end of the file
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/dbm/functions/dbmexists.xml?r1=1.4&r2=1.5&diff_format=u
Index: phpdoc/en/reference/dbm/functions/dbmexists.xml
diff -u phpdoc/en/reference/dbm/functions/dbmexists.xml:1.4
phpdoc/en/reference/dbm/functions/dbmexists.xml:1.5
--- phpdoc/en/reference/dbm/functions/dbmexists.xml:1.4 Sun Jan 14 03:20:22 2007
+++ phpdoc/en/reference/dbm/functions/dbmexists.xml Sun Jan 14 03:48:41 2007
@@ -1,12 +1,12 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
<refentry id="function.dbmexists">
<refnamediv>
<refname>dbmexists</refname>
<refpurpose>Tells if a value exists for a key in a DBM database</refpurpose>
</refnamediv>
- <refsect1>
- <title>Description</title>
+ <refsect1 role="description">
+ &reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>dbmexists</methodname>
<methodparam><type>resource</type><parameter>dbm_identifier</parameter></methodparam>
@@ -17,6 +17,36 @@
<parameter>key</parameter>.
</para>
</refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ &dbm.dbm-identifier.description;
+ <varlistentry>
+ <term><parameter>key</parameter></term>
+ <listitem>
+ <para>
+ The key, as a string
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ &return.success;
+ </para>
+ </refsect1>
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>dbmfetch</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
</refentry>
<!-- Keep this comment at the end of the file
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/dbm/functions/dbmfetch.xml?r1=1.4&r2=1.5&diff_format=u
Index: phpdoc/en/reference/dbm/functions/dbmfetch.xml
diff -u phpdoc/en/reference/dbm/functions/dbmfetch.xml:1.4
phpdoc/en/reference/dbm/functions/dbmfetch.xml:1.5
--- phpdoc/en/reference/dbm/functions/dbmfetch.xml:1.4 Sun Jan 14 03:20:22 2007
+++ phpdoc/en/reference/dbm/functions/dbmfetch.xml Sun Jan 14 03:48:41 2007
@@ -1,18 +1,40 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
<refentry id="function.dbmfetch">
<refnamediv>
<refname>dbmfetch</refname>
<refpurpose>Fetches a value for a key from a DBM database</refpurpose>
</refnamediv>
- <refsect1>
- <title>Description</title>
+ <refsect1 role="description">
+ &reftitle.description;
<methodsynopsis>
<type>string</type><methodname>dbmfetch</methodname>
<methodparam><type>resource</type><parameter>dbm_identifier</parameter></methodparam>
<methodparam><type>string</type><parameter>key</parameter></methodparam>
</methodsynopsis>
<para>
+ Gets the value associated with the given <parameter>key</parameter>.
+ </para>
+ </refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ &dbm.dbm-identifier.description;
+ <varlistentry>
+ <term><parameter>key</parameter></term>
+ <listitem>
+ <para>
+ The key, as a string
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
Returns the value associated with <parameter>key</parameter>.
</para>
</refsect1>
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/dbm/functions/dbmfirstkey.xml?r1=1.4&r2=1.5&diff_format=u
Index: phpdoc/en/reference/dbm/functions/dbmfirstkey.xml
diff -u phpdoc/en/reference/dbm/functions/dbmfirstkey.xml:1.4
phpdoc/en/reference/dbm/functions/dbmfirstkey.xml:1.5
--- phpdoc/en/reference/dbm/functions/dbmfirstkey.xml:1.4 Sun Jan 14
03:20:22 2007
+++ phpdoc/en/reference/dbm/functions/dbmfirstkey.xml Sun Jan 14 03:48:41 2007
@@ -1,12 +1,12 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
<refentry id="function.dbmfirstkey">
<refnamediv>
<refname>dbmfirstkey</refname>
<refpurpose>Retrieves the first key from a DBM database</refpurpose>
</refnamediv>
- <refsect1>
- <title>Description</title>
+ <refsect1 role="description">
+ &reftitle.description;
<methodsynopsis>
<type>string</type><methodname>dbmfirstkey</methodname>
<methodparam><type>resource</type><parameter>dbm_identifier</parameter></methodparam>
@@ -17,6 +17,28 @@
which doesn't guarantee any ordering.
</para>
</refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ &dbm.dbm-identifier.description;
+ </variablelist>
+ </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ &return.success;
+ </para>
+ </refsect1>
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>dbmnextkey</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
</refentry>
<!-- Keep this comment at the end of the file
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/dbm/functions/dbminsert.xml?r1=1.4&r2=1.5&diff_format=u
Index: phpdoc/en/reference/dbm/functions/dbminsert.xml
diff -u phpdoc/en/reference/dbm/functions/dbminsert.xml:1.4
phpdoc/en/reference/dbm/functions/dbminsert.xml:1.5
--- phpdoc/en/reference/dbm/functions/dbminsert.xml:1.4 Sun Jan 14 03:20:22 2007
+++ phpdoc/en/reference/dbm/functions/dbminsert.xml Sun Jan 14 03:48:41 2007
@@ -1,12 +1,12 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
<refentry id="function.dbminsert">
<refnamediv>
<refname>dbminsert</refname>
<refpurpose>Inserts a value for a key in a DBM database</refpurpose>
</refnamediv>
- <refsect1>
- <title>Description</title>
+ <refsect1 role="description">
+ &reftitle.description;
<methodsynopsis>
<type>int</type><methodname>dbminsert</methodname>
<methodparam><type>resource</type><parameter>dbm_identifier</parameter></methodparam>
@@ -16,12 +16,48 @@
<para>
Adds the value to the database with the specified key.
</para>
+ </refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ &dbm.dbm-identifier.description;
+ <varlistentry>
+ <term><parameter>key</parameter></term>
+ <listitem>
+ <para>
+ The added key
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>value</parameter></term>
+ <listitem>
+ <para>
+ The added key value
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
<para>
Returns -1 if the database was opened read-only, 0 if the insert
was successful, and 1 if the specified key already exists. (To
replace the value, use <function>dbmreplace</function>.)
</para>
</refsect1>
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>dbmreplace</function></member>
+ <member><function>dbmdelete</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
</refentry>
<!-- Keep this comment at the end of the file
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/dbm/functions/dbmnextkey.xml?r1=1.6&r2=1.7&diff_format=u
Index: phpdoc/en/reference/dbm/functions/dbmnextkey.xml
diff -u phpdoc/en/reference/dbm/functions/dbmnextkey.xml:1.6
phpdoc/en/reference/dbm/functions/dbmnextkey.xml:1.7
--- phpdoc/en/reference/dbm/functions/dbmnextkey.xml:1.6 Sun Jan 14
03:20:22 2007
+++ phpdoc/en/reference/dbm/functions/dbmnextkey.xml Sun Jan 14 03:48:41 2007
@@ -1,22 +1,49 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
<refentry id="function.dbmnextkey">
<refnamediv>
<refname>dbmnextkey</refname>
<refpurpose></refpurpose>
</refnamediv>
- <refsect1>
- <title>Description</title>
+ <refsect1 role="description">
+ &reftitle.description;
<methodsynopsis>
<type>string</type><methodname>dbmnextkey</methodname>
<methodparam><type>resource</type><parameter>dbm_identifier</parameter></methodparam>
<methodparam><type>string</type><parameter>key</parameter></methodparam>
</methodsynopsis>
<para>
- Returns the next key after <parameter>key</parameter>. By calling
- <function>dbmfirstkey</function> followed by successive
- calls to <function>dbmnextkey</function> it is possible to
- visit every key/value pair in the dbm database. For example:
+ Returns the next key after <parameter>key</parameter>.
+ </para>
+ </refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ &dbm.dbm-identifier.description;
+ <varlistentry>
+ <term><parameter>key</parameter></term>
+ <listitem>
+ <para>
+ The previous key
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ The next key if possible
+ </para>
+ </refsect1>
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ By calling <function>dbmfirstkey</function> followed by successive calls
+ to <function>dbmnextkey</function> it is possible to visit every key/value
+ pair in the dbm database. For example:
<example>
<title>Visiting every key/value pair in a DBM database</title>
<programlisting role="php">
@@ -35,6 +62,14 @@
</example>
</para>
</refsect1>
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>dbmfirstkey</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
</refentry>
<!-- Keep this comment at the end of the file
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/dbm/functions/dbmopen.xml?r1=1.5&r2=1.6&diff_format=u
Index: phpdoc/en/reference/dbm/functions/dbmopen.xml
diff -u phpdoc/en/reference/dbm/functions/dbmopen.xml:1.5
phpdoc/en/reference/dbm/functions/dbmopen.xml:1.6
--- phpdoc/en/reference/dbm/functions/dbmopen.xml:1.5 Sun Jan 14 03:20:22 2007
+++ phpdoc/en/reference/dbm/functions/dbmopen.xml Sun Jan 14 03:48:41 2007
@@ -1,43 +1,83 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
<refentry id="function.dbmopen">
<refnamediv>
<refname>dbmopen</refname>
<refpurpose>Opens a DBM database</refpurpose>
</refnamediv>
- <refsect1>
- <title>Description</title>
+ <refsect1 role="description">
+ &reftitle.description;
<methodsynopsis>
<type>resource</type><methodname>dbmopen</methodname>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
<methodparam><type>string</type><parameter>flags</parameter></methodparam>
</methodsynopsis>
<para>
- The first argument is the full-path filename of the DBM file to
- be opened and the second is the file open mode which is one of
- "r", "n", "c" or "w" for read-only, new (implies read-write, and
- most likely will truncate an already-existing database of the
- same name), create (implies read-write, and will not truncate an
- already-existing database of the same name) and read-write
- respectively.
+ Opens the specified DBM database in the given mode.
</para>
+ </refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>filename</parameter></term>
+ <listitem>
+ <para>
+ The full-path filename of the DBM file to be opened
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>flags</parameter></term>
+ <listitem>
+ <para>
+ The file open mode which is one of <literal>r</literal>,
+ <literal>n</literal>, <literal>c</literal> or <literal>w</literal>,
+ for read-only, new (implies read-write, and most likely will truncate
+ an already-existing database of the same name), create (implies
+ read-write, and will not truncate an already-existing database of the
+ same name) and read-write respectively.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
<para>
Returns an identifier to be passed to the other DBM functions on
success, or &false; on failure.
</para>
+ </refsect1>
+ <refsect1 role="notes">
+ &reftitle.notes;
+ <note>
+ <para>
+ If NDBM support is used, NDBM will actually create
+ <filename>filename.dir</filename> and <filename>filename.pag</filename>
+ files. GDBM only uses one file, as does the internal flat-file support,
+ and Berkeley DB creates a <filename>filename.db</filename> file.
+ </para>
+ <para>
+ Note that PHP does its own file locking in addition to any file locking
+ that may be done by the DBM library itself. PHP does not delete the
+ <filename>.lck</filename> files it creates. It uses these files simply as
+ fixed inodes on which to do the file locking. For more information on DBM
+ files, see your Unix man pages, or obtain
+ <ulink url="&url.gdbm;">GNU's GDBM</ulink>.
+ </para>
+ </note>
+ ¬e.sm.uidcheck;
+ </refsect1>
+ <refsect1 role="seealso">
+ &reftitle.seealso;
<para>
- If NDBM support is used, NDBM will actually create
<filename>filename.dir</filename>
- and <filename>filename.pag</filename> files. GDBM only uses one file, as
does the
- internal flat-file support, and Berkeley DB creates a
- <filename>filename.db</filename> file. Note that PHP does its own
- file locking in addition to any file locking that may be done by
- the DBM library itself. PHP does not delete the
- <filename>.lck</filename> files it creates. It uses these files
- simply as fixed inodes on which to do the file locking. For more
- information on DBM files, see your Unix man pages, or obtain
- <ulink url="&url.gdbm;">GNU's GDBM</ulink>.
+ <simplelist>
+ <member><function>dbmclose</function></member>
+ </simplelist>
</para>
- ¬e.sm.uidcheck;
</refsect1>
</refentry>
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/dbm/functions/dbmreplace.xml?r1=1.4&r2=1.5&diff_format=u
Index: phpdoc/en/reference/dbm/functions/dbmreplace.xml
diff -u phpdoc/en/reference/dbm/functions/dbmreplace.xml:1.4
phpdoc/en/reference/dbm/functions/dbmreplace.xml:1.5
--- phpdoc/en/reference/dbm/functions/dbmreplace.xml:1.4 Sun Jan 14
03:20:22 2007
+++ phpdoc/en/reference/dbm/functions/dbmreplace.xml Sun Jan 14 03:48:41 2007
@@ -1,12 +1,12 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
<refentry id="function.dbmreplace">
<refnamediv>
<refname>dbmreplace</refname>
<refpurpose>Replaces the value for a key in a DBM database</refpurpose>
</refnamediv>
- <refsect1>
- <title>Description</title>
+ <refsect1 role="description">
+ &reftitle.description;
<methodsynopsis>
<type>int</type><methodname>dbmreplace</methodname>
<methodparam><type>resource</type><parameter>dbm_identifier</parameter></methodparam>
@@ -21,6 +21,44 @@
exist.
</para>
</refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ &dbm.dbm-identifier.description;
+ <varlistentry>
+ <term><parameter>key</parameter></term>
+ <listitem>
+ <para>
+ The replaced key
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>value</parameter></term>
+ <listitem>
+ <para>
+ The new value
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ &return.success;
+ </para>
+ </refsect1>
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>dbminsert</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
</refentry>
<!-- Keep this comment at the end of the file
