From 0bc62a921d59d4737111d8b6938cfa5eec78cad7 Mon Sep 17 00:00:00 2001
From: Philip Olson <philip@php.net>
Date: Fri, 7 Dec 2012 08:30:40 +0000
Subject: [PATCH] Moved generated changelog to a new changelog.xml, and added
 deprecated aliases as per PHP Bug #63295.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@328703 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/mysql/book.xml                      |  7 +-
 reference/mysql/changelog.xml                 | 79 +++++++++++++++++++
 reference/mysql/functions/mysql-db-name.xml   | 27 ++++++-
 reference/mysql/functions/mysql-tablename.xml | 25 ++++++
 4 files changed, 131 insertions(+), 7 deletions(-)
 create mode 100644 reference/mysql/changelog.xml

diff --git a/reference/mysql/book.xml b/reference/mysql/book.xml
index 7764c138e2..3468d53571 100644
--- a/reference/mysql/book.xml
+++ b/reference/mysql/book.xml
@@ -33,12 +33,7 @@
  &reference.mysql.constants;
  &reference.mysql.examples;
  &reference.mysql.reference;
-
-<appendix xmlns="http://docbook.org/ns/docbook" xml:id="changelog.mysql">
- <title>&ChangelogListingTitle;</title>
- <para>&ChangelogListingDescription;</para>
- <?phpdoc generate-changelog-for="ref.mysql"?>
-</appendix>
+ &reference.mysql.changelog;
 
 </book>
 
diff --git a/reference/mysql/changelog.xml b/reference/mysql/changelog.xml
new file mode 100644
index 0000000000..93c5d4047c
--- /dev/null
+++ b/reference/mysql/changelog.xml
@@ -0,0 +1,79 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+
+<appendix xmlns="http://docbook.org/ns/docbook" xml:id="changelog.mysql" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title>&ChangelogListingTitle;</title>
+ <para>&ChangelogListingDescription;</para>
+
+ <simplesect>
+  <title>General Changelog for the ext/mysql extension</title>
+  <para>
+   This changelog references the ext/mysql extension.
+  </para>
+ </simplesect>
+ 
+ <simplesect xml:id="changelog.mysql.functions">
+  <title>Changes to existing functions</title>
+  <para>
+   The following list is a compilation of changelog entries from
+   the ext/mysql functions.
+  </para>
+  <?phpdoc generate-changelog-for="ref.mysql book.mysql"?>
+ </simplesect>
+ 
+ <simplesect xml:id="changelog.mysql.global">
+  <title>Global ext/mysql changes</title>
+  <para>
+   The following is a list of changes to the entire ext/mysql extension.
+  </para>
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>5.5.0</entry>
+       <entry>
+        <para>
+         All of the old deprecated functions and aliases now emit E_DEPRECATED errors. These functions are:
+        </para>
+        <para>
+         mysql(), mysql_fieldname(), mysql_fieldtable(), mysql_fieldlen(), mysql_fieldtype(), mysql_fieldflags(), mysql_selectdb(),
+         mysql_createdb(), mysql_dropdb(), mysql_freeresult(), mysql_numfields(), mysql_numrows(), mysql_listdbs(), mysql_listtables(),
+         mysql_listfields(), mysql_db_name(), mysql_dbname(), mysql_tablename(), and mysql_table_name().
+         </para>
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </simplesect>
+</appendix>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
+
diff --git a/reference/mysql/functions/mysql-db-name.xml b/reference/mysql/functions/mysql-db-name.xml
index 0221642a55..7db8f302e5 100644
--- a/reference/mysql/functions/mysql-db-name.xml
+++ b/reference/mysql/functions/mysql-db-name.xml
@@ -69,7 +69,32 @@
    of the error.
   </para>
  </refsect1>
- 
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>5.5.0</entry>
+       <entry>
+        The <function>mysql_list_dbs</function> function is deprecated, 
+        and emits an <constant>E_DEPRECATED</constant> level error.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
diff --git a/reference/mysql/functions/mysql-tablename.xml b/reference/mysql/functions/mysql-tablename.xml
index 5b61a6ad81..9c0482e457 100644
--- a/reference/mysql/functions/mysql-tablename.xml
+++ b/reference/mysql/functions/mysql-tablename.xml
@@ -69,6 +69,31 @@
   </para>
  </refsect1>
 
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>5.5.0</entry>
+       <entry>
+        The <function>mysql_tablename</function> function is deprecated, 
+        and emits an <constant>E_DEPRECATED</constant> level error.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+ 
  <refsect1 role="examples">
   &reftitle.examples;
   <para>