From 21c9bb49c0e1cdc18c497a7abe54bf2d540e81e4 Mon Sep 17 00:00:00 2001
From: Kyle Banker <kylebanker@gmail.com>
Date: Wed, 7 Apr 2010 18:41:08 -0400
Subject: [PATCH] 0.20 release notes

---
 0.20_UPGRADE | 16 ++++++++++++++++
 HISTORY      |  3 +++
 2 files changed, 19 insertions(+)
 create mode 100644 0.20_UPGRADE

diff --git a/0.20_UPGRADE b/0.20_UPGRADE
new file mode 100644
index 0000000..13e1984
--- /dev/null
+++ b/0.20_UPGRADE
@@ -0,0 +1,16 @@
+0.20 will require some minor code upgrades.
+
+1. Note the exception changes in HISTORY. Certain exceptions are now scoped under the BSON
+module; if you're catching these, you will need to modify your code.
+
+2. The BSON types are now scoped under the BSON module.
+
+3. Note that mongo_ext no longer exists. The new gems are bson and bson_ext.
+
+4. Indexes on GridFS chunks collections should be unique. If you have existing GridFS
+collections, you should drop the current index and replace with a unique one. Before you do this,
+make sure that index doesn't exist; no need to go through process unnecessarily.
+If you do need to create the index, once you have the chunks collection, here are the commands you can run:
+
+@chunks.drop_index('files_id_1_n_1')
+@chunks.create_index([['files_id', Mongo::ASCENDING], ['n', Mongo::ASCENDING]], :unique => true)
diff --git a/HISTORY b/HISTORY
index da666ed..cfe2a47 100644
--- a/HISTORY
+++ b/HISTORY
@@ -1,4 +1,7 @@
 0.20
+If upgrading from a previous version of the Ruby driver, please read these notes carefully,
+along with the 0.20_UPGRADE doc.
+
 * Support for new commands:
   * Collection#find_and_modify
   * Collection#stats