Imported freely distributable documentation from upstream MySQL 5.1.34 source tarball.

1 files changed, 61 insertions, 0 deletions

diff --git a/man/msql2mysql.1 b/man/msql2mysql.1
new file mode 100644
index 00000000000..cead24cf8d2
--- /dev/null
+++ b/man/msql2mysql.1
@@ -0,0 +1,61 @@
+.\"     Title: \fBmsql2mysql\fR
+.\"    Author: 
+.\" Generator: DocBook XSL Stylesheets v1.70.1 <http://docbook.sf.net/>
+.\"      Date: 03/31/2009
+.\"    Manual: MySQL Database System
+.\"    Source: MySQL 5.1
+.\"
+.TH "\fBMSQL2MYSQL\fR" "1" "03/31/2009" "MySQL 5.1" "MySQL Database System"
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+msql2mysql \- convert mSQL programs for use with MySQL
+.SH "SYNOPSIS"
+.HP 28
+\fBmsql2mysql\fR\fB\fIC\-source\-file\fR\fR\fB ...\fR
+.SH "DESCRIPTION"
+.PP
+Initially, the MySQL C API was developed to be very similar to that for the mSQL database system. Because of this, mSQL programs often can be converted relatively easily for use with MySQL by changing the names of the C API functions.
+.PP
+The
+\fBmsql2mysql\fR
+utility performs the conversion of mSQL C API function calls to their MySQL equivalents.
+\fBmsql2mysql\fR
+converts the input file in place, so make a copy of the original before converting it. For example, use
+\fBmsql2mysql\fR
+like this:
+.sp
+.RS 3n
+.nf
+shell> \fBcp client\-prog.c client\-prog.c.orig\fR
+shell> \fBmsql2mysql client\-prog.c\fR
+client\-prog.c converted
+.fi
+.RE
+.PP
+Then examine
+\fIclient\-prog.c\fR
+and make any post\-conversion revisions that may be necessary.
+.PP
+\fBmsql2mysql\fR
+uses the
+\fBreplace\fR
+utility to make the function name substitutions. See
+\fBreplace\fR(1).
+.SH "COPYRIGHT"
+.PP
+Copyright 2007\-2008 MySQL AB, 2009 Sun Microsystems, Inc.
+.PP
+This documentation is free software; you can redistribute it and/or modify it only under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 of the License.
+.PP
+This documentation is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+.PP
+You should have received a copy of the GNU General Public License along with the program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA or see http://www.gnu.org/licenses/.
+.SH "SEE ALSO"
+For more information, please refer to the MySQL Reference Manual,
+which may already be installed locally and which is also available
+online at http://dev.mysql.com/doc/.
+.SH AUTHOR
+MySQL AB (http://www.mysql.com/).