Use &true; &false; &null; semantically where appropriate

appendices/migration80/deprecated.xml

@@ -26,7 +26,7 @@ function test($a, $b) {}      // After
     </para>
     <para>
      One exception to this rule are parameters of the form <code>Type $param = null</code>, where
-     the null default makes the type implicitly nullable. This usage remains allowed, but it is
+     the &null; default makes the type implicitly nullable. This usage remains allowed, but it is
      recommended to use an explicit nullable type instead:
     </para>
     <para>

appendices/migration80/incompatible.xml

@@ -285,7 +285,7 @@ function test(int $arg = null) {}
       <simplelist>
        <member>
         Attempting to write to a property of a non-object. Previously this
-        implicitly created an stdClass object for null, false and empty strings.
+        implicitly created an stdClass object for &null;, &false; and empty strings.
        </member>
        <member>
         Attempting to append an element to an array for which the PHP_INT_MAX key
@@ -1257,7 +1257,7 @@ $array["key"];
      <methodname>ReflectionMethod::isDestructor</methodname> now also return &true; for
      <link linkend="object.construct">__construct()</link> and
      <link linkend="object.destruct">__destruct()</link> methods of interfaces.
-     Previously, this would only be true for methods of classes and traits.
+     Previously, this would only be &true; for methods of classes and traits.
     </para>
    </listitem>
    <listitem>

language/generators.xml

