Fix whitespaces

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@228279 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Mehdi Achour 2007-01-28 05:22:02 +00:00
parent 151a5927cb
commit 0dbc7d65b8
5 changed files with 123 additions and 114 deletions

View file

@ -1,10 +1,11 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.15 $ -->
<!-- $Revision: 1.16 $ -->
<refentry id="function.mysql-create-db">
<refnamediv>
<refname>mysql_create_db</refname>
<refpurpose>Create a MySQL database</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@ -18,6 +19,7 @@
identifier.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>

View file

@ -1,10 +1,11 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.18 $ -->
<!-- $Revision: 1.19 $ -->
<refentry id="function.mysql-data-seek">
<refnamediv>
<refname>mysql_data_seek</refname>
<refpurpose>Move internal result pointer</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>

View file

@ -1,10 +1,11 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.9 $ -->
<!-- $Revision: 1.10 $ -->
<refentry id="function.mysql-db-name">
<refnamediv>
<refname>mysql_db_name</refname>
<refpurpose>Get result data</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>

View file

@ -1,89 +1,88 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.16 $ -->
<!-- splitted from ./en/functions/mysql.xml, last change in rev 1.62 -->
<refentry id="function.mysql-query">
<refnamediv>
<refname>mysql_query</refname>
<refpurpose>Send a MySQL query</refpurpose>
</refnamediv>
<!-- $Revision: 1.17 $ -->
<refentry id="function.mysql-query">
<refnamediv>
<refname>mysql_query</refname>
<refpurpose>Send a MySQL query</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>resource</type><methodname>mysql_query</methodname>
<methodparam><type>string</type><parameter>query</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam>
</methodsynopsis>
<para>
<function>mysql_query</function> sends an unique query (multiple queries
are not supported) to the currently
active database on the server that's associated with the
specified <parameter>link_identifier</parameter>.
</para>
</refsect1>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>resource</type><methodname>mysql_query</methodname>
<methodparam><type>string</type><parameter>query</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam>
</methodsynopsis>
<para>
<function>mysql_query</function> sends an unique query (multiple queries
are not supported) to the currently
active database on the server that's associated with the
specified <parameter>link_identifier</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>query</parameter></term>
<listitem>
<para>
A SQL query
</para>
<para>
The query string should not end with a semicolon.
</para>
</listitem>
</varlistentry>
&mysql.linkid.description;
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
For SELECT, SHOW, DESCRIBE or EXPLAIN statements,
<function>mysql_query</function>
returns a <type>resource</type> on success, or &false; on
error.
</para>
<para>
For other type of SQL statements, UPDATE, DELETE, DROP, etc,
<function>mysql_query</function> returns &true; on success
or &false; on error.
</para>
<para>
The returned result resource should be passed to
<function>mysql_fetch_array</function>, and other
functions for dealing with result tables, to access the returned data.
</para>
<para>
Use <function>mysql_num_rows</function> to find out how many rows
were returned for a SELECT statement or
<function>mysql_affected_rows</function> to find out how many
rows were affected by a DELETE, INSERT, REPLACE, or UPDATE
statement.
</para>
<para>
<function>mysql_query</function> will also fail and return &false;
if the user does not have permission to access the table(s) referenced by
the query.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Invalid Query</title>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>query</parameter></term>
<listitem>
<para>
The following query is syntactically invalid, so
<function>mysql_query</function> fails and returns &false;.
A SQL query
</para>
<programlisting role="php">
<para>
The query string should not end with a semicolon.
</para>
</listitem>
</varlistentry>
&mysql.linkid.description;
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
For SELECT, SHOW, DESCRIBE or EXPLAIN statements,
<function>mysql_query</function>
returns a <type>resource</type> on success, or &false; on
error.
</para>
<para>
For other type of SQL statements, UPDATE, DELETE, DROP, etc,
<function>mysql_query</function> returns &true; on success
or &false; on error.
</para>
<para>
The returned result resource should be passed to
<function>mysql_fetch_array</function>, and other
functions for dealing with result tables, to access the returned data.
</para>
<para>
Use <function>mysql_num_rows</function> to find out how many rows
were returned for a SELECT statement or
<function>mysql_affected_rows</function> to find out how many
rows were affected by a DELETE, INSERT, REPLACE, or UPDATE
statement.
</para>
<para>
<function>mysql_query</function> will also fail and return &false;
if the user does not have permission to access the table(s) referenced by
the query.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Invalid Query</title>
<para>
The following query is syntactically invalid, so
<function>mysql_query</function> fails and returns &false;.
</para>
<programlisting role="php">
<![CDATA[
<?php
$result = mysql_query('SELECT * WHERE 1=1');
@ -93,17 +92,17 @@ if (!$result) {
?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
</para>
<para>
<example>
<title>Valid Query</title>
<para>
<example>
<title>Valid Query</title>
<para>
The following query is valid, so <function>mysql_query</function>
returns a <type>resource</type>.
</para>
<programlisting role="php">
The following query is valid, so <function>mysql_query</function>
returns a <type>resource</type>.
</para>
<programlisting role="php">
<![CDATA[
<?php
// This could be supplied by a user, for example
@ -144,25 +143,26 @@ while ($row = mysql_fetch_assoc($result)) {
mysql_free_result($result);
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>mysql_connect</function></member>
<member><function>mysql_error</function></member>
<member><function>mysql_real_escape_string</function></member>
<member><function>mysql_result</function></member>
<member><function>mysql_fetch_assoc</function></member>
<member><function>mysql_unbuffered_query</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>mysql_connect</function></member>
<member><function>mysql_error</function></member>
<member><function>mysql_real_escape_string</function></member>
<member><function>mysql_result</function></member>
<member><function>mysql_fetch_assoc</function></member>
<member><function>mysql_unbuffered_query</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:

View file

@ -1,11 +1,11 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.11 $ -->
<!-- splitted from ./en/functions/mysql.xml, last change in rev 1.62 -->
<!-- $Revision: 1.12 $ -->
<refentry id="function.mysql-stat">
<refnamediv>
<refname>mysql_stat</refname>
<refpurpose>Get current system status</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
@ -16,6 +16,7 @@
<function>mysql_stat</function> returns the current server status.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@ -24,6 +25,7 @@
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
@ -33,6 +35,7 @@
If <parameter>link_identifier</parameter> is invalid, &null; is returned.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
@ -97,6 +100,7 @@ bdb_tmpdir = /var/tmp/
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@ -106,6 +110,7 @@ bdb_tmpdir = /var/tmp/
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file