Skip to content

Commit 1979f8f

Browse files
GirgiasGirgias
committed
mysql : fix XML by converting para to simpara tags via script
1 parent 6a41a55 commit 1979f8f

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

54 files changed

+615
-627
lines changed

‎reference/mysql/book.xml‎

Lines changed: 10 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,29 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- State: deprecated -->
3-
<!-- EN-Revision: 68c2c871505aadf983f16113c5b077b335ce8d76 Maintainer: daijie Status: ready -->
3+
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: daijie Status: ready -->
44
<!-- CREDITS: mowangjuanzi -->
5-
<book xml:id="book.mysql" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
5+
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.mysql">
66
<?phpdoc extension-membership="pecl"?>
77
<title>原始的 MySQL API</title>
88
<titleabbrev>Mysql（原始）</titleabbrev>
99

1010
<!-- {{{ preface -->
1111
<preface xml:id="intro.mysql">
1212
&reftitle.intro;
13-
<para>
13+
<simpara>
1414
从 PHP 5.5.0 起这个扩展已经被废弃，并且从 PHP 7.0.0.
1515
开始被移除。作为替代，可以使用 <link linkend="book.mysqli">mysqli</link> 或者
1616
<link linkend="ref.pdo-mysql">PDO_MySQL</link> 扩展代替。
1717
参见 <link linkend="mysqlinfo.api.choosing">MySQL API
1818
概览</link> 寻找关于选择 MySQL API 的更多帮助。
19-
</para>
20-
<para>
19+
</simpara>
20+
<simpara>
2121
这些函数允许你接入 MySQL 数据库服务器。更多关于 MySQL 的信息：
22-
<link
23-
xlink:href="&url.mysql;">&url.mysql;</link>。
24-
</para>
25-
<para>
26-
关于 MySQL 的文档能在此找到： <link
27-
xlink:href="&url.mysql.docs;">&url.mysql.docs;</link>。
28-
</para>
22+
<link xlink:href="&url.mysql;">&url.mysql;</link>。
23+
</simpara>
24+
<simpara>
25+
关于 MySQL 的文档能在此找到： <link xlink:href="&url.mysql.docs;">&url.mysql.docs;</link>。
26+
</simpara>
2927
</preface>
3028
<!-- }}} -->
3129

@@ -56,4 +54,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
5654
vim: et tw=78 syn=sgml
5755
vi: ts=1 sw=1
5856
-->
59-

‎reference/mysql/changelog.xml‎

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,23 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: daijie Status: ready -->
3+
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: daijie Status: ready -->
44
<!-- CREDITS: mowangjuanzi -->
55
<appendix xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="changelog.mysql">
66
<title>&ChangelogListingTitle;</title>
7-
<para>&ChangelogListingDescription;</para>
7+
<simpara>&ChangelogListingDescription;</simpara>
88

99
<simplesect>
1010
<title>ext/mysql 扩展更新日志概要</title>
11-
<para>
11+
<simpara>
1212
ext/mysql 扩展相关的更新日志。
13-
</para>
13+
</simpara>
1414
</simplesect>
1515

1616
<simplesect xml:id="changelog.mysql.global">
1717
<title>全局 ext/mysql 的变更</title>
18-
<para>
18+
<simpara>
1919
以下列表是整个 ext/mysql 扩展的变动更新。
20-
</para>
20+
</simpara>
2121
<informaltable xml:id="changelog.mysql.global.table">
2222
<tgroup cols="2">
2323
<thead>
@@ -30,10 +30,10 @@
3030
<row>
3131
<entry>7.0.0</entry>
3232
<entry>
33-
<para>
33+
<simpara>
3434
此扩展已从 PHP 中移除。详见
3535
<xref linkend="mysqlinfo.api.choosing"/>.
36-
</para>
36+
</simpara>
3737
</entry>
3838
</row>
3939
</tbody>
@@ -43,9 +43,9 @@
4343

