didou Sun Jan 14 03:20:22 2007 UTC
Modified files: /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: WS, prepare for new doc style
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/dbm/functions/dblist.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/dbm/functions/dblist.xml diff -u phpdoc/en/reference/dbm/functions/dblist.xml:1.4 phpdoc/en/reference/dbm/functions/dblist.xml:1.5 --- phpdoc/en/reference/dbm/functions/dblist.xml:1.4 Fri Jan 2 23:14:48 2004 +++ phpdoc/en/reference/dbm/functions/dblist.xml Sun Jan 14 03:20:22 2007 @@ -1,32 +1,29 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/dbm.xml, last change in rev 1.2 --> - <refentry id="function.dblist"> - <refnamediv> - <refname>dblist</refname> - <refpurpose> - Describes the DBM-compatible library being used - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>dblist</methodname> - <void/> - </methodsynopsis> - <para> - <example> - <title>Getting the information on the command line</title> - <programlisting role="shell"> +<!-- $Revision: 1.5 $ --> +<refentry id="function.dblist"> + <refnamediv> + <refname>dblist</refname> + <refpurpose>Describes the DBM-compatible library being used</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>string</type><methodname>dblist</methodname> + <void/> + </methodsynopsis> + <para> + <example> + <title>Getting the information on the command line</title> + <programlisting role="shell"> <![CDATA[ [EMAIL PROTECTED] marcus]$ php -r 'echo dblist();' This is GDBM version 1.8.0, as of May 19, 1999. ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/dbm/functions/dbmclose.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/dbm/functions/dbmclose.xml diff -u phpdoc/en/reference/dbm/functions/dbmclose.xml:1.3 phpdoc/en/reference/dbm/functions/dbmclose.xml:1.4 --- phpdoc/en/reference/dbm/functions/dbmclose.xml:1.3 Mon Apr 29 12:06:32 2002 +++ phpdoc/en/reference/dbm/functions/dbmclose.xml Sun Jan 14 03:20:22 2007 @@ -1,22 +1,21 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./en/functions/dbm.xml, last change in rev 1.2 --> - <refentry id="function.dbmclose"> - <refnamediv> - <refname>dbmclose</refname> - <refpurpose>Closes a dbm database</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>dbmclose</methodname> - <methodparam><type>resource</type><parameter>dbm_identifier</parameter></methodparam> - </methodsynopsis> - <para> - Unlocks and closes the specified database. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.4 $ --> +<refentry id="function.dbmclose"> + <refnamediv> + <refname>dbmclose</refname> + <refpurpose>Closes a dbm database</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>dbmclose</methodname> + <methodparam><type>resource</type><parameter>dbm_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Unlocks and closes the specified database. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/dbm/functions/dbmdelete.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/dbm/functions/dbmdelete.xml diff -u phpdoc/en/reference/dbm/functions/dbmdelete.xml:1.3 phpdoc/en/reference/dbm/functions/dbmdelete.xml:1.4 --- phpdoc/en/reference/dbm/functions/dbmdelete.xml:1.3 Mon Apr 29 12:06:32 2002 +++ phpdoc/en/reference/dbm/functions/dbmdelete.xml Sun Jan 14 03:20:22 2007 @@ -1,28 +1,25 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./en/functions/dbm.xml, last change in rev 1.2 --> - <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> - <methodsynopsis> - <type>bool</type><methodname>dbmdelete</methodname> - <methodparam><type>resource</type><parameter>dbm_identifier</parameter></methodparam> - <methodparam><type>string</type><parameter>key</parameter></methodparam> - </methodsynopsis> - <para> - Deletes the value for <parameter>key</parameter> in the database. - </para> - <para> - Returns &false; if the key didn't exist in the database. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.4 $ --> +<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> + <methodsynopsis> + <type>bool</type><methodname>dbmdelete</methodname> + <methodparam><type>resource</type><parameter>dbm_identifier</parameter></methodparam> + <methodparam><type>string</type><parameter>key</parameter></methodparam> + </methodsynopsis> + <para> + Deletes the value for <parameter>key</parameter> in the database. + </para> + <para> + Returns &false; if the key didn't exist in the database. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/dbm/functions/dbmexists.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/dbm/functions/dbmexists.xml diff -u phpdoc/en/reference/dbm/functions/dbmexists.xml:1.3 phpdoc/en/reference/dbm/functions/dbmexists.xml:1.4 --- phpdoc/en/reference/dbm/functions/dbmexists.xml:1.3 Mon Apr 29 12:06:32 2002 +++ phpdoc/en/reference/dbm/functions/dbmexists.xml Sun Jan 14 03:20:22 2007 @@ -1,26 +1,23 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./en/functions/dbm.xml, last change in rev 1.2 --> - <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> - <methodsynopsis> - <type>bool</type><methodname>dbmexists</methodname> - <methodparam><type>resource</type><parameter>dbm_identifier</parameter></methodparam> - <methodparam><type>string</type><parameter>key</parameter></methodparam> - </methodsynopsis> - <para> - Returns &true; if there is a value associated with the - <parameter>key</parameter>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.4 $ --> +<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> + <methodsynopsis> + <type>bool</type><methodname>dbmexists</methodname> + <methodparam><type>resource</type><parameter>dbm_identifier</parameter></methodparam> + <methodparam><type>string</type><parameter>key</parameter></methodparam> + </methodsynopsis> + <para> + Returns &true; if there is a value associated with the + <parameter>key</parameter>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/dbm/functions/dbmfetch.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/dbm/functions/dbmfetch.xml diff -u phpdoc/en/reference/dbm/functions/dbmfetch.xml:1.3 phpdoc/en/reference/dbm/functions/dbmfetch.xml:1.4 --- phpdoc/en/reference/dbm/functions/dbmfetch.xml:1.3 Mon Apr 29 12:06:32 2002 +++ phpdoc/en/reference/dbm/functions/dbmfetch.xml Sun Jan 14 03:20:22 2007 @@ -1,25 +1,22 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./en/functions/dbm.xml, last change in rev 1.2 --> - <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> - <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> - Returns the value associated with <parameter>key</parameter>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.4 $ --> +<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> + <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> + Returns the value associated with <parameter>key</parameter>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/dbm/functions/dbmfirstkey.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/dbm/functions/dbmfirstkey.xml diff -u phpdoc/en/reference/dbm/functions/dbmfirstkey.xml:1.3 phpdoc/en/reference/dbm/functions/dbmfirstkey.xml:1.4 --- phpdoc/en/reference/dbm/functions/dbmfirstkey.xml:1.3 Mon Apr 29 12:06:32 2002 +++ phpdoc/en/reference/dbm/functions/dbmfirstkey.xml Sun Jan 14 03:20:22 2007 @@ -1,26 +1,23 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./en/functions/dbm.xml, last change in rev 1.2 --> - <refentry id="function.dbmfirstkey"> - <refnamediv> - <refname>dbmfirstkey</refname> - <refpurpose> - Retrieves the first key from a DBM database - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>dbmfirstkey</methodname> - <methodparam><type>resource</type><parameter>dbm_identifier</parameter></methodparam> - </methodsynopsis> - <para> - Returns the first key in the database. Note that no particular order - is guaranteed since the database may be built using a hash-table, - which doesn't guarantee any ordering. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.4 $ --> +<refentry id="function.dbmfirstkey"> + <refnamediv> + <refname>dbmfirstkey</refname> + <refpurpose>Retrieves the first key from a DBM database</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>string</type><methodname>dbmfirstkey</methodname> + <methodparam><type>resource</type><parameter>dbm_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Returns the first key in the database. Note that no particular order + is guaranteed since the database may be built using a hash-table, + which doesn't guarantee any ordering. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/dbm/functions/dbminsert.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/dbm/functions/dbminsert.xml diff -u phpdoc/en/reference/dbm/functions/dbminsert.xml:1.3 phpdoc/en/reference/dbm/functions/dbminsert.xml:1.4 --- phpdoc/en/reference/dbm/functions/dbminsert.xml:1.3 Mon Apr 29 12:06:32 2002 +++ phpdoc/en/reference/dbm/functions/dbminsert.xml Sun Jan 14 03:20:22 2007 @@ -1,31 +1,28 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./en/functions/dbm.xml, last change in rev 1.2 --> - <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> - <methodsynopsis> - <type>int</type><methodname>dbminsert</methodname> - <methodparam><type>resource</type><parameter>dbm_identifier</parameter></methodparam> - <methodparam><type>string</type><parameter>key</parameter></methodparam> - <methodparam><type>string</type><parameter>value</parameter></methodparam> - </methodsynopsis> - <para> - Adds the value to the database with the specified key. - </para> - <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> - </refentry> +<!-- $Revision: 1.4 $ --> +<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> + <methodsynopsis> + <type>int</type><methodname>dbminsert</methodname> + <methodparam><type>resource</type><parameter>dbm_identifier</parameter></methodparam> + <methodparam><type>string</type><parameter>key</parameter></methodparam> + <methodparam><type>string</type><parameter>value</parameter></methodparam> + </methodsynopsis> + <para> + Adds the value to the database with the specified key. + </para> + <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> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/dbm/functions/dbmnextkey.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/dbm/functions/dbmnextkey.xml diff -u phpdoc/en/reference/dbm/functions/dbmnextkey.xml:1.5 phpdoc/en/reference/dbm/functions/dbmnextkey.xml:1.6 --- phpdoc/en/reference/dbm/functions/dbmnextkey.xml:1.5 Mon Dec 15 16:48:48 2003 +++ phpdoc/en/reference/dbm/functions/dbmnextkey.xml Sun Jan 14 03:20:22 2007 @@ -1,27 +1,25 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./en/functions/dbm.xml, last change in rev 1.2 --> - <refentry id="function.dbmnextkey"> - <refnamediv> - <refname>dbmnextkey</refname> - <refpurpose> - Retrieves the next key from a DBM database</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <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: - <example> - <title>Visiting every key/value pair in a DBM database</title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<refentry id="function.dbmnextkey"> + <refnamediv> + <refname>dbmnextkey</refname> + <refpurpose></refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <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: + <example> + <title>Visiting every key/value pair in a DBM database</title> + <programlisting role="php"> <![CDATA[ <?php @@ -33,11 +31,11 @@ ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/dbm/functions/dbmopen.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/dbm/functions/dbmopen.xml diff -u phpdoc/en/reference/dbm/functions/dbmopen.xml:1.4 phpdoc/en/reference/dbm/functions/dbmopen.xml:1.5 --- phpdoc/en/reference/dbm/functions/dbmopen.xml:1.4 Mon Dec 15 18:42:02 2003 +++ phpdoc/en/reference/dbm/functions/dbmopen.xml Sun Jan 14 03:20:22 2007 @@ -1,46 +1,45 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/dbm.xml, last change in rev 1.2 --> - <refentry id="function.dbmopen"> - <refnamediv> - <refname>dbmopen</refname> - <refpurpose>Opens a DBM database</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <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. - </para> - <para> - Returns an identifier to be passed to the other DBM functions on - success, or &false; on failure. - </para> - <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>. - </para> - ¬e.sm.uidcheck; - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.dbmopen"> + <refnamediv> + <refname>dbmopen</refname> + <refpurpose>Opens a DBM database</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <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. + </para> + <para> + Returns an identifier to be passed to the other DBM functions on + success, or &false; on failure. + </para> + <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>. + </para> + ¬e.sm.uidcheck; + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/dbm/functions/dbmreplace.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/dbm/functions/dbmreplace.xml diff -u phpdoc/en/reference/dbm/functions/dbmreplace.xml:1.3 phpdoc/en/reference/dbm/functions/dbmreplace.xml:1.4 --- phpdoc/en/reference/dbm/functions/dbmreplace.xml:1.3 Mon Apr 29 12:06:32 2002 +++ phpdoc/en/reference/dbm/functions/dbmreplace.xml Sun Jan 14 03:20:22 2007 @@ -1,30 +1,27 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./en/functions/dbm.xml, last change in rev 1.2 --> - <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> - <methodsynopsis> - <type>int</type><methodname>dbmreplace</methodname> - <methodparam><type>resource</type><parameter>dbm_identifier</parameter></methodparam> - <methodparam><type>string</type><parameter>key</parameter></methodparam> - <methodparam><type>string</type><parameter>value</parameter></methodparam> - </methodsynopsis> - <para> - Replaces the value for the specified key in the database. - </para> - <para> - This will also add the key to the database if it didn't already - exist. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.4 $ --> +<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> + <methodsynopsis> + <type>int</type><methodname>dbmreplace</methodname> + <methodparam><type>resource</type><parameter>dbm_identifier</parameter></methodparam> + <methodparam><type>string</type><parameter>key</parameter></methodparam> + <methodparam><type>string</type><parameter>value</parameter></methodparam> + </methodsynopsis> + <para> + Replaces the value for the specified key in the database. + </para> + <para> + This will also add the key to the database if it didn't already + exist. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: