From b8c30464d009ec4898935269e87f09d6673dae5f Mon Sep 17 00:00:00 2001
From: Kristina Chodorow <kristina@php.net>
Date: Wed, 12 May 2010 22:32:56 +0000
Subject: [PATCH] deprecate stuff

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@299313 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/mongo/mongo/dropdb.xml           | 10 +++++++++-
 reference/mongo/mongo/selectcollection.xml |  2 +-
 reference/mongo/mongo/selectdb.xml         |  4 ++--
 reference/mongo/mongodb/dropcollection.xml | 11 ++++++++++-
 4 files changed, 22 insertions(+), 5 deletions(-)

diff --git a/reference/mongo/mongo/dropdb.xml b/reference/mongo/mongo/dropdb.xml
index 07d50011a0..e34dc72cd6 100644
--- a/reference/mongo/mongo/dropdb.xml
+++ b/reference/mongo/mongo/dropdb.xml
@@ -4,7 +4,7 @@
 <refentry xml:id="mongo.dropdb" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>Mongo::dropDB</refname>
-  <refpurpose>Drops a database</refpurpose>
+  <refpurpose>Drops a database [deprecated]</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -13,6 +13,14 @@
    <modifier>public</modifier> <type>array</type><methodname>Mongo::dropDB</methodname>
    <methodparam><type>mixed</type><parameter>db</parameter></methodparam>
   </methodsynopsis>
+
+  <warning>
+   <title>Deprecated</title>
+   <para>
+    Use <function>MongoDB::drop</function> instead.
+   </para>
+  </warning>
+
  </refsect1>
 
  <refsect1 role="parameters">
diff --git a/reference/mongo/mongo/selectcollection.xml b/reference/mongo/mongo/selectcollection.xml
index 20fbfb4735..ca30dd96f3 100644
--- a/reference/mongo/mongo/selectcollection.xml
+++ b/reference/mongo/mongo/selectcollection.xml
@@ -11,7 +11,7 @@
   &reftitle.description;
   <methodsynopsis>
    <modifier>public</modifier> <type>MongoCollection</type><methodname>Mongo::selectCollection</methodname>
-   <methodparam><type>string|MongoDB</type><parameter>db</parameter></methodparam>
+   <methodparam><type>string</type><parameter>db</parameter></methodparam>
    <methodparam><type>string</type><parameter>collection</parameter></methodparam>
   </methodsynopsis>
  </refsect1>
diff --git a/reference/mongo/mongo/selectdb.xml b/reference/mongo/mongo/selectdb.xml
index 0da4620b3a..2bd6f1b023 100644
--- a/reference/mongo/mongo/selectdb.xml
+++ b/reference/mongo/mongo/selectdb.xml
@@ -11,7 +11,7 @@
   &reftitle.description;
   <methodsynopsis>
    <modifier>public</modifier> <type>MongoDB</type><methodname>Mongo::selectDB</methodname>
-   <methodparam><type>string</type><parameter>dbname</parameter></methodparam>
+   <methodparam><type>string</type><parameter>name</parameter></methodparam>
   </methodsynopsis>
  </refsect1>
 
@@ -21,7 +21,7 @@
    <variablelist>
     <varlistentry>
      <term>
-      <parameter>dbname</parameter>
+      <parameter>name</parameter>
      </term>
      <listitem>
       <para>
diff --git a/reference/mongo/mongodb/dropcollection.xml b/reference/mongo/mongodb/dropcollection.xml
index 526e6b2fcc..236c4b72a3 100644
--- a/reference/mongo/mongodb/dropcollection.xml
+++ b/reference/mongo/mongodb/dropcollection.xml
@@ -4,7 +4,7 @@
 <refentry xml:id="mongodb.dropcollection" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>MongoDB::dropCollection</refname>
-  <refpurpose>Drops a collection</refpurpose>
+  <refpurpose>Drops a collection [deprecated]</refpurpose>
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;
@@ -12,6 +12,15 @@
    <modifier>public</modifier> <type>array</type><methodname>MongoDB::dropCollection</methodname>
    <methodparam><type>mixed</type><parameter>coll</parameter></methodparam>
   </methodsynopsis>
+
+  <warning>
+   <title>Deprecated</title>
+   <para>
+    Use <function>MongoCollection::drop</function> instead.  THIS FUNCTION LEAKS
+    MEMORY IN VERSION 1.0.7 AND EARLIER!
+   </para>
+  </warning>
+
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;