Fix and update docs for openssl_csr_new

php/doc-en@b6d0da0

Author: mumumu

reference/openssl/functions/openssl-csr-new.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 5bc68add3da3cd18c40f851e944b15095d3a26aa Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: b6d0da041ac2b5eee3820bf2c2062872f4459dfe Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: takagi,mumumu -->
 <refentry xml:id="function.openssl-csr-new" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -11,9 +11,9 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type class="union"><type>OpenSSLCertificateSigningRequest</type><type>false</type></type><methodname>openssl_csr_new</methodname>
+   <type class="union"><type>OpenSSLCertificateSigningRequest</type><type>bool</type></type><methodname>openssl_csr_new</methodname>
    <methodparam><type>array</type><parameter>distinguished_names</parameter></methodparam>
-   <methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type>OpenSSLAsymmetricKey</type><parameter role="reference">private_key</parameter></methodparam>
+   <methodparam><modifier role="attribute">#[\SensitiveParameter]</modifier><type class="union"><type>OpenSSLAsymmetricKey</type><type>null</type></type><parameter role="reference">private_key</parameter></methodparam>
    <methodparam choice="opt"><type class="union"><type>array</type><type>null</type></type><parameter>options</parameter><initializer>&null;</initializer></methodparam>
    <methodparam choice="opt"><type class="union"><type>array</type><type>null</type></type><parameter>extra_attributes</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
@@ -42,6 +42,9 @@
       <para>
        <parameter>private_key</parameter> には、事前に <function>openssl_pkey_new</function>
        （あるいはその他の openssl_pkey 系の関数）で作成した秘密鍵を設定します。
+       &null; も指定できます。&null; を指定した場合、
+       新しい秘密鍵が <parameter>options</parameter>
+       の指定に基づいて生成され、指定された変数に代入されます。
        これに対応する公開鍵が、<acronym>CSR</acronym> への署名に使用されます。
       </para>
      </listitem>
@@ -162,7 +165,8 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   <acronym>CSR</acronym> を返します。
+   成功した場合、<acronym>CSR</acronym> を返します。
+   CSR の作成に成功したものの、署名に失敗した場合は &true; を返します。
    &return.falseforfailure;
   </para>
  </refsect1>