Document key_length param deprecation in openssl_pkey_derive

php/doc-en@af71bd1

Author: mumumu

reference/openssl/functions/openssl-pkey-derive.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 7fd8e591b8b5a35eda6a0fa6cdecd2a83b195920 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: af71bd1bd3bb0604c7bb3d2ff12019480c842843 Maintainer: mumumu Status: ready -->
 
 <refentry xml:id="function.openssl-pkey-derive" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -55,7 +55,8 @@
      </para>
      <caution>
       <simpara>
-        このパラメータは期待どおりに機能しないため、使用しないでください。
+        このパラメータは非推奨になっているため、使用しないでください。
+        なぜなら、期待どおりに機能しないためです。
         シークレットが素数のサイズよりも長くなることはありません。
         必要な長さが素数のサイズより小さい場合、ECDH キーの場合のみ長さを切り詰めますが、
         DH キーの場合は失敗します。
@@ -74,6 +75,28 @@
   </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.5.0</entry>
+      <entry>
+       <parameter>key_length</parameter> は、推奨されなくなりました。
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>