4444
<simplesect xml:id="changelog.mysql.functions">
4545
<title>函数的变更项</title>
46-
<para>
46+
<simpara>
4747
以下列表为 ext/mysql 函数完整的更新历史项。
48-
</para>
48+
</simpara>
4949
<?phpdoc generate-changelog-for="ref.mysql book.mysql"?>
5050
</simplesect>
5151

‎reference/mysql/configure.xml‎

Lines changed: 26 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,36 +1,36 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 40667918dcff1d5c9f7ecdc88b5caca24ba0686c Maintainer: HonestQiao Status: ready -->
3+
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: HonestQiao Status: ready -->
44
<!-- CREDITS: Gregory, mowangjuanzi -->
5-
<section xml:id="mysql.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
5+
<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="mysql.installation">
66
&reftitle.install;
7-
7+
88
<warning>
99
&mysql.alternative.note;
1010
</warning>
1111

12-
<para xml:id="mysql.configure">
12+
<simpara xml:id="mysql.configure">
1313
编译时，只要使用
1414
<option role="configure">--with-mysql[=DIR]</option>
1515
配置选项即可，其中可选的
1616
<literal>[DIR]</literal> 指向 MySQL 的安装目录。
17-
</para>
18-
<para>
17+
</simpara>
18+
<simpara>
1919
虽然本 MySQL 扩展库兼容 MySQL 4.1.0
2020
及其以后版本，但是它不支持这些版本提供的额外功能。要使用这些功能，请使用
2121
<link linkend="book.mysqli">MySQLi</link> 扩展库。
22-
</para>
23-
<para>
22+
</simpara>
23+
<simpara>
2424
如果要同时安装 mysql 扩展库和 mysqli 扩展库，必须使用同一个客户端库以避免任何冲突。
25-
</para>
25+
</simpara>
2626

2727
<section xml:id="mysql.installation.linux">
2828
<title>在 Linux 系统下安装</title>
29-
<para>
30-
Note: <literal>[DIR]</literal> is the path to the MySQL client library
31-
files (<emphasis>headers and libraries</emphasis>), which can be downloaded from
29+
<simpara>
30+
Note: <literal>[DIR]</literal> is the path to the MySQL client library
31+
files (<emphasis>headers and libraries</emphasis>), which can be downloaded from
3232
<link xlink:href="&url.mysql;">MySQL</link>.
33-
</para>
33+
</simpara>
3434
<table xml:id="mysql.installation.compile.support">
3535
<title>ext/mysql compile time support matrix</title>
3636
<tgroup cols="5">
@@ -84,7 +84,7 @@
8484
<title>在 Windows 系统下安装</title>
8585
<section>
8686
<title>PHP 5+</title>
87-
<para>
87+
<simpara>
8888
MySQL 默认未启用，因此必须在 &php.ini; 中激活
8989
<filename>php_mysql.dll</filename> 动态连接库。此外，PHP
9090
还需要访问 MySQL 客户端连接库。PHP 的 Windows
@@ -97,53 +97,51 @@
9797
<filename>libmysql.dll</filename> 拷贝到 Windows
9898
系统目录中也可以（因为系统目录默认在系统路径
9999
<envar>PATH</envar> 中），但不推荐这样做。
100-
</para>
101-
<para>
100+
</simpara>
101+
<simpara>
102102
要激活任何 PHP 扩展库（例如
103103
<filename>php_mysql.dll</filename>），PHP 指令
104104
<link linkend="ini.extension-dir">extension_dir</link>
105-
要被设为 PHP 扩展库所在的目录。参见<link
106-
linkend="install.windows.manual">手工 Windows
105+
要被设为 PHP 扩展库所在的目录。参见<link linkend="install.windows.manual">手工 Windows
107106
安装指南</link>。PHP 5 下 extension_dir 取值的一个例子是
108107
<literal>c:\php\ext</literal>。
109-
</para>
108+
</simpara>
110109
<note>
111-
<para>
110+
<simpara>
112111
如果启动 web 服务器时出现类似如下的错误：<literal>"Unable
113112
to load dynamic library './php_mysql.dll'"</literal>，这是因为系统找不到
114113
<filename>php_mysql.dll</filename> 和／或
115114
<filename>libmysql.dll</filename>。
116-
</para>
115+
</simpara>
117116
</note>
118117
</section>
119118
<section>
120119
<title>PHP 5.3.0+</title>
121-
<para>
120+
<simpara>
122121
The <link linkend="mysqlnd.overview">MySQL Native Driver</link> is enabled by
123122
default. Include <filename>php_mysql.dll</filename>, but <filename>libmysql.dll</filename>
124123
is no longer required or used.
125-
</para>
124+
</simpara>
126125
</section>
127126
</section>
128127

