Below is the list of changes that have just been committed into a local
mysqldoc repository of paul. When paul does a push these changes will
be propagated to the main repository and, within 24 hours after the
push, to the public repository.
For information on how to access the public repository
see http://www.mysql.com/doc/I/n/Installing_source_tree.html
ChangeSet
1.2646 05/03/06 19:34:57 paul@stripped +1 -0
internals.texi:
Oops, we weren't writing long dash correctly,
Texinfo uses "---".
Docs/internals.texi
1.66 05/03/06 19:34:31 paul@stripped +575 -575
Oops, we weren't writing long dash correctly,
Texinfo uses "---".
# This is a BitKeeper patch. What follows are the unified diffs for the
# set of deltas contained in the patch. The rest of the patch, the part
# that BitKeeper cares about, is below these diffs.
# User: paul
# Host: frost.snake.net
# Root: /Volumes/frost2/MySQL/bk/mysqldoc
--- 1.65/Docs/internals.texi 2005-03-06 19:11:22 -06:00
+++ 1.66/Docs/internals.texi 2005-03-06 19:34:31 -06:00
@@ -87,7 +87,7 @@
We want to download the latest, the very latest, version
of the MySQL server. So we won't click "Downloads" on the MySQL
-Developer Zone page -- that's usually a few weeks old.
+Developer Zone page --- that's usually a few weeks old.
Instead we'll get BitKeeper (tm), which is a revision
control package, vaguely like CVS or Perforce. This is what MySQL's
developers use every day, so what we download with BitKeeper
@@ -283,7 +283,7 @@
on your Linux system already.
There are debuggers for Windows and other operating
-systems, of course -- don't feel left out just because
+systems, of course --- don't feel left out just because
we're mentioning a Linux tool name! But it happens
that we do a lot of things with Linux ourselves, so
we happen to know what to say. To debug the mysqld server,
@@ -323,10 +323,10 @@
It has the source code of many of your familiar favourites,
like mysql, which everybody has used to connect to
the MySQL server at one time or another. There are
-other utilities too -- in fact, you'll find the source
+other utilities too --- in fact, you'll find the source
of most client-side programs here. There are also
programs for checking the password, and for testing that
-basic functions -- such as threading or access via SSL --
+basic functions --- such as threading or access via SSL ---
are possible.
You'll notice, by the way, that we're concentrating
@@ -373,8 +373,8 @@
@end example
You can do that with manual.texi, but you've already
-seen what the result looks like -- it's the MySQL
-Reference Manual available online -- so let's look
+seen what the result looks like --- it's the MySQL
+Reference Manual available online --- so let's look
at what the real "source code" lover cares about,
internals.texi. After converting it to .html and
opening it with a browser, click "Coding Guidelines"
@@ -485,7 +485,7 @@
To sum up:
(1) The myisam directory is where you'll find
programs for handling files, rows, and keys. You
-won't find programs for handling columns -- we'll get
+won't find programs for handling columns --- we'll get
to them a bit later.
(2) The myisam directory is just one of the handler
directories. The programs in the other storage engine directories
@@ -658,7 +658,7 @@
Handler stores in file /* mysys */
@end example
-The diagram is very simplified -- it's a caricature that
+The diagram is very simplified --- it's a caricature that
distorts important things, but remember that we've only
discussed seven major directories so far: Docs, BUILD, and
the five that you see here.
@@ -678,7 +678,7 @@
Finally, one of the ha (handler) programs in the sql directory
will dispatch to an appropriate handler for storage. In this case
-we've assumed, as before, that the handler is myisam -- so a
+we've assumed, as before, that the handler is myisam --- so a
myisam-directory program is involved. Specifically, that
program is mi_write.c, as we mentioned earlier.
@@ -697,7 +697,7 @@
zlib
@end example
-Now it's time to reveal a startling fact, which is --
+Now it's time to reveal a startling fact, which is ---
we didn't write all of the source code in all of the
source code directories all by ourselves. This list
is, in a sense, a tribute to the idea of open source.
@@ -737,9 +737,9 @@
Let's go through the idea of storage engines once more,
this time with a list of all the storage engines, both the
ones that we produce, and the ones that others produce.
-We've already mentioned the internal ones -- so now
+We've already mentioned the internal ones --- so now
we'll remark on the directories of the two common external
-storage engines -- BDB and innobase.
+storage engines --- BDB and innobase.
The BDB, or Berkeley Database, handler, is strictly
the product of Sleepycat software. Sleepycat has a
@@ -792,7 +792,7 @@
@strong{Odds and Ends}
Finally, for the sake of completeness, we'll put
-up a list of the rest of the directories -- those
+up a list of the rest of the directories --- those
that we haven't had occasion to mention till now.
@example
@@ -835,7 +835,7 @@
Now, having finished with our bird's eye view of the source
code from the air, let's take the perspective of the worms
on the ground. (Which is another name for MySQL's developer
-staff -- turn on laugh track here.)
+staff --- turn on laugh track here.)
@example
int mysql_update(THD *thd, ...)
@@ -865,7 +865,7 @@
@end example
Here's a snippet of code from a .c file in the sql directory,
-specifically from sql_update.cc, which -- as we mentioned earlier
+specifically from sql_update.cc, which --- as we mentioned earlier
-- is invoked when there's an UPDATE statement to process.
The entire routine has many error checks with handlers for
@@ -890,7 +890,7 @@
process for reading records, reading records in
a loop until the thread is killed or there are
no more to read, storing a modified record for
-the table, and -- after the loop is through --
+the table, and --- after the loop is through ---
possibly writing to the log. Incidentally, a
transactional table is usually a BDB or an InnoDB
table.
@@ -1011,7 +1011,7 @@
requests from new clients. Once it receives such a request, it assigns
resources which will be exclusive to that client. In particular, the
main thread will spawn a new thread just to handle the connection.
-Then the main server will loop and listen for new connections --
+Then the main server will loop and listen for new connections ---
but we will leave it and follow the new thread.
As well as the sockets code that we chose to display here, there are
@@ -1140,8 +1140,8 @@
look at the dispatch_command function that there are more case
statements after the ones that you see here.
-There will be -- we're going into list mode now and just reciting the
-rest of the items in the switch statement -- code for prepare, close
+There will be --- we're going into list mode now and just reciting the
+rest of the items in the switch statement --- code for prepare, close
statement, query, quit, create database, drop database, dump binary
log, refresh, statistics, get process info, kill process, sleep,
connect, and several minor commands. This is the big junction.
@@ -1400,7 +1400,7 @@
To see what the write_row statement is doing, we'll have to look at one of
the include files. In handler.h on the sql directory, we find that
write_row is associated with a handler for a table. This definition
-is telling us that the address in write_row will vary -- it gets
+is telling us that the address in write_row will vary --- it gets
filled in at run time. In fact, there are several possible addresses.
There is one address for each handler. In our case, since we're using
@@ -1551,8 +1551,8 @@
The thing to notice here is that the records
are stored compactly. There is one byte at the
-start of each record -- F1 for the first record
-and F5 for the second record -- which contains
+start of each record --- F1 for the first record
+and F5 for the second record --- which contains
a bit list.
When a bit is on, that means its corresponding field
@@ -1586,17 +1586,17 @@
If, on the other hand, you look at an InnoDB
file, you'll find that it's got more complexities
in the storage. The details are in the internals.texi
-document -- which you'll find in the Docs directory,
-remember -- and you can ask for more details when
+document --- which you'll find in the Docs directory,
+remember --- and you can ask for more details when
you go to Heikki Tuuri's presentation at the MySQL
User conference. But here's an introductory
look.
-The header here begins with offsets -- unlike MyISAM,
+The header here begins with offsets --- unlike MyISAM,
which has no offsets. So you'd have to go through
column 1 before getting to column 2.
-Then there is a fixed header -- the extra bytes.
+Then there is a fixed header --- the extra bytes.
Then comes the record proper. The first fields of a
typical record contain information that the user won't
@@ -1604,7 +1604,7 @@
pointer. This part would look different if the user had
defined a primary key during the CREATE TABLE statement.
-And finally there are the column contents -- the
+And finally there are the column contents --- the
string of Ps at the end of the snippet here. You
can see that InnoDB does more administrating.
@@ -1626,7 +1626,7 @@
will be a look at packets.
By packet, we mean: what's the format of a message that
-the client sends over the tcp/ip line to the server --
+the client sends over the tcp/ip line to the server ---
and what does the server send back?
Here we're not displaying a dump. If you want to see
@@ -3783,11 +3783,11 @@
And R is the double-precision number that you see if you say:
SELECT MATCH(...) AGAINST (...) FROM t.
-To sum it up, w -- which stands for weight --
+To sum it up, w --- which stands for weight ---
goes up if the term occurs more often in a row, goes down if
the term occurs in many rows, goes up / down depending whether
the number of unique words in a row is fewer / more than average.
-Then R -- which stands for either Rank or Relevance -- is
+Then R --- which stands for either Rank or Relevance --- is
w times the frequence of the term in the AGAINST expression.
@strong{Looking at the text weights}
@@ -3861,7 +3861,7 @@
On the other hand, there are occasional complaints about speed.
Here, the tricky part is that the formula depends on global
-factors -- specifically N (the number of documents) and nf
+factors --- specifically N (the number of documents) and nf
(the number of documents that contain the term). Every time
that insert/update/delete occurs for any row in the table,
these global weight factors change for all rows in the table.
@@ -9427,7 +9427,7 @@
An unordered list is often called a "heap". If you make a pile of
stones by saying "whichever one I happen to pick up next will go on
-top" --- rather than organizing them according to size and colour --
+top" --- rather than organizing them according to size and colour ---
then you end up with a heap. Similarly, @code{InnoDB} does not want to insert
new rows according to the B-tree's key order (that would involve
expensive shifting of large amounts of data), so it inserts new rows
@@ -9713,82 +9713,82 @@
* zlib directory:: The @file{zlib} Directory
@end menu
-@strong{Directory -- Short Comment}
+@strong{Directory --- Short Comment}
@itemize @bullet
@item
-bdb -- The Berkeley Database table handler
+bdb --- The Berkeley Database table handler
@item
-BitKeeper -- BitKeeper administration (not part of the source distribution)
+BitKeeper --- BitKeeper administration (not part of the source distribution)
@item
-BUILD -- Frequently used build scripts
+BUILD --- Frequently used build scripts
@item
-Build-tools -- Build tools (not part of the source distribution)
+Build-tools --- Build tools (not part of the source distribution)
@item
-client -- Client library
+client --- Client library
@item
-cmd-line-utils -- Command-line utilities (libedit and readline)
+cmd-line-utils --- Command-line utilities (libedit and readline)
@item
-dbug -- Fred Fish's dbug library
+dbug --- Fred Fish's dbug library
@item
-Docs -- Preliminary documents about internals and new modules; will eventually be moved to the mysqldoc repository
+Docs --- Preliminary documents about internals and new modules; will eventually be moved to the mysqldoc repository
@item
-extra -- Some minor standalone utility programs
+extra --- Some minor standalone utility programs
@item
-heap -- The HEAP table handler
+heap --- The HEAP table handler
@item
-include -- Header (*.h) files for most libraries; includes all header files distributed with the MySQL binary distribution
+include --- Header (*.h) files for most libraries; includes all header files distributed with the MySQL binary distribution
@item
-innobase -- The Innobase (InnoDB) table handler
+innobase --- The Innobase (InnoDB) table handler
@item
-libmysql -- For producing MySQL as a library (e.g. a Windows .DLL)
+libmysql --- For producing MySQL as a library (e.g. a Windows .DLL)
@item
-libmysql_r -- For building a thread-safe libmysql library
+libmysql_r --- For building a thread-safe libmysql library
@item
-libmysqld -- The MySQL Server as an embeddable library
+libmysqld --- The MySQL Server as an embeddable library
@item
-man -- Some user-contributed manual pages
+man --- Some user-contributed manual pages
@item
-myisam -- The @code{MyISAM} table handler
+myisam --- The @code{MyISAM} table handler
@item
-myisammrg -- The @code{MyISAM} Merge table handler
+myisammrg --- The @code{MyISAM} Merge table handler
@item
-mysql-test -- A test suite for mysqld
+mysql-test --- A test suite for mysqld
@item
-mysys -- MySQL system library (Low level routines for file access etc.)
+mysys --- MySQL system library (Low level routines for file access etc.)
@item
-netware -- Files related to the Novell NetWare version of MySQL
+netware --- Files related to the Novell NetWare version of MySQL
@item
-NEW-RPMS -- Directory to place RPMs while making a distribution
+NEW-RPMS --- Directory to place RPMs while making a distribution
@item
-os2 -- Routines for working with the OS/2 operating system
+os2 --- Routines for working with the OS/2 operating system
@item
-pstack -- Process stack display (not currently used)
+pstack --- Process stack display (not currently used)
@item
-regex -- Henry Spencer's Regular Expression library for support of REGEXP function
+regex --- Henry Spencer's Regular Expression library for support of REGEXP function
@item
-SCCS -- Source Code Control System (not part of source distribution)
+SCCS --- Source Code Control System (not part of source distribution)
@item
-scripts -- SQL batches, e.g. mysqlbug and mysql_install_db
+scripts --- SQL batches, e.g. mysqlbug and mysql_install_db
@item
-sql -- Programs for handling SQL commands; the "core" of MySQL
+sql --- Programs for handling SQL commands; the "core" of MySQL
@item
-sql-bench -- The MySQL benchmarks
+sql-bench --- The MySQL benchmarks
@item
-SSL -- Secure Sockets Layer; includes an example certification one can use to test an SSL (secure) database connection
+SSL --- Secure Sockets Layer; includes an example certification one can use to test an SSL (secure) database connection
@item
-strings -- Library for C string routines, e.g. atof, strchr
+strings --- Library for C string routines, e.g. atof, strchr
@item
-support-files -- Files used to build MySQL on different systems
+support-files --- Files used to build MySQL on different systems
@item
-tests -- Tests in Perl and in C
+tests --- Tests in Perl and in C
@item
-tools -- mysqlmanager.c (tool under development, not yet useful)
+tools --- mysqlmanager.c (tool under development, not yet useful)
@item
-VC++Files -- Includes this entire directory, repeated for VC++ (Windows) use
+VC++Files --- Includes this entire directory, repeated for VC++ (Windows) use
@item
-vio -- Virtual I/O Library
+vio --- Virtual I/O Library
@item
-zlib -- Data compression library, used on Windows
+zlib --- Data compression library, used on Windows
@end itemize
@node BDB directory, BitKeeper directory, Source directory listing, Source directory listing
@@ -9813,7 +9813,7 @@
Bitkeeper administration is not part of the source distribution. This
directory may be present if you downloaded the MySQL source using
BitKeeper rather than via the mysql.com site. The files in the
-BitKeeper directory are for maintenance purposes only -- they are not
+BitKeeper directory are for maintenance purposes only --- they are not
part of the MySQL package.
The MySQL Reference Manual explains how to use Bitkeeper to get the
@@ -9847,7 +9847,7 @@
Build-tools is not part of the source distribution. This directory
contains batch files for extracting, making directories, and making
programs from source files. There are several subdirectories with
-different scripts -- for building Linux executables, for compiling,
+different scripts --- for building Linux executables, for compiling,
for performing all build steps, and so on.
@node client directory, cmd-line-utils directory, Build-tools directory, Source directory listing
@@ -9864,27 +9864,27 @@
The C program files in the directory are:
@itemize @bullet
@item
-get_password.c -- ask for a password from the console
+get_password.c --- ask for a password from the console
@item
-mysql.cc -- "The MySQL command tool"
+mysql.cc --- "The MySQL command tool"
@item
-mysqladmin.c -- maintenance of MySQL databases
+mysqladmin.c --- maintenance of MySQL databases
@item
-mysqlcheck.c -- check all databases, check connect, etc.
+mysqlcheck.c --- check all databases, check connect, etc.
@item
-mysqldump.c -- dump table's contents as SQL statements, suitable to backup a MySQL database
+mysqldump.c --- dump table's contents as SQL statements, suitable to backup a MySQL database
@item
-mysqlimport.c -- import text files in different formats into tables
+mysqlimport.c --- import text files in different formats into tables
@item
-mysqlmanager-pwgen.c -- pwgen stands for "password generation" (not currently maintained)
+mysqlmanager-pwgen.c --- pwgen stands for "password generation" (not currently maintained)
@item
-mysqlmanagerc.c -- entry point for mysql manager (not currently maintained)
+mysqlmanagerc.c --- entry point for mysql manager (not currently maintained)
@item
-mysqlshow.c -- show databases, tables or columns
+mysqlshow.c --- show databases, tables or columns
@item
-mysqltest.c -- test program used by the mysql-test suite, mysql-test-run
+mysqltest.c --- test program used by the mysql-test suite, mysql-test-run
@item
-password.c -- password checking routines (version 4.1 and up)
+password.c --- password checking routines (version 4.1 and up)
@end itemize
@node cmd-line-utils directory, dbug directory, client directory, Source directory listing
@@ -9910,47 +9910,47 @@
These are the program files in the \libedit subdirectory:
@itemize @bullet
@item
-chared.c -- character editor
+chared.c --- character editor
@item
-common.c -- common editor functions
+common.c --- common editor functions
@item
-el.c -- editline interface functions
+el.c --- editline interface functions
@item
-emacs.c -- emacs functions
+emacs.c --- emacs functions
@item
-fgetln.c -- get line
+fgetln.c --- get line
@item
-hist.c -- history access functions
+hist.c --- history access functions
@item
-history.c -- more history access functions
+history.c --- more history access functions
@item
-key.c -- procedures for maintaining the extended-key map
+key.c --- procedures for maintaining the extended-key map
@item
-map.c -- editor function definitions
+map.c --- editor function definitions
@item
-parse.c -- parse an editline extended command
+parse.c --- parse an editline extended command
@item
-prompt.c -- prompt printing functions
+prompt.c --- prompt printing functions
@item
-read.c -- terminal read functions
+read.c --- terminal read functions
@item
-readline.c -- read line
+readline.c --- read line
@item
-refresh.c -- "lower level screen refreshing functions"
+refresh.c --- "lower level screen refreshing functions"
@item
-search.c -- "history and character search functions"
+search.c --- "history and character search functions"
@item
-sig.c -- for signal handling
+sig.c --- for signal handling
@item
-strlcpy.c -- string copy
+strlcpy.c --- string copy
@item
-term.c -- "editor/termcap-curses interface"
+term.c --- "editor/termcap-curses interface"
@item
-tokenizer.c -- Bourne shell line tokenizer
+tokenizer.c --- Bourne shell line tokenizer
@item
-tty.c -- for a tty interface
+tty.c --- for a tty interface
@item
-vi.c -- commands used when in the vi (editor) mode
+vi.c --- commands used when in the vi (editor) mode
@end itemize
@node dbug directory, Docs directory, cmd-line-utils directory, Source directory listing
@@ -9984,21 +9984,21 @@
The C programs in this directory are:
@itemize @bullet
@item
-dbug.c -- The main module
+dbug.c --- The main module
@item
-dbug_analyze.c -- Reads a file produced by trace functions
+dbug_analyze.c --- Reads a file produced by trace functions
@item
-example1.c -- A tiny example
+example1.c --- A tiny example
@item
-example2.c -- A tiny example
+example2.c --- A tiny example
@item
-example3.c -- A tiny example
+example3.c --- A tiny example
@item
-factorial.c -- A tiny example
+factorial.c --- A tiny example
@item
-main.c -- A tiny example
+main.c --- A tiny example
@item
-sanity.c -- Declaration of a variable
+sanity.c --- Declaration of a variable
@end itemize
@node Docs directory, extra directory, dbug directory, Source directory listing
@@ -10016,27 +10016,27 @@
These sub-directories are part of this directory:
@itemize @bullet
@item
-books -- .gif images and empty .txt files; no real information
+books --- .gif images and empty .txt files; no real information
@item
-flags -- images of flags of countries
+flags --- images of flags of countries
@item
-images -- flag backgrounds and the MySQL dolphin logo
+images --- flag backgrounds and the MySQL dolphin logo
@item
-mysql-logos -- more MySQL-related logos, some of them moving
+mysql-logos --- more MySQL-related logos, some of them moving
@item
-raw-flags -- more country flags, all .gif files
+raw-flags --- more country flags, all .gif files
@item
-support -- various files for generating texinfo/docbook documentation
+support --- various files for generating texinfo/docbook documentation
@item
-to-be-included... -- contains a MySQL-for-dummies file
+to-be-included... --- contains a MySQL-for-dummies file
@item
-translations -- some Portuguese myodbc documentation
+translations --- some Portuguese myodbc documentation
@end itemize
In the main directory, you'll find some .txt files related to the
methods that MySQL uses to produce its printed and html documents, odd
bits in various languages, and the single file in the directory which
-has any importance -- @file{internals.texi} -- The "MySQL Internals"
+has any importance --- @file{internals.texi} --- The "MySQL Internals"
document.
Despite the name, @file{internals.texi} is not yet much of a description
@@ -10056,17 +10056,17 @@
follows:
@itemize @bullet
@item
-my_print_defaults.c -- print parameters from my.ini files. Can also be used in scripts to enable processing of my.ini files.
+my_print_defaults.c --- print parameters from my.ini files. Can also be used in scripts to enable processing of my.ini files.
@item
-mysql_waitpid.c -- wait for a program to terminate. Useful for shell scripts when one needs to wait until a process terminates.
+mysql_waitpid.c --- wait for a program to terminate. Useful for shell scripts when one needs to wait until a process terminates.
@item
-perror.c -- "print error" -- given error number, display message
+perror.c --- "print error" --- given error number, display message
@item
-replace.c -- replace strings in text files or pipe
+replace.c --- replace strings in text files or pipe
@item
-resolve_stack_dump.c -- show symbolic information from a MySQL stack dump, normally found in the mysql.err file
+resolve_stack_dump.c --- show symbolic information from a MySQL stack dump, normally found in the mysql.err file
@item
-resolveip.c -- convert an IP address to a hostname, or vice versa
+resolveip.c --- convert an IP address to a hostname, or vice versa
@end itemize
@node heap directory, include directory, extra directory, Source directory listing
@@ -10088,54 +10088,54 @@
@itemize @bullet
@item
-hp_block.c -- Read/write a block (i.e. a page)
+hp_block.c --- Read/write a block (i.e. a page)
@item
-hp_clear.c -- Remove all records in the table
+hp_clear.c --- Remove all records in the table
@item
-hp_close.c -- * close database
+hp_close.c --- * close database
@item
-hp_create.c -- * create a table
+hp_create.c --- * create a table
@item
-hp_delete.c -- * delete a row
+hp_delete.c --- * delete a row
@item
-hp_extra.c -- * for setting options and buffer sizes when optimizing
+hp_extra.c --- * for setting options and buffer sizes when optimizing
@item
-hp_hash.c -- Hash functions used for saving keys
+hp_hash.c --- Hash functions used for saving keys
@item
-hp_info.c -- * Information about database status
+hp_info.c --- * Information about database status
@item
-hp_open.c -- * open database
+hp_open.c --- * open database
@item
-hp_panic.c -- * the hp_panic routine, for shutdowns and flushes
+hp_panic.c --- * the hp_panic routine, for shutdowns and flushes
@item
-hp_rename.c -- * rename a table
+hp_rename.c --- * rename a table
@item
-hp_rfirst.c -- * read first row through a specific key (very short)
+hp_rfirst.c --- * read first row through a specific key (very short)
@item
-hp_rkey.c -- * read record using a key
+hp_rkey.c --- * read record using a key
@item
-hp_rlast.c -- * read last row with same key as previously-read row
+hp_rlast.c --- * read last row with same key as previously-read row
@item
-hp_rnext.c -- * read next row with same key as previously-read row
+hp_rnext.c --- * read next row with same key as previously-read row
@item
-hp_rprev.c -- * read previous row with same key as previously-read row
+hp_rprev.c --- * read previous row with same key as previously-read row
@item
-hp_rrnd.c -- * read a row based on position
+hp_rrnd.c --- * read a row based on position
@item
-hp_rsame.c -- * find current row using positional read or key-based
+hp_rsame.c --- * find current row using positional read or key-based
read
@item
-hp_scan.c -- * read all rows sequentially
+hp_scan.c --- * read all rows sequentially
@item
-hp_static.c -- * static variables (very short)
+hp_static.c --- * static variables (very short)
@item
-hp_test1.c -- * testing basic functions
+hp_test1.c --- * testing basic functions
@item
-hp_test2.c -- * testing database and storing results
+hp_test2.c --- * testing database and storing results
@item
-hp_update.c -- * update an existing row
+hp_update.c --- * update an existing row
@item
-hp_write.c -- * insert a new row
+hp_write.c --- * insert a new row
@end itemize
There are fewer files in the heap directory than in the myisam
@@ -10195,17 +10195,17 @@
The program files on this directory are:
@itemize @bullet
@item
-conf_to_src.c -- has to do with charsets
+conf_to_src.c --- has to do with charsets
@item
-dll.c -- initialization of the dll library
+dll.c --- initialization of the dll library
@item
-errmsg.c -- English error messages, compare \mysys\errors.c
+errmsg.c --- English error messages, compare \mysys\errors.c
@item
-get_password.c -- get password
+get_password.c --- get password
@item
-libmysql.c -- the code that implements the MySQL API, i.e. the functions a client that wants to connect to MySQL will call
+libmysql.c --- the code that implements the MySQL API, i.e. the functions a client that wants to connect to MySQL will call
@item
-manager.c -- initialize/connect/fetch with MySQL manager
+manager.c --- initialize/connect/fetch with MySQL manager
@end itemize
@node libmysql_r directory, libmysqld directory, libmysql directory, Source directory listing
@@ -10230,9 +10230,9 @@
are:
@itemize @bullet
@item
-libmysqld.c -- The called side, compare the mysqld.exe source
+libmysqld.c --- The called side, compare the mysqld.exe source
@item
-lib_vio.c -- Emulate the vio directory's communication buffer
+lib_vio.c --- Emulate the vio directory's communication buffer
@end itemize
@node man directory, myisam directory, libmysqld directory, Source directory listing
@@ -10253,17 +10253,17 @@
The C files in this subdirectory come in six main groups:
@itemize @bullet
@item
-ft*.c files -- ft stands for "Full Text", code contributed by Sergei Golubchik
+ft*.c files --- ft stands for "Full Text", code contributed by Sergei Golubchik
@item
-mi*.c files -- mi stands for "My Isam", these are the main programs for Myisam
+mi*.c files --- mi stands for "My Isam", these are the main programs for Myisam
@item
-myisam*.c files -- for example, "myisamchk" utility routine functions source
+myisam*.c files --- for example, "myisamchk" utility routine functions source
@item
-rt*.c files -- rt stands for "rtree", some code was written by Alexander Barkov
+rt*.c files --- rt stands for "rtree", some code was written by Alexander Barkov
@item
-sp*.c files -- sp stands for "spatial", some code was written by Ramil Kalimullin
+sp*.c files --- sp stands for "spatial", some code was written by Ramil Kalimullin
@item
-sort.c -- this is a single file that sorts keys for index-create purposes
+sort.c --- this is a single file that sorts keys for index-create purposes
@end itemize
The "full text" and "rtree" and "spatial" program sets are for special
@@ -10271,87 +10271,87 @@
programs. They are:
@itemize @bullet
@item
-mi_cache.c -- for reading records from a cache
+mi_cache.c --- for reading records from a cache
@item
-mi_changed.c -- a single routine for setting a "changed" flag (very short)
+mi_changed.c --- a single routine for setting a "changed" flag (very short)
@item
-mi_check.c -- for checking and repairing tables. Used by the myisamchk program and by the MySQL server.
+mi_check.c --- for checking and repairing tables. Used by the myisamchk program and by the MySQL server.
@item
-mi_checksum.c -- calculates a checksum for a row
+mi_checksum.c --- calculates a checksum for a row
@item
-mi_close.c -- close database
+mi_close.c --- close database
@item
-mi_create.c -- create a table
+mi_create.c --- create a table
@item
-mi_dbug.c -- support routines for use with "dbug" (see \dbug description)
+mi_dbug.c --- support routines for use with "dbug" (see \dbug description)
@item
-mi_delete.c -- delete a row
+mi_delete.c --- delete a row
@item
-mi_delete_all.c -- delete all rows
+mi_delete_all.c --- delete all rows
@item
-mi_delete_table.c -- delete a table (very short)
+mi_delete_table.c --- delete a table (very short)
@item
-mi_dynrec.c -- functions to handle space-packed records and blobs
+mi_dynrec.c --- functions to handle space-packed records and blobs
@item
-mi_extra.c -- setting options and buffer sizes when optimizing
+mi_extra.c --- setting options and buffer sizes when optimizing
@item
-mi_info.c -- return useful base information for an open table
+mi_info.c --- return useful base information for an open table
@item
-mi_key.c -- for handling keys
+mi_key.c --- for handling keys
@item
-mi_locking.c -- lock database
+mi_locking.c --- lock database
@item
-mi_log.c -- save commands in a log file which myisamlog program can read. Can be used to exactly replay a set of changes to a table.
+mi_log.c --- save commands in a log file which myisamlog program can read. Can be used to exactly replay a set of changes to a table.
@item
-mi_open.c -- open database
+mi_open.c --- open database
@item
-mi_packrec.c -- read from a data file compresed with myisampack
+mi_packrec.c --- read from a data file compresed with myisampack
@item
-mi_page.c -- read and write pages containing keys
+mi_page.c --- read and write pages containing keys
@item
-mi_panic.c -- the mi_panic routine, probably for sudden shutdowns
+mi_panic.c --- the mi_panic routine, probably for sudden shutdowns
@item
-mi_range.c -- approximate count of how many records lie between two keys
+mi_range.c --- approximate count of how many records lie between two keys
@item
-mi_rename.c -- rename a table
+mi_rename.c --- rename a table
@item
-mi_rfirst.c -- read first row through a specific key (very short)
+mi_rfirst.c --- read first row through a specific key (very short)
@item
-mi_rkey.c -- read a record using a key
+mi_rkey.c --- read a record using a key
@item
-mi_rlast.c -- read last row with same key as previously-read row
+mi_rlast.c --- read last row with same key as previously-read row
@item
-mi_rnext.c -- read next row with same key as previously-read row
+mi_rnext.c --- read next row with same key as previously-read row
@item
-mi_rnext_same.c -- same as mi_rnext.c, but abort if the key changes
+mi_rnext_same.c --- same as mi_rnext.c, but abort if the key changes
@item
-mi_rprev.c -- read previous row with same key as previously-read row
+mi_rprev.c --- read previous row with same key as previously-read row
@item
-mi_rrnd.c -- read a row based on position
+mi_rrnd.c --- read a row based on position
@item
-mi_rsame.c -- find current row using positional read or key-based read
+mi_rsame.c --- find current row using positional read or key-based read
@item
-mi_rsamepos.c -- positional read
+mi_rsamepos.c --- positional read
@item
-mi_scan.c -- read all rows sequentially
+mi_scan.c --- read all rows sequentially
@item
-mi_search.c -- key-handling functions
+mi_search.c --- key-handling functions
@item
-mi_static.c -- static variables (very short)
+mi_static.c --- static variables (very short)
@item
-mi_statrec.c -- functions to handle fixed-length records
+mi_statrec.c --- functions to handle fixed-length records
@item
-mi_test1.c -- testing basic functions
+mi_test1.c --- testing basic functions
@item
-mi_test2.c -- testing database and storing results
+mi_test2.c --- testing database and storing results
@item
-mi_test3.c -- testing locking
+mi_test3.c --- testing locking
@item
-mi_unique.c -- functions to check if a row is unique
+mi_unique.c --- functions to check if a row is unique
@item
-mi_update.c -- update an existing row
+mi_update.c --- update an existing row
@item
-mi_write.c -- insert a new row
+mi_write.c --- insert a new row
@end itemize
@node myisammrg directory, mysql-test directory, myisam directory, Source directory listing
@@ -10371,52 +10371,52 @@
the @code{myisam} functions or programs they're connected with:
@itemize @bullet
@item
-myrg_close.c -- mi_close.c
+myrg_close.c --- mi_close.c
@item
-myrg_create.c -- mi_create.c
+myrg_create.c --- mi_create.c
@item
-myrg_delete.c -- mi_delete.c / delete last-read record
+myrg_delete.c --- mi_delete.c / delete last-read record
@item
-myrg_extra.c -- mi_extra.c / "extra functions we want to do ..."
+myrg_extra.c --- mi_extra.c / "extra functions we want to do ..."
@item
-myrg_info.c -- mi_info.c / display information about a mymerge file
+myrg_info.c --- mi_info.c / display information about a mymerge file
@item
-myrg_locking.c -- mi_locking.c / lock databases
+myrg_locking.c --- mi_locking.c / lock databases
@item
-myrg_open.c -- mi_open.c / open a @code{MyISAM} @code{MERGE} table
+myrg_open.c --- mi_open.c / open a @code{MyISAM} @code{MERGE} table
@item
-myrg_panic.c -- mi_panic.c / close in a hurry
+myrg_panic.c --- mi_panic.c / close in a hurry
@item
-myrg_queue.c -- read record based on a key
+myrg_queue.c --- read record based on a key
@item
-myrg_range.c -- mi_range.c / find records in a range
+myrg_range.c --- mi_range.c / find records in a range
@item
-myrg_rfirst.c -- mi_rfirst.c / read first record according to
+myrg_rfirst.c --- mi_rfirst.c / read first record according to
specific key
@item
-myrg_rkey.c -- mi_rkey.c / read record based on a key
+myrg_rkey.c --- mi_rkey.c / read record based on a key
@item
-myrg_rlast.c -- mi_rlast.c / read last row with same key as previous
+myrg_rlast.c --- mi_rlast.c / read last row with same key as previous
read
@item
-myrg_rnext.c -- mi_rnext.c / read next row with same key as previous
+myrg_rnext.c --- mi_rnext.c / read next row with same key as previous
read
@item
-myrg_rnext_same.c -- mi_rnext_same.c / read next row with same key
+myrg_rnext_same.c --- mi_rnext_same.c / read next row with same key
@item
-myrg_rprev.c -- mi_rprev.c / read previous row with same key
+myrg_rprev.c --- mi_rprev.c / read previous row with same key
@item
-myrg_rrnd.c -- mi_rrnd.c / read record with random access
+myrg_rrnd.c --- mi_rrnd.c / read record with random access
@item
-myrg_rsame.c -- mi_rsame.c / call mi_rsame function, see
+myrg_rsame.c --- mi_rsame.c / call mi_rsame function, see
\myisam\mi_rsame.c
@item
-myrg_static.c -- mi_static.c / static variable declaration
+myrg_static.c --- mi_static.c / static variable declaration
@item
-myrg_update.c -- mi_update.c / call mi_update function, see
+myrg_update.c --- mi_update.c / call mi_update function, see
\myisam\mi_update.c
@item
-myrg_write.c -- mi_write.c / call mi_write function, see
+myrg_write.c --- mi_write.c / call mi_write function, see
\myisam\mi_write.c
@end itemize
@@ -10432,14 +10432,14 @@
There are four subdirectories:
@itemize @bullet
@item
-\misc -- contains one minor Perl program
+\misc --- contains one minor Perl program
@item
-\r -- contains *.result, i.e. "what happened" files and
+\r --- contains *.result, i.e. "what happened" files and
*.required, i.e. "what should happen" file
@item
-\std_data -- contains standard data for input to tests
+\std_data --- contains standard data for input to tests
@item
-\t -- contains tests
+\t --- contains tests
@end itemize
There are 186 @file{*.test} files in the @file{\t} subdirectory. Primarily
@@ -10464,249 +10464,249 @@
There are 115 *.c programs in this directory:
@itemize @bullet
@item
-array.c -- Dynamic array handling
+array.c --- Dynamic array handling
@item
-charset.c -- Using dynamic character sets, set default character set, ...
+charset.c --- Using dynamic character sets, set default character set, ...
@item
-charset2html.c -- Check what character set a browser is using
+charset2html.c --- Check what character set a browser is using
@item
-checksum.c -- Calculate checksum for a memory block, used for pack_isam
+checksum.c --- Calculate checksum for a memory block, used for pack_isam
@item
-default.c -- Find defaults from *.cnf or *.ini files
+default.c --- Find defaults from *.cnf or *.ini files
@item
-errors.c -- English text of global errors
+errors.c --- English text of global errors
@item
-hash.c -- Hash search/compare/free functions "for saving keys"
+hash.c --- Hash search/compare/free functions "for saving keys"
@item
-list.c -- Double-linked lists
+list.c --- Double-linked lists
@item
-make-conf.c -- "Make a charset .conf file out of a ctype-charset.c file"
+make-conf.c --- "Make a charset .conf file out of a ctype-charset.c file"
@item
-md5.c -- MD5 ("Message Digest 5") algorithm from RSA Data Security
+md5.c --- MD5 ("Message Digest 5") algorithm from RSA Data Security
@item
-mf_brkhant.c -- Prevent user from doing a Break during critical execution
+mf_brkhant.c --- Prevent user from doing a Break during critical execution
(not used in MySQL; can be used by standalone @code{MyISAM} applications)
@item
-mf_cache.c -- "Open a temporary file and cache it with io_cache"
+mf_cache.c --- "Open a temporary file and cache it with io_cache"
@item
-mf_dirname.c -- Parse/convert directory names
+mf_dirname.c --- Parse/convert directory names
@item
-mf_fn_ext.c -- Get filename extension
+mf_fn_ext.c --- Get filename extension
@item
-mf_format.c -- Format a filename
+mf_format.c --- Format a filename
@item
-mf_getdate.c -- Get date, return in yyyy-mm-dd hh:mm:ss format
+mf_getdate.c --- Get date, return in yyyy-mm-dd hh:mm:ss format
@item
-mf_iocache.c -- Cached read/write of files in fixed-size units
+mf_iocache.c --- Cached read/write of files in fixed-size units
@item
-mf_iocache2.c -- Continuation of mf_iocache.c
+mf_iocache2.c --- Continuation of mf_iocache.c
@item
-mf_keycache.c -- Key block caching for certain file types
+mf_keycache.c --- Key block caching for certain file types
@item
-mf_loadpath.c -- Return full path name (no ..\ stuff)
+mf_loadpath.c --- Return full path name (no ..\ stuff)
@item
-mf_pack.c -- Packing/unpacking directory names for create purposes
+mf_pack.c --- Packing/unpacking directory names for create purposes
@item
-mf_path.c -- Determine where a program can find its files
+mf_path.c --- Determine where a program can find its files
@item
-mf_qsort.c -- Quicksort
+mf_qsort.c --- Quicksort
@item
-mf_qsort2.c -- Quicksort, part 2 (allows the passing of an extra argument to the sort-compare routine)
+mf_qsort2.c --- Quicksort, part 2 (allows the passing of an extra argument to the sort-compare routine)
@item
-mf_radix.c -- Radix sort
+mf_radix.c --- Radix sort
@item
-mf_same.c -- Determine whether filenames are the same
+mf_same.c --- Determine whether filenames are the same
@item
-mf_sort.c -- Sort with choice of Quicksort or Radix sort
+mf_sort.c --- Sort with choice of Quicksort or Radix sort
@item
-mf_soundex.c -- Soundex algorithm derived from EDN Nov. 14, 1985 (pg. 36)
+mf_soundex.c --- Soundex algorithm derived from EDN Nov. 14, 1985 (pg. 36)
@item
-mf_strip.c -- Strip trail spaces from a string
+mf_strip.c --- Strip trail spaces from a string
@item
-mf_tempdir.c -- Initialize/find/free temporary directory
+mf_tempdir.c --- Initialize/find/free temporary directory
@item
-mf_tempfile.c -- Create a temporary file
+mf_tempfile.c --- Create a temporary file
@item
-mf_unixpath.c -- Convert filename to UNIX-style filename
+mf_unixpath.c --- Convert filename to UNIX-style filename
@item
-mf_util.c -- Routines, #ifdef'd, which may be missing on some
+mf_util.c --- Routines, #ifdef'd, which may be missing on some
machines
@item
-mf_wcomp.c -- Comparisons with wildcards
+mf_wcomp.c --- Comparisons with wildcards
@item
-mf_wfile.c -- Finding files with wildcards
+mf_wfile.c --- Finding files with wildcards
@item
-mulalloc.c -- Malloc many pointers at the same time
+mulalloc.c --- Malloc many pointers at the same time
@item
-my_aes.c -- AES encryption
+my_aes.c --- AES encryption
@item
-my_alarm.c -- Set a variable value when an alarm is received
+my_alarm.c --- Set a variable value when an alarm is received
@item
-my_alloc.c -- malloc of results which will be freed simultaneously
+my_alloc.c --- malloc of results which will be freed simultaneously
@item
-my_append.c -- one file to another
+my_append.c --- one file to another
@item
-my_bit.c -- smallest X where 2^X >= value, maybe useful for
+my_bit.c --- smallest X where 2^X >= value, maybe useful for
divisions
@item
-my_bitmap.c -- Handle uchar arrays as large bitmaps
+my_bitmap.c --- Handle uchar arrays as large bitmaps
@item
-my_chsize.c -- Truncate file if shorter, else fill with a filler
+my_chsize.c --- Truncate file if shorter, else fill with a filler
character
@item
-my_clock.c -- Time-of-day ("clock()") function, with OS-dependent
+my_clock.c --- Time-of-day ("clock()") function, with OS-dependent
#ifdef's
@item
-my_compress.c -- Compress packet (see also description of \zlib
+my_compress.c --- Compress packet (see also description of \zlib
directory)
@item
-my_copy.c -- Copy files
+my_copy.c --- Copy files
@item
-my_create.c -- Create file
+my_create.c --- Create file
@item
-my_delete.c -- Delete file
+my_delete.c --- Delete file
@item
-my_div.c -- Get file's name
+my_div.c --- Get file's name
@item
-my_dup.c -- Open a duplicated file
+my_dup.c --- Open a duplicated file
@item
-my_error.c -- Return formatted error to user
+my_error.c --- Return formatted error to user
@item
-my_fopen.c -- File open
+my_fopen.c --- File open
@item
-my_fstream.c -- Streaming file read/write
+my_fstream.c --- Streaming file read/write
@item
-my_getwd.c -- Get working directory
+my_getwd.c --- Get working directory
@item
-my_gethostbyname.c -- Thread-safe version of standard net
+my_gethostbyname.c --- Thread-safe version of standard net
gethostbyname() func
@item
-my_getopt.c -- Find out what options are in effect
+my_getopt.c --- Find out what options are in effect
@item
-my_handler.c -- Compare two keys in various possible formats
+my_handler.c --- Compare two keys in various possible formats
@item
-my_init.c -- Initialize variables and functions in the mysys library
+my_init.c --- Initialize variables and functions in the mysys library
@item
-my_lib.c -- Compare/convert directory names and file names
+my_lib.c --- Compare/convert directory names and file names
@item
-my_lock.c -- Lock part of a file
+my_lock.c --- Lock part of a file
@item
-my_lockmem.c -- "Allocate a block of locked memory"
+my_lockmem.c --- "Allocate a block of locked memory"
@item
-my_lread.c -- Read a specified number of bytes from a file into
+my_lread.c --- Read a specified number of bytes from a file into
memory
@item
-my_lwrite.c -- Write a specified number of bytes from memory into a
+my_lwrite.c --- Write a specified number of bytes from memory into a
file
@item
-my_malloc.c -- Malloc (memory allocate) and dup functions
+my_malloc.c --- Malloc (memory allocate) and dup functions
@item
-my_messnc.c -- Put out a message on stderr with "no curses"
+my_messnc.c --- Put out a message on stderr with "no curses"
@item
-my_mkdir.c -- Make directory
+my_mkdir.c --- Make directory
@item
-my_net.c -- Thread-safe version of net inet_ntoa function
+my_net.c --- Thread-safe version of net inet_ntoa function
@item
-my_netware.c -- Functions used only with the Novell Netware version
+my_netware.c --- Functions used only with the Novell Netware version
of MySQL
@item
-my_once.c -- Allocation / duplication for "things we don't need to
+my_once.c --- Allocation / duplication for "things we don't need to
free"
@item
-my_open.c -- Open a file
+my_open.c --- Open a file
@item
-my_os2cond.c -- OS2-specific: "A simple implementation of posix conditions"
+my_os2cond.c --- OS2-specific: "A simple implementation of posix conditions"
@item
-my_os2dirsrch.c -- OS2-specific: Emulate a Win32 directory search
+my_os2dirsrch.c --- OS2-specific: Emulate a Win32 directory search
@item
-my_os2dlfcn.c -- OS2-specific: Emulate UNIX dynamic loading
+my_os2dlfcn.c --- OS2-specific: Emulate UNIX dynamic loading
@item
-my_os2file64.c -- OS2-specific: For File64bit setting
+my_os2file64.c --- OS2-specific: For File64bit setting
@item
-my_os2mutex.c -- OS2-specific: For mutex handling
+my_os2mutex.c --- OS2-specific: For mutex handling
@item
-my_os2thread.c -- OS2-specific: For thread handling
+my_os2thread.c --- OS2-specific: For thread handling
@item
-my_os2tls.c -- OS2-specific: For thread-local storage
+my_os2tls.c --- OS2-specific: For thread-local storage
@item
-my_port.c -- OS/machine-dependent porting functions, e.g. AIX-specific my_ulonglong2double()
+my_port.c --- OS/machine-dependent porting functions, e.g. AIX-specific my_ulonglong2double()
@item
-my_pread.c -- Read a specified number of bytes from a file
+my_pread.c --- Read a specified number of bytes from a file
@item
-my_pthread.c -- A wrapper for thread-handling functions in different OSs
+my_pthread.c --- A wrapper for thread-handling functions in different OSs
@item
-my_quick.c -- Read/write (labeled a "quicker" interface, perhaps
+my_quick.c --- Read/write (labeled a "quicker" interface, perhaps
obsolete)
@item
-my_read.c -- Read a specified number of bytes from a file, possibly
+my_read.c --- Read a specified number of bytes from a file, possibly
retry
@item
-my_realloc.c -- Reallocate memory allocated with my_alloc.c
+my_realloc.c --- Reallocate memory allocated with my_alloc.c
(probably)
@item
-my_redel.c -- Rename and delete file
+my_redel.c --- Rename and delete file
@item
-my_rename.c -- Rename without delete
+my_rename.c --- Rename without delete
@item
-my_seek.c -- Seek, i.e. point to a spot within a file
+my_seek.c --- Seek, i.e. point to a spot within a file
@item
-my_semaphore.c -- Semaphore routines, for use on OS that doesn't support them
+my_semaphore.c --- Semaphore routines, for use on OS that doesn't support them
@item
-my_sleep.c -- Wait n microseconds
+my_sleep.c --- Wait n microseconds
@item
-my_static.c -- Static variables used by the mysys library
+my_static.c --- Static variables used by the mysys library
@item
-my_symlink.c -- Read a symbolic link (symlinks are a UNIX thing, I guess)
+my_symlink.c --- Read a symbolic link (symlinks are a UNIX thing, I guess)
@item
-my_symlink2.c -- Part 2 of my_symlink.c
+my_symlink2.c --- Part 2 of my_symlink.c
@item
-my_tempnam.c -- Obsolete temporary-filename routine used by ISAM table handler
+my_tempnam.c --- Obsolete temporary-filename routine used by ISAM table handler
@item
-my_thr_init.c -- initialize/allocate "all mysys & debug thread variables"
+my_thr_init.c --- initialize/allocate "all mysys & debug thread variables"
@item
-my_wincond.c -- Windows-specific: emulate Posix conditions
+my_wincond.c --- Windows-specific: emulate Posix conditions
@item
-my_winsem.c -- Windows-specific: emulate Posix threads
+my_winsem.c --- Windows-specific: emulate Posix threads
@item
-my_winthread.c -- Windows-specific: emulate Posix threads
+my_winthread.c --- Windows-specific: emulate Posix threads
@item
-my_write.c -- Write a specified number of bytes to a file
+my_write.c --- Write a specified number of bytes to a file
@item
-ptr_cmp.c -- Point to an optimal byte-comparison function
+ptr_cmp.c --- Point to an optimal byte-comparison function
@item
-queues.c -- Handle priority queues as in Robert Sedgewick's book
+queues.c --- Handle priority queues as in Robert Sedgewick's book
@item
-raid2.c -- RAID support (the true implementation is in raid.cc)
+raid2.c --- RAID support (the true implementation is in raid.cc)
@item
-rijndael.c -- "Optimized ANSI C code for the Rijndael cipher (now AES")
+rijndael.c --- "Optimized ANSI C code for the Rijndael cipher (now AES")
@item
-safemalloc.c -- A version of the standard malloc() with safety checking
+safemalloc.c --- A version of the standard malloc() with safety checking
@item
-sha1.c -- Implementation of Secure Hashing Algorithm 1
+sha1.c --- Implementation of Secure Hashing Algorithm 1
@item
-string.c -- Initialize/append/free dynamically-sized strings; see also sql_string.cc in the /sql directory
+string.c --- Initialize/append/free dynamically-sized strings; see also sql_string.cc in the /sql directory
@item
-testhash.c -- Standalone program: test the hash library routines
+testhash.c --- Standalone program: test the hash library routines
@item
-test_charset.c -- Standalone program: display character set information
+test_charset.c --- Standalone program: display character set information
@item
-test_dir.c -- Standalone program: placeholder for "test all functions" idea
+test_dir.c --- Standalone program: placeholder for "test all functions" idea
@item
-test_fn.c -- Standalone program: apparently tests a function
+test_fn.c --- Standalone program: apparently tests a function
@item
-test_xml.c -- Standalone program: test XML routines
+test_xml.c --- Standalone program: test XML routines
@item
-thr_alarm.c -- Thread alarms and signal handling
+thr_alarm.c --- Thread alarms and signal handling
@item
-thr_lock.c -- "Read and write locks for Posix threads"
+thr_lock.c --- "Read and write locks for Posix threads"
@item
-thr_mutex.c -- A wrapper for mutex functions
+thr_mutex.c --- A wrapper for mutex functions
@item
-thr_rwlock.c -- Synchronizes the readers' thread locks with the writer's lock
+thr_rwlock.c --- Synchronizes the readers' thread locks with the writer's lock
@item
-tree.c -- Initialize/search/free binary trees
+tree.c --- Initialize/search/free binary trees
@item
-typelib.c -- Find a string in a set of strings; returns the offset to the string found
+typelib.c --- Find a string in a set of strings; returns the offset to the string found
@end itemize
You can find documentation for the main functions in these files
@@ -10736,21 +10736,21 @@
These are the five *.c files, all from Novell Inc.:
@itemize @bullet
@item
-libmysqlmain.c -- Only one function: init_available_charsets()
+libmysqlmain.c --- Only one function: init_available_charsets()
@item
-my_manage.c -- Standalone management utility
+my_manage.c --- Standalone management utility
@item
-mysql_install_db.c -- Compare \scripts\mysql_install_db.sh
+mysql_install_db.c --- Compare \scripts\mysql_install_db.sh
@item
-mysql_test_run.c -- Short test program
+mysql_test_run.c --- Short test program
@item
-mysqld_safe.c -- Compare \scripts\mysqld_safe.sh
+mysqld_safe.c --- Compare \scripts\mysqld_safe.sh
@end itemize
Perhaps the most important file is:
@itemize @bullet
@item
-netware.patch -- NetWare-specific build instructions and switches
+netware.patch --- NetWare-specific build instructions and switches
(compare \mysql-4.1\ltmain.sh)
@end itemize
@@ -10848,47 +10848,47 @@
The @file{*.sh} files on this directory are:
@itemize @bullet
@item
-fill_help_tables.sh -- Create help-information tables and insert
+fill_help_tables.sh --- Create help-information tables and insert
@item
-make_binary_distribution.sh -- Get configure information, make, produce tar
+make_binary_distribution.sh --- Get configure information, make, produce tar
@item
-msql2mysql.sh -- Convert (partly) mSQL programs and scripts to MySQL
+msql2mysql.sh --- Convert (partly) mSQL programs and scripts to MySQL
@item
-mysqlbug.sh -- Create a bug report and mail it
+mysqlbug.sh --- Create a bug report and mail it
@item
-mysqld_multi.sh -- Start/stop any number of mysqld instances
+mysqld_multi.sh --- Start/stop any number of mysqld instances
@item
-mysqld_safe-watch.sh -- Start/restart in safe mode
+mysqld_safe-watch.sh --- Start/restart in safe mode
@item
-mysqld_safe.sh -- Start/restart in safe mode
+mysqld_safe.sh --- Start/restart in safe mode
@item
-mysqldumpslow.sh -- Parse and summarize the slow query log
+mysqldumpslow.sh --- Parse and summarize the slow query log
@item
-mysqlhotcopy.sh -- Hot backup
+mysqlhotcopy.sh --- Hot backup
@item
-mysql_config.sh -- Get configuration information that might be needed to compile a client
+mysql_config.sh --- Get configuration information that might be needed to compile a client
@item
-mysql_convert_table_format.sh -- Conversion, e.g. from @code{ISAM} to
+mysql_convert_table_format.sh --- Conversion, e.g. from @code{ISAM} to
@code{MyISAM}
@item
-mysql_explain_log.sh -- Put a log (made with @code{--log}) into a MySQL table
+mysql_explain_log.sh --- Put a log (made with @code{--log}) into a MySQL table
@item
-mysql_find_rows.sh -- Search for queries containing @code{<regexp>}
+mysql_find_rows.sh --- Search for queries containing @code{<regexp>}
@item
-mysql_fix_extensions.sh -- Renames some file extensions, not recommended
+mysql_fix_extensions.sh --- Renames some file extensions, not recommended
@item
-mysql_fix_privilege_tables.sh -- Fix @code{mysql.user} etc. when upgrading. Can be safely run during any upgrade to get the newest
+mysql_fix_privilege_tables.sh --- Fix @code{mysql.user} etc. when upgrading. Can be safely run during any upgrade to get the newest
MySQL privilege tables
@item
-mysql_install_db.sh -- Create privilege tables and func table
+mysql_install_db.sh --- Create privilege tables and func table
@item
-mysql_secure_installation.sh -- Disallow remote root login, eliminate test, etc.
+mysql_secure_installation.sh --- Disallow remote root login, eliminate test, etc.
@item
-mysql_setpermission.sh -- Aid to add users or databases, sets privileges
+mysql_setpermission.sh --- Aid to add users or databases, sets privileges
@item
-mysql_tableinfo.sh -- Puts info re MySQL tables into a MySQL table
+mysql_tableinfo.sh --- Puts info re MySQL tables into a MySQL table
@item
-mysql_zap.sh -- Kill processes that match pattern
+mysql_zap.sh --- Kill processes that match pattern
@end itemize
@node sql directory, sql-bench directory, scripts directory, Source directory listing
@@ -10899,198 +10899,198 @@
These are the @file{.c} and @file{.cc} files in the @file{sql} directory:
@itemize @bullet
@item
-convert.cc -- convert tables between different character sets
+convert.cc --- convert tables between different character sets
@item
-derror.cc -- read language-dependent message file
+derror.cc --- read language-dependent message file
@item
-des_key_file.cc -- load DES keys from plaintext file
+des_key_file.cc --- load DES keys from plaintext file
@item
-field.cc -- "implement classes defined in @file{field.h}" (long); defines all storage methods MySQL uses to store field information
+field.cc --- "implement classes defined in @file{field.h}" (long); defines all storage methods MySQL uses to store field information
into records that are then passed to handlers
@item
-field_conv.cc -- functions to copy data between fields
+field_conv.cc --- functions to copy data between fields
@item
-filesort.cc -- sort a result set, using memory or temporary files
+filesort.cc --- sort a result set, using memory or temporary files
@item
-frm_crypt.cc -- contains only one short function: @file{get_crypt_for_frm}
+frm_crypt.cc --- contains only one short function: @file{get_crypt_for_frm}
@item
-gen_lex_hash.cc -- Knuth's algorithm from Vol 3 Sorting and Searching, Chapter 6.3; used to search for SQL keywords in a query
+gen_lex_hash.cc --- Knuth's algorithm from Vol 3 Sorting and Searching, Chapter 6.3; used to search for SQL keywords in a query
@item
-gstream.cc -- GTextReadStream, used to read GIS objects
+gstream.cc --- GTextReadStream, used to read GIS objects
@item
-handler.cc -- handler-calling functions
+handler.cc --- handler-calling functions
@item
-hash_filo.cc -- static-sized hash tables, used to store info like hostname -> ip tables in a FIFO manner
+hash_filo.cc --- static-sized hash tables, used to store info like hostname -> ip tables in a FIFO manner
@item
-ha_berkeley.cc -- Handler: BDB
+ha_berkeley.cc --- Handler: BDB
@item
-ha_heap.cc -- Handler: Heap
+ha_heap.cc --- Handler: Heap
@item
-ha_innodb.cc -- Handler: InnoDB
+ha_innodb.cc --- Handler: InnoDB
@item
-ha_isam.cc -- Handler: ISAM
+ha_isam.cc --- Handler: ISAM
@item
-ha_isammrg.cc -- Handler: (ISAM MERGE)
+ha_isammrg.cc --- Handler: (ISAM MERGE)
@item
-ha_myisam.cc -- Handler: MyISAM
+ha_myisam.cc --- Handler: MyISAM
@item
-ha_myisammrg.cc -- Handler: (MyISAM MERGE)
+ha_myisammrg.cc --- Handler: (MyISAM MERGE)
@item
-hostname.cc -- Given IP, return hostname
+hostname.cc --- Given IP, return hostname
@item
-init.cc -- Init and dummy functions for interface with unireg
+init.cc --- Init and dummy functions for interface with unireg
@item
-item.cc -- Item functions
+item.cc --- Item functions
@item
-item_buff.cc -- Buffers to save and compare item values
+item_buff.cc --- Buffers to save and compare item values
@item
-item_cmpfunc.cc -- Definition of all compare functions
+item_cmpfunc.cc --- Definition of all compare functions
@item
-item_create.cc -- Create an item. Used by @file{lex.h}.
+item_create.cc --- Create an item. Used by @file{lex.h}.
@item
-item_func.cc -- Numerical functions
+item_func.cc --- Numerical functions
@item
-item_row.cc -- Row items for comparing rows and for @code{IN} on rows
+item_row.cc --- Row items for comparing rows and for @code{IN} on rows
@item
-item_sum.cc -- Set functions (@code{SUM()}, @code{AVG()}, etc.)
+item_sum.cc --- Set functions (@code{SUM()}, @code{AVG()}, etc.)
@item
-item_strfunc.cc -- String functions
+item_strfunc.cc --- String functions
@item
-item_subselect.cc -- Item subquery
+item_subselect.cc --- Item subquery
@item
-item_timefunc.cc -- Date/time functions, e.g. week of year
+item_timefunc.cc --- Date/time functions, e.g. week of year
@item
-item_uniq.cc -- Empty file, here for compatibility reasons
+item_uniq.cc --- Empty file, here for compatibility reasons
@item
-key.cc -- Functions to create keys from records and compare a key to a key in a record
+key.cc --- Functions to create keys from records and compare a key to a key in a record
@item
-lock.cc -- Locks
+lock.cc --- Locks
@item
-log.cc -- Logs
+log.cc --- Logs
@item
-log_event.cc -- Log event (a binary log consists of a stream of log events)
+log_event.cc --- Log event (a binary log consists of a stream of log events)
@item
-matherr.c -- Handling overflow, underflow, etc.
+matherr.c --- Handling overflow, underflow, etc.
@item
-mf_iocache.cc -- Caching of (sequential) reads and writes
+mf_iocache.cc --- Caching of (sequential) reads and writes
@item
-mini_client.cc -- Client included in server for server-server messaging; used by the replication code
+mini_client.cc --- Client included in server for server-server messaging; used by the replication code
@item
-mysqld.cc -- Source for @code{mysqld.exe}; includes the @code{main()}
+mysqld.cc --- Source for @code{mysqld.exe}; includes the @code{main()}
program that starts @code{mysqld}, handling of signals and connections
@item
-my_lock.c -- Lock part of a file (like @file{/mysys/my_lock.c}, but with timeout handling for threads)
+my_lock.c --- Lock part of a file (like @file{/mysys/my_lock.c}, but with timeout handling for threads)
@item
-net_serv.cc -- Read/write of packets on a network socket
+net_serv.cc --- Read/write of packets on a network socket
@item
-nt_servc.cc -- Initialize/register/remove an NT service
+nt_servc.cc --- Initialize/register/remove an NT service
@item
-opt_ft.cc -- Create a FT or QUICK RANGE based on a key (very short)
+opt_ft.cc --- Create a FT or QUICK RANGE based on a key (very short)
@item
-opt_range.cc -- Range of keys
+opt_range.cc --- Range of keys
@item
-opt_sum.cc -- Optimize functions in presence of (implied) @code{GROUP BY}
+opt_sum.cc --- Optimize functions in presence of (implied) @code{GROUP BY}
@item
-password.c -- Password checking
+password.c --- Password checking
@item
-procedure.cc -- Procedure interface, as used in @code{SELECT * FROM
+procedure.cc --- Procedure interface, as used in @code{SELECT * FROM
Table_name PROCEDURE ANALYSE()}
@item
-protocol.cc -- Low level functions for PACKING data that is sent to client;
+protocol.cc --- Low level functions for PACKING data that is sent to client;
actual sending done with @file{net_serv.cc}
@item
-records.cc -- Functions for easy reading of records, possible through a cache
+records.cc --- Functions for easy reading of records, possible through a cache
@item
-repl_failsafe.cc -- Replication fail-save (not yet implemented)
+repl_failsafe.cc --- Replication fail-save (not yet implemented)
@item
-set_var.cc -- Set and retrieve MySQL user variables
+set_var.cc --- Set and retrieve MySQL user variables
@item
-slave.cc -- Procedures for a slave in a master/slave (replication) relation
+slave.cc --- Procedures for a slave in a master/slave (replication) relation
@item
-spatial.cc -- Geometry stuff (lines, points, etc.)
+spatial.cc --- Geometry stuff (lines, points, etc.)
@item
-sql_acl.cc -- Functions related to ACL security; checks, stores, retrieves, and deletes MySQL user level privileges
+sql_acl.cc --- Functions related to ACL security; checks, stores, retrieves, and deletes MySQL user level privileges
@item
-sql_analyse.cc -- Implements the @code{PROCEDURE ANALYSE()}, which analyzes a query result and returns the 'optimal' data type for each result column
+sql_analyse.cc --- Implements the @code{PROCEDURE ANALYSE()}, which analyzes a query result and returns the 'optimal' data type for each result column
@item
-sql_base.cc -- Basic functions needed by many modules, like opening and closing tables with table cache management
+sql_base.cc --- Basic functions needed by many modules, like opening and closing tables with table cache management
@item
-sql_cache.cc -- SQL query cache, with long comments about how caching works
+sql_cache.cc --- SQL query cache, with long comments about how caching works
@item
-sql_class.cc -- SQL class; implements the SQL base classes, of which THD (THREAD object) is the most important
+sql_class.cc --- SQL class; implements the SQL base classes, of which THD (THREAD object) is the most important
@item
-sql_crypt.cc -- Encode / decode, very short
+sql_crypt.cc --- Encode / decode, very short
@item
-sql_db.cc -- Create / drop database
+sql_db.cc --- Create / drop database
@item
-sql_delete.cc -- The @code{DELETE} statement
+sql_delete.cc --- The @code{DELETE} statement
@item
-sql_derived.cc -- Derived tables, with long comments
+sql_derived.cc --- Derived tables, with long comments
@item
-sql_do.cc -- The @code{DO} statement
+sql_do.cc --- The @code{DO} statement
@item
-sql_error.cc -- Errors and warnings
+sql_error.cc --- Errors and warnings
@item
-sql_handler.cc -- Implements the @code{HANDLER} interface, which gives direct
+sql_handler.cc --- Implements the @code{HANDLER} interface, which gives direct
access to rows in @code{MyISAM} and @code{InnoDB}
@item
-sql_help.cc -- The @code{HELP} statement
+sql_help.cc --- The @code{HELP} statement
@item
-sql_insert.cc -- The @code{INSERT} statement
+sql_insert.cc --- The @code{INSERT} statement
@item
-sql_lex.cc -- Does lexical analysis of a query; i.e. breaks a query string into pieces and determines the basic type (number,
+sql_lex.cc --- Does lexical analysis of a query; i.e. breaks a query string into pieces and determines the basic type (number,
string, keyword, etc.) of each piece
@item
-sql_list.cc -- Only list_node_end_of_list, short (the rest of the list class
+sql_list.cc --- Only list_node_end_of_list, short (the rest of the list class
is implemented in @file{sql_list.h})
@item
-sql_load.cc -- The @code{LOAD DATA} statement
+sql_load.cc --- The @code{LOAD DATA} statement
@item
-sql_map.cc -- Memory-mapped files (not yet in use)
+sql_map.cc --- Memory-mapped files (not yet in use)
@item
-sql_manager.cc -- Maintenance tasks, e.g. flushing the buffers periodically;
+sql_manager.cc --- Maintenance tasks, e.g. flushing the buffers periodically;
used with @code{BDB} table logs
@item
-sql_olap.cc -- @code{ROLLUP}
+sql_olap.cc --- @code{ROLLUP}
@item
-sql_parse.cc -- Parse an SQL statement; do initial checks and then jump to the function that should execute the statement
+sql_parse.cc --- Parse an SQL statement; do initial checks and then jump to the function that should execute the statement
@item
-sql_prepare.cc -- Prepare an SQL statement, or use a prepared statement
+sql_prepare.cc --- Prepare an SQL statement, or use a prepared statement
@item
-sql_repl.cc -- Replication
+sql_repl.cc --- Replication
@item
-sql_rename.cc -- Rename table
+sql_rename.cc --- Rename table
@item
-sql_select.cc -- Select and join optimization
+sql_select.cc --- Select and join optimization
@item
-sql_show.cc -- The @code{SHOW} statement
+sql_show.cc --- The @code{SHOW} statement
@item
-sql_string.cc -- String functions: alloc, realloc, copy, convert, etc.
+sql_string.cc --- String functions: alloc, realloc, copy, convert, etc.
@item
-sql_table.cc -- The @code{DROP TABLE} and @code{ALTER TABLE} statements
+sql_table.cc --- The @code{DROP TABLE} and @code{ALTER TABLE} statements
@item
-sql_test.cc -- Some debugging information
+sql_test.cc --- Some debugging information
@item
-sql_udf.cc -- User-defined functions
+sql_udf.cc --- User-defined functions
@item
-sql_union.cc -- The @code{UNION} operator
+sql_union.cc --- The @code{UNION} operator
@item
-sql_update.cc -- The @code{UPDATE} statement
+sql_update.cc --- The @code{UPDATE} statement
@item
-stacktrace.c -- Display stack trace (Linux/Intel only)
+stacktrace.c --- Display stack trace (Linux/Intel only)
@item
-table.cc -- Table metadata retrieval; read the table definition from a
+table.cc --- Table metadata retrieval; read the table definition from a
@file{.frm} file and store it in a TABLE object
@item
-thr_malloc.cc -- Thread-safe interface to @file{/mysys/my_alloc.c}
+thr_malloc.cc --- Thread-safe interface to @file{/mysys/my_alloc.c}
@item
-time.cc -- Date and time functions
+time.cc --- Date and time functions
@item
-udf_example.cc -- Example file of user-defined functions
+udf_example.cc --- Example file of user-defined functions
@item
-uniques.cc -- Function to handle quick removal of duplicates
+uniques.cc --- Function to handle quick removal of duplicates
@item
-unireg.cc -- Create a unireg form file (.frm) from a @code{FIELD} and field-info struct
+unireg.cc --- Create a unireg form file (.frm) from a @code{FIELD} and field-info struct
@end itemize
@node sql-bench directory, SSL directory, sql directory, Source directory listing
@@ -11106,15 +11106,15 @@
There are five subdirectories and sub-subdirectories:
@itemize @bullet
@item
-\Comments -- Comments about results from tests of Access, Adabas, etc.
+\Comments --- Comments about results from tests of Access, Adabas, etc.
@item
-\Data\ATIS -- @file{.txt} files containing input data for the "ATIS" tests
+\Data\ATIS --- @file{.txt} files containing input data for the "ATIS" tests
@item
-\Data\Wisconsin -- @file{.txt} files containing input data for the "Wisconsin" tests
+\Data\Wisconsin --- @file{.txt} files containing input data for the "Wisconsin" tests
@item
-\Results -- old test results
+\Results --- old test results
@item
-\Results-win32 -- old test results from Windows 32-bit tests
+\Results-win32 --- old test results from Windows 32-bit tests
@end itemize
There are twenty-four @file{*.sh} (shell script) files, which involve Perl
@@ -11153,109 +11153,109 @@
The .C files are:
@itemize @bullet
@item
-atof.c -- ascii-to-float, MySQL version
+atof.c --- ascii-to-float, MySQL version
@item
-bchange.c -- short replacement routine written by Monty Widenius in
+bchange.c --- short replacement routine written by Monty Widenius in
1987
@item
-bcmp.c -- binary compare, rarely used
+bcmp.c --- binary compare, rarely used
@item
-bcopy-duff.c -- block copy: attempt to copy memory blocks faster
+bcopy-duff.c --- block copy: attempt to copy memory blocks faster
than cmemcpy
@item
-bfill.c -- byte fill, to fill a buffer with (length) copies of a
+bfill.c --- byte fill, to fill a buffer with (length) copies of a
byte
@item
-bmove.c -- block move
+bmove.c --- block move
@item
-bmove512.c -- "should be the fastest way to move a multiple of 512
+bmove512.c --- "should be the fastest way to move a multiple of 512
bytes"
@item
-bmove_upp.c -- bmove.c variant, starting with last byte
+bmove_upp.c --- bmove.c variant, starting with last byte
@item
-bzero.c -- something like bfill with an argument of 0
+bzero.c --- something like bfill with an argument of 0
@item
-conf_to_src.c -- reading a configuration file
+conf_to_src.c --- reading a configuration file
@item
-ctype*.c -- string handling programs for each char type MySQL
+ctype*.c --- string handling programs for each char type MySQL
handles
@item
-do_ctype.c -- display case-conversion and sort-conversion tables
+do_ctype.c --- display case-conversion and sort-conversion tables
@item
-int2str.c -- integer-to-string
+int2str.c --- integer-to-string
@item
-is_prefix.c -- checks whether string1 starts with string2
+is_prefix.c --- checks whether string1 starts with string2
@item
-llstr.c -- convert long long to temporary-buffer string, return
+llstr.c --- convert long long to temporary-buffer string, return
pointer
@item
-longlong2str.c -- ditto, but to argument-buffer
+longlong2str.c --- ditto, but to argument-buffer
@item
-memcmp.c -- memory compare
+memcmp.c --- memory compare
@item
-memset.c -- memory set
+memset.c --- memory set
@item
-my_vsnprintf.c -- variant of printf
+my_vsnprintf.c --- variant of printf
@item
-r_strinstr.c -- see if one string is within another
+r_strinstr.c --- see if one string is within another
@item
-str2int.c -- convert string to integer
+str2int.c --- convert string to integer
@item
-strappend.c -- fill up a string to n characters
+strappend.c --- fill up a string to n characters
@item
-strcat.c -- concatenate strings
+strcat.c --- concatenate strings
@item
-strcend.c -- point to where a character C occurs within str, or NULL
+strcend.c --- point to where a character C occurs within str, or NULL
@item
-strchr.c -- point to first place in string where character occurs
+strchr.c --- point to first place in string where character occurs
@item
-strcmp.c -- compare two strings
+strcmp.c --- compare two strings
@item
-strcont.c -- point to where any one of a set of characters appears
+strcont.c --- point to where any one of a set of characters appears
@item
-strend.c -- point to the '\0' byte which terminates str
+strend.c --- point to the '\0' byte which terminates str
@item
-strfill.c -- fill a string with n copies of a byte
+strfill.c --- fill a string with n copies of a byte
@item
-strinstr.c -- find string within string
+strinstr.c --- find string within string
@item
-strlen.c -- return length of string in bytes
+strlen.c --- return length of string in bytes
@item
-strmake.c -- create new string from old string with fixed length, append end \0 if needed
+strmake.c --- create new string from old string with fixed length, append end \0 if needed
@item
-strmov.c -- move source to dest and return pointer to end
+strmov.c --- move source to dest and return pointer to end
@item
-strnlen.c -- return min(length of string, n)
+strnlen.c --- return min(length of string, n)
@item
-strnmov.c -- move source to dest for source size, or for n bytes
+strnmov.c --- move source to dest for source size, or for n bytes
@item
-strrchr.c -- find a character within string, searching from end
+strrchr.c --- find a character within string, searching from end
@item
-strstr.c -- find an instance of pattern within source
+strstr.c --- find an instance of pattern within source
@item
-strto.c -- string to long, to long long, to unsigned long, etc.
+strto.c --- string to long, to long long, to unsigned long, etc.
@item
-strtol.c -- string to long
+strtol.c --- string to long
@item
-strtoll.c -- string to long long
+strtoll.c --- string to long long
@item
-strtoul.c -- string to unsigned long
+strtoul.c --- string to unsigned long
@item
-strtoull.c -- string to unsigned long long
+strtoull.c --- string to unsigned long long
@item
-strxmov.c -- move a series of concatenated source strings to dest
+strxmov.c --- move a series of concatenated source strings to dest
@item
-strxnmov.c -- like strxmov.c but with a maximum length n
+strxnmov.c --- like strxmov.c but with a maximum length n
@item
-str_test.c -- test of all the string functions encoded in assembler
+str_test.c --- test of all the string functions encoded in assembler
@item
-udiv.c -- unsigned long divide, for operating systems that don't support these
+udiv.c --- unsigned long divide, for operating systems that don't support these
@item
-xml.c -- read and parse XML strings; used to read character definition information stored in /sql/share/charsets
+xml.c --- read and parse XML strings; used to read character definition information stored in /sql/share/charsets
@end itemize
-There are also four .ASM files -- macros.asm, ptr_cmp.asm,
-strings.asm, and strxmov.asm -- which can replace some of the
+There are also four .ASM files --- macros.asm, ptr_cmp.asm,
+strings.asm, and strxmov.asm --- which can replace some of the
C-program functions. But again, they look like optimizations for old
members of the Intel processor family.
@@ -11281,30 +11281,30 @@
Some examples are:
@itemize @bullet
@item
-connect_test.c -- test that a connect is possible
+connect_test.c --- test that a connect is possible
@item
-insert_test.c -- test that an insert is possible
+insert_test.c --- test that an insert is possible
@item
-list_test.c -- test that a select is possible
+list_test.c --- test that a select is possible
@item
-select_test.c -- test that a select is possible
+select_test.c --- test that a select is possible
@item
-showdb_test.c -- test that a show-databases is possible
+showdb_test.c --- test that a show-databases is possible
@item
-ssl_test.c -- test that SSL is possible
+ssl_test.c --- test that SSL is possible
@item
-thread_test.c -- test that threading is possible
+thread_test.c --- test that threading is possible
@end itemize
@node tools directory, VC++Files directory, tests directory, Source directory listing
@subsection The @file{tools} Directory
-Tools -- well, actually, one tool.
+Tools --- well, actually, one tool.
The only file is:
@itemize @bullet
@item
-mysqlmanager.c -- A "server management daemon" by Sasha Pachev. This
+mysqlmanager.c --- A "server management daemon" by Sasha Pachev. This
is a tool under development and is not yet useful. Related to fail-safe
replication.
@end itemize
@@ -11334,51 +11334,51 @@
duplicates:
@itemize @bullet
@item
-comp_err -- (nearly empty)
+comp_err --- (nearly empty)
@item
-contrib -- (nearly empty)
+contrib --- (nearly empty)
@item
-InstallShield -- script files
+InstallShield --- script files
@item
-isamchk -- (nearly empty)
+isamchk --- (nearly empty)
@item
-libmysqltest -- one small non-MySQL test program: mytest.c
+libmysqltest --- one small non-MySQL test program: mytest.c
@item
-myisamchk -- (nearly empty)
+myisamchk --- (nearly empty)
@item
-myisamlog -- (nearly empty)
+myisamlog --- (nearly empty)
@item
-myisammrg -- (nearly empty)
+myisammrg --- (nearly empty)
@item
-mysqlbinlog -- (nearly empty)
+mysqlbinlog --- (nearly empty)
@item
-mysqlmanager -- MFC foundation class files created by AppWizard
+mysqlmanager --- MFC foundation class files created by AppWizard
@item
-mysqlserver -- (nearly empty)
+mysqlserver --- (nearly empty)
@item
-mysqlshutdown -- one short program, mysqlshutdown.c
+mysqlshutdown --- one short program, mysqlshutdown.c
@item
-mysqlwatch.c -- Windows service initialization and monitoring
+mysqlwatch.c --- Windows service initialization and monitoring
@item
-my_print_defaults -- (nearly empty)
+my_print_defaults --- (nearly empty)
@item
-pack_isam -- (nearly empty)
+pack_isam --- (nearly empty)
@item
-perror -- (nearly empty)
+perror --- (nearly empty)
@item
-prepare -- (nearly empty)
+prepare --- (nearly empty)
@item
-replace -- (nearly empty)
+replace --- (nearly empty)
@item
-SCCS -- source code control system
+SCCS --- source code control system
@item
-test1 -- tests connecting via X threads
+test1 --- tests connecting via X threads
@item
-thr_insert_test -- (nearly empty)
+thr_insert_test --- (nearly empty)
@item
-thr_test -- one short program used to test for memory-allocation bug
+thr_test --- one short program used to test for memory-allocation bug
@item
-winmysqladmin -- the winmysqladmin.exe source
+winmysqladmin --- the winmysqladmin.exe source
@end itemize
The "nearly empty" subdirectories noted above (e.g. comp_err and isamchk)
@@ -11403,28 +11403,28 @@
The C programs are:
@itemize @bullet
@item
-test-ssl.c -- Short standalone test program: SSL
+test-ssl.c --- Short standalone test program: SSL
@item
-test-sslclient.c -- Short standalone test program: clients
+test-sslclient.c --- Short standalone test program: clients
@item
-test-sslserver.c -- Short standalone test program: server
+test-sslserver.c --- Short standalone test program: server
@item
-vio.c -- Declarations + open/close functions
+vio.c --- Declarations + open/close functions
@item
-viosocket.c -- Send/retrieve functions
+viosocket.c --- Send/retrieve functions
@item
-viossl.c -- SSL variations for the above
+viossl.c --- SSL variations for the above
@item
-viosslfactories.c -- Certification / Verification
+viosslfactories.c --- Certification / Verification
@item
-viotest.cc -- Short standalone test program: general
+viotest.cc --- Short standalone test program: general
@item
-viotest-ssl.c -- Short standalone test program: SSL
+viotest-ssl.c --- Short standalone test program: SSL
@item
-viotest-sslconnect.cc -- Short standalone test program: SSL connect
+viotest-sslconnect.cc --- Short standalone test program: SSL connect
@end itemize
-The older functions -- raw_net_read, raw_net_write -- are now
+The older functions --- raw_net_read, raw_net_write --- are now
obsolete.
@node zlib directory, , vio directory, Source directory listing
@@ -11436,7 +11436,7 @@
protocol and the COMPRESS/UNCOMPRESS functions under Windows.
On Unix, MySQL uses the system libgz.a library for this purpose.
-Zlib -- which presumably stands for "Zip Library" -- is not a MySQL
+Zlib --- which presumably stands for "Zip Library" --- is not a MySQL
package. It was produced by the GNU Zip (gzip.org) people. Zlib is a
variation of the famous "Lempel-Ziv" method, which is also used by
"Zip". The method for reducing the size of any arbitrary string of
@@ -11569,8 +11569,8 @@
hash0hash.c Hashing / Hashing 3,257 Simple hash table utility
@end example
-The two C programs in the \ha and \hashing directories -- ha0ha.c and
-hash0hash.c -- both refer to a "hash table" but hash0hash.c is
+The two C programs in the \ha and \hashing directories --- ha0ha.c and
+hash0hash.c --- both refer to a "hash table" but hash0hash.c is
specialized, it is mostly about accessing points in the table under
mutex control.
@@ -11616,7 +11616,7 @@
conversion and comparison. The single function in ut0rnd.c is for
finding a prime slightly greater than the given argument, which is
useful for hash functions, but unrelated to randomness. The functions
-in ut0mem.c are wrappers for "malloc" and "free" calls -- for the
+in ut0mem.c are wrappers for "malloc" and "free" calls --- for the
real "memory" module see section \mem (MEMORY). Finally, the
functions in ut0ut.c are a miscellany that didn't fit better elsewhere:
get_high_bytes, clock, time, difftime, get_year_month_day, and "sprintf"
@@ -11707,7 +11707,7 @@
slightly lower level, and are called from the routines in com0com.c.
I was interested in seeing how InnoDB would handle inter-process
-communication, since there are many options -- named pipes, TCP/IP,
+communication, since there are many options --- named pipes, TCP/IP,
Windows messaging, and Shared Memory being the main ones that come to
mind. It appears that InnoDB prefers Shared Memory. The main idea is:
there is an area of memory which two different processes (or threads,
@@ -11867,7 +11867,7 @@
Speaking of MySQL, notice that one of the larger programs in the \row
program group is the "interface between Innobase row operations and
-MySQL" (row0mysql.c) -- information interchange happens at this level
+MySQL" (row0mysql.c) --- information interchange happens at this level
because rows in InnoDB and in MySQL are analogous, something which
can't be said for pages and other levels.
@@ -11919,20 +11919,20 @@
and that's close to true but can mislead you.
@itemize @bullet
@item
-First: @code{InnoDB} uses rollback segments like Oracle8i does -- but
+First: @code{InnoDB} uses rollback segments like Oracle8i does --- but
Oracle9i uses a different name
@item
-Second: @code{InnoDB} uses multi-versioning like Oracle does -- but I see
+Second: @code{InnoDB} uses multi-versioning like Oracle does --- but I see
nothing that looks like an Oracle ITL being stored in the @code{InnoDB} data
pages.
@item
Third: @code{InnoDB} and Oracle both have short (back-to-statement-start)
versioning for the @code{READ COMMITTED} isolation level and long
-(back-to-transaction-start) versioning for higher levels -- but @code{InnoDB}
+(back-to-transaction-start) versioning for higher levels --- but @code{InnoDB}
and Oracle have different "default" isolation levels.
@item
Finally: @code{InnoDB}'s documentation says it has to lock "the gaps before
-index keys" to prevent phantoms -- but any Oracle user will tell you that
+index keys" to prevent phantoms --- but any Oracle user will tell you that
phantoms are impossible anyway at the @code{SERIALIZABLE} isolation level, so
key-locks are unnecessary.
@end itemize
@@ -11974,7 +11974,7 @@
@end example
The data dictionary (known in some circles as the catalog) has the
-metadata information about objects in the database -- column sizes,
+metadata information about objects in the database --- column sizes,
table names, and the like.
@strong{\eval (EVALUATING)}
@@ -11986,7 +11986,7 @@
@end example
The evaluating step is a late part of the process of interpreting an
-SQL statement -- parsing has already occurred during \pars (PARSING).
+SQL statement --- parsing has already occurred during \pars (PARSING).
The ability to execute SQL stored procedures is an InnoDB feature, but
not a MySQL feature, so the eval0proc.c program is unimportant.
@@ -12083,7 +12083,7 @@
in-memory parse tree. The EVALUATING (subdirectory \eval) programs
will use the tree.
-As is common practice, the Bison and Flex tools were used -- @file{pars0grm.c}
+As is common practice, the Bison and Flex tools were used --- @file{pars0grm.c}
is what the Bison parser produced from an original file named
@file{pars0grm.y}
(not supplied), and @file{lexyy.c} is what Flex produced.
@@ -12116,7 +12116,7 @@
can hold at a time. Any modern operating system API has some functions
for mutexes; however, as the comments in the sync0sync.c code indicate, it
can be faster to write one's own low-level mechanism. In fact the old
-assembly-language XCHG trick is in here -- this is the only program
+assembly-language XCHG trick is in here --- this is the only program
that contains any assembly code.
This is the end of the section-by-section account of @code{InnoDB}
| Thread |
|---|
| • bk commit - mysqldoc tree (paul:1.2646) | paul | 7 Mar |
