Update the methodsynopsis of some recently changed stubs (php/doc-en#625)

Author: mumumu

reference/session/sessionhandler/read.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 151e61773c016edcae8fd4989ad9a86ffd03c283 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 1367cac761756ee4fce7c63be945b115f2924795 Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 
 <refentry xml:id="sessionhandler.read" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -12,7 +12,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier>public</modifier> <type>string</type><methodname>SessionHandler::read</methodname>
+   <modifier>public</modifier> <type class="union"><type>string</type><type>false</type></type><methodname>SessionHandler::read</methodname>
    <methodparam><type>string</type><parameter>id</parameter></methodparam>
   </methodsynopsis>
   <para>
@@ -57,7 +57,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   読み込んだデータを常に文字列で返します。何も読まなかった場合は空文字列を返さなければなりません。
+   読み込んだデータを常に文字列で返します。何も読まなかった場合は &false; を返さなければなりません。
    この値は、PHP の内部で処理されるものであることに注意しましょう。
   </para>
  </refsect1>

reference/session/sessionhandlerinterface/read.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 151e61773c016edcae8fd4989ad9a86ffd03c283 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 1367cac761756ee4fce7c63be945b115f2924795 Maintainer: takagi Status: ready -->
 
 <refentry xml:id="sessionhandlerinterface.read" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -11,7 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier>abstract</modifier> <modifier>public</modifier> <type>string</type><methodname>SessionHandlerInterface::read</methodname>
+   <modifier>public</modifier> <type class="union"><type>string</type><type>false</type></type><methodname>SessionHandlerInterface::read</methodname>
    <methodparam><type>string</type><parameter>id</parameter></methodparam>
   </methodsynopsis>
   <para>
@@ -25,7 +25,7 @@
    このメソッドは、指定したセッション ID のセッションデータをストレージから取得しなければなりません。
    返す文字列の書式は、<function>SessionHandlerInterface::write</function>
    に渡されたものと同様にシリアライズされたものでなければなりません。
-   データが見つからない場合は空文字列を返します。
+   データが見つからない場合は &false; を返します。
   </para>
   <para>
    このメソッドが返すデータは、PHP が内部的にデコードします。デコードに使うメソッドは

reference/simplexml/simplexmlelement/addChild.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 5916fd8f742127259912e6510904451849928020 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 1367cac761756ee4fce7c63be945b115f2924795 Maintainer: takagi Status: ready -->
 <refentry xml:id="simplexmlelement.addchild" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>SimpleXMLElement::addChild</refname>
@@ -11,7 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier>public</modifier> <type>SimpleXMLElement</type><methodname>SimpleXMLElement::addChild</methodname>
+   <modifier>public</modifier> <type class="union"><type>SimpleXMLElement</type><type>null</type></type><methodname>SimpleXMLElement::addChild</methodname>
    <methodparam><type>string</type><parameter>qualifiedName</parameter></methodparam>
    <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>value</parameter><initializer>&null;</initializer></methodparam>
    <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>namespace</parameter><initializer>&null;</initializer></methodparam>
@@ -59,6 +59,7 @@
    <literal>addChild</literal> メソッドは、
    XML ノードに追加した子要素を表す
    <type>SimpleXMLElement</type> オブジェクトを返します。
+   失敗時に &null; を返します。
   </para>
  </refsect1>
 

reference/simplexml/simplexmlelement/xpath.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 5916fd8f742127259912e6510904451849928020 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 1367cac761756ee4fce7c63be945b115f2924795 Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa,shimooka -->
 <refentry xml:id="simplexmlelement.xpath" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -11,7 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier>public</modifier> <type class="union"><type>array</type><type>false</type></type><methodname>SimpleXMLElement::xpath</methodname>
+   <modifier>public</modifier> <type class="union"><type>array</type><type>null</type><type>false</type></type><methodname>SimpleXMLElement::xpath</methodname>
    <methodparam><type>string</type><parameter>expression</parameter></methodparam>
   </methodsynopsis>
   <para>
@@ -41,7 +41,7 @@
   &reftitle.returnvalues;
   <para>
    SimpleXMLElement オブジェクトの<type>配列</type>を返します。
-   エラーが発生した場合は &false; を返します。
+   エラーが発生した場合は &null; または &false; を返します。
   </para>
  </refsect1>