cvs: phpdoc /en language-snippets.ent /en/appendices debugger.xml migration.xml migration4.xml phpdevel.xml reserved.xml /en/chapters config.xml
/en/features connection-handling.xml error-handling.xml /en/functions array.xml aspell.xml bzip2.xml calendar.xml classobj.xml com.xml cpdf.xml
ctype.xml cybercash.xml datetime.xml dba.xml dbase.xml dbm.xml dbx.xml dir.xml errorfunc.xml exec.xml fbsql.xml fdf.xml filesystem.xml ftp.xml
funchand.xml gettext.xml gmp.xml http.xml hw.xml icap.xml iconv.xml ifx.xml image.xml imap.xml info.xml ingres_ii.xml ircg.xml java.xml ldap.xml
mail.xml mbstring.xml mcal.xml mcrypt.xml mhash.xml ming.xml misc.xml mnogosearch.xml msql.xml mssql.xml mysql.xml network.xml nis.xml oci8.xml
openssl.xml oracle.xml outcontrol.xml ovrimos.xml pcre.xml pdf.xml pgsql.xml posix.xml printer.xml pspell.xml recode.xml regex.xml satellite.xml
sem.xml sesam.xml session.xml snmp.xml sockets.xml strings.xml sybase.xml uodbc.xml var.xml xml.xml xslt.xml yaz.xml zip.xml zlib.xml /en/language
basic-syntax.xml constants.xml control-structures.xml expressions.xml oop.xml operators.xml types.xml /en/pear pear.xml standards.xml
| From: | Jeroen van Wolffelaar | Date: | Sat, 07 Jul 2001 18:43:20 +0000 |
| Subject: | cvs: phpdoc /en language-snippets.ent /en/appendices debugger.xml migration.xml migration4.xml phpdevel.xml reserved.xml /en/chapters config.xml /en/features connection-handling.xml error-handling.xml /en/functions array.xml aspell.xml bzip2.xml calendar.xml classobj.xml com.xml cpdf.xml ctype.xml cybercash.xml datetime.xml dba.xml dbase.xml dbm.xml dbx.xml dir.xml errorfunc.xml exec.xml fbsql.xml fdf.xml filesystem.xml ftp.xml funchand.xml gettext.xml gmp.xml http.xml hw.xml icap.xml iconv.xml ifx.xml image.xml imap.xml info.xml ingres_ii.xml ircg.xml java.xml ldap.xml mail.xml mbstring.xml mcal.xml mcrypt.xml mhash.xml ming.xml misc.xml mnogosearch.xml msql.xml mssql.xml mysql.xml network.xml nis.xml oci8.xml openssl.xml oracle.xml outcontrol.xml ovrimos.xml pcre.xml pdf.xml pgsql.xml posix.xml printer.xml pspell.xml recode.xml regex.xml satellite.xml sem.xml sesam.xml session.xml snmp.xml sockets.xml strings.xml sybase.xml uodbc.xml var.xml xml.xml xslt.xml yaz.xml zip.xml zlib.xml /en/language basic-syntax.xml constants.xml control-structures.xml expressions.xml oop.xml operators.xml types.xml /en/pear pear.xml standards.xml |
||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969335922@lists.php.net to get a copy of this message | ||
jeroen Sat Jul 7 14:43:20 2001 EDT
Modified files:
/phpdoc/en language-snippets.ent
/phpdoc/en/appendices debugger.xml migration.xml migration4.xml
phpdevel.xml reserved.xml
/phpdoc/en/chapters config.xml
/phpdoc/en/features connection-handling.xml error-handling.xml
/phpdoc/en/functions array.xml aspell.xml bzip2.xml calendar.xml
classobj.xml com.xml cpdf.xml ctype.xml
cybercash.xml datetime.xml dba.xml dbase.xml
dbm.xml dbx.xml dir.xml errorfunc.xml exec.xml
fbsql.xml fdf.xml filesystem.xml ftp.xml
funchand.xml gettext.xml gmp.xml http.xml
hw.xml icap.xml iconv.xml ifx.xml image.xml
imap.xml info.xml ingres_ii.xml ircg.xml
java.xml ldap.xml mail.xml mbstring.xml
mcal.xml mcrypt.xml mhash.xml ming.xml
misc.xml mnogosearch.xml msql.xml mssql.xml
mysql.xml network.xml nis.xml oci8.xml
openssl.xml oracle.xml outcontrol.xml
ovrimos.xml pcre.xml pdf.xml pgsql.xml
posix.xml printer.xml pspell.xml recode.xml
regex.xml satellite.xml sem.xml sesam.xml
session.xml snmp.xml sockets.xml strings.xml
sybase.xml uodbc.xml var.xml xml.xml xslt.xml
yaz.xml zip.xml zlib.xml
/phpdoc/en/language basic-syntax.xml constants.xml
control-structures.xml expressions.xml oop.xml
operators.xml types.xml
/phpdoc/en/pear pear.xml standards.xml
Log:
Changed true, false and null to &true;, &false; and &null;
Probably this isn't correct at some places, but in the majority
it is.
Index: phpdoc/en/language-snippets.ent diff -u phpdoc/en/language-snippets.ent:1.2 phpdoc/en/language-snippets.ent:1.3 --- phpdoc/en/language-snippets.ent:1.2 Sun Jun 24 11:27:21 2001 +++ phpdoc/en/language-snippets.ent Sat Jul 7 14:42:09 2001 @@ -1,3 +1,10 @@ +<!-- PHPDoc snippets $Id: language-snippets.ent,v 1.3 2001/07/07 18:42:09 jeroen Exp $ --> + +<!ENTITY true '<constant>TRUE</constant>'> +<!ENTITY false '<constant>FALSE</constant>'> +<!ENTITY null '<constant>NULL</constant>'> + + <!ENTITY warn.experimental '<warning><simpara>This module is <emphasis>EXPERIMENTAL</emphasis>. That means, that the behaviour of these functions, these function names, in concreto ANYTHING documented here can change in a future release of PHP WITHOUT NOTICE. Be warned, and use this module at your own risk.</simpara></warning>'> <!ENTITY tip.ob-capture '<tip><simpara>As with anything that outputs its result directly to the browser, you can use the <link linkend="ref.outcontrol">output-control functions</link> to capture the output of this function, and save it - for example - in a <type>string</type>.</simpara></tip>'> Index: phpdoc/en/appendices/debugger.xml diff -u phpdoc/en/appendices/debugger.xml:1.7 phpdoc/en/appendices/debugger.xml:1.8 --- phpdoc/en/appendices/debugger.xml:1.7 Wed Jan 24 14:23:35 2001 +++ phpdoc/en/appendices/debugger.xml Sat Jul 7 14:42:10 2001 @@ -238,7 +238,7 @@ <literallayout> 1998-04-05 23:27:400966 lucifer.guardian.no(20481) start: notice 1998-04-05 23:27:400966 lucifer.guardian.no(20481) message: Uninitialized variable -1998-04-05 23:27:400966 lucifer.guardian.no(20481) location: (null):7 +1998-04-05 23:27:400966 lucifer.guardian.no(20481) location: (&null;):7 1998-04-05 23:27:400966 lucifer.guardian.no(20481) frames: 1 1998-04-05 23:27:400966 lucifer.guardian.no(20481) function: display 1998-04-05 23:27:400966 lucifer.guardian.no(20481) location: /home/ssb/public_html/test.php3:10 Index: phpdoc/en/appendices/migration.xml diff -u phpdoc/en/appendices/migration.xml:1.4 phpdoc/en/appendices/migration.xml:1.5 --- phpdoc/en/appendices/migration.xml:1.4 Sun Jan 21 20:02:01 2001 +++ phpdoc/en/appendices/migration.xml Sat Jul 7 14:42:11 2001 @@ -323,10 +323,10 @@ <sect2 id="migration-truefalse"> - <title>Function true/false return values</title> + <title>Function &true;/&false; return values</title> <simpara> - Most internal functions have been rewritten so they return TRUE - when successful and FALSE when failing, as opposed to 0 and -1 in + Most internal functions have been rewritten so they return &true; + when successful and &false; when failing, as opposed to 0 and -1 in PHP/FI 2.0, respectively. The new behaviour allows for more logical code, like <literal>$fp = fopen("/your/file") or fail("darn!");</literal>. Because PHP/FI 2.0 had no clear rules @@ -366,7 +366,7 @@ <listitem><simpara> In PHP/FI 2.0, an implementation side-effect caused <literal>$foo[0]</literal> to have the same effect as - <literal>$foo</literal>. This is not true for PHP 3.0.</simpara></listitem> + <literal>$foo</literal>. This is not &true; for PHP 3.0.</simpara></listitem> <listitem><simpara> Reading arrays with <literal>$array[]</literal> is no longer Index: phpdoc/en/appendices/migration4.xml diff -u phpdoc/en/appendices/migration4.xml:1.6 phpdoc/en/appendices/migration4.xml:1.7 --- phpdoc/en/appendices/migration4.xml:1.6 Sat May 19 16:48:23 2001 +++ phpdoc/en/appendices/migration4.xml Sat Jul 7 14:42:11 2001 @@ -98,7 +98,7 @@ <para> This has lead to a lot of unreproduceable bug reports in the past where people reported script engine problems they were not - capable to track down while the true case was usually some + capable to track down while the &true; case was usually some missing '}' in a required file that the parser was not able to report due to a misconfigured error reporting system. </para> @@ -208,7 +208,7 @@ <para> Another feature from PHP 3.0 that didn't make it into 4.0 is the experimental debugging interface as described in ??? in this - manual. A seperate true debuger is promissed to be released as a + manual. A seperate &true; debuger is promissed to be released as a Zend product but hasn't become visible yet. </para> </section> @@ -232,7 +232,7 @@ This has no direct consequences as the behavior of <function>unset</function> didn't change, but testing for "unset" usign <function>function_exists</function> will return - <literal>false</literal> as it would with othern lowlevel + &false; as it would with othern lowlevel functions like <function>echo</function>. </para> <para> Index: phpdoc/en/appendices/phpdevel.xml diff -u phpdoc/en/appendices/phpdevel.xml:1.5 phpdoc/en/appendices/phpdevel.xml:1.6 --- phpdoc/en/appendices/phpdevel.xml:1.5 Fri Sep 15 12:09:42 2000 +++ phpdoc/en/appendices/phpdevel.xml Sat Jul 7 14:42:12 2001 @@ -258,7 +258,7 @@ pval arr; if (array_init(&arr) == FAILURE) { failed... }; -hash_update(active_symbol_table,"foo",sizeof("foo"),&arr,sizeof(pval),NULL); +hash_update(active_symbol_table,"foo",sizeof("foo"),&arr,sizeof(pval),&null;); </programlisting> </example> @@ -278,15 +278,15 @@ entry.value.lval = 5; /* defines $foo["bar"] = 5 */ -hash_update(arr.value.ht,"bar",sizeof("bar"),&entry,sizeof(pval),NULL); +hash_update(arr.value.ht,"bar",sizeof("bar"),&entry,sizeof(pval),&null;); /* defines $foo[7] = 5 */ -hash_index_update(arr.value.ht,7,&entry,sizeof(pval),NULL); +hash_index_update(arr.value.ht,7,&entry,sizeof(pval),&null;); /* defines the next free place in $foo[], * $foo[8], to be 5 (works like php2) */ -hash_next_index_insert(arr.value.ht,&entry,sizeof(pval),NULL); +hash_next_index_insert(arr.value.ht,&entry,sizeof(pval),&null;); </programlisting> </example> @@ -294,7 +294,7 @@ must first retrieve it from the hash. To prevent that overhead, you can supply a pval ** to the hash add function, and it'll be updated with the pval * address of the inserted element inside the - hash. If that value is NULL (like in all of the above examples) - + hash. If that value is &null; (like in all of the above examples) - that parameter is ignored.</para> <simpara> @@ -348,10 +348,10 @@ function: <itemizedlist> <listitem><simpara>RETURN</simpara></listitem> - <listitem><simpara>RETURN_FALSE</simpara></listitem> - <listitem><simpara>RETURN_TRUE</simpara></listitem> + <listitem><simpara>RETURN_false</simpara></listitem> + <listitem><simpara>RETURN_true</simpara></listitem> <listitem><simpara>RETURN_LONG(l)</simpara></listitem> - <listitem><simpara>RETURN_STRING(s,dup) If dup is true, duplicates the string</simpara></listitem> + <listitem><simpara>RETURN_STRING(s,dup) If dup is &true;, duplicates the string</simpara></listitem> <listitem><simpara>RETURN_STRINGL(s,l,dup) Return string (s) specifying length (l).</simpara></listitem> <listitem><simpara>RETURN_DOUBLE(d)</simpara></listitem> </itemizedlist></para> @@ -359,10 +359,10 @@ <para> The RETVAL_* macros set the return value, but do not return. <itemizedlist> - <listitem><simpara>RETVAL_FALSE</simpara></listitem> - <listitem><simpara>RETVAL_TRUE</simpara></listitem> + <listitem><simpara>RETVAL_false</simpara></listitem> + <listitem><simpara>RETVAL_true</simpara></listitem> <listitem><simpara>RETVAL_LONG(l)</simpara></listitem> - <listitem><simpara>RETVAL_STRING(s,dup) If dup is true, duplicates the string</simpara></listitem> + <listitem><simpara>RETVAL_STRING(s,dup) If dup is &true;, duplicates the string</simpara></listitem> <listitem><simpara>RETVAL_STRINGL(s,l,dup) Return string (s) specifying length (l).</simpara></listitem> <listitem><simpara>RETVAL_DOUBLE(d)</simpara></listitem> </itemizedlist></para> @@ -374,7 +374,7 @@ <simpara> If your function returns boolean success/error responses, always - use RETURN_TRUE and RETURN_FALSE respectively.</simpara></sect2> + use RETURN_true and RETURN_false respectively.</simpara></sect2> <sect2 id="phpdevel-addfunc-retcomplex"> <title>Returning complex values</title> @@ -496,7 +496,7 @@ resource = php3_list_find(resource_id->value.lval, &type); if (type != LE_RESOURCE_TYPE) { php3_error(E_WARNING,"resource index %d has the wrong type",resource_id->value.lval); - RETURN_FALSE; + RETURN_false; } /* ...use resource... */ </programlisting> @@ -695,8 +695,8 @@ <title>pval *object</title> <simpara> This is a pointer to an object on which the function is invoked. - This should be NULL if a global function is called. If it's not - NULL (i.e. it points to an object), the function_table argument is + This should be &null; if a global function is called. If it's not + &null; (i.e. it points to an object), the function_table argument is ignored, and instead taken from the object's hash. The object *may* be modified by the function that is invoked on it (that function will have access to it via $this). If for some reason you don't Index: phpdoc/en/appendices/reserved.xml diff -u phpdoc/en/appendices/reserved.xml:1.3 phpdoc/en/appendices/reserved.xml:1.4 --- phpdoc/en/appendices/reserved.xml:1.3 Wed May 23 04:50:55 2001 +++ phpdoc/en/appendices/reserved.xml Sat Jul 7 14:42:13 2001 @@ -100,7 +100,7 @@ </listitem> <listitem> <simpara> - <link linkend="language.constants"><literal>FALSE</literal></link>. + <link linkend="language.constants">&false;</link>. </simpara> </listitem> <listitem> @@ -210,7 +210,7 @@ </listitem> <listitem> <simpara> - <link linkend="language.constants"><literal>TRUE</literal></link>. + <link linkend="language.constants">&true;</link>. </simpara> </listitem> <listitem> Index: phpdoc/en/chapters/config.xml diff -u phpdoc/en/chapters/config.xml:1.15 phpdoc/en/chapters/config.xml:1.16 --- phpdoc/en/chapters/config.xml:1.15 Tue Jun 26 23:52:38 2001 +++ phpdoc/en/chapters/config.xml Sat Jul 7 14:42:14 2001 @@ -1326,8 +1326,8 @@ </term> <listitem> <para> - Set to true if you want to return blob columns - in a file, false if you want them in memory. You can + Set to &true; if you want to return blob columns + in a file, &false; if you want them in memory. You can override the setting at runtime with <function>ifx_blobinfile_mode</function>. </para> @@ -1341,9 +1341,9 @@ </term> <listitem> <para> - Set to true if you want to return TEXT columns + Set to &true; if you want to return TEXT columns as normal strings in select statements, - false if you want to use blob id parameters. You can + &false; if you want to use blob id parameters. You can override the setting at runtime with <function>ifx_textasvarchar</function>. </para> @@ -1357,9 +1357,9 @@ </term> <listitem> <para> - Set to true if you want to return BYTE columns + Set to &true; if you want to return BYTE columns as normal strings in select queries, - false if you want to use blob id parameters. You can + &false; if you want to use blob id parameters. You can override the setting at runtime with <function>ifx_textasvarchar</function>. </para> @@ -1373,7 +1373,7 @@ </term> <listitem> <para> - Set to true if you want to trim trailing spaces + Set to &true; if you want to trim trailing spaces from CHAR columns when fetching them. </para> </listitem> @@ -1386,8 +1386,8 @@ </term> <listitem> <para> - Set to true if you want to return NULL columns - as the literal string "NULL", false if you want + Set to &true; if you want to return &null; columns + as the literal string "&null;", &false; if you want them returned as the empty string "". You can override this setting at runtime with <function>ifx_nullformat</function>. Index: phpdoc/en/features/connection-handling.xml diff -u phpdoc/en/features/connection-handling.xml:1.2 phpdoc/en/features/connection-handling.xml:1.3 --- phpdoc/en/features/connection-handling.xml:1.2 Thu Dec 9 19:34:38 1999 +++ phpdoc/en/features/connection-handling.xml Sat Jul 7 14:42:16 2001 @@ -41,7 +41,7 @@ This shutdown function will also get called at the end of your script terminating normally, so to do something different in case of a client diconnect you can use the <function>connection_aborted</function> - function. This function will return true if the connection was + function. This function will return &true; if the connection was aborted.</simpara> <simpara> @@ -55,7 +55,7 @@ be called. Within this shutdown function you can check to see if a timeout caused the shutdown function to be called by calling the <function>connection_timeout</function> function. This function will - return true if a timeout caused the shutdown function to be called.</simpara> + return &true; if a timeout caused the shutdown function to be called.</simpara> <simpara> One thing to note is that both the ABORTED and the TIMEOUT states @@ -65,7 +65,7 @@ running. If it then hits the time limit it will be aborted and your shutdown function, if any, will be called. At this point you will find that <function>connection_timeout</function> - and <function>connection_aborted</function> return true. + and <function>connection_aborted</function> return &true;. You can also check both states in a single call by using the <function>connection_status</function>. This function returns a bitfield of the active states. So, if both states are active it Index: phpdoc/en/features/error-handling.xml diff -u phpdoc/en/features/error-handling.xml:1.14 phpdoc/en/features/error-handling.xml:1.15 --- phpdoc/en/features/error-handling.xml:1.14 Mon Jan 22 20:56:45 2001 +++ phpdoc/en/features/error-handling.xml Sat Jul 7 14:42:17 2001 @@ -231,12 +231,12 @@ function distance ($vect1, $vect2) { if (!is_array($vect1) || !is_array($vect2)) { trigger_error("Incorrect parameters, arrays expected", E_USER_ERROR); - return NULL; + return &null;; } if (count($vect1) != count($vect2)) { trigger_error("Vectors need to be of the same size", E_USER_ERROR); - return NULL; + return &null;; } for ($i=0; $i<count($vect1); $i++) { Index: phpdoc/en/functions/array.xml diff -u phpdoc/en/functions/array.xml:1.74 phpdoc/en/functions/array.xml:1.75 --- phpdoc/en/functions/array.xml:1.74 Mon Jul 2 15:44:44 2001 +++ phpdoc/en/functions/array.xml Sat Jul 7 14:42:20 2001 @@ -288,7 +288,7 @@ used as its values, and all others will be lost. </para> <para> - <function>array_flip</function> returns <literal>FALSE</literal> + <function>array_flip</function> returns &false; if it fails. </para> <para> @@ -542,7 +542,7 @@ </para> <para> An interesting use of this function is to construct an array of arrays, - which can be easily performed by using <literal>null</literal> + which can be easily performed by using &null; as the name of the callback function </para> <para> @@ -553,7 +553,7 @@ $b = array("one", "two", "three", "four", "five"); $c = array("uno", "dos", "tres", "cuatro", "cinco"); -$d = array_map(null, $a, $b, $c); +$d = array_map(&null;, $a, $b, $c); print_r($d); // will output: @@ -775,7 +775,7 @@ SORT_REGULAR after before each new array argument. </para> <para> - Returns <literal>TRUE</literal> on success, <literal>FALSE</literal> + Returns &true; on success, &false; on failure. </para> <para> @@ -879,7 +879,7 @@ the <parameter>array</parameter>, shortening the <parameter>array</parameter> by one element. If <parameter>array</parameter> is empty (or is not an array), - <varname>NULL</varname> will be returned. + &null; will be returned. </para> <para> <example> @@ -1027,7 +1027,7 @@ <function>array_reverse</function> takes input <parameter>array</parameter> and returns a new array with the order of the elements reversed, preserving the keys if - <parameter>preserve_keys</parameter> is <literal>TRUE</literal>. + <parameter>preserve_keys</parameter> is &true;. </para> <para> <example> @@ -1035,7 +1035,7 @@ <programlisting role="php"> $input = array ("php", 4.0, array ("green", "red")); $result = array_reverse ($input); -$result_keyed = array_reverse ($input, TRUE); +$result_keyed = array_reverse ($input, &true;); </programlisting> </example> </para> @@ -1136,7 +1136,7 @@ <parameter>array</parameter> by one element and moving everything down. If <parameter>array</parameter> is empty (or is not an array), - <varname>NULL</varname> will be returned. + &null; will be returned. </para> <para> <example> @@ -1856,11 +1856,11 @@ array element that's currently being pointed by the internal pointer. It does not move the pointer in any way. If the internal pointer points beyond the end of the elements list, - <function>current</function> returns <literal>FALSE</literal>. + <function>current</function> returns &false;. <warning> <para> If the array contains empty elements (0 or "", the empty - string) then this function will return <literal>FALSE</literal> + string) then this function will return &false; for these elements as well. This makes it impossible to determine if you are really at the end of the list in such an array using <function>current</function>. To properly @@ -1905,7 +1905,7 @@ <para> If the internal pointer for the array points past the end of the array contents, <function>each</function> returns - <literal>FALSE</literal>. + &false;. </para> <para> <example> @@ -2156,7 +2156,7 @@ <refentry id="function.in-array"> <refnamediv> <refname>in_array</refname> - <refpurpose>Return TRUE if a value exists in an array</refpurpose> + <refpurpose>Return &true; if a value exists in an array</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -2172,12 +2172,12 @@ </funcsynopsis> <para> Searches <parameter>haystack</parameter> for - <parameter>needle</parameter> and returns <literal>TRUE</literal> - if it is found in the array, <literal>FALSE</literal> otherwise. + <parameter>needle</parameter> and returns &true; + if it is found in the array, &false; otherwise. </para> <para> If the third parameter <parameter>strict</parameter> is set to - <literal>TRUE</literal> then the <function>in_array</function> + &true; then the <function>in_array</function> will also check the types of the <parameter>needle</parameter> in the <parameter>haystack</parameter>. </para> @@ -2199,9 +2199,9 @@ <?php $a = array('1.10', 12.4, 1.13); -if (in_array('12.4', $a, TRUE)) +if (in_array('12.4', $a, &true;)) echo "'12.4' found with strict check\n"; -if (in_array(1.13, $a, TRUE)) +if (in_array(1.13, $a, &true;)) echo "1.13 found with strict check\n"; ?> @@ -2237,11 +2237,11 @@ <para> Searches <parameter>haystack</parameter> for <parameter>needle</parameter> and returns the key if it is found in - the array, <literal>FALSE</literal> otherwise. + the array, &false; otherwise. </para> <para> If the third parameter <parameter>strict</parameter> is set to - <literal>TRUE</literal> then the <function>array_search</function> + &true; then the <function>array_search</function> will also check the types of the <parameter>needle</parameter> in the <parameter>haystack</parameter>. </para> @@ -2575,7 +2575,7 @@ </funcsynopsis> <para> Returns the array element in the next place that's pointed by the - internal array pointer, or <literal>FALSE</literal> if + internal array pointer, or &false; if there are no more elements. </para> <para> @@ -2585,11 +2585,11 @@ element. That means it returns the next array element and advances the internal array pointer by one. If advancing the internal array pointer results in going beyond the end of the - element list, <function>next</function> returns <literal>FALSE</literal>. + element list, <function>next</function> returns &false;. <warning> <para> If the array contains empty elements, or elements that have a key - value of 0 then this function will return <literal>FALSE</literal> + value of 0 then this function will return &false; for these elements as well. To properly traverse an array which may contain empty elements or elements with key values of 0 see the <function>each</function> function. @@ -2643,12 +2643,12 @@ </funcsynopsis> <para> Returns the array element in the previous place that's pointed by - the internal array pointer, or <literal>FALSE</literal> if there are no more + the internal array pointer, or &false; if there are no more elements. <warning> <para> If the array contains empty elements then this function will - return <literal>FALSE</literal> for these elements as well. + return &false; for these elements as well. To properly traverse an array which may contain empty elements see the <function>each</function> function. </para> Index: phpdoc/en/functions/aspell.xml diff -u phpdoc/en/functions/aspell.xml:1.9 phpdoc/en/functions/aspell.xml:1.10 --- phpdoc/en/functions/aspell.xml:1.9 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/aspell.xml Sat Jul 7 14:42:21 2001 @@ -68,7 +68,7 @@ </funcsynopsis> <simpara> <function>aspell_check</function> checks the spelling of a word - and returns true if the spelling is correct, false if not. + and returns &true; if the spelling is correct, &false; if not. </simpara> <para> <example> @@ -105,7 +105,7 @@ <simpara> <function>aspell_check_raw</function> checks the spelling of a word, without changing its case or trying to trim it in any way - and returns true if the spelling is correct, false if not. + and returns &true; if the spelling is correct, &false; if not. </simpara> <para> <example> Index: phpdoc/en/functions/bzip2.xml diff -u phpdoc/en/functions/bzip2.xml:1.6 phpdoc/en/functions/bzip2.xml:1.7 --- phpdoc/en/functions/bzip2.xml:1.6 Sun May 20 18:49:49 2001 +++ phpdoc/en/functions/bzip2.xml Sat Jul 7 14:42:21 2001 @@ -72,7 +72,7 @@ Closes the bzip2 file referenced by the pointer <parameter>bz</parameter>. </para> <para> - Returns true on success and false on failure. + Returns &true; on success and &false; on failure. </para> <para> The file pointer must be valid, and must point to a file @@ -162,7 +162,7 @@ <function>bzdecompress</function> decompresses the <parameter>source</parameter> string containing bzip2 encoded data and returns it. If the optional parameter - <parameter>small</parameter> is true, an alternative + <parameter>small</parameter> is &true;, an alternative decompression algorithm will be used which uses less memory (the maximum memory requirement drops to around 2300K) but works at roughly half the speed. See the <ulink url="&url.bzip2;">bzip2 @@ -297,7 +297,7 @@ <parameter>bz</parameter>. </para> <para> - Returns true on success, false on failure. + Returns &true; on success, &false; on failure. </para> <para> See also <function>bzread</function> and <function>bzwrite</function>. @@ -327,7 +327,7 @@ <function>fopen</function> function (`r' for read, `w' for write, etc.). </para> <para> - If the open fails, the function returns false, otherwise it + If the open fails, the function returns &false;, otherwise it returns a pointer to the newly opened file. </para> <para> Index: phpdoc/en/functions/calendar.xml diff -u phpdoc/en/functions/calendar.xml:1.10 phpdoc/en/functions/calendar.xml:1.11 --- phpdoc/en/functions/calendar.xml:1.10 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/calendar.xml Sat Jul 7 14:42:21 2001 @@ -521,7 +521,7 @@ </funcsynopsis> <para> This function will return a UNIX timestamp corresponding to the - Julian Day given in <parameter>jday</parameter> or false if + Julian Day given in <parameter>jday</parameter> or &false; if <parameter>jday</parameter> is not inside the UNIX epoch (Gregorian years between 1970 and 2037 or 2440588 <= <parameter>jday</parameter> <= 2465342 ) Index: phpdoc/en/functions/classobj.xml diff -u phpdoc/en/functions/classobj.xml:1.20 phpdoc/en/functions/classobj.xml:1.21 --- phpdoc/en/functions/classobj.xml:1.20 Wed May 16 14:33:20 2001 +++ phpdoc/en/functions/classobj.xml Sat Jul 7 14:42:22 2001 @@ -56,14 +56,14 @@ // extends the base class class Spinach extends Vegetable { - var $cooked = false; + var $cooked = &false;; function Spinach() { - $this->Vegetable( true, "green" ); + $this->Vegetable( &true;, "green" ); } function cook_it() { - $this->cooked = true; + $this->cooked = &true;; } function is_cooked() { @@ -117,7 +117,7 @@ // instantiate 2 objects -$veggie = new Vegetable(true,"blue"); +$veggie = new Vegetable(&true;,"blue"); $leafy = new Spinach(); // print out information about objects @@ -291,9 +291,9 @@ </funcprototype> </funcsynopsis> <para> - This function returns true if the class given by + This function returns &true; if the class given by <parameter>class_name</parameter> has been defined, - false otherwise. + &false; otherwise. </para> </refsect1> </refentry> @@ -365,17 +365,17 @@ class myclass { // constructor function myclass() { - return(true); + return(&true;); } // method 1 function myfunc1() { - return(true); + return(&true;); } // method 2 function myfunc2() { - return(true); + return(&true;); } } @@ -448,7 +448,7 @@ // constructor function myclass() { - return(true); + return(&true;); } } @@ -631,9 +631,9 @@ </funcprototype> </funcsynopsis> <para> - This function returns true if the object <parameter>obj</parameter>, + This function returns &true; if the object <parameter>obj</parameter>, belongs to a class which is a subclass of - <parameter>superclass</parameter>, false otherwise. + <parameter>superclass</parameter>, &false; otherwise. </para> <simpara> See also <function>get_class</function>, @@ -656,9 +656,9 @@ </funcprototype> </funcsynopsis> <para> - This function returns true if the method given by + This function returns &true; if the method given by <parameter>method_name</parameter> has been defined for the given - <parameter>object</parameter>, false otherwise. + <parameter>object</parameter>, &false; otherwise. </para> </refsect1> </refentry> Index: phpdoc/en/functions/com.xml diff -u phpdoc/en/functions/com.xml:1.15 phpdoc/en/functions/com.xml:1.16 --- phpdoc/en/functions/com.xml:1.15 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/com.xml Sat Jul 7 14:42:22 2001 @@ -48,9 +48,9 @@ <listitem> <simpara> name of the DCOM server from which the component should be fetched. - If <literal>NULL</literal>, <literal>localhost</literal> is assumed. + If &null;, <literal>localhost</literal> is assumed. To allow DCOM <constant>com.allow_dcom</constant> has to be set to - <literal>TRUE</literal> in <filename>php.ini</filename>. + &true; in <filename>php.ini</filename>. </simpara> </listitem> </varlistentry> @@ -91,7 +91,7 @@ //free the object $word->Release(); -$word = null; +$word = &null;; </programlisting> </example> </para> @@ -131,8 +131,8 @@ $rs->Release(); $conn->Release(); -$rs = null; -$conn = null; +$rs = &null;; +$conn = &null;; </programlisting> </example> </para> @@ -232,7 +232,7 @@ </funcsynopsis> <para> <function>com_load</function> creates a new COM component and - returns a reference to it. Returns <literal>false</literal> on + returns a reference to it. Returns &false; on failiure.Possible values for <parameter>codepage</parameter> are <constant>CP_ACP</constant>, <constant>CP_MACCP</constant>, <constant>CP_OEMCP</constant>, <constant>CP_SYMBOL</constant>, @@ -267,7 +267,7 @@ <function>com_invoke</function> invokes a method of the COM component referenced by <parameter>com_object</parameter>. Returns - <literal>false</literal> on error, returns the + &false; on error, returns the <parameter>function_name</parameter>'s return value on success. </para> </refsect1> @@ -314,7 +314,7 @@ <para> Returns the value of the <parameter>property</parameter> of the COM component referenced by <parameter>com_object</parameter>. - Returns <literal>false</literal> on error. + Returns &false; on error. </para> </refsect1> </refentry> @@ -385,7 +385,7 @@ <para> Sets the value of the <parameter>property</parameter> of the COM component referenced by <parameter>com_object</parameter>. - Returns the newly set value if succeeded, <literal>false</literal> on error. + Returns the newly set value if succeeded, &false; on error. </para> </refsect1> </refentry> Index: phpdoc/en/functions/cpdf.xml diff -u phpdoc/en/functions/cpdf.xml:1.23 phpdoc/en/functions/cpdf.xml:1.24 --- phpdoc/en/functions/cpdf.xml:1.23 Sun May 20 23:26:27 2001 +++ phpdoc/en/functions/cpdf.xml Sat Jul 7 14:42:22 2001 @@ -1345,7 +1345,7 @@ <para> The last parameter <parameter>encoding</parameter> can take the following values: "MacRomanEncoding", "MacExpertEncoding", - "WinAnsiEncoding", and "NULL". "NULL" stands for the font's + "WinAnsiEncoding", and "&null;". "&null;" stands for the font's built-in encoding. </para> <para> Index: phpdoc/en/functions/ctype.xml diff -u phpdoc/en/functions/ctype.xml:1.6 phpdoc/en/functions/ctype.xml:1.7 --- phpdoc/en/functions/ctype.xml:1.6 Sun Jun 24 11:27:21 2001 +++ phpdoc/en/functions/ctype.xml Sat Jul 7 14:42:22 2001 @@ -16,12 +16,12 @@ <para> When called with a string argument they will check every character in the string and will only return - true if every character in the string matches the + &true; if every character in the string matches the requested criteria. </para> <para> Passing anything else but a string or integer will - return false immediately. + return &false; immediately. </para> <warning> <simpara> Index: phpdoc/en/functions/cybercash.xml diff -u phpdoc/en/functions/cybercash.xml:1.4 phpdoc/en/functions/cybercash.xml:1.5 --- phpdoc/en/functions/cybercash.xml:1.4 Fri Sep 15 12:09:43 2000 +++ phpdoc/en/functions/cybercash.xml Sat Jul 7 14:42:23 2001 @@ -28,7 +28,7 @@ </funcsynopsis> <para> The function returns an associative array with the elements - "errcode" and, if "errcode" is false, "outbuff" (string), + "errcode" and, if "errcode" is &false;, "outbuff" (string), "outLth" (long) and "macbuff" (string). </para> </refsect1> @@ -51,7 +51,7 @@ </funcsynopsis> <para> The function returns an associative array with the elements - "errcode" and, if "errcode" is false, "outbuff" (string), + "errcode" and, if "errcode" is &false;, "outbuff" (string), "outLth" (long) and "macbuff" (string). </para> </refsect1> Index: phpdoc/en/functions/datetime.xml diff -u phpdoc/en/functions/datetime.xml:1.41 phpdoc/en/functions/datetime.xml:1.42 --- phpdoc/en/functions/datetime.xml:1.41 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/datetime.xml Sat Jul 7 14:42:23 2001 @@ -18,7 +18,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the date given is valid; otherwise returns false. + Returns &true; if the date given is valid; otherwise returns &false;. Checks the validity of the date formed by the arguments. A date is considered valid if: <itemizedlist> Index: phpdoc/en/functions/dba.xml diff -u phpdoc/en/functions/dba.xml:1.9 phpdoc/en/functions/dba.xml:1.10 --- phpdoc/en/functions/dba.xml:1.9 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/dba.xml Sat Jul 7 14:42:24 2001 @@ -151,7 +151,7 @@ $key = dba_firstkey ($id); -while ($key != false) { +while ($key != &false;) { if (...) { # remember the key to perform some action later $handle_later[] = $key; } @@ -227,7 +227,7 @@ <function>dba_open</function>. </para> <para> - <function>dba_delete</function> returns <literal>true</literal> or <literal>false</literal>, if the entry is + <function>dba_delete</function> returns &true; or &false;, if the entry is deleted or not deleted, respectively. </para> <para> @@ -265,7 +265,7 @@ <function>dba_open</function>. </para> <para> - <function>dba_exists</function> returns <literal>true</literal> or <literal>false</literal>, if the key is found + <function>dba_exists</function> returns &true; or &false;, if the key is found or not found, respectively. </para> <para> @@ -304,7 +304,7 @@ </para> <para> - <function>dba_fetch</function> returns the associated string or <literal>false</literal>, if + <function>dba_fetch</function> returns the associated string or &false;, if the key/data pair is found or not found, respectively. </para> <para> @@ -339,7 +339,7 @@ <function>dba_open</function>. </para> <para> - <function>dba_firstkey</function> returns the key or <literal>false</literal> + <function>dba_firstkey</function> returns the key or &false; depending on whether it succeeds or fails, respectively. </para> <para> @@ -382,7 +382,7 @@ <function>dba_open</function>. </para> <para> - <function>dba_insert</function> returns <literal>true</literal> or <literal>false</literal>, depending on + <function>dba_insert</function> returns &true; or &false;, depending on whether it succeeds of fails, respectively. </para> <para> @@ -418,7 +418,7 @@ <function>dba_open</function>. </para> <para> - <function>dba_nextkey</function> returns the key or <literal>false</literal> depending on + <function>dba_nextkey</function> returns the key or &false; depending on whether it succeeds or fails, respectively. </para> <para> @@ -468,7 +468,7 @@ of them. </para> <para> - <function>dba_popen</function> returns a positive handle or <literal>false</literal>, in + <function>dba_popen</function> returns a positive handle or &false;, in the case the open is successful or fails, respectively. </para> <para> @@ -517,7 +517,7 @@ them. </para> <para> - <function>dba_open</function> returns a positive handle or <literal>false</literal>, in + <function>dba_open</function> returns a positive handle or &false;, in the case the open is successful or fails, respectively. </para> <para> @@ -550,7 +550,7 @@ <function>dba_open</function>. </para> <para> - <function>dba_optimize</function> returns <literal>true</literal> or <literal>false</literal>, if the + <function>dba_optimize</function> returns &true; or &false;, if the optimization succeeds or fails, respectively. </para> <para> @@ -591,7 +591,7 @@ <function>dba_open</function>. </para> <para> - <function>dba_replace</function> returns <literal>true</literal> or <literal>false</literal>, depending on + <function>dba_replace</function> returns &true; or &false;, depending on whether it succeeds of fails, respectively. </para> <para> @@ -625,7 +625,7 @@ <function>dba_open</function>. </para> <para> - <function>dba_sync</function> returns <literal>true</literal> or <literal>false</literal>, if the + <function>dba_sync</function> returns &true; or &false;, if the synchronization succeeds or fails, respectively. </para> <para> Index: phpdoc/en/functions/dbase.xml diff -u phpdoc/en/functions/dbase.xml:1.5 phpdoc/en/functions/dbase.xml:1.6 --- phpdoc/en/functions/dbase.xml:1.5 Mon Apr 23 22:45:58 2001 +++ phpdoc/en/functions/dbase.xml Sat Jul 7 14:42:24 2001 @@ -98,7 +98,7 @@ </para> <para> If the database is successfully created, a dbase_identifier is - returned, otherwise false is returned. + returned, otherwise &false; is returned. <example> <title>Creating a dBase database file</title> <programlisting role="php"> @@ -144,7 +144,7 @@ read and write.) </para> <para> - Returns a dbase_identifier for the opened database, or false if + Returns a dbase_identifier for the opened database, or &false; if the database couldn't be opened. </para> </refsect1> @@ -209,7 +209,7 @@ Adds the data in the <parameter>record</parameter> to the database. If the number of items in the supplied record isn't equal to the number of fields in the database, the operation will - fail and false will be returned. + fail and &false; will be returned. </para> </refsect1> </refentry> @@ -234,7 +234,7 @@ <parameter>record_number</parameter> with the data in the <parameter>record</parameter> in the database. If the number of items in the supplied record is not equal to the number of fields - in the database, the operation will fail and false will be + in the database, the operation will fail and &false; will be returned. </simpara> <simpara> Index: phpdoc/en/functions/dbm.xml diff -u phpdoc/en/functions/dbm.xml:1.6 phpdoc/en/functions/dbm.xml:1.7 --- phpdoc/en/functions/dbm.xml:1.6 Wed May 16 14:33:20 2001 +++ phpdoc/en/functions/dbm.xml Sat Jul 7 14:42:24 2001 @@ -53,7 +53,7 @@ </para> <para> Returns an identifer to be passed to the other DBM functions on - success, or false on failure. + success, or &false; on failure. </para> <para> If NDBM support is used, NDBM will actually create filename.dir @@ -106,7 +106,7 @@ </funcprototype> </funcsynopsis> <para> - Returns TRUE if there is a value associated with the + Returns &true; if there is a value associated with the <parameter>key</parameter>. </para> </refsect1> @@ -209,7 +209,7 @@ Deletes the value for <parameter>key</parameter> in the database. </para> <para> - Returns false if the key didn't exist in the database. + Returns &false; if the key didn't exist in the database. </para> </refsect1> </refentry> Index: phpdoc/en/functions/dbx.xml diff -u phpdoc/en/functions/dbx.xml:1.12 phpdoc/en/functions/dbx.xml:1.13 --- phpdoc/en/functions/dbx.xml:1.12 Sun Jun 24 11:27:21 2001 +++ phpdoc/en/functions/dbx.xml Sat Jul 7 14:42:24 2001 @@ -43,8 +43,8 @@ </funcprototype> </funcsynopsis> <para> - Returns <literal>TRUE</literal> on success, - <literal>FALSE</literal> on error. + Returns &true; on success, + &false; on error. </para> <example> <title><function>dbx_close</function> example</title> @@ -89,9 +89,9 @@ </funcprototype> </funcsynopsis> <para> - Returns: a dbx_link_object on success, <literal>FALSE</literal> + Returns: a dbx_link_object on success, &false; on error. If a connection has been made but the database could not - be selected, the connection is closed and <literal>FALSE</literal> + be selected, the connection is closed and &false; is returned. The 'persistent' parameter can be set to DBX_PERSISTENT so a persistent connection will be created. </para> @@ -389,8 +389,8 @@ </funcprototype> </funcsynopsis> <para> - Returns <literal>TRUE</literal> on success, - <literal>FALSE</literal> on error. + Returns &true; on success, + &false; on error. </para> <example> <title><function>dbx_sort</function> example</title> Index: phpdoc/en/functions/dir.xml diff -u phpdoc/en/functions/dir.xml:1.15 phpdoc/en/functions/dir.xml:1.16 --- phpdoc/en/functions/dir.xml:1.15 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/dir.xml Sat Jul 7 14:42:25 2001 @@ -17,8 +17,8 @@ </funcsynopsis> <para> Changes the root directory of the current process to - <parameter>directory</parameter>. Returns FALSE if unable to - change the root directory, TRUE otherwise. + <parameter>directory</parameter>. Returns &false; if unable to + change the root directory, &true; otherwise. </para> <note> <para> @@ -46,8 +46,8 @@ </funcsynopsis> <para> Changes PHP's current directory to - <parameter>directory</parameter>. Returns FALSE if unable to - change directory, TRUE otherwise. + <parameter>directory</parameter>. Returns &false; if unable to + change directory, &true; otherwise. </para> </refsect1> </refentry> @@ -151,7 +151,7 @@ <para> If <parameter>path</parameter> is not a valid directory or the directory can not be opened due to permission restrictions or - filesystem errors, <function>opendir</function> returns false and + filesystem errors, <function>opendir</function> returns &false; and generates a PHP error. You can suppress the error output of <function>opendir</function> by prepending `@' to the front of the function name. @@ -200,7 +200,7 @@ $handle=opendir('.'); echo "Directory handle: $handle\n"; echo "Files:\n"; -while (($file = readdir($handle))!==false) { +while (($file = readdir($handle))!==&false;) { echo "$file\n"; } closedir($handle); @@ -221,7 +221,7 @@ <programlisting role="php"> <?php $handle=opendir('.'); -while (false!==($file = readdir($handle))) { +while (&false;!==($file = readdir($handle))) { if ($file != "." && $file != "..") { echo "$file\n"; } Index: phpdoc/en/functions/errorfunc.xml diff -u phpdoc/en/functions/errorfunc.xml:1.12 phpdoc/en/functions/errorfunc.xml:1.13 --- phpdoc/en/functions/errorfunc.xml:1.12 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/errorfunc.xml Sat Jul 7 14:42:25 2001 @@ -315,7 +315,7 @@ <para> Sets a user function (<parameter>error_handler</parameter>) to handle errors in a script. Returns the previously defined error handler (if - any), or false on error. This function can be used for defining your own + any), or &false; on error. This function can be used for defining your own way of handling errors during runtime, for example in applications in which you need to do cleanup of data/files when a critical error happens, or when you need to trigger an error under certain conditions (using @@ -378,7 +378,7 @@ FATAL); if (!is_array($vect)) { trigger_error("Incorrect input vector, array of values expected", ERROR); - return null; + return &null;; } for ($i=0; $i<count($vect); $i++) { if (!is_numeric($vect[$i])) @@ -442,7 +442,7 @@ ---- vector c - an error <b>ERROR</b> [512] Incorrect input vector, array of values expected<br> -NULL +&null; ---- vector d - fatal error <b>FATAL</b> [256] log(x) for x <= 0 is undefined, you used: scale = -2.5<br> Index: phpdoc/en/functions/exec.xml diff -u phpdoc/en/functions/exec.xml:1.11 phpdoc/en/functions/exec.xml:1.12 --- phpdoc/en/functions/exec.xml:1.11 Sat May 19 16:39:20 2001 +++ phpdoc/en/functions/exec.xml Sat Jul 7 14:42:25 2001 @@ -238,7 +238,7 @@ PHP is running as a server module. </para> <para> - Returns the last line of the command output on success, and false + Returns the last line of the command output on success, and &false; on failure. </para> <para> Index: phpdoc/en/functions/fbsql.xml diff -u phpdoc/en/functions/fbsql.xml:1.11 phpdoc/en/functions/fbsql.xml:1.12 --- phpdoc/en/functions/fbsql.xml:1.11 Sun Jun 24 11:27:21 2001 +++ phpdoc/en/functions/fbsql.xml Sat Jul 7 14:42:26 2001 @@ -167,7 +167,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: <literal>TRUE</literal> on success, <literal>FALSE</literal> on error. + Returns: &true; on success, &false; on error. </para> <para> <function>fbsql_close</function> closes the connection to the FrontBase server that's associated with the specified link @@ -233,7 +233,7 @@ <function>fbsql_connect</function> establishes a connection to a FrontBase server. The following defaults are assumed for missing optional parameters: <parameter>hostname</parameter> = - 'NULL', <parameter>username</parameter> = '_SYSTEM' and + '&null;', <parameter>username</parameter> = '_SYSTEM' and <parameter>password</parameter> = empty password. </para> <para> @@ -365,7 +365,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: <literal>TRUE</literal> on success, <literal>FALSE</literal> on failure. + Returns: &true; on success, &false; on failure. </para> <para> <function>fbsql_data_seek</function> moves the internal row @@ -433,7 +433,7 @@ </funcsynopsis> <para> Returns: A positive FrontBase result identifier to the query result, - or <literal>FALSE</literal> on error. + or &false; on error. </para> <para> <function>fbsql_db_query</function> selects a database and @@ -468,7 +468,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: <literal>TRUE</literal> on success, <literal>FALSE</literal> on failure. + Returns: &true; on success, &false; on failure. </para> <para> <function>fbsql_drop_db</function> attempts to drop (remove) an @@ -600,7 +600,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an array that corresponds to the fetched row, or <literal>FALSE</literal> + Returns an array that corresponds to the fetched row, or &false; if there are no more rows.</para> <para> <function>fbsql_fetch_array</function> is an extended version of @@ -671,7 +671,7 @@ </funcsynopsis> <para> Returns an associative array that corresponds to the fetched row, - or <literal>FALSE</literal> if there are no more rows.</para> + or &false; if there are no more rows.</para> <para> <function>fbsql_fetch_assoc</function> is equivalent to calling <function>fbsql_fetch_array</function> with FBSQL_ASSOC for the @@ -762,7 +762,7 @@ </listitem> <listitem> <simpara> - not_null - 1 if the column cannot be null + not_null - 1 if the column cannot be &null; </simpara> </listitem> <listitem> @@ -827,7 +827,7 @@ <para> Returns: An array that corresponds to the lengths of each field in the last row fetched by <function>fbsql_fetch_row</function>, - or <literal>FALSE</literal> on error. + or &false; on error. </para> <para> <function>fbsql_fetch_lengths</function> stores the lengths of @@ -863,7 +863,7 @@ </funcsynopsis> <para> Returns an object with properties that correspond to the fetched - row, or <literal>FALSE</literal> if there are no more rows. + row, or &false; if there are no more rows. </para> <para> <function>fbsql_fetch_object</function> is similar to @@ -918,7 +918,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: An array that corresponds to the fetched row, or <literal>FALSE</literal> + Returns: An array that corresponds to the fetched row, or &false; if there are no more rows. </para> <para> @@ -929,7 +929,7 @@ </para> <para> Subsequent call to <function>fbsql_fetch_row</function> would - return the next row in the result set, or <literal>FALSE</literal> if there are no + return the next row in the result set, or &false; if there are no more rows. </para> <para> @@ -1394,8 +1394,8 @@ This function will test for additional results available form the server. if an additional result set exists it will free the existing result set and prepare to fetch the wors from the new result set. - The function will return <literal>TRUE</literal> if an additional result set was - available or <literal>FALSE</literal> othervise. + The function will return &true; if an additional result set was + available or &false; othervise. </para> <example> <title><function>fbsql_next_result</function> example</title> @@ -1513,7 +1513,7 @@ </funcsynopsis> <para> Returns: A positive FrontBase persistent link identifier on success, - or <literal>FALSE</literal> on error. + or &false; on error. </para> <para> <function>fbsql_pconnect</function> establishes a connection @@ -1577,16 +1577,16 @@ </para> </note> <para> - <function>fbsql_query</function> returns <literal>TRUE</literal> (non-zero) or <literal>FALSE</literal> + <function>fbsql_query</function> returns &true; (non-zero) or &false; to indicate whether or not the query succeeded. A return value - of <literal>TRUE</literal> means that the query was legal and could be executed by + of &true; means that the query was legal and could be executed by the server. It does not indicate anything about the number of rows affected or returned. It is perfectly possible for a query to succeed but affect no rows or return no rows. </para> <para> The following query is syntactically invalid, so - <function>fbsql_query</function> fails and returns <literal>FALSE</literal>: + <function>fbsql_query</function> fails and returns &false;: <example> <title><function>fbsql_query</function> example</title> <programlisting role="php"> @@ -1601,7 +1601,7 @@ The following query is semantically invalid if <literal>my_col</literal> is not a column in the table <literal>my_tbl</literal>, so <function>fbsql_query</function> - fails and returns <literal>FALSE</literal>: + fails and returns &false;: <example> <title><function>fbsql_query</function> example</title> <programlisting role="php"> @@ -1613,7 +1613,7 @@ </example> </para> <para> - <function>fbsql_query</function> will also fail and return <literal>FALSE</literal> + <function>fbsql_query</function> will also fail and return &false; if you don't have permission to access the table(s) referenced by the query. </para> @@ -1713,7 +1713,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: <literal>TRUE</literal> on success, <literal>FALSE</literal> on error. + Returns: &true; on success, &false; on error. </para> <para> <function>fbsql_select_db</function> sets the current active @@ -1800,7 +1800,7 @@ </funcprototype> </funcsynopsis> <para> - Returns <literal>TRUE</literal> if warnings is turned on otherwise <literal>FALSE</literal>. + Returns &true; if warnings is turned on otherwise &false;. </para> <para> <function>fbsql_warnings</function> enables or disables FrontBase Index: phpdoc/en/functions/fdf.xml diff -u phpdoc/en/functions/fdf.xml:1.10 phpdoc/en/functions/fdf.xml:1.11 --- phpdoc/en/functions/fdf.xml:1.10 Wed May 16 14:33:20 2001 +++ phpdoc/en/functions/fdf.xml Sat Jul 7 14:42:26 2001 @@ -305,7 +305,7 @@ The <function>fdf_next_field_name</function> function returns the name of the field after the field in <parameter>fieldname</parameter> or the field name of the first field - if the second paramter is NULL.</para> + if the second paramter is &null;.</para> <para> See also <function>fdf_set_field</function>, Index: phpdoc/en/functions/filesystem.xml diff -u phpdoc/en/functions/filesystem.xml:1.72 phpdoc/en/functions/filesystem.xml:1.73 --- phpdoc/en/functions/filesystem.xml:1.72 Thu Jun 28 11:46:49 2001 +++ phpdoc/en/functions/filesystem.xml Sat Jul 7 14:42:26 2001 @@ -69,7 +69,7 @@ a file to any group of which that user is a member. </para> <para> - Returns true on success; otherwise returns false. + Returns &true; on success; otherwise returns &false;. </para> <para> See also <function>chown</function> and @@ -116,7 +116,7 @@ </informalexample> </para> <para> - Returns true on success and false otherwise. + Returns &true; on success and &false; otherwise. </para> <para> See also <function>chown</function> and @@ -149,7 +149,7 @@ user. Only the superuser may change the owner of a file. </para> <para> - Returns true on success; otherwise returns false. + Returns &true; on success; otherwise returns &false;. </para> <para> See also <function>chown</function> and @@ -227,8 +227,8 @@ </funcprototype> </funcsynopsis> <para> - Makes a copy of a file. Returns true if the copy succeeded, - false otherwise. + Makes a copy of a file. Returns &true; if the copy succeeded, + &false; otherwise. <example> <title><function>copy</function> example</title> <programlisting role="php"> @@ -382,7 +382,7 @@ The file pointed to by <parameter>fp</parameter> is closed. </para> <para> - Returns <literal>TRUE</literal> on success and <literal>FALSE</literal> + Returns &true; on success and &false; on failure. </para> <para> @@ -407,8 +407,8 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the file pointer is at EOF or an error occurs; - otherwise returns false. + Returns &true; if the file pointer is at EOF or an error occurs; + otherwise returns &false;. </para> <para> The file pointer must be valid, and must point to a file @@ -434,7 +434,7 @@ <para> This function forces a write of all buffered output to the to the resource pointed to by the file handle - <parameter>fp</parameter>. Returns true if succesful, false + <parameter>fp</parameter>. Returns &true; if succesful, &false; otherwise. </para> <para> @@ -460,7 +460,7 @@ </funcsynopsis> <para> Returns a string containing a single character read from the - file pointed to by fp. Returns FALSE on EOF. + file pointed to by fp. Returns &false; on EOF. </para> <para> The file pointer must be valid, and must point to a file @@ -513,12 +513,12 @@ CSV file (allowing for trailing line-end characters). </simpara> <simpara> - <function>fgetcsv</function> returns false on error, including + <function>fgetcsv</function> returns &false; on error, including end of file. </simpara> <simpara> N.B. A blank line in a CSV file will be returned as an array - comprising a single null field, and will not be treated as an + comprising a single &null; field, and will not be treated as an error. </simpara> <example> @@ -564,7 +564,7 @@ EOF (whichever comes first). </para> <para> - If an error occurs, returns false. + If an error occurs, returns &false;. </para> <para> Common Pitfalls: @@ -712,8 +712,8 @@ </funcprototype> </funcsynopsis> <simpara> - Returns true if the file specified by - <parameter>filename</parameter> exists; false otherwise. + Returns &true; if the file specified by + <parameter>filename</parameter> exists; &false; otherwise. </simpara> <simpara> This function will not work on <link @@ -742,7 +742,7 @@ </funcprototype> </funcsynopsis> <simpara> - Returns the time the file was last accessed, or false in case of + Returns the time the file was last accessed, or &false; in case of an error. The time is returned as a Unix timestamp. </simpara> <simpara> @@ -781,7 +781,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the time the file was last changed, or false in case of + Returns the time the file was last changed, or &false; in case of an error. The time is returned as a Unix timestamp. </para> <para> @@ -823,7 +823,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the group ID of the owner of the file, or false in case + Returns the group ID of the owner of the file, or &false; in case of an error. The group ID is returned in numerical format, use <function>posix_getgrgid</function> to resolve it to a group name. </para> @@ -858,7 +858,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the inode number of the file, or false in case of an + Returns the inode number of the file, or &false; in case of an error.</para> <para> The results of this function are cached. See @@ -891,7 +891,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the time the file was last modified, or false in case of + Returns the time the file was last modified, or &false; in case of an error. The time is returned as a Unix timestamp. </para> <para> @@ -926,7 +926,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the user ID of the owner of the file, or false in case of + Returns the user ID of the owner of the file, or &false; in case of an error. The user ID is returned in numerical format, use <function>posix_getpwuid</function> to resolve it to a username. </para> @@ -961,7 +961,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the permissions on the file, or false in case of an error. + Returns the permissions on the file, or &false; in case of an error. </para> <simpara> This function will not work on <link @@ -989,7 +989,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the size of the file, or false in case of an error. + Returns the size of the file, or &false; in case of an error. </para> <para> The results of this function are cached. See @@ -1018,7 +1018,7 @@ </funcsynopsis> <para> Returns the type of the file. Possible values are fifo, char, - dir, block, link, file, and unknown.</para> <para> Returns false + dir, block, link, file, and unknown.</para> <para> Returns &false; if an error occurs. </para> <para> @@ -1099,11 +1099,11 @@ <function>flock</function> allows you to perform a simple reader/writer model which can be used on virtually every platform (including most Unices and even Windows). The optional 3rd - argument is set to true if the lock would block (EWOULDBLOCK + argument is set to &true; if the lock would block (EWOULDBLOCK errno condition) </simpara> <simpara> - <function>flock</function> returns true on success and false on + <function>flock</function> returns &true; on success and &false; on error (e.g. when a lock could not be acquired). </simpara> <warning> @@ -1169,7 +1169,7 @@ the file opened is returned. </simpara> <simpara> - If the open fails, the function returns false. + If the open fails, the function returns &false;. </simpara> <para> <parameter>mode</parameter> may be any of the following: @@ -1285,7 +1285,7 @@ </simpara> <simpara> If an error occurs, <function>fpassthru</function> returns - false. + &false;. </simpara> <simpara> The file pointer must be valid, and must point to a file @@ -1572,7 +1572,7 @@ its offset into the file stream. </para> <para> - If an error occurs, returns false. + If an error occurs, returns &false;. </para> <para> The file pointer must be valid, and must point to a file @@ -1604,7 +1604,7 @@ </funcsynopsis> <para> Takes the filepointer, fp, and truncates the file to length, size. - This function returns true on success and false on failure. + This function returns &true; on success and &false; on failure. </para> </refsect1> </refentry> @@ -1727,7 +1727,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the filename exists and is a directory. + Returns &true; if the filename exists and is a directory. </para> <para> The results of this function are cached. See @@ -1759,7 +1759,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the filename exists and is executable. + Returns &true; if the filename exists and is executable. </para> <para> The results of this function are cached. See @@ -1793,7 +1793,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the filename exists and is a regular file. + Returns &true; if the filename exists and is a regular file. </para> <para> The results of this function are cached. See @@ -1822,7 +1822,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the filename exists and is a symbolic link. + Returns &true; if the filename exists and is a symbolic link. </para> <para> The results of this function are cached. See @@ -1861,7 +1861,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the filename exists and is readable. + Returns &true; if the filename exists and is readable. </para> <para> Keep in mind that PHP may be accessing the file as the user @@ -1897,7 +1897,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the filename exists and is writable. The + Returns &true; if the filename exists and is writable. The filename argument may be a directory name allowing you to check if a directory is writeable. </para> @@ -1960,7 +1960,7 @@ </para> <para> - Returns true if the file named by <varname>filename</varname> was + Returns &true; if the file named by <varname>filename</varname> was uploaded via HTTP POST. This is useful to help ensure that a malicious user hasn't tried to trick the script into working on files upon which it should not be working--for instance, @@ -2029,7 +2029,7 @@ UNIX C stat structure returned by the lstat system call. This function is used to verify if a link (pointed to by <parameter>path</parameter>) really exists (using the same method - as the S_ISLNK macro defined in stat.h). Returns 0 or FALSE in + as the S_ISLNK macro defined in stat.h). Returns 0 or &false; in case of error. </para> <para> @@ -2071,7 +2071,7 @@ </informalexample> </para> <para> - Returns true on success and false on failure. + Returns &true; on success and &false; on failure. </para> <para> See also <function>rmdir</function>. @@ -2111,14 +2111,14 @@ If <parameter>filename</parameter> is not a valid upload file, then no action will occur, and <function>move_uploaded_file</function> will return - <literal>false</literal>. + &false;. </para> <para> If <parameter>filename</parameter> is a valid upload file, but cannot be moved for some reason, no action will occur, and <function>move_uploaded_file</function> will return - <literal>false</literal>. Additionally, a warning will be issued. + &false;. Additionally, a warning will be issued. </para> <para> @@ -2249,7 +2249,7 @@ <function>fputs</function>. </para> <para> - If an error occurs, returns false. + If an error occurs, returns &false;. </para> <para> <informalexample> @@ -2287,7 +2287,7 @@ </para> <para> Returns the number of bytes read from the file. If an error - occurs, false is returned and unless the function was called as + occurs, &false; is returned and unless the function was called as @readfile, an error message is printed. </para> <para> @@ -2375,7 +2375,7 @@ <parameter>newname</parameter>. </para> <para> - Returns true on success and false on failure. + Returns &true; on success and &false; on failure. </para> </refsect1> </refentry> @@ -2472,7 +2472,7 @@ systems (i.e. Windows) return -1. </para> <para> - Returns <literal>FALSE</literal> in case of error. + Returns &false; in case of error. </para> <para> <function>stat</function> doesn't handle URL as does <function>fopen</function>. @@ -2627,7 +2627,7 @@ tempnam(3) function if in doubt. </para> <para> - Returns the new temporary filename, or the null string on + Returns the new temporary filename, or the &null; string on failure. <example> <title><function>tempnam</function> example</title> @@ -2709,7 +2709,7 @@ If the file does not exist, it is created. </para> <para> - Returns true on success and false otherwise. + Returns &true; on success and &false; otherwise. <example> <title><function>touch</function> example</title> <programlisting role="php"> @@ -2773,7 +2773,7 @@ unlink() function. </para> <para> - Returns 0 or FALSE on an error. + Returns 0 or &false; on an error. </para> <para> See also <function>rmdir</function> for removing directories. Index: phpdoc/en/functions/ftp.xml diff -u phpdoc/en/functions/ftp.xml:1.14 phpdoc/en/functions/ftp.xml:1.15 --- phpdoc/en/functions/ftp.xml:1.14 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/ftp.xml Sat Jul 7 14:42:26 2001 @@ -67,7 +67,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a FTP stream on success, false on error.</para> + Returns a FTP stream on success, &false; on error.</para> <para> <function>ftp_connect</function> opens up a FTP connection to the specified <parameter>host</parameter>. The <parameter>port</parameter> @@ -93,7 +93,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> Logs in the given FTP stream.</para> </refsect1> @@ -113,7 +113,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the current directory, or false on error.</para> + Returns the current directory, or &false; on error.</para> </refsect1> </refentry> @@ -131,7 +131,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> Changes to the parent directory.</para> </refsect1> @@ -152,7 +152,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> Changes to the specified <parameter>directory</parameter>.</para> </refsect1> @@ -173,7 +173,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the newly created directory name on success, false on error.</para> + Returns the newly created directory name on success, &false; on error.</para> <para> Creates the specified <parameter>directory</parameter>.</para> </refsect1> @@ -194,7 +194,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> Removes the specified <parameter>directory</parameter>.</para> </refsect1> @@ -215,7 +215,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an array of filenames on success, false on error.</para> + Returns an array of filenames on success, &false; on error.</para> </refsect1> </refentry> @@ -260,7 +260,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the remote system type, or false on error.</para> + Returns the remote system type, or &false; on error.</para> </refsect1> </refentry> @@ -279,11 +279,11 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> <function>ftp_pasv</function> turns on passive mode if the - <parameter>pasv</parameter> parameter is true (it turns off - passive mode if <parameter>pasv</parameter> is false.) In + <parameter>pasv</parameter> parameter is &true; (it turns off + passive mode if <parameter>pasv</parameter> is &false;.) In passive mode, data connections are initiated by the client, rather than by the server.</para> </refsect1> @@ -306,7 +306,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> <function>ftp_get</function> retrieves <parameter>remote_file</parameter> from the FTP server, and saves it to <parameter>local_file</parameter> @@ -335,7 +335,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> <function>ftp_fget</function> retrieves <parameter>remote_file</parameter> from the FTP server, and writes it to the given file pointer, @@ -361,7 +361,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> <function>ftp_put</function> stores <parameter>local_file</parameter> on the FTP server, as <parameter>remote_file</parameter>. The transfer @@ -396,7 +396,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> <function>ftp_fput</function> uploads the data from the file pointer <parameter>fp</parameter> until end of file. The results are stored @@ -476,7 +476,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> <function>ftp_rename</function> renames the file specified by <parameter>from</parameter> to the new name @@ -500,7 +500,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> <function>ftp_delete</function> deletes the file specified by <parameter>path</parameter> from the FTP server. @@ -523,7 +523,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> <function>ftp_site</function> sends the command specified by <parameter>cmd</parameter> to the FTP server. SITE commands Index: phpdoc/en/functions/funchand.xml diff -u phpdoc/en/functions/funchand.xml:1.13 phpdoc/en/functions/funchand.xml:1.14 --- phpdoc/en/functions/funchand.xml:1.13 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/funchand.xml Sat Jul 7 14:42:27 2001 @@ -173,9 +173,9 @@ } // create a bunch of math functions -$f1 = 'if ($a >=0) {return "b*a^2 = ".$b*sqrt($a);} else {return false;}'; +$f1 = 'if ($a >=0) {return "b*a^2 = ".$b*sqrt($a);} else {return &false;;}'; $f2 = "return \"min(b^2+a, a^2,b) = \".min(\$a*\$a+\$b,\$b*\$b+\$a);"; -$f3 = 'if ($a > 0 && $b != 0) {return "ln(a)/b = ".log($a)/$b;} else {return false;}'; +$f3 = 'if ($a > 0 && $b != 0) {return "ln(a)/b = ".log($a)/$b;} else {return &false;;}'; $farr = array( create_function('$x,$y', 'return "some trig: ".(sin($x) + $x*cos($y));'), create_function('$x,$y', 'return "a hypotenuse: ".sqrt($x*$x + $y*$y);'), @@ -287,7 +287,7 @@ <simpara> If <parameter>arg_num</parameter> is greater than the number of arguments actually passed, a warning will be generated and - <function>func_get_arg</function> will return FALSE. + <function>func_get_arg</function> will return &false;. </simpara> <para> <informalexample> @@ -429,7 +429,7 @@ <refnamediv> <refname>function_exists</refname> <refpurpose> - Return true if the given function has been defined + Return &true; if the given function has been defined </refpurpose> </refnamediv> <refsect1> @@ -442,8 +442,8 @@ </funcsynopsis> <para> Checks the list of defined functions for - <parameter>function_name</parameter>. Returns true if the given - function name was found, false otherwise. + <parameter>function_name</parameter>. Returns &true; if the given + function name was found, &false; otherwise. <informalexample> <programlisting role="php"> if (function_exists('imap_open')) { Index: phpdoc/en/functions/gettext.xml diff -u phpdoc/en/functions/gettext.xml:1.8 phpdoc/en/functions/gettext.xml:1.9 --- phpdoc/en/functions/gettext.xml:1.8 Fri Jul 6 18:50:40 2001 +++ phpdoc/en/functions/gettext.xml Sat Jul 7 14:42:27 2001 @@ -129,7 +129,7 @@ This function sets the domain to search within when calls are made to <function>gettext</function>, usually the named after an application. The previous default domain is returned. - Call it with NULL as parameter to get the current setting without + Call it with &null; as parameter to get the current setting without changing it. </para> </refsect1> Index: phpdoc/en/functions/gmp.xml diff -u phpdoc/en/functions/gmp.xml:1.10 phpdoc/en/functions/gmp.xml:1.11 --- phpdoc/en/functions/gmp.xml:1.10 Thu May 17 10:06:31 2001 +++ phpdoc/en/functions/gmp.xml Sat Jul 7 14:42:28 2001 @@ -590,8 +590,8 @@ </funcprototype> </funcsynopsis> <para> - Returns true if <parameter>a</parameter> is a perfect square, - false otherwise. + Returns &true; if <parameter>a</parameter> is a perfect square, + &false; otherwise. </para> <para> See also: <function>gmp_sqrt</function>, @@ -734,7 +734,7 @@ </funcsynopsis> <para> Computes the inverse of <parameter>a</parameter> modulo - <parameter>b</parameter>. Returns false if an inverse does not + <parameter>b</parameter>. Returns &false; if an inverse does not exist. </para> </refsect1> Index: phpdoc/en/functions/http.xml diff -u phpdoc/en/functions/http.xml:1.19 phpdoc/en/functions/http.xml:1.20 --- phpdoc/en/functions/http.xml:1.19 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/http.xml Sat Jul 7 14:42:28 2001 @@ -32,13 +32,13 @@ <para> The optional <parameter>replace</parameter> parameter indicates whether the header should replace a previous similar header, or add a second header - of the same type. By default it will replace, but if you pass in false as + of the same type. By default it will replace, but if you pass in &false; as the second argument you can force multiple headers of the same type. For example: <informalexample> <programlisting role="php"> header('www-authenticate: Negociate'); -header('www-authenticate: NTLM',false); +header('www-authenticate: NTLM',&false;); </programlisting> </informalexample> </para> @@ -114,7 +114,7 @@ <refentry id="function.headers-sent"> <refnamediv> <refname>headers_sent</refname> - <refpurpose>Returns true if headers have been sent</refpurpose> + <refpurpose>Returns &true; if headers have been sent</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -125,8 +125,8 @@ </funcprototype> </funcsynopsis> <para> - This function returns true if the HTTP headers have already been - sent, false otherwise. + This function returns &true; if the HTTP headers have already been + sent, &false; otherwise. </para> <para> See also <function>header</function> Index: phpdoc/en/functions/hw.xml diff -u phpdoc/en/functions/hw.xml:1.10 phpdoc/en/functions/hw.xml:1.11 --- phpdoc/en/functions/hw.xml:1.10 Thu May 17 23:23:13 2001 +++ phpdoc/en/functions/hw.xml Sat Jul 7 14:42:28 2001 @@ -448,8 +448,8 @@ </funcprototype> </funcsynopsis> <para> - Returns false if connection is not a valid connection index, - otherwise true. Closes down the connection to a Hyperwave server + Returns &false; if connection is not a valid connection index, + otherwise &true;. Closes down the connection to a Hyperwave server with the given connection index. </para> </refsect1> @@ -473,7 +473,7 @@ </funcsynopsis> <para> Opens a connection to a Hyperwave server and returns a connection - index on success, or false if the connection + index on success, or &false; if the connection could not be made. Each of the arguments should be a quoted string, except for the port number. The <parameter>username</parameter> and <parameter>password</parameter> arguments are @@ -538,7 +538,7 @@ parameter. It will delete all instances of the object. </para> <para> - Returns TRUE if no error occurs otherwise FALSE. + Returns &true; if no error occurs otherwise &false;. </para> <para> See also <function>hw_mv</function>. @@ -740,7 +740,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a string containing the last error message or 'No Error'. If false + Returns a string containing the last error message or 'No Error'. If &false; is returned, this function failed. The message relates to the last command. </para> @@ -1569,7 +1569,7 @@ the object record of the new document contains at least the attributes: Type, DocumentType, Title and Name. Possibly you also want to set the MimeType. The functions returns the - object id of the new document or false. + object id of the new document or &false;. </para> <para> See also <function>hw_pipedocument</function>. @@ -1802,7 +1802,7 @@ </note> </para> <para> - Returns TRUE if no error occurs otherwise FALSE. + Returns &true; if no error occurs otherwise &false;. </para> </refsect1> </refentry> @@ -1920,7 +1920,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a connection index on success, or false if the connection + Returns a connection index on success, or &false; if the connection could not be made. Opens a persistent connection to a Hyperwave server. Each of the arguments should be a quoted string, except for the port number. The <parameter>username</parameter> Index: phpdoc/en/functions/icap.xml diff -u phpdoc/en/functions/icap.xml:1.7 phpdoc/en/functions/icap.xml:1.8 --- phpdoc/en/functions/icap.xml:1.7 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/icap.xml Sat Jul 7 14:42:28 2001 @@ -28,7 +28,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an ICAP stream on success, false on error.</para> + Returns an ICAP stream on success, &false; on error.</para> <para> <function>icap_open</function> opens up an ICAP connection to the specified <parameter>calendar</parameter> store. If the optional @@ -91,7 +91,7 @@ </listitem> <listitem> <simpara> - int public - TRUE if the event if public, FALSE if it is private. + int public - &true; if the event if public, &false; if it is private. </simpara> </listitem> <listitem> @@ -320,7 +320,7 @@ </itemizedlist> </para> <para> - Returns true on success and false on error. + Returns &true; on success and &false; on error. </para> </refsect1> </refentry> @@ -344,7 +344,7 @@ specified by the <parameter>uid</parameter>. </para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> @@ -368,7 +368,7 @@ calendar event specified by the <parameter>uid</parameter>. </para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> Index: phpdoc/en/functions/iconv.xml diff -u phpdoc/en/functions/iconv.xml:1.2 phpdoc/en/functions/iconv.xml:1.3 --- phpdoc/en/functions/iconv.xml:1.2 Mon Jul 2 13:55:34 2001 +++ phpdoc/en/functions/iconv.xml Sat Jul 7 14:42:29 2001 @@ -41,7 +41,7 @@ It converts the string <parameter>string</parameter> encoded in <parameter>in_charset</parameter> to the string encoded in <parameter>out_charset</parameter>. It returns the converted - string or <literal>FALSE</literal>, if it fails. + string or &false;, if it fails. </para> <para> <example> @@ -74,7 +74,7 @@ <para> It returns the current settings of <function>ob_iconv_handler</function> as array or - <literal>FALSE</literal> in failure. + &false; in failure. </para> <para> See also: @@ -102,8 +102,8 @@ </funcsynopsis> <para> It changes the value of <parameter>type</parameter> to - <parameter>charset</parameter> and returns <literal>TRUE</literal> in success or - <literal>FALSE</literal> in failure. + <parameter>charset</parameter> and returns &true; in success or + &false; in failure. </para> <para> <example> Index: phpdoc/en/functions/ifx.xml diff -u phpdoc/en/functions/ifx.xml:1.12 phpdoc/en/functions/ifx.xml:1.13 --- phpdoc/en/functions/ifx.xml:1.12 Sat Feb 24 22:10:23 2001 +++ phpdoc/en/functions/ifx.xml Sat Jul 7 14:42:29 2001 @@ -41,7 +41,7 @@ INFORMIX bin directory is in the PATH. Check this by running a script that contains a call to <function>phpinfo()</function> before you start testing. The <function>phpinfo()</function> - output should list these environment variables. This is true for + output should list these environment variables. This is &true; for both CGI php and Apache mod_php. You may have to set these environment variables in your Apache startup script. </para> @@ -151,13 +151,13 @@ </para> </note> <note> - <title>NULL values</title> + <title>&null; values</title> <para> The configuration variable ifx.nullformat (and the runtime - function <function>ifx_nullformat</function>) when set to true - will return NULL columns as the string "NULL", when set to false + function <function>ifx_nullformat</function>) when set to &true; + will return &null; columns as the string "&null;", when set to &false; they return the empty string. This allows you to discriminate - between NULL columns and empty columns. + between &null; columns and empty columns. </para> </note> </partintro> @@ -181,7 +181,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a connection identifier on success, or FALSE on + Returns a connection identifier on success, or &false; on error. </para> <para> @@ -241,7 +241,7 @@ </funcsynopsis> <para> Returns: A positive Informix persistent link identifier on success, - or false on error + or &false; on error </para> <para> <function>ifx_pconnect</function> acts very much like @@ -286,7 +286,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: always true. + Returns: always &true;. </para> <para> <function>ifx_close</function> closes the link to an Informix @@ -344,7 +344,7 @@ </funcsynopsis> <para> Returns: A positive Informix result identifier on success, or - false on error. + &false; on error. </para> <para> A "result_id" resource used by other functions to retrieve the @@ -512,7 +512,7 @@ </funcprototype> </funcsynopsis> <para> - Returns TRUE on success, FALSE on error. + Returns &true; on success, &false; on error. </para> <para> Executes a previously prepared query or opens a cursor for it. @@ -750,13 +750,13 @@ </funcsynopsis> <para> Returns an associative array that corresponds to the fetched row, - or false if there are no more rows. + or &false; if there are no more rows. </para> <para> Blob columns are returned as integer blob id values for use in <function>ifx_get_blob</function> unless you have used ifx_textasvarchar(1) or ifx_byteasvarchar(1), in which case blobs - are returned as string values. Returns FALSE on error + are returned as string values. Returns &false; on error </para> <para> <parameter>result_id</parameter> is a valid resultid returned by @@ -778,7 +778,7 @@ </para> <para> Subsequent calls to <function>ifx_fetch_row</function> would - return the next row in the result set, or false if there are no + return the next row in the result set, or &false; if there are no more rows. </para> <example> @@ -831,7 +831,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the number of rows fetched or FALSE on error. + Returns the number of rows fetched or &false; on error. </para> <para> Formats all rows of the <parameter>result_id</parameter> query @@ -879,7 +879,7 @@ <para> Returns an associative array with fieldnames as key and the SQL fieldtypes as data for query with - <parameter>result_id</parameter>. Returns FALSE on error. + <parameter>result_id</parameter>. Returns &false; on error. </para> <example> <title>Fielnames and SQL fieldtypes</title> @@ -914,13 +914,13 @@ <para> Returns an associative array with fieldnames as key and the SQL fieldproperties as data for a query with - <parameter>result_id</parameter>. Returns FALSE on error. + <parameter>result_id</parameter>. Returns &false; on error. </para> <para> Returns the Informix SQL fieldproperies of every field in the query as an associative array. Properties are encoded as: - "SQLTYPE;length;precision;scale;ISNULLABLE" where SQLTYPE = the - Informix type like "SQLVCHAR" etc. and ISNULLABLE = "Y" or "N". + "SQLTYPE;length;precision;scale;ISnullABLE" where SQLTYPE = the + Informix type like "SQLVCHAR" etc. and ISnullABLE = "Y" or "N". </para> <example> <title>Informix SQL fieldproperties</title> @@ -954,7 +954,7 @@ </funcsynopsis> <para> Returns the number of columns in query for - <parameter>result_id</parameter> or FALSE on error + <parameter>result_id</parameter> or &false; on error </para> <para> After preparing or executing a query, this call gives you the @@ -1000,7 +1000,7 @@ </funcsynopsis> <para> Releases resources for the query associated with - <parameter>result_id</parameter>. Returns FALSE on error. + <parameter>result_id</parameter>. Returns &false; on error. </para> </refsect1> </refentry> @@ -1040,8 +1040,8 @@ </funcsynopsis> <para> Deletes the charobject for the given char object-id - <parameter>bid</parameter>. Returns FALSE on error otherwise - TRUE. + <parameter>bid</parameter>. Returns &false; on error otherwise + &true;. </para> </refsect1> </refentry> @@ -1063,7 +1063,7 @@ <para> Updates the content of the char object for the given char object <parameter>bid</parameter>. <parameter>content</parameter> is a - string with new data. Returns FALSE on error otherwise TRUE. + string with new data. Returns &false; on error otherwise &true;. </para> </refsect1> </refentry> @@ -1118,7 +1118,7 @@ if mode = 1: pointer to the filestring. </para> <para> - Return FALSE on error, otherwise the new blob object-id. + Return &false; on error, otherwise the new blob object-id. </para> </refsect1> </refentry> @@ -1141,7 +1141,7 @@ the ID of the blob object. </para> <para> - Returns FALSE on error otherwise the new blob object-id. + Returns &false; on error otherwise the new blob object-id. </para> </refsect1> </refentry> @@ -1161,8 +1161,8 @@ </funcsynopsis> <para> Deletes the blobobject for the given blob object-id - <parameter>bid</parameter>. Returns FALSE on error otherwise - TRUE. + <parameter>bid</parameter>. Returns &false; on error otherwise + &true;. </para> </refsect1> </refentry> @@ -1204,7 +1204,7 @@ <para> Updates the content of the blob object for the given blob object <parameter>bid</parameter>. <parameter>content</parameter> is a - string with new data. Returns FALSE on error otherwise TRUE. + string with new data. Returns &false; on error otherwise &true;. </para> </refsect1> </refentry> @@ -1288,8 +1288,8 @@ </funcprototype> </funcsynopsis> <para> - Sets the default return value of a NULL-value on a fetch row. - Mode "0" returns "", and mode "1" returns "NULL". + Sets the default return value of a &null;-value on a fetch row. + Mode "0" returns "", and mode "1" returns "&null;". </para> </refsect1> </refentry> @@ -1311,7 +1311,7 @@ Creates an slob object and opens it. Modes: 1 = LO_RDONLY, 2 = LO_WRONLY, 4 = LO_APPEND, 8 = LO_RDWR, 16 = LO_BUFFER, 32 = LO_NOBUFFER -> or-mask. You can also use constants named - IFX_LO_RDONLY, IFX_LO_WRONLY etc. Return FALSE on error otherwise + IFX_LO_RDONLY, IFX_LO_WRONLY etc. Return &false; on error otherwise the new slob object-id. </para> </refsect1> @@ -1332,7 +1332,7 @@ </funcsynopsis> <para> Deletes the slob object. <parameter>bid</parameter> is the Id of - the slob object. Returns FALSE on error otherwise TRUE. + the slob object. Returns &false; on error otherwise &true;. </para> </refsect1> </refentry> @@ -1352,8 +1352,8 @@ </funcsynopsis> <para> Deletes the slob object on the given slob object-id - <parameter>bid</parameter>. Return FALSE on error otherwise - TRUE. + <parameter>bid</parameter>. Return &false; on error otherwise + &true;. </para> </refsect1> </refentry> @@ -1376,7 +1376,7 @@ Opens an slob object. <parameter>bid</parameter> should be an existing slob id. Modes: 1 = LO_RDONLY, 2 = LO_WRONLY, 4 = LO_APPEND, 8 = LO_RDWR, 16 = LO_BUFFER, 32 = LO_NOBUFFER -> - or-mask. Returns FALSE on error otherwise the new slob + or-mask. Returns &false; on error otherwise the new slob object-id. </para> </refsect1> @@ -1398,7 +1398,7 @@ <para> Returns the current file or seek position of an open slob object <parameter>bid</parameter> should be an existing slob id. Return - FALSE on error otherwise the seek position. + &false; on error otherwise the seek position. </para> </refsect1> </refentry> @@ -1422,7 +1422,7 @@ Sets the current file or seek position of an open slob object. <parameter>bid</parameter> should be an existing slob id. Modes: 0 = LO_SEEK_SET, 1 = LO_SEEK_CUR, 2 = LO_SEEK_END and - <parameter>offset</parameter> is an byte offset. Return FALSE on + <parameter>offset</parameter> is an byte offset. Return &false; on error otherwise the seek position. </para> </refsect1> @@ -1445,7 +1445,7 @@ <para> Reads nbytes of the slob object. <parameter>bid</parameter> is a existing slob id and <parameter>nbytes</parameter> is the number - of bytes zu read. Return FALSE on error otherwise the string. + of bytes zu read. Return &false; on error otherwise the string. </para> </refsect1> </refentry> @@ -1467,7 +1467,7 @@ <para> Writes a string into the slob object. <parameter>bid</parameter> is a existing slob id and <parameter>content</parameter> the - content to write. Return FALSE on error otherwise bytes written. + content to write. Return &false; on error otherwise bytes written. </para> </refsect1> </refentry> Index: phpdoc/en/functions/image.xml diff -u phpdoc/en/functions/image.xml:1.44 phpdoc/en/functions/image.xml:1.45 --- phpdoc/en/functions/image.xml:1.44 Tue Jun 12 20:01:10 2001 +++ phpdoc/en/functions/image.xml Sat Jul 7 14:42:29 2001 @@ -88,7 +88,7 @@ <para> If accessing the <parameter>filename</parameter> image is impossible, or if it isn't a valid picture, <function>getimagesize</function> - will return <literal>NULL</literal> and generate a warning. + will return &null; and generate a warning. </para> <para> The optional <parameter>imageinfo</parameter> parameter allows @@ -143,7 +143,7 @@ </funcsynopsis> <para> <function>ImageAlphaBlending</function> allows for two different - modes of drawing on truecolor images. In blending mode, the + modes of drawing on &true;color images. In blending mode, the alpha channel component of the color supplied to all drawing function, such as <function>ImageSetPixel</function> determines how much of the underlying color shouldbe allowed to shine through. As a result, gd @@ -152,7 +152,7 @@ non-blending mode, the drawing color is copied literally with its alpha channel information, replacing the destination pixel. Blending mode is not available when drawing on palette images. - If <parameter>blendmode</parameter> is true, then blending mode is enabled, otherwise + If <parameter>blendmode</parameter> is &true;, then blending mode is enabled, otherwise disabled. </para> <note><para>This function was added in PHP 4.0.6 and requires GD 2.0.1</para></note> @@ -1069,8 +1069,8 @@ <refentry id="function.imagecreatetruecolor"> <refnamediv> - <refname>ImageCreateTrueColor</refname> - <refpurpose>Create a new true color image</refpurpose> + <refname>ImageCreatetrueColor</refname> + <refpurpose>Create a new &true; color image</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1082,7 +1082,7 @@ </funcprototype> </funcsynopsis> <para> - <function>ImageCreateTrueColor</function> returns an image identifier + <function>ImageCreatetrueColor</function> returns an image identifier representing a black image of size <parameter>x_size</parameter> by <parameter>y_size</parameter>. </para> @@ -1091,8 +1091,8 @@ <refentry id="function.imagetruecolortopalette"> <refnamediv> - <refname>ImageTrueColorToPalette</refname> - <refpurpose>Convert a true color image to a palette image</refpurpose> + <refname>ImagetrueColorToPalette</refname> + <refpurpose>Convert a &true; color image to a palette image</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1105,18 +1105,18 @@ </funcprototype> </funcsynopsis> <para> - <function>ImageTrueColorToPalette</function> converts a truecolor image + <function>ImagetrueColorToPalette</function> converts a &true;color image to a palette image. The code for this function was originally drawn from the Independent JPEG Group library code, which is excellent. The code has been modified to preserve as much alpha channel information as possible in the resulting palette, in addition to preserving colors as well as possible. This does not work as well as might be hoped. It is - usually best to simply produce a truecolor output image instead, which + usually best to simply produce a &true;color output image instead, which guarantees the highest output quality. </para> <para> <parameter>dither</parameter> indicates if the image should be dithered - - if it is true then dithering will be used which will result in a more + if it is &true; then dithering will be used which will result in a more speckled image but with better color approximation. </para> <para> @@ -2061,7 +2061,7 @@ <para> In the case everything went right, a valid font index will be returned and can be used for further purposes. Otherwise the - function returns false and prints a message describing what went + function returns &false; and prints a message describing what went wrong. </para> <para> @@ -2141,7 +2141,7 @@ <para> In the case everything went right, a valid font index will be returned and can be used for further purposes. Otherwise the - function returns false and prints a message describing what went + function returns &false; and prints a message describing what went wrong. </para> <para> @@ -2688,7 +2688,7 @@ </funcsynopsis> <para> This function calculates and returns the bounding box in pixels - for a TrueType text. + for a &true;Type text. <variablelist> <varlistentry> <term> @@ -2712,7 +2712,7 @@ </term> <listitem> <simpara> - The name of the TrueType font file. (Can also be an URL.) + The name of the &true;Type font file. (Can also be an URL.) </simpara> </listitem> </varlistentry> @@ -2787,7 +2787,7 @@ <refnamediv> <refname>ImageTTFText</refname> <refpurpose> - Write text to the image using TrueType fonts + Write text to the image using &true;Type fonts </refpurpose> </refnamediv> <refsect1> @@ -2811,7 +2811,7 @@ <parameter>im</parameter>, starting at coordinates <parameter>x</parameter>, <parameter>y</parameter> (top left is 0, 0), at an angle of <parameter>angle</parameter> in color - <parameter>col</parameter>, using the TrueType font file + <parameter>col</parameter>, using the &true;Type font file identified by <parameter>fontfile</parameter>. </para> <para> @@ -2828,7 +2828,7 @@ of 90 would result in bottom-to-top reading text). </para> <para> - <parameter>Fontfile</parameter> is the path to the TrueType font + <parameter>Fontfile</parameter> is the path to the &true;Type font you wish to use. </para> <para> Index: phpdoc/en/functions/imap.xml diff -u phpdoc/en/functions/imap.xml:1.43 phpdoc/en/functions/imap.xml:1.44 --- phpdoc/en/functions/imap.xml:1.43 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/imap.xml Sat Jul 7 14:42:29 2001 @@ -161,7 +161,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on sucess, false on error. + Returns &true; on sucess, &false; on error. </para> <para> <function>imap_append</function> appends a string message to the @@ -316,7 +316,7 @@ </funcprototype> </funcsynopsis> <para> - Returns information about the current mailbox. Returns FALSE on + Returns information about the current mailbox. Returns &false; on failure. </para> <para> @@ -440,7 +440,7 @@ international characters should be encoded by <function>imap_utf7_encode</function> </para> <para> - Returns true on success and false on error. + Returns &true; on success and &false; on error. </para> <para> See also <function>imap_renamemailbox</function>, @@ -521,7 +521,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true. + Returns &true;. </para> <para> <function>imap_delete</function> function marks message pointed @@ -577,7 +577,7 @@ of <parameter>mbox</parameter> names). </para> <para> - Returns true on success and false on error. + Returns &true; on success and &false; on error. </para> <para> See also <function>imap_createmailbox</function>, @@ -636,7 +636,7 @@ <function>imap_setflag_full</function>. </para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> @@ -909,7 +909,7 @@ </row> <row> <entry>ifsubtype</entry> - <entry>True if there is a subtype string</entry> + <entry>&true; if there is a subtype string</entry> </row> <row> <entry>subtype</entry> @@ -917,7 +917,7 @@ </row> <row> <entry>ifdescription</entry> - <entry>True if there is a description string</entry> + <entry>&true; if there is a description string</entry> </row> <row> <entry>description</entry> @@ -925,7 +925,7 @@ </row> <row> <entry>ifid</entry> - <entry>True if there is an identification string</entry> + <entry>&true; if there is an identification string</entry> </row> <row> <entry>id</entry> @@ -941,7 +941,7 @@ </row> <row> <entry>ifdisposition</entry> - <entry>True if there is a disposition string</entry> + <entry>&true; if there is a disposition string</entry> </row> <row> <entry>disposition</entry> @@ -949,7 +949,7 @@ </row> <row> <entry>ifdparameters</entry> - <entry>True if the dparameters array exists</entry> + <entry>&true; if the dparameters array exists</entry> </row> <row> <entry>dparameters</entry> @@ -957,7 +957,7 @@ </row> <row> <entry>ifparameters</entry> - <entry>True if the parameters array exists</entry> + <entry>&true; if the parameters array exists</entry> </row> <row> <entry>parameters</entry> @@ -1052,7 +1052,7 @@ Returns an array with integer values limit and usage for the given mailbox. The value of limit represents the total amount of space allowed for this mailbox. The usage value represents the mailboxes - current level of capacity. Will return FALSE in the case of failure. + current level of capacity. Will return &false; in the case of failure. </para> <para> This function is currently only available to users of the c-client2000 @@ -1599,7 +1599,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success and false on error. + Returns &true; on success and &false; on error. </para> <para> Copies mail messages specified by <parameter>msglist</parameter> @@ -1661,7 +1661,7 @@ </itemizedlist> </para> <para> - Returns true on success and false on error. + Returns &true; on success and &false; on error. </para> </refsect1> </refentry> @@ -1680,7 +1680,7 @@ </funcprototype> </funcsynopsis> <para> - Returns information about the current mailbox. Returns FALSE on + Returns information about the current mailbox. Returns &false; on failure. </para> <para> @@ -1904,7 +1904,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an IMAP stream on success and false on error. This + Returns an IMAP stream on success and &false; on error. This function can also be used to open streams to POP3 and NNTP servers, but some functions and features are not available on IMAP servers. @@ -1993,7 +1993,7 @@ echo "<p><h1>Mailboxes</h1>\n"; $folders = imap_listmailbox ($mbox, "{your.imap.host:143}", "*"); -if ($folders == false) { +if ($folders == &false;) { echo "Call failed<br>\n"; } else { while (list ($key, $val) = each ($folders)) { @@ -2004,7 +2004,7 @@ echo "<p><h1>Headers in INBOX</h1>\n"; $headers = imap_headers ($mbox); -if ($headers == false) { +if ($headers == &false;) { echo "Call failed<br>\n"; } else { while (list ($key,$val) = each ($headers)) { @@ -2033,7 +2033,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the stream is still alive, false otherwise. + Returns &true; if the stream is still alive, &false; otherwise. </para> <para> <function>imap_ping</function> function pings the stream to see @@ -2096,7 +2096,7 @@ <parameter>mbox</parameter> names). </para> <para> - Returns true on success and false on error. + Returns &true; on success and &false; on error. </para> <para> See also <function>imap_createmailbox</function>, @@ -2158,7 +2158,7 @@ </itemizedlist> </para> <para> - Returns true on success and false on error. + Returns &true; on success and &false; on error. </para> </refsect1> </refentry> @@ -2519,7 +2519,7 @@ the <parameter>quota_root</parameter>. </para> <para> - Returns true on success and false on error. + Returns &true; on success and &false; on error. </para> <para> <example> @@ -2751,7 +2751,7 @@ Subscribe to a new mailbox. </para> <para> - Returns true on success and false on error. + Returns &true; on success and &false; on error. </para> </refsect1> </refentry> @@ -2805,7 +2805,7 @@ <function>imap_mail_move</function>. </para> <para> - Returns true on success and false on error. + Returns &true; on success and &false; on error. </para> </refsect1> </refentry> @@ -2828,7 +2828,7 @@ Unsubscribe from a specified mailbox. </para> <para> - Returns true on success and false on error. + Returns &true; on success and &false; on error. </para> </refsect1> </refentry> @@ -2852,7 +2852,7 @@ Decodes modified UTF-7 <parameter>text</parameter> into 8bit data. </para> <para> - Returns the decoded 8bit data, or false if the input string was + Returns the decoded 8bit data, or &false; if the input string was not valid modified UTF-7. This function is needed to decode mailbox names that contain international characters outside of the printable ASCII range. The modified UTF-7 encoding is defined Index: phpdoc/en/functions/info.xml diff -u phpdoc/en/functions/info.xml:1.53 phpdoc/en/functions/info.xml:1.54 --- phpdoc/en/functions/info.xml:1.53 Wed Jun 27 01:44:14 2001 +++ phpdoc/en/functions/info.xml Sat Jul 7 14:42:30 2001 @@ -5,7 +5,7 @@ <refentry id="function.assert"> <refnamediv> <refname>assert</refname> - <refpurpose>Checks if assertion is FALSE</refpurpose> + <refpurpose>Checks if assertion is &false;</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -18,7 +18,7 @@ <para> <function>assert</function> will check the given <parameter>assertion</parameter> and take appropriate - action if its result is <literal>FALSE</literal>. + action if its result is &false;. </para> <para> If the <parameter>assertion</parameter> is given as a string it @@ -31,7 +31,7 @@ <para> Assertions should be used as a debugging feature only. You may use them for sanity-checks that test for conditions that should - always be <literal>TRUE</literal> and that indicate some programming errors if not + always be &true; and that indicate some programming errors if not or to check for the presence of certain features like extension functions or certain system limits and features. </para> @@ -157,7 +157,7 @@ <row> <entry>ASSERT_CALLBACK</entry> <entry>assert_callback</entry> - <entry>(null)</entry> + <entry>(&null;)</entry> <entry>user function to call on failed assertions</entry> </row> </tbody> @@ -165,7 +165,7 @@ </table> <para> <function>assert_options</function> will return the original - setting of any option or <literal>FALSE</literal> on errors. + setting of any option or &false; on errors. </para> </refsect1> </refentry> @@ -184,7 +184,7 @@ </funcprototype> </funcsynopsis> <simpara> - Returns <literal>TRUE</literal> if the extension identified by + Returns &true; if the extension identified by <parameter>name</parameter> is loaded. You can see the names of various extensions by using <function>phpinfo</function>. </simpara> @@ -236,7 +236,7 @@ </funcsynopsis> <para> Returns the value of the environment variable - <parameter>varname</parameter>, or <literal>FALSE</literal> on an error. + <parameter>varname</parameter>, or &false; on an error. <informalexample> <programlisting> $ip = getenv ("REMOTE_ADDR"); // get the ip number of the user @@ -279,7 +279,7 @@ </funcsynopsis> <simpara> Returns the current value of the PHP configuration variable - specified by <parameter>varname</parameter>, or <literal>FALSE</literal> if an error + specified by <parameter>varname</parameter>, or &false; if an error occurs. </simpara> <simpara> @@ -396,7 +396,7 @@ <para> Returns the time of the last modification of the current page. The value returned is a Unix timestamp, suitable for - feeding to <function>date</function>. Returns <literal>FALSE</literal> on error. + feeding to <function>date</function>. Returns &false; on error. <example> <title>getlastmod() example</title> <programlisting role="php"> @@ -429,7 +429,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the current script's inode, or <literal>FALSE</literal> on error. + Returns the current script's inode, or &false; on error. </para> <para> See also <function>getmyuid</function>, @@ -459,7 +459,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the current PHP process ID, or <literal>FALSE</literal> on error. + Returns the current PHP process ID, or &false; on error. </para> <warning> <para> @@ -491,7 +491,7 @@ </funcprototype> </funcsynopsis> <simpara> - Returns the user ID of the current script, or <literal>FALSE</literal> on error. + Returns the user ID of the current script, or &false; on error. </simpara> <simpara> See also <function>getmypid</function>, @@ -555,7 +555,7 @@ </funcsynopsis> <para> Changes the value of a configuration option, returns - <literal>FALSE</literal> on failure, and the previous value of the + &false; on failure, and the previous value of the configuration option on success. </para> <note> @@ -586,7 +586,7 @@ </funcsynopsis> <para> Returns the value of the configuration option on success, - <literal>FALSE</literal> on failure. + &false; on failure. </para> <para> See also <function>ini_alter</function>, @@ -636,7 +636,7 @@ </funcsynopsis> <para> Sets the value of the given configuration option. Returns the old - value on success, <literal>FALSE</literal> on failure. The configuration + value on success, &false; on failure. The configuration option will keep this new value during the script's execution, and will be restored at the script's ending. </para> @@ -718,12 +718,12 @@ </row> <row> <entry>error_append_string</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>error_prepend_string</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_ALL</entry> </row> <row> @@ -773,7 +773,7 @@ </row> <row> <entry>output_handler</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry> </row> <row> @@ -818,17 +818,17 @@ </row> <row> <entry>auto_append_file</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>auto_prepend_file</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>doc_root</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> @@ -843,7 +843,7 @@ </row> <row> <entry>error_log</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_ALL</entry> </row> <row> @@ -868,7 +868,7 @@ </row> <row> <entry>open_basedir</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> @@ -893,17 +893,17 @@ </row> <row> <entry>upload_tmp_dir</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> <entry>user_dir</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> <entry>variables_order</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_ALL</entry> </row> <row> @@ -913,12 +913,12 @@ </row> <row> <entry>browscap</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> <entry>error_reporting</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_ALL</entry> </row> <row> @@ -933,7 +933,7 @@ </row> <row> <entry>sendmail_from</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_ALL</entry> </row> <row> @@ -1493,7 +1493,7 @@ [E_USER_WARNING] => 512 [E_USER_NOTICE] => 1024 [E_ALL] => 2047 - [TRUE] => 1 + [&true;] => 1 ) </programlisting> </informalexample> Index: phpdoc/en/functions/ingres_ii.xml diff -u phpdoc/en/functions/ingres_ii.xml:1.2 phpdoc/en/functions/ingres_ii.xml:1.3 --- phpdoc/en/functions/ingres_ii.xml:1.2 Sun Jun 24 11:27:21 2001 +++ phpdoc/en/functions/ingres_ii.xml Sat Jul 7 14:42:30 2001 @@ -59,7 +59,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a Ingres II link resource on success, or false on failure. + Returns a Ingres II link resource on success, or &false; on failure. </para> <para> <function>ingres_connect</function> opens a connection with the @@ -136,7 +136,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a Ingres II link resource on success, or false on failure. + Returns a Ingres II link resource on success, or &false; on failure. </para> <para> See <function>ingres_connect</function> for parameters details and @@ -176,7 +176,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, or false on failure. + Returns &true; on success, or &false; on failure. </para> <para> <function>ingres_close</function> closes the connection to @@ -215,7 +215,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, or false on failure. + Returns &true; on success, or &false; on failure. </para> <para> <function>ingres_query</function> sends the given @@ -331,7 +331,7 @@ </simpara> <simpara> You should instead retrieve the result's data using one of these - fetch functions in a loop until it returns false, indicating that + fetch functions in a loop until it returns &false;, indicating that no more results are available. </simpara> </note> @@ -398,7 +398,7 @@ </funcsynopsis> <para> <function>ingres_field_name</function> returns the name of a field - in a query result, or false on failure. + in a query result, or &false; on failure. </para> <para> <parameter>index</parameter> is the number of the field and must be @@ -435,7 +435,7 @@ </funcsynopsis> <para> <function>ingres_field_type</function> returns the type of a field - in a query result, or false on failure. + in a query result, or &false; on failure. Examples of types returned are "IIAPI_BYTE_TYPE", "IIAPI_CHA_TYPE", "IIAPI_DTE_TYPE", "IIAPI_FLT_TYPE", "IIAPI_INT_TYPE", "IIAPI_VCH_TYPE". Some of these types can map @@ -462,7 +462,7 @@ <refentry id="function.ingres-field-nullable"> <refnamediv> <refname>ingres_field_nullable</refname> - <refpurpose>Test if a field is nullable.</refpurpose> + <refpurpose>Test if a field is &null;able.</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -478,8 +478,8 @@ </funcprototype> </funcsynopsis> <para> - <function>ingres_field_nullable</function> returns true if the field - can be set to the NULL value and false if it can't. + <function>ingres_field_nullable</function> returns &true; if the field + can be set to the &null; value and &false; if it can't. </para> <para> <parameter>index</parameter> is the number of the field and must be @@ -631,7 +631,7 @@ </funcsynopsis> <para> <function>ingres_fetch_array</function> Returns an array that corresponds - to the fetched row, or false if there are no more rows. + to the fetched row, or &false; if there are no more rows. </para> <para> This function is an extended version of @@ -709,12 +709,12 @@ </funcsynopsis> <para> <function>ingres_fetch_row</function> returns an array that corresponds - to the fetched row, or false if there are no more rows. Each result + to the fetched row, or &false; if there are no more rows. Each result column is stored in an array offset, starting at offset 1. </para> <para> Subsequent call to <function>ingres_fetch_row</function> would - return the next row in the result set, or false if there are no + return the next row in the result set, or &false; if there are no more rows. </para> <para> @@ -763,7 +763,7 @@ </funcsynopsis> <para> <function>ingres_fetch_object</function> Returns an object that - corresponds to the fetched row, or false if there are no more rows. + corresponds to the fetched row, or &false; if there are no more rows. </para> <para> This function is similar to Index: phpdoc/en/functions/ircg.xml diff -u phpdoc/en/functions/ircg.xml:1.1 phpdoc/en/functions/ircg.xml:1.2 --- phpdoc/en/functions/ircg.xml:1.1 Fri Jun 8 17:18:24 2001 +++ phpdoc/en/functions/ircg.xml Sat Jul 7 14:42:30 2001 @@ -178,7 +178,7 @@ </para> <para> Setting the optional parameter <parameter>suppress</parameter> to - a true value will suppress output of your message to your own + a &true; value will suppress output of your message to your own <parameter>connection</parameter>. </para> </refsect1> @@ -236,7 +236,7 @@ <parameter>nick</parameter> if possible. </para> <para> - Will return true on success and false on failure. + Will return &true; on success and &false; on failure. </para> </refsect1> </refentry> @@ -476,9 +476,9 @@ </funcprototype> </funcsynopsis> <para> - <function>ircg_is_conn_alive</function> returns true if + <function>ircg_is_conn_alive</function> returns &true; if <parameter>connection</parameter> is still alive and working or - false if the server no longer talks to us. + &false; if the server no longer talks to us. </para> </refsect1> </refentry> Index: phpdoc/en/functions/java.xml diff -u phpdoc/en/functions/java.xml:1.5 phpdoc/en/functions/java.xml:1.6 --- phpdoc/en/functions/java.xml:1.5 Tue Jun 26 10:08:25 2001 +++ phpdoc/en/functions/java.xml Sat Jul 7 14:42:31 2001 @@ -49,7 +49,7 @@ $frame->add("North", $button); $frame->validate(); $frame->pack(); - $frame->visible = True; + $frame->visible = &true;; $thread = new Java("java.lang.Thread"); $thread->sleep(10000); @@ -87,7 +87,7 @@ </listitem> <listitem> <para> - Exceptions raised result in PHP warnings, and null results. The + Exceptions raised result in PHP warnings, and &null; results. The warnings may be eliminated by prefixing the method call with an "@" sign. The following APIs may be used to retrieve and reset the last error: Index: phpdoc/en/functions/ldap.xml diff -u phpdoc/en/functions/ldap.xml:1.26 phpdoc/en/functions/ldap.xml:1.27 --- phpdoc/en/functions/ldap.xml:1.26 Sun Jun 3 11:00:29 2001 +++ phpdoc/en/functions/ldap.xml Sat Jul 7 14:42:31 2001 @@ -216,7 +216,7 @@ </funcprototype> </funcsynopsis> <para> - returns true on success and false on error. + returns &true; on success and &false; on error. </para><para> The <function>ldap_add</function> function is used to add entries in the LDAP directory. The DN of the entry to be added is @@ -279,7 +279,7 @@ </funcsynopsis> <para> Binds to the LDAP directory with specified RDN and - password. Returns true on success and false on error.</para> + password. Returns &true; on success and &false; on error.</para> <para> <function>ldap_bind</function> does a bind operation on the directory. bind_rdn and bind_password are optional. If not @@ -302,7 +302,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> <function>ldap_close</function> closes the link to the LDAP server that's associated with the specified @@ -333,7 +333,7 @@ </funcprototype> </funcsynopsis> <simpara> - Returns true if <parameter>value</parameter> matches otherwise returns false. Returns -1 on error. + Returns &true; if <parameter>value</parameter> matches otherwise returns &false;. Returns -1 on error. </simpara> <para> <function>ldap_compare</function> is used to compare <parameter>value</parameter> @@ -366,9 +366,9 @@ if ($r === -1) { echo "Error: ".ldap_error($ds); - } elseif ($r === TRUE) { + } elseif ($r === &true;) { echo "Password correct."; - } elseif ($r === FALSE) { + } elseif ($r === &false;) { echo "Wrong guess! Password incorrect."; } @@ -414,7 +414,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a positive LDAP link identifier on success, or false on + Returns a positive LDAP link identifier on success, or &false; on error.</para> <para> <function>ldap_connect</function> establishes a connection to a @@ -449,7 +449,7 @@ </funcprototype> </funcsynopsis> <para> - Returns number of entries in the result or false on error.</para> + Returns number of entries in the result or &false; on error.</para> <para> <function>ldap_count_entries</function> returns the number of entries stored in the result of previous search @@ -474,7 +474,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success and false on error.</para> + Returns &true; on success and &false; on error.</para> <para> <function>ldap_delete</function> function delete a particular entry in LDAP directory specified by dn.</para> @@ -680,7 +680,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the first attribute in the entry on success and false on + Returns the first attribute in the entry on success and &false; on error. </para> <para> @@ -718,7 +718,7 @@ </funcsynopsis> <para> Returns the result entry identifier for the first entry on - success and false on error.</para> + success and &false; on error.</para> <para> Entries in the LDAP result are read sequentially using the <function>ldap_first_entry</function> and @@ -748,7 +748,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success and false on error.</para> + Returns &true; on success and &false; on error.</para> <para> <function>ldap_free_result</function> frees up the memory allocated internally to store the result and pointed by the @@ -781,7 +781,7 @@ </funcsynopsis> <para> Returns a complete entry information in a multi-dimensional array - on success and false on error.</para> + on success and &false; on error.</para> <para> <function>ldap_get_attributes</function> function is used to simplify reading the attributes and values from an entry in the @@ -849,7 +849,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the DN of the result entry and false on error.</para> + Returns the DN of the result entry and &false; on error.</para> <para> <function>ldap_get_dn</function> function is used to find out the DN of an entry in the result.</para> @@ -873,7 +873,7 @@ </funcsynopsis> <para> Returns a complete result information in a multi-dimenasional - array on success and false on error.</para> + array on success and &false; on error.</para> <para> <function>ldap_get_entries</function> function is used to simplify reading multiple entries from the result and then @@ -926,7 +926,7 @@ </funcsynopsis> <para> Sets <parameter>retval</parameter> to the value of the specified option, - and returns true on success and false on error.</para> + and returns &true; on success and &false; on error.</para> <para> The parameter <parameter>option</parameter> can be one of: LDAP_OPT_DEREF, LDAP_OPT_SIZELIMIT, LDAP_OPT_TIMELIMIT, @@ -973,7 +973,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an array of values for the attribute on success and false + Returns an array of values for the attribute on success and &false; on error.</para> <para> <function>ldap_get_values</function> function is used to read all @@ -1046,7 +1046,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an array of values for the attribute on success and false + Returns an array of values for the attribute on success and &false; on error.</para> <para> <function>ldap_get_values_len</function> function is used to read all @@ -1099,7 +1099,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a search result identifier or false on error.</para> + Returns a search result identifier or &false; on error.</para> <para> <function>ldap_list</function> performs the search for a specified filter on the directory with the scope LDAP_SCOPE_ONELEVEL.</para> @@ -1162,7 +1162,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success and false on error.</para> + Returns &true; on success and &false; on error.</para> <para> <function>ldap_modify</function> function is used to modify the existing entries in the LDAP directory. The structure of the @@ -1187,7 +1187,7 @@ </funcprototype> </funcsynopsis> <para> - returns true on success and false on error.</para> + returns &true; on success and &false; on error.</para> <para> This function adds attribute(s) to the specified dn. It performs the modification at the attribute level as opposed to the @@ -1212,7 +1212,7 @@ </funcprototype> </funcsynopsis> <para> - returns true on success and false on error.</para> + returns &true; on success and &false; on error.</para> <para> This function removes attribute(s) from the specified dn. It performs the modification at the attribute level as opposed to the @@ -1237,7 +1237,7 @@ </funcprototype> </funcsynopsis> <para> - returns true on success and false on error.</para> + returns &true; on success and &false; on error.</para> <para> This function replaces attribute(s) from the specified dn. It performs the modification at the attribute level as opposed to the @@ -1262,7 +1262,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the next attribute in an entry on success and false on + Returns the next attribute in an entry on success and &false; on error.</para> <para> <function>ldap_next_attribute</function> is called to retrieve @@ -1296,7 +1296,7 @@ Returns entry identifier for the next entry in the result whose entries are being read starting with <function>ldap_first_entry</function>. If there are no more - entries in the result then it returns false.</para> + entries in the result then it returns &false;.</para> <para> <function>ldap_next_entry</function> function is used to retrieve the entries stored in the result. Successive calls to the @@ -1341,7 +1341,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a search result identifier or false on error.</para> + Returns a search result identifier or &false; on error.</para> <para> <function>ldap_read</function> performs the search for a specified filter on the directory with the scope @@ -1396,10 +1396,10 @@ The new RDN is specified by <parameter>newrdn</parameter> and the new parent/superior entry is specified by <parameter>newparent</parameter>. If the parameter - <parameter>deleteoldrdn</parameter> is true the old RDN value(s) + <parameter>deleteoldrdn</parameter> is &true; the old RDN value(s) is removed, else the old RDN value(s) is retained as - non-distinguished values of the entry. True is returned on - success and false is returned on error.</para> + non-distinguished values of the entry. &true; is returned on + success and &false; is returned on error.</para> <para>This function is only available when using OpenLDAP 2.x.x OR Netscape Directory SDK x.x, and was added in PHP 4.0.5.</para> </refsect1> @@ -1437,7 +1437,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a search result identifier or false on error.</para> + Returns a search result identifier or &false; on error.</para> <para> <function>ldap_search</function> performs the search for a specified filter on the directory with the scope of @@ -1559,10 +1559,10 @@ used for one search, the second entries are used for another, and so on. When doing parallel searches an array of search result identifiers is returned, except in case of error, then the entry - corresponding to the search will be false. This is very much like + corresponding to the search will be &false;. This is very much like the value normally returned, except that a result identifier is always returned when a search was made. There are some rare cases where the - normal search returns false while the parallel search returns an + normal search returns &false; while the parallel search returns an identifier. </para> </refsect1> @@ -1586,7 +1586,7 @@ </funcsynopsis> <para> Sets the value of the specified option to be - <parameter>newval</parameter>, and returns true on success and false + <parameter>newval</parameter>, and returns &true; on success and &false; on error.</para> <para> The parameter <parameter>option</parameter> can be one of: @@ -1611,7 +1611,7 @@ and string value, and two optional elements. The optional elements are key <emphasis>value</emphasis> with string value and key <emphasis>iscritical</emphasis> with boolean value. - <emphasis>iscritical</emphasis> defaults to <emphasis>FALSE</emphasis> + <emphasis>iscritical</emphasis> defaults to <emphasis>&false;</emphasis> if not supplied. See also the second example below.</para> <para> This function is only available when using @@ -1633,8 +1633,8 @@ <programlisting role="php"> // $ds is a valid link identifier for a directory server // control with no value -$ctrl1 = array("oid" => "1.2.752.58.10.1", "iscritical" => TRUE); -// iscritical defaults to FALSE +$ctrl1 = array("oid" => "1.2.752.58.10.1", "iscritical" => &true;); +// iscritical defaults to &false; $ctrl2 = array("oid" => "1.2.752.58.1.10", "value" => "magic"); // try to set both controls if (!ldap_set_option($ds, LDAP_OPT_SERVER_CONTROLS, array($ctrl1, $ctrl2))) @@ -1662,7 +1662,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success and false on error.</para> + Returns &true; on success and &false; on error.</para> <para> <function>ldap_unbind</function> function unbinds from the LDAP directory.</para> Index: phpdoc/en/functions/mail.xml diff -u phpdoc/en/functions/mail.xml:1.22 phpdoc/en/functions/mail.xml:1.23 --- phpdoc/en/functions/mail.xml:1.22 Sat Jul 7 04:36:54 2001 +++ phpdoc/en/functions/mail.xml Sat Jul 7 14:42:31 2001 @@ -43,8 +43,8 @@ >http://www.rfc-editor.org/</ulink>). </simpara> <para> - <function>mail</function> returns <literal>TRUE</literal> if the mail - is sucessfully sent, <literal>FALSE</literal> otherwise. + <function>mail</function> returns &true; if the mail + is sucessfully sent, &false; otherwise. </para> <para> <example> Index: phpdoc/en/functions/mbstring.xml diff -u phpdoc/en/functions/mbstring.xml:1.3 phpdoc/en/functions/mbstring.xml:1.4 --- phpdoc/en/functions/mbstring.xml:1.3 Thu Jun 28 23:20:28 2001 +++ phpdoc/en/functions/mbstring.xml Sat Jul 7 14:42:31 2001 @@ -557,10 +557,10 @@ <para> Return Value: If <parameter>language</parameter> is set and <parameter>language</parameter> is valid, it returns - TRUE. Otherwise, it returns FALSE. When + &true;. Otherwise, it returns &false;. When <parameter>language</parameter> is omitted, it returns language name as string. If no language is set previously, it returns - FALSE. + &false;. </para> <para> See also <function>mb_send_mail</function>. @@ -606,7 +606,7 @@ character encoding converted values. </para> <para> - Return Value: It returns TRUE for success or FALSE for failure. + Return Value: It returns &true; for success or &false; for failure. </para> <para> See also <function>mb_detect_order</function>, @@ -649,8 +649,8 @@ <para> Return Value: If <parameter>encoding</parameter> is set,<function>mb_internal_encoding</function> returns - <literal>TRUE</literal> for success, otherwise returns - <literal>FALSE</literal>. If <parameter>encoding</parameter> is + &true; for success, otherwise returns + &false;. If <parameter>encoding</parameter> is omitted, it returns current character encoding name. </para> <para> @@ -701,7 +701,7 @@ <para> Return Value: Character encoding name. If <function>mb_http_input</function> does not process specified - HTTP input, it returns FALSE. + HTTP input, it returns &false;. </para> <para> See also <function>mb_internal_encoding</function>, @@ -732,7 +732,7 @@ encoding to <parameter>encoding</parameter>. Output after this function is converted to <parameter>encoding</parameter>. <function>mb_http_output</function> returns - <literal>TRUE</literal> for success and <literal>FALSE</literal> + &true; for success and &false; for failure. </para> <para> @@ -768,8 +768,8 @@ <para> <function>mb_detect_order</function> sets automatic character encoding detection order to <parameter>encoding-list</parameter>. - It returns <literal>TRUE</literal> for success, - <literal>FALSE</literal> for failure. + It returns &true; for success, + &false; for failure. </para> <para> <parameter>encoding-list</parameter> is array or comma separated @@ -866,7 +866,7 @@ <function>mb_substitute_character</function> specifies substitution character when input character encoding is invalid or character code is not exist in output character - encoding. Invalid characters may be substituted null(no output), + encoding. Invalid characters may be substituted &null;(no output), string or integer value (Unicode character code value). </para> <para> @@ -892,8 +892,8 @@ </para> <para> Return Value: If <parameter>substchar</parameter> is set, it - returns <literal>TRUE</literal> for success, otherwise returns - <literal>FALSE</literal>. If <parameter>substchar</parameter> is + returns &true; for success, otherwise returns + &false;. If <parameter>substchar</parameter> is not set, it returns Unicode value or "<literal>none</literal>"/"<literal>long</literal>". </para> @@ -1082,7 +1082,7 @@ <function>mb_strpos</function> returns the numeric position of the first occurrence of <parameter>needle</parameter> in the <parameter>haystack</parameter> string. If - <parameter>needle</parameter> is not found, it returns FALSE. + <parameter>needle</parameter> is not found, it returns &false;. </para> <para> <function>mb_strpos</function> performs multi-byte safe @@ -1138,7 +1138,7 @@ <function>mb_strrpos</function> returns the numeric position of the last occurrence of <parameter>needle</parameter> in the <parameter>haystack</parameter> string. If - <parameter>needle</parameter> is not found, it returns FALSE. + <parameter>needle</parameter> is not found, it returns &false;. </para> <para> <function>mb_strrpos</function> performs multi-byte safe @@ -1661,7 +1661,7 @@ character encoding of variables <parameter>vars</parameter> in encoding <parameter>from-encoding</parameter> to encoding <parameter>to-encoding</parameter>. It returns character encoding - before conversion for success, FALSE for failure. + before conversion for success, &false; for failure. </para> <para> <function>mb_convert_variables</function> join strings in Array @@ -1882,8 +1882,8 @@ header when using sendmail. </para> <para> - It returns <literal>TRUE</literal> for success, otherwise it - returns <literal>FALSE</literal>. + It returns &true; for success, otherwise it + returns &false;. </para> <para> See also: <function>mb_language</function>, Index: phpdoc/en/functions/mcal.xml diff -u phpdoc/en/functions/mcal.xml:1.20 phpdoc/en/functions/mcal.xml:1.21 --- phpdoc/en/functions/mcal.xml:1.20 Mon Jul 2 06:46:40 2001 +++ phpdoc/en/functions/mcal.xml Sat Jul 7 14:42:31 2001 @@ -144,7 +144,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an MCAL stream on success, false on error. + Returns an MCAL stream on success, &false; on error. </para> <para> <function>mcal_open</function> opens up an MCAL connection to the @@ -173,7 +173,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an MCAL stream on success, false on error. + Returns an MCAL stream on success, &false; on error. </para> <para> <function>mcal_popen</function> opens up an MCAL connection to the @@ -320,7 +320,7 @@ <listitem><simpara> int id - ID of that event.</simpara></listitem> <listitem><simpara> - int public - TRUE if the event if public, FALSE if it is + int public - &true; if the event if public, &false; if it is private.</simpara></listitem> <listitem><simpara> string category - Category string of the event.</simpara></listitem> @@ -460,7 +460,7 @@ to the current global event for the given stream. </para> <para> - Returns the event id of the modified event on success and false on error. + Returns the event id of the modified event on success and &false; on error. </para> </refsect1> </refentry> @@ -484,7 +484,7 @@ <function>mcal_delete_event</function> deletes the calendar event specified by the event_id.</para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> @@ -507,7 +507,7 @@ calendar event specified by the id. </para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> @@ -581,7 +581,7 @@ structure to 0, or the default settings. </para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> @@ -607,7 +607,7 @@ global event structure's category to the given string. </para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> @@ -633,7 +633,7 @@ event structure's title to the given string. </para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> @@ -661,7 +661,7 @@ global event structure's description to the given string. </para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> @@ -708,7 +708,7 @@ event structure's start date and time to the given values. </para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> @@ -755,7 +755,7 @@ event structure's end date and time to the given values. </para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> @@ -781,7 +781,7 @@ event structure's alarm to the given minutes before the event. </para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> @@ -808,7 +808,7 @@ for public, or 0 for private. </para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> @@ -864,7 +864,7 @@ <refnamediv> <refname>mcal_date_valid</refname> <refpurpose> - Returns true if the given year, month, day is a valid date + Returns &true; if the given year, month, day is a valid date </refpurpose> </refnamediv> <refsect1> @@ -878,8 +878,8 @@ </funcprototype> </funcsynopsis> <para> - <function>mcal_date_valid</function> Returns true if the given - year, month and day is a valid date, false if not. + <function>mcal_date_valid</function> Returns &true; if the given + year, month and day is a valid date, &false; if not. </para> </refsect1> </refentry> @@ -888,7 +888,7 @@ <refnamediv> <refname>mcal_time_valid</refname> <refpurpose> - Returns true if the given year, month, day is a valid time + Returns &true; if the given year, month, day is a valid time </refpurpose> </refnamediv> <refsect1> @@ -902,8 +902,8 @@ </funcprototype> </funcsynopsis> <para> - <function>mcal_time_valid</function> Returns true if the given - hour, minutes and seconds is a valid time, false if not. + <function>mcal_time_valid</function> Returns &true; if the given + hour, minutes and seconds is a valid time, &false; if not. </para> </refsect1> </refentry> @@ -1207,7 +1207,7 @@ <listitem><simpara> int id - ID of that event.</simpara></listitem> <listitem><simpara> - int public - TRUE if the event if public, FALSE if it is + int public - &true; if the event if public, &false; if it is private.</simpara></listitem> <listitem><simpara> string category - Category string of the event.</simpara></listitem> Index: phpdoc/en/functions/mcrypt.xml diff -u phpdoc/en/functions/mcrypt.xml:1.17 phpdoc/en/functions/mcrypt.xml:1.18 --- phpdoc/en/functions/mcrypt.xml:1.17 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/mcrypt.xml Sat Jul 7 14:42:32 2001 @@ -389,7 +389,7 @@ <function>mcrypt_get_cipher_name</function> takes the cipher number as an argument (libmcrypt 2.2.x) or takes the cipher name as an argument (libmcrypt 2.4.x) and returns the name of the cipher - or false, if the cipher does not exist. + or &false;, if the cipher does not exist. </para> <para> <example> @@ -916,7 +916,7 @@ <para> <function>mcrypt_get_iv_size</function> returns the size of the Initialisation Vector (IV) in bytes. On error the function - returns FALSE. If the IV is ignored in the specified cipher/mode + returns &false;. If the IV is ignored in the specified cipher/mode combination zero is returned. </para> <para> @@ -1091,7 +1091,7 @@ <function>mcrypt_module_close</function>, but there is no need to call that function if <function>mcrypt_generic_end</function> is called. Normally it returns an encryption descriptor, or - FALSE on error. + &false; on error. </para> <para> The <parameter>algorithm_directory</parameter> and @@ -1239,7 +1239,7 @@ <para> This function terminates encryption specified by the encryption descriptor (td). Actually it clears all buffers, and closes - all the modules used. Returns FALSE on error, or TRUE on succes. + all the modules used. Returns &false; on error, or &true; on succes. </para> </refsect1> </refentry> @@ -1469,7 +1469,7 @@ the location of where the algorithm module is on the system. </para> <para> - The function returns TRUE if the self test succeeds, or FALSE when + The function returns &true; if the self test succeeds, or &false; when if fails. </para> </refsect1> @@ -1490,7 +1490,7 @@ </funcprototype> </funcsynopsis> <para> - This function returns TRUE if the mode is for use with block algorithms, + This function returns &true; if the mode is for use with block algorithms, otherwise it returns 0. (eg. 0 for stream, and 1 for cbc, cfb, ofb). The optional <parameter>lib_dir</parameter> parameter can contain the location where the mode module is on the system. @@ -1513,8 +1513,8 @@ </funcprototype> </funcsynopsis> <para> - This function returns TRUE if the specified algorithm is a block - algorithm, or FALSE is it is a stream algorithm. + This function returns &true; if the specified algorithm is a block + algorithm, or &false; is it is a stream algorithm. The optional <parameter>lib_dir</parameter> parameter can contain the location where the algorithm module is on the system. </para> @@ -1536,8 +1536,8 @@ </funcprototype> </funcsynopsis> <para> - This function returns TRUE if the mode outputs blocks of bytes or - FALSE if it outputs just bytes. (eg. 1 for cbc and ecb, and 0 for cfb + This function returns &true; if the mode outputs blocks of bytes or + &false; if it outputs just bytes. (eg. 1 for cbc and ecb, and 0 for cfb and stream). The optional <parameter>lib_dir</parameter> parameter can contain the location where the mode module is on the system. </para> Index: phpdoc/en/functions/mhash.xml diff -u phpdoc/en/functions/mhash.xml:1.13 phpdoc/en/functions/mhash.xml:1.14 --- phpdoc/en/functions/mhash.xml:1.13 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/mhash.xml Sat Jul 7 14:42:32 2001 @@ -128,7 +128,7 @@ </para> <para> <function>mhash_get_hash_name</function> takes the hash id as an - argument and returns the name of the hash or false, if the hash + argument and returns the name of the hash or &false;, if the hash does not exist. </para> <para> @@ -170,7 +170,7 @@ <para> <function>mhash_get_block_size</function> takes one argument, the <parameter>hash</parameter> and returns the size in bytes or - false, if the <parameter>hash</parameter> does not exist. + &false;, if the <parameter>hash</parameter> does not exist. </para> </refsect1> </refentry> @@ -234,7 +234,7 @@ is specified it will return the resulting HMAC. HMAC is keyed hashing for message authentication, or simply a message digest that depends on the specified key. Not all algorithms supported in mhash can be used in - HMAC mode. In case of an error returns false. + HMAC mode. In case of an error returns &false;. </para> </refsect1> </refentry> Index: phpdoc/en/functions/ming.xml diff -u phpdoc/en/functions/ming.xml:1.12 phpdoc/en/functions/ming.xml:1.13 --- phpdoc/en/functions/ming.xml:1.12 Sun Jun 24 11:27:21 2001 +++ phpdoc/en/functions/ming.xml Sat Jul 7 14:42:32 2001 @@ -3539,7 +3539,7 @@ <listitem> <simpara> Start dragging the movie clip target. The lock argument indicates whether - to lock the mouse (?)- use 0 (false) or 1 (true). Optional parameters + to lock the mouse (?)- use 0 (&false;) or 1 (&true;). Optional parameters define a bounding area for the dragging. </simpara> </listitem> Index: phpdoc/en/functions/misc.xml diff -u phpdoc/en/functions/misc.xml:1.48 phpdoc/en/functions/misc.xml:1.49 --- phpdoc/en/functions/misc.xml:1.48 Sun Jun 24 07:45:37 2001 +++ phpdoc/en/functions/misc.xml Sat Jul 7 14:42:32 2001 @@ -12,7 +12,7 @@ <refentry id="function.connection-aborted"> <refnamediv> <refname>connection_aborted</refname> - <refpurpose>Returns true if client disconnected</refpurpose> + <refpurpose>Returns &true; if client disconnected</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -23,7 +23,7 @@ </funcprototype> </funcsynopsis> <simpara> - Returns true if client disconnected. See the <link + Returns &true; if client disconnected. See the <link linkend="features.connection-handling">Connection Handling</link> description in the <link linkend="features">Features</link> chapter for a complete explanation. @@ -56,7 +56,7 @@ <refentry id="function.connection-timeout"> <refnamediv> <refname>connection_timeout</refname> - <refpurpose>Return true if script timed out</refpurpose> + <refpurpose>Return &true; if script timed out</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -67,7 +67,7 @@ </funcprototype> </funcsynopsis> <simpara> - Returns true if script timed out. + Returns &true; if script timed out. </simpara> <warning> <title>Deprecated</title> @@ -164,7 +164,7 @@ <para> The optional third parameter <parameter>case_insensitive</parameter> is also available. If the - value <constant>TRUE</constant> is given, then the constant will be + value &true; is given, then the constant will be defined case-insensitive. The default behaviour is case-sensitive; i.e. CONSTANT and Constant represent different values. @@ -178,7 +178,7 @@ echo CONSTANT; // outputs "Hello world." echo Constant; // outputs "Constant" and issues a notice. -define ("GREETING", "Hello you.",TRUE); +define ("GREETING", "Hello you.",&true;); echo GREETING; // outputs "Hello you." echo Greeting; // outputs "Hello you." @@ -187,8 +187,8 @@ </example> </para> <para> - <function>define</function> returns <constant>TRUE</constant> - on success and <constant>FALSE</constant> if + <function>define</function> returns &true; + on success and &false; if an error occurs. </para> <para> @@ -215,9 +215,9 @@ </funcprototype> </funcsynopsis> <para> - Returns <constant>TRUE</constant> if the named constant given by + Returns &true; if the named constant given by <parameter>name</parameter> has been defined, - <constant>FALSE</constant> otherwise. + &false; otherwise. <example> <title>Checking Constants</title> <programlisting role="php"> @@ -424,7 +424,7 @@ <simpara> The information is returned in an object, which will contain various data elements representing, for instance, the browser's - major and minor version numbers and ID string; true/false values + major and minor version numbers and ID string; &true;/&false; values for features such as frames, JavaScript, and cookies; and so forth. </simpara> @@ -669,7 +669,7 @@ <simpara> This function parses a binary IPTC block into its single tags. It returns an array using the tagmarker as an index and the value as - the value. It returns false on error or if no IPTC data was + the value. It returns &false; on error or if no IPTC data was found. See <function>GetImageSize</function> for a sample. </simpara> </refsect1> @@ -882,7 +882,7 @@ The <function>show_source</function> function prints out a syntax higlighted version of the code contained in <parameter>filename</parameter> using the colors defined in the built-in syntax highlighter for PHP. - It returns true on success, false otherwise (PHP 4). + It returns &true; on success, &false; otherwise (PHP 4). </simpara> <simpara> This function is an alias for the function @@ -953,7 +953,7 @@ characters long. </simpara> <simpara> - If the optional <parameter>lcg</parameter> parameter is true, + If the optional <parameter>lcg</parameter> parameter is &true;, <function>uniqid</function> will add additional "combined LCG" entropy at the end of the return value, which should make the results more unique. @@ -961,7 +961,7 @@ <simpara> With an empty <parameter>prefix</parameter>, the returned string will be 13 characters long. If <parameter>lcg</parameter> is - true, it will be 23 characters. + &true;, it will be 23 characters. </simpara> <note> <simpara> Index: phpdoc/en/functions/mnogosearch.xml diff -u phpdoc/en/functions/mnogosearch.xml:1.15 phpdoc/en/functions/mnogosearch.xml:1.16 --- phpdoc/en/functions/mnogosearch.xml:1.15 Tue Jun 26 04:38:34 2001 +++ phpdoc/en/functions/mnogosearch.xml Sat Jul 7 14:42:32 2001 @@ -62,7 +62,7 @@ </funcprototype> </funcsynopsis> <para> - <function>udm_add_search_limit</function> returns <literal>TRUE</literal> on success, <literal>FALSE</literal> on error. Adds search restrictions. + <function>udm_add_search_limit</function> returns &true; on success, &false; on error. Adds search restrictions. </para> <para> <parameter>agent</parameter> - a link to Agent, received after call to <function>udm_alloc_agent</function>. @@ -145,7 +145,7 @@ </funcprototype> </funcsynopsis> <para><function>udm_alloc_agent</function> returns mnogosearch agent -identifier on success, <literal>FALSE</literal> on error. This function creates a +identifier on success, &false; on error. This function creates a session with database parameters.</para> <para><parameter>dbaddr</parameter> - URL-style database description. Options (type, host, database name, port, user and password) to connect to SQL database. @@ -350,7 +350,7 @@ </funcsynopsis> <para> - <function>udm_clear_search_limits</function> resets defined search limitations and returns <literal>TRUE</literal>. + <function>udm_clear_search_limits</function> resets defined search limitations and returns &true;. </para> </refsect1> </refentry> @@ -431,7 +431,7 @@ </funcsynopsis> <para> - <function>udm_find</function> returns result link identifier on success, <literal>FALSE</literal> on error. + <function>udm_find</function> returns result link identifier on success, &false; on error. </para> <para> @@ -497,7 +497,7 @@ </funcsynopsis> <para> - <function>udm_free_agent</function> returns <literal>TRUE</literal> on success, <literal>FALSE</literal> on error. + <function>udm_free_agent</function> returns &true; on success, &false; on error. </para> <para> <parameter>agent</parameter> - link to agent identifier, received after call to <function>udm_alloc_agent</function>. @@ -526,7 +526,7 @@ </funcsynopsis> <para> - <function>udm_free_ispell_data</function> always returns <literal>TRUE</literal>. + <function>udm_free_ispell_data</function> always returns &true;. </para> <para> @@ -558,7 +558,7 @@ </funcsynopsis> <para> - <function>udm_free_res</function> returns <literal>TRUE</literal> on success, <literal>FALSE</literal> on error. + <function>udm_free_res</function> returns &true; on success, &false; on error. </para> <para> @@ -622,7 +622,7 @@ </funcsynopsis> <para> - <function>udm_get_res_field</function> returns result field value on success, <literal>FALSE</literal> on error. + <function>udm_get_res_field</function> returns result field value on success, &false; on error. </para> <para> @@ -726,7 +726,7 @@ </funcsynopsis> <para> - <function>udm_get_res_param</function> returns result parameter value on success, <literal>FALSE</literal> on error. + <function>udm_get_res_param</function> returns result parameter value on success, &false; on error. </para> <para> @@ -794,7 +794,7 @@ </funcsynopsis> <para> - <function>udm_load_ispell_data</function> loads ispell data. Returns <literal>TRUE</literal> on success, <literal>FALSE</literal> on error. + <function>udm_load_ispell_data</function> loads ispell data. Returns &true; on success, &false; on error. </para> <para> @@ -811,7 +811,7 @@ <para> The fastest mode is UDM_ISPELL_TYPE_SERVER. UDM_ISPELL_TYPE_TEXT is slower - and UDM_ISPELL_TYPE_DB is the slowest. The above pattern is true for mnoGoSearch 3.1.10 - 3.1.11. + and UDM_ISPELL_TYPE_DB is the slowest. The above pattern is &true; for mnoGoSearch 3.1.10 - 3.1.11. It is planned to speed up DB mode in future versions and it is going to be faster than TEXT mode. </para> @@ -827,7 +827,7 @@ <parameter>flag</parameter> indicates that after loading ispell data from defined source it sould be sorted (it is necessary for correct functioning of ispell). In case of loading ispell data from files there may be several calls to <function>udm_load_ispell_data</function>, and there is no sense to sort data after every call, but only after the last one. Since in db mode all the data is loaded by one call, this parameter should have the value <literal>1</literal>. - In this mode in case of error, e.g. if ispell tables are absent, the function will return <literal>FALSE</literal> and code and error message will be accessible through <function>udm_error</function> and <function>udm_errno</function>. + In this mode in case of error, e.g. if ispell tables are absent, the function will return &false; and code and error message will be accessible through <function>udm_error</function> and <function>udm_errno</function>. </para> </note> @@ -847,7 +847,7 @@ In this case <parameter>val1</parameter> defines double letter language code for which affixes are loaded, and <parameter>val2</parameter> - file path. Please note, that if a relative path entered, the module looks for the file not in UDM_CONF_DIR, but in relation to current path, i.e. to the path where the script is executed. - In case of error in this mode, e.g. if file is absent, the function will return <literal>FALSE</literal>, and an error message will be displayed. + In case of error in this mode, e.g. if file is absent, the function will return &false;, and an error message will be displayed. Error message text cannot be accessed through <function>udm_error</function> and <function>udm_errno</function>, since those functions can only return messages associated with SQL. Please, see <parameter>flag</parameter> parameter description in UDM_ISPELL_TYPE_DB. </para> @@ -875,7 +875,7 @@ In this case <parameter>val1</parameter> defines double letter language code for which affixes are loaded, and <parameter>val2</parameter> - file path. Please note, that if a relative path entered, the module looks for the file not in UDM_CONF_DIR, but in relation to current path, i.e. to the path where the script is executed. - In case of error in this mode, e.g. if file is absent, the function will return <literal>FALSE</literal>, and an error message will be displayed. + In case of error in this mode, e.g. if file is absent, the function will return &false;, and an error message will be displayed. Error message text cannot be accessed through <function>udm_error</function> and <function>udm_errno</function>, since those functions can only return messages associated with SQL. Please, see <parameter>flag</parameter> parameter description in UDM_ISPELL_TYPE_DB. </para> @@ -960,8 +960,8 @@ </funcsynopsis> <para> - <function>udm_set_agent_param</function> returns <literal>TRUE</literal> on success, - <literal>FALSE</literal> on error. Defines mnoGoSearch session parameters. + <function>udm_set_agent_param</function> returns &true; on success, + &false; on error. Defines mnoGoSearch session parameters. </para> <simpara> Index: phpdoc/en/functions/msql.xml diff -u phpdoc/en/functions/msql.xml:1.8 phpdoc/en/functions/msql.xml:1.9 --- phpdoc/en/functions/msql.xml:1.8 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/msql.xml Sat Jul 7 14:42:33 2001 @@ -32,7 +32,7 @@ </funcsynopsis> <para> Returns a positive mSQL query identifier to the query result, or - false on error. + &false; on error. </para> <para> <function>msql</function> selects a database and executes a query @@ -84,7 +84,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error. + Returns &true; on success, &false; on error. </para> <para> <function>msql_close</function> closes the link to a mSQL @@ -141,7 +141,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a positive mSQL link identifier on success, or false on + Returns a positive mSQL link identifier on success, or &false; on error. </para> <para> @@ -229,7 +229,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on failure. + Returns &true; on success, &false; on failure. </para> <para> <function>msql_data_seek</function> moves the internal row @@ -283,7 +283,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on failure. + Returns &true; on success, &false; on failure. </para> <para> <function>msql_drop_db</function> attempts to drop (remove) an @@ -347,7 +347,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an array that corresponds to the fetched row, or false if + Returns an array that corresponds to the fetched row, or &false; if there are no more rows. </para> <para> @@ -364,7 +364,7 @@ <para> Be careful if you are retrieving results from a query that may return a record that contains only one field that has a value of - 0 (or an empty string, or NULL). + 0 (or an empty string, or &null;). </para> <para> An important thing to note is that using @@ -417,7 +417,7 @@ </listitem> <listitem> <simpara> - not_null - 1 if the column cannot be null + not_null - 1 if the column cannot be &null; </simpara> </listitem> <listitem> @@ -461,7 +461,7 @@ </funcsynopsis> <para> Returns an object with properties that correspond to the fetched - row, or false if there are no more rows. + row, or &false; if there are no more rows. </para> <para> <function>msql_fetch_object</function> is similar to @@ -502,7 +502,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an array that corresponds to the fetched row, or false if + Returns an array that corresponds to the fetched row, or &false; if there are no more rows. </para> <para> @@ -513,7 +513,7 @@ </para> <para> Subsequent call to <function>msql_fetch_row</function> would - return the next row in the result set, or false if there are no + return the next row in the result set, or &false; if there are no more rows. </para> <para> @@ -635,7 +635,7 @@ </funcsynopsis> <para> <function>msql_fieldflags</function> returns the field flags of - the specified field. Currently this is either, "not null", + the specified field. Currently this is either, "not &null;", "primary key", a combination of the two or "" (an empty string). </para> </refsect1> @@ -938,7 +938,7 @@ </funcsynopsis> <para> Returns a positive mSQL persistent link identifier on success, or - false on error. + &false; on error. </para> <para> <function>msql_pconnect</function> acts very much like @@ -985,7 +985,7 @@ <function>msql_connect</function> was called, and use it. </para> <para> - Returns a positive mSQL query identifier on success, or false on + Returns a positive mSQL query identifier on success, or &false; on error. </para> <para> @@ -1070,7 +1070,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error. + Returns &true; on success, &false; on error. </para> <para> <function>msql_select_db</function> sets the current active Index: phpdoc/en/functions/mssql.xml diff -u phpdoc/en/functions/mssql.xml:1.12 phpdoc/en/functions/mssql.xml:1.13 --- phpdoc/en/functions/mssql.xml:1.12 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/mssql.xml Sat Jul 7 14:42:33 2001 @@ -18,7 +18,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: true on success, false on error. + Returns: &true; on success, &false; on error. </para> <para> <function>mssql_close</function> closes the link to a MS SQL @@ -64,7 +64,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: A positive MS SQL link identifier on success, or false + Returns: A positive MS SQL link identifier on success, or &false; on error. </para> <para> @@ -105,7 +105,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: true on success, false on failure. + Returns: &true; on success, &false; on failure. </para> <para> <function>mssql_data_seek</function> moves the internal row @@ -133,7 +133,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: An array that corresponds to the fetched row, or false + Returns: An array that corresponds to the fetched row, or &false; if there are no more rows. </para> <para> @@ -227,7 +227,7 @@ </funcsynopsis> <para> Returns: An object with properties that correspond to the fetched - row, or false if there are no more rows. + row, or &false; if there are no more rows. </para> <para> <function>mssql_fetch_object</function> is similar to @@ -263,7 +263,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: An array that corresponds to the fetched row, or false + Returns: An array that corresponds to the fetched row, or &false; if there are no more rows. </para> <para> @@ -274,7 +274,7 @@ </para> <para> Subsequent call to <function>mssql_fetch_rows</function> would - return the next row in the result set, or false if there are no + return the next row in the result set, or &false; if there are no more rows. </para> <para> @@ -470,8 +470,8 @@ This function will test for additional results available form the server. if an additional result set exists it will free the existing result set and prepare to fetch the wors from the new result set. - The function will return <literal>TRUE</literal> if an additional result set was - available or <literal>FALSE</literal> othervise. + The function will return &true; if an additional result set was + available or &false; othervise. </para> <example> <title><function>mssql_next_result</function> example</title> @@ -567,7 +567,7 @@ </funcsynopsis> <para> Returns: A positive MS SQL persistent link identifier on success, - or false on error. + or &false; on error. </para> <para> <function>mssql_pconnect</function> acts very much like @@ -608,7 +608,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: A positive MS SQL result identifier on success, or false + Returns: A positive MS SQL result identifier on success, or &false; on error. </para> <para> @@ -684,7 +684,7 @@ </paramdef> </funcprototype> </funcsynopsis> - <para> Returns: true on success, false on error + <para> Returns: &true; on success, &false; on error </para> <para> <function>mssql_select_db</function> sets the current active Index: phpdoc/en/functions/mysql.xml diff -u phpdoc/en/functions/mysql.xml:1.50 phpdoc/en/functions/mysql.xml:1.51 --- phpdoc/en/functions/mysql.xml:1.50 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/mysql.xml Sat Jul 7 14:42:33 2001 @@ -181,7 +181,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: true on success, false on error. + Returns: &true; on success, &false; on error. </para> <para> <function>mysql_close</function> closes the connection to the MySQL server that's associated with the specified link @@ -250,7 +250,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a MySQL link identifier on success, or FALSE on failure. + Returns a MySQL link identifier on success, or &false; on failure. </para> <para> <function>mysql_connect</function> establishes a connection @@ -372,7 +372,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: true on success, false on failure. + Returns: &true; on success, &false; on failure. </para> <para> <function>mysql_data_seek</function> moves the internal row @@ -447,7 +447,7 @@ </para> <para> - If an error occurs, FALSE is returned. Use + If an error occurs, &false; is returned. Use <function>mysql_errno</function> and <function>mysql_error</function> to determine the nature of the error. @@ -501,7 +501,7 @@ </funcsynopsis> <para> Returns: A positive MySQL result resource to the query result, - or false on error. + or &false; on error. </para> <para> <function>mysql_db_query</function> selects a database and @@ -541,7 +541,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: true on success, false on failure. + Returns: &true; on success, &false; on failure. </para> <para> <function>mysql_drop_db</function> attempts to drop (remove) an @@ -703,7 +703,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an array that corresponds to the fetched row, or false + Returns an array that corresponds to the fetched row, or &false; if there are no more rows.</para> <para> <function>mysql_fetch_array</function> is an extended version of @@ -774,7 +774,7 @@ </funcsynopsis> <para> Returns an associative array that corresponds to the fetched row, - or false if there are no more rows.</para> + or &false; if there are no more rows.</para> <para> <function>mysql_fetch_assoc</function> is equivalent to calling <function>mysql_fetch_array</function> with MYSQL_ASSOC for the @@ -865,7 +865,7 @@ </listitem> <listitem> <simpara> - not_null - 1 if the column cannot be null + not_null - 1 if the column cannot be &null; </simpara> </listitem> <listitem> @@ -970,7 +970,7 @@ <para> Returns: An array that corresponds to the lengths of each field in the last row fetched by <function>mysql_fetch_row</function>, - or false on error. + or &false; on error. </para> <para> <function>mysql_fetch_lengths</function> stores the lengths of @@ -1006,7 +1006,7 @@ </funcsynopsis> <para> Returns an object with properties that correspond to the fetched - row, or false if there are no more rows. + row, or &false; if there are no more rows. </para> <para> <function>mysql_fetch_object</function> is similar to @@ -1061,7 +1061,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: An array that corresponds to the fetched row, or false + Returns: An array that corresponds to the fetched row, or &false; if there are no more rows. </para> <para> @@ -1072,7 +1072,7 @@ </para> <para> Subsequent call to <function>mysql_fetch_row</function> would - return the next row in the result set, or false if there are no + return the next row in the result set, or &false; if there are no more rows. </para> <para> @@ -1539,7 +1539,7 @@ For downward compatibility <function>mysql_listfields</function> can also be used. </para> - <!-- TODO: this is equiv. with 'select * from $table where FALSE,' + <!-- TODO: this is equiv. with 'select * from $table where &false;,' which implies you can better use the field-research functions on a real query, that saves you one mysql-query. --> @@ -1687,7 +1687,7 @@ </funcsynopsis> <para> Returns: A positive MySQL persistent link identifier on success, - or false on error. + or &false; on error. </para> <para> <function>mysql_pconnect</function> establishes a connection @@ -1766,16 +1766,16 @@ </para> </note> <para> - <function>mysql_query</function> returns TRUE (non-zero) or FALSE + <function>mysql_query</function> returns &true; (non-zero) or &false; to indicate whether or not the query succeeded. A return value - of TRUE means that the query was legal and could be executed by + of &true; means that the query was legal and could be executed by the server. It does not indicate anything about the number of rows affected or returned. It is perfectly possible for a query to succeed but affect no rows or return no rows. </para> <para> The following query is syntactically invalid, so - <function>mysql_query</function> fails and returns FALSE: + <function>mysql_query</function> fails and returns &false;: <example> <title><function>mysql_query</function></title> <programlisting role="php"> @@ -1790,7 +1790,7 @@ The following query is semantically invalid if <literal>my_col</literal> is not a column in the table <literal>my_tbl</literal>, so <function>mysql_query</function> - fails and returns FALSE: + fails and returns &false;: <example> <title><function>mysql_query</function></title> <programlisting role="php"> @@ -1802,7 +1802,7 @@ </example> </para> <para> - <function>mysql_query</function> will also fail and return FALSE + <function>mysql_query</function> will also fail and return &false; if you don't have permission to access the table(s) referenced by the query. </para> @@ -1947,7 +1947,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: true on success, false on error. + Returns: &true; on success, &false; on error. </para> <para> <function>mysql_select_db</function> sets the current active Index: phpdoc/en/functions/network.xml diff -u phpdoc/en/functions/network.xml:1.36 phpdoc/en/functions/network.xml:1.37 --- phpdoc/en/functions/network.xml:1.36 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/network.xml Sat Jul 7 14:42:34 2001 @@ -23,8 +23,8 @@ </funcsynopsis> <simpara> Searches DNS for records of type <parameter>type</parameter> - corresponding to <parameter>host</parameter>. Returns true if any - records are found; returns false if no records were found or if + corresponding to <parameter>host</parameter>. Returns &true; if any + records are found; returns &false; if no records were found or if an error occurred. </simpara> <simpara> @@ -189,12 +189,12 @@ <function>feof</function>). </para> <para> - If the call fails, it will return false and if the optional + If the call fails, it will return &false; and if the optional <parameter>errno</parameter> and <parameter>errstr</parameter> arguments are present they will be set to indicate the actual system level error that occurred on the system-level <literal>connect()</literal> call. If the returned errno is 0 and - the function returned false, it is an indication that the error + the function returned &false;, it is an indication that the error occurred before the <literal>connect()</literal> call. This is most likely due to a problem initializing the socket. Note that the <parameter>errno</parameter> and @@ -356,8 +356,8 @@ </funcsynopsis> <simpara> Searches DNS for MX records corresponding to - <parameter>hostname</parameter>. Returns true if any records are - found; returns false if no records were found or if an error + <parameter>hostname</parameter>. Returns &true; if any records are + found; returns &false; if no records were found or if an error occurred. </simpara> <simpara> @@ -595,7 +595,7 @@ The use of <function>openlog</function> is optional. It will automatically be called by <function>syslog</function> if necessary, in which case <parameter>ident</parameter> will default - to false. + to &false;. </para> <para> <table> @@ -823,8 +823,8 @@ </funcprototype> </funcsynopsis> <para> - If <parameter>mode</parameter> is false, the given socket - descriptor will be switched to non-blocking mode, and if true, it + If <parameter>mode</parameter> is &false;, the given socket + descriptor will be switched to non-blocking mode, and if &true;, it will be switched to blocking mode. This affects calls like <function>fgets</function> that read from the socket. In non-blocking mode an <function>fgets</function> call will always Index: phpdoc/en/functions/nis.xml diff -u phpdoc/en/functions/nis.xml:1.11 phpdoc/en/functions/nis.xml:1.12 --- phpdoc/en/functions/nis.xml:1.11 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/nis.xml Sat Jul 7 14:42:34 2001 @@ -32,7 +32,7 @@ </funcsynopsis> <para> <function>yp_get_default_domain</function> returns the default - domain of the node or FALSE. Can be used as the domain parameter + domain of the node or &false;. Can be used as the domain parameter for successive NIS calls. </para> <para> @@ -77,7 +77,7 @@ </funcsynopsis> <para> <function>yp_order</function> returns the order number for a map - or FALSE. + or &false;. </para> <para> <example> @@ -158,7 +158,7 @@ </funcsynopsis> <para> <function>yp_match</function> returns the value associated with - the passed key out of the specified map or FALSE. This key must + the passed key out of the specified map or &false;. This key must be exact.</para> <para> <example> @@ -203,7 +203,7 @@ </funcsynopsis> <para> <function>yp_first</function> returns the first key-value - pair from the named map in the named domain, otherwise FALSE. + pair from the named map in the named domain, otherwise &false;. </para> <para> <example> @@ -246,7 +246,7 @@ </funcsynopsis> <para> <function>yp_next</function> returns the next key-value pair in - the named map after the specified key or FALSE. + the named map after the specified key or &false;. </para> <para> <example> Index: phpdoc/en/functions/oci8.xml diff -u phpdoc/en/functions/oci8.xml:1.25 phpdoc/en/functions/oci8.xml:1.26 --- phpdoc/en/functions/oci8.xml:1.25 Fri Jun 29 08:52:59 2001 +++ phpdoc/en/functions/oci8.xml Sat Jul 7 14:42:34 2001 @@ -943,12 +943,12 @@ <function>OCIFetchInto</function> will overwrite the previous content of <parameter>result</parameter>. By default <parameter>result</parameter> will contain a zero-based array of all - columns that are not NULL. + columns that are not &null;. </para> <para> The <parameter>mode</parameter> parameter allows you to change the default behaviour. You can specify more than one flag by simply - adding them up (eg OCI_ASSOC+OCI_RETURN_NULLS). The known flags + adding them up (eg OCI_ASSOC+OCI_RETURN_nullS). The known flags are: <simplelist> <member> @@ -959,7 +959,7 @@ zero. (DEFAULT) </member> <member> - <literal>OCI_RETURN_NULLS</literal> Return empty columns. + <literal>OCI_RETURN_nullS</literal> Return empty columns. </member> <member> <literal>OCI_RETURN_LOBS</literal> Return the value of a LOB @@ -1036,22 +1036,22 @@ <refentry id="function.ocicolumnisnull"> <refnamediv> - <refname>OCIColumnIsNULL</refname> - <refpurpose>test whether a result column is NULL</refpurpose> + <refname>OCIColumnIsnull</refname> + <refpurpose>test whether a result column is &null;</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>OCIColumnIsNULL</function></funcdef> + <funcdef>int <function>OCIColumnIsnull</function></funcdef> <paramdef>int <parameter>stmt</parameter></paramdef> <paramdef>mixed <parameter>column</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>OCIColumnIsNULL</function> returns true if the returned + <function>OCIColumnIsnull</function> returns &true; if the returned column <parameter>column</parameter> in the result from the - statement <parameter>stmt</parameter> is NULL. You can either use + statement <parameter>stmt</parameter> is &null;. You can either use the column-number (1-Based) or the column-name for the <parameter>col</parameter> parameter. </para> @@ -1426,8 +1426,8 @@ </funcprototype> </funcsynopsis> <para> - <function>OCIFreeStatement</function> returns true if successful, - or false if unsuccessful. + <function>OCIFreeStatement</function> returns &true; if successful, + or &false; if unsuccessful. </para> </refsect1> </refentry> @@ -1448,8 +1448,8 @@ </funcprototype> </funcsynopsis> <para> - <function>OCIFreeCursor</function> returns true if successful, or - false if unsuccessful. + <function>OCIFreeCursor</function> returns &true; if successful, or + &false; if unsuccessful. </para> </refsect1> </refentry> @@ -1468,8 +1468,8 @@ </funcprototype> </funcsynopsis> <para> - <function>OCIFreeDesc</function> returns true if successful, or - false if unsuccessful. + <function>OCIFreeDesc</function> returns &true; if successful, or + &false; if unsuccessful. </para> </refsect1> </refentry> @@ -1491,7 +1491,7 @@ <simpara> <function>OCIParse</function> parses the <parameter>query</parameter> using <parameter>conn</parameter>. - It returns the statement identity if the query is valid, false if + It returns the statement identity if the query is valid, &false; if not. The <parameter>query</parameter> can be any valid SQL statement. </simpara> @@ -1501,7 +1501,7 @@ <refnamediv> <refname>OCIError</refname> <refpurpose>Return the last error of stmt|conn|global. - If no error happened returns false. + If no error happened returns &false;. </refpurpose> </refnamediv> <refsect1> @@ -1519,7 +1519,7 @@ the optional <parameter>stmt|conn|global</parameter> is not provided, the last error encountered is returned. If no error is found, <function>OCIError</function> returns - false. <function>OCIError</function> returns the error as an + &false;. <function>OCIError</function> returns the error as an associative array. In this array, <parameter>code</parameter> consists the oracle error code and <parameter>message</parameter> the oracle errorstring. Index: phpdoc/en/functions/openssl.xml diff -u phpdoc/en/functions/openssl.xml:1.9 phpdoc/en/functions/openssl.xml:1.10 --- phpdoc/en/functions/openssl.xml:1.9 Sun Jun 24 11:27:21 2001 +++ phpdoc/en/functions/openssl.xml Sat Jul 7 14:42:34 2001 @@ -189,7 +189,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an error message string, or false if there are no more error + Returns an error message string, or &false; if there are no more error messages to return. </para> <para> @@ -252,7 +252,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a positive key resource identifier on success, or false on error. + Returns a positive key resource identifier on success, or &false; on error. </para> <para> <function>openssl_get_privatekey</function> parses the PEM @@ -278,7 +278,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a positive key resource identifier on success, or false on error. + Returns a positive key resource identifier on success, or &false; on error. </para> <para> <function>openssl_get_publickey</function> extracts the @@ -306,7 +306,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, or false on error. If successful the opened + Returns &true; on success, or &false; on error. If successful the opened data is returned in <parameter>open_data</parameter>. </para> <para> @@ -366,7 +366,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the length of the sealed data on success, or false on error. + Returns the length of the sealed data on success, or &false; on error. If successful the sealed data is returned in <parameter>sealed_data</parameter>, and the envelope keys in <parameter>env_keys</parameter>. @@ -432,7 +432,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, or false on failure. + Returns &true; on success, or &false; on failure. If successful the signature is returned in <parameter>signature</parameter>. </para> @@ -750,8 +750,8 @@ <para> <function>openssl_pkcs7_verify</function> reads the S/MIME message contained in the filename specified by <parameter>filename</parameter> and - examines the digital signature. It returns true if the signature is - verified, false if it is not correct (the message has been tampered with, + examines the digital signature. It returns &true; if the signature is + verified, &false; if it is not correct (the message has been tampered with, or the signing certificate is invalid), or -1 on error. </para> <para> @@ -801,8 +801,8 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the certificate can be used for the intended purpose, - false if it cannot, or -1 on error. + Returns &true; if the certificate can be used for the intended purpose, + &false; if it cannot, or -1 on error. </para> <para> <function>openssl_x509_checkpurpose</function> examines the certificate @@ -920,7 +920,7 @@ supplied <parameter>x509cert</parameter>, including fields such as subject name, issuer name, purposes, valid from and valid to dates etc. <parameter>shortnames</parameter> controls how the data is indexed in the - array - if <parameter>shortnames</parameter> is true (the default) then + array - if <parameter>shortnames</parameter> is &true; (the default) then fields will be indexed with the short name form, otherwise, the long name form will be used - e.g.: CN is the shortname form of commonName. </para> Index: phpdoc/en/functions/oracle.xml diff -u phpdoc/en/functions/oracle.xml:1.14 phpdoc/en/functions/oracle.xml:1.15 --- phpdoc/en/functions/oracle.xml:1.14 Mon Aug 28 07:16:40 2000 +++ phpdoc/en/functions/oracle.xml Sat Jul 7 14:42:34 2001 @@ -20,7 +20,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the bind succeeds, otherwise false. Details + Returns &true; if the bind succeeds, otherwise &false;. Details about the error can be retrieved using the <function>ora_error</function> and <function>ora_errorcode</function> functions. @@ -70,7 +70,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the close succeeds, otherwise false. Details + Returns &true; if the close succeeds, otherwise &false;. Details about the error can be retrieved using the <function>ora_error</function> and <function>ora_errorcode</function> functions. @@ -175,7 +175,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error. Details about the + Returns &true; on success, &false; on error. Details about the error can be retrieved using the <function>ora_error</function> and <function>ora_errorcode</function> functions. </para> @@ -201,7 +201,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error. Details about the error + Returns &true; on success, &false; on error. Details about the error can be retrieved using the <function>ora_error</function> and <function>ora_errorcode</function> functions. </para> @@ -230,7 +230,7 @@ <function>ora_exec</function> on the given connection. </para> <para> - Returns true on success, false on error. Details about the error + Returns &true; on success, &false; on error. Details about the error can be retrieved using the <function>ora_error</function> and <function>ora_errorcode</function> functions. </para> @@ -257,7 +257,7 @@ It will parse and execute a statement, then fetch the first result row. </para> <para> - Returns true on success, false on error. Details about the error + Returns &true; on success, &false; on error. Details about the error can be retrieved using the <function>ora_error</function> and <function>ora_errorcode</function> functions. </para> @@ -347,7 +347,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error. Details about the error + Returns &true; on success, &false; on error. Details about the error can be retrieved using the <function>ora_error</function> and <function>ora_errorcode</function> functions. </para> @@ -372,7 +372,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true (a row was fetched) or false (no more rows, or an + Returns &true; (a row was fetched) or &false; (no more rows, or an error occured). If an error occured, details can be retrieved using the <function>ora_error</function> and <function>ora_errorcode</function> functions. If there was no @@ -444,11 +444,11 @@ </funcprototype> </funcsynopsis> <para> - Returns the column data. If an error occurs, False is returned + Returns the column data. If an error occurs, &false; is returned and <function>ora_errorcode</function> - will return a non-zero value. Note, however, that a test for False - on the results from this function may be true in cases where there is - not error as well (NULL result, empty string, the number 0, the + will return a non-zero value. Note, however, that a test for &false; + on the results from this function may be &true; in cases where there is + not error as well (&null; result, empty string, the number 0, the string "0"). </para> <para> @@ -471,7 +471,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error. Details about the error + Returns &true; on success, &false; on error. Details about the error can be retrieved using the <function>ora_error</function> and <function>ora_errorcode</function> functions. </para> @@ -519,7 +519,7 @@ server's environment before starting the server. </para> <para> - Returns a connection index on success, or false on failure. + Returns a connection index on success, or &false; on failure. Details about the error can be retrieved using the <function>ora_error</function> and <function>ora_errorcode</function> functions. @@ -613,7 +613,7 @@ Opens an Oracle cursor associated with connection. </para> <para> - Returns a cursor index or False on failure. Details about the + Returns a cursor index or &false; on failure. Details about the error can be retrieved using the <function>ora_error</function> and <function>ora_errorcode</function> functions. </para> @@ -669,7 +669,7 @@ transaction.) </para> <para> - Returns true on success, false on error. Details about the error + Returns &true; on success, &false; on error. Details about the error can be retrieved using the <function>ora_error</function> and <function>ora_errorcode</function> functions. </para> Index: phpdoc/en/functions/outcontrol.xml diff -u phpdoc/en/functions/outcontrol.xml:1.12 phpdoc/en/functions/outcontrol.xml:1.13 --- phpdoc/en/functions/outcontrol.xml:1.12 Fri Mar 30 19:46:13 2001 +++ phpdoc/en/functions/outcontrol.xml Sat Jul 7 14:42:35 2001 @@ -210,7 +210,7 @@ </funcprototype> </funcsynopsis> <para> - This will return the contents of the output buffer or FALSE, if + This will return the contents of the output buffer or &false;, if output buffering isn't active. </para> <para> @@ -237,7 +237,7 @@ </funcsynopsis> <para> This will return the length of the contents in the output buffer - or FALSE, if output buffering isnt't active. + or &false;, if output buffering isnt't active. </para> <para> See also <function>ob_start</function> and Index: phpdoc/en/functions/ovrimos.xml diff -u phpdoc/en/functions/ovrimos.xml:1.6 phpdoc/en/functions/ovrimos.xml:1.7 --- phpdoc/en/functions/ovrimos.xml:1.6 Wed May 16 14:33:21 2001 +++ phpdoc/en/functions/ovrimos.xml Sat Jul 7 14:42:35 2001 @@ -166,7 +166,7 @@ are to be retrieved from long datatypes (long varchar and long varbinary). Default is zero. Regardless of its taking a result_id as an argument, it currently sets this parameter for all result - sets. Returns <literal>TRUE</literal>. + sets. Returns &true;. </para> </refsect1> </refentry> @@ -190,7 +190,7 @@ </para> <para> <function>ovrimos_prepare</function> prepares an SQL statement - and returns a result_id (or false on failure). + and returns a result_id (or &false; on failure). </para> <para> <example> @@ -247,7 +247,7 @@ </para> <para> <function>ovrimos_execute</function> executes a prepared - statement. Returns <literal>TRUE</literal> or <literal>FALSE</literal>. + statement. Returns &true; or &false;. If the prepared statement contained parameters (question marks in the statement), the correct number of parameters should be passed in an array. Notice @@ -303,7 +303,7 @@ </para> <para> <function>ovrimos_exec</function> executes an SQL statement - (query or update) and returns a result_id or false. Evidently, + (query or update) and returns a result_id or &false;. Evidently, the SQL statement should not contain parameters. </para> </refsect1> @@ -344,7 +344,7 @@ and absolute position from the start (essentially equivalent to 'first' but needs 'rownumber'). Case is not significant. 'Rownumber' is optional except for absolute - positioning. Returns <literal>TRUE</literal> or <literal>FALSE</literal>. + positioning. Returns &true; or &false;. </para> <para> <example> @@ -407,7 +407,7 @@ <para> <function>ovrimos_fetch_row</function> fetches a row from the result set. Column values should be retrieved with other - calls. Returns <literal>TRUE</literal> or <literal>FALSE</literal>. + calls. Returns &true; or &false;. </para> <para> <example> @@ -495,8 +495,8 @@ </para> <para> <function>ovrimos_result_all</function> prints the whole result - set as an HTML table. Returns <literal>TRUE</literal> or - <literal>FALSE</literal>. + set as an HTML table. Returns &true; or + &false;. </para> <para> <example> @@ -730,7 +730,7 @@ </para> <para> <function>ovrimos_field_num</function> returns the (1-based) - index of the output column specified by name, or false. + index of the output column specified by name, or &false;. </para> </refsect1> </refentry> @@ -754,7 +754,7 @@ </para> <para> <function>ovrimos_free_result</function> frees the specified - result_id <parameter>result_id</parameter>. Returns <literal>TRUE</literal>. + result_id <parameter>result_id</parameter>. Returns &true;. </para> </refsect1> </refentry> Index: phpdoc/en/functions/pcre.xml diff -u phpdoc/en/functions/pcre.xml:1.51 phpdoc/en/functions/pcre.xml:1.52 --- phpdoc/en/functions/pcre.xml:1.51 Wed May 30 11:36:40 2001 +++ phpdoc/en/functions/pcre.xml Sat Jul 7 14:42:35 2001 @@ -92,8 +92,8 @@ the first captured parenthesized subpattern, and so on. </para> <para> - Returns true if a match for <parameter>pattern</parameter> was - found in the subject string, or false if not match was found + Returns &true; if a match for <parameter>pattern</parameter> was + found in the subject string, or &false; if not match was found or an error occurred. </para> <para> @@ -243,7 +243,7 @@ to be PREG_PATTERN_ORDER. </para> <para> - Returns the number of full pattern matches, or false if + Returns the number of full pattern matches, or &false; if no match is found or an error occurred. </para> <para> @@ -941,7 +941,7 @@ "b", but matching "aabbaa" against /^(aa(bb)?)+$/ leaves $2 unset. However, if the pattern is changed to /^(aa(b(b))?)+$/ then $2 (and $3) get set. - In Perl 5.004 $2 is set in both cases, and that is also true + In Perl 5.004 $2 is set in both cases, and that is also &true; of PCRE. If in the future Perl changes to a consistent state that is different, PCRE may change to follow. </simpara> @@ -1585,7 +1585,7 @@ <title>Cicumflex and dollar</title> <literallayout> Outside a character class, in the default matching mode, the - circumflex character is an assertion which is true only if + circumflex character is an assertion which is &true; only if the current matching point is at the start of the subject string. Inside a character class, circumflex has an entirely different meaning (see below). @@ -1599,7 +1599,7 @@ said to be an "anchored" pattern. (There are also other con- structs that can cause a pattern to be anchored.) - A dollar character is an assertion which is true only if the + A dollar character is an assertion which is &true; only if the current matching point is at the end of the subject string, or immediately before a newline character that is the last character in the string (by default). Dollar need not be the @@ -2113,7 +2113,7 @@ does not find an occurrence of "bar" that is preceded by something other than "foo"; it finds any occurrence of "bar" - whatsoever, because the assertion (?!foo) is always true + whatsoever, because the assertion (?!foo) is always &true; when the next three characters are "bar". A lookbehind assertion is needed to achieve this effect. @@ -2347,7 +2347,7 @@ that are not parentheses. The third part is a conditional subpattern that tests whether the first set of parentheses matched or not. If they did, that is, if subject started - with an opening parenthesis, the condition is true, and so + with an opening parenthesis, the condition is &true;, and so the yes-pattern is executed and a closing parenthesis is required. Otherwise, since no-pattern is not present, the subpattern matches nothing. In other words, this pattern Index: phpdoc/en/functions/pdf.xml diff -u phpdoc/en/functions/pdf.xml:1.58 phpdoc/en/functions/pdf.xml:1.59 --- phpdoc/en/functions/pdf.xml:1.58 Sat Jun 2 20:50:40 2001 +++ phpdoc/en/functions/pdf.xml Sat Jul 7 14:42:35 2001 @@ -62,7 +62,7 @@ supported by PHP 4 with exactly the same meaning and the same parameters. Only the return values may differ from the PDFlib manual, because the PHP convention of returning - <literal>false</literal> was adopted. For compatibility reasons + &false; was adopted. For compatibility reasons this binding for PDFlib still supports the old functions, but they should be replaced by their new versions. PDFlib GmbH will not support any problems arising from the use of these deprecated @@ -315,7 +315,7 @@ exit; }; -pdf_set_parameter($pdf, "warning", "true"); +pdf_set_parameter($pdf, "warning", "&true;"); pdf_set_info($pdf, "Creator", "pdf_clock.php"); pdf_set_info($pdf, "Author", "Uwe Steinmann"); @@ -1172,7 +1172,7 @@ or the name of a CMap. </para> <para> - <function>pdf_findfont</function> returns a font handle or false + <function>pdf_findfont</function> returns a font handle or &false; on error. </para> <para> Index: phpdoc/en/functions/pgsql.xml diff -u phpdoc/en/functions/pgsql.xml:1.34 phpdoc/en/functions/pgsql.xml:1.35 --- phpdoc/en/functions/pgsql.xml:1.34 Wed Jun 27 01:59:41 2001 +++ phpdoc/en/functions/pgsql.xml Sat Jul 7 14:42:36 2001 @@ -117,7 +117,7 @@ </funcprototype> </funcsynopsis> <para> - Returns false if connection is not a valid connection index, true + Returns &false; if connection is not a valid connection index, &true; otherwise. Closes down the connection to a PostgreSQL database associated with the given connection index. </para> @@ -203,7 +203,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a connection index on success, or false if the connection + Returns a connection index on success, or &false; if the connection could not be made. Opens a connection to a PostgreSQL database. The arguments should be within a quoted string. <example> @@ -263,7 +263,7 @@ </funcsynopsis> <para> Returns the name of the database that the given PostgreSQL - connection index is connected to, or false if connection is not a + connection index is connected to, or &false; if connection is not a valid connection index. </para> </refsect1> @@ -288,7 +288,7 @@ <function>pg_end_copy</function> syncs PostgreSQL frontend with the backend after doing a copy operation. It must be issued or the backend may get "out of sync" with the frontend. Returns - TRUE if successfull, FALSE otherwise. + &true; if successfull, &false; otherwise. </para> <para> For further details and an example, see also @@ -311,7 +311,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a string containing the error message, false on failure. + Returns a string containing the error message, &false; on failure. Details about the error probably cannot be retrieved using the <function>pg_errormessage</function> function if an error occured on the last database action for which a valid connection exists, @@ -336,7 +336,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a result index if query could be executed, false on + Returns a result index if query could be executed, &false; on failure or if connection is not a valid connection index. Details about the error can be retrieved using the <function>pg_ErrorMessage</function> function if connection is @@ -375,7 +375,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: An array that corresponds to the fetched row, or false + Returns: An array that corresponds to the fetched row, or &false; if there are no more rows. </para> <para> @@ -450,7 +450,7 @@ </funcsynopsis> <para> Returns: An object with properties that correspond to the fetched - row, or false if there are no more rows. + row, or &false; if there are no more rows. </para> <para> <function>pg_fetch_object</function> is similar to @@ -539,7 +539,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: An array that corresponds to the fetched row, or false + Returns: An array that corresponds to the fetched row, or &false; if there are no more rows. </para> <para> @@ -591,7 +591,7 @@ <refentry id="function.pg-fieldisnull"> <refnamediv> <refname>pg_fieldisnull</refname> - <refpurpose>Test if a field is NULL</refpurpose> + <refpurpose>Test if a field is &null;</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -604,9 +604,9 @@ </funcprototype> </funcsynopsis> <para> - Test if a field is NULL or not. Returns 0 if the field in the - given row is not NULL. Returns 1 if the field in the given row is - NULL. Field can be specified as number or fieldname. Row + Test if a field is &null; or not. Returns 0 if the field in the + given row is not &null;. Returns 1 if the field in the given row is + &null;. Field can be specified as number or fieldname. Row numbering starts at 0. </para> </refsect1> @@ -702,7 +702,7 @@ storage size (in bytes) of the field number in the given PostgreSQL result. Field numbering starts at 0. A field size of -1 indicates a variable length field. This function will return - false on error. + &false; on error. </para> </refsect1> </refentry> @@ -875,7 +875,7 @@ The <parameter>oid</parameter> argument specifies the object id of the large object to export and the <parameter>filename</parameter> argument specifies the pathname - of the file. Returns FALSE if an error occurred, TRUE + of the file. Returns &false; if an error occurred, &true; otherwise. Remember that handling large objects in PostgreSQL must happen inside a transaction. </para> @@ -903,7 +903,7 @@ <para> The <parameter>filename</parameter> argument specifies the pathname of the file to be imported as a large object. Returns - FALSE if an error occurred, object id of the just created large + &false; if an error occurred, object id of the just created large object otherwise. Remember that handling large objects in PostgreSQL must happen inside a transaction. </para> @@ -1022,7 +1022,7 @@ <para> <function>pg_lowrite</function> writes at most to a large object from a variable <parameter>buf</parameter> and returns the number - of bytes actually written, or false in the case of an error. + of bytes actually written, or &false; in the case of an error. <parameter>fd</parameter> is a file descriptor for the large object from <function>pg_loopen</function>. </para> @@ -1116,7 +1116,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a connection index on success, or false if the connection + Returns a connection index on success, or &false; if the connection could not be made. Opens a connection to a PostgreSQL database. The arguments should be within a quoted string. The arguments available include <parameter>host</parameter>, @@ -1167,7 +1167,7 @@ <refentry id="function.pg-put-line"> <refnamediv> <refname>pg_put_line</refname> - <refpurpose>Send a NULL-terminated string to PostgreSQL backend</refpurpose> + <refpurpose>Send a &null;-terminated string to PostgreSQL backend</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1181,11 +1181,11 @@ </funcprototype> </funcsynopsis> <para> - <function>pg_put_line</function> sends a NULL-terminated string + <function>pg_put_line</function> sends a &null;-terminated string to the PostgreSQL backend server. This is useful for example for very high-speed inserting of data into a table, initiated by - starting a PostgreSQL copy-operation. That final NULL-character - is added automatically. Returns TRUE if successfull, FALSE + starting a PostgreSQL copy-operation. That final &null;-character + is added automatically. Returns &true; if successfull, &false; otherwise. </para> <note> @@ -1374,8 +1374,8 @@ trace and defaults to the last one opened. </para> <para> - Returns TRUE if <parameter>filename</parameter> could be opened - for logging, FALSE otherwise. + Returns &true; if <parameter>filename</parameter> could be opened + for logging, &false; otherwise. </para> <para> See also <function>fopen</function> and @@ -1428,7 +1428,7 @@ traced and defaults to the last one opened. </para> <para> - Returns always TRUE. + Returns always &true;. </para> <para> See also <function>pg_trace</function>. Index: phpdoc/en/functions/posix.xml diff -u phpdoc/en/functions/posix.xml:1.10 phpdoc/en/functions/posix.xml:1.11 --- phpdoc/en/functions/posix.xml:1.10 Wed May 16 14:33:21 2001 +++ phpdoc/en/functions/posix.xml Sat Jul 7 14:42:37 2001 @@ -31,8 +31,8 @@ </funcsynopsis> <para> Send the signal <parameter>sig</parameter> to the process with - the process identifier <parameter>pid</parameter>. Returns FALSE, - if unable to send the signal, TRUE otherwise. + the process identifier <parameter>pid</parameter>. Returns &false;, + if unable to send the signal, &true; otherwise. </para> <para> See also the kill(2) manual page of your POSIX system, which @@ -194,7 +194,7 @@ your system to be able to perform this function. </para> <para> - Returns TRUE on success, FALSE otherwise. See also + Returns &true; on success, &false; otherwise. See also <function>posix_setgid</function>. </para> </refsect1> @@ -224,7 +224,7 @@ <function>posix_setuid</function> last. </para> <para> - Returns TRUE on success, FALSE otherwise. + Returns &true; on success, &false; otherwise. </para> </refsect1> </refentry> @@ -336,7 +336,7 @@ Let the process <parameter>pid</parameter> join the process group <parameter>pgid</parameter>. See POSIX.1 and the setsid(2) manual page on your POSIX system for more informations on process groups - and job control. Returns TRUE on success, FALSE otherwise. + and job control. Returns &true; on success, &false; otherwise. </para> </refsect1> </refentry> @@ -361,7 +361,7 @@ <para> This is not a POSIX function, but is common on BSD and System V systems. If your system does not support this function at system - level, this PHP function will always return FALSE. + level, this PHP function will always return &false;. </para> </refsect1> </refentry> @@ -387,7 +387,7 @@ <para> This is not a POSIX function, but is common on System V systems. If your system does not support this function at system level, - this PHP function will always return FALSE. + this PHP function will always return &false;. </para> </refsect1> </refentry> Index: phpdoc/en/functions/printer.xml diff -u phpdoc/en/functions/printer.xml:1.3 phpdoc/en/functions/printer.xml:1.4 --- phpdoc/en/functions/printer.xml:1.3 Fri Jun 22 05:59:28 2001 +++ phpdoc/en/functions/printer.xml Sat Jul 7 14:42:37 2001 @@ -25,7 +25,7 @@ <para> This function tries to open a connection to the printer <parameter>devicename</parameter>, and returns a handle on success - or false on failure. + or &false; on failure. </para> <para> If no parameter was given it tries to open a @@ -124,7 +124,7 @@ </funcsynopsis> <para> Writes <parameter>content</parameter> directly to the printer, and - returns true on success or false if it failed. + returns &true; on success or &false; if it failed. </para> <para> <parameter>handle</parameter> must be a valid handle to a printer. @@ -563,8 +563,8 @@ </funcprototype> </funcsynopsis> <para> - The function deletes the device context and returns true on success, - or false if an error occurred. For an example see + The function deletes the device context and returns &true; on success, + or &false; if an error occurred. For an example see <function>printer_create_dc</function>. <parameter>handle</parameter> must be a valid handle to a printer. </para> @@ -764,8 +764,8 @@ </funcsynopsis> <para> The function deletes the selected pen. For an example see - <function>printer_select_pen</function>. It returns true on success, - or false otherwise. <parameter>handle</parameter> must be a valid + <function>printer_select_pen</function>. It returns &true; on success, + or &false; otherwise. <parameter>handle</parameter> must be a valid handle to a pen. </para> </refsect1> @@ -913,8 +913,8 @@ </funcsynopsis> <para> The function deletes the selected brush. For an example see - <function>printer_select_brush</function>. It returns true on - success, or false otherwise. <parameter>handle</parameter> + <function>printer_select_brush</function>. It returns &true; on + success, or &false; otherwise. <parameter>handle</parameter> must be a valid handle to a brush. </para> </refsect1> @@ -1058,9 +1058,9 @@ </simpara> </listitem> </itemizedlist> - <parameter>italic</parameter> can be true or false, and sets whether the font should be italic. - <parameter>underline</parameter> can be true or false, and sets whether the font should be underlined. - <parameter>strikeout</parameter> can be true or false, and sets whether the font should be striked out. + <parameter>italic</parameter> can be &true; or &false;, and sets whether the font should be italic. + <parameter>underline</parameter> can be &true; or &false;, and sets whether the font should be underlined. + <parameter>strikeout</parameter> can be &true; or &false;, and sets whether the font should be striked out. <parameter>orientation</parameter> specifies a rotation. For an example see <function>printer_select_font</function>. </para> @@ -1083,8 +1083,8 @@ </funcsynopsis> <para> The function deletes the selected font. For an example see - <function>printer_select_font</function>. It returns true on success, - or false otherwise. <parameter>handle</parameter> must be a valid + <function>printer_select_font</function>. It returns &true; on success, + or &false; otherwise. <parameter>handle</parameter> must be a valid handle to a font. </para> </refsect1> @@ -1120,7 +1120,7 @@ printer_start_doc($handle, "My Document"); printer_start_page($handle); -$font = printer_create_font("Arial", 148, 76, PRINTER_FW_MEDIUM, false, false, false, -50); +$font = printer_create_font("Arial", 148, 76, PRINTER_FW_MEDIUM, &false;, &false;, &false;, -50); printer_select_font($handle, $font); printer_draw_text($handle, "PHP is simply cool", 40, 40); printer_delete_font($font); @@ -1393,7 +1393,7 @@ printer_start_doc($handle, "My Document"); printer_start_page($handle); -$font = printer_create_font("Arial",72,48,400,false,false,false,0); +$font = printer_create_font("Arial",72,48,400,&false;,&false;,&false;,0); printer_select_font($handle, $font); printer_draw_text($handle, "test", 10, 10); printer_delete_font($font); @@ -1644,7 +1644,7 @@ valid handle to a printer. </para> <para> - The function returns true on success, or otherwise false. + The function returns &true; on success, or otherwise &false;. </para> <example> <title><function>printer_draw_bmp</function> example</title> Index: phpdoc/en/functions/pspell.xml diff -u phpdoc/en/functions/pspell.xml:1.12 phpdoc/en/functions/pspell.xml:1.13 --- phpdoc/en/functions/pspell.xml:1.12 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/pspell.xml Sat Jul 7 14:42:37 2001 @@ -93,7 +93,7 @@ </funcsynopsis> <simpara> <function>pspell_check</function> checks the spelling of a word - and returns true if the spelling is correct, false if not. + and returns &true; if the spelling is correct, &false; if not. </simpara> <para> <example> @@ -444,7 +444,7 @@ <title><function>pspell_config_runtogether</function></title> <programlisting role="php"> $pspell_config = pspell_config_create ("en"); -pspell_config_runtogether ($pspell_config, true); +pspell_config_runtogether ($pspell_config, &true;); $pspell_link = pspell_new_config ($pspell_config); pspell_check ($pspell_link, "thecat"); </programlisting> Index: phpdoc/en/functions/recode.xml diff -u phpdoc/en/functions/recode.xml:1.10 phpdoc/en/functions/recode.xml:1.11 --- phpdoc/en/functions/recode.xml:1.10 Fri May 11 03:37:44 2001 +++ phpdoc/en/functions/recode.xml Sat Jul 7 14:42:37 2001 @@ -37,7 +37,7 @@ <para> Recode the string <parameter>string</parameter> according to the recode request <parameter>request</parameter>. Returns the - recoded string or FALSE, if unable to perform the recode request. + recoded string or &false;, if unable to perform the recode request. </para> <para> A simple recode request may be "lat1..iso646-de". @@ -97,8 +97,8 @@ Recode the file referenced by file handle <parameter>input</parameter> into the file referenced by file handle <parameter>output</parameter> according to the recode - <parameter>request</parameter>. Returns FALSE, if unable to - comply, TRUE otherwise. + <parameter>request</parameter>. Returns &false;, if unable to + comply, &true; otherwise. </para> <para> This function does not currently process filehandles referencing Index: phpdoc/en/functions/regex.xml diff -u phpdoc/en/functions/regex.xml:1.20 phpdoc/en/functions/regex.xml:1.21 --- phpdoc/en/functions/regex.xml:1.20 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/regex.xml Sat Jul 7 14:42:38 2001 @@ -42,19 +42,19 @@ <title>Regular Expression Examples</title> <programlisting role="php"> ereg ("abc", $string); -/* Returns true if "abc" +/* Returns &true; if "abc" is found anywhere in $string. */ ereg ("^abc", $string); -/* Returns true if "abc" +/* Returns &true; if "abc" is found at the beginning of $string. */ ereg ("abc$", $string); -/* Returns true if "abc" +/* Returns &true; if "abc" is found at the end of $string. */ eregi ("(ozilla.[23]|MSIE.3)", $HTTP_USER_AGENT); -/* Returns true if client browser +/* Returns &true; if client browser is Netscape 2, 3 or MSIE 3. */ ereg ("([[:alnum:]]+) ([[:alnum:]]+) ([[:alnum:]]+)", $string,$regs); @@ -118,8 +118,8 @@ Searching is case sensitive. </simpara> <simpara> - Returns true if a match for <parameter>pattern</parameter> was - found in <parameter>string</parameter>, or false if no matches + Returns &true; if a match for <parameter>pattern</parameter> was + found in <parameter>string</parameter>, or &false; if no matches were found or an error occurred. </simpara> <para> @@ -311,7 +311,7 @@ is set, the returned array will contain a maximum of <parameter>limit</parameter> elements with the last element containing the whole rest of <parameter>string</parameter>. If - an error occurs, <function>split</function> returns false. + an error occurs, <function>split</function> returns &false;. </para> <para> To split off the first four fields from a line from Index: phpdoc/en/functions/satellite.xml diff -u phpdoc/en/functions/satellite.xml:1.6 phpdoc/en/functions/satellite.xml:1.7 --- phpdoc/en/functions/satellite.xml:1.6 Sun Jun 24 19:13:22 2001 +++ phpdoc/en/functions/satellite.xml Sat Jul 7 14:42:38 2001 @@ -1,6 +1,6 @@ <!-- - $Id: satellite.xml,v 1.6 2001/06/24 23:13:22 jeroen Exp $ + $Id: satellite.xml,v 1.7 2001/07/07 18:42:38 jeroen Exp $ Author: David Eriksson <david@2good.com> @@ -197,7 +197,7 @@ </funcprototype> </funcsynopsis> <para> - This function returns true if an exception has been caught. + This function returns &true; if an exception has been caught. </para> <para> <example> Index: phpdoc/en/functions/sem.xml diff -u phpdoc/en/functions/sem.xml:1.9 phpdoc/en/functions/sem.xml:1.10 --- phpdoc/en/functions/sem.xml:1.9 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/sem.xml Sat Jul 7 14:42:39 2001 @@ -72,7 +72,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: A positive semaphore identifier on success, or <literal>FALSE</literal> on + Returns: A positive semaphore identifier on success, or &false; on error. </para> <para> @@ -115,7 +115,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: <literal>TRUE</literal> on success, <literal>FALSE</literal> on error. + Returns: &true; on success, &false; on error. </para> <para> <function>sem_acquire</function> blocks (if necessary) until the @@ -150,7 +150,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: <literal>TRUE</literal> on success, <literal>FALSE</literal> on error. + Returns: &true; on success, &false; on error. </para> <para> <function>sem_release</function> releases the semaphore if it @@ -187,7 +187,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: <literal>TRUE</literal> on success, <literal>FALSE</literal> + Returns: &true; on success, &false; on error. </para> <para> Index: phpdoc/en/functions/sesam.xml diff -u phpdoc/en/functions/sesam.xml:1.5 phpdoc/en/functions/sesam.xml:1.6 --- phpdoc/en/functions/sesam.xml:1.5 Fri May 11 03:37:44 2001 +++ phpdoc/en/functions/sesam.xml Sat Jul 7 14:42:39 2001 @@ -358,7 +358,7 @@ initialization string must be prefixed with the respective type keyword, as in: <literal> CREATE TABLE exmpl ( xtime timestamp(3) DEFAULT TIMESTAMP '1970-01-01 00:00:00.000' NOT - NULL ); </literal> + &null; ); </literal> </simpara> </listitem> <listitem> @@ -502,8 +502,8 @@ </funcprototype> </funcsynopsis> <para> - Returns <literal>TRUE</literal> if a connection to the SESAM - database was made, or <literal>FALSE</literal> on error. + Returns &true; if a connection to the SESAM + database was made, or &false; on error. </para> <para> <function>sesam_connect</function> establishes a connection to an @@ -561,7 +561,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: always <literal>TRUE</literal>. + Returns: always &true;. </para> <para> <function>sesam_disconnect</function> closes the logical link to @@ -612,9 +612,9 @@ </funcprototype> </funcsynopsis> <para> - Returns: <literal>TRUE</literal> if the values are valid, and the + Returns: &true; if the values are valid, and the <function>settransaction</function> operation was successful, - <literal>FALSE</literal> otherwise. + &false; otherwise. </para> <para> <function>sesam_settransaction</function> overrides the default @@ -732,8 +732,8 @@ </funcprototype> </funcsynopsis> <para> - Returns: <literal>TRUE</literal> on success, - <literal>FALSE</literal> on errors + Returns: &true; on success, + &false; on errors </para> <para> <function>sesam_commit</function> commits any pending updates to @@ -783,8 +783,8 @@ </funcprototype> </funcsynopsis> <para> - Returns: <literal>TRUE</literal> on success, - <literal>FALSE</literal> on errors + Returns: &true; on success, + &false; on errors </para> <para> <function>sesam_rollback</function> discards any pending updates @@ -832,7 +832,7 @@ </funcsynopsis> <para> Returns: A SESAM "result identifier" on success, or - <literal>FALSE</literal> on error. + &false; on error. </para> <para> <function>sesam_execimm</function> executes an "immediate" @@ -892,7 +892,7 @@ </funcsynopsis> <para> Returns: A SESAM "result identifier" on success, or - <literal>FALSE</literal> on error. + &false; on error. </para> <para> A "result_id" resource is used by other functions to retrieve the @@ -1008,7 +1008,7 @@ result. Returns an integer describing the total number of columns (aka. fields) in the current <parameter>result_id</parameter> result set or - <literal>FALSE</literal> on error. + &false; on error. </para> <para> For "immediate" statements, the value zero is returned. The SESAM @@ -1041,7 +1041,7 @@ </funcsynopsis> <para> Returns the name of a field (i.e., the column name) in the result - set, or <literal>FALSE</literal> on error. + set, or &false; on error. </para> <para> For "immediate" queries, or for dynamic columns, an empty string @@ -1261,10 +1261,10 @@ <row> <entry>boolean $arr["truncated"]</entry> <entry> - <literal>TRUE</literal> if the number of rows was at least - <parameter>max_rows</parameter>, <literal>FALSE</literal> + &true; if the number of rows was at least + <parameter>max_rows</parameter>, &false; otherwise. Note that even when this is - <literal>TRUE</literal>, the next + &true;, the next <function>sesam_fetch_result</function> call may return zero rows because there are no more result entries. </entry> @@ -1600,7 +1600,7 @@ </funcsynopsis> <para> Returns an array that corresponds to the fetched row, or - <literal>FALSE</literal> if there are no more rows. + &false; if there are no more rows. </para> <para> The number of columns in the result set is returned in an @@ -1719,7 +1719,7 @@ Subsequent calls to <function>sesam_fetch_row</function> would return the next (or prior, or n'th next/prior, depending on the scroll attributes) row in the result set, or - <literal>FALSE</literal> if there are no more rows. + &false; if there are no more rows. </para> <example> <title>SESAM fetch rows</title> @@ -1777,7 +1777,7 @@ </funcsynopsis> <para> Returns an array that corresponds to the fetched row, or - <literal>FALSE</literal> if there are no more rows. + &false; if there are no more rows. </para> <para> <function>sesam_fetch_array</function> is an alternative version @@ -1838,7 +1838,7 @@ Subsequent calls to <function>sesam_fetch_array</function> would return the next (or prior, or n'th next/prior, depending on the scroll attributes) row in the result set, or - <literal>FALSE</literal> if there are no more rows. + &false; if there are no more rows. </para> <example> <title>SESAM fetch array</title> @@ -1989,7 +1989,7 @@ <para> Releases resources for the query associated with <parameter>result_id</parameter>. Returns - <literal>FALSE</literal> on error. + &false; on error. </para> </refsect1> </refentry> Index: phpdoc/en/functions/session.xml diff -u phpdoc/en/functions/session.xml:1.44 phpdoc/en/functions/session.xml:1.45 --- phpdoc/en/functions/session.xml:1.44 Tue Jul 3 11:36:35 2001 +++ phpdoc/en/functions/session.xml Sat Jul 7 14:42:39 2001 @@ -351,7 +351,7 @@ the current one based on the session id being passed via a GET variable or a cookie).</simpara> <simpara> - This function always returns <literal>TRUE</literal>. + This function always returns &true;. </simpara> <note> <para> @@ -379,8 +379,8 @@ associated with the current session. </simpara> <simpara> - This function returns <literal>TRUE</literal> on success and - <literal>FALSE</literal> on failure to destroy + This function returns &true; on success and + &false; on failure to destroy the session data. </simpara> </refsect1> @@ -553,7 +553,7 @@ variable named by it with the current session. </para> <para> - This function returns <literal>TRUE</literal> when the variable is successfully + This function returns &true; when the variable is successfully registered with the session. </para> <note> @@ -598,7 +598,7 @@ current session. </para> <para> - This function returns <literal>TRUE</literal> when the variable is successfully + This function returns &true; when the variable is successfully unregistered from the session. <note> <para> @@ -647,7 +647,7 @@ </funcprototype> </funcsynopsis> <para> - <function>session_is_registered</function> returns <literal>TRUE</literal> if there + <function>session_is_registered</function> returns &true; if there is a variable with the name <parameter>name</parameter> registered in the current session. <note> @@ -851,11 +851,11 @@ $sess_save_path = $save_path; $sess_session_name = $session_name; - return(true); + return(&true;); } function close() { - return(true); + return(&true;); } function read ($id) { @@ -878,7 +878,7 @@ if ($fp = @fopen($sess_file, "w")) { return(fwrite($fp, $sess_data)); } else { - return(false); + return(&false;); } } @@ -895,7 +895,7 @@ * sort of garbage collection routine here. * *********************************************/ function gc ($maxlifetime) { - return true; + return &true;; } session_set_save_handler ("open", "close", "read", "write", "destroy", "gc"); Index: phpdoc/en/functions/snmp.xml diff -u phpdoc/en/functions/snmp.xml:1.8 phpdoc/en/functions/snmp.xml:1.9 --- phpdoc/en/functions/snmp.xml:1.8 Wed May 16 14:33:21 2001 +++ phpdoc/en/functions/snmp.xml Sat Jul 7 14:42:40 2001 @@ -46,7 +46,7 @@ </funcsynopsis> <para> - Returns SNMP object value on success and false on error.</para> + Returns SNMP object value on success and &false; on error.</para> <para> The <function>snmpget</function> function is used to read the @@ -87,8 +87,8 @@ </funcsynopsis> <para> - Sets the specified SNMP object value, returning true on success - and false on error.</para> + Sets the specified SNMP object value, returning &true; on success + and &false; on error.</para> <para> The <function>snmpset</function> function is used @@ -122,13 +122,13 @@ <para> Returns an array of SNMP object values starting from the - <function>object_id</function> as root and false on error.</para> + <function>object_id</function> as root and &false; on error.</para> <para> <function>snmpwalk</function> function is used to read all the values from an SNMP agent specified by the <parameter>hostname</parameter>. <parameter>Community</parameter> - specifies the read community for that agent. A null + specifies the read community for that agent. A &null; <parameter>object_id</parameter> is taken as the root of the SNMP objects tree and all objects under that tree are returned as an array. If <parameter>object_id</parameter> is specified, all the @@ -182,13 +182,13 @@ <para> Returns an associative array with object ids and their respective object value starting from the <parameter>object_id</parameter> - as root and false on error.</para> + as root and &false; on error.</para> <para> <function>snmpwalkoid</function> function is used to read all object ids and their respective values from an SNMP agent specified by the hostname. Community specifies the read - <parameter>community</parameter> for that agent. A null + <parameter>community</parameter> for that agent. A &null; <parameter>object_id</parameter> is taken as the root of the SNMP objects tree and all objects under that tree are returned as an array. If <parameter>object_id</parameter> is specified, all the @@ -249,8 +249,8 @@ </informalexample></para> <para> - Above function call would return <systemitem>false</systemitem> if - quick_print is on, and <systemitem>true</systemitem> if quick_print + Above function call would return <systemitem>&false;</systemitem> if + quick_print is on, and <systemitem>&true;</systemitem> if quick_print is on.</para> <para> Index: phpdoc/en/functions/sockets.xml diff -u phpdoc/en/functions/sockets.xml:1.13 phpdoc/en/functions/sockets.xml:1.14 --- phpdoc/en/functions/sockets.xml:1.13 Fri Jul 6 05:45:22 2001 +++ phpdoc/en/functions/sockets.xml Sat Jul 7 14:42:40 2001 @@ -90,9 +90,9 @@ $talkback = "PHP: You said '$buf'.\n"; write ($msgsock, $talkback, strlen ($talkback)); echo "$buf\n"; - } while (true); + } while (&true;); close ($msgsock); -} while (true); +} while (&true;); close ($sock); ?> @@ -290,7 +290,7 @@ <function>accept_connect</function>. </para> <para> - Returns <literal>TRUE</literal> on success, or <literal>FALSE</literal> + Returns &true; on success, or &false; if an error occurs (i.e., <parameter>socket</parameter> is invalid). </para> <para> Index: phpdoc/en/functions/strings.xml diff -u phpdoc/en/functions/strings.xml:1.96 phpdoc/en/functions/strings.xml:1.97 --- phpdoc/en/functions/strings.xml:1.96 Thu Jun 28 19:03:46 2001 +++ phpdoc/en/functions/strings.xml Sat Jul 7 14:42:40 2001 @@ -44,7 +44,7 @@ Be careful if you choose to escape characters 0, a, b, f, n, r, t and v. They will be converted to \0, \a, \b, \f, \n, \r, \t and \v. - In PHP \0 (NULL), \r (carriage return), \n (newline) and \t (tab) + In PHP \0 (&null;), \r (carriage return), \n (newline) and \t (tab) are predefined escape sequences, while in C all of these are predefined escape sequences. </para> @@ -116,7 +116,7 @@ to be quoted in database queries etc. These characters are single quote (<literal>'</literal>), double quote (<literal>"</literal>), backslash (<literal>\</literal>) - and NUL (the null byte). + and NUL (the &null; byte). </para> <para> See also <function>stripslashes</function>, @@ -555,11 +555,11 @@ echo $foo,$bar; // foobarbarbaz // because echo is not a function, following code is invalid. -($some_var) ? echo('true'): echo('false'); +($some_var) ? echo('&true;'): echo('&false;'); // However, the following examples will work: -($some_var) ? print('true'): print('false'); // print is a function -echo ($some_var) ? 'true': 'false'; // changing the statement around +($some_var) ? print('&true;'): print('&false;'); // print is a function +echo ($some_var) ? '&true;': '&false;'; // changing the statement around ?> </programlisting> </example> @@ -607,7 +607,7 @@ a maximum of <parameter>limit</parameter> elements with the last element containing the whole rest of <parameter>string</parameter>. If an empty string ("") is used as the <parameter>separator</parameter> - argument, then <function>explode</function> will return <literal>FALSE</literal>. + argument, then <function>explode</function> will return &false;. If <parameter>separator</parameter> contains a value that is not contained in the <parameter>string</parameter> argument, then<function>explode</function> will return the <parameter>string</parameter> argument. @@ -1220,19 +1220,19 @@ </row> <row> <entry>p_cs_precedes</entry> - <entry>True if currency_symbol precedes a positive value, false if it succeeds one</entry> + <entry>&true; if currency_symbol precedes a positive value, &false; if it succeeds one</entry> </row> <row> <entry>p_sep_by_space</entry> - <entry>True if a space separates currency_symbol from a positive value, false otherwise</entry> + <entry>&true; if a space separates currency_symbol from a positive value, &false; otherwise</entry> </row> <row> <entry>n_cs_precedes</entry> - <entry>True if currency_symbol precedes a negative value, false if it succeeds one</entry> + <entry>&true; if currency_symbol precedes a negative value, &false; if it succeeds one</entry> </row> <row> <entry>n_sep_by_space</entry> - <entry>True if a space separates currency_symbol from a negative value, false otherwise</entry> + <entry>&true; if a space separates currency_symbol from a negative value, &false; otherwise</entry> </row> <row valign="top"> <entry>p_sign_posn</entry> @@ -1764,7 +1764,7 @@ is not affected, only the current setting is returned. </para> <para> - Setlocale returns the new current locale, or false if the locale + Setlocale returns the new current locale, or &false; if the locale functionality is not implemented in the platform, the specified locale does not exist or the category name is invalid. An invalid category name also causes a warning message. @@ -2362,7 +2362,7 @@ are examined in a case-insensitive manner. </para> <para> - If <parameter>needle</parameter> is not found, returns false. + If <parameter>needle</parameter> is not found, returns &false;. </para> <para> If <parameter>needle</parameter> is not a string, it is converted @@ -2645,7 +2645,7 @@ entire string will be used. </para> <para> - If <parameter>needle</parameter> is not found, returns false. + If <parameter>needle</parameter> is not found, returns &false;. <note> <para> It is easy to mistake the return values for "character found at @@ -2655,7 +2655,7 @@ <programlisting role="php"> // in PHP 4.0b3 and newer: $pos = strpos ($mystring, "b"); -if ($pos === false) { // note: three equal signs +if ($pos === &false;) { // note: three equal signs // not found... } @@ -2710,7 +2710,7 @@ end of <parameter>haystack</parameter>. </para> <para> - Returns false if <parameter>needle</parameter> is not found. + Returns &false; if <parameter>needle</parameter> is not found. </para> <para> If <parameter>needle</parameter> contains more than one @@ -2818,7 +2818,7 @@ be used. </para> <para> - If <parameter>needle</parameter> is not found, returns false. + If <parameter>needle</parameter> is not found, returns &false;. <note> <para> It is easy to mistake the return values for "character found at @@ -2828,7 +2828,7 @@ <programlisting role="php"> // in PHP 4.0b3 and newer: $pos = strrpos ($mystring, "b"); -if ($pos === false) { // note: three equal signs +if ($pos === &false;) { // note: three equal signs // not found... } @@ -2910,7 +2910,7 @@ occurrence of <parameter>needle</parameter> to the end. </para> <para> - If <parameter>needle</parameter> is not found, returns false. + If <parameter>needle</parameter> is not found, returns &false;. </para> <para> If <parameter>needle</parameter> is not a string, it is converted @@ -2985,7 +2985,7 @@ </para> <para> Also be careful that your tokens may be equal to "0". This - evaluates to false in conditional expressions. + evaluates to &false; in conditional expressions. </para> <para> See also <function>split</function> and Index: phpdoc/en/functions/sybase.xml diff -u phpdoc/en/functions/sybase.xml:1.14 phpdoc/en/functions/sybase.xml:1.15 --- phpdoc/en/functions/sybase.xml:1.14 Wed May 16 14:33:21 2001 +++ phpdoc/en/functions/sybase.xml Sat Jul 7 14:42:40 2001 @@ -53,7 +53,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: true on success, false on error + Returns: &true; on success, &false; on error </para> <para> sybase_close() closes the link to a Sybase database that's associated with the specified link identifier. If the link @@ -89,7 +89,7 @@ </funcprototype> </funcsynopsis> <para> Returns: A positive Sybase link identifier on success, or - false on error. + &false; on error. </para> <para> sybase_connect() establishes a connection to a Sybase server. The servername argument has to be a valid servername that is defined @@ -123,7 +123,7 @@ <paramdef>int <parameter>row_number</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> Returns: true on success, false on failure + <para> Returns: &true; on success, &false; on failure </para> <para> sybase_data_seek() moves the internal row pointer of the Sybase result associated with the specified result identifier to @@ -149,7 +149,7 @@ </funcprototype> </funcsynopsis> <para> Returns: An array that corresponds to the fetched row, or - false if there are no more rows. + &false; if there are no more rows. </para> <para> sybase_fetch_array() is an extended version of @@ -236,7 +236,7 @@ </funcprototype> </funcsynopsis> <para> Returns: An object with properties that correspond to the - fetched row, or false if there are no more rows. + fetched row, or &false; if there are no more rows. </para> <para> sybase_fetch_object() is similar to <function>sybase_fetch_array</function>, with one difference - an @@ -269,7 +269,7 @@ </funcprototype> </funcsynopsis> <para> Returns: An array that corresponds to the fetched row, or - false if there are no more rows. + &false; if there are no more rows. </para> <para> sybase_fetch_row() fetches one row of data from the result @@ -279,7 +279,7 @@ </para> <para> Subsequent call to sybase_fetch_rows() would return the next row - in the result set, or false if there are no more rows. + in the result set, or &false; if there are no more rows. </para> <para> See also: <function>sybase_fetch_array</function>, @@ -532,7 +532,7 @@ </funcsynopsis> <para> Returns: A positive Sybase persistent link identifier on success, - or false on error</para> + or &false; on error</para> <para> sybase_pconnect() acts very much like <function>sybase_connect</function> with two major differences.</para> @@ -568,7 +568,7 @@ </funcprototype> </funcsynopsis> <para> Returns: A positive Sybase result identifier on success, or - false on error. + &false; on error. </para> <para> sybase_query() sends a query to the currently active database on the server that's associated with the specified link @@ -644,7 +644,7 @@ <paramdef>int <parameter>link_identifier</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> Returns: true on success, false on error + <para> Returns: &true; on success, &false; on error </para> <para> sybase_select_db() sets the current active database on the server that's associated with the specified link identifier. If Index: phpdoc/en/functions/uodbc.xml diff -u phpdoc/en/functions/uodbc.xml:1.20 phpdoc/en/functions/uodbc.xml:1.21 --- phpdoc/en/functions/uodbc.xml:1.20 Tue Jul 3 11:36:35 2001 +++ phpdoc/en/functions/uodbc.xml Sat Jul 7 14:42:40 2001 @@ -57,13 +57,13 @@ <para> Without the <parameter>OnOff</parameter> parameter, this function returns auto-commit status for - <parameter>connection_id</parameter>. True is returned if - auto-commit is on, false if it is off or an error occurs. + <parameter>connection_id</parameter>. &true; is returned if + auto-commit is on, &false; if it is off or an error occurs. </para> <para> - If <parameter>OnOff</parameter> is true, auto-commit is enabled, - if it is false auto-commit is disabled. Returns - <literal>true</literal> on success, <literal>false</literal> on + If <parameter>OnOff</parameter> is &true;, auto-commit is enabled, + if it is &false; auto-commit is disabled. Returns + &true; on success, &false; on failure. </para> <para> @@ -255,8 +255,8 @@ </funcprototype> </funcsynopsis> <para> - Returns: <literal>true</literal> on success, - <literal>false</literal> on failure. All pending transactions on + Returns: &true; on success, + &false; on failure. All pending transactions on <parameter>connection_id</parameter> are committed. </para> </refsect1> @@ -279,7 +279,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an ODBC connection id or 0 (<literal>false</literal>) on + Returns an ODBC connection id or 0 (&false;) on error. </para> <simpara> @@ -439,7 +439,7 @@ </funcprototype> </funcsynopsis> <para> - Returns <literal>false</literal> on error. Returns an ODBC + Returns &false; on error. Returns an ODBC result identifier if the SQL command was executed successfully. </para> <para> @@ -475,8 +475,8 @@ <para> Executes a statement prepared with <function>odbc_prepare</function>. Returns - <literal>true</literal> on successful execution, - <literal>false</literal> otherwise. The array + &true; on successful execution, + &false; otherwise. The array <parameter>parameters_array</parameter> only needs to be given if you really have parameters in your statement. </para> @@ -500,7 +500,7 @@ </funcsynopsis> <para> Returns the number of columns in the result; - <literal>false</literal> on error. + &false; on error. <parameter>result_array</parameter> must be passed by reference, but it can be of any type since it will be converted to type array. The array will contain the column values starting at array @@ -578,8 +578,8 @@ </funcsynopsis> <para> If <function>odbc_fetch_row</function> was succesful (there was a - row), <literal>true</literal> is returned. If there are no more - rows, <literal>false</literal> is returned. + row), &true; is returned. If there are no more + rows, &false; is returned. </para> <para> <function>odbc_fetch_row</function> fetches a row of the data @@ -625,7 +625,7 @@ <function>odbc_field_name</function> will return the name of the field occupying the given column number in the given ODBC result identifier. Field numbering starts at 1. - <literal>false</literal> is returned on error. + &false; is returned on error. </para> </refsect1> </refentry> @@ -648,7 +648,7 @@ <function>odbc_field_num</function> will return the number of the column slot that corresponds to the named field in the given ODBC result identifier. Field numbering starts at 1. - <literal>false</literal> is returned on error. + &false; is returned on error. </para> </refsect1> </refentry> @@ -763,7 +763,7 @@ </funcprototype> </funcsynopsis> <para> - Always returns <literal>true</literal>. + Always returns &true;. </para> <para> <function>odbc_free_result</function> only needs to be called if @@ -855,7 +855,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an ODBC connection id or 0 (<literal>false</literal>) on + Returns an ODBC connection id or 0 (&false;) on error. This function is much like <function>odbc_connect</function>, except that the connection is not really closed when the script has finished. Future requests @@ -896,7 +896,7 @@ </funcprototype> </funcsynopsis> <para> - Returns <literal>false</literal> on error. + Returns &false; on error. </para> <para> Returns an ODBC result identifier if the SQL command was prepared @@ -1011,7 +1011,7 @@ </funcsynopsis> <para> Returns the number of rows in the result or - <literal>false</literal> on error. + &false; on error. </para> <para> <function>odbc_result_all</function> will print all rows from a @@ -1039,7 +1039,7 @@ <para> Rolls back all pending statements on <parameter>connection_id</parameter>. Returns - <literal>true</literal> on success, <literal>false</literal> on + &true; on success, &false; on failure. </para> </refsect1> @@ -1049,8 +1049,8 @@ <refnamediv> <refname>odbc_setoption</refname> <refpurpose> - Adjust ODBC settings. Returns false if an error occurs, otherwise - true. + Adjust ODBC settings. Returns &false; if an error occurs, otherwise + &true;. </refpurpose> </refnamediv> <refsect1> @@ -1106,7 +1106,7 @@ // 1. Option 102 of SQLSetConnectOption() is SQL_AUTOCOMMIT. // Value 1 of SQL_AUTOCOMMIT is SQL_AUTOCOMMIT_ON. // This example has the same effect as -// odbc_autocommit($conn, true); +// odbc_autocommit($conn, &true;); odbc_setoption ($conn, 1, 102, 1); @@ -1145,7 +1145,7 @@ </funcsynopsis> <para> Lists all tables in the requested range. Returns an ODBC result - identifier or <literal>false</literal> on failure. + identifier or &false; on failure. </para> <para> The result set has the following columns: @@ -1180,7 +1180,7 @@ <parameter>name</parameter> are empty strings, then the result set contains a list of valid qualifiers for the data source. (All columns except the TABLE_QUALIFIER column contain - NULLs.) + &null;s.) </simpara> </listitem> <listitem> @@ -1190,7 +1190,7 @@ <parameter>name</parameter> are empty strings, then the result set contains a list of valid owners for the data source. (All columns except the TABLE_OWNER column contain - NULLs.) + &null;s.) </simpara> </listitem> <listitem> @@ -1200,7 +1200,7 @@ <parameter>owner</parameter> and <parameter>name</parameter> are empty strings, then the result set contains a list of valid table types for the data source. (All columns except the - TABLE_TYPE column contain NULLs.) + TABLE_TYPE column contain &null;s.) </simpara> </listitem> </itemizedlist> @@ -1242,7 +1242,7 @@ <para> Lists tables in the requested range and the privileges associated with each table. Returns an ODBC result identifier or - <literal>false</literal> on failure. + &false; on failure. </para> <para> The result set has the following columns: @@ -1290,7 +1290,7 @@ </funcsynopsis> <para> Lists all columns in the requested range. Returns an ODBC result - identifier or <literal>false</literal> on failure. + identifier or &false; on failure. </para> <para> The result set has the following columns: @@ -1305,7 +1305,7 @@ <listitem><simpara>LENGTH</simpara></listitem> <listitem><simpara>SCALE</simpara></listitem> <listitem><simpara>RADIX</simpara></listitem> - <listitem><simpara>NULLABLE</simpara></listitem> + <listitem><simpara>&null;ABLE</simpara></listitem> <listitem><simpara>REMARKS</simpara></listitem> </itemizedlist> </para> @@ -1349,7 +1349,7 @@ </funcsynopsis> <para> Lists columns and associated privileges for the given table. - Returns an ODBC result identifier or <literal>false</literal> on + Returns an ODBC result identifier or &false; on failure. </para> <para> @@ -1396,7 +1396,7 @@ <para> Retrieves information about data types supported by the data source. Returns an ODBC result identifier or - <literal>false</literal> on failure. The optional argument + &false; on failure. The optional argument <parameter>data_type</parameter> can be used to restrict the information to a single data type. </para> @@ -1409,7 +1409,7 @@ <listitem><simpara>LITERAL_PREFIX</simpara></listitem> <listitem><simpara>LITERAL_SUFFIX</simpara></listitem> <listitem><simpara>CREATE_PARAMS</simpara></listitem> - <listitem><simpara>NULLABLE</simpara></listitem> + <listitem><simpara>&null;ABLE</simpara></listitem> <listitem><simpara>CASE_SENSITIVE</simpara></listitem> <listitem><simpara>SEARCHABLE</simpara></listitem> <listitem><simpara>UNSIGNED_ATTRIBUTE</simpara></listitem> @@ -1447,7 +1447,7 @@ <para> Returns the column names that comprise the primary key for a table. Returns an ODBC result identifier or - <literal>false</literal> on failure. + &false; on failure. </para> <para> The result set has the following columns: @@ -1489,7 +1489,7 @@ <para> <function>odbc_foreignkeys</function> retrieves information about foreign keys. Returns an ODBC result identifier or - <literal>false</literal> on failure. + &false; on failure. </para> <para> The result set has the following columns: @@ -1553,7 +1553,7 @@ </funcsynopsis> <para> Lists all procedures in the requested range. Returns an ODBC - result identifier or <literal>false</literal> on failure. + result identifier or &false; on failure. </para> <para> The result set has the following columns: @@ -1598,7 +1598,7 @@ <para> Returns the list of input and output parameters, as well as the columns that make up the result set for the specified procedures. Returns - an ODBC result identifier or <literal>false</literal> on failure. + an ODBC result identifier or &false; on failure. </para> <para> The result set has the following columns: @@ -1614,7 +1614,7 @@ <listitem><simpara>LENGTH</simpara></listitem> <listitem><simpara>SCALE</simpara></listitem> <listitem><simpara>RADIX</simpara></listitem> - <listitem><simpara>NULLABLE</simpara></listitem> + <listitem><simpara>&null;ABLE</simpara></listitem> <listitem><simpara>REMARKS</simpara></listitem> </itemizedlist> </para> @@ -1650,7 +1650,7 @@ <paramdef>string <parameter>owner</parameter></paramdef> <paramdef>string <parameter>table</parameter></paramdef> <paramdef>int <parameter>scope</parameter></paramdef> - <paramdef>int <parameter>nullable</parameter></paramdef> + <paramdef>int <parameter>&null;able</parameter></paramdef> </funcprototype> </funcsynopsis> <simpara> @@ -1666,7 +1666,7 @@ uniquely identified. </simpara> <simpara> - Returns an ODBC result identifier or <literal>false</literal> on + Returns an ODBC result identifier or &false; on failure. </simpara> <para> @@ -1708,7 +1708,7 @@ </funcsynopsis> <para> Get statistics about a table and it's indexes. Returns an ODBC - result identifier or <literal>false</literal> on failure. + result identifier or &false; on failure. </para> <para> The result set has the following columns: Index: phpdoc/en/functions/var.xml diff -u phpdoc/en/functions/var.xml:1.58 phpdoc/en/functions/var.xml:1.59 --- phpdoc/en/functions/var.xml:1.58 Wed Jun 27 08:04:49 2001 +++ phpdoc/en/functions/var.xml Sat Jul 7 14:42:41 2001 @@ -65,18 +65,18 @@ to boolean</link> for more information. </para> - <!-- Returns false if <parameter>var</parameter> is set and has a - non-empty or non-zero value; true otherwise. --> + <!-- Returns &false; if <parameter>var</parameter> is set and has a + non-empty or non-zero value; &true; otherwise. --> <informalexample> <programlisting role="php"> $var = 0; -if (empty($var)) { // evaluates true +if (empty($var)) { // evaluates &true; echo '$var is either 0 or not set at all'; } -if (!isset($var)) { // evaluates false +if (!isset($var)) { // evaluates &false; echo '$var is not set at all'; } </programlisting> @@ -86,7 +86,7 @@ Note that this is meaningless when used on anything which isn't a variable; i.e. <command>empty (addslashes ($name))</command> has no meaning since it would be checking whether something which - isn't a variable is a variable with a false value. + isn't a variable is a variable with a &false; value. <!-- will even result in parse error (at least in PHP 4) --> </simpara> <simpara> @@ -149,7 +149,7 @@ <simpara>"<type>resource</type>" (since PHP 4)</simpara> </listitem> <listitem> - <simpara>"<type>NULL</type>" (since PHP 4)</simpara> + <simpara>"<type>null</type>" (since PHP 4)</simpara> </listitem> <listitem> <simpara>"user function" (PHP 3 only, deprecated)</simpara> @@ -324,7 +324,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true if <parameter>var</parameter> is an <type>array</type>, false + Returns &true; if <parameter>var</parameter> is an <type>array</type>, &false; otherwise. </para> <para> @@ -360,7 +360,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the <parameter>var</parameter> parameter is + Returns &true; if the <parameter>var</parameter> parameter is a <type>boolean</type>. </para> <para> @@ -391,8 +391,8 @@ </funcprototype> </funcsynopsis> <para> - Returns true if <parameter>var</parameter> is a <type>double</type>, - false otherwise. + Returns &true; if <parameter>var</parameter> is a <type>double</type>, + &false; otherwise. </para> <para> See also <function>is_array</function>, @@ -513,9 +513,9 @@ </funcprototype> </funcsynopsis> <para> - Returns true if <parameter>var</parameter> is an <type>integer</type> + Returns &true; if <parameter>var</parameter> is an <type>integer</type> (long), - false otherwise. + &false; otherwise. </para> <para> See also <function>is_bool</function>, @@ -535,7 +535,7 @@ <refnamediv> <refname>is_null</refname> <refpurpose> - Finds whether a variable is null + Finds whether a variable is &null; </refpurpose> </refnamediv> <refsect1> @@ -547,8 +547,8 @@ </funcprototype> </funcsynopsis> <para> - Returns true if <parameter>var</parameter> is <type>null</type>, - false otherwise. + Returns &true; if <parameter>var</parameter> is <type>null</type>, + &false; otherwise. </para> <para> See also <function>is_bool</function>, @@ -582,8 +582,8 @@ </funcprototype> </funcsynopsis> <para> - Returns true if <parameter>var</parameter> is a number or a - numeric string, false otherwise. + Returns &true; if <parameter>var</parameter> is a number or a + numeric string, &false; otherwise. </para> <para> See also <function>is_bool</function>, @@ -613,8 +613,8 @@ </funcprototype> </funcsynopsis> <para> - Returns true if <parameter>var</parameter> is an <type>object</type>, - false otherwise. + Returns &true; if <parameter>var</parameter> is an <type>object</type>, + &false; otherwise. </para> <para> See also <function>is_bool</function>, @@ -680,9 +680,9 @@ </funcprototype> </funcsynopsis> <para> - <function>is_resource</function> returns true if the variable + <function>is_resource</function> returns &true; if the variable given by the <parameter>var</parameter> parameter is a - <type>resource</type>, otherwise it returns false. + <type>resource</type>, otherwise it returns &false;. </para> <para> See the documentation on the <type>resource</type>-type for @@ -711,9 +711,9 @@ </funcprototype> </funcsynopsis> <para> - <function>is_scalar</function> returns true if the variable + <function>is_scalar</function> returns &true; if the variable given by the <parameter>var</parameter> parameter is a scalar, - otherwise it returns false. + otherwise it returns &false;. </para> <para> Scalar variables are those containing an <type>integer</type>, @@ -793,8 +793,8 @@ </funcprototype> </funcsynopsis> <para> - Returns true if <parameter>var</parameter> is a <type>string</type>, - false otherwise. + Returns &true; if <parameter>var</parameter> is a <type>string</type>, + &false; otherwise. </para> <para> See also <function>is_bool</function>, @@ -824,25 +824,25 @@ </funcprototype> </funcsynopsis> <simpara> - Returns <literal>true</literal> if <parameter>var</parameter> - exists; <literal>false</literal> otherwise. + Returns &true; if <parameter>var</parameter> + exists; &false; otherwise. </simpara> <para> If a variable has been unset with <function>unset</function>, it will no longer be <function>isset</function>. <function>isset</function> - will return <literal>false</literal> if testing a variable that has been - set to <literal>NULL</literal>. Also note that a null byte (<literal>"\0"</literal>) - is not equivalent to the PHP <literal>NULL</literal> constant. + will return &false; if testing a variable that has been + set to &null;. Also note that a &null; byte (<literal>"\0"</literal>) + is not equivalent to the PHP &null; constant. <informalexample> <programlisting role="php"> $a = "test"; -echo isset ($a); // TRUE +echo isset ($a); // &true; unset ($a); -echo isset ($a); // FALSE +echo isset ($a); // &false; -$foo = NULL; -print isset ($foo); // FALSE +$foo = &null;; +print isset ($foo); // &false; </programlisting> </informalexample> </para> @@ -903,7 +903,7 @@ that contains a direct or indirect reference to itself or that contains an <type>array</type> or <type>object</type> on a deeper level that does so. - This is especially true for <literal>print_r($GLOBALS)</literal>, + This is especially &true; for <literal>print_r($GLOBALS)</literal>, as <literal>$GLOBALS</literal> is itself a global variable and contains a reference to itself as such. </para> @@ -1023,15 +1023,15 @@ </itemizedlist> </para> <para> - Returns <literal>TRUE</literal> if successful; otherwise returns - <literal>FALSE</literal>. + Returns &true; if successful; otherwise returns + &false;. </para> <para> <example> <title><function>settype</function> example</title> <programlisting role="php"> $foo = "5bar"; // string -$bar = true; // boolean +$bar = &true;; // boolean settype($foo, "integer"); // $foo is now 5 (integer) settype($bar, "string"); // $bar is now "1" (string) @@ -1159,9 +1159,9 @@ </funcsynopsis> <para> <function>unset</function> destroys the specified variables. Note - that in PHP 3, <function>unset</function> will always return true + that in PHP 3, <function>unset</function> will always return &true; (actually, the integer value 1). In PHP 4, however, - <function>unset</function> is no longer a true function: it is + <function>unset</function> is no longer a &true; function: it is now a statement. As such no value is returned, and attempting to take the value of <function>unset</function> results in a parse error. @@ -1343,12 +1343,12 @@ */ -$b = 3.1; $c = TRUE; +$b = 3.1; $c = &true;; var_dump($b,$c); /* output: float(3.1) -bool(true) +bool(&true;) */ ?> Index: phpdoc/en/functions/xml.xml diff -u phpdoc/en/functions/xml.xml:1.14 phpdoc/en/functions/xml.xml:1.15 --- phpdoc/en/functions/xml.xml:1.14 Wed Jan 3 15:20:36 2001 +++ phpdoc/en/functions/xml.xml Sat Jul 7 14:42:41 2001 @@ -345,7 +345,7 @@ $xml_parser = xml_parser_create(); // use case-folding so we are sure to find the tag in $map_array -xml_parser_set_option($xml_parser, XML_OPTION_CASE_FOLDING, true); +xml_parser_set_option($xml_parser, XML_OPTION_CASE_FOLDING, &true;); xml_set_element_handler($xml_parser, "startElement", "endElement"); xml_set_character_data_handler($xml_parser, "characterData"); if (!($fp = fopen($file, "r"))) { @@ -389,9 +389,9 @@ // only trust local files owned by ourselves if (!eregi("^([a-z]+)://", $file) && fileowner($file) == getmyuid()) { - return true; + return &true;; } - return false; + return &false;; } function startElement($parser, $name, $attribs) { @@ -446,7 +446,7 @@ if (!list($parser, $fp) = new_xml_parser($systemId)) { printf("Could not open entity %s at %s\n", $openEntityNames, $systemId); - return false; + return &false;; } while ($data = fread($fp, 4096)) { if (!xml_parse($parser, $data, feof($fp))) { @@ -454,13 +454,13 @@ xml_error_string(xml_get_error_code($parser)), xml_get_current_line_number($parser), $openEntityNames); xml_parser_free($parser); - return false; + return &false;; } } xml_parser_free($parser); - return true; + return &true;; } - return false; + return &false;; } @@ -476,7 +476,7 @@ xml_set_external_entity_ref_handler($xml_parser, "externalEntityRefHandler"); if (!($fp = @fopen($file, "r"))) { - return false; + return &false;; } if (!is_array($parser_file)) { settype($parser_file, "array"); @@ -593,7 +593,7 @@ </varlistentry> </variablelist> This function creates an XML parser and returns a handle for use - by other XML functions. Returns <literal>false</literal> on + by other XML functions. Returns &false; on failure. </para> </refsect1> @@ -779,10 +779,10 @@ </para> <para> If a handler function is set to an empty string, or - <literal>false</literal>, the handler in question is disabled. + &false;, the handler in question is disabled. </para> <para> - True is returned if the handlers are set up, false if + &true; is returned if the handlers are set up, &false; if <parameter>parser</parameter> is not a parser. </para> <para> @@ -847,11 +847,11 @@ </variablelist></para> <para> If a handler function is set to an empty string, or - <literal>false</literal>, the handler in question is + &false;, the handler in question is disabled. </para> <para> - True is returned if the handler is set up, false if + &true; is returned if the handler is set up, &false; if <parameter>parser</parameter> is not a parser. </para> <para> @@ -935,10 +935,10 @@ </variablelist></para> <para> If a handler function is set to an empty string, or - <literal>false</literal>, the handler in question is disabled. + &false;, the handler in question is disabled. </para> <para> - True is returned if the handler is set up, false if + &true; is returned if the handler is set up, &false; if <parameter>parser</parameter> is not a parser. </para> <para> @@ -1011,10 +1011,10 @@ </para> <para> If a handler function is set to an empty string, or - <literal>false</literal>, the handler in question is disabled. + &false;, the handler in question is disabled. </para> <para> - True is returned if the handler is set up, false if + &true; is returned if the handler is set up, &false; if <parameter>parser</parameter> is not a parser. </para> <para> @@ -1133,10 +1133,10 @@ </variablelist></para> <para> If a handler function is set to an empty string, or - <literal>false</literal>, the handler in question is disabled. + &false;, the handler in question is disabled. </para> <para> - True is returned if the handler is set up, false if + &true; is returned if the handler is set up, &false; if <parameter>parser</parameter> is not a parser. </para> <para> @@ -1250,11 +1250,11 @@ </para> <para> If a handler function is set to an empty string, or - <literal>false</literal>, the handler in question is + &false;, the handler in question is disabled. </para> <para> - True is returned if the handler is set up, false if + &true; is returned if the handler is set up, &false; if <parameter>parser</parameter> is not a parser. </para> <para> @@ -1291,7 +1291,7 @@ <para> The function named by <parameter>handler</parameter> must accept five parameters, and should return an integer value. If the - value returned from the handler is false (which it will be if no + value returned from the handler is &false; (which it will be if no value is returned), the XML parser will stop parsing and <function>xml_get_error_code</function> will return <systemitem class="constant">XML_ERROR_EXTERNAL_ENTITY_HANDLING</systemitem>. @@ -1364,11 +1364,11 @@ </para> <para> If a handler function is set to an empty string, or - <literal>false</literal>, the handler in question is + &false;, the handler in question is disabled. </para> <para> - True is returned if the handler is set up, false if + &true; is returned if the handler is set up, &false; if <parameter>parser</parameter> is not a parser. </para> <para> @@ -1413,7 +1413,7 @@ Chunk of data to parse. A document may be parsed piece-wise by calling <function>xml_parse</function> several times with new data, as long as the <parameter>isFinal</parameter> - parameter is set and true when the last data is parsed. + parameter is set and &true; when the last data is parsed. </simpara> </listitem> </varlistentry> @@ -1421,7 +1421,7 @@ <term><parameter>isFinal</parameter> (optional)</term> <listitem> <simpara> - If set and true, <parameter>data</parameter> is the last + If set and &true;, <parameter>data</parameter> is the last piece of data sent in this parse. </simpara> </listitem> @@ -1431,10 +1431,10 @@ <para> When the XML document is parsed, the handlers for the configured events are called as many times as necessary, after which this - function returns true or false. + function returns &true; or &false;. </para> <para> - True is returned if the parse was successful, false if it was not + &true; is returned if the parse was successful, &false; if it was not successful, or if <parameter>parser</parameter> does not refer to a valid parser. For unsuccessful parses, error information can be retrieved with <function>xml_get_error_code</function>, @@ -1472,7 +1472,7 @@ </variablelist> </para> <para> - This function returns false if <parameter>parser</parameter> does + This function returns &false; if <parameter>parser</parameter> does not refer to a valid parser, or else it returns one of the error codes listed in the <link linkend="xml.error-codes">error codes section</link>. @@ -1507,7 +1507,7 @@ </para> <para> Returns a string with a textual description of the error code - <parameter>code</parameter>, or false if no description was found. + <parameter>code</parameter>, or &false; if no description was found. </para> </refsect1> </refentry> @@ -1540,7 +1540,7 @@ </variablelist> </para> <para> - This function returns false if <parameter>parser</parameter> does + This function returns &false; if <parameter>parser</parameter> does not refer to a valid parser, or else it returns which line the parser is currently at in its data buffer. </para> @@ -1577,7 +1577,7 @@ </variablelist> </para> <para> - This function returns false if <parameter>parser</parameter> does + This function returns &false; if <parameter>parser</parameter> does not refer to a valid parser, or else it returns which column on the current line (as given by <function>xml_get_current_line_number</function>) the parser is @@ -1614,7 +1614,7 @@ </variablelist> </para> <para> - This function returns false if <parameter>parser</parameter> does + This function returns &false; if <parameter>parser</parameter> does not refer to a valid parser, or else it returns which byte index the parser is currently at in its data buffer (starting at 0). </para> @@ -1860,9 +1860,9 @@ </varlistentry> </variablelist></para> <para> - This function returns false if <parameter>parser</parameter> does + This function returns &false; if <parameter>parser</parameter> does not refer to a valid parser, or else it frees the parser and - returns true. + returns &true;. </para> </refsect1> </refentry> @@ -1911,9 +1911,9 @@ </variablelist> </para> <para> - This function returns false if <parameter>parser</parameter> does + This function returns &false; if <parameter>parser</parameter> does not refer to a valid parser, or if the option could not be set. - Else the option is set and true is returned. + Else the option is set and &true; is returned. </para> <para> The following options are available: @@ -1996,7 +1996,7 @@ </variablelist> </para> <para> - This function returns false if <parameter>parser</parameter> does + This function returns &false; if <parameter>parser</parameter> does not refer to a valid parser, or if the option could not be set. Else the option's value is returned. </para> Index: phpdoc/en/functions/xslt.xml diff -u phpdoc/en/functions/xslt.xml:1.16 phpdoc/en/functions/xslt.xml:1.17 --- phpdoc/en/functions/xslt.xml:1.16 Sun Jun 24 11:27:21 2001 +++ phpdoc/en/functions/xslt.xml Sat Jul 7 14:42:41 2001 @@ -78,9 +78,9 @@ </varlistentry> </variablelist></para> <para> - This function returns false if <parameter>parser</parameter> does + This function returns &false; if <parameter>parser</parameter> does not refer to a valid parser, or if the closing of the logfile - fails. Otherwise it returns true. + fails. Otherwise it returns &true;. </para> </refsect1> </refentry> @@ -326,7 +326,7 @@ The <function>xslt_process</function> takes a string containing the XSLT stylesheet as its first argument, it takes a second string containing the XML data you want to transform and then a third string containing the results of the transformation. - <function>xslt_process</function> will return true on success and false on failure, + <function>xslt_process</function> will return &true; on success and &false; on failure, to get the error number and error string if an error occurs use the <function>xslt_errno</function> and <function>xslt_error</function> functions. </para> Index: phpdoc/en/functions/yaz.xml diff -u phpdoc/en/functions/yaz.xml:1.12 phpdoc/en/functions/yaz.xml:1.13 --- phpdoc/en/functions/yaz.xml:1.12 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/yaz.xml Sat Jul 7 14:42:42 2001 @@ -294,7 +294,7 @@ <literal>B</literal> (brief). </para> <para> - Returns true on success; false on error. + Returns &true; on success; &false; on error. </para> </refsect1> </refentry> @@ -326,7 +326,7 @@ a session. </para> <para> - Returns true on success; false on error. + Returns &true; on success; &false; on error. </para> </refsect1> </refentry> @@ -357,7 +357,7 @@ set to 10. </para> <para> - Returns true on success; false on error. + Returns &true; on success; &false; on error. </para> </refsect1> </refentry> @@ -729,11 +729,11 @@ To define a set of valid CCL fields call <function>yaz_ccl_conf</function> prior to this function. If the supplied <parameter>query</parameter> was successfully - converted to RPN, this function returns true, and the index + converted to RPN, this function returns &true;, and the index <literal>rpn</literal> of the supplied array <parameter>result</parameter> holds a valid RPN query. If the query could not be converted (because of invalid syntax, - unknown field, etc.) this function returns false and three + unknown field, etc.) this function returns &false; and three indexes are set in the resulting array to indicate the cause of failure: <literal>errorcode</literal>CCL error code (integer), <literal>errorstring</literal>CCL error string, and Index: phpdoc/en/functions/zip.xml diff -u phpdoc/en/functions/zip.xml:1.5 phpdoc/en/functions/zip.xml:1.6 --- phpdoc/en/functions/zip.xml:1.5 Tue Jun 26 21:55:15 2001 +++ phpdoc/en/functions/zip.xml Sat Jul 7 14:42:42 2001 @@ -267,7 +267,7 @@ </para> </note> <para> - Returns <literal>true</literal> on succes or <literal>false</literal> on failure. + Returns &true; on succes or &false; on failure. </para> <note> <para> @@ -313,7 +313,7 @@ </para> </note> <para> - Returns the data read, or <literal>false</literal> if the end of + Returns the data read, or &false; if the end of the file is reached. </para> <para> @@ -346,7 +346,7 @@ Returns a resource handle for later use with <function>zip_read</function> and <function>zip_close</function> or returns - <literal>false</literal> if <parameter>filename</parameter> does + &false; if <parameter>filename</parameter> does not exist. </para> <para> Index: phpdoc/en/functions/zlib.xml diff -u phpdoc/en/functions/zlib.xml:1.14 phpdoc/en/functions/zlib.xml:1.15 --- phpdoc/en/functions/zlib.xml:1.14 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/zlib.xml Sat Jul 7 14:42:42 2001 @@ -95,7 +95,7 @@ The gz-file pointed to by zp is closed. </para> <para> - Returns true on success and false on failure. + Returns &true; on success and &false; on failure. </para> <para> The gz-file pointer must be valid, and must point to a file @@ -118,8 +118,8 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the gz-file pointer is at EOF or an error occurs; - otherwise returns false. + Returns &true; if the gz-file pointer is at EOF or an error occurs; + otherwise returns &false;. </para> <para> The gz-file pointer must be valid, and must point to a file @@ -175,7 +175,7 @@ </funcsynopsis> <para> Returns a string containing a single (uncompressed) character - read from the file pointed to by zp. Returns FALSE on EOF (as + read from the file pointed to by zp. Returns &false; on EOF (as does <function>gzeof</function>). </para> <para> @@ -210,7 +210,7 @@ first). </para> <para> - If an error occurs, returns false. + If an error occurs, returns &false;. </para> <para> The file pointer must be valid, and must point to a file @@ -301,7 +301,7 @@ compressed. </para> <para> - If the open fails, the function returns false. + If the open fails, the function returns &false;. </para> <para> You can use the optional third parameter and set it to "1", if @@ -342,7 +342,7 @@ (uncompressed) results to standard output. </para> <para> - If an error occurs, returns false. + If an error occurs, returns &false;. </para> <para> The file pointer must be valid, and must point to a file @@ -505,7 +505,7 @@ stream. </para> <para> - If an error occurs, returns false. + If an error occurs, returns &false;. </para> <para> The file pointer must be valid, and must point to a file @@ -586,7 +586,7 @@ </para> <para> Returns the number of (uncompressed) bytes read from the file. If - an error occurs, false is returned and unless the function was + an error occurs, &false; is returned and unless the function was called as <literal>@readgzfile</literal>, an error message is printed. </para> @@ -625,7 +625,7 @@ <para> This function returns a compressed version of the input <parameter>data</parameter> using the ZLIB data format, - or false if an error is encountered. The optional parameter + or &false; if an error is encountered. The optional parameter <parameter>level</parameter> can be given as 0 for no compression up to 9 for maximum compression. </para> @@ -669,7 +669,7 @@ <para> This function takes <parameter>data</parameter> compressed by <function>gzcompress</function> and returns the original - uncompressed data or false on error. The function will return an + uncompressed data or &false; on error. The function will return an error if the uncompressed data is more than 256 times the length of the compressed input <parameter>data</parameter> or more than the optional parameter <parameter>length</parameter>. @@ -702,7 +702,7 @@ <para> This function returns a compressed version of the input <parameter>data</parameter> using the DEFLATE data format, - or false if an error is encountered. The optional parameter + or &false; if an error is encountered. The optional parameter <parameter>level</parameter> can be given as 0 for no compression up to 9 for maximum compression. </para> @@ -740,7 +740,7 @@ <para> This function takes <parameter>data</parameter> compressed by <function>gzdeflate</function> and returns the original - uncompressed data or false on error. The function will return an + uncompressed data or &false; on error. The function will return an error if the uncompressed data is more than 256 times the length of the compressed input <parameter>data</parameter> or more than the optional parameter <parameter>length</parameter>. @@ -774,7 +774,7 @@ This function returns a compressed version of the input <parameter>data</parameter> compatible with the output of the <command>gzip</command> program, - or false if an error is encountered. The optional parameter + or &false; if an error is encountered. The optional parameter <parameter>level</parameter> can be given as 0 for no compression up to 9 for maximum compression, if not given the default compression level will be 1. Index: phpdoc/en/language/basic-syntax.xml diff -u phpdoc/en/language/basic-syntax.xml:1.7 phpdoc/en/language/basic-syntax.xml:1.8 --- phpdoc/en/language/basic-syntax.xml:1.7 Sat May 19 16:44:05 2001 +++ phpdoc/en/language/basic-syntax.xml Sat Jul 7 14:42:43 2001 @@ -30,7 +30,7 @@ TODO: - why is $foo[bar] bad syntax? - what's the difference between unset($bla) and - $bla = NULL (it is different!) + $bla = &null; (it is different!) - $obj->{expr} syntax - (unset) cast????? - $bla = unset <== should've been nuked, don't mention it @@ -116,13 +116,13 @@ if ( boolean-expression ) { ?> -<strong>This is true.</strong> +<strong>This is &true;.</strong> <?php } else { ?> -<strong>This is false.</strong> +<strong>This is &false;.</strong> <?php } </programlisting></example> Index: phpdoc/en/language/constants.xml diff -u phpdoc/en/language/constants.xml:1.11 phpdoc/en/language/constants.xml:1.12 --- phpdoc/en/language/constants.xml:1.11 Fri Jun 22 18:06:55 2001 +++ phpdoc/en/language/constants.xml Sat Jul 7 14:42:43 2001 @@ -52,7 +52,7 @@ <note> <simpara> Constants and (global) variables are in a different namespace. - This implies that for example <constant>TRUE</constant> and + This implies that for example &true; and <varname>$TRUE</varname> are generally different. </simpara> </note> @@ -160,28 +160,28 @@ </varlistentry> <varlistentry> - <term>TRUE (case-insensitive)</term> + <term>&true; (case-insensitive)</term> <listitem> <simpara> - A true value (see the <type>boolean</type> type). + A &true; value (see the <type>boolean</type> type). </simpara> </listitem> </varlistentry> <varlistentry> - <term>FALSE (case-insensitive)</term> + <term>&false; (case-insensitive)</term> <listitem> <simpara> - A false value (see the <type>boolean</type> type). + A &false; value (see the <type>boolean</type> type). </simpara> </listitem> </varlistentry> <varlistentry> - <term>NULL (case-insensitive)</term> + <term>&null; (case-insensitive)</term> <listitem> <simpara> - A null value (see the <type>null</type> type). + A &null; value (see the <type>null</type> type). </simpara> </listitem> </varlistentry> Index: phpdoc/en/language/control-structures.xml diff -u phpdoc/en/language/control-structures.xml:1.31 phpdoc/en/language/control-structures.xml:1.32 --- phpdoc/en/language/control-structures.xml:1.31 Sun Jul 1 23:03:43 2001 +++ phpdoc/en/language/control-structures.xml Sat Jul 7 14:42:44 2001 @@ -29,8 +29,8 @@ <simpara> As described in the section about expressions, expr is evaluated to its truth value. If <replaceable>expr</replaceable> evaluates - to <literal>TRUE</literal>, PHP will execute statement, and if it - evaluates to <literal>FALSE</literal> - it'll ignore it. + to &true;, PHP will execute statement, and if it + evaluates to &false; - it'll ignore it. </simpara> <para> The following example would display <computeroutput>a is bigger @@ -77,7 +77,7 @@ is what <literal>else</literal> is for. <literal>else</literal> extends an <literal>if</literal> statement to execute a statement in case the expression in the <literal>if</literal> statement - evaluates to <literal>FALSE</literal>. For example, the following + evaluates to &false;. For example, the following code would display <computeroutput>a is bigger than b</computeroutput> if <replaceable>$a</replaceable> is bigger than <replaceable>$b</replaceable>, and <computeroutput>a is NOT bigger @@ -94,9 +94,9 @@ The <literal>else</literal> statement is only executed if the <literal>if</literal> expression evaluated to - <literal>FALSE</literal>, and if there were any + &false;, and if there were any <literal>elseif</literal> expressions - only if they evaluated to - <literal>FALSE</literal> as well (see <link + &false; as well (see <link linkend="control-structures.elseif">elseif</link>). </para> @@ -110,10 +110,10 @@ <literal>else</literal>, it extends an <literal>if</literal> statement to execute a different statement in case the original <literal>if</literal> expression evaluates to - <literal>FALSE</literal>. However, unlike + &false;. However, unlike <literal>else</literal>, it will execute that alternative expression only if the <literal>elseif</literal> conditional - expression evaluates to <literal>TRUE</literal>. For example, the + expression evaluates to &true;. For example, the following code would display <computeroutput>a is bigger than b</computeroutput>, <computeroutput>a equal to b</computeroutput> or <computeroutput>a is smaller than b</computeroutput>: @@ -133,7 +133,7 @@ There may be several <literal>elseif</literal>s within the same <literal>if</literal> statement. The first <literal>elseif</literal> expression (if any) that evaluates to - <literal>true</literal> would be executed. In PHP, you can also + &true; would be executed. In PHP, you can also write 'else if' (in two words) and the behavior would be identical to the one of 'elseif' (in a single word). The syntactic meaning is slightly different (if you're familiar with C, this is the same @@ -144,9 +144,9 @@ The <literal>elseif</literal> statement is only executed if the preceding <literal>if</literal> expression and any preceding <literal>elseif</literal> expressions evaluated to - <literal>FALSE</literal>, and the current + &false;, and the current <literal>elseif</literal> expression evaluated to - <literal>TRUE</literal>. + &true;. </simpara> </sect1> @@ -229,13 +229,13 @@ The meaning of a <literal>while</literal> statement is simple. It tells PHP to execute the nested statement(s) repeatedly, as long as the <literal>while</literal> expression evaluates to - <literal>TRUE</literal>. The value of the expression is checked + &true;. The value of the expression is checked each time at the beginning of the loop, so even if this value changes during the execution of the nested statement(s), execution will not stop until the end of the iteration (each time PHP runs the statements in the loop is one iteration). Sometimes, if the <literal>while</literal> expression evaluates to - <literal>FALSE</literal> from the very beginning, the nested + &false; from the very beginning, the nested statement(s) won't even be run once. </simpara> <para> @@ -287,7 +287,7 @@ of the iteration), whereas it's may not necessarily run with a regular <literal>while</literal> loop (the truth expression is checked at the beginning of each iteration, if it evaluates to - <literal>FALSE</literal> right from the beginning, the loop + &false; right from the beginning, the loop execution would end immediately). </simpara> <para> @@ -305,7 +305,7 @@ <simpara> The above loop would run one time exactly, since after the first iteration, when truth expression is checked, it evaluates to - <literal>FALSE</literal> ($i is not bigger than 0) and the loop + &false; ($i is not bigger than 0) and the loop execution ends. </simpara> <para> @@ -361,9 +361,9 @@ <simpara> In the beginning of each iteration, <replaceable>expr2</replaceable> is evaluated. If it evaluates to - <literal>TRUE</literal>, the loop continues and the nested + &true;, the loop continues and the nested statement(s) are executed. If it evaluates to - <literal>FALSE</literal>, the execution of the loop ends. + &false;, the execution of the loop ends. </simpara> <simpara> At the end of each iteration, <replaceable>expr3</replaceable> is @@ -373,7 +373,7 @@ Each of the expressions can be empty. <replaceable>expr2</replaceable> being empty means the loop should be run indefinitely (PHP implicitly considers it as - <literal>TRUE</literal>, like C). This may not be as useless as + &true;, like C). This may not be as useless as you might think, since often you'd want to end the loop using a conditional <link linkend="control-structures.break"><literal>break</literal></link> @@ -877,7 +877,7 @@ <pre> <?php // A function that records the time when it is called -function profile ($dump = FALSE) +function profile ($dump = &false;) { static $profile; @@ -905,7 +905,7 @@ } // Display the data stored in the profiler -print_r (profile (TRUE)); +print_r (profile (&true;)); ?> </pre> </programlisting> @@ -1094,7 +1094,7 @@ encountered, whether the contents of the file will be evaluated or not (for example, if it is inside an <link linkend="control-structures.if">if</link> statement whose - condition evaluated to false). + condition evaluated to &false;). </para> <para> Because <function>include</function> is a special language Index: phpdoc/en/language/expressions.xml diff -u phpdoc/en/language/expressions.xml:1.5 phpdoc/en/language/expressions.xml:1.6 --- phpdoc/en/language/expressions.xml:1.5 Fri May 11 02:34:06 2001 +++ phpdoc/en/language/expressions.xml Sat Jul 7 14:42:44 2001 @@ -89,7 +89,7 @@ <simpara> A very common type of expressions are comparison expressions. - These expressions evaluate to either 0 or 1, meaning FALSE or TRUE + These expressions evaluate to either 0 or 1, meaning &false; or &true; (respectively). PHP supports > (bigger than), >= (bigger than or equal to), == (equal), != (not equal), < (smaller than) and <= (smaller than or equal to). These expressions are most commonly used @@ -126,7 +126,7 @@ $first ? $second : $third </programlisting></informalexample> - If the value of the first subexpression is true (non-zero), then + If the value of the first subexpression is &true; (non-zero), then it the second subexpression is evaluated, and that is the result of the conditional expression. Otherwise, the third subexpression is evaluated, and that is the value.</para> @@ -171,12 +171,12 @@ One last thing worth mentioning is the truth value of expressions. In many events, mainly in conditional execution and loops, you're not interested in the specific value of the expression, but only - care about whether it means TRUE or FALSE. + care about whether it means &true; or &false;. <!-- (PHP doesn't have a dedicated boolean type) : WRONG, php does. --> - The constants TRUE and FALSE (case-insensitive) are the two + The constants &true; and &false; (case-insensitive) are the two possible boolean values. When necessary, an expression is autmatically converted to boolean. See the <link linkend="language.types.typecasting">section about Index: phpdoc/en/language/oop.xml diff -u phpdoc/en/language/oop.xml:1.15 phpdoc/en/language/oop.xml:1.16 --- phpdoc/en/language/oop.xml:1.15 Wed Jun 27 02:11:31 2001 +++ phpdoc/en/language/oop.xml Sat Jul 7 14:42:44 2001 @@ -24,9 +24,9 @@ function remove_item ($artnr, $num) { if ($this->items[$artnr] > $num) { $this->items[$artnr] -= $num; - return true; + return &true;; } else { - return false; + return &false;; } } } @@ -477,7 +477,7 @@ <para> You may find yourself writing code that refers to variables and functions in base classes. This is - particularly true if your derived class is a refinement + particularly &true; if your derived class is a refinement or specialisation of code in your base class. </para> Index: phpdoc/en/language/operators.xml diff -u phpdoc/en/language/operators.xml:1.21 phpdoc/en/language/operators.xml:1.22 --- phpdoc/en/language/operators.xml:1.21 Fri Jun 22 18:06:55 2001 +++ phpdoc/en/language/operators.xml Sat Jul 7 14:42:44 2001 @@ -187,48 +187,48 @@ <row> <entry>$a == $b</entry> <entry>Equal</entry> - <entry>True if $a is equal to $b.</entry> + <entry>&true; if $a is equal to $b.</entry> </row> <row> <entry>$a === $b</entry> <entry>Identical</entry> <entry> - True if $a is equal to $b, and they are of the same + &true; if $a is equal to $b, and they are of the same type. (PHP 4 only) </entry> </row> <row> <entry>$a != $b</entry> <entry>Not equal</entry> - <entry>True if $a is not equal to $b.</entry> + <entry>&true; if $a is not equal to $b.</entry> </row> <row> <entry>$a !== $b</entry> <entry>Not identical</entry> <entry> - True if $a is not equal to $b, or they are not of the same + &true; if $a is not equal to $b, or they are not of the same type. (PHP 4 only) </entry> </row> <row> <entry>$a < $b</entry> <entry>Less than</entry> - <entry>True if $a is strictly less than $b.</entry> + <entry>&true; if $a is strictly less than $b.</entry> </row> <row> <entry>$a > $b</entry> <entry>Greater than</entry> - <entry>True if $a is strictly greater than $b.</entry> + <entry>&true; if $a is strictly greater than $b.</entry> </row> <row> <entry>$a <= $b</entry> <entry>Less than or equal to </entry> - <entry>True if $a is less than or equal to $b.</entry> + <entry>&true; if $a is less than or equal to $b.</entry> </row> <row> <entry>$a >= $b</entry> <entry>Greater than or equal to </entry> - <entry>True if $a is greater than or equal to $b.</entry> + <entry>&true; if $a is greater than or equal to $b.</entry> </row> </tbody> </tgroup> @@ -242,9 +242,9 @@ </programlisting> </informalexample> This expression evaluates to <replaceable>expr2</replaceable> if - <replaceable>expr1</replaceable> evaluates to true, and + <replaceable>expr1</replaceable> evaluates to &true;, and <replaceable>expr3</replaceable> if - <replaceable>expr1</replaceable> evaluates to false. + <replaceable>expr1</replaceable> evaluates to &false;. </para> </sect1> @@ -420,32 +420,32 @@ <row> <entry>$a and $b</entry> <entry>And</entry> - <entry>True if both $a and $b are true.</entry> + <entry>&true; if both $a and $b are &true;.</entry> </row> <row> <entry>$a or $b</entry> <entry>Or</entry> - <entry>True if either $a or $b is true.</entry> + <entry>&true; if either $a or $b is &true;.</entry> </row> <row> <entry>$a xor $b</entry> <entry>Xor</entry> - <entry>True if either $a or $b is true, but not both.</entry> + <entry>&true; if either $a or $b is &true;, but not both.</entry> </row> <row> <entry>! $a</entry> <entry>Not</entry> - <entry>True if $a is not true.</entry> + <entry>&true; if $a is not &true;.</entry> </row> <row> <entry>$a && $b</entry> <entry>And</entry> - <entry>True if both $a and $b are true.</entry> + <entry>&true; if both $a and $b are &true;.</entry> </row> <row> <entry>$a || $b</entry> <entry>Or</entry> - <entry>True if either $a or $b is true.</entry> + <entry>&true; if either $a or $b is &true;.</entry> </row> </tbody> </tgroup> Index: phpdoc/en/language/types.xml diff -u phpdoc/en/language/types.xml:1.33 phpdoc/en/language/types.xml:1.34 --- phpdoc/en/language/types.xml:1.33 Sat Jun 30 15:23:22 2001 +++ phpdoc/en/language/types.xml Sat Jul 7 14:42:45 2001 @@ -70,7 +70,7 @@ <listitem> <simpara> - <link linkend="language.types.null">null</link> + <link linkend="language.types.null">&null;</link> </simpara> </listitem> @@ -123,8 +123,8 @@ <simpara> This is the easiest type. A <type>boolean</type> expresses a - truth value. It can be either true or - false. + truth value. It can be either &true; or + &false;. </simpara> <note> @@ -136,12 +136,12 @@ <sect2 id="language.types.boolean.syntax"> <title>Syntax</title> <para> - To specify a boolean-literal, use either the keyword <constant>TRUE</constant> - or <constant>FALSE</constant>. Both are case-insensitive. + To specify a boolean-literal, use either the keyword &true; + or &false;. Both are case-insensitive. <!-- technically they are just constants --> <informalexample> <programlisting role="php"> -$foo = True; // assign the value TRUE to $foo +$foo = &true;; // assign the value &true; to $foo </programlisting> </informalexample> </para> @@ -159,7 +159,7 @@ } // this is not necessary: -if ($show_separators == true) +if ($show_separators == &true;) { echo "<hr>\n"; } @@ -189,12 +189,12 @@ <para> When converting to <type>boolean</type>, the following values - are considered <constant>FALSE</constant>: + are considered &false;: <itemizedlist> <listitem> <simpara>the <link linkend="language.types.boolean">boolean</link> - FALSE<!-- duh... --></simpara> + &false;<!-- duh... --></simpara> </listitem> <listitem> <simpara>the <link linkend="language.types.integer">integer</link @@ -220,17 +220,17 @@ </listitem> <listitem> <simpara>the special value <link linkend="language.types.null" - >NULL</link> + >&null;</link> </simpara> </listitem> </itemizedlist> - Every other value is considered <constant>TRUE</constant> (including any + Every other value is considered &true; (including any <link linkend="language.types.resource">resource</link>). <warning> <simpara> <literal>-1</literal> is considered - <constant>TRUE</constant>, like any other non-zero (whether negative + &true;, like any other non-zero (whether negative or positive) number! </simpara> </warning> @@ -365,8 +365,8 @@ <title>From <link linkend="language.types.boolean" >booleans</link></title> <simpara> - <constant>FALSE</constant> will yield - <literal>0</literal> (zero), and <constant>TRUE</constant> + &false; will yield + <literal>0</literal> (zero), and &true; will yield <literal>1</literal> (one). </simpara> </sect3> @@ -783,7 +783,7 @@ with object properties there doesn't exist a trick like the one with variables. - <!-- XXX isn't true :(, this would be the trick + <!-- XXX isn't &true; :(, this would be the trick Also, the same trick with curly-braces works if you want to limit the greediness of parsers (aren't they @@ -1146,7 +1146,7 @@ That means that you can write things like this: <informalexample> <programlisting role="php"> -echo $arr[ foo(true) ]; +echo $arr[ foo(&true;) ]; </programlisting> </informalexample> This is an example of using function-output as the array index. @@ -1258,7 +1258,7 @@ $map = array( 'version' => 4 , 'OS' => 'Linux' , 'lang' => 'english' - , 'short_tags' => true + , 'short_tags' => &true; ); // strictly numerical keys @@ -1706,27 +1706,27 @@ </sect1> <sect1 id="language.types.null"> - <title>Null</title> + <title>&null;</title> <para> - The special <literal>NULL</literal> value represents + The special &null; value represents that a variable has no value. </para> <note> <simpara> - The null-type was introduced in PHP 4 + The &null;-type was introduced in PHP 4 </simpara> </note> <sect2 id="language.types.null.syntax"> <title>Syntax</title> <para> - There is only one value of type null, and that is + There is only one value of type &null;, and that is the case-insensitive keyword - <literal>NULL</literal>. + &null;. <informalexample> <programlisting role="php"> -$var = Null; +$var = &null;; </programlisting> </informalexample> </para> @@ -1926,7 +1926,7 @@ </listitem> <listitem> <simpara><link linkend="language.types.null.casting">Converting to - null</link></simpara> + &null;</link></simpara> </listitem> --> </itemizedlist> Index: phpdoc/en/pear/pear.xml diff -u phpdoc/en/pear/pear.xml:1.3 phpdoc/en/pear/pear.xml:1.4 --- phpdoc/en/pear/pear.xml:1.3 Thu Mar 22 15:01:33 2001 +++ phpdoc/en/pear/pear.xml Sat Jul 7 14:42:46 2001 @@ -54,7 +54,7 @@ <title>PEAR Error Handling</title> <simpara> PEAR's base class also provides a way of passing around more - complex errors than a true/false value or a numeric code. A + complex errors than a &true;/&false; value or a numeric code. A PEAR error is an object that is either an instance of the class <classname>PEAR_Error</classname>, or some class inheriting <classname>PEAR_Error</classname>. Index: phpdoc/en/pear/standards.xml diff -u phpdoc/en/pear/standards.xml:1.4 phpdoc/en/pear/standards.xml:1.5 --- phpdoc/en/pear/standards.xml:1.4 Mon May 7 01:26:55 2001 +++ phpdoc/en/pear/standards.xml Sat Jul 7 14:42:46 2001 @@ -107,7 +107,7 @@ <sect1 id="pear.standards.funcdef"> <title>Function Definitions</title> <para> - Function declaractions follow the "one true brace" convention: + Function declaractions follow the "one &true; brace" convention: <programlisting role="php"> function fooFunction($arg1, $arg2 = '') { @@ -123,7 +123,7 @@ Always attempt to return a meaningful value from a function if one is appropriate. Here is a slightly longer example: <programlisting role="php"> -function connect(&$dsn, $persistent = false) +function connect(&$dsn, $persistent = &false;) { if (is_array($dsn)) { $dsninfo = &$dsn; @@ -135,7 +135,7 @@ return $this->raiseError(); } - return true; + return &true;; } </programlisting> </para>
Index: phpdoc/en/language-snippets.ent diff -u phpdoc/en/language-snippets.ent:1.2 phpdoc/en/language-snippets.ent:1.3 --- phpdoc/en/language-snippets.ent:1.2 Sun Jun 24 11:27:21 2001 +++ phpdoc/en/language-snippets.ent Sat Jul 7 14:42:09 2001 @@ -1,3 +1,10 @@ +<!-- PHPDoc snippets $Id: language-snippets.ent,v 1.3 2001/07/07 18:42:09 jeroen Exp $ --> + +<!ENTITY true '<constant>TRUE</constant>'> +<!ENTITY false '<constant>FALSE</constant>'> +<!ENTITY null '<constant>NULL</constant>'> + + <!ENTITY warn.experimental '<warning><simpara>This module is <emphasis>EXPERIMENTAL</emphasis>. That means, that the behaviour of these functions, these function names, in concreto ANYTHING documented here can change in a future release of PHP WITHOUT NOTICE. Be warned, and use this module at your own risk.</simpara></warning>'> <!ENTITY tip.ob-capture '<tip><simpara>As with anything that outputs its result directly to the browser, you can use the <link linkend="ref.outcontrol">output-control functions</link> to capture the output of this function, and save it - for example - in a <type>string</type>.</simpara></tip>'> Index: phpdoc/en/appendices/debugger.xml diff -u phpdoc/en/appendices/debugger.xml:1.7 phpdoc/en/appendices/debugger.xml:1.8 --- phpdoc/en/appendices/debugger.xml:1.7 Wed Jan 24 14:23:35 2001 +++ phpdoc/en/appendices/debugger.xml Sat Jul 7 14:42:10 2001 @@ -238,7 +238,7 @@ <literallayout> 1998-04-05 23:27:400966 lucifer.guardian.no(20481) start: notice 1998-04-05 23:27:400966 lucifer.guardian.no(20481) message: Uninitialized variable -1998-04-05 23:27:400966 lucifer.guardian.no(20481) location: (null):7 +1998-04-05 23:27:400966 lucifer.guardian.no(20481) location: (&null;):7 1998-04-05 23:27:400966 lucifer.guardian.no(20481) frames: 1 1998-04-05 23:27:400966 lucifer.guardian.no(20481) function: display 1998-04-05 23:27:400966 lucifer.guardian.no(20481) location: /home/ssb/public_html/test.php3:10 Index: phpdoc/en/appendices/migration.xml diff -u phpdoc/en/appendices/migration.xml:1.4 phpdoc/en/appendices/migration.xml:1.5 --- phpdoc/en/appendices/migration.xml:1.4 Sun Jan 21 20:02:01 2001 +++ phpdoc/en/appendices/migration.xml Sat Jul 7 14:42:11 2001 @@ -323,10 +323,10 @@ <sect2 id="migration-truefalse"> - <title>Function true/false return values</title> + <title>Function &true;/&false; return values</title> <simpara> - Most internal functions have been rewritten so they return TRUE - when successful and FALSE when failing, as opposed to 0 and -1 in + Most internal functions have been rewritten so they return &true; + when successful and &false; when failing, as opposed to 0 and -1 in PHP/FI 2.0, respectively. The new behaviour allows for more logical code, like <literal>$fp = fopen("/your/file") or fail("darn!");</literal>. Because PHP/FI 2.0 had no clear rules @@ -366,7 +366,7 @@ <listitem><simpara> In PHP/FI 2.0, an implementation side-effect caused <literal>$foo[0]</literal> to have the same effect as - <literal>$foo</literal>. This is not true for PHP 3.0.</simpara></listitem> + <literal>$foo</literal>. This is not &true; for PHP 3.0.</simpara></listitem> <listitem><simpara> Reading arrays with <literal>$array[]</literal> is no longer Index: phpdoc/en/appendices/migration4.xml diff -u phpdoc/en/appendices/migration4.xml:1.6 phpdoc/en/appendices/migration4.xml:1.7 --- phpdoc/en/appendices/migration4.xml:1.6 Sat May 19 16:48:23 2001 +++ phpdoc/en/appendices/migration4.xml Sat Jul 7 14:42:11 2001 @@ -98,7 +98,7 @@ <para> This has lead to a lot of unreproduceable bug reports in the past where people reported script engine problems they were not - capable to track down while the true case was usually some + capable to track down while the &true; case was usually some missing '}' in a required file that the parser was not able to report due to a misconfigured error reporting system. </para> @@ -208,7 +208,7 @@ <para> Another feature from PHP 3.0 that didn't make it into 4.0 is the experimental debugging interface as described in ??? in this - manual. A seperate true debuger is promissed to be released as a + manual. A seperate &true; debuger is promissed to be released as a Zend product but hasn't become visible yet. </para> </section> @@ -232,7 +232,7 @@ This has no direct consequences as the behavior of <function>unset</function> didn't change, but testing for "unset" usign <function>function_exists</function> will return - <literal>false</literal> as it would with othern lowlevel + &false; as it would with othern lowlevel functions like <function>echo</function>. </para> <para> Index: phpdoc/en/appendices/phpdevel.xml diff -u phpdoc/en/appendices/phpdevel.xml:1.5 phpdoc/en/appendices/phpdevel.xml:1.6 --- phpdoc/en/appendices/phpdevel.xml:1.5 Fri Sep 15 12:09:42 2000 +++ phpdoc/en/appendices/phpdevel.xml Sat Jul 7 14:42:12 2001 @@ -258,7 +258,7 @@ pval arr; if (array_init(&arr) == FAILURE) { failed... }; -hash_update(active_symbol_table,"foo",sizeof("foo"),&arr,sizeof(pval),NULL); +hash_update(active_symbol_table,"foo",sizeof("foo"),&arr,sizeof(pval),&null;); </programlisting> </example> @@ -278,15 +278,15 @@ entry.value.lval = 5; /* defines $foo["bar"] = 5 */ -hash_update(arr.value.ht,"bar",sizeof("bar"),&entry,sizeof(pval),NULL); +hash_update(arr.value.ht,"bar",sizeof("bar"),&entry,sizeof(pval),&null;); /* defines $foo[7] = 5 */ -hash_index_update(arr.value.ht,7,&entry,sizeof(pval),NULL); +hash_index_update(arr.value.ht,7,&entry,sizeof(pval),&null;); /* defines the next free place in $foo[], * $foo[8], to be 5 (works like php2) */ -hash_next_index_insert(arr.value.ht,&entry,sizeof(pval),NULL); +hash_next_index_insert(arr.value.ht,&entry,sizeof(pval),&null;); </programlisting> </example> @@ -294,7 +294,7 @@ must first retrieve it from the hash. To prevent that overhead, you can supply a pval ** to the hash add function, and it'll be updated with the pval * address of the inserted element inside the - hash. If that value is NULL (like in all of the above examples) - + hash. If that value is &null; (like in all of the above examples) - that parameter is ignored.</para> <simpara> @@ -348,10 +348,10 @@ function: <itemizedlist> <listitem><simpara>RETURN</simpara></listitem> - <listitem><simpara>RETURN_FALSE</simpara></listitem> - <listitem><simpara>RETURN_TRUE</simpara></listitem> + <listitem><simpara>RETURN_false</simpara></listitem> + <listitem><simpara>RETURN_true</simpara></listitem> <listitem><simpara>RETURN_LONG(l)</simpara></listitem> - <listitem><simpara>RETURN_STRING(s,dup) If dup is true, duplicates the string</simpara></listitem> + <listitem><simpara>RETURN_STRING(s,dup) If dup is &true;, duplicates the string</simpara></listitem> <listitem><simpara>RETURN_STRINGL(s,l,dup) Return string (s) specifying length (l).</simpara></listitem> <listitem><simpara>RETURN_DOUBLE(d)</simpara></listitem> </itemizedlist></para> @@ -359,10 +359,10 @@ <para> The RETVAL_* macros set the return value, but do not return. <itemizedlist> - <listitem><simpara>RETVAL_FALSE</simpara></listitem> - <listitem><simpara>RETVAL_TRUE</simpara></listitem> + <listitem><simpara>RETVAL_false</simpara></listitem> + <listitem><simpara>RETVAL_true</simpara></listitem> <listitem><simpara>RETVAL_LONG(l)</simpara></listitem> - <listitem><simpara>RETVAL_STRING(s,dup) If dup is true, duplicates the string</simpara></listitem> + <listitem><simpara>RETVAL_STRING(s,dup) If dup is &true;, duplicates the string</simpara></listitem> <listitem><simpara>RETVAL_STRINGL(s,l,dup) Return string (s) specifying length (l).</simpara></listitem> <listitem><simpara>RETVAL_DOUBLE(d)</simpara></listitem> </itemizedlist></para> @@ -374,7 +374,7 @@ <simpara> If your function returns boolean success/error responses, always - use RETURN_TRUE and RETURN_FALSE respectively.</simpara></sect2> + use RETURN_true and RETURN_false respectively.</simpara></sect2> <sect2 id="phpdevel-addfunc-retcomplex"> <title>Returning complex values</title> @@ -496,7 +496,7 @@ resource = php3_list_find(resource_id->value.lval, &type); if (type != LE_RESOURCE_TYPE) { php3_error(E_WARNING,"resource index %d has the wrong type",resource_id->value.lval); - RETURN_FALSE; + RETURN_false; } /* ...use resource... */ </programlisting> @@ -695,8 +695,8 @@ <title>pval *object</title> <simpara> This is a pointer to an object on which the function is invoked. - This should be NULL if a global function is called. If it's not - NULL (i.e. it points to an object), the function_table argument is + This should be &null; if a global function is called. If it's not + &null; (i.e. it points to an object), the function_table argument is ignored, and instead taken from the object's hash. The object *may* be modified by the function that is invoked on it (that function will have access to it via $this). If for some reason you don't Index: phpdoc/en/appendices/reserved.xml diff -u phpdoc/en/appendices/reserved.xml:1.3 phpdoc/en/appendices/reserved.xml:1.4 --- phpdoc/en/appendices/reserved.xml:1.3 Wed May 23 04:50:55 2001 +++ phpdoc/en/appendices/reserved.xml Sat Jul 7 14:42:13 2001 @@ -100,7 +100,7 @@ </listitem> <listitem> <simpara> - <link linkend="language.constants"><literal>FALSE</literal></link>. + <link linkend="language.constants">&false;</link>. </simpara> </listitem> <listitem> @@ -210,7 +210,7 @@ </listitem> <listitem> <simpara> - <link linkend="language.constants"><literal>TRUE</literal></link>. + <link linkend="language.constants">&true;</link>. </simpara> </listitem> <listitem> Index: phpdoc/en/chapters/config.xml diff -u phpdoc/en/chapters/config.xml:1.15 phpdoc/en/chapters/config.xml:1.16 --- phpdoc/en/chapters/config.xml:1.15 Tue Jun 26 23:52:38 2001 +++ phpdoc/en/chapters/config.xml Sat Jul 7 14:42:14 2001 @@ -1326,8 +1326,8 @@ </term> <listitem> <para> - Set to true if you want to return blob columns - in a file, false if you want them in memory. You can + Set to &true; if you want to return blob columns + in a file, &false; if you want them in memory. You can override the setting at runtime with <function>ifx_blobinfile_mode</function>. </para> @@ -1341,9 +1341,9 @@ </term> <listitem> <para> - Set to true if you want to return TEXT columns + Set to &true; if you want to return TEXT columns as normal strings in select statements, - false if you want to use blob id parameters. You can + &false; if you want to use blob id parameters. You can override the setting at runtime with <function>ifx_textasvarchar</function>. </para> @@ -1357,9 +1357,9 @@ </term> <listitem> <para> - Set to true if you want to return BYTE columns + Set to &true; if you want to return BYTE columns as normal strings in select queries, - false if you want to use blob id parameters. You can + &false; if you want to use blob id parameters. You can override the setting at runtime with <function>ifx_textasvarchar</function>. </para> @@ -1373,7 +1373,7 @@ </term> <listitem> <para> - Set to true if you want to trim trailing spaces + Set to &true; if you want to trim trailing spaces from CHAR columns when fetching them. </para> </listitem> @@ -1386,8 +1386,8 @@ </term> <listitem> <para> - Set to true if you want to return NULL columns - as the literal string "NULL", false if you want + Set to &true; if you want to return &null; columns + as the literal string "&null;", &false; if you want them returned as the empty string "". You can override this setting at runtime with <function>ifx_nullformat</function>. Index: phpdoc/en/features/connection-handling.xml diff -u phpdoc/en/features/connection-handling.xml:1.2 phpdoc/en/features/connection-handling.xml:1.3 --- phpdoc/en/features/connection-handling.xml:1.2 Thu Dec 9 19:34:38 1999 +++ phpdoc/en/features/connection-handling.xml Sat Jul 7 14:42:16 2001 @@ -41,7 +41,7 @@ This shutdown function will also get called at the end of your script terminating normally, so to do something different in case of a client diconnect you can use the <function>connection_aborted</function> - function. This function will return true if the connection was + function. This function will return &true; if the connection was aborted.</simpara> <simpara> @@ -55,7 +55,7 @@ be called. Within this shutdown function you can check to see if a timeout caused the shutdown function to be called by calling the <function>connection_timeout</function> function. This function will - return true if a timeout caused the shutdown function to be called.</simpara> + return &true; if a timeout caused the shutdown function to be called.</simpara> <simpara> One thing to note is that both the ABORTED and the TIMEOUT states @@ -65,7 +65,7 @@ running. If it then hits the time limit it will be aborted and your shutdown function, if any, will be called. At this point you will find that <function>connection_timeout</function> - and <function>connection_aborted</function> return true. + and <function>connection_aborted</function> return &true;. You can also check both states in a single call by using the <function>connection_status</function>. This function returns a bitfield of the active states. So, if both states are active it Index: phpdoc/en/features/error-handling.xml diff -u phpdoc/en/features/error-handling.xml:1.14 phpdoc/en/features/error-handling.xml:1.15 --- phpdoc/en/features/error-handling.xml:1.14 Mon Jan 22 20:56:45 2001 +++ phpdoc/en/features/error-handling.xml Sat Jul 7 14:42:17 2001 @@ -231,12 +231,12 @@ function distance ($vect1, $vect2) { if (!is_array($vect1) || !is_array($vect2)) { trigger_error("Incorrect parameters, arrays expected", E_USER_ERROR); - return NULL; + return &null;; } if (count($vect1) != count($vect2)) { trigger_error("Vectors need to be of the same size", E_USER_ERROR); - return NULL; + return &null;; } for ($i=0; $i<count($vect1); $i++) { Index: phpdoc/en/functions/array.xml diff -u phpdoc/en/functions/array.xml:1.74 phpdoc/en/functions/array.xml:1.75 --- phpdoc/en/functions/array.xml:1.74 Mon Jul 2 15:44:44 2001 +++ phpdoc/en/functions/array.xml Sat Jul 7 14:42:20 2001 @@ -288,7 +288,7 @@ used as its values, and all others will be lost. </para> <para> - <function>array_flip</function> returns <literal>FALSE</literal> + <function>array_flip</function> returns &false; if it fails. </para> <para> @@ -542,7 +542,7 @@ </para> <para> An interesting use of this function is to construct an array of arrays, - which can be easily performed by using <literal>null</literal> + which can be easily performed by using &null; as the name of the callback function </para> <para> @@ -553,7 +553,7 @@ $b = array("one", "two", "three", "four", "five"); $c = array("uno", "dos", "tres", "cuatro", "cinco"); -$d = array_map(null, $a, $b, $c); +$d = array_map(&null;, $a, $b, $c); print_r($d); // will output: @@ -775,7 +775,7 @@ SORT_REGULAR after before each new array argument. </para> <para> - Returns <literal>TRUE</literal> on success, <literal>FALSE</literal> + Returns &true; on success, &false; on failure. </para> <para> @@ -879,7 +879,7 @@ the <parameter>array</parameter>, shortening the <parameter>array</parameter> by one element. If <parameter>array</parameter> is empty (or is not an array), - <varname>NULL</varname> will be returned. + &null; will be returned. </para> <para> <example> @@ -1027,7 +1027,7 @@ <function>array_reverse</function> takes input <parameter>array</parameter> and returns a new array with the order of the elements reversed, preserving the keys if - <parameter>preserve_keys</parameter> is <literal>TRUE</literal>. + <parameter>preserve_keys</parameter> is &true;. </para> <para> <example> @@ -1035,7 +1035,7 @@ <programlisting role="php"> $input = array ("php", 4.0, array ("green", "red")); $result = array_reverse ($input); -$result_keyed = array_reverse ($input, TRUE); +$result_keyed = array_reverse ($input, &true;); </programlisting> </example> </para> @@ -1136,7 +1136,7 @@ <parameter>array</parameter> by one element and moving everything down. If <parameter>array</parameter> is empty (or is not an array), - <varname>NULL</varname> will be returned. + &null; will be returned. </para> <para> <example> @@ -1856,11 +1856,11 @@ array element that's currently being pointed by the internal pointer. It does not move the pointer in any way. If the internal pointer points beyond the end of the elements list, - <function>current</function> returns <literal>FALSE</literal>. + <function>current</function> returns &false;. <warning> <para> If the array contains empty elements (0 or "", the empty - string) then this function will return <literal>FALSE</literal> + string) then this function will return &false; for these elements as well. This makes it impossible to determine if you are really at the end of the list in such an array using <function>current</function>. To properly @@ -1905,7 +1905,7 @@ <para> If the internal pointer for the array points past the end of the array contents, <function>each</function> returns - <literal>FALSE</literal>. + &false;. </para> <para> <example> @@ -2156,7 +2156,7 @@ <refentry id="function.in-array"> <refnamediv> <refname>in_array</refname> - <refpurpose>Return TRUE if a value exists in an array</refpurpose> + <refpurpose>Return &true; if a value exists in an array</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -2172,12 +2172,12 @@ </funcsynopsis> <para> Searches <parameter>haystack</parameter> for - <parameter>needle</parameter> and returns <literal>TRUE</literal> - if it is found in the array, <literal>FALSE</literal> otherwise. + <parameter>needle</parameter> and returns &true; + if it is found in the array, &false; otherwise. </para> <para> If the third parameter <parameter>strict</parameter> is set to - <literal>TRUE</literal> then the <function>in_array</function> + &true; then the <function>in_array</function> will also check the types of the <parameter>needle</parameter> in the <parameter>haystack</parameter>. </para> @@ -2199,9 +2199,9 @@ <?php $a = array('1.10', 12.4, 1.13); -if (in_array('12.4', $a, TRUE)) +if (in_array('12.4', $a, &true;)) echo "'12.4' found with strict check\n"; -if (in_array(1.13, $a, TRUE)) +if (in_array(1.13, $a, &true;)) echo "1.13 found with strict check\n"; ?> @@ -2237,11 +2237,11 @@ <para> Searches <parameter>haystack</parameter> for <parameter>needle</parameter> and returns the key if it is found in - the array, <literal>FALSE</literal> otherwise. + the array, &false; otherwise. </para> <para> If the third parameter <parameter>strict</parameter> is set to - <literal>TRUE</literal> then the <function>array_search</function> + &true; then the <function>array_search</function> will also check the types of the <parameter>needle</parameter> in the <parameter>haystack</parameter>. </para> @@ -2575,7 +2575,7 @@ </funcsynopsis> <para> Returns the array element in the next place that's pointed by the - internal array pointer, or <literal>FALSE</literal> if + internal array pointer, or &false; if there are no more elements. </para> <para> @@ -2585,11 +2585,11 @@ element. That means it returns the next array element and advances the internal array pointer by one. If advancing the internal array pointer results in going beyond the end of the - element list, <function>next</function> returns <literal>FALSE</literal>. + element list, <function>next</function> returns &false;. <warning> <para> If the array contains empty elements, or elements that have a key - value of 0 then this function will return <literal>FALSE</literal> + value of 0 then this function will return &false; for these elements as well. To properly traverse an array which may contain empty elements or elements with key values of 0 see the <function>each</function> function. @@ -2643,12 +2643,12 @@ </funcsynopsis> <para> Returns the array element in the previous place that's pointed by - the internal array pointer, or <literal>FALSE</literal> if there are no more + the internal array pointer, or &false; if there are no more elements. <warning> <para> If the array contains empty elements then this function will - return <literal>FALSE</literal> for these elements as well. + return &false; for these elements as well. To properly traverse an array which may contain empty elements see the <function>each</function> function. </para> Index: phpdoc/en/functions/aspell.xml diff -u phpdoc/en/functions/aspell.xml:1.9 phpdoc/en/functions/aspell.xml:1.10 --- phpdoc/en/functions/aspell.xml:1.9 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/aspell.xml Sat Jul 7 14:42:21 2001 @@ -68,7 +68,7 @@ </funcsynopsis> <simpara> <function>aspell_check</function> checks the spelling of a word - and returns true if the spelling is correct, false if not. + and returns &true; if the spelling is correct, &false; if not. </simpara> <para> <example> @@ -105,7 +105,7 @@ <simpara> <function>aspell_check_raw</function> checks the spelling of a word, without changing its case or trying to trim it in any way - and returns true if the spelling is correct, false if not. + and returns &true; if the spelling is correct, &false; if not. </simpara> <para> <example> Index: phpdoc/en/functions/bzip2.xml diff -u phpdoc/en/functions/bzip2.xml:1.6 phpdoc/en/functions/bzip2.xml:1.7 --- phpdoc/en/functions/bzip2.xml:1.6 Sun May 20 18:49:49 2001 +++ phpdoc/en/functions/bzip2.xml Sat Jul 7 14:42:21 2001 @@ -72,7 +72,7 @@ Closes the bzip2 file referenced by the pointer <parameter>bz</parameter>. </para> <para> - Returns true on success and false on failure. + Returns &true; on success and &false; on failure. </para> <para> The file pointer must be valid, and must point to a file @@ -162,7 +162,7 @@ <function>bzdecompress</function> decompresses the <parameter>source</parameter> string containing bzip2 encoded data and returns it. If the optional parameter - <parameter>small</parameter> is true, an alternative + <parameter>small</parameter> is &true;, an alternative decompression algorithm will be used which uses less memory (the maximum memory requirement drops to around 2300K) but works at roughly half the speed. See the <ulink url="&url.bzip2;">bzip2 @@ -297,7 +297,7 @@ <parameter>bz</parameter>. </para> <para> - Returns true on success, false on failure. + Returns &true; on success, &false; on failure. </para> <para> See also <function>bzread</function> and <function>bzwrite</function>. @@ -327,7 +327,7 @@ <function>fopen</function> function (`r' for read, `w' for write, etc.). </para> <para> - If the open fails, the function returns false, otherwise it + If the open fails, the function returns &false;, otherwise it returns a pointer to the newly opened file. </para> <para> Index: phpdoc/en/functions/calendar.xml diff -u phpdoc/en/functions/calendar.xml:1.10 phpdoc/en/functions/calendar.xml:1.11 --- phpdoc/en/functions/calendar.xml:1.10 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/calendar.xml Sat Jul 7 14:42:21 2001 @@ -521,7 +521,7 @@ </funcsynopsis> <para> This function will return a UNIX timestamp corresponding to the - Julian Day given in <parameter>jday</parameter> or false if + Julian Day given in <parameter>jday</parameter> or &false; if <parameter>jday</parameter> is not inside the UNIX epoch (Gregorian years between 1970 and 2037 or 2440588 <= <parameter>jday</parameter> <= 2465342 ) Index: phpdoc/en/functions/classobj.xml diff -u phpdoc/en/functions/classobj.xml:1.20 phpdoc/en/functions/classobj.xml:1.21 --- phpdoc/en/functions/classobj.xml:1.20 Wed May 16 14:33:20 2001 +++ phpdoc/en/functions/classobj.xml Sat Jul 7 14:42:22 2001 @@ -56,14 +56,14 @@ // extends the base class class Spinach extends Vegetable { - var $cooked = false; + var $cooked = &false;; function Spinach() { - $this->Vegetable( true, "green" ); + $this->Vegetable( &true;, "green" ); } function cook_it() { - $this->cooked = true; + $this->cooked = &true;; } function is_cooked() { @@ -117,7 +117,7 @@ // instantiate 2 objects -$veggie = new Vegetable(true,"blue"); +$veggie = new Vegetable(&true;,"blue"); $leafy = new Spinach(); // print out information about objects @@ -291,9 +291,9 @@ </funcprototype> </funcsynopsis> <para> - This function returns true if the class given by + This function returns &true; if the class given by <parameter>class_name</parameter> has been defined, - false otherwise. + &false; otherwise. </para> </refsect1> </refentry> @@ -365,17 +365,17 @@ class myclass { // constructor function myclass() { - return(true); + return(&true;); } // method 1 function myfunc1() { - return(true); + return(&true;); } // method 2 function myfunc2() { - return(true); + return(&true;); } } @@ -448,7 +448,7 @@ // constructor function myclass() { - return(true); + return(&true;); } } @@ -631,9 +631,9 @@ </funcprototype> </funcsynopsis> <para> - This function returns true if the object <parameter>obj</parameter>, + This function returns &true; if the object <parameter>obj</parameter>, belongs to a class which is a subclass of - <parameter>superclass</parameter>, false otherwise. + <parameter>superclass</parameter>, &false; otherwise. </para> <simpara> See also <function>get_class</function>, @@ -656,9 +656,9 @@ </funcprototype> </funcsynopsis> <para> - This function returns true if the method given by + This function returns &true; if the method given by <parameter>method_name</parameter> has been defined for the given - <parameter>object</parameter>, false otherwise. + <parameter>object</parameter>, &false; otherwise. </para> </refsect1> </refentry> Index: phpdoc/en/functions/com.xml diff -u phpdoc/en/functions/com.xml:1.15 phpdoc/en/functions/com.xml:1.16 --- phpdoc/en/functions/com.xml:1.15 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/com.xml Sat Jul 7 14:42:22 2001 @@ -48,9 +48,9 @@ <listitem> <simpara> name of the DCOM server from which the component should be fetched. - If <literal>NULL</literal>, <literal>localhost</literal> is assumed. + If &null;, <literal>localhost</literal> is assumed. To allow DCOM <constant>com.allow_dcom</constant> has to be set to - <literal>TRUE</literal> in <filename>php.ini</filename>. + &true; in <filename>php.ini</filename>. </simpara> </listitem> </varlistentry> @@ -91,7 +91,7 @@ //free the object $word->Release(); -$word = null; +$word = &null;; </programlisting> </example> </para> @@ -131,8 +131,8 @@ $rs->Release(); $conn->Release(); -$rs = null; -$conn = null; +$rs = &null;; +$conn = &null;; </programlisting> </example> </para> @@ -232,7 +232,7 @@ </funcsynopsis> <para> <function>com_load</function> creates a new COM component and - returns a reference to it. Returns <literal>false</literal> on + returns a reference to it. Returns &false; on failiure.Possible values for <parameter>codepage</parameter> are <constant>CP_ACP</constant>, <constant>CP_MACCP</constant>, <constant>CP_OEMCP</constant>, <constant>CP_SYMBOL</constant>, @@ -267,7 +267,7 @@ <function>com_invoke</function> invokes a method of the COM component referenced by <parameter>com_object</parameter>. Returns - <literal>false</literal> on error, returns the + &false; on error, returns the <parameter>function_name</parameter>'s return value on success. </para> </refsect1> @@ -314,7 +314,7 @@ <para> Returns the value of the <parameter>property</parameter> of the COM component referenced by <parameter>com_object</parameter>. - Returns <literal>false</literal> on error. + Returns &false; on error. </para> </refsect1> </refentry> @@ -385,7 +385,7 @@ <para> Sets the value of the <parameter>property</parameter> of the COM component referenced by <parameter>com_object</parameter>. - Returns the newly set value if succeeded, <literal>false</literal> on error. + Returns the newly set value if succeeded, &false; on error. </para> </refsect1> </refentry> Index: phpdoc/en/functions/cpdf.xml diff -u phpdoc/en/functions/cpdf.xml:1.23 phpdoc/en/functions/cpdf.xml:1.24 --- phpdoc/en/functions/cpdf.xml:1.23 Sun May 20 23:26:27 2001 +++ phpdoc/en/functions/cpdf.xml Sat Jul 7 14:42:22 2001 @@ -1345,7 +1345,7 @@ <para> The last parameter <parameter>encoding</parameter> can take the following values: "MacRomanEncoding", "MacExpertEncoding", - "WinAnsiEncoding", and "NULL". "NULL" stands for the font's + "WinAnsiEncoding", and "&null;". "&null;" stands for the font's built-in encoding. </para> <para> Index: phpdoc/en/functions/ctype.xml diff -u phpdoc/en/functions/ctype.xml:1.6 phpdoc/en/functions/ctype.xml:1.7 --- phpdoc/en/functions/ctype.xml:1.6 Sun Jun 24 11:27:21 2001 +++ phpdoc/en/functions/ctype.xml Sat Jul 7 14:42:22 2001 @@ -16,12 +16,12 @@ <para> When called with a string argument they will check every character in the string and will only return - true if every character in the string matches the + &true; if every character in the string matches the requested criteria. </para> <para> Passing anything else but a string or integer will - return false immediately. + return &false; immediately. </para> <warning> <simpara> Index: phpdoc/en/functions/cybercash.xml diff -u phpdoc/en/functions/cybercash.xml:1.4 phpdoc/en/functions/cybercash.xml:1.5 --- phpdoc/en/functions/cybercash.xml:1.4 Fri Sep 15 12:09:43 2000 +++ phpdoc/en/functions/cybercash.xml Sat Jul 7 14:42:23 2001 @@ -28,7 +28,7 @@ </funcsynopsis> <para> The function returns an associative array with the elements - "errcode" and, if "errcode" is false, "outbuff" (string), + "errcode" and, if "errcode" is &false;, "outbuff" (string), "outLth" (long) and "macbuff" (string). </para> </refsect1> @@ -51,7 +51,7 @@ </funcsynopsis> <para> The function returns an associative array with the elements - "errcode" and, if "errcode" is false, "outbuff" (string), + "errcode" and, if "errcode" is &false;, "outbuff" (string), "outLth" (long) and "macbuff" (string). </para> </refsect1> Index: phpdoc/en/functions/datetime.xml diff -u phpdoc/en/functions/datetime.xml:1.41 phpdoc/en/functions/datetime.xml:1.42 --- phpdoc/en/functions/datetime.xml:1.41 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/datetime.xml Sat Jul 7 14:42:23 2001 @@ -18,7 +18,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the date given is valid; otherwise returns false. + Returns &true; if the date given is valid; otherwise returns &false;. Checks the validity of the date formed by the arguments. A date is considered valid if: <itemizedlist> Index: phpdoc/en/functions/dba.xml diff -u phpdoc/en/functions/dba.xml:1.9 phpdoc/en/functions/dba.xml:1.10 --- phpdoc/en/functions/dba.xml:1.9 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/dba.xml Sat Jul 7 14:42:24 2001 @@ -151,7 +151,7 @@ $key = dba_firstkey ($id); -while ($key != false) { +while ($key != &false;) { if (...) { # remember the key to perform some action later $handle_later[] = $key; } @@ -227,7 +227,7 @@ <function>dba_open</function>. </para> <para> - <function>dba_delete</function> returns <literal>true</literal> or <literal>false</literal>, if the entry is + <function>dba_delete</function> returns &true; or &false;, if the entry is deleted or not deleted, respectively. </para> <para> @@ -265,7 +265,7 @@ <function>dba_open</function>. </para> <para> - <function>dba_exists</function> returns <literal>true</literal> or <literal>false</literal>, if the key is found + <function>dba_exists</function> returns &true; or &false;, if the key is found or not found, respectively. </para> <para> @@ -304,7 +304,7 @@ </para> <para> - <function>dba_fetch</function> returns the associated string or <literal>false</literal>, if + <function>dba_fetch</function> returns the associated string or &false;, if the key/data pair is found or not found, respectively. </para> <para> @@ -339,7 +339,7 @@ <function>dba_open</function>. </para> <para> - <function>dba_firstkey</function> returns the key or <literal>false</literal> + <function>dba_firstkey</function> returns the key or &false; depending on whether it succeeds or fails, respectively. </para> <para> @@ -382,7 +382,7 @@ <function>dba_open</function>. </para> <para> - <function>dba_insert</function> returns <literal>true</literal> or <literal>false</literal>, depending on + <function>dba_insert</function> returns &true; or &false;, depending on whether it succeeds of fails, respectively. </para> <para> @@ -418,7 +418,7 @@ <function>dba_open</function>. </para> <para> - <function>dba_nextkey</function> returns the key or <literal>false</literal> depending on + <function>dba_nextkey</function> returns the key or &false; depending on whether it succeeds or fails, respectively. </para> <para> @@ -468,7 +468,7 @@ of them. </para> <para> - <function>dba_popen</function> returns a positive handle or <literal>false</literal>, in + <function>dba_popen</function> returns a positive handle or &false;, in the case the open is successful or fails, respectively. </para> <para> @@ -517,7 +517,7 @@ them. </para> <para> - <function>dba_open</function> returns a positive handle or <literal>false</literal>, in + <function>dba_open</function> returns a positive handle or &false;, in the case the open is successful or fails, respectively. </para> <para> @@ -550,7 +550,7 @@ <function>dba_open</function>. </para> <para> - <function>dba_optimize</function> returns <literal>true</literal> or <literal>false</literal>, if the + <function>dba_optimize</function> returns &true; or &false;, if the optimization succeeds or fails, respectively. </para> <para> @@ -591,7 +591,7 @@ <function>dba_open</function>. </para> <para> - <function>dba_replace</function> returns <literal>true</literal> or <literal>false</literal>, depending on + <function>dba_replace</function> returns &true; or &false;, depending on whether it succeeds of fails, respectively. </para> <para> @@ -625,7 +625,7 @@ <function>dba_open</function>. </para> <para> - <function>dba_sync</function> returns <literal>true</literal> or <literal>false</literal>, if the + <function>dba_sync</function> returns &true; or &false;, if the synchronization succeeds or fails, respectively. </para> <para> Index: phpdoc/en/functions/dbase.xml diff -u phpdoc/en/functions/dbase.xml:1.5 phpdoc/en/functions/dbase.xml:1.6 --- phpdoc/en/functions/dbase.xml:1.5 Mon Apr 23 22:45:58 2001 +++ phpdoc/en/functions/dbase.xml Sat Jul 7 14:42:24 2001 @@ -98,7 +98,7 @@ </para> <para> If the database is successfully created, a dbase_identifier is - returned, otherwise false is returned. + returned, otherwise &false; is returned. <example> <title>Creating a dBase database file</title> <programlisting role="php"> @@ -144,7 +144,7 @@ read and write.) </para> <para> - Returns a dbase_identifier for the opened database, or false if + Returns a dbase_identifier for the opened database, or &false; if the database couldn't be opened. </para> </refsect1> @@ -209,7 +209,7 @@ Adds the data in the <parameter>record</parameter> to the database. If the number of items in the supplied record isn't equal to the number of fields in the database, the operation will - fail and false will be returned. + fail and &false; will be returned. </para> </refsect1> </refentry> @@ -234,7 +234,7 @@ <parameter>record_number</parameter> with the data in the <parameter>record</parameter> in the database. If the number of items in the supplied record is not equal to the number of fields - in the database, the operation will fail and false will be + in the database, the operation will fail and &false; will be returned. </simpara> <simpara> Index: phpdoc/en/functions/dbm.xml diff -u phpdoc/en/functions/dbm.xml:1.6 phpdoc/en/functions/dbm.xml:1.7 --- phpdoc/en/functions/dbm.xml:1.6 Wed May 16 14:33:20 2001 +++ phpdoc/en/functions/dbm.xml Sat Jul 7 14:42:24 2001 @@ -53,7 +53,7 @@ </para> <para> Returns an identifer to be passed to the other DBM functions on - success, or false on failure. + success, or &false; on failure. </para> <para> If NDBM support is used, NDBM will actually create filename.dir @@ -106,7 +106,7 @@ </funcprototype> </funcsynopsis> <para> - Returns TRUE if there is a value associated with the + Returns &true; if there is a value associated with the <parameter>key</parameter>. </para> </refsect1> @@ -209,7 +209,7 @@ Deletes the value for <parameter>key</parameter> in the database. </para> <para> - Returns false if the key didn't exist in the database. + Returns &false; if the key didn't exist in the database. </para> </refsect1> </refentry> Index: phpdoc/en/functions/dbx.xml diff -u phpdoc/en/functions/dbx.xml:1.12 phpdoc/en/functions/dbx.xml:1.13 --- phpdoc/en/functions/dbx.xml:1.12 Sun Jun 24 11:27:21 2001 +++ phpdoc/en/functions/dbx.xml Sat Jul 7 14:42:24 2001 @@ -43,8 +43,8 @@ </funcprototype> </funcsynopsis> <para> - Returns <literal>TRUE</literal> on success, - <literal>FALSE</literal> on error. + Returns &true; on success, + &false; on error. </para> <example> <title><function>dbx_close</function> example</title> @@ -89,9 +89,9 @@ </funcprototype> </funcsynopsis> <para> - Returns: a dbx_link_object on success, <literal>FALSE</literal> + Returns: a dbx_link_object on success, &false; on error. If a connection has been made but the database could not - be selected, the connection is closed and <literal>FALSE</literal> + be selected, the connection is closed and &false; is returned. The 'persistent' parameter can be set to DBX_PERSISTENT so a persistent connection will be created. </para> @@ -389,8 +389,8 @@ </funcprototype> </funcsynopsis> <para> - Returns <literal>TRUE</literal> on success, - <literal>FALSE</literal> on error. + Returns &true; on success, + &false; on error. </para> <example> <title><function>dbx_sort</function> example</title> Index: phpdoc/en/functions/dir.xml diff -u phpdoc/en/functions/dir.xml:1.15 phpdoc/en/functions/dir.xml:1.16 --- phpdoc/en/functions/dir.xml:1.15 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/dir.xml Sat Jul 7 14:42:25 2001 @@ -17,8 +17,8 @@ </funcsynopsis> <para> Changes the root directory of the current process to - <parameter>directory</parameter>. Returns FALSE if unable to - change the root directory, TRUE otherwise. + <parameter>directory</parameter>. Returns &false; if unable to + change the root directory, &true; otherwise. </para> <note> <para> @@ -46,8 +46,8 @@ </funcsynopsis> <para> Changes PHP's current directory to - <parameter>directory</parameter>. Returns FALSE if unable to - change directory, TRUE otherwise. + <parameter>directory</parameter>. Returns &false; if unable to + change directory, &true; otherwise. </para> </refsect1> </refentry> @@ -151,7 +151,7 @@ <para> If <parameter>path</parameter> is not a valid directory or the directory can not be opened due to permission restrictions or - filesystem errors, <function>opendir</function> returns false and + filesystem errors, <function>opendir</function> returns &false; and generates a PHP error. You can suppress the error output of <function>opendir</function> by prepending `@' to the front of the function name. @@ -200,7 +200,7 @@ $handle=opendir('.'); echo "Directory handle: $handle\n"; echo "Files:\n"; -while (($file = readdir($handle))!==false) { +while (($file = readdir($handle))!==&false;) { echo "$file\n"; } closedir($handle); @@ -221,7 +221,7 @@ <programlisting role="php"> <?php $handle=opendir('.'); -while (false!==($file = readdir($handle))) { +while (&false;!==($file = readdir($handle))) { if ($file != "." && $file != "..") { echo "$file\n"; } Index: phpdoc/en/functions/errorfunc.xml diff -u phpdoc/en/functions/errorfunc.xml:1.12 phpdoc/en/functions/errorfunc.xml:1.13 --- phpdoc/en/functions/errorfunc.xml:1.12 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/errorfunc.xml Sat Jul 7 14:42:25 2001 @@ -315,7 +315,7 @@ <para> Sets a user function (<parameter>error_handler</parameter>) to handle errors in a script. Returns the previously defined error handler (if - any), or false on error. This function can be used for defining your own + any), or &false; on error. This function can be used for defining your own way of handling errors during runtime, for example in applications in which you need to do cleanup of data/files when a critical error happens, or when you need to trigger an error under certain conditions (using @@ -378,7 +378,7 @@ FATAL); if (!is_array($vect)) { trigger_error("Incorrect input vector, array of values expected", ERROR); - return null; + return &null;; } for ($i=0; $i<count($vect); $i++) { if (!is_numeric($vect[$i])) @@ -442,7 +442,7 @@ ---- vector c - an error <b>ERROR</b> [512] Incorrect input vector, array of values expected<br> -NULL +&null; ---- vector d - fatal error <b>FATAL</b> [256] log(x) for x <= 0 is undefined, you used: scale = -2.5<br> Index: phpdoc/en/functions/exec.xml diff -u phpdoc/en/functions/exec.xml:1.11 phpdoc/en/functions/exec.xml:1.12 --- phpdoc/en/functions/exec.xml:1.11 Sat May 19 16:39:20 2001 +++ phpdoc/en/functions/exec.xml Sat Jul 7 14:42:25 2001 @@ -238,7 +238,7 @@ PHP is running as a server module. </para> <para> - Returns the last line of the command output on success, and false + Returns the last line of the command output on success, and &false; on failure. </para> <para> Index: phpdoc/en/functions/fbsql.xml diff -u phpdoc/en/functions/fbsql.xml:1.11 phpdoc/en/functions/fbsql.xml:1.12 --- phpdoc/en/functions/fbsql.xml:1.11 Sun Jun 24 11:27:21 2001 +++ phpdoc/en/functions/fbsql.xml Sat Jul 7 14:42:26 2001 @@ -167,7 +167,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: <literal>TRUE</literal> on success, <literal>FALSE</literal> on error. + Returns: &true; on success, &false; on error. </para> <para> <function>fbsql_close</function> closes the connection to the FrontBase server that's associated with the specified link @@ -233,7 +233,7 @@ <function>fbsql_connect</function> establishes a connection to a FrontBase server. The following defaults are assumed for missing optional parameters: <parameter>hostname</parameter> = - 'NULL', <parameter>username</parameter> = '_SYSTEM' and + '&null;', <parameter>username</parameter> = '_SYSTEM' and <parameter>password</parameter> = empty password. </para> <para> @@ -365,7 +365,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: <literal>TRUE</literal> on success, <literal>FALSE</literal> on failure. + Returns: &true; on success, &false; on failure. </para> <para> <function>fbsql_data_seek</function> moves the internal row @@ -433,7 +433,7 @@ </funcsynopsis> <para> Returns: A positive FrontBase result identifier to the query result, - or <literal>FALSE</literal> on error. + or &false; on error. </para> <para> <function>fbsql_db_query</function> selects a database and @@ -468,7 +468,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: <literal>TRUE</literal> on success, <literal>FALSE</literal> on failure. + Returns: &true; on success, &false; on failure. </para> <para> <function>fbsql_drop_db</function> attempts to drop (remove) an @@ -600,7 +600,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an array that corresponds to the fetched row, or <literal>FALSE</literal> + Returns an array that corresponds to the fetched row, or &false; if there are no more rows.</para> <para> <function>fbsql_fetch_array</function> is an extended version of @@ -671,7 +671,7 @@ </funcsynopsis> <para> Returns an associative array that corresponds to the fetched row, - or <literal>FALSE</literal> if there are no more rows.</para> + or &false; if there are no more rows.</para> <para> <function>fbsql_fetch_assoc</function> is equivalent to calling <function>fbsql_fetch_array</function> with FBSQL_ASSOC for the @@ -762,7 +762,7 @@ </listitem> <listitem> <simpara> - not_null - 1 if the column cannot be null + not_null - 1 if the column cannot be &null; </simpara> </listitem> <listitem> @@ -827,7 +827,7 @@ <para> Returns: An array that corresponds to the lengths of each field in the last row fetched by <function>fbsql_fetch_row</function>, - or <literal>FALSE</literal> on error. + or &false; on error. </para> <para> <function>fbsql_fetch_lengths</function> stores the lengths of @@ -863,7 +863,7 @@ </funcsynopsis> <para> Returns an object with properties that correspond to the fetched - row, or <literal>FALSE</literal> if there are no more rows. + row, or &false; if there are no more rows. </para> <para> <function>fbsql_fetch_object</function> is similar to @@ -918,7 +918,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: An array that corresponds to the fetched row, or <literal>FALSE</literal> + Returns: An array that corresponds to the fetched row, or &false; if there are no more rows. </para> <para> @@ -929,7 +929,7 @@ </para> <para> Subsequent call to <function>fbsql_fetch_row</function> would - return the next row in the result set, or <literal>FALSE</literal> if there are no + return the next row in the result set, or &false; if there are no more rows. </para> <para> @@ -1394,8 +1394,8 @@ This function will test for additional results available form the server. if an additional result set exists it will free the existing result set and prepare to fetch the wors from the new result set. - The function will return <literal>TRUE</literal> if an additional result set was - available or <literal>FALSE</literal> othervise. + The function will return &true; if an additional result set was + available or &false; othervise. </para> <example> <title><function>fbsql_next_result</function> example</title> @@ -1513,7 +1513,7 @@ </funcsynopsis> <para> Returns: A positive FrontBase persistent link identifier on success, - or <literal>FALSE</literal> on error. + or &false; on error. </para> <para> <function>fbsql_pconnect</function> establishes a connection @@ -1577,16 +1577,16 @@ </para> </note> <para> - <function>fbsql_query</function> returns <literal>TRUE</literal> (non-zero) or <literal>FALSE</literal> + <function>fbsql_query</function> returns &true; (non-zero) or &false; to indicate whether or not the query succeeded. A return value - of <literal>TRUE</literal> means that the query was legal and could be executed by + of &true; means that the query was legal and could be executed by the server. It does not indicate anything about the number of rows affected or returned. It is perfectly possible for a query to succeed but affect no rows or return no rows. </para> <para> The following query is syntactically invalid, so - <function>fbsql_query</function> fails and returns <literal>FALSE</literal>: + <function>fbsql_query</function> fails and returns &false;: <example> <title><function>fbsql_query</function> example</title> <programlisting role="php"> @@ -1601,7 +1601,7 @@ The following query is semantically invalid if <literal>my_col</literal> is not a column in the table <literal>my_tbl</literal>, so <function>fbsql_query</function> - fails and returns <literal>FALSE</literal>: + fails and returns &false;: <example> <title><function>fbsql_query</function> example</title> <programlisting role="php"> @@ -1613,7 +1613,7 @@ </example> </para> <para> - <function>fbsql_query</function> will also fail and return <literal>FALSE</literal> + <function>fbsql_query</function> will also fail and return &false; if you don't have permission to access the table(s) referenced by the query. </para> @@ -1713,7 +1713,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: <literal>TRUE</literal> on success, <literal>FALSE</literal> on error. + Returns: &true; on success, &false; on error. </para> <para> <function>fbsql_select_db</function> sets the current active @@ -1800,7 +1800,7 @@ </funcprototype> </funcsynopsis> <para> - Returns <literal>TRUE</literal> if warnings is turned on otherwise <literal>FALSE</literal>. + Returns &true; if warnings is turned on otherwise &false;. </para> <para> <function>fbsql_warnings</function> enables or disables FrontBase Index: phpdoc/en/functions/fdf.xml diff -u phpdoc/en/functions/fdf.xml:1.10 phpdoc/en/functions/fdf.xml:1.11 --- phpdoc/en/functions/fdf.xml:1.10 Wed May 16 14:33:20 2001 +++ phpdoc/en/functions/fdf.xml Sat Jul 7 14:42:26 2001 @@ -305,7 +305,7 @@ The <function>fdf_next_field_name</function> function returns the name of the field after the field in <parameter>fieldname</parameter> or the field name of the first field - if the second paramter is NULL.</para> + if the second paramter is &null;.</para> <para> See also <function>fdf_set_field</function>, Index: phpdoc/en/functions/filesystem.xml diff -u phpdoc/en/functions/filesystem.xml:1.72 phpdoc/en/functions/filesystem.xml:1.73 --- phpdoc/en/functions/filesystem.xml:1.72 Thu Jun 28 11:46:49 2001 +++ phpdoc/en/functions/filesystem.xml Sat Jul 7 14:42:26 2001 @@ -69,7 +69,7 @@ a file to any group of which that user is a member. </para> <para> - Returns true on success; otherwise returns false. + Returns &true; on success; otherwise returns &false;. </para> <para> See also <function>chown</function> and @@ -116,7 +116,7 @@ </informalexample> </para> <para> - Returns true on success and false otherwise. + Returns &true; on success and &false; otherwise. </para> <para> See also <function>chown</function> and @@ -149,7 +149,7 @@ user. Only the superuser may change the owner of a file. </para> <para> - Returns true on success; otherwise returns false. + Returns &true; on success; otherwise returns &false;. </para> <para> See also <function>chown</function> and @@ -227,8 +227,8 @@ </funcprototype> </funcsynopsis> <para> - Makes a copy of a file. Returns true if the copy succeeded, - false otherwise. + Makes a copy of a file. Returns &true; if the copy succeeded, + &false; otherwise. <example> <title><function>copy</function> example</title> <programlisting role="php"> @@ -382,7 +382,7 @@ The file pointed to by <parameter>fp</parameter> is closed. </para> <para> - Returns <literal>TRUE</literal> on success and <literal>FALSE</literal> + Returns &true; on success and &false; on failure. </para> <para> @@ -407,8 +407,8 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the file pointer is at EOF or an error occurs; - otherwise returns false. + Returns &true; if the file pointer is at EOF or an error occurs; + otherwise returns &false;. </para> <para> The file pointer must be valid, and must point to a file @@ -434,7 +434,7 @@ <para> This function forces a write of all buffered output to the to the resource pointed to by the file handle - <parameter>fp</parameter>. Returns true if succesful, false + <parameter>fp</parameter>. Returns &true; if succesful, &false; otherwise. </para> <para> @@ -460,7 +460,7 @@ </funcsynopsis> <para> Returns a string containing a single character read from the - file pointed to by fp. Returns FALSE on EOF. + file pointed to by fp. Returns &false; on EOF. </para> <para> The file pointer must be valid, and must point to a file @@ -513,12 +513,12 @@ CSV file (allowing for trailing line-end characters). </simpara> <simpara> - <function>fgetcsv</function> returns false on error, including + <function>fgetcsv</function> returns &false; on error, including end of file. </simpara> <simpara> N.B. A blank line in a CSV file will be returned as an array - comprising a single null field, and will not be treated as an + comprising a single &null; field, and will not be treated as an error. </simpara> <example> @@ -564,7 +564,7 @@ EOF (whichever comes first). </para> <para> - If an error occurs, returns false. + If an error occurs, returns &false;. </para> <para> Common Pitfalls: @@ -712,8 +712,8 @@ </funcprototype> </funcsynopsis> <simpara> - Returns true if the file specified by - <parameter>filename</parameter> exists; false otherwise. + Returns &true; if the file specified by + <parameter>filename</parameter> exists; &false; otherwise. </simpara> <simpara> This function will not work on <link @@ -742,7 +742,7 @@ </funcprototype> </funcsynopsis> <simpara> - Returns the time the file was last accessed, or false in case of + Returns the time the file was last accessed, or &false; in case of an error. The time is returned as a Unix timestamp. </simpara> <simpara> @@ -781,7 +781,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the time the file was last changed, or false in case of + Returns the time the file was last changed, or &false; in case of an error. The time is returned as a Unix timestamp. </para> <para> @@ -823,7 +823,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the group ID of the owner of the file, or false in case + Returns the group ID of the owner of the file, or &false; in case of an error. The group ID is returned in numerical format, use <function>posix_getgrgid</function> to resolve it to a group name. </para> @@ -858,7 +858,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the inode number of the file, or false in case of an + Returns the inode number of the file, or &false; in case of an error.</para> <para> The results of this function are cached. See @@ -891,7 +891,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the time the file was last modified, or false in case of + Returns the time the file was last modified, or &false; in case of an error. The time is returned as a Unix timestamp. </para> <para> @@ -926,7 +926,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the user ID of the owner of the file, or false in case of + Returns the user ID of the owner of the file, or &false; in case of an error. The user ID is returned in numerical format, use <function>posix_getpwuid</function> to resolve it to a username. </para> @@ -961,7 +961,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the permissions on the file, or false in case of an error. + Returns the permissions on the file, or &false; in case of an error. </para> <simpara> This function will not work on <link @@ -989,7 +989,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the size of the file, or false in case of an error. + Returns the size of the file, or &false; in case of an error. </para> <para> The results of this function are cached. See @@ -1018,7 +1018,7 @@ </funcsynopsis> <para> Returns the type of the file. Possible values are fifo, char, - dir, block, link, file, and unknown.</para> <para> Returns false + dir, block, link, file, and unknown.</para> <para> Returns &false; if an error occurs. </para> <para> @@ -1099,11 +1099,11 @@ <function>flock</function> allows you to perform a simple reader/writer model which can be used on virtually every platform (including most Unices and even Windows). The optional 3rd - argument is set to true if the lock would block (EWOULDBLOCK + argument is set to &true; if the lock would block (EWOULDBLOCK errno condition) </simpara> <simpara> - <function>flock</function> returns true on success and false on + <function>flock</function> returns &true; on success and &false; on error (e.g. when a lock could not be acquired). </simpara> <warning> @@ -1169,7 +1169,7 @@ the file opened is returned. </simpara> <simpara> - If the open fails, the function returns false. + If the open fails, the function returns &false;. </simpara> <para> <parameter>mode</parameter> may be any of the following: @@ -1285,7 +1285,7 @@ </simpara> <simpara> If an error occurs, <function>fpassthru</function> returns - false. + &false;. </simpara> <simpara> The file pointer must be valid, and must point to a file @@ -1572,7 +1572,7 @@ its offset into the file stream. </para> <para> - If an error occurs, returns false. + If an error occurs, returns &false;. </para> <para> The file pointer must be valid, and must point to a file @@ -1604,7 +1604,7 @@ </funcsynopsis> <para> Takes the filepointer, fp, and truncates the file to length, size. - This function returns true on success and false on failure. + This function returns &true; on success and &false; on failure. </para> </refsect1> </refentry> @@ -1727,7 +1727,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the filename exists and is a directory. + Returns &true; if the filename exists and is a directory. </para> <para> The results of this function are cached. See @@ -1759,7 +1759,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the filename exists and is executable. + Returns &true; if the filename exists and is executable. </para> <para> The results of this function are cached. See @@ -1793,7 +1793,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the filename exists and is a regular file. + Returns &true; if the filename exists and is a regular file. </para> <para> The results of this function are cached. See @@ -1822,7 +1822,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the filename exists and is a symbolic link. + Returns &true; if the filename exists and is a symbolic link. </para> <para> The results of this function are cached. See @@ -1861,7 +1861,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the filename exists and is readable. + Returns &true; if the filename exists and is readable. </para> <para> Keep in mind that PHP may be accessing the file as the user @@ -1897,7 +1897,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the filename exists and is writable. The + Returns &true; if the filename exists and is writable. The filename argument may be a directory name allowing you to check if a directory is writeable. </para> @@ -1960,7 +1960,7 @@ </para> <para> - Returns true if the file named by <varname>filename</varname> was + Returns &true; if the file named by <varname>filename</varname> was uploaded via HTTP POST. This is useful to help ensure that a malicious user hasn't tried to trick the script into working on files upon which it should not be working--for instance, @@ -2029,7 +2029,7 @@ UNIX C stat structure returned by the lstat system call. This function is used to verify if a link (pointed to by <parameter>path</parameter>) really exists (using the same method - as the S_ISLNK macro defined in stat.h). Returns 0 or FALSE in + as the S_ISLNK macro defined in stat.h). Returns 0 or &false; in case of error. </para> <para> @@ -2071,7 +2071,7 @@ </informalexample> </para> <para> - Returns true on success and false on failure. + Returns &true; on success and &false; on failure. </para> <para> See also <function>rmdir</function>. @@ -2111,14 +2111,14 @@ If <parameter>filename</parameter> is not a valid upload file, then no action will occur, and <function>move_uploaded_file</function> will return - <literal>false</literal>. + &false;. </para> <para> If <parameter>filename</parameter> is a valid upload file, but cannot be moved for some reason, no action will occur, and <function>move_uploaded_file</function> will return - <literal>false</literal>. Additionally, a warning will be issued. + &false;. Additionally, a warning will be issued. </para> <para> @@ -2249,7 +2249,7 @@ <function>fputs</function>. </para> <para> - If an error occurs, returns false. + If an error occurs, returns &false;. </para> <para> <informalexample> @@ -2287,7 +2287,7 @@ </para> <para> Returns the number of bytes read from the file. If an error - occurs, false is returned and unless the function was called as + occurs, &false; is returned and unless the function was called as @readfile, an error message is printed. </para> <para> @@ -2375,7 +2375,7 @@ <parameter>newname</parameter>. </para> <para> - Returns true on success and false on failure. + Returns &true; on success and &false; on failure. </para> </refsect1> </refentry> @@ -2472,7 +2472,7 @@ systems (i.e. Windows) return -1. </para> <para> - Returns <literal>FALSE</literal> in case of error. + Returns &false; in case of error. </para> <para> <function>stat</function> doesn't handle URL as does <function>fopen</function>. @@ -2627,7 +2627,7 @@ tempnam(3) function if in doubt. </para> <para> - Returns the new temporary filename, or the null string on + Returns the new temporary filename, or the &null; string on failure. <example> <title><function>tempnam</function> example</title> @@ -2709,7 +2709,7 @@ If the file does not exist, it is created. </para> <para> - Returns true on success and false otherwise. + Returns &true; on success and &false; otherwise. <example> <title><function>touch</function> example</title> <programlisting role="php"> @@ -2773,7 +2773,7 @@ unlink() function. </para> <para> - Returns 0 or FALSE on an error. + Returns 0 or &false; on an error. </para> <para> See also <function>rmdir</function> for removing directories. Index: phpdoc/en/functions/ftp.xml diff -u phpdoc/en/functions/ftp.xml:1.14 phpdoc/en/functions/ftp.xml:1.15 --- phpdoc/en/functions/ftp.xml:1.14 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/ftp.xml Sat Jul 7 14:42:26 2001 @@ -67,7 +67,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a FTP stream on success, false on error.</para> + Returns a FTP stream on success, &false; on error.</para> <para> <function>ftp_connect</function> opens up a FTP connection to the specified <parameter>host</parameter>. The <parameter>port</parameter> @@ -93,7 +93,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> Logs in the given FTP stream.</para> </refsect1> @@ -113,7 +113,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the current directory, or false on error.</para> + Returns the current directory, or &false; on error.</para> </refsect1> </refentry> @@ -131,7 +131,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> Changes to the parent directory.</para> </refsect1> @@ -152,7 +152,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> Changes to the specified <parameter>directory</parameter>.</para> </refsect1> @@ -173,7 +173,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the newly created directory name on success, false on error.</para> + Returns the newly created directory name on success, &false; on error.</para> <para> Creates the specified <parameter>directory</parameter>.</para> </refsect1> @@ -194,7 +194,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> Removes the specified <parameter>directory</parameter>.</para> </refsect1> @@ -215,7 +215,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an array of filenames on success, false on error.</para> + Returns an array of filenames on success, &false; on error.</para> </refsect1> </refentry> @@ -260,7 +260,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the remote system type, or false on error.</para> + Returns the remote system type, or &false; on error.</para> </refsect1> </refentry> @@ -279,11 +279,11 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> <function>ftp_pasv</function> turns on passive mode if the - <parameter>pasv</parameter> parameter is true (it turns off - passive mode if <parameter>pasv</parameter> is false.) In + <parameter>pasv</parameter> parameter is &true; (it turns off + passive mode if <parameter>pasv</parameter> is &false;.) In passive mode, data connections are initiated by the client, rather than by the server.</para> </refsect1> @@ -306,7 +306,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> <function>ftp_get</function> retrieves <parameter>remote_file</parameter> from the FTP server, and saves it to <parameter>local_file</parameter> @@ -335,7 +335,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> <function>ftp_fget</function> retrieves <parameter>remote_file</parameter> from the FTP server, and writes it to the given file pointer, @@ -361,7 +361,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> <function>ftp_put</function> stores <parameter>local_file</parameter> on the FTP server, as <parameter>remote_file</parameter>. The transfer @@ -396,7 +396,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> <function>ftp_fput</function> uploads the data from the file pointer <parameter>fp</parameter> until end of file. The results are stored @@ -476,7 +476,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> <function>ftp_rename</function> renames the file specified by <parameter>from</parameter> to the new name @@ -500,7 +500,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> <function>ftp_delete</function> deletes the file specified by <parameter>path</parameter> from the FTP server. @@ -523,7 +523,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> <function>ftp_site</function> sends the command specified by <parameter>cmd</parameter> to the FTP server. SITE commands Index: phpdoc/en/functions/funchand.xml diff -u phpdoc/en/functions/funchand.xml:1.13 phpdoc/en/functions/funchand.xml:1.14 --- phpdoc/en/functions/funchand.xml:1.13 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/funchand.xml Sat Jul 7 14:42:27 2001 @@ -173,9 +173,9 @@ } // create a bunch of math functions -$f1 = 'if ($a >=0) {return "b*a^2 = ".$b*sqrt($a);} else {return false;}'; +$f1 = 'if ($a >=0) {return "b*a^2 = ".$b*sqrt($a);} else {return &false;;}'; $f2 = "return \"min(b^2+a, a^2,b) = \".min(\$a*\$a+\$b,\$b*\$b+\$a);"; -$f3 = 'if ($a > 0 && $b != 0) {return "ln(a)/b = ".log($a)/$b;} else {return false;}'; +$f3 = 'if ($a > 0 && $b != 0) {return "ln(a)/b = ".log($a)/$b;} else {return &false;;}'; $farr = array( create_function('$x,$y', 'return "some trig: ".(sin($x) + $x*cos($y));'), create_function('$x,$y', 'return "a hypotenuse: ".sqrt($x*$x + $y*$y);'), @@ -287,7 +287,7 @@ <simpara> If <parameter>arg_num</parameter> is greater than the number of arguments actually passed, a warning will be generated and - <function>func_get_arg</function> will return FALSE. + <function>func_get_arg</function> will return &false;. </simpara> <para> <informalexample> @@ -429,7 +429,7 @@ <refnamediv> <refname>function_exists</refname> <refpurpose> - Return true if the given function has been defined + Return &true; if the given function has been defined </refpurpose> </refnamediv> <refsect1> @@ -442,8 +442,8 @@ </funcsynopsis> <para> Checks the list of defined functions for - <parameter>function_name</parameter>. Returns true if the given - function name was found, false otherwise. + <parameter>function_name</parameter>. Returns &true; if the given + function name was found, &false; otherwise. <informalexample> <programlisting role="php"> if (function_exists('imap_open')) { Index: phpdoc/en/functions/gettext.xml diff -u phpdoc/en/functions/gettext.xml:1.8 phpdoc/en/functions/gettext.xml:1.9 --- phpdoc/en/functions/gettext.xml:1.8 Fri Jul 6 18:50:40 2001 +++ phpdoc/en/functions/gettext.xml Sat Jul 7 14:42:27 2001 @@ -129,7 +129,7 @@ This function sets the domain to search within when calls are made to <function>gettext</function>, usually the named after an application. The previous default domain is returned. - Call it with NULL as parameter to get the current setting without + Call it with &null; as parameter to get the current setting without changing it. </para> </refsect1> Index: phpdoc/en/functions/gmp.xml diff -u phpdoc/en/functions/gmp.xml:1.10 phpdoc/en/functions/gmp.xml:1.11 --- phpdoc/en/functions/gmp.xml:1.10 Thu May 17 10:06:31 2001 +++ phpdoc/en/functions/gmp.xml Sat Jul 7 14:42:28 2001 @@ -590,8 +590,8 @@ </funcprototype> </funcsynopsis> <para> - Returns true if <parameter>a</parameter> is a perfect square, - false otherwise. + Returns &true; if <parameter>a</parameter> is a perfect square, + &false; otherwise. </para> <para> See also: <function>gmp_sqrt</function>, @@ -734,7 +734,7 @@ </funcsynopsis> <para> Computes the inverse of <parameter>a</parameter> modulo - <parameter>b</parameter>. Returns false if an inverse does not + <parameter>b</parameter>. Returns &false; if an inverse does not exist. </para> </refsect1> Index: phpdoc/en/functions/http.xml diff -u phpdoc/en/functions/http.xml:1.19 phpdoc/en/functions/http.xml:1.20 --- phpdoc/en/functions/http.xml:1.19 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/http.xml Sat Jul 7 14:42:28 2001 @@ -32,13 +32,13 @@ <para> The optional <parameter>replace</parameter> parameter indicates whether the header should replace a previous similar header, or add a second header - of the same type. By default it will replace, but if you pass in false as + of the same type. By default it will replace, but if you pass in &false; as the second argument you can force multiple headers of the same type. For example: <informalexample> <programlisting role="php"> header('www-authenticate: Negociate'); -header('www-authenticate: NTLM',false); +header('www-authenticate: NTLM',&false;); </programlisting> </informalexample> </para> @@ -114,7 +114,7 @@ <refentry id="function.headers-sent"> <refnamediv> <refname>headers_sent</refname> - <refpurpose>Returns true if headers have been sent</refpurpose> + <refpurpose>Returns &true; if headers have been sent</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -125,8 +125,8 @@ </funcprototype> </funcsynopsis> <para> - This function returns true if the HTTP headers have already been - sent, false otherwise. + This function returns &true; if the HTTP headers have already been + sent, &false; otherwise. </para> <para> See also <function>header</function> Index: phpdoc/en/functions/hw.xml diff -u phpdoc/en/functions/hw.xml:1.10 phpdoc/en/functions/hw.xml:1.11 --- phpdoc/en/functions/hw.xml:1.10 Thu May 17 23:23:13 2001 +++ phpdoc/en/functions/hw.xml Sat Jul 7 14:42:28 2001 @@ -448,8 +448,8 @@ </funcprototype> </funcsynopsis> <para> - Returns false if connection is not a valid connection index, - otherwise true. Closes down the connection to a Hyperwave server + Returns &false; if connection is not a valid connection index, + otherwise &true;. Closes down the connection to a Hyperwave server with the given connection index. </para> </refsect1> @@ -473,7 +473,7 @@ </funcsynopsis> <para> Opens a connection to a Hyperwave server and returns a connection - index on success, or false if the connection + index on success, or &false; if the connection could not be made. Each of the arguments should be a quoted string, except for the port number. The <parameter>username</parameter> and <parameter>password</parameter> arguments are @@ -538,7 +538,7 @@ parameter. It will delete all instances of the object. </para> <para> - Returns TRUE if no error occurs otherwise FALSE. + Returns &true; if no error occurs otherwise &false;. </para> <para> See also <function>hw_mv</function>. @@ -740,7 +740,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a string containing the last error message or 'No Error'. If false + Returns a string containing the last error message or 'No Error'. If &false; is returned, this function failed. The message relates to the last command. </para> @@ -1569,7 +1569,7 @@ the object record of the new document contains at least the attributes: Type, DocumentType, Title and Name. Possibly you also want to set the MimeType. The functions returns the - object id of the new document or false. + object id of the new document or &false;. </para> <para> See also <function>hw_pipedocument</function>. @@ -1802,7 +1802,7 @@ </note> </para> <para> - Returns TRUE if no error occurs otherwise FALSE. + Returns &true; if no error occurs otherwise &false;. </para> </refsect1> </refentry> @@ -1920,7 +1920,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a connection index on success, or false if the connection + Returns a connection index on success, or &false; if the connection could not be made. Opens a persistent connection to a Hyperwave server. Each of the arguments should be a quoted string, except for the port number. The <parameter>username</parameter> Index: phpdoc/en/functions/icap.xml diff -u phpdoc/en/functions/icap.xml:1.7 phpdoc/en/functions/icap.xml:1.8 --- phpdoc/en/functions/icap.xml:1.7 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/icap.xml Sat Jul 7 14:42:28 2001 @@ -28,7 +28,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an ICAP stream on success, false on error.</para> + Returns an ICAP stream on success, &false; on error.</para> <para> <function>icap_open</function> opens up an ICAP connection to the specified <parameter>calendar</parameter> store. If the optional @@ -91,7 +91,7 @@ </listitem> <listitem> <simpara> - int public - TRUE if the event if public, FALSE if it is private. + int public - &true; if the event if public, &false; if it is private. </simpara> </listitem> <listitem> @@ -320,7 +320,7 @@ </itemizedlist> </para> <para> - Returns true on success and false on error. + Returns &true; on success and &false; on error. </para> </refsect1> </refentry> @@ -344,7 +344,7 @@ specified by the <parameter>uid</parameter>. </para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> @@ -368,7 +368,7 @@ calendar event specified by the <parameter>uid</parameter>. </para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> Index: phpdoc/en/functions/iconv.xml diff -u phpdoc/en/functions/iconv.xml:1.2 phpdoc/en/functions/iconv.xml:1.3 --- phpdoc/en/functions/iconv.xml:1.2 Mon Jul 2 13:55:34 2001 +++ phpdoc/en/functions/iconv.xml Sat Jul 7 14:42:29 2001 @@ -41,7 +41,7 @@ It converts the string <parameter>string</parameter> encoded in <parameter>in_charset</parameter> to the string encoded in <parameter>out_charset</parameter>. It returns the converted - string or <literal>FALSE</literal>, if it fails. + string or &false;, if it fails. </para> <para> <example> @@ -74,7 +74,7 @@ <para> It returns the current settings of <function>ob_iconv_handler</function> as array or - <literal>FALSE</literal> in failure. + &false; in failure. </para> <para> See also: @@ -102,8 +102,8 @@ </funcsynopsis> <para> It changes the value of <parameter>type</parameter> to - <parameter>charset</parameter> and returns <literal>TRUE</literal> in success or - <literal>FALSE</literal> in failure. + <parameter>charset</parameter> and returns &true; in success or + &false; in failure. </para> <para> <example> Index: phpdoc/en/functions/ifx.xml diff -u phpdoc/en/functions/ifx.xml:1.12 phpdoc/en/functions/ifx.xml:1.13 --- phpdoc/en/functions/ifx.xml:1.12 Sat Feb 24 22:10:23 2001 +++ phpdoc/en/functions/ifx.xml Sat Jul 7 14:42:29 2001 @@ -41,7 +41,7 @@ INFORMIX bin directory is in the PATH. Check this by running a script that contains a call to <function>phpinfo()</function> before you start testing. The <function>phpinfo()</function> - output should list these environment variables. This is true for + output should list these environment variables. This is &true; for both CGI php and Apache mod_php. You may have to set these environment variables in your Apache startup script. </para> @@ -151,13 +151,13 @@ </para> </note> <note> - <title>NULL values</title> + <title>&null; values</title> <para> The configuration variable ifx.nullformat (and the runtime - function <function>ifx_nullformat</function>) when set to true - will return NULL columns as the string "NULL", when set to false + function <function>ifx_nullformat</function>) when set to &true; + will return &null; columns as the string "&null;", when set to &false; they return the empty string. This allows you to discriminate - between NULL columns and empty columns. + between &null; columns and empty columns. </para> </note> </partintro> @@ -181,7 +181,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a connection identifier on success, or FALSE on + Returns a connection identifier on success, or &false; on error. </para> <para> @@ -241,7 +241,7 @@ </funcsynopsis> <para> Returns: A positive Informix persistent link identifier on success, - or false on error + or &false; on error </para> <para> <function>ifx_pconnect</function> acts very much like @@ -286,7 +286,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: always true. + Returns: always &true;. </para> <para> <function>ifx_close</function> closes the link to an Informix @@ -344,7 +344,7 @@ </funcsynopsis> <para> Returns: A positive Informix result identifier on success, or - false on error. + &false; on error. </para> <para> A "result_id" resource used by other functions to retrieve the @@ -512,7 +512,7 @@ </funcprototype> </funcsynopsis> <para> - Returns TRUE on success, FALSE on error. + Returns &true; on success, &false; on error. </para> <para> Executes a previously prepared query or opens a cursor for it. @@ -750,13 +750,13 @@ </funcsynopsis> <para> Returns an associative array that corresponds to the fetched row, - or false if there are no more rows. + or &false; if there are no more rows. </para> <para> Blob columns are returned as integer blob id values for use in <function>ifx_get_blob</function> unless you have used ifx_textasvarchar(1) or ifx_byteasvarchar(1), in which case blobs - are returned as string values. Returns FALSE on error + are returned as string values. Returns &false; on error </para> <para> <parameter>result_id</parameter> is a valid resultid returned by @@ -778,7 +778,7 @@ </para> <para> Subsequent calls to <function>ifx_fetch_row</function> would - return the next row in the result set, or false if there are no + return the next row in the result set, or &false; if there are no more rows. </para> <example> @@ -831,7 +831,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the number of rows fetched or FALSE on error. + Returns the number of rows fetched or &false; on error. </para> <para> Formats all rows of the <parameter>result_id</parameter> query @@ -879,7 +879,7 @@ <para> Returns an associative array with fieldnames as key and the SQL fieldtypes as data for query with - <parameter>result_id</parameter>. Returns FALSE on error. + <parameter>result_id</parameter>. Returns &false; on error. </para> <example> <title>Fielnames and SQL fieldtypes</title> @@ -914,13 +914,13 @@ <para> Returns an associative array with fieldnames as key and the SQL fieldproperties as data for a query with - <parameter>result_id</parameter>. Returns FALSE on error. + <parameter>result_id</parameter>. Returns &false; on error. </para> <para> Returns the Informix SQL fieldproperies of every field in the query as an associative array. Properties are encoded as: - "SQLTYPE;length;precision;scale;ISNULLABLE" where SQLTYPE = the - Informix type like "SQLVCHAR" etc. and ISNULLABLE = "Y" or "N". + "SQLTYPE;length;precision;scale;ISnullABLE" where SQLTYPE = the + Informix type like "SQLVCHAR" etc. and ISnullABLE = "Y" or "N". </para> <example> <title>Informix SQL fieldproperties</title> @@ -954,7 +954,7 @@ </funcsynopsis> <para> Returns the number of columns in query for - <parameter>result_id</parameter> or FALSE on error + <parameter>result_id</parameter> or &false; on error </para> <para> After preparing or executing a query, this call gives you the @@ -1000,7 +1000,7 @@ </funcsynopsis> <para> Releases resources for the query associated with - <parameter>result_id</parameter>. Returns FALSE on error. + <parameter>result_id</parameter>. Returns &false; on error. </para> </refsect1> </refentry> @@ -1040,8 +1040,8 @@ </funcsynopsis> <para> Deletes the charobject for the given char object-id - <parameter>bid</parameter>. Returns FALSE on error otherwise - TRUE. + <parameter>bid</parameter>. Returns &false; on error otherwise + &true;. </para> </refsect1> </refentry> @@ -1063,7 +1063,7 @@ <para> Updates the content of the char object for the given char object <parameter>bid</parameter>. <parameter>content</parameter> is a - string with new data. Returns FALSE on error otherwise TRUE. + string with new data. Returns &false; on error otherwise &true;. </para> </refsect1> </refentry> @@ -1118,7 +1118,7 @@ if mode = 1: pointer to the filestring. </para> <para> - Return FALSE on error, otherwise the new blob object-id. + Return &false; on error, otherwise the new blob object-id. </para> </refsect1> </refentry> @@ -1141,7 +1141,7 @@ the ID of the blob object. </para> <para> - Returns FALSE on error otherwise the new blob object-id. + Returns &false; on error otherwise the new blob object-id. </para> </refsect1> </refentry> @@ -1161,8 +1161,8 @@ </funcsynopsis> <para> Deletes the blobobject for the given blob object-id - <parameter>bid</parameter>. Returns FALSE on error otherwise - TRUE. + <parameter>bid</parameter>. Returns &false; on error otherwise + &true;. </para> </refsect1> </refentry> @@ -1204,7 +1204,7 @@ <para> Updates the content of the blob object for the given blob object <parameter>bid</parameter>. <parameter>content</parameter> is a - string with new data. Returns FALSE on error otherwise TRUE. + string with new data. Returns &false; on error otherwise &true;. </para> </refsect1> </refentry> @@ -1288,8 +1288,8 @@ </funcprototype> </funcsynopsis> <para> - Sets the default return value of a NULL-value on a fetch row. - Mode "0" returns "", and mode "1" returns "NULL". + Sets the default return value of a &null;-value on a fetch row. + Mode "0" returns "", and mode "1" returns "&null;". </para> </refsect1> </refentry> @@ -1311,7 +1311,7 @@ Creates an slob object and opens it. Modes: 1 = LO_RDONLY, 2 = LO_WRONLY, 4 = LO_APPEND, 8 = LO_RDWR, 16 = LO_BUFFER, 32 = LO_NOBUFFER -> or-mask. You can also use constants named - IFX_LO_RDONLY, IFX_LO_WRONLY etc. Return FALSE on error otherwise + IFX_LO_RDONLY, IFX_LO_WRONLY etc. Return &false; on error otherwise the new slob object-id. </para> </refsect1> @@ -1332,7 +1332,7 @@ </funcsynopsis> <para> Deletes the slob object. <parameter>bid</parameter> is the Id of - the slob object. Returns FALSE on error otherwise TRUE. + the slob object. Returns &false; on error otherwise &true;. </para> </refsect1> </refentry> @@ -1352,8 +1352,8 @@ </funcsynopsis> <para> Deletes the slob object on the given slob object-id - <parameter>bid</parameter>. Return FALSE on error otherwise - TRUE. + <parameter>bid</parameter>. Return &false; on error otherwise + &true;. </para> </refsect1> </refentry> @@ -1376,7 +1376,7 @@ Opens an slob object. <parameter>bid</parameter> should be an existing slob id. Modes: 1 = LO_RDONLY, 2 = LO_WRONLY, 4 = LO_APPEND, 8 = LO_RDWR, 16 = LO_BUFFER, 32 = LO_NOBUFFER -> - or-mask. Returns FALSE on error otherwise the new slob + or-mask. Returns &false; on error otherwise the new slob object-id. </para> </refsect1> @@ -1398,7 +1398,7 @@ <para> Returns the current file or seek position of an open slob object <parameter>bid</parameter> should be an existing slob id. Return - FALSE on error otherwise the seek position. + &false; on error otherwise the seek position. </para> </refsect1> </refentry> @@ -1422,7 +1422,7 @@ Sets the current file or seek position of an open slob object. <parameter>bid</parameter> should be an existing slob id. Modes: 0 = LO_SEEK_SET, 1 = LO_SEEK_CUR, 2 = LO_SEEK_END and - <parameter>offset</parameter> is an byte offset. Return FALSE on + <parameter>offset</parameter> is an byte offset. Return &false; on error otherwise the seek position. </para> </refsect1> @@ -1445,7 +1445,7 @@ <para> Reads nbytes of the slob object. <parameter>bid</parameter> is a existing slob id and <parameter>nbytes</parameter> is the number - of bytes zu read. Return FALSE on error otherwise the string. + of bytes zu read. Return &false; on error otherwise the string. </para> </refsect1> </refentry> @@ -1467,7 +1467,7 @@ <para> Writes a string into the slob object. <parameter>bid</parameter> is a existing slob id and <parameter>content</parameter> the - content to write. Return FALSE on error otherwise bytes written. + content to write. Return &false; on error otherwise bytes written. </para> </refsect1> </refentry> Index: phpdoc/en/functions/image.xml diff -u phpdoc/en/functions/image.xml:1.44 phpdoc/en/functions/image.xml:1.45 --- phpdoc/en/functions/image.xml:1.44 Tue Jun 12 20:01:10 2001 +++ phpdoc/en/functions/image.xml Sat Jul 7 14:42:29 2001 @@ -88,7 +88,7 @@ <para> If accessing the <parameter>filename</parameter> image is impossible, or if it isn't a valid picture, <function>getimagesize</function> - will return <literal>NULL</literal> and generate a warning. + will return &null; and generate a warning. </para> <para> The optional <parameter>imageinfo</parameter> parameter allows @@ -143,7 +143,7 @@ </funcsynopsis> <para> <function>ImageAlphaBlending</function> allows for two different - modes of drawing on truecolor images. In blending mode, the + modes of drawing on &true;color images. In blending mode, the alpha channel component of the color supplied to all drawing function, such as <function>ImageSetPixel</function> determines how much of the underlying color shouldbe allowed to shine through. As a result, gd @@ -152,7 +152,7 @@ non-blending mode, the drawing color is copied literally with its alpha channel information, replacing the destination pixel. Blending mode is not available when drawing on palette images. - If <parameter>blendmode</parameter> is true, then blending mode is enabled, otherwise + If <parameter>blendmode</parameter> is &true;, then blending mode is enabled, otherwise disabled. </para> <note><para>This function was added in PHP 4.0.6 and requires GD 2.0.1</para></note> @@ -1069,8 +1069,8 @@ <refentry id="function.imagecreatetruecolor"> <refnamediv> - <refname>ImageCreateTrueColor</refname> - <refpurpose>Create a new true color image</refpurpose> + <refname>ImageCreatetrueColor</refname> + <refpurpose>Create a new &true; color image</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1082,7 +1082,7 @@ </funcprototype> </funcsynopsis> <para> - <function>ImageCreateTrueColor</function> returns an image identifier + <function>ImageCreatetrueColor</function> returns an image identifier representing a black image of size <parameter>x_size</parameter> by <parameter>y_size</parameter>. </para> @@ -1091,8 +1091,8 @@ <refentry id="function.imagetruecolortopalette"> <refnamediv> - <refname>ImageTrueColorToPalette</refname> - <refpurpose>Convert a true color image to a palette image</refpurpose> + <refname>ImagetrueColorToPalette</refname> + <refpurpose>Convert a &true; color image to a palette image</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1105,18 +1105,18 @@ </funcprototype> </funcsynopsis> <para> - <function>ImageTrueColorToPalette</function> converts a truecolor image + <function>ImagetrueColorToPalette</function> converts a &true;color image to a palette image. The code for this function was originally drawn from the Independent JPEG Group library code, which is excellent. The code has been modified to preserve as much alpha channel information as possible in the resulting palette, in addition to preserving colors as well as possible. This does not work as well as might be hoped. It is - usually best to simply produce a truecolor output image instead, which + usually best to simply produce a &true;color output image instead, which guarantees the highest output quality. </para> <para> <parameter>dither</parameter> indicates if the image should be dithered - - if it is true then dithering will be used which will result in a more + if it is &true; then dithering will be used which will result in a more speckled image but with better color approximation. </para> <para> @@ -2061,7 +2061,7 @@ <para> In the case everything went right, a valid font index will be returned and can be used for further purposes. Otherwise the - function returns false and prints a message describing what went + function returns &false; and prints a message describing what went wrong. </para> <para> @@ -2141,7 +2141,7 @@ <para> In the case everything went right, a valid font index will be returned and can be used for further purposes. Otherwise the - function returns false and prints a message describing what went + function returns &false; and prints a message describing what went wrong. </para> <para> @@ -2688,7 +2688,7 @@ </funcsynopsis> <para> This function calculates and returns the bounding box in pixels - for a TrueType text. + for a &true;Type text. <variablelist> <varlistentry> <term> @@ -2712,7 +2712,7 @@ </term> <listitem> <simpara> - The name of the TrueType font file. (Can also be an URL.) + The name of the &true;Type font file. (Can also be an URL.) </simpara> </listitem> </varlistentry> @@ -2787,7 +2787,7 @@ <refnamediv> <refname>ImageTTFText</refname> <refpurpose> - Write text to the image using TrueType fonts + Write text to the image using &true;Type fonts </refpurpose> </refnamediv> <refsect1> @@ -2811,7 +2811,7 @@ <parameter>im</parameter>, starting at coordinates <parameter>x</parameter>, <parameter>y</parameter> (top left is 0, 0), at an angle of <parameter>angle</parameter> in color - <parameter>col</parameter>, using the TrueType font file + <parameter>col</parameter>, using the &true;Type font file identified by <parameter>fontfile</parameter>. </para> <para> @@ -2828,7 +2828,7 @@ of 90 would result in bottom-to-top reading text). </para> <para> - <parameter>Fontfile</parameter> is the path to the TrueType font + <parameter>Fontfile</parameter> is the path to the &true;Type font you wish to use. </para> <para> Index: phpdoc/en/functions/imap.xml diff -u phpdoc/en/functions/imap.xml:1.43 phpdoc/en/functions/imap.xml:1.44 --- phpdoc/en/functions/imap.xml:1.43 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/imap.xml Sat Jul 7 14:42:29 2001 @@ -161,7 +161,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on sucess, false on error. + Returns &true; on sucess, &false; on error. </para> <para> <function>imap_append</function> appends a string message to the @@ -316,7 +316,7 @@ </funcprototype> </funcsynopsis> <para> - Returns information about the current mailbox. Returns FALSE on + Returns information about the current mailbox. Returns &false; on failure. </para> <para> @@ -440,7 +440,7 @@ international characters should be encoded by <function>imap_utf7_encode</function> </para> <para> - Returns true on success and false on error. + Returns &true; on success and &false; on error. </para> <para> See also <function>imap_renamemailbox</function>, @@ -521,7 +521,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true. + Returns &true;. </para> <para> <function>imap_delete</function> function marks message pointed @@ -577,7 +577,7 @@ of <parameter>mbox</parameter> names). </para> <para> - Returns true on success and false on error. + Returns &true; on success and &false; on error. </para> <para> See also <function>imap_createmailbox</function>, @@ -636,7 +636,7 @@ <function>imap_setflag_full</function>. </para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> @@ -909,7 +909,7 @@ </row> <row> <entry>ifsubtype</entry> - <entry>True if there is a subtype string</entry> + <entry>&true; if there is a subtype string</entry> </row> <row> <entry>subtype</entry> @@ -917,7 +917,7 @@ </row> <row> <entry>ifdescription</entry> - <entry>True if there is a description string</entry> + <entry>&true; if there is a description string</entry> </row> <row> <entry>description</entry> @@ -925,7 +925,7 @@ </row> <row> <entry>ifid</entry> - <entry>True if there is an identification string</entry> + <entry>&true; if there is an identification string</entry> </row> <row> <entry>id</entry> @@ -941,7 +941,7 @@ </row> <row> <entry>ifdisposition</entry> - <entry>True if there is a disposition string</entry> + <entry>&true; if there is a disposition string</entry> </row> <row> <entry>disposition</entry> @@ -949,7 +949,7 @@ </row> <row> <entry>ifdparameters</entry> - <entry>True if the dparameters array exists</entry> + <entry>&true; if the dparameters array exists</entry> </row> <row> <entry>dparameters</entry> @@ -957,7 +957,7 @@ </row> <row> <entry>ifparameters</entry> - <entry>True if the parameters array exists</entry> + <entry>&true; if the parameters array exists</entry> </row> <row> <entry>parameters</entry> @@ -1052,7 +1052,7 @@ Returns an array with integer values limit and usage for the given mailbox. The value of limit represents the total amount of space allowed for this mailbox. The usage value represents the mailboxes - current level of capacity. Will return FALSE in the case of failure. + current level of capacity. Will return &false; in the case of failure. </para> <para> This function is currently only available to users of the c-client2000 @@ -1599,7 +1599,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success and false on error. + Returns &true; on success and &false; on error. </para> <para> Copies mail messages specified by <parameter>msglist</parameter> @@ -1661,7 +1661,7 @@ </itemizedlist> </para> <para> - Returns true on success and false on error. + Returns &true; on success and &false; on error. </para> </refsect1> </refentry> @@ -1680,7 +1680,7 @@ </funcprototype> </funcsynopsis> <para> - Returns information about the current mailbox. Returns FALSE on + Returns information about the current mailbox. Returns &false; on failure. </para> <para> @@ -1904,7 +1904,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an IMAP stream on success and false on error. This + Returns an IMAP stream on success and &false; on error. This function can also be used to open streams to POP3 and NNTP servers, but some functions and features are not available on IMAP servers. @@ -1993,7 +1993,7 @@ echo "<p><h1>Mailboxes</h1>\n"; $folders = imap_listmailbox ($mbox, "{your.imap.host:143}", "*"); -if ($folders == false) { +if ($folders == &false;) { echo "Call failed<br>\n"; } else { while (list ($key, $val) = each ($folders)) { @@ -2004,7 +2004,7 @@ echo "<p><h1>Headers in INBOX</h1>\n"; $headers = imap_headers ($mbox); -if ($headers == false) { +if ($headers == &false;) { echo "Call failed<br>\n"; } else { while (list ($key,$val) = each ($headers)) { @@ -2033,7 +2033,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the stream is still alive, false otherwise. + Returns &true; if the stream is still alive, &false; otherwise. </para> <para> <function>imap_ping</function> function pings the stream to see @@ -2096,7 +2096,7 @@ <parameter>mbox</parameter> names). </para> <para> - Returns true on success and false on error. + Returns &true; on success and &false; on error. </para> <para> See also <function>imap_createmailbox</function>, @@ -2158,7 +2158,7 @@ </itemizedlist> </para> <para> - Returns true on success and false on error. + Returns &true; on success and &false; on error. </para> </refsect1> </refentry> @@ -2519,7 +2519,7 @@ the <parameter>quota_root</parameter>. </para> <para> - Returns true on success and false on error. + Returns &true; on success and &false; on error. </para> <para> <example> @@ -2751,7 +2751,7 @@ Subscribe to a new mailbox. </para> <para> - Returns true on success and false on error. + Returns &true; on success and &false; on error. </para> </refsect1> </refentry> @@ -2805,7 +2805,7 @@ <function>imap_mail_move</function>. </para> <para> - Returns true on success and false on error. + Returns &true; on success and &false; on error. </para> </refsect1> </refentry> @@ -2828,7 +2828,7 @@ Unsubscribe from a specified mailbox. </para> <para> - Returns true on success and false on error. + Returns &true; on success and &false; on error. </para> </refsect1> </refentry> @@ -2852,7 +2852,7 @@ Decodes modified UTF-7 <parameter>text</parameter> into 8bit data. </para> <para> - Returns the decoded 8bit data, or false if the input string was + Returns the decoded 8bit data, or &false; if the input string was not valid modified UTF-7. This function is needed to decode mailbox names that contain international characters outside of the printable ASCII range. The modified UTF-7 encoding is defined Index: phpdoc/en/functions/info.xml diff -u phpdoc/en/functions/info.xml:1.53 phpdoc/en/functions/info.xml:1.54 --- phpdoc/en/functions/info.xml:1.53 Wed Jun 27 01:44:14 2001 +++ phpdoc/en/functions/info.xml Sat Jul 7 14:42:30 2001 @@ -5,7 +5,7 @@ <refentry id="function.assert"> <refnamediv> <refname>assert</refname> - <refpurpose>Checks if assertion is FALSE</refpurpose> + <refpurpose>Checks if assertion is &false;</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -18,7 +18,7 @@ <para> <function>assert</function> will check the given <parameter>assertion</parameter> and take appropriate - action if its result is <literal>FALSE</literal>. + action if its result is &false;. </para> <para> If the <parameter>assertion</parameter> is given as a string it @@ -31,7 +31,7 @@ <para> Assertions should be used as a debugging feature only. You may use them for sanity-checks that test for conditions that should - always be <literal>TRUE</literal> and that indicate some programming errors if not + always be &true; and that indicate some programming errors if not or to check for the presence of certain features like extension functions or certain system limits and features. </para> @@ -157,7 +157,7 @@ <row> <entry>ASSERT_CALLBACK</entry> <entry>assert_callback</entry> - <entry>(null)</entry> + <entry>(&null;)</entry> <entry>user function to call on failed assertions</entry> </row> </tbody> @@ -165,7 +165,7 @@ </table> <para> <function>assert_options</function> will return the original - setting of any option or <literal>FALSE</literal> on errors. + setting of any option or &false; on errors. </para> </refsect1> </refentry> @@ -184,7 +184,7 @@ </funcprototype> </funcsynopsis> <simpara> - Returns <literal>TRUE</literal> if the extension identified by + Returns &true; if the extension identified by <parameter>name</parameter> is loaded. You can see the names of various extensions by using <function>phpinfo</function>. </simpara> @@ -236,7 +236,7 @@ </funcsynopsis> <para> Returns the value of the environment variable - <parameter>varname</parameter>, or <literal>FALSE</literal> on an error. + <parameter>varname</parameter>, or &false; on an error. <informalexample> <programlisting> $ip = getenv ("REMOTE_ADDR"); // get the ip number of the user @@ -279,7 +279,7 @@ </funcsynopsis> <simpara> Returns the current value of the PHP configuration variable - specified by <parameter>varname</parameter>, or <literal>FALSE</literal> if an error + specified by <parameter>varname</parameter>, or &false; if an error occurs. </simpara> <simpara> @@ -396,7 +396,7 @@ <para> Returns the time of the last modification of the current page. The value returned is a Unix timestamp, suitable for - feeding to <function>date</function>. Returns <literal>FALSE</literal> on error. + feeding to <function>date</function>. Returns &false; on error. <example> <title>getlastmod() example</title> <programlisting role="php"> @@ -429,7 +429,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the current script's inode, or <literal>FALSE</literal> on error. + Returns the current script's inode, or &false; on error. </para> <para> See also <function>getmyuid</function>, @@ -459,7 +459,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the current PHP process ID, or <literal>FALSE</literal> on error. + Returns the current PHP process ID, or &false; on error. </para> <warning> <para> @@ -491,7 +491,7 @@ </funcprototype> </funcsynopsis> <simpara> - Returns the user ID of the current script, or <literal>FALSE</literal> on error. + Returns the user ID of the current script, or &false; on error. </simpara> <simpara> See also <function>getmypid</function>, @@ -555,7 +555,7 @@ </funcsynopsis> <para> Changes the value of a configuration option, returns - <literal>FALSE</literal> on failure, and the previous value of the + &false; on failure, and the previous value of the configuration option on success. </para> <note> @@ -586,7 +586,7 @@ </funcsynopsis> <para> Returns the value of the configuration option on success, - <literal>FALSE</literal> on failure. + &false; on failure. </para> <para> See also <function>ini_alter</function>, @@ -636,7 +636,7 @@ </funcsynopsis> <para> Sets the value of the given configuration option. Returns the old - value on success, <literal>FALSE</literal> on failure. The configuration + value on success, &false; on failure. The configuration option will keep this new value during the script's execution, and will be restored at the script's ending. </para> @@ -718,12 +718,12 @@ </row> <row> <entry>error_append_string</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>error_prepend_string</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_ALL</entry> </row> <row> @@ -773,7 +773,7 @@ </row> <row> <entry>output_handler</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry> </row> <row> @@ -818,17 +818,17 @@ </row> <row> <entry>auto_append_file</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>auto_prepend_file</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>doc_root</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> @@ -843,7 +843,7 @@ </row> <row> <entry>error_log</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_ALL</entry> </row> <row> @@ -868,7 +868,7 @@ </row> <row> <entry>open_basedir</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> @@ -893,17 +893,17 @@ </row> <row> <entry>upload_tmp_dir</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> <entry>user_dir</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> <entry>variables_order</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_ALL</entry> </row> <row> @@ -913,12 +913,12 @@ </row> <row> <entry>browscap</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_SYSTEM</entry> </row> <row> <entry>error_reporting</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_ALL</entry> </row> <row> @@ -933,7 +933,7 @@ </row> <row> <entry>sendmail_from</entry> - <entry>NULL</entry> + <entry>&null;</entry> <entry>PHP_INI_ALL</entry> </row> <row> @@ -1493,7 +1493,7 @@ [E_USER_WARNING] => 512 [E_USER_NOTICE] => 1024 [E_ALL] => 2047 - [TRUE] => 1 + [&true;] => 1 ) </programlisting> </informalexample> Index: phpdoc/en/functions/ingres_ii.xml diff -u phpdoc/en/functions/ingres_ii.xml:1.2 phpdoc/en/functions/ingres_ii.xml:1.3 --- phpdoc/en/functions/ingres_ii.xml:1.2 Sun Jun 24 11:27:21 2001 +++ phpdoc/en/functions/ingres_ii.xml Sat Jul 7 14:42:30 2001 @@ -59,7 +59,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a Ingres II link resource on success, or false on failure. + Returns a Ingres II link resource on success, or &false; on failure. </para> <para> <function>ingres_connect</function> opens a connection with the @@ -136,7 +136,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a Ingres II link resource on success, or false on failure. + Returns a Ingres II link resource on success, or &false; on failure. </para> <para> See <function>ingres_connect</function> for parameters details and @@ -176,7 +176,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, or false on failure. + Returns &true; on success, or &false; on failure. </para> <para> <function>ingres_close</function> closes the connection to @@ -215,7 +215,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, or false on failure. + Returns &true; on success, or &false; on failure. </para> <para> <function>ingres_query</function> sends the given @@ -331,7 +331,7 @@ </simpara> <simpara> You should instead retrieve the result's data using one of these - fetch functions in a loop until it returns false, indicating that + fetch functions in a loop until it returns &false;, indicating that no more results are available. </simpara> </note> @@ -398,7 +398,7 @@ </funcsynopsis> <para> <function>ingres_field_name</function> returns the name of a field - in a query result, or false on failure. + in a query result, or &false; on failure. </para> <para> <parameter>index</parameter> is the number of the field and must be @@ -435,7 +435,7 @@ </funcsynopsis> <para> <function>ingres_field_type</function> returns the type of a field - in a query result, or false on failure. + in a query result, or &false; on failure. Examples of types returned are "IIAPI_BYTE_TYPE", "IIAPI_CHA_TYPE", "IIAPI_DTE_TYPE", "IIAPI_FLT_TYPE", "IIAPI_INT_TYPE", "IIAPI_VCH_TYPE". Some of these types can map @@ -462,7 +462,7 @@ <refentry id="function.ingres-field-nullable"> <refnamediv> <refname>ingres_field_nullable</refname> - <refpurpose>Test if a field is nullable.</refpurpose> + <refpurpose>Test if a field is &null;able.</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -478,8 +478,8 @@ </funcprototype> </funcsynopsis> <para> - <function>ingres_field_nullable</function> returns true if the field - can be set to the NULL value and false if it can't. + <function>ingres_field_nullable</function> returns &true; if the field + can be set to the &null; value and &false; if it can't. </para> <para> <parameter>index</parameter> is the number of the field and must be @@ -631,7 +631,7 @@ </funcsynopsis> <para> <function>ingres_fetch_array</function> Returns an array that corresponds - to the fetched row, or false if there are no more rows. + to the fetched row, or &false; if there are no more rows. </para> <para> This function is an extended version of @@ -709,12 +709,12 @@ </funcsynopsis> <para> <function>ingres_fetch_row</function> returns an array that corresponds - to the fetched row, or false if there are no more rows. Each result + to the fetched row, or &false; if there are no more rows. Each result column is stored in an array offset, starting at offset 1. </para> <para> Subsequent call to <function>ingres_fetch_row</function> would - return the next row in the result set, or false if there are no + return the next row in the result set, or &false; if there are no more rows. </para> <para> @@ -763,7 +763,7 @@ </funcsynopsis> <para> <function>ingres_fetch_object</function> Returns an object that - corresponds to the fetched row, or false if there are no more rows. + corresponds to the fetched row, or &false; if there are no more rows. </para> <para> This function is similar to Index: phpdoc/en/functions/ircg.xml diff -u phpdoc/en/functions/ircg.xml:1.1 phpdoc/en/functions/ircg.xml:1.2 --- phpdoc/en/functions/ircg.xml:1.1 Fri Jun 8 17:18:24 2001 +++ phpdoc/en/functions/ircg.xml Sat Jul 7 14:42:30 2001 @@ -178,7 +178,7 @@ </para> <para> Setting the optional parameter <parameter>suppress</parameter> to - a true value will suppress output of your message to your own + a &true; value will suppress output of your message to your own <parameter>connection</parameter>. </para> </refsect1> @@ -236,7 +236,7 @@ <parameter>nick</parameter> if possible. </para> <para> - Will return true on success and false on failure. + Will return &true; on success and &false; on failure. </para> </refsect1> </refentry> @@ -476,9 +476,9 @@ </funcprototype> </funcsynopsis> <para> - <function>ircg_is_conn_alive</function> returns true if + <function>ircg_is_conn_alive</function> returns &true; if <parameter>connection</parameter> is still alive and working or - false if the server no longer talks to us. + &false; if the server no longer talks to us. </para> </refsect1> </refentry> Index: phpdoc/en/functions/java.xml diff -u phpdoc/en/functions/java.xml:1.5 phpdoc/en/functions/java.xml:1.6 --- phpdoc/en/functions/java.xml:1.5 Tue Jun 26 10:08:25 2001 +++ phpdoc/en/functions/java.xml Sat Jul 7 14:42:31 2001 @@ -49,7 +49,7 @@ $frame->add("North", $button); $frame->validate(); $frame->pack(); - $frame->visible = True; + $frame->visible = &true;; $thread = new Java("java.lang.Thread"); $thread->sleep(10000); @@ -87,7 +87,7 @@ </listitem> <listitem> <para> - Exceptions raised result in PHP warnings, and null results. The + Exceptions raised result in PHP warnings, and &null; results. The warnings may be eliminated by prefixing the method call with an "@" sign. The following APIs may be used to retrieve and reset the last error: Index: phpdoc/en/functions/ldap.xml diff -u phpdoc/en/functions/ldap.xml:1.26 phpdoc/en/functions/ldap.xml:1.27 --- phpdoc/en/functions/ldap.xml:1.26 Sun Jun 3 11:00:29 2001 +++ phpdoc/en/functions/ldap.xml Sat Jul 7 14:42:31 2001 @@ -216,7 +216,7 @@ </funcprototype> </funcsynopsis> <para> - returns true on success and false on error. + returns &true; on success and &false; on error. </para><para> The <function>ldap_add</function> function is used to add entries in the LDAP directory. The DN of the entry to be added is @@ -279,7 +279,7 @@ </funcsynopsis> <para> Binds to the LDAP directory with specified RDN and - password. Returns true on success and false on error.</para> + password. Returns &true; on success and &false; on error.</para> <para> <function>ldap_bind</function> does a bind operation on the directory. bind_rdn and bind_password are optional. If not @@ -302,7 +302,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error.</para> + Returns &true; on success, &false; on error.</para> <para> <function>ldap_close</function> closes the link to the LDAP server that's associated with the specified @@ -333,7 +333,7 @@ </funcprototype> </funcsynopsis> <simpara> - Returns true if <parameter>value</parameter> matches otherwise returns false. Returns -1 on error. + Returns &true; if <parameter>value</parameter> matches otherwise returns &false;. Returns -1 on error. </simpara> <para> <function>ldap_compare</function> is used to compare <parameter>value</parameter> @@ -366,9 +366,9 @@ if ($r === -1) { echo "Error: ".ldap_error($ds); - } elseif ($r === TRUE) { + } elseif ($r === &true;) { echo "Password correct."; - } elseif ($r === FALSE) { + } elseif ($r === &false;) { echo "Wrong guess! Password incorrect."; } @@ -414,7 +414,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a positive LDAP link identifier on success, or false on + Returns a positive LDAP link identifier on success, or &false; on error.</para> <para> <function>ldap_connect</function> establishes a connection to a @@ -449,7 +449,7 @@ </funcprototype> </funcsynopsis> <para> - Returns number of entries in the result or false on error.</para> + Returns number of entries in the result or &false; on error.</para> <para> <function>ldap_count_entries</function> returns the number of entries stored in the result of previous search @@ -474,7 +474,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success and false on error.</para> + Returns &true; on success and &false; on error.</para> <para> <function>ldap_delete</function> function delete a particular entry in LDAP directory specified by dn.</para> @@ -680,7 +680,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the first attribute in the entry on success and false on + Returns the first attribute in the entry on success and &false; on error. </para> <para> @@ -718,7 +718,7 @@ </funcsynopsis> <para> Returns the result entry identifier for the first entry on - success and false on error.</para> + success and &false; on error.</para> <para> Entries in the LDAP result are read sequentially using the <function>ldap_first_entry</function> and @@ -748,7 +748,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success and false on error.</para> + Returns &true; on success and &false; on error.</para> <para> <function>ldap_free_result</function> frees up the memory allocated internally to store the result and pointed by the @@ -781,7 +781,7 @@ </funcsynopsis> <para> Returns a complete entry information in a multi-dimensional array - on success and false on error.</para> + on success and &false; on error.</para> <para> <function>ldap_get_attributes</function> function is used to simplify reading the attributes and values from an entry in the @@ -849,7 +849,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the DN of the result entry and false on error.</para> + Returns the DN of the result entry and &false; on error.</para> <para> <function>ldap_get_dn</function> function is used to find out the DN of an entry in the result.</para> @@ -873,7 +873,7 @@ </funcsynopsis> <para> Returns a complete result information in a multi-dimenasional - array on success and false on error.</para> + array on success and &false; on error.</para> <para> <function>ldap_get_entries</function> function is used to simplify reading multiple entries from the result and then @@ -926,7 +926,7 @@ </funcsynopsis> <para> Sets <parameter>retval</parameter> to the value of the specified option, - and returns true on success and false on error.</para> + and returns &true; on success and &false; on error.</para> <para> The parameter <parameter>option</parameter> can be one of: LDAP_OPT_DEREF, LDAP_OPT_SIZELIMIT, LDAP_OPT_TIMELIMIT, @@ -973,7 +973,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an array of values for the attribute on success and false + Returns an array of values for the attribute on success and &false; on error.</para> <para> <function>ldap_get_values</function> function is used to read all @@ -1046,7 +1046,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an array of values for the attribute on success and false + Returns an array of values for the attribute on success and &false; on error.</para> <para> <function>ldap_get_values_len</function> function is used to read all @@ -1099,7 +1099,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a search result identifier or false on error.</para> + Returns a search result identifier or &false; on error.</para> <para> <function>ldap_list</function> performs the search for a specified filter on the directory with the scope LDAP_SCOPE_ONELEVEL.</para> @@ -1162,7 +1162,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success and false on error.</para> + Returns &true; on success and &false; on error.</para> <para> <function>ldap_modify</function> function is used to modify the existing entries in the LDAP directory. The structure of the @@ -1187,7 +1187,7 @@ </funcprototype> </funcsynopsis> <para> - returns true on success and false on error.</para> + returns &true; on success and &false; on error.</para> <para> This function adds attribute(s) to the specified dn. It performs the modification at the attribute level as opposed to the @@ -1212,7 +1212,7 @@ </funcprototype> </funcsynopsis> <para> - returns true on success and false on error.</para> + returns &true; on success and &false; on error.</para> <para> This function removes attribute(s) from the specified dn. It performs the modification at the attribute level as opposed to the @@ -1237,7 +1237,7 @@ </funcprototype> </funcsynopsis> <para> - returns true on success and false on error.</para> + returns &true; on success and &false; on error.</para> <para> This function replaces attribute(s) from the specified dn. It performs the modification at the attribute level as opposed to the @@ -1262,7 +1262,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the next attribute in an entry on success and false on + Returns the next attribute in an entry on success and &false; on error.</para> <para> <function>ldap_next_attribute</function> is called to retrieve @@ -1296,7 +1296,7 @@ Returns entry identifier for the next entry in the result whose entries are being read starting with <function>ldap_first_entry</function>. If there are no more - entries in the result then it returns false.</para> + entries in the result then it returns &false;.</para> <para> <function>ldap_next_entry</function> function is used to retrieve the entries stored in the result. Successive calls to the @@ -1341,7 +1341,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a search result identifier or false on error.</para> + Returns a search result identifier or &false; on error.</para> <para> <function>ldap_read</function> performs the search for a specified filter on the directory with the scope @@ -1396,10 +1396,10 @@ The new RDN is specified by <parameter>newrdn</parameter> and the new parent/superior entry is specified by <parameter>newparent</parameter>. If the parameter - <parameter>deleteoldrdn</parameter> is true the old RDN value(s) + <parameter>deleteoldrdn</parameter> is &true; the old RDN value(s) is removed, else the old RDN value(s) is retained as - non-distinguished values of the entry. True is returned on - success and false is returned on error.</para> + non-distinguished values of the entry. &true; is returned on + success and &false; is returned on error.</para> <para>This function is only available when using OpenLDAP 2.x.x OR Netscape Directory SDK x.x, and was added in PHP 4.0.5.</para> </refsect1> @@ -1437,7 +1437,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a search result identifier or false on error.</para> + Returns a search result identifier or &false; on error.</para> <para> <function>ldap_search</function> performs the search for a specified filter on the directory with the scope of @@ -1559,10 +1559,10 @@ used for one search, the second entries are used for another, and so on. When doing parallel searches an array of search result identifiers is returned, except in case of error, then the entry - corresponding to the search will be false. This is very much like + corresponding to the search will be &false;. This is very much like the value normally returned, except that a result identifier is always returned when a search was made. There are some rare cases where the - normal search returns false while the parallel search returns an + normal search returns &false; while the parallel search returns an identifier. </para> </refsect1> @@ -1586,7 +1586,7 @@ </funcsynopsis> <para> Sets the value of the specified option to be - <parameter>newval</parameter>, and returns true on success and false + <parameter>newval</parameter>, and returns &true; on success and &false; on error.</para> <para> The parameter <parameter>option</parameter> can be one of: @@ -1611,7 +1611,7 @@ and string value, and two optional elements. The optional elements are key <emphasis>value</emphasis> with string value and key <emphasis>iscritical</emphasis> with boolean value. - <emphasis>iscritical</emphasis> defaults to <emphasis>FALSE</emphasis> + <emphasis>iscritical</emphasis> defaults to <emphasis>&false;</emphasis> if not supplied. See also the second example below.</para> <para> This function is only available when using @@ -1633,8 +1633,8 @@ <programlisting role="php"> // $ds is a valid link identifier for a directory server // control with no value -$ctrl1 = array("oid" => "1.2.752.58.10.1", "iscritical" => TRUE); -// iscritical defaults to FALSE +$ctrl1 = array("oid" => "1.2.752.58.10.1", "iscritical" => &true;); +// iscritical defaults to &false; $ctrl2 = array("oid" => "1.2.752.58.1.10", "value" => "magic"); // try to set both controls if (!ldap_set_option($ds, LDAP_OPT_SERVER_CONTROLS, array($ctrl1, $ctrl2))) @@ -1662,7 +1662,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success and false on error.</para> + Returns &true; on success and &false; on error.</para> <para> <function>ldap_unbind</function> function unbinds from the LDAP directory.</para> Index: phpdoc/en/functions/mail.xml diff -u phpdoc/en/functions/mail.xml:1.22 phpdoc/en/functions/mail.xml:1.23 --- phpdoc/en/functions/mail.xml:1.22 Sat Jul 7 04:36:54 2001 +++ phpdoc/en/functions/mail.xml Sat Jul 7 14:42:31 2001 @@ -43,8 +43,8 @@ >http://www.rfc-editor.org/</ulink>). </simpara> <para> - <function>mail</function> returns <literal>TRUE</literal> if the mail - is sucessfully sent, <literal>FALSE</literal> otherwise. + <function>mail</function> returns &true; if the mail + is sucessfully sent, &false; otherwise. </para> <para> <example> Index: phpdoc/en/functions/mbstring.xml diff -u phpdoc/en/functions/mbstring.xml:1.3 phpdoc/en/functions/mbstring.xml:1.4 --- phpdoc/en/functions/mbstring.xml:1.3 Thu Jun 28 23:20:28 2001 +++ phpdoc/en/functions/mbstring.xml Sat Jul 7 14:42:31 2001 @@ -557,10 +557,10 @@ <para> Return Value: If <parameter>language</parameter> is set and <parameter>language</parameter> is valid, it returns - TRUE. Otherwise, it returns FALSE. When + &true;. Otherwise, it returns &false;. When <parameter>language</parameter> is omitted, it returns language name as string. If no language is set previously, it returns - FALSE. + &false;. </para> <para> See also <function>mb_send_mail</function>. @@ -606,7 +606,7 @@ character encoding converted values. </para> <para> - Return Value: It returns TRUE for success or FALSE for failure. + Return Value: It returns &true; for success or &false; for failure. </para> <para> See also <function>mb_detect_order</function>, @@ -649,8 +649,8 @@ <para> Return Value: If <parameter>encoding</parameter> is set,<function>mb_internal_encoding</function> returns - <literal>TRUE</literal> for success, otherwise returns - <literal>FALSE</literal>. If <parameter>encoding</parameter> is + &true; for success, otherwise returns + &false;. If <parameter>encoding</parameter> is omitted, it returns current character encoding name. </para> <para> @@ -701,7 +701,7 @@ <para> Return Value: Character encoding name. If <function>mb_http_input</function> does not process specified - HTTP input, it returns FALSE. + HTTP input, it returns &false;. </para> <para> See also <function>mb_internal_encoding</function>, @@ -732,7 +732,7 @@ encoding to <parameter>encoding</parameter>. Output after this function is converted to <parameter>encoding</parameter>. <function>mb_http_output</function> returns - <literal>TRUE</literal> for success and <literal>FALSE</literal> + &true; for success and &false; for failure. </para> <para> @@ -768,8 +768,8 @@ <para> <function>mb_detect_order</function> sets automatic character encoding detection order to <parameter>encoding-list</parameter>. - It returns <literal>TRUE</literal> for success, - <literal>FALSE</literal> for failure. + It returns &true; for success, + &false; for failure. </para> <para> <parameter>encoding-list</parameter> is array or comma separated @@ -866,7 +866,7 @@ <function>mb_substitute_character</function> specifies substitution character when input character encoding is invalid or character code is not exist in output character - encoding. Invalid characters may be substituted null(no output), + encoding. Invalid characters may be substituted &null;(no output), string or integer value (Unicode character code value). </para> <para> @@ -892,8 +892,8 @@ </para> <para> Return Value: If <parameter>substchar</parameter> is set, it - returns <literal>TRUE</literal> for success, otherwise returns - <literal>FALSE</literal>. If <parameter>substchar</parameter> is + returns &true; for success, otherwise returns + &false;. If <parameter>substchar</parameter> is not set, it returns Unicode value or "<literal>none</literal>"/"<literal>long</literal>". </para> @@ -1082,7 +1082,7 @@ <function>mb_strpos</function> returns the numeric position of the first occurrence of <parameter>needle</parameter> in the <parameter>haystack</parameter> string. If - <parameter>needle</parameter> is not found, it returns FALSE. + <parameter>needle</parameter> is not found, it returns &false;. </para> <para> <function>mb_strpos</function> performs multi-byte safe @@ -1138,7 +1138,7 @@ <function>mb_strrpos</function> returns the numeric position of the last occurrence of <parameter>needle</parameter> in the <parameter>haystack</parameter> string. If - <parameter>needle</parameter> is not found, it returns FALSE. + <parameter>needle</parameter> is not found, it returns &false;. </para> <para> <function>mb_strrpos</function> performs multi-byte safe @@ -1661,7 +1661,7 @@ character encoding of variables <parameter>vars</parameter> in encoding <parameter>from-encoding</parameter> to encoding <parameter>to-encoding</parameter>. It returns character encoding - before conversion for success, FALSE for failure. + before conversion for success, &false; for failure. </para> <para> <function>mb_convert_variables</function> join strings in Array @@ -1882,8 +1882,8 @@ header when using sendmail. </para> <para> - It returns <literal>TRUE</literal> for success, otherwise it - returns <literal>FALSE</literal>. + It returns &true; for success, otherwise it + returns &false;. </para> <para> See also: <function>mb_language</function>, Index: phpdoc/en/functions/mcal.xml diff -u phpdoc/en/functions/mcal.xml:1.20 phpdoc/en/functions/mcal.xml:1.21 --- phpdoc/en/functions/mcal.xml:1.20 Mon Jul 2 06:46:40 2001 +++ phpdoc/en/functions/mcal.xml Sat Jul 7 14:42:31 2001 @@ -144,7 +144,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an MCAL stream on success, false on error. + Returns an MCAL stream on success, &false; on error. </para> <para> <function>mcal_open</function> opens up an MCAL connection to the @@ -173,7 +173,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an MCAL stream on success, false on error. + Returns an MCAL stream on success, &false; on error. </para> <para> <function>mcal_popen</function> opens up an MCAL connection to the @@ -320,7 +320,7 @@ <listitem><simpara> int id - ID of that event.</simpara></listitem> <listitem><simpara> - int public - TRUE if the event if public, FALSE if it is + int public - &true; if the event if public, &false; if it is private.</simpara></listitem> <listitem><simpara> string category - Category string of the event.</simpara></listitem> @@ -460,7 +460,7 @@ to the current global event for the given stream. </para> <para> - Returns the event id of the modified event on success and false on error. + Returns the event id of the modified event on success and &false; on error. </para> </refsect1> </refentry> @@ -484,7 +484,7 @@ <function>mcal_delete_event</function> deletes the calendar event specified by the event_id.</para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> @@ -507,7 +507,7 @@ calendar event specified by the id. </para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> @@ -581,7 +581,7 @@ structure to 0, or the default settings. </para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> @@ -607,7 +607,7 @@ global event structure's category to the given string. </para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> @@ -633,7 +633,7 @@ event structure's title to the given string. </para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> @@ -661,7 +661,7 @@ global event structure's description to the given string. </para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> @@ -708,7 +708,7 @@ event structure's start date and time to the given values. </para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> @@ -755,7 +755,7 @@ event structure's end date and time to the given values. </para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> @@ -781,7 +781,7 @@ event structure's alarm to the given minutes before the event. </para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> @@ -808,7 +808,7 @@ for public, or 0 for private. </para> <para> - Returns true. + Returns &true;. </para> </refsect1> </refentry> @@ -864,7 +864,7 @@ <refnamediv> <refname>mcal_date_valid</refname> <refpurpose> - Returns true if the given year, month, day is a valid date + Returns &true; if the given year, month, day is a valid date </refpurpose> </refnamediv> <refsect1> @@ -878,8 +878,8 @@ </funcprototype> </funcsynopsis> <para> - <function>mcal_date_valid</function> Returns true if the given - year, month and day is a valid date, false if not. + <function>mcal_date_valid</function> Returns &true; if the given + year, month and day is a valid date, &false; if not. </para> </refsect1> </refentry> @@ -888,7 +888,7 @@ <refnamediv> <refname>mcal_time_valid</refname> <refpurpose> - Returns true if the given year, month, day is a valid time + Returns &true; if the given year, month, day is a valid time </refpurpose> </refnamediv> <refsect1> @@ -902,8 +902,8 @@ </funcprototype> </funcsynopsis> <para> - <function>mcal_time_valid</function> Returns true if the given - hour, minutes and seconds is a valid time, false if not. + <function>mcal_time_valid</function> Returns &true; if the given + hour, minutes and seconds is a valid time, &false; if not. </para> </refsect1> </refentry> @@ -1207,7 +1207,7 @@ <listitem><simpara> int id - ID of that event.</simpara></listitem> <listitem><simpara> - int public - TRUE if the event if public, FALSE if it is + int public - &true; if the event if public, &false; if it is private.</simpara></listitem> <listitem><simpara> string category - Category string of the event.</simpara></listitem> Index: phpdoc/en/functions/mcrypt.xml diff -u phpdoc/en/functions/mcrypt.xml:1.17 phpdoc/en/functions/mcrypt.xml:1.18 --- phpdoc/en/functions/mcrypt.xml:1.17 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/mcrypt.xml Sat Jul 7 14:42:32 2001 @@ -389,7 +389,7 @@ <function>mcrypt_get_cipher_name</function> takes the cipher number as an argument (libmcrypt 2.2.x) or takes the cipher name as an argument (libmcrypt 2.4.x) and returns the name of the cipher - or false, if the cipher does not exist. + or &false;, if the cipher does not exist. </para> <para> <example> @@ -916,7 +916,7 @@ <para> <function>mcrypt_get_iv_size</function> returns the size of the Initialisation Vector (IV) in bytes. On error the function - returns FALSE. If the IV is ignored in the specified cipher/mode + returns &false;. If the IV is ignored in the specified cipher/mode combination zero is returned. </para> <para> @@ -1091,7 +1091,7 @@ <function>mcrypt_module_close</function>, but there is no need to call that function if <function>mcrypt_generic_end</function> is called. Normally it returns an encryption descriptor, or - FALSE on error. + &false; on error. </para> <para> The <parameter>algorithm_directory</parameter> and @@ -1239,7 +1239,7 @@ <para> This function terminates encryption specified by the encryption descriptor (td). Actually it clears all buffers, and closes - all the modules used. Returns FALSE on error, or TRUE on succes. + all the modules used. Returns &false; on error, or &true; on succes. </para> </refsect1> </refentry> @@ -1469,7 +1469,7 @@ the location of where the algorithm module is on the system. </para> <para> - The function returns TRUE if the self test succeeds, or FALSE when + The function returns &true; if the self test succeeds, or &false; when if fails. </para> </refsect1> @@ -1490,7 +1490,7 @@ </funcprototype> </funcsynopsis> <para> - This function returns TRUE if the mode is for use with block algorithms, + This function returns &true; if the mode is for use with block algorithms, otherwise it returns 0. (eg. 0 for stream, and 1 for cbc, cfb, ofb). The optional <parameter>lib_dir</parameter> parameter can contain the location where the mode module is on the system. @@ -1513,8 +1513,8 @@ </funcprototype> </funcsynopsis> <para> - This function returns TRUE if the specified algorithm is a block - algorithm, or FALSE is it is a stream algorithm. + This function returns &true; if the specified algorithm is a block + algorithm, or &false; is it is a stream algorithm. The optional <parameter>lib_dir</parameter> parameter can contain the location where the algorithm module is on the system. </para> @@ -1536,8 +1536,8 @@ </funcprototype> </funcsynopsis> <para> - This function returns TRUE if the mode outputs blocks of bytes or - FALSE if it outputs just bytes. (eg. 1 for cbc and ecb, and 0 for cfb + This function returns &true; if the mode outputs blocks of bytes or + &false; if it outputs just bytes. (eg. 1 for cbc and ecb, and 0 for cfb and stream). The optional <parameter>lib_dir</parameter> parameter can contain the location where the mode module is on the system. </para> Index: phpdoc/en/functions/mhash.xml diff -u phpdoc/en/functions/mhash.xml:1.13 phpdoc/en/functions/mhash.xml:1.14 --- phpdoc/en/functions/mhash.xml:1.13 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/mhash.xml Sat Jul 7 14:42:32 2001 @@ -128,7 +128,7 @@ </para> <para> <function>mhash_get_hash_name</function> takes the hash id as an - argument and returns the name of the hash or false, if the hash + argument and returns the name of the hash or &false;, if the hash does not exist. </para> <para> @@ -170,7 +170,7 @@ <para> <function>mhash_get_block_size</function> takes one argument, the <parameter>hash</parameter> and returns the size in bytes or - false, if the <parameter>hash</parameter> does not exist. + &false;, if the <parameter>hash</parameter> does not exist. </para> </refsect1> </refentry> @@ -234,7 +234,7 @@ is specified it will return the resulting HMAC. HMAC is keyed hashing for message authentication, or simply a message digest that depends on the specified key. Not all algorithms supported in mhash can be used in - HMAC mode. In case of an error returns false. + HMAC mode. In case of an error returns &false;. </para> </refsect1> </refentry> Index: phpdoc/en/functions/ming.xml diff -u phpdoc/en/functions/ming.xml:1.12 phpdoc/en/functions/ming.xml:1.13 --- phpdoc/en/functions/ming.xml:1.12 Sun Jun 24 11:27:21 2001 +++ phpdoc/en/functions/ming.xml Sat Jul 7 14:42:32 2001 @@ -3539,7 +3539,7 @@ <listitem> <simpara> Start dragging the movie clip target. The lock argument indicates whether - to lock the mouse (?)- use 0 (false) or 1 (true). Optional parameters + to lock the mouse (?)- use 0 (&false;) or 1 (&true;). Optional parameters define a bounding area for the dragging. </simpara> </listitem> Index: phpdoc/en/functions/misc.xml diff -u phpdoc/en/functions/misc.xml:1.48 phpdoc/en/functions/misc.xml:1.49 --- phpdoc/en/functions/misc.xml:1.48 Sun Jun 24 07:45:37 2001 +++ phpdoc/en/functions/misc.xml Sat Jul 7 14:42:32 2001 @@ -12,7 +12,7 @@ <refentry id="function.connection-aborted"> <refnamediv> <refname>connection_aborted</refname> - <refpurpose>Returns true if client disconnected</refpurpose> + <refpurpose>Returns &true; if client disconnected</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -23,7 +23,7 @@ </funcprototype> </funcsynopsis> <simpara> - Returns true if client disconnected. See the <link + Returns &true; if client disconnected. See the <link linkend="features.connection-handling">Connection Handling</link> description in the <link linkend="features">Features</link> chapter for a complete explanation. @@ -56,7 +56,7 @@ <refentry id="function.connection-timeout"> <refnamediv> <refname>connection_timeout</refname> - <refpurpose>Return true if script timed out</refpurpose> + <refpurpose>Return &true; if script timed out</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -67,7 +67,7 @@ </funcprototype> </funcsynopsis> <simpara> - Returns true if script timed out. + Returns &true; if script timed out. </simpara> <warning> <title>Deprecated</title> @@ -164,7 +164,7 @@ <para> The optional third parameter <parameter>case_insensitive</parameter> is also available. If the - value <constant>TRUE</constant> is given, then the constant will be + value &true; is given, then the constant will be defined case-insensitive. The default behaviour is case-sensitive; i.e. CONSTANT and Constant represent different values. @@ -178,7 +178,7 @@ echo CONSTANT; // outputs "Hello world." echo Constant; // outputs "Constant" and issues a notice. -define ("GREETING", "Hello you.",TRUE); +define ("GREETING", "Hello you.",&true;); echo GREETING; // outputs "Hello you." echo Greeting; // outputs "Hello you." @@ -187,8 +187,8 @@ </example> </para> <para> - <function>define</function> returns <constant>TRUE</constant> - on success and <constant>FALSE</constant> if + <function>define</function> returns &true; + on success and &false; if an error occurs. </para> <para> @@ -215,9 +215,9 @@ </funcprototype> </funcsynopsis> <para> - Returns <constant>TRUE</constant> if the named constant given by + Returns &true; if the named constant given by <parameter>name</parameter> has been defined, - <constant>FALSE</constant> otherwise. + &false; otherwise. <example> <title>Checking Constants</title> <programlisting role="php"> @@ -424,7 +424,7 @@ <simpara> The information is returned in an object, which will contain various data elements representing, for instance, the browser's - major and minor version numbers and ID string; true/false values + major and minor version numbers and ID string; &true;/&false; values for features such as frames, JavaScript, and cookies; and so forth. </simpara> @@ -669,7 +669,7 @@ <simpara> This function parses a binary IPTC block into its single tags. It returns an array using the tagmarker as an index and the value as - the value. It returns false on error or if no IPTC data was + the value. It returns &false; on error or if no IPTC data was found. See <function>GetImageSize</function> for a sample. </simpara> </refsect1> @@ -882,7 +882,7 @@ The <function>show_source</function> function prints out a syntax higlighted version of the code contained in <parameter>filename</parameter> using the colors defined in the built-in syntax highlighter for PHP. - It returns true on success, false otherwise (PHP 4). + It returns &true; on success, &false; otherwise (PHP 4). </simpara> <simpara> This function is an alias for the function @@ -953,7 +953,7 @@ characters long. </simpara> <simpara> - If the optional <parameter>lcg</parameter> parameter is true, + If the optional <parameter>lcg</parameter> parameter is &true;, <function>uniqid</function> will add additional "combined LCG" entropy at the end of the return value, which should make the results more unique. @@ -961,7 +961,7 @@ <simpara> With an empty <parameter>prefix</parameter>, the returned string will be 13 characters long. If <parameter>lcg</parameter> is - true, it will be 23 characters. + &true;, it will be 23 characters. </simpara> <note> <simpara> Index: phpdoc/en/functions/mnogosearch.xml diff -u phpdoc/en/functions/mnogosearch.xml:1.15 phpdoc/en/functions/mnogosearch.xml:1.16 --- phpdoc/en/functions/mnogosearch.xml:1.15 Tue Jun 26 04:38:34 2001 +++ phpdoc/en/functions/mnogosearch.xml Sat Jul 7 14:42:32 2001 @@ -62,7 +62,7 @@ </funcprototype> </funcsynopsis> <para> - <function>udm_add_search_limit</function> returns <literal>TRUE</literal> on success, <literal>FALSE</literal> on error. Adds search restrictions. + <function>udm_add_search_limit</function> returns &true; on success, &false; on error. Adds search restrictions. </para> <para> <parameter>agent</parameter> - a link to Agent, received after call to <function>udm_alloc_agent</function>. @@ -145,7 +145,7 @@ </funcprototype> </funcsynopsis> <para><function>udm_alloc_agent</function> returns mnogosearch agent -identifier on success, <literal>FALSE</literal> on error. This function creates a +identifier on success, &false; on error. This function creates a session with database parameters.</para> <para><parameter>dbaddr</parameter> - URL-style database description. Options (type, host, database name, port, user and password) to connect to SQL database. @@ -350,7 +350,7 @@ </funcsynopsis> <para> - <function>udm_clear_search_limits</function> resets defined search limitations and returns <literal>TRUE</literal>. + <function>udm_clear_search_limits</function> resets defined search limitations and returns &true;. </para> </refsect1> </refentry> @@ -431,7 +431,7 @@ </funcsynopsis> <para> - <function>udm_find</function> returns result link identifier on success, <literal>FALSE</literal> on error. + <function>udm_find</function> returns result link identifier on success, &false; on error. </para> <para> @@ -497,7 +497,7 @@ </funcsynopsis> <para> - <function>udm_free_agent</function> returns <literal>TRUE</literal> on success, <literal>FALSE</literal> on error. + <function>udm_free_agent</function> returns &true; on success, &false; on error. </para> <para> <parameter>agent</parameter> - link to agent identifier, received after call to <function>udm_alloc_agent</function>. @@ -526,7 +526,7 @@ </funcsynopsis> <para> - <function>udm_free_ispell_data</function> always returns <literal>TRUE</literal>. + <function>udm_free_ispell_data</function> always returns &true;. </para> <para> @@ -558,7 +558,7 @@ </funcsynopsis> <para> - <function>udm_free_res</function> returns <literal>TRUE</literal> on success, <literal>FALSE</literal> on error. + <function>udm_free_res</function> returns &true; on success, &false; on error. </para> <para> @@ -622,7 +622,7 @@ </funcsynopsis> <para> - <function>udm_get_res_field</function> returns result field value on success, <literal>FALSE</literal> on error. + <function>udm_get_res_field</function> returns result field value on success, &false; on error. </para> <para> @@ -726,7 +726,7 @@ </funcsynopsis> <para> - <function>udm_get_res_param</function> returns result parameter value on success, <literal>FALSE</literal> on error. + <function>udm_get_res_param</function> returns result parameter value on success, &false; on error. </para> <para> @@ -794,7 +794,7 @@ </funcsynopsis> <para> - <function>udm_load_ispell_data</function> loads ispell data. Returns <literal>TRUE</literal> on success, <literal>FALSE</literal> on error. + <function>udm_load_ispell_data</function> loads ispell data. Returns &true; on success, &false; on error. </para> <para> @@ -811,7 +811,7 @@ <para> The fastest mode is UDM_ISPELL_TYPE_SERVER. UDM_ISPELL_TYPE_TEXT is slower - and UDM_ISPELL_TYPE_DB is the slowest. The above pattern is true for mnoGoSearch 3.1.10 - 3.1.11. + and UDM_ISPELL_TYPE_DB is the slowest. The above pattern is &true; for mnoGoSearch 3.1.10 - 3.1.11. It is planned to speed up DB mode in future versions and it is going to be faster than TEXT mode. </para> @@ -827,7 +827,7 @@ <parameter>flag</parameter> indicates that after loading ispell data from defined source it sould be sorted (it is necessary for correct functioning of ispell). In case of loading ispell data from files there may be several calls to <function>udm_load_ispell_data</function>, and there is no sense to sort data after every call, but only after the last one. Since in db mode all the data is loaded by one call, this parameter should have the value <literal>1</literal>. - In this mode in case of error, e.g. if ispell tables are absent, the function will return <literal>FALSE</literal> and code and error message will be accessible through <function>udm_error</function> and <function>udm_errno</function>. + In this mode in case of error, e.g. if ispell tables are absent, the function will return &false; and code and error message will be accessible through <function>udm_error</function> and <function>udm_errno</function>. </para> </note> @@ -847,7 +847,7 @@ In this case <parameter>val1</parameter> defines double letter language code for which affixes are loaded, and <parameter>val2</parameter> - file path. Please note, that if a relative path entered, the module looks for the file not in UDM_CONF_DIR, but in relation to current path, i.e. to the path where the script is executed. - In case of error in this mode, e.g. if file is absent, the function will return <literal>FALSE</literal>, and an error message will be displayed. + In case of error in this mode, e.g. if file is absent, the function will return &false;, and an error message will be displayed. Error message text cannot be accessed through <function>udm_error</function> and <function>udm_errno</function>, since those functions can only return messages associated with SQL. Please, see <parameter>flag</parameter> parameter description in UDM_ISPELL_TYPE_DB. </para> @@ -875,7 +875,7 @@ In this case <parameter>val1</parameter> defines double letter language code for which affixes are loaded, and <parameter>val2</parameter> - file path. Please note, that if a relative path entered, the module looks for the file not in UDM_CONF_DIR, but in relation to current path, i.e. to the path where the script is executed. - In case of error in this mode, e.g. if file is absent, the function will return <literal>FALSE</literal>, and an error message will be displayed. + In case of error in this mode, e.g. if file is absent, the function will return &false;, and an error message will be displayed. Error message text cannot be accessed through <function>udm_error</function> and <function>udm_errno</function>, since those functions can only return messages associated with SQL. Please, see <parameter>flag</parameter> parameter description in UDM_ISPELL_TYPE_DB. </para> @@ -960,8 +960,8 @@ </funcsynopsis> <para> - <function>udm_set_agent_param</function> returns <literal>TRUE</literal> on success, - <literal>FALSE</literal> on error. Defines mnoGoSearch session parameters. + <function>udm_set_agent_param</function> returns &true; on success, + &false; on error. Defines mnoGoSearch session parameters. </para> <simpara> Index: phpdoc/en/functions/msql.xml diff -u phpdoc/en/functions/msql.xml:1.8 phpdoc/en/functions/msql.xml:1.9 --- phpdoc/en/functions/msql.xml:1.8 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/msql.xml Sat Jul 7 14:42:33 2001 @@ -32,7 +32,7 @@ </funcsynopsis> <para> Returns a positive mSQL query identifier to the query result, or - false on error. + &false; on error. </para> <para> <function>msql</function> selects a database and executes a query @@ -84,7 +84,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error. + Returns &true; on success, &false; on error. </para> <para> <function>msql_close</function> closes the link to a mSQL @@ -141,7 +141,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a positive mSQL link identifier on success, or false on + Returns a positive mSQL link identifier on success, or &false; on error. </para> <para> @@ -229,7 +229,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on failure. + Returns &true; on success, &false; on failure. </para> <para> <function>msql_data_seek</function> moves the internal row @@ -283,7 +283,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on failure. + Returns &true; on success, &false; on failure. </para> <para> <function>msql_drop_db</function> attempts to drop (remove) an @@ -347,7 +347,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an array that corresponds to the fetched row, or false if + Returns an array that corresponds to the fetched row, or &false; if there are no more rows. </para> <para> @@ -364,7 +364,7 @@ <para> Be careful if you are retrieving results from a query that may return a record that contains only one field that has a value of - 0 (or an empty string, or NULL). + 0 (or an empty string, or &null;). </para> <para> An important thing to note is that using @@ -417,7 +417,7 @@ </listitem> <listitem> <simpara> - not_null - 1 if the column cannot be null + not_null - 1 if the column cannot be &null; </simpara> </listitem> <listitem> @@ -461,7 +461,7 @@ </funcsynopsis> <para> Returns an object with properties that correspond to the fetched - row, or false if there are no more rows. + row, or &false; if there are no more rows. </para> <para> <function>msql_fetch_object</function> is similar to @@ -502,7 +502,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an array that corresponds to the fetched row, or false if + Returns an array that corresponds to the fetched row, or &false; if there are no more rows. </para> <para> @@ -513,7 +513,7 @@ </para> <para> Subsequent call to <function>msql_fetch_row</function> would - return the next row in the result set, or false if there are no + return the next row in the result set, or &false; if there are no more rows. </para> <para> @@ -635,7 +635,7 @@ </funcsynopsis> <para> <function>msql_fieldflags</function> returns the field flags of - the specified field. Currently this is either, "not null", + the specified field. Currently this is either, "not &null;", "primary key", a combination of the two or "" (an empty string). </para> </refsect1> @@ -938,7 +938,7 @@ </funcsynopsis> <para> Returns a positive mSQL persistent link identifier on success, or - false on error. + &false; on error. </para> <para> <function>msql_pconnect</function> acts very much like @@ -985,7 +985,7 @@ <function>msql_connect</function> was called, and use it. </para> <para> - Returns a positive mSQL query identifier on success, or false on + Returns a positive mSQL query identifier on success, or &false; on error. </para> <para> @@ -1070,7 +1070,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error. + Returns &true; on success, &false; on error. </para> <para> <function>msql_select_db</function> sets the current active Index: phpdoc/en/functions/mssql.xml diff -u phpdoc/en/functions/mssql.xml:1.12 phpdoc/en/functions/mssql.xml:1.13 --- phpdoc/en/functions/mssql.xml:1.12 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/mssql.xml Sat Jul 7 14:42:33 2001 @@ -18,7 +18,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: true on success, false on error. + Returns: &true; on success, &false; on error. </para> <para> <function>mssql_close</function> closes the link to a MS SQL @@ -64,7 +64,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: A positive MS SQL link identifier on success, or false + Returns: A positive MS SQL link identifier on success, or &false; on error. </para> <para> @@ -105,7 +105,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: true on success, false on failure. + Returns: &true; on success, &false; on failure. </para> <para> <function>mssql_data_seek</function> moves the internal row @@ -133,7 +133,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: An array that corresponds to the fetched row, or false + Returns: An array that corresponds to the fetched row, or &false; if there are no more rows. </para> <para> @@ -227,7 +227,7 @@ </funcsynopsis> <para> Returns: An object with properties that correspond to the fetched - row, or false if there are no more rows. + row, or &false; if there are no more rows. </para> <para> <function>mssql_fetch_object</function> is similar to @@ -263,7 +263,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: An array that corresponds to the fetched row, or false + Returns: An array that corresponds to the fetched row, or &false; if there are no more rows. </para> <para> @@ -274,7 +274,7 @@ </para> <para> Subsequent call to <function>mssql_fetch_rows</function> would - return the next row in the result set, or false if there are no + return the next row in the result set, or &false; if there are no more rows. </para> <para> @@ -470,8 +470,8 @@ This function will test for additional results available form the server. if an additional result set exists it will free the existing result set and prepare to fetch the wors from the new result set. - The function will return <literal>TRUE</literal> if an additional result set was - available or <literal>FALSE</literal> othervise. + The function will return &true; if an additional result set was + available or &false; othervise. </para> <example> <title><function>mssql_next_result</function> example</title> @@ -567,7 +567,7 @@ </funcsynopsis> <para> Returns: A positive MS SQL persistent link identifier on success, - or false on error. + or &false; on error. </para> <para> <function>mssql_pconnect</function> acts very much like @@ -608,7 +608,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: A positive MS SQL result identifier on success, or false + Returns: A positive MS SQL result identifier on success, or &false; on error. </para> <para> @@ -684,7 +684,7 @@ </paramdef> </funcprototype> </funcsynopsis> - <para> Returns: true on success, false on error + <para> Returns: &true; on success, &false; on error </para> <para> <function>mssql_select_db</function> sets the current active Index: phpdoc/en/functions/mysql.xml diff -u phpdoc/en/functions/mysql.xml:1.50 phpdoc/en/functions/mysql.xml:1.51 --- phpdoc/en/functions/mysql.xml:1.50 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/mysql.xml Sat Jul 7 14:42:33 2001 @@ -181,7 +181,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: true on success, false on error. + Returns: &true; on success, &false; on error. </para> <para> <function>mysql_close</function> closes the connection to the MySQL server that's associated with the specified link @@ -250,7 +250,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a MySQL link identifier on success, or FALSE on failure. + Returns a MySQL link identifier on success, or &false; on failure. </para> <para> <function>mysql_connect</function> establishes a connection @@ -372,7 +372,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: true on success, false on failure. + Returns: &true; on success, &false; on failure. </para> <para> <function>mysql_data_seek</function> moves the internal row @@ -447,7 +447,7 @@ </para> <para> - If an error occurs, FALSE is returned. Use + If an error occurs, &false; is returned. Use <function>mysql_errno</function> and <function>mysql_error</function> to determine the nature of the error. @@ -501,7 +501,7 @@ </funcsynopsis> <para> Returns: A positive MySQL result resource to the query result, - or false on error. + or &false; on error. </para> <para> <function>mysql_db_query</function> selects a database and @@ -541,7 +541,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: true on success, false on failure. + Returns: &true; on success, &false; on failure. </para> <para> <function>mysql_drop_db</function> attempts to drop (remove) an @@ -703,7 +703,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an array that corresponds to the fetched row, or false + Returns an array that corresponds to the fetched row, or &false; if there are no more rows.</para> <para> <function>mysql_fetch_array</function> is an extended version of @@ -774,7 +774,7 @@ </funcsynopsis> <para> Returns an associative array that corresponds to the fetched row, - or false if there are no more rows.</para> + or &false; if there are no more rows.</para> <para> <function>mysql_fetch_assoc</function> is equivalent to calling <function>mysql_fetch_array</function> with MYSQL_ASSOC for the @@ -865,7 +865,7 @@ </listitem> <listitem> <simpara> - not_null - 1 if the column cannot be null + not_null - 1 if the column cannot be &null; </simpara> </listitem> <listitem> @@ -970,7 +970,7 @@ <para> Returns: An array that corresponds to the lengths of each field in the last row fetched by <function>mysql_fetch_row</function>, - or false on error. + or &false; on error. </para> <para> <function>mysql_fetch_lengths</function> stores the lengths of @@ -1006,7 +1006,7 @@ </funcsynopsis> <para> Returns an object with properties that correspond to the fetched - row, or false if there are no more rows. + row, or &false; if there are no more rows. </para> <para> <function>mysql_fetch_object</function> is similar to @@ -1061,7 +1061,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: An array that corresponds to the fetched row, or false + Returns: An array that corresponds to the fetched row, or &false; if there are no more rows. </para> <para> @@ -1072,7 +1072,7 @@ </para> <para> Subsequent call to <function>mysql_fetch_row</function> would - return the next row in the result set, or false if there are no + return the next row in the result set, or &false; if there are no more rows. </para> <para> @@ -1539,7 +1539,7 @@ For downward compatibility <function>mysql_listfields</function> can also be used. </para> - <!-- TODO: this is equiv. with 'select * from $table where FALSE,' + <!-- TODO: this is equiv. with 'select * from $table where &false;,' which implies you can better use the field-research functions on a real query, that saves you one mysql-query. --> @@ -1687,7 +1687,7 @@ </funcsynopsis> <para> Returns: A positive MySQL persistent link identifier on success, - or false on error. + or &false; on error. </para> <para> <function>mysql_pconnect</function> establishes a connection @@ -1766,16 +1766,16 @@ </para> </note> <para> - <function>mysql_query</function> returns TRUE (non-zero) or FALSE + <function>mysql_query</function> returns &true; (non-zero) or &false; to indicate whether or not the query succeeded. A return value - of TRUE means that the query was legal and could be executed by + of &true; means that the query was legal and could be executed by the server. It does not indicate anything about the number of rows affected or returned. It is perfectly possible for a query to succeed but affect no rows or return no rows. </para> <para> The following query is syntactically invalid, so - <function>mysql_query</function> fails and returns FALSE: + <function>mysql_query</function> fails and returns &false;: <example> <title><function>mysql_query</function></title> <programlisting role="php"> @@ -1790,7 +1790,7 @@ The following query is semantically invalid if <literal>my_col</literal> is not a column in the table <literal>my_tbl</literal>, so <function>mysql_query</function> - fails and returns FALSE: + fails and returns &false;: <example> <title><function>mysql_query</function></title> <programlisting role="php"> @@ -1802,7 +1802,7 @@ </example> </para> <para> - <function>mysql_query</function> will also fail and return FALSE + <function>mysql_query</function> will also fail and return &false; if you don't have permission to access the table(s) referenced by the query. </para> @@ -1947,7 +1947,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: true on success, false on error. + Returns: &true; on success, &false; on error. </para> <para> <function>mysql_select_db</function> sets the current active Index: phpdoc/en/functions/network.xml diff -u phpdoc/en/functions/network.xml:1.36 phpdoc/en/functions/network.xml:1.37 --- phpdoc/en/functions/network.xml:1.36 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/network.xml Sat Jul 7 14:42:34 2001 @@ -23,8 +23,8 @@ </funcsynopsis> <simpara> Searches DNS for records of type <parameter>type</parameter> - corresponding to <parameter>host</parameter>. Returns true if any - records are found; returns false if no records were found or if + corresponding to <parameter>host</parameter>. Returns &true; if any + records are found; returns &false; if no records were found or if an error occurred. </simpara> <simpara> @@ -189,12 +189,12 @@ <function>feof</function>). </para> <para> - If the call fails, it will return false and if the optional + If the call fails, it will return &false; and if the optional <parameter>errno</parameter> and <parameter>errstr</parameter> arguments are present they will be set to indicate the actual system level error that occurred on the system-level <literal>connect()</literal> call. If the returned errno is 0 and - the function returned false, it is an indication that the error + the function returned &false;, it is an indication that the error occurred before the <literal>connect()</literal> call. This is most likely due to a problem initializing the socket. Note that the <parameter>errno</parameter> and @@ -356,8 +356,8 @@ </funcsynopsis> <simpara> Searches DNS for MX records corresponding to - <parameter>hostname</parameter>. Returns true if any records are - found; returns false if no records were found or if an error + <parameter>hostname</parameter>. Returns &true; if any records are + found; returns &false; if no records were found or if an error occurred. </simpara> <simpara> @@ -595,7 +595,7 @@ The use of <function>openlog</function> is optional. It will automatically be called by <function>syslog</function> if necessary, in which case <parameter>ident</parameter> will default - to false. + to &false;. </para> <para> <table> @@ -823,8 +823,8 @@ </funcprototype> </funcsynopsis> <para> - If <parameter>mode</parameter> is false, the given socket - descriptor will be switched to non-blocking mode, and if true, it + If <parameter>mode</parameter> is &false;, the given socket + descriptor will be switched to non-blocking mode, and if &true;, it will be switched to blocking mode. This affects calls like <function>fgets</function> that read from the socket. In non-blocking mode an <function>fgets</function> call will always Index: phpdoc/en/functions/nis.xml diff -u phpdoc/en/functions/nis.xml:1.11 phpdoc/en/functions/nis.xml:1.12 --- phpdoc/en/functions/nis.xml:1.11 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/nis.xml Sat Jul 7 14:42:34 2001 @@ -32,7 +32,7 @@ </funcsynopsis> <para> <function>yp_get_default_domain</function> returns the default - domain of the node or FALSE. Can be used as the domain parameter + domain of the node or &false;. Can be used as the domain parameter for successive NIS calls. </para> <para> @@ -77,7 +77,7 @@ </funcsynopsis> <para> <function>yp_order</function> returns the order number for a map - or FALSE. + or &false;. </para> <para> <example> @@ -158,7 +158,7 @@ </funcsynopsis> <para> <function>yp_match</function> returns the value associated with - the passed key out of the specified map or FALSE. This key must + the passed key out of the specified map or &false;. This key must be exact.</para> <para> <example> @@ -203,7 +203,7 @@ </funcsynopsis> <para> <function>yp_first</function> returns the first key-value - pair from the named map in the named domain, otherwise FALSE. + pair from the named map in the named domain, otherwise &false;. </para> <para> <example> @@ -246,7 +246,7 @@ </funcsynopsis> <para> <function>yp_next</function> returns the next key-value pair in - the named map after the specified key or FALSE. + the named map after the specified key or &false;. </para> <para> <example> Index: phpdoc/en/functions/oci8.xml diff -u phpdoc/en/functions/oci8.xml:1.25 phpdoc/en/functions/oci8.xml:1.26 --- phpdoc/en/functions/oci8.xml:1.25 Fri Jun 29 08:52:59 2001 +++ phpdoc/en/functions/oci8.xml Sat Jul 7 14:42:34 2001 @@ -943,12 +943,12 @@ <function>OCIFetchInto</function> will overwrite the previous content of <parameter>result</parameter>. By default <parameter>result</parameter> will contain a zero-based array of all - columns that are not NULL. + columns that are not &null;. </para> <para> The <parameter>mode</parameter> parameter allows you to change the default behaviour. You can specify more than one flag by simply - adding them up (eg OCI_ASSOC+OCI_RETURN_NULLS). The known flags + adding them up (eg OCI_ASSOC+OCI_RETURN_nullS). The known flags are: <simplelist> <member> @@ -959,7 +959,7 @@ zero. (DEFAULT) </member> <member> - <literal>OCI_RETURN_NULLS</literal> Return empty columns. + <literal>OCI_RETURN_nullS</literal> Return empty columns. </member> <member> <literal>OCI_RETURN_LOBS</literal> Return the value of a LOB @@ -1036,22 +1036,22 @@ <refentry id="function.ocicolumnisnull"> <refnamediv> - <refname>OCIColumnIsNULL</refname> - <refpurpose>test whether a result column is NULL</refpurpose> + <refname>OCIColumnIsnull</refname> + <refpurpose>test whether a result column is &null;</refpurpose> </refnamediv> <refsect1> <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>OCIColumnIsNULL</function></funcdef> + <funcdef>int <function>OCIColumnIsnull</function></funcdef> <paramdef>int <parameter>stmt</parameter></paramdef> <paramdef>mixed <parameter>column</parameter></paramdef> </funcprototype> </funcsynopsis> <para> - <function>OCIColumnIsNULL</function> returns true if the returned + <function>OCIColumnIsnull</function> returns &true; if the returned column <parameter>column</parameter> in the result from the - statement <parameter>stmt</parameter> is NULL. You can either use + statement <parameter>stmt</parameter> is &null;. You can either use the column-number (1-Based) or the column-name for the <parameter>col</parameter> parameter. </para> @@ -1426,8 +1426,8 @@ </funcprototype> </funcsynopsis> <para> - <function>OCIFreeStatement</function> returns true if successful, - or false if unsuccessful. + <function>OCIFreeStatement</function> returns &true; if successful, + or &false; if unsuccessful. </para> </refsect1> </refentry> @@ -1448,8 +1448,8 @@ </funcprototype> </funcsynopsis> <para> - <function>OCIFreeCursor</function> returns true if successful, or - false if unsuccessful. + <function>OCIFreeCursor</function> returns &true; if successful, or + &false; if unsuccessful. </para> </refsect1> </refentry> @@ -1468,8 +1468,8 @@ </funcprototype> </funcsynopsis> <para> - <function>OCIFreeDesc</function> returns true if successful, or - false if unsuccessful. + <function>OCIFreeDesc</function> returns &true; if successful, or + &false; if unsuccessful. </para> </refsect1> </refentry> @@ -1491,7 +1491,7 @@ <simpara> <function>OCIParse</function> parses the <parameter>query</parameter> using <parameter>conn</parameter>. - It returns the statement identity if the query is valid, false if + It returns the statement identity if the query is valid, &false; if not. The <parameter>query</parameter> can be any valid SQL statement. </simpara> @@ -1501,7 +1501,7 @@ <refnamediv> <refname>OCIError</refname> <refpurpose>Return the last error of stmt|conn|global. - If no error happened returns false. + If no error happened returns &false;. </refpurpose> </refnamediv> <refsect1> @@ -1519,7 +1519,7 @@ the optional <parameter>stmt|conn|global</parameter> is not provided, the last error encountered is returned. If no error is found, <function>OCIError</function> returns - false. <function>OCIError</function> returns the error as an + &false;. <function>OCIError</function> returns the error as an associative array. In this array, <parameter>code</parameter> consists the oracle error code and <parameter>message</parameter> the oracle errorstring. Index: phpdoc/en/functions/openssl.xml diff -u phpdoc/en/functions/openssl.xml:1.9 phpdoc/en/functions/openssl.xml:1.10 --- phpdoc/en/functions/openssl.xml:1.9 Sun Jun 24 11:27:21 2001 +++ phpdoc/en/functions/openssl.xml Sat Jul 7 14:42:34 2001 @@ -189,7 +189,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an error message string, or false if there are no more error + Returns an error message string, or &false; if there are no more error messages to return. </para> <para> @@ -252,7 +252,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a positive key resource identifier on success, or false on error. + Returns a positive key resource identifier on success, or &false; on error. </para> <para> <function>openssl_get_privatekey</function> parses the PEM @@ -278,7 +278,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a positive key resource identifier on success, or false on error. + Returns a positive key resource identifier on success, or &false; on error. </para> <para> <function>openssl_get_publickey</function> extracts the @@ -306,7 +306,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, or false on error. If successful the opened + Returns &true; on success, or &false; on error. If successful the opened data is returned in <parameter>open_data</parameter>. </para> <para> @@ -366,7 +366,7 @@ </funcprototype> </funcsynopsis> <para> - Returns the length of the sealed data on success, or false on error. + Returns the length of the sealed data on success, or &false; on error. If successful the sealed data is returned in <parameter>sealed_data</parameter>, and the envelope keys in <parameter>env_keys</parameter>. @@ -432,7 +432,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, or false on failure. + Returns &true; on success, or &false; on failure. If successful the signature is returned in <parameter>signature</parameter>. </para> @@ -750,8 +750,8 @@ <para> <function>openssl_pkcs7_verify</function> reads the S/MIME message contained in the filename specified by <parameter>filename</parameter> and - examines the digital signature. It returns true if the signature is - verified, false if it is not correct (the message has been tampered with, + examines the digital signature. It returns &true; if the signature is + verified, &false; if it is not correct (the message has been tampered with, or the signing certificate is invalid), or -1 on error. </para> <para> @@ -801,8 +801,8 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the certificate can be used for the intended purpose, - false if it cannot, or -1 on error. + Returns &true; if the certificate can be used for the intended purpose, + &false; if it cannot, or -1 on error. </para> <para> <function>openssl_x509_checkpurpose</function> examines the certificate @@ -920,7 +920,7 @@ supplied <parameter>x509cert</parameter>, including fields such as subject name, issuer name, purposes, valid from and valid to dates etc. <parameter>shortnames</parameter> controls how the data is indexed in the - array - if <parameter>shortnames</parameter> is true (the default) then + array - if <parameter>shortnames</parameter> is &true; (the default) then fields will be indexed with the short name form, otherwise, the long name form will be used - e.g.: CN is the shortname form of commonName. </para> Index: phpdoc/en/functions/oracle.xml diff -u phpdoc/en/functions/oracle.xml:1.14 phpdoc/en/functions/oracle.xml:1.15 --- phpdoc/en/functions/oracle.xml:1.14 Mon Aug 28 07:16:40 2000 +++ phpdoc/en/functions/oracle.xml Sat Jul 7 14:42:34 2001 @@ -20,7 +20,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the bind succeeds, otherwise false. Details + Returns &true; if the bind succeeds, otherwise &false;. Details about the error can be retrieved using the <function>ora_error</function> and <function>ora_errorcode</function> functions. @@ -70,7 +70,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the close succeeds, otherwise false. Details + Returns &true; if the close succeeds, otherwise &false;. Details about the error can be retrieved using the <function>ora_error</function> and <function>ora_errorcode</function> functions. @@ -175,7 +175,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error. Details about the + Returns &true; on success, &false; on error. Details about the error can be retrieved using the <function>ora_error</function> and <function>ora_errorcode</function> functions. </para> @@ -201,7 +201,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error. Details about the error + Returns &true; on success, &false; on error. Details about the error can be retrieved using the <function>ora_error</function> and <function>ora_errorcode</function> functions. </para> @@ -230,7 +230,7 @@ <function>ora_exec</function> on the given connection. </para> <para> - Returns true on success, false on error. Details about the error + Returns &true; on success, &false; on error. Details about the error can be retrieved using the <function>ora_error</function> and <function>ora_errorcode</function> functions. </para> @@ -257,7 +257,7 @@ It will parse and execute a statement, then fetch the first result row. </para> <para> - Returns true on success, false on error. Details about the error + Returns &true; on success, &false; on error. Details about the error can be retrieved using the <function>ora_error</function> and <function>ora_errorcode</function> functions. </para> @@ -347,7 +347,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error. Details about the error + Returns &true; on success, &false; on error. Details about the error can be retrieved using the <function>ora_error</function> and <function>ora_errorcode</function> functions. </para> @@ -372,7 +372,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true (a row was fetched) or false (no more rows, or an + Returns &true; (a row was fetched) or &false; (no more rows, or an error occured). If an error occured, details can be retrieved using the <function>ora_error</function> and <function>ora_errorcode</function> functions. If there was no @@ -444,11 +444,11 @@ </funcprototype> </funcsynopsis> <para> - Returns the column data. If an error occurs, False is returned + Returns the column data. If an error occurs, &false; is returned and <function>ora_errorcode</function> - will return a non-zero value. Note, however, that a test for False - on the results from this function may be true in cases where there is - not error as well (NULL result, empty string, the number 0, the + will return a non-zero value. Note, however, that a test for &false; + on the results from this function may be &true; in cases where there is + not error as well (&null; result, empty string, the number 0, the string "0"). </para> <para> @@ -471,7 +471,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true on success, false on error. Details about the error + Returns &true; on success, &false; on error. Details about the error can be retrieved using the <function>ora_error</function> and <function>ora_errorcode</function> functions. </para> @@ -519,7 +519,7 @@ server's environment before starting the server. </para> <para> - Returns a connection index on success, or false on failure. + Returns a connection index on success, or &false; on failure. Details about the error can be retrieved using the <function>ora_error</function> and <function>ora_errorcode</function> functions. @@ -613,7 +613,7 @@ Opens an Oracle cursor associated with connection. </para> <para> - Returns a cursor index or False on failure. Details about the + Returns a cursor index or &false; on failure. Details about the error can be retrieved using the <function>ora_error</function> and <function>ora_errorcode</function> functions. </para> @@ -669,7 +669,7 @@ transaction.) </para> <para> - Returns true on success, false on error. Details about the error + Returns &true; on success, &false; on error. Details about the error can be retrieved using the <function>ora_error</function> and <function>ora_errorcode</function> functions. </para> Index: phpdoc/en/functions/outcontrol.xml diff -u phpdoc/en/functions/outcontrol.xml:1.12 phpdoc/en/functions/outcontrol.xml:1.13 --- phpdoc/en/functions/outcontrol.xml:1.12 Fri Mar 30 19:46:13 2001 +++ phpdoc/en/functions/outcontrol.xml Sat Jul 7 14:42:35 2001 @@ -210,7 +210,7 @@ </funcprototype> </funcsynopsis> <para> - This will return the contents of the output buffer or FALSE, if + This will return the contents of the output buffer or &false;, if output buffering isn't active. </para> <para> @@ -237,7 +237,7 @@ </funcsynopsis> <para> This will return the length of the contents in the output buffer - or FALSE, if output buffering isnt't active. + or &false;, if output buffering isnt't active. </para> <para> See also <function>ob_start</function> and Index: phpdoc/en/functions/ovrimos.xml diff -u phpdoc/en/functions/ovrimos.xml:1.6 phpdoc/en/functions/ovrimos.xml:1.7 --- phpdoc/en/functions/ovrimos.xml:1.6 Wed May 16 14:33:21 2001 +++ phpdoc/en/functions/ovrimos.xml Sat Jul 7 14:42:35 2001 @@ -166,7 +166,7 @@ are to be retrieved from long datatypes (long varchar and long varbinary). Default is zero. Regardless of its taking a result_id as an argument, it currently sets this parameter for all result - sets. Returns <literal>TRUE</literal>. + sets. Returns &true;. </para> </refsect1> </refentry> @@ -190,7 +190,7 @@ </para> <para> <function>ovrimos_prepare</function> prepares an SQL statement - and returns a result_id (or false on failure). + and returns a result_id (or &false; on failure). </para> <para> <example> @@ -247,7 +247,7 @@ </para> <para> <function>ovrimos_execute</function> executes a prepared - statement. Returns <literal>TRUE</literal> or <literal>FALSE</literal>. + statement. Returns &true; or &false;. If the prepared statement contained parameters (question marks in the statement), the correct number of parameters should be passed in an array. Notice @@ -303,7 +303,7 @@ </para> <para> <function>ovrimos_exec</function> executes an SQL statement - (query or update) and returns a result_id or false. Evidently, + (query or update) and returns a result_id or &false;. Evidently, the SQL statement should not contain parameters. </para> </refsect1> @@ -344,7 +344,7 @@ and absolute position from the start (essentially equivalent to 'first' but needs 'rownumber'). Case is not significant. 'Rownumber' is optional except for absolute - positioning. Returns <literal>TRUE</literal> or <literal>FALSE</literal>. + positioning. Returns &true; or &false;. </para> <para> <example> @@ -407,7 +407,7 @@ <para> <function>ovrimos_fetch_row</function> fetches a row from the result set. Column values should be retrieved with other - calls. Returns <literal>TRUE</literal> or <literal>FALSE</literal>. + calls. Returns &true; or &false;. </para> <para> <example> @@ -495,8 +495,8 @@ </para> <para> <function>ovrimos_result_all</function> prints the whole result - set as an HTML table. Returns <literal>TRUE</literal> or - <literal>FALSE</literal>. + set as an HTML table. Returns &true; or + &false;. </para> <para> <example> @@ -730,7 +730,7 @@ </para> <para> <function>ovrimos_field_num</function> returns the (1-based) - index of the output column specified by name, or false. + index of the output column specified by name, or &false;. </para> </refsect1> </refentry> @@ -754,7 +754,7 @@ </para> <para> <function>ovrimos_free_result</function> frees the specified - result_id <parameter>result_id</parameter>. Returns <literal>TRUE</literal>. + result_id <parameter>result_id</parameter>. Returns &true;. </para> </refsect1> </refentry> Index: phpdoc/en/functions/pcre.xml diff -u phpdoc/en/functions/pcre.xml:1.51 phpdoc/en/functions/pcre.xml:1.52 --- phpdoc/en/functions/pcre.xml:1.51 Wed May 30 11:36:40 2001 +++ phpdoc/en/functions/pcre.xml Sat Jul 7 14:42:35 2001 @@ -92,8 +92,8 @@ the first captured parenthesized subpattern, and so on. </para> <para> - Returns true if a match for <parameter>pattern</parameter> was - found in the subject string, or false if not match was found + Returns &true; if a match for <parameter>pattern</parameter> was + found in the subject string, or &false; if not match was found or an error occurred. </para> <para> @@ -243,7 +243,7 @@ to be PREG_PATTERN_ORDER. </para> <para> - Returns the number of full pattern matches, or false if + Returns the number of full pattern matches, or &false; if no match is found or an error occurred. </para> <para> @@ -941,7 +941,7 @@ "b", but matching "aabbaa" against /^(aa(bb)?)+$/ leaves $2 unset. However, if the pattern is changed to /^(aa(b(b))?)+$/ then $2 (and $3) get set. - In Perl 5.004 $2 is set in both cases, and that is also true + In Perl 5.004 $2 is set in both cases, and that is also &true; of PCRE. If in the future Perl changes to a consistent state that is different, PCRE may change to follow. </simpara> @@ -1585,7 +1585,7 @@ <title>Cicumflex and dollar</title> <literallayout> Outside a character class, in the default matching mode, the - circumflex character is an assertion which is true only if + circumflex character is an assertion which is &true; only if the current matching point is at the start of the subject string. Inside a character class, circumflex has an entirely different meaning (see below). @@ -1599,7 +1599,7 @@ said to be an "anchored" pattern. (There are also other con- structs that can cause a pattern to be anchored.) - A dollar character is an assertion which is true only if the + A dollar character is an assertion which is &true; only if the current matching point is at the end of the subject string, or immediately before a newline character that is the last character in the string (by default). Dollar need not be the @@ -2113,7 +2113,7 @@ does not find an occurrence of "bar" that is preceded by something other than "foo"; it finds any occurrence of "bar" - whatsoever, because the assertion (?!foo) is always true + whatsoever, because the assertion (?!foo) is always &true; when the next three characters are "bar". A lookbehind assertion is needed to achieve this effect. @@ -2347,7 +2347,7 @@ that are not parentheses. The third part is a conditional subpattern that tests whether the first set of parentheses matched or not. If they did, that is, if subject started - with an opening parenthesis, the condition is true, and so + with an opening parenthesis, the condition is &true;, and so the yes-pattern is executed and a closing parenthesis is required. Otherwise, since no-pattern is not present, the subpattern matches nothing. In other words, this pattern Index: phpdoc/en/functions/pdf.xml diff -u phpdoc/en/functions/pdf.xml:1.58 phpdoc/en/functions/pdf.xml:1.59 --- phpdoc/en/functions/pdf.xml:1.58 Sat Jun 2 20:50:40 2001 +++ phpdoc/en/functions/pdf.xml Sat Jul 7 14:42:35 2001 @@ -62,7 +62,7 @@ supported by PHP 4 with exactly the same meaning and the same parameters. Only the return values may differ from the PDFlib manual, because the PHP convention of returning - <literal>false</literal> was adopted. For compatibility reasons + &false; was adopted. For compatibility reasons this binding for PDFlib still supports the old functions, but they should be replaced by their new versions. PDFlib GmbH will not support any problems arising from the use of these deprecated @@ -315,7 +315,7 @@ exit; }; -pdf_set_parameter($pdf, "warning", "true"); +pdf_set_parameter($pdf, "warning", "&true;"); pdf_set_info($pdf, "Creator", "pdf_clock.php"); pdf_set_info($pdf, "Author", "Uwe Steinmann"); @@ -1172,7 +1172,7 @@ or the name of a CMap. </para> <para> - <function>pdf_findfont</function> returns a font handle or false + <function>pdf_findfont</function> returns a font handle or &false; on error. </para> <para> Index: phpdoc/en/functions/pgsql.xml diff -u phpdoc/en/functions/pgsql.xml:1.34 phpdoc/en/functions/pgsql.xml:1.35 --- phpdoc/en/functions/pgsql.xml:1.34 Wed Jun 27 01:59:41 2001 +++ phpdoc/en/functions/pgsql.xml Sat Jul 7 14:42:36 2001 @@ -117,7 +117,7 @@ </funcprototype> </funcsynopsis> <para> - Returns false if connection is not a valid connection index, true + Returns &false; if connection is not a valid connection index, &true; otherwise. Closes down the connection to a PostgreSQL database associated with the given connection index. </para> @@ -203,7 +203,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a connection index on success, or false if the connection + Returns a connection index on success, or &false; if the connection could not be made. Opens a connection to a PostgreSQL database. The arguments should be within a quoted string. <example> @@ -263,7 +263,7 @@ </funcsynopsis> <para> Returns the name of the database that the given PostgreSQL - connection index is connected to, or false if connection is not a + connection index is connected to, or &false; if connection is not a valid connection index. </para> </refsect1> @@ -288,7 +288,7 @@ <function>pg_end_copy</function> syncs PostgreSQL frontend with the backend after doing a copy operation. It must be issued or the backend may get "out of sync" with the frontend. Returns - TRUE if successfull, FALSE otherwise. + &true; if successfull, &false; otherwise. </para> <para> For further details and an example, see also @@ -311,7 +311,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a string containing the error message, false on failure. + Returns a string containing the error message, &false; on failure. Details about the error probably cannot be retrieved using the <function>pg_errormessage</function> function if an error occured on the last database action for which a valid connection exists, @@ -336,7 +336,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a result index if query could be executed, false on + Returns a result index if query could be executed, &false; on failure or if connection is not a valid connection index. Details about the error can be retrieved using the <function>pg_ErrorMessage</function> function if connection is @@ -375,7 +375,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: An array that corresponds to the fetched row, or false + Returns: An array that corresponds to the fetched row, or &false; if there are no more rows. </para> <para> @@ -450,7 +450,7 @@ </funcsynopsis> <para> Returns: An object with properties that correspond to the fetched - row, or false if there are no more rows. + row, or &false; if there are no more rows. </para> <para> <function>pg_fetch_object</function> is similar to @@ -539,7 +539,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: An array that corresponds to the fetched row, or false + Returns: An array that corresponds to the fetched row, or &false; if there are no more rows. </para> <para> @@ -591,7 +591,7 @@ <refentry id="function.pg-fieldisnull"> <refnamediv> <refname>pg_fieldisnull</refname> - <refpurpose>Test if a field is NULL</refpurpose> + <refpurpose>Test if a field is &null;</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -604,9 +604,9 @@ </funcprototype> </funcsynopsis> <para> - Test if a field is NULL or not. Returns 0 if the field in the - given row is not NULL. Returns 1 if the field in the given row is - NULL. Field can be specified as number or fieldname. Row + Test if a field is &null; or not. Returns 0 if the field in the + given row is not &null;. Returns 1 if the field in the given row is + &null;. Field can be specified as number or fieldname. Row numbering starts at 0. </para> </refsect1> @@ -702,7 +702,7 @@ storage size (in bytes) of the field number in the given PostgreSQL result. Field numbering starts at 0. A field size of -1 indicates a variable length field. This function will return - false on error. + &false; on error. </para> </refsect1> </refentry> @@ -875,7 +875,7 @@ The <parameter>oid</parameter> argument specifies the object id of the large object to export and the <parameter>filename</parameter> argument specifies the pathname - of the file. Returns FALSE if an error occurred, TRUE + of the file. Returns &false; if an error occurred, &true; otherwise. Remember that handling large objects in PostgreSQL must happen inside a transaction. </para> @@ -903,7 +903,7 @@ <para> The <parameter>filename</parameter> argument specifies the pathname of the file to be imported as a large object. Returns - FALSE if an error occurred, object id of the just created large + &false; if an error occurred, object id of the just created large object otherwise. Remember that handling large objects in PostgreSQL must happen inside a transaction. </para> @@ -1022,7 +1022,7 @@ <para> <function>pg_lowrite</function> writes at most to a large object from a variable <parameter>buf</parameter> and returns the number - of bytes actually written, or false in the case of an error. + of bytes actually written, or &false; in the case of an error. <parameter>fd</parameter> is a file descriptor for the large object from <function>pg_loopen</function>. </para> @@ -1116,7 +1116,7 @@ </funcprototype> </funcsynopsis> <para> - Returns a connection index on success, or false if the connection + Returns a connection index on success, or &false; if the connection could not be made. Opens a connection to a PostgreSQL database. The arguments should be within a quoted string. The arguments available include <parameter>host</parameter>, @@ -1167,7 +1167,7 @@ <refentry id="function.pg-put-line"> <refnamediv> <refname>pg_put_line</refname> - <refpurpose>Send a NULL-terminated string to PostgreSQL backend</refpurpose> + <refpurpose>Send a &null;-terminated string to PostgreSQL backend</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -1181,11 +1181,11 @@ </funcprototype> </funcsynopsis> <para> - <function>pg_put_line</function> sends a NULL-terminated string + <function>pg_put_line</function> sends a &null;-terminated string to the PostgreSQL backend server. This is useful for example for very high-speed inserting of data into a table, initiated by - starting a PostgreSQL copy-operation. That final NULL-character - is added automatically. Returns TRUE if successfull, FALSE + starting a PostgreSQL copy-operation. That final &null;-character + is added automatically. Returns &true; if successfull, &false; otherwise. </para> <note> @@ -1374,8 +1374,8 @@ trace and defaults to the last one opened. </para> <para> - Returns TRUE if <parameter>filename</parameter> could be opened - for logging, FALSE otherwise. + Returns &true; if <parameter>filename</parameter> could be opened + for logging, &false; otherwise. </para> <para> See also <function>fopen</function> and @@ -1428,7 +1428,7 @@ traced and defaults to the last one opened. </para> <para> - Returns always TRUE. + Returns always &true;. </para> <para> See also <function>pg_trace</function>. Index: phpdoc/en/functions/posix.xml diff -u phpdoc/en/functions/posix.xml:1.10 phpdoc/en/functions/posix.xml:1.11 --- phpdoc/en/functions/posix.xml:1.10 Wed May 16 14:33:21 2001 +++ phpdoc/en/functions/posix.xml Sat Jul 7 14:42:37 2001 @@ -31,8 +31,8 @@ </funcsynopsis> <para> Send the signal <parameter>sig</parameter> to the process with - the process identifier <parameter>pid</parameter>. Returns FALSE, - if unable to send the signal, TRUE otherwise. + the process identifier <parameter>pid</parameter>. Returns &false;, + if unable to send the signal, &true; otherwise. </para> <para> See also the kill(2) manual page of your POSIX system, which @@ -194,7 +194,7 @@ your system to be able to perform this function. </para> <para> - Returns TRUE on success, FALSE otherwise. See also + Returns &true; on success, &false; otherwise. See also <function>posix_setgid</function>. </para> </refsect1> @@ -224,7 +224,7 @@ <function>posix_setuid</function> last. </para> <para> - Returns TRUE on success, FALSE otherwise. + Returns &true; on success, &false; otherwise. </para> </refsect1> </refentry> @@ -336,7 +336,7 @@ Let the process <parameter>pid</parameter> join the process group <parameter>pgid</parameter>. See POSIX.1 and the setsid(2) manual page on your POSIX system for more informations on process groups - and job control. Returns TRUE on success, FALSE otherwise. + and job control. Returns &true; on success, &false; otherwise. </para> </refsect1> </refentry> @@ -361,7 +361,7 @@ <para> This is not a POSIX function, but is common on BSD and System V systems. If your system does not support this function at system - level, this PHP function will always return FALSE. + level, this PHP function will always return &false;. </para> </refsect1> </refentry> @@ -387,7 +387,7 @@ <para> This is not a POSIX function, but is common on System V systems. If your system does not support this function at system level, - this PHP function will always return FALSE. + this PHP function will always return &false;. </para> </refsect1> </refentry> Index: phpdoc/en/functions/printer.xml diff -u phpdoc/en/functions/printer.xml:1.3 phpdoc/en/functions/printer.xml:1.4 --- phpdoc/en/functions/printer.xml:1.3 Fri Jun 22 05:59:28 2001 +++ phpdoc/en/functions/printer.xml Sat Jul 7 14:42:37 2001 @@ -25,7 +25,7 @@ <para> This function tries to open a connection to the printer <parameter>devicename</parameter>, and returns a handle on success - or false on failure. + or &false; on failure. </para> <para> If no parameter was given it tries to open a @@ -124,7 +124,7 @@ </funcsynopsis> <para> Writes <parameter>content</parameter> directly to the printer, and - returns true on success or false if it failed. + returns &true; on success or &false; if it failed. </para> <para> <parameter>handle</parameter> must be a valid handle to a printer. @@ -563,8 +563,8 @@ </funcprototype> </funcsynopsis> <para> - The function deletes the device context and returns true on success, - or false if an error occurred. For an example see + The function deletes the device context and returns &true; on success, + or &false; if an error occurred. For an example see <function>printer_create_dc</function>. <parameter>handle</parameter> must be a valid handle to a printer. </para> @@ -764,8 +764,8 @@ </funcsynopsis> <para> The function deletes the selected pen. For an example see - <function>printer_select_pen</function>. It returns true on success, - or false otherwise. <parameter>handle</parameter> must be a valid + <function>printer_select_pen</function>. It returns &true; on success, + or &false; otherwise. <parameter>handle</parameter> must be a valid handle to a pen. </para> </refsect1> @@ -913,8 +913,8 @@ </funcsynopsis> <para> The function deletes the selected brush. For an example see - <function>printer_select_brush</function>. It returns true on - success, or false otherwise. <parameter>handle</parameter> + <function>printer_select_brush</function>. It returns &true; on + success, or &false; otherwise. <parameter>handle</parameter> must be a valid handle to a brush. </para> </refsect1> @@ -1058,9 +1058,9 @@ </simpara> </listitem> </itemizedlist> - <parameter>italic</parameter> can be true or false, and sets whether the font should be italic. - <parameter>underline</parameter> can be true or false, and sets whether the font should be underlined. - <parameter>strikeout</parameter> can be true or false, and sets whether the font should be striked out. + <parameter>italic</parameter> can be &true; or &false;, and sets whether the font should be italic. + <parameter>underline</parameter> can be &true; or &false;, and sets whether the font should be underlined. + <parameter>strikeout</parameter> can be &true; or &false;, and sets whether the font should be striked out. <parameter>orientation</parameter> specifies a rotation. For an example see <function>printer_select_font</function>. </para> @@ -1083,8 +1083,8 @@ </funcsynopsis> <para> The function deletes the selected font. For an example see - <function>printer_select_font</function>. It returns true on success, - or false otherwise. <parameter>handle</parameter> must be a valid + <function>printer_select_font</function>. It returns &true; on success, + or &false; otherwise. <parameter>handle</parameter> must be a valid handle to a font. </para> </refsect1> @@ -1120,7 +1120,7 @@ printer_start_doc($handle, "My Document"); printer_start_page($handle); -$font = printer_create_font("Arial", 148, 76, PRINTER_FW_MEDIUM, false, false, false, -50); +$font = printer_create_font("Arial", 148, 76, PRINTER_FW_MEDIUM, &false;, &false;, &false;, -50); printer_select_font($handle, $font); printer_draw_text($handle, "PHP is simply cool", 40, 40); printer_delete_font($font); @@ -1393,7 +1393,7 @@ printer_start_doc($handle, "My Document"); printer_start_page($handle); -$font = printer_create_font("Arial",72,48,400,false,false,false,0); +$font = printer_create_font("Arial",72,48,400,&false;,&false;,&false;,0); printer_select_font($handle, $font); printer_draw_text($handle, "test", 10, 10); printer_delete_font($font); @@ -1644,7 +1644,7 @@ valid handle to a printer. </para> <para> - The function returns true on success, or otherwise false. + The function returns &true; on success, or otherwise &false;. </para> <example> <title><function>printer_draw_bmp</function> example</title> Index: phpdoc/en/functions/pspell.xml diff -u phpdoc/en/functions/pspell.xml:1.12 phpdoc/en/functions/pspell.xml:1.13 --- phpdoc/en/functions/pspell.xml:1.12 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/pspell.xml Sat Jul 7 14:42:37 2001 @@ -93,7 +93,7 @@ </funcsynopsis> <simpara> <function>pspell_check</function> checks the spelling of a word - and returns true if the spelling is correct, false if not. + and returns &true; if the spelling is correct, &false; if not. </simpara> <para> <example> @@ -444,7 +444,7 @@ <title><function>pspell_config_runtogether</function></title> <programlisting role="php"> $pspell_config = pspell_config_create ("en"); -pspell_config_runtogether ($pspell_config, true); +pspell_config_runtogether ($pspell_config, &true;); $pspell_link = pspell_new_config ($pspell_config); pspell_check ($pspell_link, "thecat"); </programlisting> Index: phpdoc/en/functions/recode.xml diff -u phpdoc/en/functions/recode.xml:1.10 phpdoc/en/functions/recode.xml:1.11 --- phpdoc/en/functions/recode.xml:1.10 Fri May 11 03:37:44 2001 +++ phpdoc/en/functions/recode.xml Sat Jul 7 14:42:37 2001 @@ -37,7 +37,7 @@ <para> Recode the string <parameter>string</parameter> according to the recode request <parameter>request</parameter>. Returns the - recoded string or FALSE, if unable to perform the recode request. + recoded string or &false;, if unable to perform the recode request. </para> <para> A simple recode request may be "lat1..iso646-de". @@ -97,8 +97,8 @@ Recode the file referenced by file handle <parameter>input</parameter> into the file referenced by file handle <parameter>output</parameter> according to the recode - <parameter>request</parameter>. Returns FALSE, if unable to - comply, TRUE otherwise. + <parameter>request</parameter>. Returns &false;, if unable to + comply, &true; otherwise. </para> <para> This function does not currently process filehandles referencing Index: phpdoc/en/functions/regex.xml diff -u phpdoc/en/functions/regex.xml:1.20 phpdoc/en/functions/regex.xml:1.21 --- phpdoc/en/functions/regex.xml:1.20 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/regex.xml Sat Jul 7 14:42:38 2001 @@ -42,19 +42,19 @@ <title>Regular Expression Examples</title> <programlisting role="php"> ereg ("abc", $string); -/* Returns true if "abc" +/* Returns &true; if "abc" is found anywhere in $string. */ ereg ("^abc", $string); -/* Returns true if "abc" +/* Returns &true; if "abc" is found at the beginning of $string. */ ereg ("abc$", $string); -/* Returns true if "abc" +/* Returns &true; if "abc" is found at the end of $string. */ eregi ("(ozilla.[23]|MSIE.3)", $HTTP_USER_AGENT); -/* Returns true if client browser +/* Returns &true; if client browser is Netscape 2, 3 or MSIE 3. */ ereg ("([[:alnum:]]+) ([[:alnum:]]+) ([[:alnum:]]+)", $string,$regs); @@ -118,8 +118,8 @@ Searching is case sensitive. </simpara> <simpara> - Returns true if a match for <parameter>pattern</parameter> was - found in <parameter>string</parameter>, or false if no matches + Returns &true; if a match for <parameter>pattern</parameter> was + found in <parameter>string</parameter>, or &false; if no matches were found or an error occurred. </simpara> <para> @@ -311,7 +311,7 @@ is set, the returned array will contain a maximum of <parameter>limit</parameter> elements with the last element containing the whole rest of <parameter>string</parameter>. If - an error occurs, <function>split</function> returns false. + an error occurs, <function>split</function> returns &false;. </para> <para> To split off the first four fields from a line from Index: phpdoc/en/functions/satellite.xml diff -u phpdoc/en/functions/satellite.xml:1.6 phpdoc/en/functions/satellite.xml:1.7 --- phpdoc/en/functions/satellite.xml:1.6 Sun Jun 24 19:13:22 2001 +++ phpdoc/en/functions/satellite.xml Sat Jul 7 14:42:38 2001 @@ -1,6 +1,6 @@ <!-- - $Id: satellite.xml,v 1.6 2001/06/24 23:13:22 jeroen Exp $ + $Id: satellite.xml,v 1.7 2001/07/07 18:42:38 jeroen Exp $ Author: David Eriksson <david@2good.com> @@ -197,7 +197,7 @@ </funcprototype> </funcsynopsis> <para> - This function returns true if an exception has been caught. + This function returns &true; if an exception has been caught. </para> <para> <example> Index: phpdoc/en/functions/sem.xml diff -u phpdoc/en/functions/sem.xml:1.9 phpdoc/en/functions/sem.xml:1.10 --- phpdoc/en/functions/sem.xml:1.9 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/sem.xml Sat Jul 7 14:42:39 2001 @@ -72,7 +72,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: A positive semaphore identifier on success, or <literal>FALSE</literal> on + Returns: A positive semaphore identifier on success, or &false; on error. </para> <para> @@ -115,7 +115,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: <literal>TRUE</literal> on success, <literal>FALSE</literal> on error. + Returns: &true; on success, &false; on error. </para> <para> <function>sem_acquire</function> blocks (if necessary) until the @@ -150,7 +150,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: <literal>TRUE</literal> on success, <literal>FALSE</literal> on error. + Returns: &true; on success, &false; on error. </para> <para> <function>sem_release</function> releases the semaphore if it @@ -187,7 +187,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: <literal>TRUE</literal> on success, <literal>FALSE</literal> + Returns: &true; on success, &false; on error. </para> <para> Index: phpdoc/en/functions/sesam.xml diff -u phpdoc/en/functions/sesam.xml:1.5 phpdoc/en/functions/sesam.xml:1.6 --- phpdoc/en/functions/sesam.xml:1.5 Fri May 11 03:37:44 2001 +++ phpdoc/en/functions/sesam.xml Sat Jul 7 14:42:39 2001 @@ -358,7 +358,7 @@ initialization string must be prefixed with the respective type keyword, as in: <literal> CREATE TABLE exmpl ( xtime timestamp(3) DEFAULT TIMESTAMP '1970-01-01 00:00:00.000' NOT - NULL ); </literal> + &null; ); </literal> </simpara> </listitem> <listitem> @@ -502,8 +502,8 @@ </funcprototype> </funcsynopsis> <para> - Returns <literal>TRUE</literal> if a connection to the SESAM - database was made, or <literal>FALSE</literal> on error. + Returns &true; if a connection to the SESAM + database was made, or &false; on error. </para> <para> <function>sesam_connect</function> establishes a connection to an @@ -561,7 +561,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: always <literal>TRUE</literal>. + Returns: always &true;. </para> <para> <function>sesam_disconnect</function> closes the logical link to @@ -612,9 +612,9 @@ </funcprototype> </funcsynopsis> <para> - Returns: <literal>TRUE</literal> if the values are valid, and the + Returns: &true; if the values are valid, and the <function>settransaction</function> operation was successful, - <literal>FALSE</literal> otherwise. + &false; otherwise. </para> <para> <function>sesam_settransaction</function> overrides the default @@ -732,8 +732,8 @@ </funcprototype> </funcsynopsis> <para> - Returns: <literal>TRUE</literal> on success, - <literal>FALSE</literal> on errors + Returns: &true; on success, + &false; on errors </para> <para> <function>sesam_commit</function> commits any pending updates to @@ -783,8 +783,8 @@ </funcprototype> </funcsynopsis> <para> - Returns: <literal>TRUE</literal> on success, - <literal>FALSE</literal> on errors + Returns: &true; on success, + &false; on errors </para> <para> <function>sesam_rollback</function> discards any pending updates @@ -832,7 +832,7 @@ </funcsynopsis> <para> Returns: A SESAM "result identifier" on success, or - <literal>FALSE</literal> on error. + &false; on error. </para> <para> <function>sesam_execimm</function> executes an "immediate" @@ -892,7 +892,7 @@ </funcsynopsis> <para> Returns: A SESAM "result identifier" on success, or - <literal>FALSE</literal> on error. + &false; on error. </para> <para> A "result_id" resource is used by other functions to retrieve the @@ -1008,7 +1008,7 @@ result. Returns an integer describing the total number of columns (aka. fields) in the current <parameter>result_id</parameter> result set or - <literal>FALSE</literal> on error. + &false; on error. </para> <para> For "immediate" statements, the value zero is returned. The SESAM @@ -1041,7 +1041,7 @@ </funcsynopsis> <para> Returns the name of a field (i.e., the column name) in the result - set, or <literal>FALSE</literal> on error. + set, or &false; on error. </para> <para> For "immediate" queries, or for dynamic columns, an empty string @@ -1261,10 +1261,10 @@ <row> <entry>boolean $arr["truncated"]</entry> <entry> - <literal>TRUE</literal> if the number of rows was at least - <parameter>max_rows</parameter>, <literal>FALSE</literal> + &true; if the number of rows was at least + <parameter>max_rows</parameter>, &false; otherwise. Note that even when this is - <literal>TRUE</literal>, the next + &true;, the next <function>sesam_fetch_result</function> call may return zero rows because there are no more result entries. </entry> @@ -1600,7 +1600,7 @@ </funcsynopsis> <para> Returns an array that corresponds to the fetched row, or - <literal>FALSE</literal> if there are no more rows. + &false; if there are no more rows. </para> <para> The number of columns in the result set is returned in an @@ -1719,7 +1719,7 @@ Subsequent calls to <function>sesam_fetch_row</function> would return the next (or prior, or n'th next/prior, depending on the scroll attributes) row in the result set, or - <literal>FALSE</literal> if there are no more rows. + &false; if there are no more rows. </para> <example> <title>SESAM fetch rows</title> @@ -1777,7 +1777,7 @@ </funcsynopsis> <para> Returns an array that corresponds to the fetched row, or - <literal>FALSE</literal> if there are no more rows. + &false; if there are no more rows. </para> <para> <function>sesam_fetch_array</function> is an alternative version @@ -1838,7 +1838,7 @@ Subsequent calls to <function>sesam_fetch_array</function> would return the next (or prior, or n'th next/prior, depending on the scroll attributes) row in the result set, or - <literal>FALSE</literal> if there are no more rows. + &false; if there are no more rows. </para> <example> <title>SESAM fetch array</title> @@ -1989,7 +1989,7 @@ <para> Releases resources for the query associated with <parameter>result_id</parameter>. Returns - <literal>FALSE</literal> on error. + &false; on error. </para> </refsect1> </refentry> Index: phpdoc/en/functions/session.xml diff -u phpdoc/en/functions/session.xml:1.44 phpdoc/en/functions/session.xml:1.45 --- phpdoc/en/functions/session.xml:1.44 Tue Jul 3 11:36:35 2001 +++ phpdoc/en/functions/session.xml Sat Jul 7 14:42:39 2001 @@ -351,7 +351,7 @@ the current one based on the session id being passed via a GET variable or a cookie).</simpara> <simpara> - This function always returns <literal>TRUE</literal>. + This function always returns &true;. </simpara> <note> <para> @@ -379,8 +379,8 @@ associated with the current session. </simpara> <simpara> - This function returns <literal>TRUE</literal> on success and - <literal>FALSE</literal> on failure to destroy + This function returns &true; on success and + &false; on failure to destroy the session data. </simpara> </refsect1> @@ -553,7 +553,7 @@ variable named by it with the current session. </para> <para> - This function returns <literal>TRUE</literal> when the variable is successfully + This function returns &true; when the variable is successfully registered with the session. </para> <note> @@ -598,7 +598,7 @@ current session. </para> <para> - This function returns <literal>TRUE</literal> when the variable is successfully + This function returns &true; when the variable is successfully unregistered from the session. <note> <para> @@ -647,7 +647,7 @@ </funcprototype> </funcsynopsis> <para> - <function>session_is_registered</function> returns <literal>TRUE</literal> if there + <function>session_is_registered</function> returns &true; if there is a variable with the name <parameter>name</parameter> registered in the current session. <note> @@ -851,11 +851,11 @@ $sess_save_path = $save_path; $sess_session_name = $session_name; - return(true); + return(&true;); } function close() { - return(true); + return(&true;); } function read ($id) { @@ -878,7 +878,7 @@ if ($fp = @fopen($sess_file, "w")) { return(fwrite($fp, $sess_data)); } else { - return(false); + return(&false;); } } @@ -895,7 +895,7 @@ * sort of garbage collection routine here. * *********************************************/ function gc ($maxlifetime) { - return true; + return &true;; } session_set_save_handler ("open", "close", "read", "write", "destroy", "gc"); Index: phpdoc/en/functions/snmp.xml diff -u phpdoc/en/functions/snmp.xml:1.8 phpdoc/en/functions/snmp.xml:1.9 --- phpdoc/en/functions/snmp.xml:1.8 Wed May 16 14:33:21 2001 +++ phpdoc/en/functions/snmp.xml Sat Jul 7 14:42:40 2001 @@ -46,7 +46,7 @@ </funcsynopsis> <para> - Returns SNMP object value on success and false on error.</para> + Returns SNMP object value on success and &false; on error.</para> <para> The <function>snmpget</function> function is used to read the @@ -87,8 +87,8 @@ </funcsynopsis> <para> - Sets the specified SNMP object value, returning true on success - and false on error.</para> + Sets the specified SNMP object value, returning &true; on success + and &false; on error.</para> <para> The <function>snmpset</function> function is used @@ -122,13 +122,13 @@ <para> Returns an array of SNMP object values starting from the - <function>object_id</function> as root and false on error.</para> + <function>object_id</function> as root and &false; on error.</para> <para> <function>snmpwalk</function> function is used to read all the values from an SNMP agent specified by the <parameter>hostname</parameter>. <parameter>Community</parameter> - specifies the read community for that agent. A null + specifies the read community for that agent. A &null; <parameter>object_id</parameter> is taken as the root of the SNMP objects tree and all objects under that tree are returned as an array. If <parameter>object_id</parameter> is specified, all the @@ -182,13 +182,13 @@ <para> Returns an associative array with object ids and their respective object value starting from the <parameter>object_id</parameter> - as root and false on error.</para> + as root and &false; on error.</para> <para> <function>snmpwalkoid</function> function is used to read all object ids and their respective values from an SNMP agent specified by the hostname. Community specifies the read - <parameter>community</parameter> for that agent. A null + <parameter>community</parameter> for that agent. A &null; <parameter>object_id</parameter> is taken as the root of the SNMP objects tree and all objects under that tree are returned as an array. If <parameter>object_id</parameter> is specified, all the @@ -249,8 +249,8 @@ </informalexample></para> <para> - Above function call would return <systemitem>false</systemitem> if - quick_print is on, and <systemitem>true</systemitem> if quick_print + Above function call would return <systemitem>&false;</systemitem> if + quick_print is on, and <systemitem>&true;</systemitem> if quick_print is on.</para> <para> Index: phpdoc/en/functions/sockets.xml diff -u phpdoc/en/functions/sockets.xml:1.13 phpdoc/en/functions/sockets.xml:1.14 --- phpdoc/en/functions/sockets.xml:1.13 Fri Jul 6 05:45:22 2001 +++ phpdoc/en/functions/sockets.xml Sat Jul 7 14:42:40 2001 @@ -90,9 +90,9 @@ $talkback = "PHP: You said '$buf'.\n"; write ($msgsock, $talkback, strlen ($talkback)); echo "$buf\n"; - } while (true); + } while (&true;); close ($msgsock); -} while (true); +} while (&true;); close ($sock); ?> @@ -290,7 +290,7 @@ <function>accept_connect</function>. </para> <para> - Returns <literal>TRUE</literal> on success, or <literal>FALSE</literal> + Returns &true; on success, or &false; if an error occurs (i.e., <parameter>socket</parameter> is invalid). </para> <para> Index: phpdoc/en/functions/strings.xml diff -u phpdoc/en/functions/strings.xml:1.96 phpdoc/en/functions/strings.xml:1.97 --- phpdoc/en/functions/strings.xml:1.96 Thu Jun 28 19:03:46 2001 +++ phpdoc/en/functions/strings.xml Sat Jul 7 14:42:40 2001 @@ -44,7 +44,7 @@ Be careful if you choose to escape characters 0, a, b, f, n, r, t and v. They will be converted to \0, \a, \b, \f, \n, \r, \t and \v. - In PHP \0 (NULL), \r (carriage return), \n (newline) and \t (tab) + In PHP \0 (&null;), \r (carriage return), \n (newline) and \t (tab) are predefined escape sequences, while in C all of these are predefined escape sequences. </para> @@ -116,7 +116,7 @@ to be quoted in database queries etc. These characters are single quote (<literal>'</literal>), double quote (<literal>"</literal>), backslash (<literal>\</literal>) - and NUL (the null byte). + and NUL (the &null; byte). </para> <para> See also <function>stripslashes</function>, @@ -555,11 +555,11 @@ echo $foo,$bar; // foobarbarbaz // because echo is not a function, following code is invalid. -($some_var) ? echo('true'): echo('false'); +($some_var) ? echo('&true;'): echo('&false;'); // However, the following examples will work: -($some_var) ? print('true'): print('false'); // print is a function -echo ($some_var) ? 'true': 'false'; // changing the statement around +($some_var) ? print('&true;'): print('&false;'); // print is a function +echo ($some_var) ? '&true;': '&false;'; // changing the statement around ?> </programlisting> </example> @@ -607,7 +607,7 @@ a maximum of <parameter>limit</parameter> elements with the last element containing the whole rest of <parameter>string</parameter>. If an empty string ("") is used as the <parameter>separator</parameter> - argument, then <function>explode</function> will return <literal>FALSE</literal>. + argument, then <function>explode</function> will return &false;. If <parameter>separator</parameter> contains a value that is not contained in the <parameter>string</parameter> argument, then<function>explode</function> will return the <parameter>string</parameter> argument. @@ -1220,19 +1220,19 @@ </row> <row> <entry>p_cs_precedes</entry> - <entry>True if currency_symbol precedes a positive value, false if it succeeds one</entry> + <entry>&true; if currency_symbol precedes a positive value, &false; if it succeeds one</entry> </row> <row> <entry>p_sep_by_space</entry> - <entry>True if a space separates currency_symbol from a positive value, false otherwise</entry> + <entry>&true; if a space separates currency_symbol from a positive value, &false; otherwise</entry> </row> <row> <entry>n_cs_precedes</entry> - <entry>True if currency_symbol precedes a negative value, false if it succeeds one</entry> + <entry>&true; if currency_symbol precedes a negative value, &false; if it succeeds one</entry> </row> <row> <entry>n_sep_by_space</entry> - <entry>True if a space separates currency_symbol from a negative value, false otherwise</entry> + <entry>&true; if a space separates currency_symbol from a negative value, &false; otherwise</entry> </row> <row valign="top"> <entry>p_sign_posn</entry> @@ -1764,7 +1764,7 @@ is not affected, only the current setting is returned. </para> <para> - Setlocale returns the new current locale, or false if the locale + Setlocale returns the new current locale, or &false; if the locale functionality is not implemented in the platform, the specified locale does not exist or the category name is invalid. An invalid category name also causes a warning message. @@ -2362,7 +2362,7 @@ are examined in a case-insensitive manner. </para> <para> - If <parameter>needle</parameter> is not found, returns false. + If <parameter>needle</parameter> is not found, returns &false;. </para> <para> If <parameter>needle</parameter> is not a string, it is converted @@ -2645,7 +2645,7 @@ entire string will be used. </para> <para> - If <parameter>needle</parameter> is not found, returns false. + If <parameter>needle</parameter> is not found, returns &false;. <note> <para> It is easy to mistake the return values for "character found at @@ -2655,7 +2655,7 @@ <programlisting role="php"> // in PHP 4.0b3 and newer: $pos = strpos ($mystring, "b"); -if ($pos === false) { // note: three equal signs +if ($pos === &false;) { // note: three equal signs // not found... } @@ -2710,7 +2710,7 @@ end of <parameter>haystack</parameter>. </para> <para> - Returns false if <parameter>needle</parameter> is not found. + Returns &false; if <parameter>needle</parameter> is not found. </para> <para> If <parameter>needle</parameter> contains more than one @@ -2818,7 +2818,7 @@ be used. </para> <para> - If <parameter>needle</parameter> is not found, returns false. + If <parameter>needle</parameter> is not found, returns &false;. <note> <para> It is easy to mistake the return values for "character found at @@ -2828,7 +2828,7 @@ <programlisting role="php"> // in PHP 4.0b3 and newer: $pos = strrpos ($mystring, "b"); -if ($pos === false) { // note: three equal signs +if ($pos === &false;) { // note: three equal signs // not found... } @@ -2910,7 +2910,7 @@ occurrence of <parameter>needle</parameter> to the end. </para> <para> - If <parameter>needle</parameter> is not found, returns false. + If <parameter>needle</parameter> is not found, returns &false;. </para> <para> If <parameter>needle</parameter> is not a string, it is converted @@ -2985,7 +2985,7 @@ </para> <para> Also be careful that your tokens may be equal to "0". This - evaluates to false in conditional expressions. + evaluates to &false; in conditional expressions. </para> <para> See also <function>split</function> and Index: phpdoc/en/functions/sybase.xml diff -u phpdoc/en/functions/sybase.xml:1.14 phpdoc/en/functions/sybase.xml:1.15 --- phpdoc/en/functions/sybase.xml:1.14 Wed May 16 14:33:21 2001 +++ phpdoc/en/functions/sybase.xml Sat Jul 7 14:42:40 2001 @@ -53,7 +53,7 @@ </funcprototype> </funcsynopsis> <para> - Returns: true on success, false on error + Returns: &true; on success, &false; on error </para> <para> sybase_close() closes the link to a Sybase database that's associated with the specified link identifier. If the link @@ -89,7 +89,7 @@ </funcprototype> </funcsynopsis> <para> Returns: A positive Sybase link identifier on success, or - false on error. + &false; on error. </para> <para> sybase_connect() establishes a connection to a Sybase server. The servername argument has to be a valid servername that is defined @@ -123,7 +123,7 @@ <paramdef>int <parameter>row_number</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> Returns: true on success, false on failure + <para> Returns: &true; on success, &false; on failure </para> <para> sybase_data_seek() moves the internal row pointer of the Sybase result associated with the specified result identifier to @@ -149,7 +149,7 @@ </funcprototype> </funcsynopsis> <para> Returns: An array that corresponds to the fetched row, or - false if there are no more rows. + &false; if there are no more rows. </para> <para> sybase_fetch_array() is an extended version of @@ -236,7 +236,7 @@ </funcprototype> </funcsynopsis> <para> Returns: An object with properties that correspond to the - fetched row, or false if there are no more rows. + fetched row, or &false; if there are no more rows. </para> <para> sybase_fetch_object() is similar to <function>sybase_fetch_array</function>, with one difference - an @@ -269,7 +269,7 @@ </funcprototype> </funcsynopsis> <para> Returns: An array that corresponds to the fetched row, or - false if there are no more rows. + &false; if there are no more rows. </para> <para> sybase_fetch_row() fetches one row of data from the result @@ -279,7 +279,7 @@ </para> <para> Subsequent call to sybase_fetch_rows() would return the next row - in the result set, or false if there are no more rows. + in the result set, or &false; if there are no more rows. </para> <para> See also: <function>sybase_fetch_array</function>, @@ -532,7 +532,7 @@ </funcsynopsis> <para> Returns: A positive Sybase persistent link identifier on success, - or false on error</para> + or &false; on error</para> <para> sybase_pconnect() acts very much like <function>sybase_connect</function> with two major differences.</para> @@ -568,7 +568,7 @@ </funcprototype> </funcsynopsis> <para> Returns: A positive Sybase result identifier on success, or - false on error. + &false; on error. </para> <para> sybase_query() sends a query to the currently active database on the server that's associated with the specified link @@ -644,7 +644,7 @@ <paramdef>int <parameter>link_identifier</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> Returns: true on success, false on error + <para> Returns: &true; on success, &false; on error </para> <para> sybase_select_db() sets the current active database on the server that's associated with the specified link identifier. If Index: phpdoc/en/functions/uodbc.xml diff -u phpdoc/en/functions/uodbc.xml:1.20 phpdoc/en/functions/uodbc.xml:1.21 --- phpdoc/en/functions/uodbc.xml:1.20 Tue Jul 3 11:36:35 2001 +++ phpdoc/en/functions/uodbc.xml Sat Jul 7 14:42:40 2001 @@ -57,13 +57,13 @@ <para> Without the <parameter>OnOff</parameter> parameter, this function returns auto-commit status for - <parameter>connection_id</parameter>. True is returned if - auto-commit is on, false if it is off or an error occurs. + <parameter>connection_id</parameter>. &true; is returned if + auto-commit is on, &false; if it is off or an error occurs. </para> <para> - If <parameter>OnOff</parameter> is true, auto-commit is enabled, - if it is false auto-commit is disabled. Returns - <literal>true</literal> on success, <literal>false</literal> on + If <parameter>OnOff</parameter> is &true;, auto-commit is enabled, + if it is &false; auto-commit is disabled. Returns + &true; on success, &false; on failure. </para> <para> @@ -255,8 +255,8 @@ </funcprototype> </funcsynopsis> <para> - Returns: <literal>true</literal> on success, - <literal>false</literal> on failure. All pending transactions on + Returns: &true; on success, + &false; on failure. All pending transactions on <parameter>connection_id</parameter> are committed. </para> </refsect1> @@ -279,7 +279,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an ODBC connection id or 0 (<literal>false</literal>) on + Returns an ODBC connection id or 0 (&false;) on error. </para> <simpara> @@ -439,7 +439,7 @@ </funcprototype> </funcsynopsis> <para> - Returns <literal>false</literal> on error. Returns an ODBC + Returns &false; on error. Returns an ODBC result identifier if the SQL command was executed successfully. </para> <para> @@ -475,8 +475,8 @@ <para> Executes a statement prepared with <function>odbc_prepare</function>. Returns - <literal>true</literal> on successful execution, - <literal>false</literal> otherwise. The array + &true; on successful execution, + &false; otherwise. The array <parameter>parameters_array</parameter> only needs to be given if you really have parameters in your statement. </para> @@ -500,7 +500,7 @@ </funcsynopsis> <para> Returns the number of columns in the result; - <literal>false</literal> on error. + &false; on error. <parameter>result_array</parameter> must be passed by reference, but it can be of any type since it will be converted to type array. The array will contain the column values starting at array @@ -578,8 +578,8 @@ </funcsynopsis> <para> If <function>odbc_fetch_row</function> was succesful (there was a - row), <literal>true</literal> is returned. If there are no more - rows, <literal>false</literal> is returned. + row), &true; is returned. If there are no more + rows, &false; is returned. </para> <para> <function>odbc_fetch_row</function> fetches a row of the data @@ -625,7 +625,7 @@ <function>odbc_field_name</function> will return the name of the field occupying the given column number in the given ODBC result identifier. Field numbering starts at 1. - <literal>false</literal> is returned on error. + &false; is returned on error. </para> </refsect1> </refentry> @@ -648,7 +648,7 @@ <function>odbc_field_num</function> will return the number of the column slot that corresponds to the named field in the given ODBC result identifier. Field numbering starts at 1. - <literal>false</literal> is returned on error. + &false; is returned on error. </para> </refsect1> </refentry> @@ -763,7 +763,7 @@ </funcprototype> </funcsynopsis> <para> - Always returns <literal>true</literal>. + Always returns &true;. </para> <para> <function>odbc_free_result</function> only needs to be called if @@ -855,7 +855,7 @@ </funcprototype> </funcsynopsis> <para> - Returns an ODBC connection id or 0 (<literal>false</literal>) on + Returns an ODBC connection id or 0 (&false;) on error. This function is much like <function>odbc_connect</function>, except that the connection is not really closed when the script has finished. Future requests @@ -896,7 +896,7 @@ </funcprototype> </funcsynopsis> <para> - Returns <literal>false</literal> on error. + Returns &false; on error. </para> <para> Returns an ODBC result identifier if the SQL command was prepared @@ -1011,7 +1011,7 @@ </funcsynopsis> <para> Returns the number of rows in the result or - <literal>false</literal> on error. + &false; on error. </para> <para> <function>odbc_result_all</function> will print all rows from a @@ -1039,7 +1039,7 @@ <para> Rolls back all pending statements on <parameter>connection_id</parameter>. Returns - <literal>true</literal> on success, <literal>false</literal> on + &true; on success, &false; on failure. </para> </refsect1> @@ -1049,8 +1049,8 @@ <refnamediv> <refname>odbc_setoption</refname> <refpurpose> - Adjust ODBC settings. Returns false if an error occurs, otherwise - true. + Adjust ODBC settings. Returns &false; if an error occurs, otherwise + &true;. </refpurpose> </refnamediv> <refsect1> @@ -1106,7 +1106,7 @@ // 1. Option 102 of SQLSetConnectOption() is SQL_AUTOCOMMIT. // Value 1 of SQL_AUTOCOMMIT is SQL_AUTOCOMMIT_ON. // This example has the same effect as -// odbc_autocommit($conn, true); +// odbc_autocommit($conn, &true;); odbc_setoption ($conn, 1, 102, 1); @@ -1145,7 +1145,7 @@ </funcsynopsis> <para> Lists all tables in the requested range. Returns an ODBC result - identifier or <literal>false</literal> on failure. + identifier or &false; on failure. </para> <para> The result set has the following columns: @@ -1180,7 +1180,7 @@ <parameter>name</parameter> are empty strings, then the result set contains a list of valid qualifiers for the data source. (All columns except the TABLE_QUALIFIER column contain - NULLs.) + &null;s.) </simpara> </listitem> <listitem> @@ -1190,7 +1190,7 @@ <parameter>name</parameter> are empty strings, then the result set contains a list of valid owners for the data source. (All columns except the TABLE_OWNER column contain - NULLs.) + &null;s.) </simpara> </listitem> <listitem> @@ -1200,7 +1200,7 @@ <parameter>owner</parameter> and <parameter>name</parameter> are empty strings, then the result set contains a list of valid table types for the data source. (All columns except the - TABLE_TYPE column contain NULLs.) + TABLE_TYPE column contain &null;s.) </simpara> </listitem> </itemizedlist> @@ -1242,7 +1242,7 @@ <para> Lists tables in the requested range and the privileges associated with each table. Returns an ODBC result identifier or - <literal>false</literal> on failure. + &false; on failure. </para> <para> The result set has the following columns: @@ -1290,7 +1290,7 @@ </funcsynopsis> <para> Lists all columns in the requested range. Returns an ODBC result - identifier or <literal>false</literal> on failure. + identifier or &false; on failure. </para> <para> The result set has the following columns: @@ -1305,7 +1305,7 @@ <listitem><simpara>LENGTH</simpara></listitem> <listitem><simpara>SCALE</simpara></listitem> <listitem><simpara>RADIX</simpara></listitem> - <listitem><simpara>NULLABLE</simpara></listitem> + <listitem><simpara>&null;ABLE</simpara></listitem> <listitem><simpara>REMARKS</simpara></listitem> </itemizedlist> </para> @@ -1349,7 +1349,7 @@ </funcsynopsis> <para> Lists columns and associated privileges for the given table. - Returns an ODBC result identifier or <literal>false</literal> on + Returns an ODBC result identifier or &false; on failure. </para> <para> @@ -1396,7 +1396,7 @@ <para> Retrieves information about data types supported by the data source. Returns an ODBC result identifier or - <literal>false</literal> on failure. The optional argument + &false; on failure. The optional argument <parameter>data_type</parameter> can be used to restrict the information to a single data type. </para> @@ -1409,7 +1409,7 @@ <listitem><simpara>LITERAL_PREFIX</simpara></listitem> <listitem><simpara>LITERAL_SUFFIX</simpara></listitem> <listitem><simpara>CREATE_PARAMS</simpara></listitem> - <listitem><simpara>NULLABLE</simpara></listitem> + <listitem><simpara>&null;ABLE</simpara></listitem> <listitem><simpara>CASE_SENSITIVE</simpara></listitem> <listitem><simpara>SEARCHABLE</simpara></listitem> <listitem><simpara>UNSIGNED_ATTRIBUTE</simpara></listitem> @@ -1447,7 +1447,7 @@ <para> Returns the column names that comprise the primary key for a table. Returns an ODBC result identifier or - <literal>false</literal> on failure. + &false; on failure. </para> <para> The result set has the following columns: @@ -1489,7 +1489,7 @@ <para> <function>odbc_foreignkeys</function> retrieves information about foreign keys. Returns an ODBC result identifier or - <literal>false</literal> on failure. + &false; on failure. </para> <para> The result set has the following columns: @@ -1553,7 +1553,7 @@ </funcsynopsis> <para> Lists all procedures in the requested range. Returns an ODBC - result identifier or <literal>false</literal> on failure. + result identifier or &false; on failure. </para> <para> The result set has the following columns: @@ -1598,7 +1598,7 @@ <para> Returns the list of input and output parameters, as well as the columns that make up the result set for the specified procedures. Returns - an ODBC result identifier or <literal>false</literal> on failure. + an ODBC result identifier or &false; on failure. </para> <para> The result set has the following columns: @@ -1614,7 +1614,7 @@ <listitem><simpara>LENGTH</simpara></listitem> <listitem><simpara>SCALE</simpara></listitem> <listitem><simpara>RADIX</simpara></listitem> - <listitem><simpara>NULLABLE</simpara></listitem> + <listitem><simpara>&null;ABLE</simpara></listitem> <listitem><simpara>REMARKS</simpara></listitem> </itemizedlist> </para> @@ -1650,7 +1650,7 @@ <paramdef>string <parameter>owner</parameter></paramdef> <paramdef>string <parameter>table</parameter></paramdef> <paramdef>int <parameter>scope</parameter></paramdef> - <paramdef>int <parameter>nullable</parameter></paramdef> + <paramdef>int <parameter>&null;able</parameter></paramdef> </funcprototype> </funcsynopsis> <simpara> @@ -1666,7 +1666,7 @@ uniquely identified. </simpara> <simpara> - Returns an ODBC result identifier or <literal>false</literal> on + Returns an ODBC result identifier or &false; on failure. </simpara> <para> @@ -1708,7 +1708,7 @@ </funcsynopsis> <para> Get statistics about a table and it's indexes. Returns an ODBC - result identifier or <literal>false</literal> on failure. + result identifier or &false; on failure. </para> <para> The result set has the following columns: Index: phpdoc/en/functions/var.xml diff -u phpdoc/en/functions/var.xml:1.58 phpdoc/en/functions/var.xml:1.59 --- phpdoc/en/functions/var.xml:1.58 Wed Jun 27 08:04:49 2001 +++ phpdoc/en/functions/var.xml Sat Jul 7 14:42:41 2001 @@ -65,18 +65,18 @@ to boolean</link> for more information. </para> - <!-- Returns false if <parameter>var</parameter> is set and has a - non-empty or non-zero value; true otherwise. --> + <!-- Returns &false; if <parameter>var</parameter> is set and has a + non-empty or non-zero value; &true; otherwise. --> <informalexample> <programlisting role="php"> $var = 0; -if (empty($var)) { // evaluates true +if (empty($var)) { // evaluates &true; echo '$var is either 0 or not set at all'; } -if (!isset($var)) { // evaluates false +if (!isset($var)) { // evaluates &false; echo '$var is not set at all'; } </programlisting> @@ -86,7 +86,7 @@ Note that this is meaningless when used on anything which isn't a variable; i.e. <command>empty (addslashes ($name))</command> has no meaning since it would be checking whether something which - isn't a variable is a variable with a false value. + isn't a variable is a variable with a &false; value. <!-- will even result in parse error (at least in PHP 4) --> </simpara> <simpara> @@ -149,7 +149,7 @@ <simpara>"<type>resource</type>" (since PHP 4)</simpara> </listitem> <listitem> - <simpara>"<type>NULL</type>" (since PHP 4)</simpara> + <simpara>"<type>null</type>" (since PHP 4)</simpara> </listitem> <listitem> <simpara>"user function" (PHP 3 only, deprecated)</simpara> @@ -324,7 +324,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true if <parameter>var</parameter> is an <type>array</type>, false + Returns &true; if <parameter>var</parameter> is an <type>array</type>, &false; otherwise. </para> <para> @@ -360,7 +360,7 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the <parameter>var</parameter> parameter is + Returns &true; if the <parameter>var</parameter> parameter is a <type>boolean</type>. </para> <para> @@ -391,8 +391,8 @@ </funcprototype> </funcsynopsis> <para> - Returns true if <parameter>var</parameter> is a <type>double</type>, - false otherwise. + Returns &true; if <parameter>var</parameter> is a <type>double</type>, + &false; otherwise. </para> <para> See also <function>is_array</function>, @@ -513,9 +513,9 @@ </funcprototype> </funcsynopsis> <para> - Returns true if <parameter>var</parameter> is an <type>integer</type> + Returns &true; if <parameter>var</parameter> is an <type>integer</type> (long), - false otherwise. + &false; otherwise. </para> <para> See also <function>is_bool</function>, @@ -535,7 +535,7 @@ <refnamediv> <refname>is_null</refname> <refpurpose> - Finds whether a variable is null + Finds whether a variable is &null; </refpurpose> </refnamediv> <refsect1> @@ -547,8 +547,8 @@ </funcprototype> </funcsynopsis> <para> - Returns true if <parameter>var</parameter> is <type>null</type>, - false otherwise. + Returns &true; if <parameter>var</parameter> is <type>null</type>, + &false; otherwise. </para> <para> See also <function>is_bool</function>, @@ -582,8 +582,8 @@ </funcprototype> </funcsynopsis> <para> - Returns true if <parameter>var</parameter> is a number or a - numeric string, false otherwise. + Returns &true; if <parameter>var</parameter> is a number or a + numeric string, &false; otherwise. </para> <para> See also <function>is_bool</function>, @@ -613,8 +613,8 @@ </funcprototype> </funcsynopsis> <para> - Returns true if <parameter>var</parameter> is an <type>object</type>, - false otherwise. + Returns &true; if <parameter>var</parameter> is an <type>object</type>, + &false; otherwise. </para> <para> See also <function>is_bool</function>, @@ -680,9 +680,9 @@ </funcprototype> </funcsynopsis> <para> - <function>is_resource</function> returns true if the variable + <function>is_resource</function> returns &true; if the variable given by the <parameter>var</parameter> parameter is a - <type>resource</type>, otherwise it returns false. + <type>resource</type>, otherwise it returns &false;. </para> <para> See the documentation on the <type>resource</type>-type for @@ -711,9 +711,9 @@ </funcprototype> </funcsynopsis> <para> - <function>is_scalar</function> returns true if the variable + <function>is_scalar</function> returns &true; if the variable given by the <parameter>var</parameter> parameter is a scalar, - otherwise it returns false. + otherwise it returns &false;. </para> <para> Scalar variables are those containing an <type>integer</type>, @@ -793,8 +793,8 @@ </funcprototype> </funcsynopsis> <para> - Returns true if <parameter>var</parameter> is a <type>string</type>, - false otherwise. + Returns &true; if <parameter>var</parameter> is a <type>string</type>, + &false; otherwise. </para> <para> See also <function>is_bool</function>, @@ -824,25 +824,25 @@ </funcprototype> </funcsynopsis> <simpara> - Returns <literal>true</literal> if <parameter>var</parameter> - exists; <literal>false</literal> otherwise. + Returns &true; if <parameter>var</parameter> + exists; &false; otherwise. </simpara> <para> If a variable has been unset with <function>unset</function>, it will no longer be <function>isset</function>. <function>isset</function> - will return <literal>false</literal> if testing a variable that has been - set to <literal>NULL</literal>. Also note that a null byte (<literal>"\0"</literal>) - is not equivalent to the PHP <literal>NULL</literal> constant. + will return &false; if testing a variable that has been + set to &null;. Also note that a &null; byte (<literal>"\0"</literal>) + is not equivalent to the PHP &null; constant. <informalexample> <programlisting role="php"> $a = "test"; -echo isset ($a); // TRUE +echo isset ($a); // &true; unset ($a); -echo isset ($a); // FALSE +echo isset ($a); // &false; -$foo = NULL; -print isset ($foo); // FALSE +$foo = &null;; +print isset ($foo); // &false; </programlisting> </informalexample> </para> @@ -903,7 +903,7 @@ that contains a direct or indirect reference to itself or that contains an <type>array</type> or <type>object</type> on a deeper level that does so. - This is especially true for <literal>print_r($GLOBALS)</literal>, + This is especially &true; for <literal>print_r($GLOBALS)</literal>, as <literal>$GLOBALS</literal> is itself a global variable and contains a reference to itself as such. </para> @@ -1023,15 +1023,15 @@ </itemizedlist> </para> <para> - Returns <literal>TRUE</literal> if successful; otherwise returns - <literal>FALSE</literal>. + Returns &true; if successful; otherwise returns + &false;. </para> <para> <example> <title><function>settype</function> example</title> <programlisting role="php"> $foo = "5bar"; // string -$bar = true; // boolean +$bar = &true;; // boolean settype($foo, "integer"); // $foo is now 5 (integer) settype($bar, "string"); // $bar is now "1" (string) @@ -1159,9 +1159,9 @@ </funcsynopsis> <para> <function>unset</function> destroys the specified variables. Note - that in PHP 3, <function>unset</function> will always return true + that in PHP 3, <function>unset</function> will always return &true; (actually, the integer value 1). In PHP 4, however, - <function>unset</function> is no longer a true function: it is + <function>unset</function> is no longer a &true; function: it is now a statement. As such no value is returned, and attempting to take the value of <function>unset</function> results in a parse error. @@ -1343,12 +1343,12 @@ */ -$b = 3.1; $c = TRUE; +$b = 3.1; $c = &true;; var_dump($b,$c); /* output: float(3.1) -bool(true) +bool(&true;) */ ?> Index: phpdoc/en/functions/xml.xml diff -u phpdoc/en/functions/xml.xml:1.14 phpdoc/en/functions/xml.xml:1.15 --- phpdoc/en/functions/xml.xml:1.14 Wed Jan 3 15:20:36 2001 +++ phpdoc/en/functions/xml.xml Sat Jul 7 14:42:41 2001 @@ -345,7 +345,7 @@ $xml_parser = xml_parser_create(); // use case-folding so we are sure to find the tag in $map_array -xml_parser_set_option($xml_parser, XML_OPTION_CASE_FOLDING, true); +xml_parser_set_option($xml_parser, XML_OPTION_CASE_FOLDING, &true;); xml_set_element_handler($xml_parser, "startElement", "endElement"); xml_set_character_data_handler($xml_parser, "characterData"); if (!($fp = fopen($file, "r"))) { @@ -389,9 +389,9 @@ // only trust local files owned by ourselves if (!eregi("^([a-z]+)://", $file) && fileowner($file) == getmyuid()) { - return true; + return &true;; } - return false; + return &false;; } function startElement($parser, $name, $attribs) { @@ -446,7 +446,7 @@ if (!list($parser, $fp) = new_xml_parser($systemId)) { printf("Could not open entity %s at %s\n", $openEntityNames, $systemId); - return false; + return &false;; } while ($data = fread($fp, 4096)) { if (!xml_parse($parser, $data, feof($fp))) { @@ -454,13 +454,13 @@ xml_error_string(xml_get_error_code($parser)), xml_get_current_line_number($parser), $openEntityNames); xml_parser_free($parser); - return false; + return &false;; } } xml_parser_free($parser); - return true; + return &true;; } - return false; + return &false;; } @@ -476,7 +476,7 @@ xml_set_external_entity_ref_handler($xml_parser, "externalEntityRefHandler"); if (!($fp = @fopen($file, "r"))) { - return false; + return &false;; } if (!is_array($parser_file)) { settype($parser_file, "array"); @@ -593,7 +593,7 @@ </varlistentry> </variablelist> This function creates an XML parser and returns a handle for use - by other XML functions. Returns <literal>false</literal> on + by other XML functions. Returns &false; on failure. </para> </refsect1> @@ -779,10 +779,10 @@ </para> <para> If a handler function is set to an empty string, or - <literal>false</literal>, the handler in question is disabled. + &false;, the handler in question is disabled. </para> <para> - True is returned if the handlers are set up, false if + &true; is returned if the handlers are set up, &false; if <parameter>parser</parameter> is not a parser. </para> <para> @@ -847,11 +847,11 @@ </variablelist></para> <para> If a handler function is set to an empty string, or - <literal>false</literal>, the handler in question is + &false;, the handler in question is disabled. </para> <para> - True is returned if the handler is set up, false if + &true; is returned if the handler is set up, &false; if <parameter>parser</parameter> is not a parser. </para> <para> @@ -935,10 +935,10 @@ </variablelist></para> <para> If a handler function is set to an empty string, or - <literal>false</literal>, the handler in question is disabled. + &false;, the handler in question is disabled. </para> <para> - True is returned if the handler is set up, false if + &true; is returned if the handler is set up, &false; if <parameter>parser</parameter> is not a parser. </para> <para> @@ -1011,10 +1011,10 @@ </para> <para> If a handler function is set to an empty string, or - <literal>false</literal>, the handler in question is disabled. + &false;, the handler in question is disabled. </para> <para> - True is returned if the handler is set up, false if + &true; is returned if the handler is set up, &false; if <parameter>parser</parameter> is not a parser. </para> <para> @@ -1133,10 +1133,10 @@ </variablelist></para> <para> If a handler function is set to an empty string, or - <literal>false</literal>, the handler in question is disabled. + &false;, the handler in question is disabled. </para> <para> - True is returned if the handler is set up, false if + &true; is returned if the handler is set up, &false; if <parameter>parser</parameter> is not a parser. </para> <para> @@ -1250,11 +1250,11 @@ </para> <para> If a handler function is set to an empty string, or - <literal>false</literal>, the handler in question is + &false;, the handler in question is disabled. </para> <para> - True is returned if the handler is set up, false if + &true; is returned if the handler is set up, &false; if <parameter>parser</parameter> is not a parser. </para> <para> @@ -1291,7 +1291,7 @@ <para> The function named by <parameter>handler</parameter> must accept five parameters, and should return an integer value. If the - value returned from the handler is false (which it will be if no + value returned from the handler is &false; (which it will be if no value is returned), the XML parser will stop parsing and <function>xml_get_error_code</function> will return <systemitem class="constant">XML_ERROR_EXTERNAL_ENTITY_HANDLING</systemitem>. @@ -1364,11 +1364,11 @@ </para> <para> If a handler function is set to an empty string, or - <literal>false</literal>, the handler in question is + &false;, the handler in question is disabled. </para> <para> - True is returned if the handler is set up, false if + &true; is returned if the handler is set up, &false; if <parameter>parser</parameter> is not a parser. </para> <para> @@ -1413,7 +1413,7 @@ Chunk of data to parse. A document may be parsed piece-wise by calling <function>xml_parse</function> several times with new data, as long as the <parameter>isFinal</parameter> - parameter is set and true when the last data is parsed. + parameter is set and &true; when the last data is parsed. </simpara> </listitem> </varlistentry> @@ -1421,7 +1421,7 @@ <term><parameter>isFinal</parameter> (optional)</term> <listitem> <simpara> - If set and true, <parameter>data</parameter> is the last + If set and &true;, <parameter>data</parameter> is the last piece of data sent in this parse. </simpara> </listitem> @@ -1431,10 +1431,10 @@ <para> When the XML document is parsed, the handlers for the configured events are called as many times as necessary, after which this - function returns true or false. + function returns &true; or &false;. </para> <para> - True is returned if the parse was successful, false if it was not + &true; is returned if the parse was successful, &false; if it was not successful, or if <parameter>parser</parameter> does not refer to a valid parser. For unsuccessful parses, error information can be retrieved with <function>xml_get_error_code</function>, @@ -1472,7 +1472,7 @@ </variablelist> </para> <para> - This function returns false if <parameter>parser</parameter> does + This function returns &false; if <parameter>parser</parameter> does not refer to a valid parser, or else it returns one of the error codes listed in the <link linkend="xml.error-codes">error codes section</link>. @@ -1507,7 +1507,7 @@ </para> <para> Returns a string with a textual description of the error code - <parameter>code</parameter>, or false if no description was found. + <parameter>code</parameter>, or &false; if no description was found. </para> </refsect1> </refentry> @@ -1540,7 +1540,7 @@ </variablelist> </para> <para> - This function returns false if <parameter>parser</parameter> does + This function returns &false; if <parameter>parser</parameter> does not refer to a valid parser, or else it returns which line the parser is currently at in its data buffer. </para> @@ -1577,7 +1577,7 @@ </variablelist> </para> <para> - This function returns false if <parameter>parser</parameter> does + This function returns &false; if <parameter>parser</parameter> does not refer to a valid parser, or else it returns which column on the current line (as given by <function>xml_get_current_line_number</function>) the parser is @@ -1614,7 +1614,7 @@ </variablelist> </para> <para> - This function returns false if <parameter>parser</parameter> does + This function returns &false; if <parameter>parser</parameter> does not refer to a valid parser, or else it returns which byte index the parser is currently at in its data buffer (starting at 0). </para> @@ -1860,9 +1860,9 @@ </varlistentry> </variablelist></para> <para> - This function returns false if <parameter>parser</parameter> does + This function returns &false; if <parameter>parser</parameter> does not refer to a valid parser, or else it frees the parser and - returns true. + returns &true;. </para> </refsect1> </refentry> @@ -1911,9 +1911,9 @@ </variablelist> </para> <para> - This function returns false if <parameter>parser</parameter> does + This function returns &false; if <parameter>parser</parameter> does not refer to a valid parser, or if the option could not be set. - Else the option is set and true is returned. + Else the option is set and &true; is returned. </para> <para> The following options are available: @@ -1996,7 +1996,7 @@ </variablelist> </para> <para> - This function returns false if <parameter>parser</parameter> does + This function returns &false; if <parameter>parser</parameter> does not refer to a valid parser, or if the option could not be set. Else the option's value is returned. </para> Index: phpdoc/en/functions/xslt.xml diff -u phpdoc/en/functions/xslt.xml:1.16 phpdoc/en/functions/xslt.xml:1.17 --- phpdoc/en/functions/xslt.xml:1.16 Sun Jun 24 11:27:21 2001 +++ phpdoc/en/functions/xslt.xml Sat Jul 7 14:42:41 2001 @@ -78,9 +78,9 @@ </varlistentry> </variablelist></para> <para> - This function returns false if <parameter>parser</parameter> does + This function returns &false; if <parameter>parser</parameter> does not refer to a valid parser, or if the closing of the logfile - fails. Otherwise it returns true. + fails. Otherwise it returns &true;. </para> </refsect1> </refentry> @@ -326,7 +326,7 @@ The <function>xslt_process</function> takes a string containing the XSLT stylesheet as its first argument, it takes a second string containing the XML data you want to transform and then a third string containing the results of the transformation. - <function>xslt_process</function> will return true on success and false on failure, + <function>xslt_process</function> will return &true; on success and &false; on failure, to get the error number and error string if an error occurs use the <function>xslt_errno</function> and <function>xslt_error</function> functions. </para> Index: phpdoc/en/functions/yaz.xml diff -u phpdoc/en/functions/yaz.xml:1.12 phpdoc/en/functions/yaz.xml:1.13 --- phpdoc/en/functions/yaz.xml:1.12 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/yaz.xml Sat Jul 7 14:42:42 2001 @@ -294,7 +294,7 @@ <literal>B</literal> (brief). </para> <para> - Returns true on success; false on error. + Returns &true; on success; &false; on error. </para> </refsect1> </refentry> @@ -326,7 +326,7 @@ a session. </para> <para> - Returns true on success; false on error. + Returns &true; on success; &false; on error. </para> </refsect1> </refentry> @@ -357,7 +357,7 @@ set to 10. </para> <para> - Returns true on success; false on error. + Returns &true; on success; &false; on error. </para> </refsect1> </refentry> @@ -729,11 +729,11 @@ To define a set of valid CCL fields call <function>yaz_ccl_conf</function> prior to this function. If the supplied <parameter>query</parameter> was successfully - converted to RPN, this function returns true, and the index + converted to RPN, this function returns &true;, and the index <literal>rpn</literal> of the supplied array <parameter>result</parameter> holds a valid RPN query. If the query could not be converted (because of invalid syntax, - unknown field, etc.) this function returns false and three + unknown field, etc.) this function returns &false; and three indexes are set in the resulting array to indicate the cause of failure: <literal>errorcode</literal>CCL error code (integer), <literal>errorstring</literal>CCL error string, and Index: phpdoc/en/functions/zip.xml diff -u phpdoc/en/functions/zip.xml:1.5 phpdoc/en/functions/zip.xml:1.6 --- phpdoc/en/functions/zip.xml:1.5 Tue Jun 26 21:55:15 2001 +++ phpdoc/en/functions/zip.xml Sat Jul 7 14:42:42 2001 @@ -267,7 +267,7 @@ </para> </note> <para> - Returns <literal>true</literal> on succes or <literal>false</literal> on failure. + Returns &true; on succes or &false; on failure. </para> <note> <para> @@ -313,7 +313,7 @@ </para> </note> <para> - Returns the data read, or <literal>false</literal> if the end of + Returns the data read, or &false; if the end of the file is reached. </para> <para> @@ -346,7 +346,7 @@ Returns a resource handle for later use with <function>zip_read</function> and <function>zip_close</function> or returns - <literal>false</literal> if <parameter>filename</parameter> does + &false; if <parameter>filename</parameter> does not exist. </para> <para> Index: phpdoc/en/functions/zlib.xml diff -u phpdoc/en/functions/zlib.xml:1.14 phpdoc/en/functions/zlib.xml:1.15 --- phpdoc/en/functions/zlib.xml:1.14 Sat Jun 23 16:10:51 2001 +++ phpdoc/en/functions/zlib.xml Sat Jul 7 14:42:42 2001 @@ -95,7 +95,7 @@ The gz-file pointed to by zp is closed. </para> <para> - Returns true on success and false on failure. + Returns &true; on success and &false; on failure. </para> <para> The gz-file pointer must be valid, and must point to a file @@ -118,8 +118,8 @@ </funcprototype> </funcsynopsis> <para> - Returns true if the gz-file pointer is at EOF or an error occurs; - otherwise returns false. + Returns &true; if the gz-file pointer is at EOF or an error occurs; + otherwise returns &false;. </para> <para> The gz-file pointer must be valid, and must point to a file @@ -175,7 +175,7 @@ </funcsynopsis> <para> Returns a string containing a single (uncompressed) character - read from the file pointed to by zp. Returns FALSE on EOF (as + read from the file pointed to by zp. Returns &false; on EOF (as does <function>gzeof</function>). </para> <para> @@ -210,7 +210,7 @@ first). </para> <para> - If an error occurs, returns false. + If an error occurs, returns &false;. </para> <para> The file pointer must be valid, and must point to a file @@ -301,7 +301,7 @@ compressed. </para> <para> - If the open fails, the function returns false. + If the open fails, the function returns &false;. </para> <para> You can use the optional third parameter and set it to "1", if @@ -342,7 +342,7 @@ (uncompressed) results to standard output. </para> <para> - If an error occurs, returns false. + If an error occurs, returns &false;. </para> <para> The file pointer must be valid, and must point to a file @@ -505,7 +505,7 @@ stream. </para> <para> - If an error occurs, returns false. + If an error occurs, returns &false;. </para> <para> The file pointer must be valid, and must point to a file @@ -586,7 +586,7 @@ </para> <para> Returns the number of (uncompressed) bytes read from the file. If - an error occurs, false is returned and unless the function was + an error occurs, &false; is returned and unless the function was called as <literal>@readgzfile</literal>, an error message is printed. </para> @@ -625,7 +625,7 @@ <para> This function returns a compressed version of the input <parameter>data</parameter> using the ZLIB data format, - or false if an error is encountered. The optional parameter + or &false; if an error is encountered. The optional parameter <parameter>level</parameter> can be given as 0 for no compression up to 9 for maximum compression. </para> @@ -669,7 +669,7 @@ <para> This function takes <parameter>data</parameter> compressed by <function>gzcompress</function> and returns the original - uncompressed data or false on error. The function will return an + uncompressed data or &false; on error. The function will return an error if the uncompressed data is more than 256 times the length of the compressed input <parameter>data</parameter> or more than the optional parameter <parameter>length</parameter>. @@ -702,7 +702,7 @@ <para> This function returns a compressed version of the input <parameter>data</parameter> using the DEFLATE data format, - or false if an error is encountered. The optional parameter + or &false; if an error is encountered. The optional parameter <parameter>level</parameter> can be given as 0 for no compression up to 9 for maximum compression. </para> @@ -740,7 +740,7 @@ <para> This function takes <parameter>data</parameter> compressed by <function>gzdeflate</function> and returns the original - uncompressed data or false on error. The function will return an + uncompressed data or &false; on error. The function will return an error if the uncompressed data is more than 256 times the length of the compressed input <parameter>data</parameter> or more than the optional parameter <parameter>length</parameter>. @@ -774,7 +774,7 @@ This function returns a compressed version of the input <parameter>data</parameter> compatible with the output of the <command>gzip</command> program, - or false if an error is encountered. The optional parameter + or &false; if an error is encountered. The optional parameter <parameter>level</parameter> can be given as 0 for no compression up to 9 for maximum compression, if not given the default compression level will be 1. Index: phpdoc/en/language/basic-syntax.xml diff -u phpdoc/en/language/basic-syntax.xml:1.7 phpdoc/en/language/basic-syntax.xml:1.8 --- phpdoc/en/language/basic-syntax.xml:1.7 Sat May 19 16:44:05 2001 +++ phpdoc/en/language/basic-syntax.xml Sat Jul 7 14:42:43 2001 @@ -30,7 +30,7 @@ TODO: - why is $foo[bar] bad syntax? - what's the difference between unset($bla) and - $bla = NULL (it is different!) + $bla = &null; (it is different!) - $obj->{expr} syntax - (unset) cast????? - $bla = unset <== should've been nuked, don't mention it @@ -116,13 +116,13 @@ if ( boolean-expression ) { ?> -<strong>This is true.</strong> +<strong>This is &true;.</strong> <?php } else { ?> -<strong>This is false.</strong> +<strong>This is &false;.</strong> <?php } </programlisting></example> Index: phpdoc/en/language/constants.xml diff -u phpdoc/en/language/constants.xml:1.11 phpdoc/en/language/constants.xml:1.12 --- phpdoc/en/language/constants.xml:1.11 Fri Jun 22 18:06:55 2001 +++ phpdoc/en/language/constants.xml Sat Jul 7 14:42:43 2001 @@ -52,7 +52,7 @@ <note> <simpara> Constants and (global) variables are in a different namespace. - This implies that for example <constant>TRUE</constant> and + This implies that for example &true; and <varname>$TRUE</varname> are generally different. </simpara> </note> @@ -160,28 +160,28 @@ </varlistentry> <varlistentry> - <term>TRUE (case-insensitive)</term> + <term>&true; (case-insensitive)</term> <listitem> <simpara> - A true value (see the <type>boolean</type> type). + A &true; value (see the <type>boolean</type> type). </simpara> </listitem> </varlistentry> <varlistentry> - <term>FALSE (case-insensitive)</term> + <term>&false; (case-insensitive)</term> <listitem> <simpara> - A false value (see the <type>boolean</type> type). + A &false; value (see the <type>boolean</type> type). </simpara> </listitem> </varlistentry> <varlistentry> - <term>NULL (case-insensitive)</term> + <term>&null; (case-insensitive)</term> <listitem> <simpara> - A null value (see the <type>null</type> type). + A &null; value (see the <type>null</type> type). </simpara> </listitem> </varlistentry> Index: phpdoc/en/language/control-structures.xml diff -u phpdoc/en/language/control-structures.xml:1.31 phpdoc/en/language/control-structures.xml:1.32 --- phpdoc/en/language/control-structures.xml:1.31 Sun Jul 1 23:03:43 2001 +++ phpdoc/en/language/control-structures.xml Sat Jul 7 14:42:44 2001 @@ -29,8 +29,8 @@ <simpara> As described in the section about expressions, expr is evaluated to its truth value. If <replaceable>expr</replaceable> evaluates - to <literal>TRUE</literal>, PHP will execute statement, and if it - evaluates to <literal>FALSE</literal> - it'll ignore it. + to &true;, PHP will execute statement, and if it + evaluates to &false; - it'll ignore it. </simpara> <para> The following example would display <computeroutput>a is bigger @@ -77,7 +77,7 @@ is what <literal>else</literal> is for. <literal>else</literal> extends an <literal>if</literal> statement to execute a statement in case the expression in the <literal>if</literal> statement - evaluates to <literal>FALSE</literal>. For example, the following + evaluates to &false;. For example, the following code would display <computeroutput>a is bigger than b</computeroutput> if <replaceable>$a</replaceable> is bigger than <replaceable>$b</replaceable>, and <computeroutput>a is NOT bigger @@ -94,9 +94,9 @@ The <literal>else</literal> statement is only executed if the <literal>if</literal> expression evaluated to - <literal>FALSE</literal>, and if there were any + &false;, and if there were any <literal>elseif</literal> expressions - only if they evaluated to - <literal>FALSE</literal> as well (see <link + &false; as well (see <link linkend="control-structures.elseif">elseif</link>). </para> @@ -110,10 +110,10 @@ <literal>else</literal>, it extends an <literal>if</literal> statement to execute a different statement in case the original <literal>if</literal> expression evaluates to - <literal>FALSE</literal>. However, unlike + &false;. However, unlike <literal>else</literal>, it will execute that alternative expression only if the <literal>elseif</literal> conditional - expression evaluates to <literal>TRUE</literal>. For example, the + expression evaluates to &true;. For example, the following code would display <computeroutput>a is bigger than b</computeroutput>, <computeroutput>a equal to b</computeroutput> or <computeroutput>a is smaller than b</computeroutput>: @@ -133,7 +133,7 @@ There may be several <literal>elseif</literal>s within the same <literal>if</literal> statement. The first <literal>elseif</literal> expression (if any) that evaluates to - <literal>true</literal> would be executed. In PHP, you can also + &true; would be executed. In PHP, you can also write 'else if' (in two words) and the behavior would be identical to the one of 'elseif' (in a single word). The syntactic meaning is slightly different (if you're familiar with C, this is the same @@ -144,9 +144,9 @@ The <literal>elseif</literal> statement is only executed if the preceding <literal>if</literal> expression and any preceding <literal>elseif</literal> expressions evaluated to - <literal>FALSE</literal>, and the current + &false;, and the current <literal>elseif</literal> expression evaluated to - <literal>TRUE</literal>. + &true;. </simpara> </sect1> @@ -229,13 +229,13 @@ The meaning of a <literal>while</literal> statement is simple. It tells PHP to execute the nested statement(s) repeatedly, as long as the <literal>while</literal> expression evaluates to - <literal>TRUE</literal>. The value of the expression is checked + &true;. The value of the expression is checked each time at the beginning of the loop, so even if this value changes during the execution of the nested statement(s), execution will not stop until the end of the iteration (each time PHP runs the statements in the loop is one iteration). Sometimes, if the <literal>while</literal> expression evaluates to - <literal>FALSE</literal> from the very beginning, the nested + &false; from the very beginning, the nested statement(s) won't even be run once. </simpara> <para> @@ -287,7 +287,7 @@ of the iteration), whereas it's may not necessarily run with a regular <literal>while</literal> loop (the truth expression is checked at the beginning of each iteration, if it evaluates to - <literal>FALSE</literal> right from the beginning, the loop + &false; right from the beginning, the loop execution would end immediately). </simpara> <para> @@ -305,7 +305,7 @@ <simpara> The above loop would run one time exactly, since after the first iteration, when truth expression is checked, it evaluates to - <literal>FALSE</literal> ($i is not bigger than 0) and the loop + &false; ($i is not bigger than 0) and the loop execution ends. </simpara> <para> @@ -361,9 +361,9 @@ <simpara> In the beginning of each iteration, <replaceable>expr2</replaceable> is evaluated. If it evaluates to - <literal>TRUE</literal>, the loop continues and the nested + &true;, the loop continues and the nested statement(s) are executed. If it evaluates to - <literal>FALSE</literal>, the execution of the loop ends. + &false;, the execution of the loop ends. </simpara> <simpara> At the end of each iteration, <replaceable>expr3</replaceable> is @@ -373,7 +373,7 @@ Each of the expressions can be empty. <replaceable>expr2</replaceable> being empty means the loop should be run indefinitely (PHP implicitly considers it as - <literal>TRUE</literal>, like C). This may not be as useless as + &true;, like C). This may not be as useless as you might think, since often you'd want to end the loop using a conditional <link linkend="control-structures.break"><literal>break</literal></link> @@ -877,7 +877,7 @@ <pre> <?php // A function that records the time when it is called -function profile ($dump = FALSE) +function profile ($dump = &false;) { static $profile; @@ -905,7 +905,7 @@ } // Display the data stored in the profiler -print_r (profile (TRUE)); +print_r (profile (&true;)); ?> </pre> </programlisting> @@ -1094,7 +1094,7 @@ encountered, whether the contents of the file will be evaluated or not (for example, if it is inside an <link linkend="control-structures.if">if</link> statement whose - condition evaluated to false). + condition evaluated to &false;). </para> <para> Because <function>include</function> is a special language Index: phpdoc/en/language/expressions.xml diff -u phpdoc/en/language/expressions.xml:1.5 phpdoc/en/language/expressions.xml:1.6 --- phpdoc/en/language/expressions.xml:1.5 Fri May 11 02:34:06 2001 +++ phpdoc/en/language/expressions.xml Sat Jul 7 14:42:44 2001 @@ -89,7 +89,7 @@ <simpara> A very common type of expressions are comparison expressions. - These expressions evaluate to either 0 or 1, meaning FALSE or TRUE + These expressions evaluate to either 0 or 1, meaning &false; or &true; (respectively). PHP supports > (bigger than), >= (bigger than or equal to), == (equal), != (not equal), < (smaller than) and <= (smaller than or equal to). These expressions are most commonly used @@ -126,7 +126,7 @@ $first ? $second : $third </programlisting></informalexample> - If the value of the first subexpression is true (non-zero), then + If the value of the first subexpression is &true; (non-zero), then it the second subexpression is evaluated, and that is the result of the conditional expression. Otherwise, the third subexpression is evaluated, and that is the value.</para> @@ -171,12 +171,12 @@ One last thing worth mentioning is the truth value of expressions. In many events, mainly in conditional execution and loops, you're not interested in the specific value of the expression, but only - care about whether it means TRUE or FALSE. + care about whether it means &true; or &false;. <!-- (PHP doesn't have a dedicated boolean type) : WRONG, php does. --> - The constants TRUE and FALSE (case-insensitive) are the two + The constants &true; and &false; (case-insensitive) are the two possible boolean values. When necessary, an expression is autmatically converted to boolean. See the <link linkend="language.types.typecasting">section about Index: phpdoc/en/language/oop.xml diff -u phpdoc/en/language/oop.xml:1.15 phpdoc/en/language/oop.xml:1.16 --- phpdoc/en/language/oop.xml:1.15 Wed Jun 27 02:11:31 2001 +++ phpdoc/en/language/oop.xml Sat Jul 7 14:42:44 2001 @@ -24,9 +24,9 @@ function remove_item ($artnr, $num) { if ($this->items[$artnr] > $num) { $this->items[$artnr] -= $num; - return true; + return &true;; } else { - return false; + return &false;; } } } @@ -477,7 +477,7 @@ <para> You may find yourself writing code that refers to variables and functions in base classes. This is - particularly true if your derived class is a refinement + particularly &true; if your derived class is a refinement or specialisation of code in your base class. </para> Index: phpdoc/en/language/operators.xml diff -u phpdoc/en/language/operators.xml:1.21 phpdoc/en/language/operators.xml:1.22 --- phpdoc/en/language/operators.xml:1.21 Fri Jun 22 18:06:55 2001 +++ phpdoc/en/language/operators.xml Sat Jul 7 14:42:44 2001 @@ -187,48 +187,48 @@ <row> <entry>$a == $b</entry> <entry>Equal</entry> - <entry>True if $a is equal to $b.</entry> + <entry>&true; if $a is equal to $b.</entry> </row> <row> <entry>$a === $b</entry> <entry>Identical</entry> <entry> - True if $a is equal to $b, and they are of the same + &true; if $a is equal to $b, and they are of the same type. (PHP 4 only) </entry> </row> <row> <entry>$a != $b</entry> <entry>Not equal</entry> - <entry>True if $a is not equal to $b.</entry> + <entry>&true; if $a is not equal to $b.</entry> </row> <row> <entry>$a !== $b</entry> <entry>Not identical</entry> <entry> - True if $a is not equal to $b, or they are not of the same + &true; if $a is not equal to $b, or they are not of the same type. (PHP 4 only) </entry> </row> <row> <entry>$a < $b</entry> <entry>Less than</entry> - <entry>True if $a is strictly less than $b.</entry> + <entry>&true; if $a is strictly less than $b.</entry> </row> <row> <entry>$a > $b</entry> <entry>Greater than</entry> - <entry>True if $a is strictly greater than $b.</entry> + <entry>&true; if $a is strictly greater than $b.</entry> </row> <row> <entry>$a <= $b</entry> <entry>Less than or equal to </entry> - <entry>True if $a is less than or equal to $b.</entry> + <entry>&true; if $a is less than or equal to $b.</entry> </row> <row> <entry>$a >= $b</entry> <entry>Greater than or equal to </entry> - <entry>True if $a is greater than or equal to $b.</entry> + <entry>&true; if $a is greater than or equal to $b.</entry> </row> </tbody> </tgroup> @@ -242,9 +242,9 @@ </programlisting> </informalexample> This expression evaluates to <replaceable>expr2</replaceable> if - <replaceable>expr1</replaceable> evaluates to true, and + <replaceable>expr1</replaceable> evaluates to &true;, and <replaceable>expr3</replaceable> if - <replaceable>expr1</replaceable> evaluates to false. + <replaceable>expr1</replaceable> evaluates to &false;. </para> </sect1> @@ -420,32 +420,32 @@ <row> <entry>$a and $b</entry> <entry>And</entry> - <entry>True if both $a and $b are true.</entry> + <entry>&true; if both $a and $b are &true;.</entry> </row> <row> <entry>$a or $b</entry> <entry>Or</entry> - <entry>True if either $a or $b is true.</entry> + <entry>&true; if either $a or $b is &true;.</entry> </row> <row> <entry>$a xor $b</entry> <entry>Xor</entry> - <entry>True if either $a or $b is true, but not both.</entry> + <entry>&true; if either $a or $b is &true;, but not both.</entry> </row> <row> <entry>! $a</entry> <entry>Not</entry> - <entry>True if $a is not true.</entry> + <entry>&true; if $a is not &true;.</entry> </row> <row> <entry>$a && $b</entry> <entry>And</entry> - <entry>True if both $a and $b are true.</entry> + <entry>&true; if both $a and $b are &true;.</entry> </row> <row> <entry>$a || $b</entry> <entry>Or</entry> - <entry>True if either $a or $b is true.</entry> + <entry>&true; if either $a or $b is &true;.</entry> </row> </tbody> </tgroup> Index: phpdoc/en/language/types.xml diff -u phpdoc/en/language/types.xml:1.33 phpdoc/en/language/types.xml:1.34 --- phpdoc/en/language/types.xml:1.33 Sat Jun 30 15:23:22 2001 +++ phpdoc/en/language/types.xml Sat Jul 7 14:42:45 2001 @@ -70,7 +70,7 @@ <listitem> <simpara> - <link linkend="language.types.null">null</link> + <link linkend="language.types.null">&null;</link> </simpara> </listitem> @@ -123,8 +123,8 @@ <simpara> This is the easiest type. A <type>boolean</type> expresses a - truth value. It can be either true or - false. + truth value. It can be either &true; or + &false;. </simpara> <note> @@ -136,12 +136,12 @@ <sect2 id="language.types.boolean.syntax"> <title>Syntax</title> <para> - To specify a boolean-literal, use either the keyword <constant>TRUE</constant> - or <constant>FALSE</constant>. Both are case-insensitive. + To specify a boolean-literal, use either the keyword &true; + or &false;. Both are case-insensitive. <!-- technically they are just constants --> <informalexample> <programlisting role="php"> -$foo = True; // assign the value TRUE to $foo +$foo = &true;; // assign the value &true; to $foo </programlisting> </informalexample> </para> @@ -159,7 +159,7 @@ } // this is not necessary: -if ($show_separators == true) +if ($show_separators == &true;) { echo "<hr>\n"; } @@ -189,12 +189,12 @@ <para> When converting to <type>boolean</type>, the following values - are considered <constant>FALSE</constant>: + are considered &false;: <itemizedlist> <listitem> <simpara>the <link linkend="language.types.boolean">boolean</link> - FALSE<!-- duh... --></simpara> + &false;<!-- duh... --></simpara> </listitem> <listitem> <simpara>the <link linkend="language.types.integer">integer</link @@ -220,17 +220,17 @@ </listitem> <listitem> <simpara>the special value <link linkend="language.types.null" - >NULL</link> + >&null;</link> </simpara> </listitem> </itemizedlist> - Every other value is considered <constant>TRUE</constant> (including any + Every other value is considered &true; (including any <link linkend="language.types.resource">resource</link>). <warning> <simpara> <literal>-1</literal> is considered - <constant>TRUE</constant>, like any other non-zero (whether negative + &true;, like any other non-zero (whether negative or positive) number! </simpara> </warning> @@ -365,8 +365,8 @@ <title>From <link linkend="language.types.boolean" >booleans</link></title> <simpara> - <constant>FALSE</constant> will yield - <literal>0</literal> (zero), and <constant>TRUE</constant> + &false; will yield + <literal>0</literal> (zero), and &true; will yield <literal>1</literal> (one). </simpara> </sect3> @@ -783,7 +783,7 @@ with object properties there doesn't exist a trick like the one with variables. - <!-- XXX isn't true :(, this would be the trick + <!-- XXX isn't &true; :(, this would be the trick Also, the same trick with curly-braces works if you want to limit the greediness of parsers (aren't they @@ -1146,7 +1146,7 @@ That means that you can write things like this: <informalexample> <programlisting role="php"> -echo $arr[ foo(true) ]; +echo $arr[ foo(&true;) ]; </programlisting> </informalexample> This is an example of using function-output as the array index. @@ -1258,7 +1258,7 @@ $map = array( 'version' => 4 , 'OS' => 'Linux' , 'lang' => 'english' - , 'short_tags' => true + , 'short_tags' => &true; ); // strictly numerical keys @@ -1706,27 +1706,27 @@ </sect1> <sect1 id="language.types.null"> - <title>Null</title> + <title>&null;</title> <para> - The special <literal>NULL</literal> value represents + The special &null; value represents that a variable has no value. </para> <note> <simpara> - The null-type was introduced in PHP 4 + The &null;-type was introduced in PHP 4 </simpara> </note> <sect2 id="language.types.null.syntax"> <title>Syntax</title> <para> - There is only one value of type null, and that is + There is only one value of type &null;, and that is the case-insensitive keyword - <literal>NULL</literal>. + &null;. <informalexample> <programlisting role="php"> -$var = Null; +$var = &null;; </programlisting> </informalexample> </para> @@ -1926,7 +1926,7 @@ </listitem> <listitem> <simpara><link linkend="language.types.null.casting">Converting to - null</link></simpara> + &null;</link></simpara> </listitem> --> </itemizedlist> Index: phpdoc/en/pear/pear.xml diff -u phpdoc/en/pear/pear.xml:1.3 phpdoc/en/pear/pear.xml:1.4 --- phpdoc/en/pear/pear.xml:1.3 Thu Mar 22 15:01:33 2001 +++ phpdoc/en/pear/pear.xml Sat Jul 7 14:42:46 2001 @@ -54,7 +54,7 @@ <title>PEAR Error Handling</title> <simpara> PEAR's base class also provides a way of passing around more - complex errors than a true/false value or a numeric code. A + complex errors than a &true;/&false; value or a numeric code. A PEAR error is an object that is either an instance of the class <classname>PEAR_Error</classname>, or some class inheriting <classname>PEAR_Error</classname>. Index: phpdoc/en/pear/standards.xml diff -u phpdoc/en/pear/standards.xml:1.4 phpdoc/en/pear/standards.xml:1.5 --- phpdoc/en/pear/standards.xml:1.4 Mon May 7 01:26:55 2001 +++ phpdoc/en/pear/standards.xml Sat Jul 7 14:42:46 2001 @@ -107,7 +107,7 @@ <sect1 id="pear.standards.funcdef"> <title>Function Definitions</title> <para> - Function declaractions follow the "one true brace" convention: + Function declaractions follow the "one &true; brace" convention: <programlisting role="php"> function fooFunction($arg1, $arg2 = '') { @@ -123,7 +123,7 @@ Always attempt to return a meaningful value from a function if one is appropriate. Here is a slightly longer example: <programlisting role="php"> -function connect(&$dsn, $persistent = false) +function connect(&$dsn, $persistent = &false;) { if (is_array($dsn)) { $dsninfo = &$dsn; @@ -135,7 +135,7 @@ return $this->raiseError(); } - return true; + return &true;; } </programlisting> </para>