Use informal variant of tag instead of empty title tag (php#3928)

lufei · Oct 28, 2024 · 2a52232 · 2a52232
1 parent 6585fbf
commit 2a52232
Show file tree

Hide file tree

Showing 5 changed files with 17 additions and 29 deletions.
diff --git a/reference/snmp/snmp.xml b/reference/snmp/snmp.xml
@@ -165,8 +165,7 @@
      <term><varname>valueretrieval</varname></term>
      <listitem>
       <para>Controls the method how the SNMP values will be returned</para>
-      <table>
-       <title/>
+      <informaltable>
        <tgroup cols="2">
         <tbody>
          <row><entry><constant>SNMP_VALUE_LIBRARY</constant></entry><entry>The return values will be as returned by the Net-SNMP library.</entry></row>
@@ -181,7 +180,7 @@
          </row>
         </tbody>
        </tgroup>
-      </table>
+      </informaltable>
 
      </listitem>
     </varlistentry>

diff --git a/reference/snmp/snmp/construct.xml b/reference/snmp/snmp/construct.xml
@@ -46,8 +46,7 @@
       it will be resolved by php-snmp library, not by Net-SNMP engine. Usage
       of IPv6 addresses when specifying FQDN may be forced by enclosing FQDN
       into square brackets. Here it is some examples:
-     <table>
-      <title/>
+     <informaltable>
       <tgroup cols="2">
        <tbody>
         <row><entry>IPv4 with default port</entry><entry>127.0.0.1</entry></row>
@@ -60,7 +59,7 @@
         <row><entry>FQDN with specific port, force usage of IPv6 address</entry><entry>[host.domain]:1161</entry></row>
        </tbody>
       </tgroup>
-     </table>
+     </informaltable>
      </para>
     </listitem>
    </varlistentry>
@@ -69,16 +68,15 @@
     <listitem>
      <para>The purpuse of <parameter>community</parameter> is
      <acronym>SNMP</acronym> version specific:</para>
-     <table>
-      <title/>
+     <informaltable>
       <tgroup cols="2">
        <tbody>
         <row><entry>SNMP::VERSION_1</entry><entry><acronym>SNMP</acronym> community</entry></row>
         <row><entry>SNMP::VERSION_2C</entry><entry><acronym>SNMP</acronym> community</entry></row>
         <row><entry>SNMP::VERSION_3</entry><entry><acronym>SNMP</acronym>v3 securityName</entry></row>
        </tbody>
       </tgroup>
-     </table>
+     </informaltable>
     </listitem>
    </varlistentry>
     <varlistentry>

diff --git a/reference/strings/functions/echo.xml b/reference/strings/functions/echo.xml
@@ -133,10 +133,8 @@ echo $some_var ? 'true': 'false'; // evaluating the expression first and passing
     function call. However, this can be misleading, because the parentheses are actually
     part of the expression being output, not part of the <literal>echo</literal>
     syntax itself.
-   </para>
-   <para>
-    <example>
-     <title/>
+
+    <informalexample>
      <programlisting role="php">
      <![CDATA[
 <?php
@@ -161,7 +159,7 @@ echo("hello", " world");
 ?>
 ]]>
     </programlisting>
-   </example>
+   </informalexample>
   </para>
   </note>
 

diff --git a/reference/strings/functions/print.xml b/reference/strings/functions/print.xml
@@ -108,10 +108,8 @@ if ( print "hello" ) {
     function call. However, this can be misleading, because the parentheses are actually
     part of the expression being output, not part of the <literal>print</literal>
     syntax itself.
-   </para>
-   <para>
-    <example>
-     <title/>
+
+    <informalexample>
      <programlisting role="php">
 <![CDATA[
 <?php
@@ -138,18 +136,15 @@ else {
 ?>
 ]]>
      </programlisting>
-    </example>
+    </informalexample>
    </para>
 
    <para>
     When using <literal>print</literal> in a larger expression, placing both the
     keyword and its argument in parentheses may be necessary to give the intended
     result:
-   </para>
 
-   <para>
-    <example>
-     <title/>
+    <informalexample>
      <programlisting role="php">
 <![CDATA[
 <?php
@@ -174,7 +169,7 @@ print "hello " && print "world";
 ?>
 ]]>
      </programlisting>
-    </example>
+    </informalexample>
    </para>
   </note>
 

diff --git a/reference/var/functions/debug-zval-dump.xml b/reference/var/functions/debug-zval-dump.xml
@@ -109,10 +109,8 @@ string(11) "Hello World" refcount(3)
     The parameter passing also prevents <function>debug_zval_dump</function>
     showing variables which have been assigned by reference. To illustrate,
     consider a slightly modified version of the above example:
-   </para>
-   <para>
-    <example>
-     <title/>
+
+    <informalexample>
      <programlisting role="php">
 <![CDATA[
 <?php
@@ -132,7 +130,7 @@ debug_zval_dump($var1);
 string(11) "Hello World" refcount(2)
 ]]>
      </screen>
-    </example>
+    </informalexample>
    </para>
    <para>
     Although <varname>$var1</varname>, <varname>$var2</varname>, and