129128
<section xml:id="mysql.installation.notes">
130129
<title>MySQL 安装注意事项</title>
131130
<warning>
132-
<para>
131+
<simpara>
133132
当同时加在本扩展库和 recode 扩展库时 PHP 可能会崩溃。更多信息见
134133
<link linkend="ref.recode">recode</link> 扩展库。
135-
</para>
134+
</simpara>
136135
</warning>
137136
<note>
138-
<para>
137+
<simpara>
139138
如果需要不同于
140139
<emphasis>latin</emphasis>（默认值）的字符集，必须安装外部的（非绑定的）已编译入所需字符集支持的
141140
libmysql。
142-
</para>
141+
</simpara>
143142
</note>
144143
</section>
145144
</section>
146-
147145
<!-- Keep this comment at the end of the file
148146
Local variables:
149147
mode: sgml
@@ -164,4 +162,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
164162
vim: et tw=78 syn=sgml
165163
vi: ts=1 sw=1
166164
-->
167-

‎reference/mysql/functions/mysql-affected-rows.xml‎

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: HonestQiao Status: ready -->
3+
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: HonestQiao Status: ready -->
44
<!-- Reviewed: no Maintainer: HonestQiao -->
55
<!-- CREDITS: dallas -->
66
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-affected-rows">
@@ -26,10 +26,10 @@
2626
<type>int</type><methodname>mysql_affected_rows</methodname>
2727
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
2828
</methodsynopsis>
29-
<para>
29+
<simpara>
3030
取得最近一次与 <parameter>link_identifier</parameter> 关联的
3131
INSERT，UPDATE 或 DELETE 查询所影响的记录行数。
32-
</para>
32+
</simpara>
3333
</refsect1>
3434

3535
<refsect1 role="parameters">
@@ -41,24 +41,24 @@
4141

4242
<refsect1 role="returnvalues">
4343
&reftitle.returnvalues;
44-
<para>
44+
<simpara>
4545
执行成功则返回受影响的行的数目，如果最近一次查询失败的话，函数返回 -1。
46-
</para>
47-
<para>
46+
</simpara>
47+
<simpara>
4848
如果最近一次操作是没有任何条件（WHERE）的 DELETE
4949
查询，在表中所有的记录都会被删除，但本函数返回值在 4.1.2 版之前都为 0。
50-
</para>
51-
<para>
50+
</simpara>
51+
<simpara>
5252
当使用 UPDATE 查询，MySQL 不会将原值和新值一样的列更新。这样使得
5353
<function>mysql_affected_rows</function>
5454
函数返回值不一定就是查询条件所符合的记录数，只有真正被修改的记录数才会被返回。
55-
</para>
56-
<para>
55+
</simpara>
56+
<simpara>
5757
REPLACE 语句首先删除具有相同主键的记录，然后插入一个新记录。本函数返回的是被删除的记录数加上被插入的记录数。
58-
</para>
59-
<para>
58+
</simpara>
59+
<simpara>
6060
"INSERT ... ON DUPLICATE KEY UPDATE" 这种情况的查询，当执行了一次 INSERT 返回的值会是 <literal>1</literal>；如果是对已经存在的记录执行一次 UPDATE 将返回 <literal>2</literal>。
61-
</para>
61+
</simpara>
6262
</refsect1>
6363

