diff --git a/reference/mysql/functions/mysql-create-db.xml b/reference/mysql/functions/mysql-create-db.xml
index 0c32be9060..83a0fb5d8d 100644
--- a/reference/mysql/functions/mysql-create-db.xml
+++ b/reference/mysql/functions/mysql-create-db.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <!-- splitted from ./en/functions/mysql.xml, last change in rev 1.2 -->
   <refentry id="function.mysql-create-db">
    <refnamediv>
@@ -44,8 +44,16 @@
      For downwards compatibility <function>mysql_createdb</function>
      can also be used. This is deprecated, however.
     </para>
+    <note>
+     <para>
+      The function <function>mysql_create_db</function> is deprecated. It
+      is preferable to use <function>mysql_query</function> to issue a
+      SQL CREATE DATABASE Statement instead.
+     </para>
+    </note>
     <para>
-     See also: <function>mysql_drop_db</function>.
+     See also: <function>mysql_drop_db</function>,
+               <function>mysql_query</function>.
     </para>
    </refsect1>
   </refentry>