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.3075 05/07/19 15:42:52 paul@stripped +6 -0
Docoument mysql_get_character_set_info().
refman/titles.ent
1.31 05/07/19 15:42:48 paul@stripped +1 -0
Docoument mysql_get_character_set_info().
refman/news.xml
1.83 05/07/19 15:42:47 paul@stripped +8 -0
Docoument mysql_get_character_set_info().
refman/mysql-apis.xml
1.13 05/07/19 15:42:47 paul@stripped +56 -0
Docoument mysql_get_character_set_info().
refman-5.0/titles.ent
1.28 05/07/19 15:42:47 paul@stripped +1 -0
Sync.
refman-5.0/news.xml
1.69 05/07/19 15:42:46 paul@stripped +8 -0
Sync.
refman-5.0/mysql-apis.xml
1.13 05/07/19 15:42:45 paul@stripped +56 -0
Sync.
# 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.12/refman-5.0/mysql-apis.xml 2005-07-19 15:22:00 -05:00
+++ 1.13/refman-5.0/mysql-apis.xml 2005-07-19 15:42:45 -05:00
@@ -3225,6 +3225,62 @@
</section>
+ <section id="mysql-get-character-set-info">
+
+ <title id='title-mysql-get-character-set-info'>&title-mysql-get-character-set-info;</title>
+
+ <indexterm type="function">
+ <primary><literal>mysql_get_character_set_info()</literal></primary>
+ </indexterm>
+
+ <para>
+ <literal>void mysql_get_character_set_info(MYSQL *mysql,
+ MY_CHARSET_INFO *cs)</literal>
+ </para>
+
+ <para>
+ <emphasis role="bold">Description</emphasis>
+ </para>
+
+ <para>
+ This function provides information about the default client
+ character set. The default character set may be changed with
+ the <literal>mysql_set_character_set()</literal> function.
+ </para>
+
+ <para>
+ This function was added in MySQL 5.0.10.
+ </para>
+
+ <para>
+ <emphasis role="bold">Return Values</emphasis>
+ </para>
+
+ <para>
+ Zero for success. Non-zero if an error occurred.
+ </para>
+
+ <para>
+ <emphasis role="bold">Example</emphasis>
+ </para>
+
+<programlisting>
+if (!mysql_set_character_set_name(&mysql, "utf8"))
+{
+ MY_CHARSET_INFO cs;
+ mysql_get_character_set_info(&mysql, &cs);
+ printf("character set information:\n");
+ printf("character set name: %s\n", cs->name);
+ printf("collation name: %s\n", cs->csname);
+ printf("comment: %s\n", cs->comment);
+ printf("directory: %s\n", cs->dir);
+ printf("multi byte character min. length: %s\n", cs->mbminlen);
+ printf("multi byte character max. length: %s\n", cs->mbmaxlen);
+}
+</programlisting>
+
+ </section>
+
<section id="mysql-get-client-info">
<title id='title-mysql-get-client-info'>&title-mysql-get-client-info;</title>
--- 1.68/refman-5.0/news.xml 2005-07-19 15:22:01 -05:00
+++ 1.69/refman-5.0/news.xml 2005-07-19 15:42:46 -05:00
@@ -253,6 +253,14 @@
<listitem>
<para>
+ Added <literal>mysql_get_character_set_info()</literal> C
+ API function for obtaining information about the default
+ character set of the current connection.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
The bundled version of the <literal>readline</literal>
library was upgraded to version 5.0.
</para>
--- 1.27/refman-5.0/titles.ent 2005-07-19 15:22:02 -05:00
+++ 1.28/refman-5.0/titles.ent 2005-07-19 15:42:47 -05:00
@@ -1482,6 +1482,7 @@
<!ENTITY title-mysql-stmt-sqlstate "<literal>mysql_stmt_sqlstate()</literal>"><!-- "<literal>mysql_stmt_sqlstate()</literal>" -->
<!ENTITY title-not-enough-file-handles "File Not Found"><!-- "File Not Found" -->
<!ENTITY title-mysql-set-character-set "<literal>mysql_set_character_set()</literal>">
+<!ENTITY title-mysql-get-character-set-info "<literal>mysql_get_character_set_info()</literal>">
<!ENTITY title-mysql-set-server-option "<literal>mysql_set_server_option()</literal>"><!-- "<literal>mysql_set_server_option()</literal>" -->
<!ENTITY title-mysql-config-wizard-connections "The Concurrent Connections Dialog"><!-- "The Concurrent Connections Dialog" -->
<!ENTITY title-mysql-cluster-basics "Basic MySQL Cluster Concepts"><!-- "Basic MySQL Cluster Concepts" -->
--- 1.12/refman/mysql-apis.xml 2005-07-19 15:22:02 -05:00
+++ 1.13/refman/mysql-apis.xml 2005-07-19 15:42:47 -05:00
@@ -3225,6 +3225,62 @@
</section>
+ <section id="mysql-get-character-set-info">
+
+ <title id='title-mysql-get-character-set-info'>&title-mysql-get-character-set-info;</title>
+
+ <indexterm type="function">
+ <primary><literal>mysql_get_character_set_info()</literal></primary>
+ </indexterm>
+
+ <para>
+ <literal>void mysql_get_character_set_info(MYSQL *mysql,
+ MY_CHARSET_INFO *cs)</literal>
+ </para>
+
+ <para>
+ <emphasis role="bold">Description</emphasis>
+ </para>
+
+ <para>
+ This function provides information about the default client
+ character set. The default character set may be changed with
+ the <literal>mysql_set_character_set()</literal> function.
+ </para>
+
+ <para>
+ This function was added in MySQL 5.0.10.
+ </para>
+
+ <para>
+ <emphasis role="bold">Return Values</emphasis>
+ </para>
+
+ <para>
+ Zero for success. Non-zero if an error occurred.
+ </para>
+
+ <para>
+ <emphasis role="bold">Example</emphasis>
+ </para>
+
+<programlisting>
+if (!mysql_set_character_set_name(&mysql, "utf8"))
+{
+ MY_CHARSET_INFO cs;
+ mysql_get_character_set_info(&mysql, &cs);
+ printf("character set information:\n");
+ printf("character set name: %s\n", cs->name);
+ printf("collation name: %s\n", cs->csname);
+ printf("comment: %s\n", cs->comment);
+ printf("directory: %s\n", cs->dir);
+ printf("multi byte character min. length: %s\n", cs->mbminlen);
+ printf("multi byte character max. length: %s\n", cs->mbmaxlen);
+}
+</programlisting>
+
+ </section>
+
<section id="mysql-get-client-info">
<title id='title-mysql-get-client-info'>&title-mysql-get-client-info;</title>
--- 1.82/refman/news.xml 2005-07-19 15:22:03 -05:00
+++ 1.83/refman/news.xml 2005-07-19 15:42:47 -05:00
@@ -246,6 +246,14 @@
<listitem>
<para>
+ Added <literal>mysql_get_character_set_info()</literal> C
+ API function for obtaining information about the default
+ character set of the current connection.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
The bundled version of the <literal>readline</literal>
library was upgraded to version 5.0.
</para>
--- 1.30/refman/titles.ent 2005-07-19 15:22:03 -05:00
+++ 1.31/refman/titles.ent 2005-07-19 15:42:48 -05:00
@@ -1481,6 +1481,7 @@
<!ENTITY title-mysql-stmt-sqlstate "<literal>mysql_stmt_sqlstate()</literal>"><!-- "<literal>mysql_stmt_sqlstate()</literal>" -->
<!ENTITY title-not-enough-file-handles "File Not Found"><!-- "File Not Found" -->
<!ENTITY title-mysql-set-character-set "<literal>mysql_set_character_set()</literal>">
+<!ENTITY title-mysql-get-character-set-info "<literal>mysql_get_character_set_info()</literal>">
<!ENTITY title-mysql-set-server-option "<literal>mysql_set_server_option()</literal>"><!-- "<literal>mysql_set_server_option()</literal>" -->
<!ENTITY title-mysql-config-wizard-connections "The Concurrent Connections Dialog"><!-- "The Concurrent Connections Dialog" -->
<!ENTITY title-mysql-cluster-basics "Basic MySQL Cluster Concepts"><!-- "Basic MySQL Cluster Concepts" -->
| Thread |
|---|
| • bk commit - mysqldoc@docsrva tree (paul:1.3075) | paul | 19 Jul |