Improve SOAP constructor docs

php/doc-en@f309e78

Author: mumumu

reference/soap/constants.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 37280533a76693adac626a37ffc8daa2276400ce Maintainer: shimooka Status: ready -->
+<!-- EN-Revision: f309e78f9439ae5d063a284cefb4b375233aa785 Maintainer: shimooka Status: ready -->
 <!-- Generated by xml_proto.php v2.0. Found in /scripts directory of phpdoc. -->
 <appendix xml:id="soap.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.constants;

reference/soap/soapclient/construct.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 22583751fbfdaa3eaa41aeb6470d1343f5cb2c78 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: f309e78f9439ae5d063a284cefb4b375233aa785 Maintainer: mumumu Status: ready -->
 
 <refentry xml:id="soapclient.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -30,7 +30,7 @@
      <term><parameter>wsdl</parameter></term>
      <listitem>
       <para>
-       サービスを記述した WSDL ファイルまたは URI。
+       サービスを記述した <acronym>WSDL</acronym> ファイルまたは URI。
        これは自動的にクライアントを設定します。
        指定されない場合、クライアントは 非WSDL モードで動作します。
       </para>
@@ -644,7 +644,7 @@
            <constant>SOAP_SSL_METHOD_SSLv23</constant>
            を指定しても意味がありません。
            これは後方互換のためだけに存在しています。
-           PHP 7.2 以降では、
+           PHP 7.2.0 以降では、
            <constant>SOAP_SSL_METHOD_TLS</constant>
            を指定しても同様に意味がありません。
            これより前のバージョンでは、
@@ -657,18 +657,19 @@
           </para>
           <para>
            このオプションは
-           PHP 8.1.0 以降では <emphasis>推奨されません</emphasis>。
+           PHP 8.1.0 以降では
+           <emphasis role="strong">推奨されません</emphasis>。
            個別の TLS のバージョンを指定できる、
            より柔軟性に富んだ代替があります。
            <link linkend="soapclient.construct.options.stream-context">
            <parameter>stream_context</parameter></link> オプションを
            'crypto_method'
            コンテキストパラメータと一緒に使うようにして下さい。
-           <example>
-            <title>TLS 1.3 だけを指定する</title>
+           <informalexample>
             <programlisting role="php">
 <![CDATA[
 <?php
+// TLS 1.3 のみを使うよう指定
 $context = stream_context_create([
     'ssl' => [
         'crypto_method' => STREAM_CRYPTO_METHOD_TLSv1_3_CLIENT
@@ -677,7 +678,7 @@ $context = stream_context_create([
 $client = new SoapClient("some.wsdl", ['context' => $context]);
 ]]>
             </programlisting>
-           </example>
+           </informalexample>
           </para>
          </listitem>
         </varlistentry>