@@ -274,7 +274,7 @@ foreach (input_parser($input) as $id => $fields) {
    </sect3>
 
    <sect3 xml:id="control-structures.yield.null">
-    <title>Yielding null values</title>
+    <title>Yielding &null; values</title>
 
     <para>
      Yield can be called without an argument to yield a &null; value with an

reference/apcu/functions/apcu-add.xml

@@ -86,7 +86,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Returns TRUE if something has effectively been added into the cache, FALSE otherwise.
+   Returns &true; if something has effectively been added into the cache, &false; otherwise.
    Second syntax returns array with error keys.
   </para>
  </refsect1>

reference/componere/componere/definition/isregistered.xml

@@ -21,7 +21,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Shall return true if this Definition is registered
+   Shall return &true; if this Definition is registered
   </para>
  </refsect1>
 

reference/cubrid/cubridmysql/cubrid-errno.xml

@@ -19,7 +19,7 @@
   <para>
    The <function>cubrid_errno</function> function is used to get the
    error code of the error that occurred during the API execution.  Usually,
-   it gets the error code when API returns false as its return value.
+   it gets the error code when API returns &false;.
   </para>
  </refsect1>
 

reference/cubrid/cubridmysql/cubrid-fetch-assoc.xml

@@ -17,7 +17,7 @@
   <para>
     This function returns the associative array, that corresponds to the
     fetched row, and then moves the internal data pointer ahead, or returns
-    FALSE when the end is reached.
+    &false; when the end is reached.
   </para>
  </refsect1>
 

reference/cubrid/cubridmysql/cubrid-fetch-lengths.xml

@@ -15,7 +15,7 @@
   </methodsynopsis>
   <para>
     This function returns an numeric array with the lengths of the values of
-    each field from the current row of the result set or it returns FALSE on
+    each field from the current row of the result set or it returns &false; on
     failure.
   </para>
   <note>

reference/cubrid/cubridmysql/cubrid-field-len.xml

@@ -15,7 +15,7 @@
    <methodparam><type>int</type><parameter>field_offset</parameter></methodparam>
   </methodsynopsis>
   <para>
-    This function returns the maximum length of the specified field on success, or it returns FALSE on failure.
+    This function returns the maximum length of the specified field on success, or it returns &false; on failure.
   </para>
  </refsect1>
 

reference/cubrid/cubridmysql/cubrid-field-name.xml

@@ -16,7 +16,7 @@
   </methodsynopsis>
   <para>
     This function returns the name of the specified field index on success or
-    it returns FALSE on failure.
+    it returns &false; on failure.
   </para>
  </refsect1>
 

reference/cubrid/cubridmysql/cubrid-field-seek.xml

@@ -17,7 +17,7 @@
   <para>
     This function moves the result set cursor to the specified field offset.
     This offset is used by <function>cubrid_fetch_field</function> if it
-    doesn't include a field offset. It returns TRUE on success or FALSE on
+    doesn't include a field offset. It returns &true; on success or &false; on
     failure.
   </para>
  </refsect1>

reference/cubrid/cubridmysql/cubrid-num-fields.xml

@@ -15,7 +15,7 @@
   </methodsynopsis>
   <para>
     This function returns the number of columns in the result set, on success,
-    or it returns FALSE on failure.
+    or it returns &false; on failure.
   </para>
  </refsect1>
 

reference/cubrid/functions/cubrid-error-code-facility.xml

@@ -17,7 +17,7 @@
     The <function>cubrid_error_code_facility</function> function is used to
     get the facility code (level in which the error occurred) from the error
     code of the error that occurred during the API execution. Usually, you can
-    get the error code when API returns false as its return value.
+    get the error code when API returns &false; as its return value.
   </para>
  </refsect1>
 

reference/cubrid/functions/cubrid-error-code.xml

@@ -16,7 +16,7 @@
   <para>
     The <function>cubrid_error_code</function> function is used to get the
     error code of the error that occurred during the API execution. Usually,
-    it gets the error code when API returns false as its return value.
+    it gets the error code when API returns &false; as its return value.
   </para>
  </refsect1>
 

reference/cubrid/functions/cubrid-insert-id.xml

@@ -17,7 +17,7 @@
    The <function>cubrid_insert_id</function> function retrieves the ID
    generated for the AUTO_INCREMENT column which is updated by the previous
    INSERT query. It returns 0 if the previous query does not generate new
-   rows, or FALSE on failure. 
+   rows, or &false; on failure. 
   </para>
 
   <note>

reference/dom/domdocumenttype.xml

@@ -146,7 +146,7 @@
      <term><varname>internalSubset</varname></term>
      <listitem>
       <para>
-       The internal subset as a string, or null if there is none. This
+       The internal subset as a string, or &null; if there is none. This
        does not contain the delimiting square brackets.
       </para>
      </listitem>

reference/filter/constants.xml

@@ -135,7 +135,7 @@
    </term>
    <listitem>
     <simpara>
-     Use NULL instead of FALSE on failure.
+     Use NULL instead of &false; on failure.
     </simpara>
    </listitem>
   </varlistentry>

reference/gmp/functions/gmp-setbit.xml

@@ -44,7 +44,7 @@
      <term><parameter>value</parameter></term>
      <listitem>
       <para>
-       True to set the bit (set it to 1/on); false to clear the bit (set it to 0/off).
+       &true; to set the bit (set it to 1/on); &false; to clear the bit (set it to 0/off).
       </para>
      </listitem>
     </varlistentry>

reference/hash/functions/hash-file.xml

@@ -53,7 +53,7 @@
   &reftitle.returnvalues;
   <para>
    Returns a string containing the calculated message digest as lowercase hexits
-   unless <parameter>binary</parameter> is set to true in which case the raw
+   unless <parameter>binary</parameter> is set to &true; in which case the raw
    binary representation of the message digest is returned.
   </para>
  </refsect1>

reference/hash/functions/hash-final.xml

@@ -43,7 +43,7 @@
   &reftitle.returnvalues;
   <para>
    Returns a string containing the calculated message digest as lowercase hexits
-   unless <parameter>binary</parameter> is set to true in which case the raw
+   unless <parameter>binary</parameter> is set to &true; in which case the raw
    binary representation of the message digest is returned.
   </para>
  </refsect1>

reference/hash/functions/hash-hmac-file.xml

@@ -61,7 +61,7 @@
   &reftitle.returnvalues;
   <para>
    Returns a string containing the calculated message digest as lowercase hexits
-   unless <parameter>binary</parameter> is set to true in which case the raw
+   unless <parameter>binary</parameter> is set to &true; in which case the raw
    binary representation of the message digest is returned.
    Returns &false; when <parameter>algo</parameter> is unknown or is a
    non-cryptographic hash function, or if the file

reference/hash/functions/hash-hmac.xml

@@ -61,7 +61,7 @@
   &reftitle.returnvalues;
   <para>
    Returns a string containing the calculated message digest as lowercase hexits
-   unless <parameter>binary</parameter> is set to true in which case the raw
+   unless <parameter>binary</parameter> is set to &true; in which case the raw
    binary representation of the message digest is returned.
    Returns &false; when <parameter>algo</parameter> is unknown or is a
    non-cryptographic hash function.

reference/hash/functions/hash.xml

@@ -52,7 +52,7 @@
   &reftitle.returnvalues;
   <para>
    Returns a string containing the calculated message digest as lowercase hexits
-   unless <parameter>binary</parameter> is set to true in which case the raw
+   unless <parameter>binary</parameter> is set to &true; in which case the raw
    binary representation of the message digest is returned.
   </para>
  </refsect1>

reference/ibm_db2/ini.xml

@@ -212,7 +212,7 @@
       is only for simple DB2 based websites that never require profile switching 
       and therefore can avoid all overhead of server mode additional QSQSRVR jobs. 
       This is a convenience override of db2_(p)connect to set the userid and password 
-      values to null without PHP source code changes. This override can be used in 
+      values to &null; without PHP source code changes. This override can be used in 
       combination with <parameter>ibm_db2.i5_all_pconnect</parameter> = 1.
       <itemizedlist>
        <listitem>

reference/imagick/imagick/getimageproperty.xml

@@ -37,7 +37,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Returns a string containing the image property, false if a
+   Returns a string containing the image property, &false; if a
    property with the given name does not exist.
   </para>
  </refsect1>

reference/imagick/imagick/getregistry.xml

@@ -14,7 +14,7 @@
    <methodparam><type>string</type><parameter>key</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Get the StringRegistry entry for the named key or false if not set.
+   Get the StringRegistry entry for the named key or &false; if not set.
   </para>
 
  </refsect1>

reference/imagick/imagick/setimagematte.xml

@@ -27,7 +27,7 @@
      <term><parameter>matte</parameter></term>
      <listitem>
       <para>
-       True activates the matte channel and false disables it.
+       &true; activates the matte channel and &false; disables it.
       </para>
      </listitem>
     </varlistentry>

reference/imagick/imagick/setprogressmonitor.xml

@@ -28,7 +28,7 @@
     <term><parameter>callback</parameter></term>
     <listitem>
      <para>
-      The progress function to call. It should return true if image processing should continue, or false if it should be cancelled. The offset parameter indicates the progress and the span parameter indicates the total amount of work needed to be done.
+      The progress function to call. It should return &true; if image processing should continue, or &false; if it should be cancelled. The offset parameter indicates the progress and the span parameter indicates the total amount of work needed to be done.
      </para>
 
      <methodsynopsis xmlns="http://docbook.org/ns/docbook">

reference/imagick/imagick/sigmoidalcontrastimage.xml

@@ -38,7 +38,7 @@
      <term><parameter>sharpen</parameter></term>
      <listitem>
       <para>
-       If true increase the contrast, if false decrease the contrast.
+       If &true; increase the contrast, if &false; decrease the contrast.
       </para>
      </listitem>
     </varlistentry>

reference/imagick/imagickdraw/getclippath.xml

@@ -21,7 +21,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Returns a string containing the clip path ID or false if no clip path exists.
+   Returns a string containing the clip path ID or &false; if no clip path exists.
   </para>
  </refsect1>
 

reference/imagick/imagickdraw/getfont.xml

@@ -21,7 +21,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Returns a string on success and false if no font is set.
+   Returns a string on success and &false; if no font is set.
   </para>
  </refsect1>
 

reference/imagick/imagickdraw/getfontfamily.xml

@@ -21,7 +21,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Returns the font family currently selected or false if font family is not set. 
+   Returns the font family currently selected or &false; if font family is not set. 
   </para>
  </refsect1>
 

reference/imagick/imagickdraw/gettextencoding.xml

@@ -22,7 +22,7 @@
   &reftitle.returnvalues;
   <para>
    Returns a string specifying the code set
-   or false if text encoding is not set.
+   or &false; if text encoding is not set.
   </para>
  </refsect1>
 

reference/imagick/imagickkernel/frommatrix.xml

@@ -30,7 +30,7 @@
     <term><parameter>array</parameter></term>
     <listitem>
      <para>
-      A matrix (i.e. 2d array) of values that define the kernel. Each element should be either a float value, or FALSE if that element shouldn't be used by the kernel.
+      A matrix (i.e. 2d array) of values that define the kernel. Each element should be either a float value, or &false; if that element shouldn't be used by the kernel.
      </para>
     </listitem>
    </varlistentry>

reference/imagick/imagickpixel/ispixelsimilarquantum.xml

@@ -15,7 +15,7 @@
    <methodparam choice="opt"><type>string</type><parameter>fuzz</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Returns true if the distance between two colors is less than the specified distance.
+   Returns &true; if the distance between two colors is less than the specified distance.
    The fuzz value should be in the range 0-QuantumRange.
    The maximum value represents the longest possible distance in the colorspace.
    e.g. from RGB(0, 0, 0) to RGB(255, 255, 255) for the RGB colorspace

reference/info/functions/getenv.xml

@@ -44,7 +44,7 @@
      <term><parameter>local_only</parameter></term>
      <listitem>
       <para>
-       Set to true to only return local environment variables (set by the operating system or putenv).
+       Set to &true; to only return local environment variables (set by the operating system or putenv).
       </para>
      </listitem>
     </varlistentry>

reference/intl/intlcalendar/equals.xml

@@ -25,7 +25,7 @@
    <methodparam><type>IntlCalendar</type><parameter>other</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Returns true if this calendar and the given calendar have the same time.
+   Returns &true; if this calendar and the given calendar have the same time.
    The settings, calendar types and field states do not have to be the same.
   </para>
  </refsect1>

reference/ldap/functions/ldap-control-paged-result.xml

@@ -51,7 +51,7 @@ xmlns:xlink="http://www.w3.org/1999/xlink">
      <listitem>
       <para>
        Indicates whether the pagination is critical or not. 
-       If true and if the server doesn't support pagination, the search
+       If &true; and if the server doesn't support pagination, the search
        will return no result.
       </para>
      </listitem>

reference/luasandbox/luasandbox/callfunction.xml

@@ -22,7 +22,7 @@
    recursive table accesses, as if the name were a Lua expression.
   </para>
   <para>
-   If the variable does not exist, or is not a function, false will be
+   If the variable does not exist, or is not a function, &false; will be
    returned and a warning issued.
   </para>
   <para>

reference/memcached/callbacks.xml

@@ -65,7 +65,7 @@ array(3) {
    Read-through cache callbacks are invoked when an item cannot be retrieved
    from the server. The callback is passed the Memcached object, the requested
    key, and the by-reference value variable. The callback is responsible for
-   setting the value and returning true or false. If the callback returns true,
+   setting the value and returning &true; or false. If the callback returns true,
    Memcached will store the populated value on the server and return it to the
    original calling function. Only <methodname>Memcached::get</methodname> and
    <methodname>Memcached::getByKey</methodname> support these callbacks,

reference/memcached/memcached/ispersistent.xml

@@ -28,7 +28,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Returns true if Memcache instance uses a persistent connection, false otherwise.
+   Returns &true; if Memcache instance uses a persistent connection, &false; otherwise.
   </para>
  </refsect1>
 

reference/memcached/memcached/ispristine.xml

@@ -27,7 +27,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Returns the true if instance is recently created, false otherwise.
+   Returns the &true; if instance is recently created, &false; otherwise.
   </para>
  </refsect1>
 

reference/mysql_xdevapi/mysql_xdevapi/collection/createindex.xml

@@ -61,7 +61,7 @@
       </listitem>
       <listitem>
         <para>
-          <code>required</code>: bool, (optional) true if the field is required to exist in the document. 
+          <code>required</code>: bool, (optional) &true; if the field is required to exist in the document. 
           Defaults to &false;, except for <literal>GEOJSON</literal> where it defaults to &true;.
          </para>
        </listitem>