Commit 2700bc2c authored by unknown's avatar unknown

Cleanups of manual.texi and mysql.cc.


Docs/manual.texi:
  Various fixups.
client/mysql.cc:
  Small change in usage info.
parent 47665f7d
...@@ -238,7 +238,7 @@ Linux notes (all Linux versions) ...@@ -238,7 +238,7 @@ Linux notes (all Linux versions)
* Linux-Alpha:: Linux-Alpha notes * Linux-Alpha:: Linux-Alpha notes
* MKLinux:: MkLinux notes * MKLinux:: MkLinux notes
* Qube2:: Qube2 Linux notes * Qube2:: Qube2 Linux notes
* Linux-Ia64:: * Linux-Ia64:: IA64 Linux notes
BSD/OS notes BSD/OS notes
...@@ -275,7 +275,7 @@ Is there anything special to do when upgrading/downgrading MySQL? ...@@ -275,7 +275,7 @@ Is there anything special to do when upgrading/downgrading MySQL?
How standards-compatible is MySQL? How standards-compatible is MySQL?
* Extensions to ANSI:: @strong{MySQL} extensions to ANSI SQL92 * Extensions to ANSI:: @strong{MySQL} extensions to ANSI SQL92
* Ansi mode:: Runnning @strong{MySQL} in ANSI mode * Ansi mode:: Running @strong{MySQL} in ANSI mode
* Differences from ANSI:: @strong{MySQL} differences compared to ANSI SQL92 * Differences from ANSI:: @strong{MySQL} differences compared to ANSI SQL92
* Missing functions:: Functionality missing from @strong{MySQL} * Missing functions:: Functionality missing from @strong{MySQL}
* Standards:: What standards does @strong{MySQL} follow? * Standards:: What standards does @strong{MySQL} follow?
...@@ -650,10 +650,10 @@ Some common errors when using MySQL ...@@ -650,10 +650,10 @@ Some common errors when using MySQL
Solving some common problems with MySQL Solving some common problems with MySQL
* Log Replication:: Database replication with update log * Log Replication:: Database replication with update log
* Backup:: Database backups * Backup:: Database backups
* Update log:: The update log * Update log:: The update log
* Slow query log:: * Slow query log:: Log of slow queries
* Multiple servers:: Running multiple @strong{MySQL} servers on the same machine * Multiple servers:: Running multiple @strong{MySQL} servers on the same machine
MySQL client tools and APIs MySQL client tools and APIs
...@@ -6172,7 +6172,7 @@ until you have installed @code{glibc} 2.0.7-19 from source! ...@@ -6172,7 +6172,7 @@ until you have installed @code{glibc} 2.0.7-19 from source!
You can check which version of @code{glibc} you have with @code{rpm -q glibc}. You can check which version of @code{glibc} you have with @code{rpm -q glibc}.
Another reason for the above error is if you try to use more threads Another reason for the above error is if you try to use more threads
than your Linux kernel is configured for. In this case you should rise than your Linux kernel is configured for. In this case you should raise
the limits in @file{include/linux/tasks.h} and recompile your kernel! the limits in @file{include/linux/tasks.h} and recompile your kernel!
@node Linux-SPARC, Linux-Alpha, Linux-RedHat51, Linux @node Linux-SPARC, Linux-Alpha, Linux-RedHat51, Linux
...@@ -8384,8 +8384,8 @@ Log connections and queries to file ...@@ -8384,8 +8384,8 @@ Log connections and queries to file
Log all ISAM/MyISAM changes to file (only used when debugging ISAM/MyISAM). Log all ISAM/MyISAM changes to file (only used when debugging ISAM/MyISAM).
@item --log-slow-queries[=file] @item --log-slow-queries[=file]
Log all queries that has taken more than @code{long_query_time} to execute Log all queries that have taken more than @code{long_query_time} seconds to
to file. @xref{Slow query log}. execute to file. @xref{Slow query log}.
@item --log-update[=file] @item --log-update[=file]
Log updates to @code{file.#} where @code{#} is a unique number if not given. Log updates to @code{file.#} where @code{#} is a unique number if not given.
...@@ -8952,7 +8952,7 @@ information. ...@@ -8952,7 +8952,7 @@ information.
@menu @menu
* Extensions to ANSI:: @strong{MySQL} extensions to ANSI SQL92 * Extensions to ANSI:: @strong{MySQL} extensions to ANSI SQL92
* Ansi mode:: Runnning @strong{MySQL} in ANSI mode * Ansi mode:: Running @strong{MySQL} in ANSI mode
* Differences from ANSI:: @strong{MySQL} differences compared to ANSI SQL92 * Differences from ANSI:: @strong{MySQL} differences compared to ANSI SQL92
* Missing functions:: Functionality missing from @strong{MySQL} * Missing functions:: Functionality missing from @strong{MySQL}
* Standards:: What standards does @strong{MySQL} follow? * Standards:: What standards does @strong{MySQL} follow?
...@@ -9202,7 +9202,7 @@ SELECT @@t1:=(@@t2:=1)+@@t3:=4,@@t1,@@t2,@@t3; ...@@ -9202,7 +9202,7 @@ SELECT @@t1:=(@@t2:=1)+@@t3:=4,@@t1,@@t2,@@t3;
@end itemize @end itemize
@node Ansi mode, Differences from ANSI, Extensions to ANSI, Compatibility @node Ansi mode, Differences from ANSI, Extensions to ANSI, Compatibility
@section Runnning MySQL in ANSI mode @section Running MySQL in ANSI mode
If you start mysqld with the @code{--ansi} option, the following behaviour If you start mysqld with the @code{--ansi} option, the following behaviour
of @strong{MySQL} changes. of @strong{MySQL} changes.
...@@ -11954,8 +11954,8 @@ with @code{`} (@code{"} will also work to quote identifiers if you run ...@@ -11954,8 +11954,8 @@ with @code{`} (@code{"} will also work to quote identifiers if you run
in ANSI mode). in ANSI mode).
@multitable @columnfractions .15 .7 .78 @multitable @columnfractions .15 .7 .78
@item @strong{Identifier} @tab @strong{max length} @tab @strong{Allowed characters} @item @strong{Identifier} @tab @strong{Max length} @tab @strong{Allowed characters}
@item Database @tab 64 @tab Any character that is allowed in a directory name execpt @code{/}. @item Database @tab 64 @tab Any character that is allowed in a directory name except @code{/}.
@item Table @tab 64 @tab Any character that is allowed in file name, except @code{/} or @code{.} @item Table @tab 64 @tab Any character that is allowed in file name, except @code{/} or @code{.}
@item Column @tab 64 @tab All characters @item Column @tab 64 @tab All characters
@item Alias @tab 255 @tab All characters @item Alias @tab 255 @tab All characters
...@@ -18559,7 +18559,7 @@ have.. ...@@ -18559,7 +18559,7 @@ have..
@item @code{Open_streams} @tab Number of streams that are open (used mainly for logging) @item @code{Open_streams} @tab Number of streams that are open (used mainly for logging)
@item @code{Opened_tables} @tab Number of tables that have been opened. @item @code{Opened_tables} @tab Number of tables that have been opened.
@item @code{Questions} @tab Number of queries sent to the server. @item @code{Questions} @tab Number of queries sent to the server.
@item @code{Slow_launch_threads} @tab Number of threads that has taken more than @code{slow_launch_time} to connect. @item @code{Slow_launch_threads} @tab Number of threads that have taken more than @code{slow_launch_time} to connect.
@item @code{Slow_queries} @tab Number of queries that has taken more than @code{long_query_time}. @xref{Slow query log}. @item @code{Slow_queries} @tab Number of queries that has taken more than @code{long_query_time}. @xref{Slow query log}.
@item @code{Threads_cached} @tab Number of threads in the thread cache. @item @code{Threads_cached} @tab Number of threads in the thread cache.
@item @code{Threads_connected} @tab Number of currently open connections. @item @code{Threads_connected} @tab Number of currently open connections.
...@@ -25304,7 +25304,7 @@ our systems. ...@@ -25304,7 +25304,7 @@ our systems.
We are also experimenting with Intel-Linux to be able to get more CPU We are also experimenting with Intel-Linux to be able to get more CPU
power cheaper. Now that we have the binary portable database format (new power cheaper. Now that we have the binary portable database format (new
in 3.32) we will start to use this for some parts of the application. in 3.23) we will start to use this for some parts of the application.
Our initial feelings are that Linux will perform much better on low to Our initial feelings are that Linux will perform much better on low to
medium load but Solaris will perform better when you start to get a medium load but Solaris will perform better when you start to get a
...@@ -25573,9 +25573,6 @@ Debug log. Default is 'd:t:o,/tmp/mysql.trace' ...@@ -25573,9 +25573,6 @@ Debug log. Default is 'd:t:o,/tmp/mysql.trace'
Database to use; This is mainly useful in the @code{my.cnf} file. Database to use; This is mainly useful in the @code{my.cnf} file.
@item @item
--default-character-set=... Set the default character set. --default-character-set=... Set the default character set.
@item
-G, --enable-named-commands
Named commands are enabled. Opposite to -g.
@item -e, --execute=... @item -e, --execute=...
Execute command and quit. (Output like with --batch) Execute command and quit. (Output like with --batch)
@item -E, --vertical @item -E, --vertical
...@@ -25583,12 +25580,15 @@ Print the output of a query (rows) vertically. Without this option you ...@@ -25583,12 +25580,15 @@ Print the output of a query (rows) vertically. Without this option you
can also force this output by ending your statements with @code{\G}. can also force this output by ending your statements with @code{\G}.
@item -f, --force @item -f, --force
Continue even if we get an SQL error. Continue even if we get an SQL error.
@item @item -g, --no-named-commands
-g, --no-named-commands
Named commands are disabled. Use \* form only, or use named commands Named commands are disabled. Use \* form only, or use named commands
only in the beginning of a line ending with a semicolon (;) Since only in the beginning of a line ending with a semicolon (;) Since
version 10.9 the client now starts with this option ENABLED by default! version 10.9 the client now starts with this option ENABLED by default!
Disable with '-G'. Long format commands still work from the first line. With the -g option, long format commands will still work from the first
line, however.
@item -G, --enable-named-commands
Named commands are @strong{enabled}. Long format commands are allowed as
well as shortened \* commands.
@item -i, --ignore-space @item -i, --ignore-space
Ignore space after function names. Ignore space after function names.
@item -h, --host=... @item -h, --host=...
...@@ -27502,8 +27502,8 @@ The above command does the following: ...@@ -27502,8 +27502,8 @@ The above command does the following:
@itemize @bullet @itemize @bullet
@item @item
If standard logging (@code{--log}) or slow query logging If standard logging (@code{--log}) or slow query logging
@code{--log-slow-queries} is used, closes and reopens the log file. (@code{--log-slow-queries}) is used, closes and reopens the log file.
(@file{mysql.log} and @file{mysql-slow.log} as default). (@file{mysql.log} and @file{`hostname`-slow.log} as default).
@item @item
If update logging (@code{--log-update}) is used, closes the update log and If update logging (@code{--log-update}) is used, closes the update log and
opens a new log file with a higher sequence number. opens a new log file with a higher sequence number.
...@@ -29965,7 +29965,7 @@ Drop or rename @code{old_table} ...@@ -29965,7 +29965,7 @@ Drop or rename @code{old_table}
* Log Replication:: Database replication with update log * Log Replication:: Database replication with update log
* Backup:: Database backups * Backup:: Database backups
* Update log:: The update log * Update log:: The update log
* Slow query log:: * Slow query log:: Log of slow queries
* Multiple servers:: Running multiple @strong{MySQL} servers on the same machine * Multiple servers:: Running multiple @strong{MySQL} servers on the same machine
@end menu @end menu
...@@ -30131,9 +30131,9 @@ and the crash. ...@@ -30131,9 +30131,9 @@ and the crash.
When started with the @code{--log-slow-queries[=file_name]} option, When started with the @code{--log-slow-queries[=file_name]} option,
@code{mysqld} writes a log file containing all SQL commands that took @code{mysqld} writes a log file containing all SQL commands that took
more than @code{long_query_time} to execute. data. If no file name is more than @code{long_query_time} to execute. If no file name is
given, it defaults to the name of the host machine suffixed with given, it defaults to the name of the host machine suffixed with
@code{-slow.log}. If file name is given, but it doesn't contain a path @code{-slow.log}. If a file name is given, but doesn't contain a path,
the file is written in the data directory. the file is written in the data directory.
The slow query log can be used to find queries that takes a long time to The slow query log can be used to find queries that takes a long time to
...@@ -30674,7 +30674,7 @@ expects a counted string. If the string contains binary data (which may ...@@ -30674,7 +30674,7 @@ expects a counted string. If the string contains binary data (which may
include null bytes), you must use @code{mysql_real_query()}. include null bytes), you must use @code{mysql_real_query()}.
For each non-@code{SELECT} query (e.g., @code{INSERT}, @code{UPDATE}, For each non-@code{SELECT} query (e.g., @code{INSERT}, @code{UPDATE},
@code{DELETE}), you can found out how many rows were affected (changed) @code{DELETE}), you can find out how many rows were affected (changed)
by calling @code{mysql_affected_rows()}. by calling @code{mysql_affected_rows()}.
For @code{SELECT} queries, you retrieve the selected rows as a result set. For @code{SELECT} queries, you retrieve the selected rows as a result set.
...@@ -30733,7 +30733,7 @@ was a @code{SELECT} and you can read the rows. If the result set call ...@@ -30733,7 +30733,7 @@ was a @code{SELECT} and you can read the rows. If the result set call
fails, call @code{mysql_field_count()} to determine whether or not a fails, call @code{mysql_field_count()} to determine whether or not a
result was actually to be expected. If @code{mysql_field_count()} result was actually to be expected. If @code{mysql_field_count()}
returns zero, the query returned no data (indicating that it was an returns zero, the query returned no data (indicating that it was an
@code{INSERT}, @code{UPDATE}, @code{DELETE}, etc.), and thus not @code{INSERT}, @code{UPDATE}, @code{DELETE}, etc.), and was not
expected to return rows. If @code{mysql_field_count()} is non-zero, the expected to return rows. If @code{mysql_field_count()} is non-zero, the
query should have returned rows, but didn't. This indicates that the query should have returned rows, but didn't. This indicates that the
query was a @code{SELECT} that failed. See the description for query was a @code{SELECT} that failed. See the description for
...@@ -35702,7 +35702,7 @@ though, so 3.23 is not released as a stable version yet. ...@@ -35702,7 +35702,7 @@ though, so 3.23 is not released as a stable version yet.
@itemize @bullet @itemize @bullet
@item @item
Added option @code{--core-file} to @code{mysqld} to get a core file on Added option @code{--core-file} to @code{mysqld} to get a core file on
Linux if mysqld dies on the SIGSEGV signal Linux if mysqld dies on the SIGSEGV signal.
@item @item
@strong{MySQL} client 'mysql' now starts with option --no-named-commands @strong{MySQL} client 'mysql' now starts with option --no-named-commands
(-g) by default. This option can be disabled with --enable-named-commands (-g) by default. This option can be disabled with --enable-named-commands
...@@ -40342,8 +40342,8 @@ old threads. You can avoid this problem by starting @code{mysqld} with ...@@ -40342,8 +40342,8 @@ old threads. You can avoid this problem by starting @code{mysqld} with
@code{-O thread_cache_size= 'max_connections +1'}. In most cases just @code{-O thread_cache_size= 'max_connections +1'}. In most cases just
using @code{-O thread_cache_size= 5'} will help a lot! using @code{-O thread_cache_size= 5'} will help a lot!
If you want to get a core dump on Linux if mysqld dies with a SIGSEGV signal, If you want to get a core dump on Linux if @code{mysqld} dies with a
you can start mysqld with the @code{--core-file} option. SIGSEGV signal, you can start mysqld with the @code{--core-file} option.
If you are using gdb 4.17.x or above on Linux, you should install a If you are using gdb 4.17.x or above on Linux, you should install a
@file{.gdb} file, with the following information, in your current @file{.gdb} file, with the following information, in your current
...@@ -40409,7 +40409,7 @@ mysqld are using indexes properly. @xref{EXPLAIN, , @code{EXPLAIN}}. You ...@@ -40409,7 +40409,7 @@ mysqld are using indexes properly. @xref{EXPLAIN, , @code{EXPLAIN}}. You
should also test complicated queries that didn't complete within the should also test complicated queries that didn't complete within the
@code{mysql} command line tool. @code{mysql} command line tool.
You can find the queries that takes a long time to run by starting You can find the queries that take a long time to execute by starting
@code{mysqld} with @code{--log-slow-queries}. @xref{Slow query log}. @code{mysqld} with @code{--log-slow-queries}. @xref{Slow query log}.
If you find the text @code{mysqld restarted} in the error log file If you find the text @code{mysqld restarted} in the error log file
...@@ -40543,7 +40543,7 @@ The currently recognized flag characters are: ...@@ -40543,7 +40543,7 @@ The currently recognized flag characters are:
@multitable @columnfractions .1 .9 @multitable @columnfractions .1 .9
@item d @tab Enable output from DBUG_<N> macros for for the current state. May be followed by a list of keywords which selects output only for the DBUG macros with that keyword. A empty list of keywords implies output for all macros. @item d @tab Enable output from DBUG_<N> macros for for the current state. May be followed by a list of keywords which selects output only for the DBUG macros with that keyword. A empty list of keywords implies output for all macros.
@item D @tab Delay after each debugger output line. The argument is the number of tenths of seconds to delay, subject to machine capabilities. I.E. @code{-#D,20} is delay two seconds. @item D @tab Delay after each debugger output line. The argument is the number of tenths of seconds to delay, subject to machine capabilities. I.E. @code{-#D,20} is delay two seconds.
@item f tab Limit debugging and/or tracing, and profiling to the list of named functions. Note that a null list will disable all functions. The appropriate "d" or "t" flags must still be given, this flag only limits their actions if they are enabled. @item f @tab Limit debugging and/or tracing, and profiling to the list of named functions. Note that a null list will disable all functions. The appropriate "d" or "t" flags must still be given, this flag only limits their actions if they are enabled.
@item F @tab Identify the source file name for each line of debug or trace output. @item F @tab Identify the source file name for each line of debug or trace output.
@item i @tab Identify the process with the pid or thread id for each line of debug or trace output. @item i @tab Identify the process with the pid or thread id for each line of debug or trace output.
@item g @tab Enable profiling. Create a file called 'dbugmon.out' containing information that can be used to profile the program. May be followed by a list of keywords that select profiling only for the functions in that list. A null list implies that all functions are considered. @item g @tab Enable profiling. Create a file called 'dbugmon.out' containing information that can be used to profile the program. May be followed by a list of keywords that select profiling only for the functions in that list. A null list implies that all functions are considered.
...@@ -32,7 +32,7 @@ ...@@ -32,7 +32,7 @@
#include "errmsg.h" #include "errmsg.h"
#include <my_dir.h> #include <my_dir.h>
#ifndef __GNU_LIBRARY__ #ifndef __GNU_LIBRARY__
#define __GNU_LIBRARY__ // Skipp warnings in getopt.h #define __GNU_LIBRARY__ // Skip warnings in getopt.h
#endif #endif
#include <getopt.h> #include <getopt.h>
#include "my_readline.h" #include "my_readline.h"
...@@ -427,8 +427,6 @@ static void usage(int version) ...@@ -427,8 +427,6 @@ static void usage(int version)
-D, --database=.. Database to use.\n\ -D, --database=.. Database to use.\n\
--default-character-set=...\n\ --default-character-set=...\n\
Set the default character set.\n\ Set the default character set.\n\
-G, --enable-named-commands\n\
Named commands are enabled. Opposite to -g.\n\
-e, --execute=... Execute command and quit. (Output like with --batch)\n\ -e, --execute=... Execute command and quit. (Output like with --batch)\n\
-E, --vertical Print the output of a query (rows) vertically.\n\ -E, --vertical Print the output of a query (rows) vertically.\n\
-f, --force Continue even if we get an sql error.\n\ -f, --force Continue even if we get an sql error.\n\
...@@ -439,6 +437,8 @@ static void usage(int version) ...@@ -439,6 +437,8 @@ static void usage(int version)
client now starts with this option ENABLED by\n\ client now starts with this option ENABLED by\n\
default! Disable with '-G'. Long format commands\n\ default! Disable with '-G'. Long format commands\n\
still work from the first line.\n\ still work from the first line.\n\
-G, --enable-named-commands\n\
Named commands are enabled. Opposite to -g.\n\
-i, --ignore-space Ignore space after function names.\n\ -i, --ignore-space Ignore space after function names.\n\
-h, --host=... Connect to host.\n\ -h, --host=... Connect to host.\n\
-H, --html Produce HTML output.\n\ -H, --html Produce HTML output.\n\
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment