com doc/ja: bindtextdomain()'s second arg is nullable now: reference/gettext/functions/bind-textdomain-codeset.xml reference/gettext/functions/bindtextdomain.xml

Commit:    cba3f0e39a1e3372809586360b7bbdaf94799350
Author:    Yoshinari Takaoka <[email protected]>         Tue, 26 Jan 2021 00:45:59 +0900
Parents:   0789871dac948ccdeeb2639a2408a6ba75d70105
Branches:  master

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

Log:
bindtextdomain()'s second arg is nullable now

Cf. <https://github.com/php/php-src/pull/6631>.

Changed paths:
  M  reference/gettext/functions/bind-textdomain-codeset.xml
  M  reference/gettext/functions/bindtextdomain.xml


Diff:
diff --git a/reference/gettext/functions/bind-textdomain-codeset.xml b/reference/gettext/functions/bind-textdomain-codeset.xml
index 5dbd95e7da..8ed9b52d88 100644
--- a/reference/gettext/functions/bind-textdomain-codeset.xml
+++ b/reference/gettext/functions/bind-textdomain-codeset.xml
@@ -5,7 +5,7 @@
 <refentry xml:id="function.bind-textdomain-codeset" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>bind_textdomain_codeset</refname>
-  <refpurpose>DOMAIN メッセージカタログから返されるメッセージの文字エンコーディングを指定する</refpurpose>
+  <refpurpose>DOMAIN メッセージカタログから返されるメッセージの文字エンコーディングを設定/取得する</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -13,13 +13,13 @@
   <methodsynopsis>
    <type class="union"><type>string</type><type>false</type></type><methodname>bind_textdomain_codeset</methodname>
    <methodparam><type>string</type><parameter>domain</parameter></methodparam>
-   <methodparam><type>string</type><parameter>codeset</parameter></methodparam>
+   <methodparam><type class="union"><type>string</type><type>null</type></type><parameter>codeset</parameter></methodparam>
   </methodsynopsis>
   <para>
    <function>bind_textdomain_codeset</function> を使用することで、
    <function>gettext</function> やその類似の関数において返される、
    <parameter>domain</parameter> からのメッセージの文字エンコーディングを
-   設定することが可能です。
+   設定したり、取得することが可能です。
   </para>
  </refsect1>
 
@@ -40,6 +40,7 @@
      <listitem>
       <para>
        コードセット。
+       &null; を指定すると、現在設定されているエンコーディングが返されます。
       </para>
      </listitem>
     </varlistentry>
@@ -53,6 +54,31 @@
    成功した場合に文字列を返します。
   </para>
  </refsect1>
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.0.3</entry>
+      <entry>
+       <parameter>codeset</parameter> は、nullable になりました。
+       これより前のバージョンでは、
+       現在設定されているエンコーディングは取得できませんでした。
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
 </refentry>
 <!-- Keep this comment at the end of the file
 Local variables:
diff --git a/reference/gettext/functions/bindtextdomain.xml b/reference/gettext/functions/bindtextdomain.xml
index 4a2cdd31ff..4ea81db87b 100644
--- a/reference/gettext/functions/bindtextdomain.xml
+++ b/reference/gettext/functions/bindtextdomain.xml
@@ -4,7 +4,7 @@
 <refentry xml:id="function.bindtextdomain" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>bindtextdomain</refname>
-  <refpurpose>ドメインのパスを設定する</refpurpose>
+  <refpurpose>ドメインのパスを取得/設定する</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -12,10 +12,10 @@
   <methodsynopsis>
    <type class="union"><type>string</type><type>false</type></type><methodname>bindtextdomain</methodname>
    <methodparam><type>string</type><parameter>domain</parameter></methodparam>
-   <methodparam><type>string</type><parameter>directory</parameter></methodparam>
+   <methodparam><type class="union"><type>string</type><type>null</type></type><parameter>directory</parameter></methodparam>
   </methodsynopsis>
   <para>
-   <function>bindtextdomain</function> 関数は、ドメインへのパスを設定します。
+   <function>bindtextdomain</function> 関数は、ドメインへのパスを取得/設定します。
   </para>
  </refsect1>
 
@@ -36,6 +36,7 @@
      <listitem>
       <para>
        ディレクトリのパス。
+       &null; を指定すると、現在設定されているディレクトリが返されます。
       </para>
      </listitem>
     </varlistentry>
@@ -47,9 +48,33 @@
   &reftitle.returnvalues;
   <para>
    現在設定されているドメインへのフルパスを返します。
+   &return.falseforfailure;
   </para>
  </refsect1>
   
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.0.3</entry>
+      <entry>
+       <parameter>directory</parameter> は、nullable になりました。
+       これより前のバージョンでは、現在設定されているディレクトリを取得できませんでした。
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>