Author: mcbrown
Date: 2008-07-29 18:07:14 +0200 (Tue, 29 Jul 2008)
New Revision: 11421
Log:
Docs Bug #36849 (Deprecated options to mysql client)
Modified:
trunk/refman-5.0/programs-client-core.xml
trunk/refman-5.1/programs-client-core.xml
trunk/refman-6.0/programs-client-core.xml
Modified: trunk/refman-5.0/programs-client-core.xml
===================================================================
--- trunk/refman-5.0/programs-client-core.xml 2008-07-29 16:00:54 UTC (rev 11420)
+++ trunk/refman-5.0/programs-client-core.xml 2008-07-29 16:07:14 UTC (rev 11421)
Changed blocks: 11, Lines Added: 48, Lines Deleted: 27; 6117 bytes
@@ -202,7 +202,7 @@
<para>
Enable automatic rehashing. This option is on by default,
which enables database, table, and column name completion.
- Use <option>--skip-auto-rehash</option> to disable
+ Use <option>--disable-auto-rehash</option> to disable
rehashing. That causes <command>mysql</command> to start
faster, but you must issue the <literal>rehash</literal>
command if you want to use name completion.
@@ -441,6 +441,33 @@
</listitem>
<listitem>
+ <para id="option_mysql_disable-named-commands">
+ <indexterm>
+ <primary>mysql</primary>
+ <secondary>disable named commands</secondary>
+ </indexterm>
+
+ <indexterm>
+ <primary>disable named command</primary>
+ <secondary>mysql</secondary>
+ </indexterm>
+
+ <option>--disable-named-commands</option>
+ </para>
+
+ <para>
+ Disable named commands. Use the <literal>\*</literal> form
+ only, or use named commands only at the beginning of a line
+ ending with a semicolon
+ (<quote><literal>;</literal></quote>).
+ <command>mysql</command> starts with this option
+ <emphasis>enabled</emphasis> by default. However, even with
+ this option, long-format commands still work from the first
+ line. See <xref linkend="mysql-commands"/>.
+ </para>
+ </listitem>
+
+ <listitem>
<para id="option_mysql_execute">
<indexterm>
<primary>mysql</primary>
@@ -649,8 +676,9 @@
</para>
<para>
- Deprecated form of <option>-skip-auto-rehash</option>. See
- the description for <option>--auto-rehash</option>.
+ Deprecated form of <option>-skip-auto-rehash</option>. Use
+ <option>--disable-auto-rehash</option> instead. See the
+ description for <option>--auto-rehash</option>.
</para>
</listitem>
@@ -690,14 +718,8 @@
</para>
<para>
- Disable named commands. Use the <literal>\*</literal> form
- only, or use named commands only at the beginning of a line
- ending with a semicolon
- (<quote><literal>;</literal></quote>).
- <command>mysql</command> starts with this option
- <emphasis>enabled</emphasis> by default. However, even with
- this option, long-format commands still work from the first
- line. See <xref linkend="mysql-commands"/>.
+ Deprecated, use <option>--disable-named-commands</option>
+ instead.
</para>
</listitem>
@@ -1177,7 +1199,9 @@
</para>
<para>
- Do not write column names in results.
+ Do not write column names in results. The short format,
+ <option>-N</option> is deprecated, use the long format
+ instead.
</para>
</listitem>
@@ -1198,7 +1222,9 @@
<para>
Do not write line numbers for errors. Useful when you want
- to compare result files that include error messages.
+ to compare result files that include error messages. The
+ short format, <option>-L</option> is deprecated, use the
+ long format instead.
</para>
</listitem>
@@ -1503,8 +1529,8 @@
<para>
You can also set the following variables by using
- <option>--<replaceable>var_name</replaceable>=<replaceable>value</replaceable></option>
- syntax:
+ <option>--<replaceable>var_name</replaceable>=<replaceable>value</replaceable></option>.
+ The <option>--set-variable</option> format is deprecated.
</para>
<itemizedlist>
@@ -1595,10 +1621,8 @@
<para>
It is also possible to set variables by using
- <option>--set-variable=<replaceable>var_name</replaceable>=<replaceable>value</replaceable></option>
- or <option>-O
- <replaceable>var_name</replaceable>=<replaceable>value</replaceable></option>
- syntax. <emphasis>This syntax is deprecated</emphasis>.
+ <option>--<replaceable>var_name</replaceable>=<replaceable>value</replaceable></option>.
+ The <option>--set-variable</option> format is deprecated.
</para>
<indexterm>
@@ -4198,6 +4222,7 @@
<para>
You can also set the following variables by using
<option>--<replaceable>var_name</replaceable>=<replaceable>value</replaceable></option>
+ The <option>--set-variable</option> format is deprecated.
syntax:
</para>
@@ -4247,10 +4272,8 @@
<para>
It is also possible to set variables by using
- <option>--set-variable=<replaceable>var_name</replaceable>=<replaceable>value</replaceable></option>
- or <option>-O
- <replaceable>var_name</replaceable>=<replaceable>value</replaceable></option>
- syntax. <emphasis>This syntax is deprecated</emphasis>.
+ <option>--<replaceable>var_name</replaceable>=<replaceable>value</replaceable></option>.
+ The <option>--set-variable</option> format is deprecated.
</para>
</refsection>
@@ -7390,10 +7413,8 @@
<para>
It is also possible to set variables by using
- <option>--set-variable=<replaceable>var_name</replaceable>=<replaceable>value</replaceable></option>
- or <option>-O
- <replaceable>var_name</replaceable>=<replaceable>value</replaceable></option>
- syntax. <emphasis>This syntax is deprecated</emphasis>.
+ <option>--<replaceable>var_name</replaceable>=<replaceable>value</replaceable></option>.
+ The <option>--set-variable</option> format is deprecated.
</para>
<para>
Modified: trunk/refman-5.1/programs-client-core.xml
===================================================================
--- trunk/refman-5.1/programs-client-core.xml 2008-07-29 16:00:54 UTC (rev 11420)
+++ trunk/refman-5.1/programs-client-core.xml 2008-07-29 16:07:14 UTC (rev 11421)
Changed blocks: 8, Lines Added: 42, Lines Deleted: 15; 4421 bytes
@@ -202,7 +202,7 @@
<para>
Enable automatic rehashing. This option is on by default,
which enables database, table, and column name completion.
- Use <option>--skip-auto-rehash</option> to disable
+ Use <option>--disable-auto-rehash</option> to disable
rehashing. That causes <command>mysql</command> to start
faster, but you must issue the <literal>rehash</literal>
command if you want to use name completion.
@@ -490,6 +490,33 @@
</listitem>
<listitem>
+ <para id="option_mysql_disable-named-commands">
+ <indexterm>
+ <primary>mysql</primary>
+ <secondary>disable named commands</secondary>
+ </indexterm>
+
+ <indexterm>
+ <primary>disable named command</primary>
+ <secondary>mysql</secondary>
+ </indexterm>
+
+ <option>--disable-named-commands</option>
+ </para>
+
+ <para>
+ Disable named commands. Use the <literal>\*</literal> form
+ only, or use named commands only at the beginning of a line
+ ending with a semicolon
+ (<quote><literal>;</literal></quote>).
+ <command>mysql</command> starts with this option
+ <emphasis>enabled</emphasis> by default. However, even with
+ this option, long-format commands still work from the first
+ line. See <xref linkend="mysql-commands"/>.
+ </para>
+ </listitem>
+
+ <listitem>
<para id="option_mysql_execute">
<indexterm>
<primary>mysql</primary>
@@ -698,8 +725,9 @@
</para>
<para>
- Deprecated form of <option>-skip-auto-rehash</option>. See
- the description for <option>--auto-rehash</option>.
+ Deprecated form of <option>-skip-auto-rehash</option>. Use
+ <option>--disable-auto-rehash</option> instead. See the
+ description for <option>--auto-rehash</option>.
</para>
</listitem>
@@ -739,14 +767,8 @@
</para>
<para>
- Disable named commands. Use the <literal>\*</literal> form
- only, or use named commands only at the beginning of a line
- ending with a semicolon
- (<quote><literal>;</literal></quote>).
- <command>mysql</command> starts with this option
- <emphasis>enabled</emphasis> by default. However, even with
- this option, long-format commands still work from the first
- line. See <xref linkend="mysql-commands"/>.
+ Deprecated, use <option>--disable-named-commands</option>
+ instead.
</para>
</listitem>
@@ -1225,7 +1247,9 @@
</para>
<para>
- Do not write column names in results.
+ Do not write column names in results. The short format,
+ <option>-N</option> is deprecated, use the long format
+ instead.
</para>
</listitem>
@@ -1246,7 +1270,9 @@
<para>
Do not write line numbers for errors. Useful when you want
- to compare result files that include error messages.
+ to compare result files that include error messages. The
+ short format, <option>-L</option> is deprecated, use the
+ long format instead.
</para>
</listitem>
@@ -1551,8 +1577,8 @@
<para>
You can also set the following variables by using
- <option>--<replaceable>var_name</replaceable>=<replaceable>value</replaceable></option>
- syntax:
+ <option>--<replaceable>var_name</replaceable>=<replaceable>value</replaceable></option>.
+ The <option>--set-variable</option> format is deprecated.
</para>
<itemizedlist>
@@ -4316,6 +4342,7 @@
<para>
You can also set the following variables by using
<option>--<replaceable>var_name</replaceable>=<replaceable>value</replaceable></option>
+ The <option>--set-variable</option> format is deprecated.
syntax:
</para>
Modified: trunk/refman-6.0/programs-client-core.xml
===================================================================
--- trunk/refman-6.0/programs-client-core.xml 2008-07-29 16:00:54 UTC (rev 11420)
+++ trunk/refman-6.0/programs-client-core.xml 2008-07-29 16:07:14 UTC (rev 11421)
Changed blocks: 8, Lines Added: 42, Lines Deleted: 15; 4421 bytes
@@ -201,7 +201,7 @@
<para>
Enable automatic rehashing. This option is on by default,
which enables database, table, and column name completion.
- Use <option>--skip-auto-rehash</option> to disable
+ Use <option>--disable-auto-rehash</option> to disable
rehashing. That causes <command>mysql</command> to start
faster, but you must issue the <literal>rehash</literal>
command if you want to use name completion.
@@ -505,6 +505,33 @@
</listitem>
<listitem>
+ <para id="option_mysql_disable-named-commands">
+ <indexterm>
+ <primary>mysql</primary>
+ <secondary>disable named commands</secondary>
+ </indexterm>
+
+ <indexterm>
+ <primary>disable named command</primary>
+ <secondary>mysql</secondary>
+ </indexterm>
+
+ <option>--disable-named-commands</option>
+ </para>
+
+ <para>
+ Disable named commands. Use the <literal>\*</literal> form
+ only, or use named commands only at the beginning of a line
+ ending with a semicolon
+ (<quote><literal>;</literal></quote>).
+ <command>mysql</command> starts with this option
+ <emphasis>enabled</emphasis> by default. However, even with
+ this option, long-format commands still work from the first
+ line. See <xref linkend="mysql-commands"/>.
+ </para>
+ </listitem>
+
+ <listitem>
<para id="option_mysql_execute">
<indexterm>
<primary>mysql</primary>
@@ -713,8 +740,9 @@
</para>
<para>
- Deprecated form of <option>-skip-auto-rehash</option>. See
- the description for <option>--auto-rehash</option>.
+ Deprecated form of <option>-skip-auto-rehash</option>. Use
+ <option>--disable-auto-rehash</option> instead. See the
+ description for <option>--auto-rehash</option>.
</para>
</listitem>
@@ -754,14 +782,8 @@
</para>
<para>
- Disable named commands. Use the <literal>\*</literal> form
- only, or use named commands only at the beginning of a line
- ending with a semicolon
- (<quote><literal>;</literal></quote>).
- <command>mysql</command> starts with this option
- <emphasis>enabled</emphasis> by default. However, even with
- this option, long-format commands still work from the first
- line. See <xref linkend="mysql-commands"/>.
+ Deprecated, use <option>--disable-named-commands</option>
+ instead.
</para>
</listitem>
@@ -1240,7 +1262,9 @@
</para>
<para>
- Do not write column names in results.
+ Do not write column names in results. The short format,
+ <option>-N</option> is deprecated, use the long format
+ instead.
</para>
</listitem>
@@ -1261,7 +1285,9 @@
<para>
Do not write line numbers for errors. Useful when you want
- to compare result files that include error messages.
+ to compare result files that include error messages. The
+ short format, <option>-L</option> is deprecated, use the
+ long format instead.
</para>
</listitem>
@@ -1554,8 +1580,8 @@
<para>
You can also set the following variables by using
- <option>--<replaceable>var_name</replaceable>=<replaceable>value</replaceable></option>
- syntax:
+ <option>--<replaceable>var_name</replaceable>=<replaceable>value</replaceable></option>.
+ The <option>--set-variable</option> format is deprecated.
</para>
<itemizedlist>
@@ -4312,6 +4338,7 @@
<para>
You can also set the following variables by using
<option>--<replaceable>var_name</replaceable>=<replaceable>value</replaceable></option>
+ The <option>--set-variable</option> format is deprecated.
syntax:
</para>
| Thread |
|---|
| • svn commit - mysqldoc@docsrva: r11421 - in trunk: refman-5.0 refman-5.1 refman-6.0 | mcbrown | 29 Jul |