Replace <literal> nodes with <constant> for constants

Author: phansys

appendices/migration70/changed-functions.xml

@@ -46,7 +46,7 @@
    <listitem>
     <simpara>
      <function>setlocale</function> function no longer accepts <parameter>category</parameter>
-     passed as string. <constant>LC_*</constant> constants must be used instead.
+     passed as string. <constant>LC_<replaceable>*</replaceable></constant> constants must be used instead.
     </simpara>
    </listitem>
    <listitem>

appendices/migration70/incompatible/removed-functions.xml

@@ -45,7 +45,7 @@
    <function>mcrypt_cbc</function>, <function>mcrypt_cfb</function> and
    <function>mcrypt_ofb</function> functions have been removed in favour of
    using <function>mcrypt_decrypt</function> with the appropriate
-   <constant>MCRYPT_MODE_*</constant> constant.
+   <constant>MCRYPT_MODE_<replaceable>*</replaceable></constant> constant.
   </para>
  </sect3>
 

appendices/migration70/other-changes.xml

@@ -30,7 +30,7 @@ Project::new('Project Name')->private()->for('purpose here')->with('username her
   <para>
    The only limitation is that the <literal>class</literal> keyword still
    cannot be used as a constant name, otherwise it would conflict with the
-   class name resolution syntax (<literal>ClassName::class</literal>).
+   class name resolution syntax (<constant>ClassName::class</constant>).
   </para>
  </sect2>
 

appendices/migration80/other-changes.xml

@@ -73,7 +73,7 @@
       <methodname>ZipArchive::addEmptyDir</methodname>, <methodname>ZipArchive::addFile</methodname>
       and <methodname>ZipArchive::addFromString</methodname>
       methods have a new <parameter>flags</parameter> argument. This allows managing name encoding
-      (<constant>ZipArchive::FL_ENC_*</constant>) and entry replacement
+      (<constant>ZipArchive::FL_ENC_<replaceable>*</replaceable></constant>) and entry replacement
       (<constant>ZipArchive::FL_OVERWRITE</constant>).
      </para>
     </listitem>

language-snippets.ent

@@ -1233,7 +1233,7 @@ Passing untrusted data to this parameter is <emphasis>insecure</emphasis>, unles
 
 <!ENTITY intl.locale-len.return '<para xmlns="http://docbook.org/ns/docbook">Returns &null; when the length of <parameter>locale</parameter> exceeds <constant>INTL_MAX_LOCALE_LEN</constant>.</para>'>
 
-<!ENTITY intl.property.parameter '<para xmlns="http://docbook.org/ns/docbook">The Unicode property to lookup (see the <literal>IntlChar::PROPERTY_*</literal> constants).</para>'>
+<!ENTITY intl.property.parameter '<para xmlns="http://docbook.org/ns/docbook">The Unicode property to lookup (see the <constant>IntlChar::PROPERTY_<replaceable>*</replaceable></constant> constants).</para>'>
 
 <!ENTITY intl.property.example 'Testing different properties'>
 
@@ -1382,7 +1382,7 @@ encoding value will be used.</para>'>
 <!ENTITY memcached.result.delete-multi '<para xmlns="http://docbook.org/ns/docbook">
    Returns an array indexed by <parameter>keys</parameter>. Each element
    is &true; if the corresponding key was deleted, or one of the
-   <constant>Memcached::RES_*</constant> constants if the corresponding deletion
+   <constant>Memcached::RES_<replaceable>*</replaceable></constant> constants if the corresponding deletion
    failed.
    </para>
   <para xmlns="http://docbook.org/ns/docbook">
@@ -2076,7 +2076,7 @@ extensions in order to use these functions.</simpara>'>
 <!-- APD Notes -->
 <!ENTITY apd.debug-level.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
 <parameter>debug_level</parameter></term><listitem><para>An integer which is formed by adding
-together the <literal>XXX_TRACE</literal> constants.</para><para>It is not recommended
+together the <constant><replaceable>*</replaceable>_TRACE</constant> constants.</para><para>It is not recommended
 to use <constant>MEMORY_TRACE</constant>. It is very slow and does not appear to be accurate.
 <constant>ASSIGNMENT_TRACE</constant> is not implemented yet.</para><para>To turn on all
 functional traces (TIMING, FUNCTIONS, ARGS SUMMARY (like strace -c)) use the value 99</para>

language/enumerations.xml

@@ -51,8 +51,8 @@ enum Suit
 
    <para>
     This declaration creates a new enumerated type named <literal>Suit</literal>, which has
-    four and only four legal values: <literal>Suit::Hearts</literal>, <literal>Suit::Diamonds</literal>,
-    <literal>Suit::Clubs</literal>, and <literal>Suit::Spades</literal>. Variables may be assigned
+    four and only four legal values: <constant>Suit::Hearts</constant>, <constant>Suit::Diamonds</constant>,
+    <constant>Suit::Clubs</constant>, and <constant>Suit::Spades</constant>. Variables may be assigned
     to one of those legal values. A function may be type checked against an enumerated type,
     in which case only values of that type may be passed.
    </para>
@@ -91,7 +91,7 @@ pick_a_card('Spades');
    </para>
 
    <para>
-    By default, cases are not intrinsically backed by a scalar value. That is, <literal>Suit::Hearts</literal>
+    By default, cases are not intrinsically backed by a scalar value. That is, <constant>Suit::Hearts</constant>
     is not equal to <literal>"0"</literal>. Instead, each case is backed by a singleton object of that name. That means that:
    </para>
 
@@ -897,8 +897,8 @@ function query($fields, $filter, SortOrder $order = SortOrder::Asc)
     </programlisting>
     <para>
      The <literal>query()</literal> function can now proceed safe in the knowledge that
-     <literal>$order</literal> is guaranteed to be either <literal>SortOrder::Asc</literal>
-     or <literal>SortOrder::Desc</literal>.  Any other value would have resulted in a
+     <literal>$order</literal> is guaranteed to be either <constant>SortOrder::Asc</constant>
+     or <constant>SortOrder::Desc</constant>.  Any other value would have resulted in a
      <classname>TypeError</classname>, so no further error checking or testing is needed.
     </para>
    </example>
@@ -935,9 +935,9 @@ enum UserStatus: string
     </programlisting>
 
     <para>
-     In this example, a user's status may be one of, and exclusively, <literal>UserStatus::Pending</literal>,
-     <literal>UserStatus::Active</literal>, <literal>UserStatus::Suspended</literal>, or
-     <literal>UserStatus::CanceledByUser</literal>.  A function can type a parameter against
+     In this example, a user's status may be one of, and exclusively, <constant>UserStatus::Pending</constant>,
+     <constant>UserStatus::Active</constant>, <constant>UserStatus::Suspended</constant>, or
+     <constant>UserStatus::CanceledByUser</constant>.  A function can type a parameter against
      <literal>UserStatus</literal> and then only accept those four values, period.
     </para>
 

language/oop5/basic.xml

@@ -690,7 +690,7 @@ Stack trace:
     The <literal>class</literal> keyword is also used for class
     name resolution.
     To obtain the fully qualified name of a class <literal>ClassName</literal>
-    use <literal>ClassName::class</literal>. This is particularly useful with
+    use <constant>ClassName::class</constant>. This is particularly useful with
     <link linkend="language.namespaces">namespaced</link> classes.
    </para>
    <para>

reference/com/functions/variant-cast.xml

@@ -39,7 +39,7 @@
      <listitem>
       <para>
        <parameter>type</parameter> should be one of the
-       <constant>VT_XXX</constant> constants.
+       <constant>VT_<replaceable>*</replaceable></constant> constants.
       </para>
      </listitem>
     </varlistentry>

reference/com/functions/variant-get-type.xml

@@ -37,7 +37,7 @@
    <parameter>variant</parameter>, which can be an instance of
    <xref linkend="class.com"/>, <xref linkend="class.dotnet"/> or
    <xref linkend="class.variant"/> classes.  The return value can be compared
-   to one of the <constant>VT_XXX</constant> constants.
+   to one of the <constant>VT_<replaceable>*</replaceable></constant> constants.
   </para>
   <para>
    The return value for COM and DOTNET objects will usually be

reference/com/variant/construct.xml

@@ -35,7 +35,7 @@
     <listitem>
      <simpara>
       Specifies the content type of the variant object. Possible values are
-      one of the <constant>VT_XXX</constant> <xref
+      one of the <constant>VT_<replaceable>*</replaceable></constant> <xref
       linkend="com.constants"/>.
      </simpara>
      <simpara>