6464
<refsect1 role="examples">
@@ -123,25 +123,25 @@ Updated Records: 10
123123
&reftitle.notes;
124124
<note>
125125
<title>事务处理</title>
126-
<para>
126+
<simpara>
127127
如果使用事务处理（transactions），需要在 INSERT，UPDATE 或 DELETE 查询后调用
128128
<function>mysql_affected_rows</function> 函数，而不是在 COMMIT 命令之后。
129-
</para>
129+
</simpara>
130130
</note>
131131
<note>
132132
<title>SELECT 语句</title>
133-
<para>
133+
<simpara>
134134
要获取 SELECT 所返回的行数，可以用
135135
<function>mysql_num_rows</function>。
136-
</para>
136+
</simpara>
137137
</note>
138138
<note>
139139
<title>Cascaded 外键</title>
140-
<para>
140+
<simpara>
141141
<function>mysql_affected_rows</function> does not count rows affected
142142
implicitly through the use of ON DELETE CASCADE and/or ON UPDATE CASCADE
143143
in foreign key constraints.
144-
</para>
144+
</simpara>
145145
</note>
146146
</refsect1>
147147

‎reference/mysql/functions/mysql-client-encoding.xml‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: HonestQiao Status: ready -->
3+
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: HonestQiao Status: ready -->
44
<!-- CREDITS: mowangjuanzi -->
55
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-client-encoding">
66
<refnamediv>
@@ -23,9 +23,9 @@
2323
<type>string</type><methodname>mysql_client_encoding</methodname>
2424
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam>
2525
</methodsynopsis>
26-
<para>
26+
<simpara>
2727
从 MySQL 中取得 <literal>character_set</literal> 变量的值。
28-
</para>
28+
</simpara>
2929
</refsect1>
3030

3131
<refsect1 role="parameters">
@@ -37,9 +37,9 @@
3737

3838
<refsect1 role="returnvalues">
3939
&reftitle.returnvalues;
40-
<para>
40+
<simpara>
4141
返回当前连接的默认字符集名称。
42-
</para>
42+
</simpara>
4343
</refsect1>
4444

4545
<refsect1 role="examples">

‎reference/mysql/functions/mysql-close.xml‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: HonestQiao Status: ready -->
3+
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: HonestQiao Status: ready -->
44
<!-- CREDITS: mowangjuanzi -->
55
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-close">
66
<refnamediv>
@@ -24,11 +24,11 @@
2424
<type>bool</type><methodname>mysql_close</methodname>
2525
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
2626
</methodsynopsis>
27-
<para>
27+
<simpara>
2828
<function>mysql_close</function> 关闭指定的连接标识所关联的到
2929
MySQL 服务器的非持久连接。如果没有指定
3030
<parameter>link_identifier</parameter>，则关闭上一个打开的连接。
31-
</para>
31+
</simpara>
3232
&mysql.close.connections.result.sets;
3333
</refsect1>
3434

@@ -41,9 +41,9 @@
4141

4242
<refsect1 role="returnvalues">
4343
&reftitle.returnvalues;
44-
<para>
44+
<simpara>
4545
&return.success;
46-
</para>
46+
</simpara>
4747
</refsect1>
4848

4949
<refsect1 role="examples">
@@ -74,11 +74,11 @@ Connected successfully
7474
<refsect1 role="notes">
7575
&reftitle.notes;
7676
<note>
77-
<para>
77+
<simpara>
7878
<function>mysql_close</function> 不会关闭由
7979
<function>mysql_pconnect</function> 建立的持久连接。
8080
有关其他详细信息，请参阅有关<link linkend="features.persistent-connections">持久连接</link>的手册页。
81-
</para>
81+
</simpara>
8282
</note>
8383
</refsect1>
8484

0 commit comments

Comments
 (0)