php/archived-doc-zh
1
0
Fork 0
mirror of https://github.com/php/doc-zh.git synced 2026-03-23 22:52:08 +01:00
Code Issues Packages Projects Releases Wiki Activity

readline: fix XML to remove useless wrapping para tags via script

Browse Source
This commit is contained in:
Gina Peter Banyard
2026-01-26 15:31:36 +00:00
parent 9a623afdaa
commit 653076f0a7
10 changed files with 194 additions and 225 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
reference/readline/functions/readline-add-history.xml
View File

@@ -1,13 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2ab6e3ff1677d26786a443fa370719bfb4eba9cb Maintainer: Szopen Xiao Status: ready -->
<!-- EN-Revision: 3c4eb41f4747d9f6e8ae17574177d92a2d1d5810 Maintainer: Szopen Xiao Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.readline-add-history" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.readline-add-history">
<refnamediv>
<refname>readline_add_history</refname>
<refpurpose>添加一行到历史</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@@ -21,18 +21,16 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>prompt</parameter></term>
<listitem>
<para>
添加到历史中的行。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>prompt</parameter></term>
<listitem>
<para>
添加到历史中的行。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">

70
reference/readline/functions/readline-callback-handler-install.xml
View File

@@ -1,13 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2ab6e3ff1677d26786a443fa370719bfb4eba9cb Maintainer: Szopen Xiao Status: ready -->
<!-- EN-Revision: 3c4eb41f4747d9f6e8ae17574177d92a2d1d5810 Maintainer: Szopen Xiao Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.readline-callback-handler-install" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.readline-callback-handler-install">
<refnamediv>
<refname>readline_callback_handler_install</refname>
<refpurpose>初始化 readline 回调接口和终端，然后打印提示并立即返回</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@@ -26,26 +26,24 @@
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>prompt</parameter></term>
<listitem>
<para>
提示信息。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>callback</parameter></term>
<listitem>
<para>
<parameter>callback</parameter> 函数接受一个参数；返回用户输入。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>prompt</parameter></term>
<listitem>
<para>
提示信息。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>callback</parameter></term>
<listitem>
<para>
<parameter>callback</parameter> 函数接受一个参数；返回用户输入。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -54,13 +52,12 @@
&return.true.always;
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Readline 回调接口示例</title>
<programlisting role="php">
<example>
<title>Readline 回调接口示例</title>
<programlisting role="php">
<![CDATA[
<?php
function rl_callback($ret)
@@ -96,20 +93,17 @@ while ($prompting) {
echo "Prompting disabled. All done.\n";
?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>readline_callback_handler_remove</function></member>
<member><function>readline_callback_read_char</function></member>
<member><function>stream_select</function></member>
</simplelist>
</para>
<simplelist>
<member><function>readline_callback_handler_remove</function></member>
<member><function>readline_callback_read_char</function></member>
<member><function>stream_select</function></member>
</simplelist>
</refsect1>
</refentry>

21
reference/readline/functions/readline-callback-handler-remove.xml
View File

@@ -1,13 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 5106807f258ed4b465f89b9faf4375f628e02b98 Maintainer: Szopen Xiao Status: ready -->
<!-- EN-Revision: 3c4eb41f4747d9f6e8ae17574177d92a2d1d5810 Maintainer: Szopen Xiao Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.readline-callback-handler-remove" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.readline-callback-handler-remove">
<refnamediv>
<refname>readline_callback_handler_remove</refname>
<refpurpose>移除之前已安装的回调函数句柄并且恢复终端设置</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@@ -23,14 +23,14 @@
&reftitle.parameters;
&no.function.parameters;
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
如果移除了之前已安装的回调句柄，返回 &true; 或者如果没有找到的话返回 &false;。
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
@@ -40,16 +40,13 @@
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>readline_callback_handler_install</function></member>
<member><function>readline_callback_read_char</function></member>
</simplelist>
</para>
<simplelist>
<member><function>readline_callback_handler_install</function></member>
<member><function>readline_callback_read_char</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

21
reference/readline/functions/readline-callback-read-char.xml
View File

@@ -1,18 +1,18 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 5106807f258ed4b465f89b9faf4375f628e02b98 Maintainer: Szopen Xiao Status: ready -->
<!-- EN-Revision: 3c4eb41f4747d9f6e8ae17574177d92a2d1d5810 Maintainer: Szopen Xiao Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.readline-callback-read-char" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.readline-callback-read-char">
<refnamediv>
<refname>readline_callback_read_char</refname>
<refpurpose>当一个行被接收时读取一个字符并且通知 readline 回调接口</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>void</type><methodname>readline_callback_read_char</methodname>
<void />
<void/>
</methodsynopsis>
<para>
读取用户输入中的一个字符。当一行被接收时，这个函数将通知使用
@@ -32,7 +32,7 @@
&return.void;
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
@@ -42,16 +42,13 @@
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>readline_callback_handler_install</function></member>
<member><function>readline_callback_handler_remove</function></member>
</simplelist>
</para>
<simplelist>
<member><function>readline_callback_handler_install</function></member>
<member><function>readline_callback_handler_remove</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

28
reference/readline/functions/readline-completion-function.xml
View File

@@ -1,13 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: cef062f45e1ba5691158b591381a9a9efc1e346d Maintainer: Szopen Xiao Status: ready -->
<!-- EN-Revision: 3c4eb41f4747d9f6e8ae17574177d92a2d1d5810 Maintainer: Szopen Xiao Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.readline-completion-function" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.readline-completion-function">
<refnamediv>
<refname>readline_completion_function</refname>
<refpurpose>注册完成函数</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@@ -21,18 +21,16 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>callback</parameter></term>
<listitem>
<para>
必须提供现有的函数名，该函数接受部分命令行并返回可能的匹配项数组。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>callback</parameter></term>
<listitem>
<para>
必须提供现有的函数名，该函数接受部分命令行并返回可能的匹配项数组。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">

44
reference/readline/functions/readline-info.xml
View File

@@ -1,13 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d8ba69fe4e7c835bc2b76dcd908597f75d1c65a1 Maintainer: Szopen Xiao Status: ready -->
<!-- EN-Revision: 3c4eb41f4747d9f6e8ae17574177d92a2d1d5810 Maintainer: Szopen Xiao Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.readline-info" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.readline-info">
<refnamediv>
<refname>readline_info</refname>
<refpurpose>获取/设置各种 readline 内部变量</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@@ -22,26 +22,24 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>var_name</parameter></term>
<listitem>
<para>
变量名。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>value</parameter></term>
<listitem>
<para>
如果提供，将是设置的新值。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>var_name</parameter></term>
<listitem>
<para>
变量名。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>value</parameter></term>
<listitem>
<para>
如果提供，将是设置的新值。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">

28
reference/readline/functions/readline-read-history.xml
View File

@@ -1,13 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: cef062f45e1ba5691158b591381a9a9efc1e346d Maintainer: Szopen Xiao Status: ready -->
<!-- EN-Revision: 3c4eb41f4747d9f6e8ae17574177d92a2d1d5810 Maintainer: Szopen Xiao Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.readline-read-history" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.readline-read-history">
<refnamediv>
<refname>readline_read_history</refname>
<refpurpose>读取历史</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@@ -21,18 +21,16 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>filename</parameter></term>
<listitem>
<para>
包含命令行历史的文件路径。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>filename</parameter></term>
<listitem>
<para>
包含命令行历史的文件路径。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">

28
reference/readline/functions/readline-write-history.xml
View File

@@ -1,13 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: cef062f45e1ba5691158b591381a9a9efc1e346d Maintainer: Szopen Xiao Status: ready -->
<!-- EN-Revision: 3c4eb41f4747d9f6e8ae17574177d92a2d1d5810 Maintainer: Szopen Xiao Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.readline-write-history" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.readline-write-history">
<refnamediv>
<refname>readline_write_history</refname>
<refpurpose>写入历史记录</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@@ -21,18 +21,16 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>filename</parameter></term>
<listitem>
<para>
保存文件的路径.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>filename</parameter></term>
<listitem>
<para>
保存文件的路径.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">

40
reference/readline/functions/readline.xml
View File

@@ -1,13 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: cef062f45e1ba5691158b591381a9a9efc1e346d Maintainer: Szopen Xiao Status: ready -->
<!-- EN-Revision: 3c4eb41f4747d9f6e8ae17574177d92a2d1d5810 Maintainer: Szopen Xiao Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<refentry xml:id="function.readline" xmlns="http://docbook.org/ns/docbook">
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.readline">
<refnamediv>
<refname>readline</refname>
<refpurpose>读取一行</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@@ -21,18 +21,16 @@
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>prompt</parameter></term>
<listitem>
<para>
可以指定字符串来作为用户的提示信息。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry>
<term><parameter>prompt</parameter></term>
<listitem>
<para>
可以指定字符串来作为用户的提示信息。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
@@ -45,10 +43,9 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>readline</function> 示例</title>
<programlisting role="php">
<example>
<title><function>readline</function> 示例</title>
<programlisting role="php">
<![CDATA[
<?php
//get 3 commands from user
@@ -64,9 +61,8 @@ print_r(readline_list_history());
print_r(readline_info());
?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
</refsect1>
</refentry>

111
reference/readline/ini.xml
View File

@@ -1,70 +1,65 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: aab33d644359aba597e810e2fc0c0caa0d347c9c Maintainer: Szopen Xiao Status: ready -->
<!-- EN-Revision: 3c4eb41f4747d9f6e8ae17574177d92a2d1d5810 Maintainer: Szopen Xiao Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<section xml:id="readline.configuration" xmlns="http://docbook.org/ns/docbook">
<section xmlns="http://docbook.org/ns/docbook" xml:id="readline.configuration">
&reftitle.runtime;
&extension.runtime;
<para>
<table>
<title>Readline &ConfigureOptions;</title>
<tgroup cols="4">
<thead>
<row>
<entry>&Name;</entry>
<entry>&Default;</entry>
<entry>&Changeable;</entry>
<entry>&Changelog;</entry>
</row>
</thead>
<tbody xml:id="readline.configuration.list">
<row>
<entry><link linkend="ini.cli.pager">cli.pager</link></entry>
<entry>""</entry>
<entry><constant>INI_ALL</constant></entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.cli.prompt">cli.prompt</link></entry>
<entry>"\\b \\> "</entry>
<entry><constant>INI_ALL</constant></entry>
<entry></entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<table>
<title>Readline &ConfigureOptions;</title>
<tgroup cols="4">
<thead>
<row>
<entry>&Name;</entry>
<entry>&Default;</entry>
<entry>&Changeable;</entry>
<entry>&Changelog;</entry>
</row>
</thead>
<tbody xml:id="readline.configuration.list">
<row>
<entry><link linkend="ini.cli.pager">cli.pager</link></entry>
<entry>""</entry>
<entry><constant>INI_ALL</constant></entry>
<entry/>
</row>
<row>
<entry><link linkend="ini.cli.prompt">cli.prompt</link></entry>
<entry>"\\b \\&gt; "</entry>
<entry><constant>INI_ALL</constant></entry>
<entry/>
</row>
</tbody>
</tgroup>
</table>
&ini.descriptions.title;
<para>
<variablelist>
<varlistentry xml:id="ini.cli.pager">
<term>
<parameter>cli.pager</parameter>
<type>string</type>
</term>
<listitem>
<para>
<link linkend="features.commandline">命令行</link>显示输出的外部工具。
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.cli.prompt">
<term>
<parameter>cli.prompt</parameter>
<type>string</type>
</term>
<listitem>
<para>
<link linkend="features.commandline">命令行</link>提示。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry xml:id="ini.cli.pager">
<term>
<parameter>cli.pager</parameter>
<type>string</type>
</term>
<listitem>
<para>
<link linkend="features.commandline">命令行</link>显示输出的外部工具。
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.cli.prompt">
<term>
<parameter>cli.prompt</parameter>
<type>string</type>
</term>
<listitem>
<para>
<link linkend="features.commandline">命令行</link>提示。
</para>
</listitem>
</varlistentry>
</variablelist>
</section>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml