Remove GNU Readline in favor of libedit (php#912)

lufei · Sep 26, 2024 · e9b2a5d · e9b2a5d
1 parent 33dc84f
commit e9b2a5d
Show file tree

Hide file tree

Showing 3 changed files with 36 additions and 15 deletions.
diff --git a/reference/readline/book.xml b/reference/readline/book.xml
@@ -1,17 +1,17 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 462ad78d00fa08794ac8aeed9e79f8ab3d4ca371 Maintainer: Szopen Xiao Status: ready -->
-<!-- CREDITS: mowangjuanzi -->
+<!-- EN-Revision: b9582e11e41e0d06e1bd4a499ce6db383692759b Maintainer: Szopen Xiao Status: ready -->
+<!-- CREDITS: mowangjuanzi, Luffy -->
 <book xml:id="book.readline" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <?phpdoc extension-membership="bundledexternal" ?>
- <title>GNU Readline</title>
+ <title>Readline</title>
  <titleabbrev>Readline</titleabbrev>
 
  <!-- {{{ preface -->
  <preface xml:id="intro.readline">
   &reftitle.intro;
   <para>
-   readline 扩展函数实现了访问 GNU Readline 库的接口。这些函数提供了可编辑的命令行。一个例子是在 Bash
+   readline 扩展函数实现了访问 libedit 库的接口。这些函数提供了可编辑的命令行。一个例子是在 Bash
    中允许使用箭头按键来插入字符或者翻看历史命令。因为这个库的交互特性，对编写 Web
    应用程序没多大用处，但当编写从<link linkend="features.commandline">命令行</link>使用的脚本时非常有用.
   </para>

diff --git a/reference/readline/configure.xml b/reference/readline/configure.xml
@@ -1,17 +1,41 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: d92890ef469c2527326bcb4a6730892eee3c96cb Maintainer: Szopen Xiao Status: ready -->
-<!-- CREDITS: mowangjuanzi -->
+<!-- EN-Revision: b9582e11e41e0d06e1bd4a499ce6db383692759b Maintainer: Szopen Xiao Status: ready -->
+<!-- CREDITS: mowangjuanzi, Luffy -->
 <section xml:id="readline.installation" xmlns="http://docbook.org/ns/docbook">
  &reftitle.install;
  <para>
-  要使用这些函数，必须编译支持 readline 的 PHP 的 CGI 或者 CLI 版本。需要配置 PHP <option
-  role="configure">--with-readline[=DIR]</option>。如果想使用 libedit 代替 readline，配置 PHP
-  <option role="configure">--with-libedit[=DIR]</option>。
+  要使用这些函数，必须编译支持 readline 的 PHP 的 CGI 或者 CLI 版本。需要配置 PHP
+  <option role="configure">--with-readline</option>。
  </para>
  <para>
   在 Windows 上，此扩展自 PHP 7.1.0 起默认可用。
  </para>
+ <simplesect role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        配置选项 <option role="configure">--with-libedit</option> 已被移除，取而代之的是
+        <option role="configure">--with-readline</option>，该选项不再接受 DIR 参数，而是使用
+        pkg-config 并链接到 libedit 库，这是 GNU Readline 库的非 GPL 替代品。
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </simplesect>
 </section>
 
 <!-- Keep this comment at the end of the file

diff --git a/reference/readline/setup.xml b/reference/readline/setup.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: Szopen Xiao Status: ready -->
+<!-- EN-Revision: b9582e11e41e0d06e1bd4a499ce6db383692759b Maintainer: Szopen Xiao Status: ready -->
 <!-- CREDITS: mowangjuanzi, Luffy -->
 <chapter xml:id="readline.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.setup;
@@ -9,11 +9,8 @@
  <section xml:id="readline.requirements">
   &reftitle.required;
   <para>
-   如果要使用 readline 函数，必须安装 libreadline。可以在 GNU readline 项目主页找到 libreadline，在
-   <link xlink:href="&url.readline;">&url.readline;</link>。由 Chet Ramey 维护，他也是 Bash 的作者。
-  </para>
-  <para>
-   也能使用非 GPL 的 libedit 库来替代 readline 库，libedit 库是使用 BSD 证书，可以从 <link xlink:href="&url.libedit;">&url.libedit;</link> 下载。
+   要使用 readline 函数，必须安装 libedit 库。libedit 库是 BSD 许可的，可以从
+   <link xlink:href="&url.libedit;">&url.libedit;</link> 下载。
   </para>
  </section>
  <!-- }}} -->