com doc/ja: Update "How to read a function definition" section: appendices/about.xml

Commit:    01f9f4dd5978fe41c635ebcfefa0e11033a82aed
Author:    Yoshinari Takaoka <[email protected]>         Tue, 5 Jan 2021 14:49:32 +0900
Parents:   89f23d410238a202a02b7ca58db76ddbc069c75f
Branches:  master

Link:       http://git.php.net/?p=doc/ja.git;a=commitdiff;h=01f9f4dd5978fe41c635ebcfefa0e11033a82aed

Log:
Update "How to read a function definition" section

Since there are barely any differences to user defined functions, this
section could mostly be dropped, but for now we just update to match
the manual proper. See also <https://github.com/php/phd/pull/37>.

Changed paths:
  M  appendices/about.xml


Diff:
diff --git a/appendices/about.xml b/appendices/about.xml
index 6ebf37d91d..94f8665799 100644
--- a/appendices/about.xml
+++ b/appendices/about.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: bcd51bdf1d04d8b18ed058f8de03cfa2a4c2fb9b Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: takagi,mumumu -->
 
  <appendix xml:id="about" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -145,7 +145,7 @@
 <![CDATA[
 strlen ( string $string ) : int
  
-(PHP 4, PHP 5)
+(PHP 4, PHP 5, PHP 7)
  strlen -- 文字列の長さを得る
  
  説明
@@ -176,10 +176,10 @@ int strlen ( string $string )
          </row>
        <row>
         <entry>
-          (PHP 4, PHP 5)
+          (PHP 4, PHP 5, PHP 7)
         </entry>
         <entry>
-         strlen()は PHP 4 と PHP 5 のすべてのバージョンで使用できる
+         strlen()は PHP 4 と PHP 5、そして PHP 7 のすべてのバージョンで使用できる
         </entry>
        </row>
        <row>
@@ -222,7 +222,7 @@ int strlen ( string $string )
    <para>
     <screen>    
 <![CDATA[
-      in_array ( mixed $needle, array $haystack [, bool $strict = FALSE ] ) : bool
+      in_array ( mixed $needle, array $haystack , bool $strict = false ) : bool
 ]]>
     </screen>
    </para>
@@ -241,8 +241,8 @@ int strlen ( string $string )
       <link linkend="language.types.array">配列</link>でもかまいません。
       <parameter>haystack</parameter> (対象を探す配列)は二番目の引数です。
       三番目の<emphasis>オプション</emphasis>の引数は <parameter>strict</parameter>
-      と名づけられています。全てのオプション引数は
-      <emphasis>[</emphasis> ブラケット <emphasis>]</emphasis>の中に表現されます。
+      と名づけられています。全てのオプション引数はデフォルト値を持ちます。
+      デフォルト値が不明な場合、<literal>?</literal> と表示されます。
       <parameter>strict</parameter> パラメータはデフォルトでは boolean の
       &false; であるとマニュアルに述べられています。機能の詳細については
       各関数のマニュアルをご覧ください。
@@ -254,8 +254,8 @@ int strlen ( string $string )
     <para>
      <screen> 
 <![CDATA[
-       preg_match ( string $pattern , string $subject [, array &$matches
-      [, int $flags = 0 [, int $offset = 0 ]]] ) : int
+       preg_match ( string $pattern , string $subject , array &$matches = null,
+       int $flags = 0 , int $offset = 0 ) : int|false
 ]]>
      </screen>
     </para>
@@ -269,7 +269,7 @@ int strlen ( string $string )
    </para>
    <para>
     <screen>    
-     (PHP 4 >= 4.3.0, PHP 5)
+     (PHP 4 >= 4.3.0, PHP 5, PHP 7)
     </screen>
    </para>
    <para>