bindtextdomain()'s second arg is nullable now

Cf. <php/php-src#6631>.

Author: mumumu

reference/gettext/functions/bind-textdomain-codeset.xml

@@ -5,21 +5,21 @@
 <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">
   &reftitle.description;
   <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:

reference/gettext/functions/bindtextdomain.xml

@@ -4,18 +4,18 @@
 <refentry xml:id="function.bindtextdomain" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>bindtextdomain</refname>
-  <refpurpose>ドメインのパスを設定する</refpurpose>
+  <refpurpose>ドメインのパスを取得/設定する</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
   &reftitle.description;
   <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>