couchbase 1.2.1 → 1.2.2

data/README.markdown

@@ -6,9 +6,6 @@ are related libraries available:
 * [couchbase-model][6] the ActiveModel implementation, git repository:
   [https://github.com/couchbase/couchbase-ruby-model][7]
 
-* [em-couchbase][8] EventMachine friendly implementation of couchbase
-  client, git repository: [https://github.com/couchbase/couchbase-ruby-client-em][9]
-
 ## SUPPORT
 
 If you found an issue, please file it in our [JIRA][1]. Also you are
@@ -520,6 +517,54 @@ Note that errors object in view results usually goes *after* the rows,
 so you will likely receive a number of view results successfully before
 the error is detected.
 
+## Engines
+
+As far as couchbase gem uses [libcouchbase][8] as the backend, you can
+choose from several asynchronous IO options:
+
+* `:default` this one is used by default and implemented as the part
+  of the ruby extensions (this mean you don't need any dependencies
+  apart from libcouchbase2-core and libcouchbase-dev to build and use
+  it). This engine honours ruby GVL, so when it comes to waiting for
+  IO operations from kernel it release the GVL allowing interpreter to
+  run your code. This technique isn't available on windows, but down't
+  worry `:default` engine still accessible and will pick up statically
+  linked on that platform `:libevent` engine.
+
+* `:libev` and `:libevent`, these two engines require installed
+  libcouchbase2-libev and libcouchbase2-libevent packages
+  correspondingly. Currently they aren't so friendly to GVL but still
+  useful.
+
+* `:eventmachine` engine. From version 1.2.2 it is possible to use
+  great [EventMachine][9] library as underlying IO backend and
+  integrate couchbase gem to your current asynchronous application.
+  This engine will be only accessible on the MRI ruby 1.9+. Checkout
+  simple example of usage:
+
+        require 'eventmachine'
+        require 'couchbase'
+
+        EM.epoll = true  if EM.epoll?
+        EM.kqueue = true  if EM.kqueue?
+        EM.run do
+          con = Couchbase.connect :engine => :eventmachine, :async => true
+          con.on_connect do |res|
+            puts "connected: #{res.inspect}"
+            if res.success?
+              con.set("emfoo", "bar") do |res|
+                puts "set: #{res.inspect}"
+                con.get("emfoo") do |res|
+                  puts "get: #{res.inspect}"
+                  EM.stop
+                end
+              end
+            else
+              EM.stop
+            end
+          end
+        end
+
 [1]: http://couchbase.com/issues/browse/RCBC
 [2]: http://freenode.net/irc_servers.shtml
 [3]: http://www.couchbase.com/develop/c/current
@@ -527,6 +572,6 @@ the error is detected.
 [5]: http://code.google.com/p/memcached/wiki/BinaryProtocolRevamped
 [6]: https://rubygems.org/gems/couchbase-model
 [7]: https://github.com/couchbase/couchbase-ruby-model
-[8]: https://rubygems.org/gems/em-couchbase
-[9]: https://github.com/couchbase/couchbase-ruby-client-em
+[8]: http://www.couchbase.com/develop/c/current
+[9]: http://rubygems.org/gems/eventmachine
 

data/RELEASE_NOTES.markdown

@@ -3,13 +3,74 @@
 This document is a list of user visible feature changes and important
 bugfixes. Do not forget to update this doc in every important patch.
 
+## 1.2.2 (2013-02-11)
+
+* [minor] Bucket#design_docs will return a Hash with DesignDoc
+  instances as a values.
+
+* [critical] RCBC-104 Data corruption on intensive store operations.
+  The issue could also lead to segfaults.
+
+* [major] RCBC-118 Alias #total_rows as #total_entries on view result
+  set to match documentation.
+
+* [minor] View#fetch_all - async method for fetching all records
+
+        conn.run do
+          doc.recent_posts.fetch_all do |posts|
+            do_something_with_all_posts(posts)
+          end
+        end
+
+* [major] Allow to use Bucket instance in completely asynchronous
+  environment like this, without blocking on connect:
+
+        conn = Couchbase.new(:async => true)
+        conn.run do
+          conn.on_connect do |res|
+            if res.success?
+              #
+              # schedule async requests
+              #
+            end
+          end
+        end
+
+* [major] RCBC-27 EventMachine plugin to integrate with EventMachine
+  library. Note that the plugin is experimental at this stage.
+  Example:
+
+        require 'eventmachine'
+        require 'couchbase'
+
+        EM.epoll = true  if EM.epoll?
+        EM.kqueue = true  if EM.kqueue?
+        EM.run do
+          con = Couchbase.connect(:engine => :eventmachine, :async => true)
+          con.on_connect do |res|
+            puts "connected: #{res.inspect}"
+            if res.success?
+              con.set("emfoo", "bar") do |res|
+                puts "set: #{res.inspect}"
+                con.get("emfoo") do |res|
+                  puts "get: #{res.inspect}"
+                  EM.stop
+                end
+              end
+            else
+              EM.stop
+            end
+          end
+        end
+
+
 ## 1.2.1 (2012-12-28)
 
-* [major] RCBC-101 Persistence constraints were not passed to mutation
-  methods, so they were not applied properly.
+* [major] RCBC-101 Persistence constraints wasn't passed to mutation
+  methods, so they haven't been applied properly.
 
 * [major] RCBC-102 Inconsistent return values in case of storage
-  functions with persistence constraints. It always returns a Hash
+  functions with persistence constraints. It always return a Hash like
   in case of multi-set, even if there is only one document is being
   set.
 
@@ -20,127 +81,145 @@ bugfixes. Do not forget to update this doc in every important patch.
 
  30 files changed, 2079 insertions(+), 662 deletions(-)
 
-* New specialized io plugin for releasing Ruby GVL (thanks to
+* Specialized io plugin for releasing Ruby GVL (thanks to
   Sokolov Yura aka funny_falcon).
 
-  * Ruby 1.9.x uses a global lock for ensuring integrity, and blocking
+  * Ruby 1.9.x uses global lock for ensuring integrity, and blocking
     calls should be called inside rb_thread_blocking_region to allow
-    other threads to be run.
+    other threads to be runned.
 
-  * Ruby 1.8.7 has only green threads, so rb_thread_schedule
+  * Ruby 1.8.7 have only green threads, so that rb_thread_schedule
     should be called manually.
 
-* RCBC-42 Catch exceptions from ruby callbacks.
+* RCBC-42 Catch exceptions from ruby callbacks
 
-* RCBC-99 read out the StringIO contents in json gem monkey patch.
+* RCBC-99 read out the StringIO contents in json gem monkey patch
 
-* Use marshal serializer by default for session store.
+* Use marshal serializer by default for session store
 
-* Remove debugger development dependency.
+* Remove debugger development dependency
 
-* Fix memory leaks and performance improvements.
+* Fix memory leaks and performance improvements
 
 ## 1.2.0.z.beta5 (2012-11-29)
 
  25 files changed, 1419 insertions(+), 1230 deletions(-)
 
-* RCBC-95 Use response body to clarify Couchbase::Error::HTTP.
+* RCBC-95 Use response body to clarify Couchbase::Error::HTTP
 
-* Fix memory leaks: in async mode context wasn't freed.
+* Fix memory leaks: in async mode context wasn't freed
 
-* Allow caller to setup default initial value for INCR/DECR on per
-  connection level.
+* Allow to setup default initial value for INCR/DECR on per connection
+  level.
 
-* Make error message about libcouchbase dependency more verbose.
+* Make error message about libcouchbase dependency more verbose
 
 ## 1.2.0.z.beta4 (2012-11-21)
 
  27 files changed, 311 insertions(+), 123 deletions(-)
 
-* Increase default connection timeout for Views up to 75 seconds.
+* Increase default connection timeout for Views up to 75 seconds
 
-* RCBC-94 Reset global exception after usage.
+* RCBC-94 Reset global exception after usage
 
 * RCBC-89 Do not expose docs embedded in HTTP response. Use binary
   protocol for it.
 
 * Remove all_docs mentions. It isn't recommended to use it because of
-  performance and support concerns.
+  performance issues
 
 * Protect against non string values in :plain mode. Will raise error
   if the value given isn't a string.
 
-* RCBC-90 Update documentation about session store.
+* RCBC-90 Update documentation about session store
 
-* Make rack session store adapter quiet.
+* Make rack session store adapter quiet
 
-* Update to recent libcouchbase API.
+* Update to recent libcouchbase API
 
-* Adjust version check for MultiJson monkeypatch (8098da1).
+* Adjust version check for MultiJson monkeypatch (8098da1)
 
-* Do not hide ValueFormat reason.
+* Do not hide ValueFormat reason. It is accessible using
+  Couchbase::Error::Value#inner_exception.
 
 ## 1.2.0.z.beta3 (2012-10-16)
 
  18 files changed, 241 insertions(+), 57 deletions(-)
 
-* RCBC-52 Implement bucket create/delete operations.
+* RCBC-52 Implement bucket create/delete operations. Examples:
 
-* Propogate status code for HTTP responses.
+        conn = Couchbase::Cluster.new(:hostname => "localhost",
+                 :username => "Administrator", :password => "secret")
+        conn.create_bucket("my_protected_bucket",
+                 :ram_quota => 500, # megabytes
+                 :sasl_password => "s3cr3tBuck3t")
 
-* RCBC-87 Fix build error on macos.
+* Propagate status code for HTTP responses
 
-* Use global scope to find Error classes (thanks to @wr0ngway).
+* RCBC-87 Fix build error on Mac OS X
 
-* Fix memory leaks.
+* Use global scope to find Error classes (thanks to @wr0ngway)
 
-* Update to recent libcouchbase API.
+* Fix memory leaks
+
+* Update to recent libcouchbase API
 
 ## 1.2.0.z.beta2 (2012-09-21)
 
  3 files changed, 6 insertions(+), 2 deletions(-)
 
-* RCBC-82 Not all rubies are fat on MacOS. Fixes build.
+* RCBC-82 Not all rubies are fat on Mac OS X. Fixes build there
 
 ## 1.2.0.z.beta  (2012-09-18)
 
  2 files changed, 5 insertions(+), 1 deletion(-)
 
-* Fix version ordering by using ".z" prefix before .beta.
+* Fix version ordering by using ".z" prefix before .beta. The problem
+  is that DP (Developer Preview) should have lower precedence than
+  Beta, but alphabetially ".beta" orders before ".dp". This is why
+  further Beta versions have ".z".
 
 ## 1.2.0.beta (2012-09-18)
 
  51 files changed, 9301 insertions(+), 3364 deletions(-)
 
 * RCBC-81 Protect against NoMethodError in extconf.rb. Fixes
-  gem installation.
+  gem installation
+
+* RCBC-79 Use RESTful flush
+
+* Various build fixes
 
-* RCBC-79 Use RESTful flush.
+* Add attribute reader for Error::Base status code
 
-* Various build fixes.
+* CCBC-98 Expose client temporary failure error
 
-* Add attribute reader for Error::Base status code.
+* RCBC-28 Implement Bucket#unlock
 
-* CCBC-98 Expose client temporary failure error.
+        # Unlock the single key
+        val, _, cas = c.get("foo", :lock => true, :extended => true)
+        c.unlock("foo", :cas => cas)
 
-* RCBC-28 Implement Bucket#unlock.
+        # Unlock several keys
+        c.unlock("foo" => cas1, :bar => cas2)
+        #=> {"foo" => true, "bar" => true}
 
-* Fix CAS conversion for Bucket#delete method for 32-bit systems.
+* Fix CAS conversion for Bucket#delete method for 32-bit systems
 
 ## 1.1.5 (2012-09-17)
 
  3 files changed, 9 insertions(+), 5 deletions(-)
 
-* RCBC-81 Fixed installing issue on MacOS.
+* RCBC-81 Fixed installing issue on Mac OS X.
 
 ## 1.1.4 (2012-08-30)
 
  5 files changed, 64 insertions(+), 30 deletions(-)
 
-* RCBC-37 Allow app to pass intial list of nodes which will let client
-  iterate addresses until an alive node is found.
+* RCBC-37 Allow to pass intial list of nodes which will allow to
+  iterate addresses until alive node will be found.
 
-    Couchbase.connect(:node_list => ['node1.example.com:8091', 'node2.example.org:8091', 'node3.example.com:8091'])
+        Couchbase.connect(:node_list => ['example.com:8091', 'example.org:8091', 'example.net'])
 
 * RCBC-70 Fixed UTF-8 in the keys. Original discussion
   https://groups.google.com/d/topic/couchbase/bya0lSf9uGE/discussion
@@ -152,23 +231,37 @@ bugfixes. Do not forget to update this doc in every important patch.
 * RCBC-47 Allow to skip username for protected buckets. The will use
   bucket name for credentials.
 
-* Expose the number of replicas to the user.
+* Expose number of replicas to the user
+
+* RCBC-6 Implement Bucket#observe command to query durable state.
+  Examples:
+
+        # Query state of single key
+        c.observe("foo")
+        #=> [#<Couchbase::Result:0x00000001650df0 ...>, ...]
+
+        # Query state of multiple keys
+        keys = ["foo", "bar"]
+        stats = c.observe(keys)
+        stats.size   #=> 2
+        stats["foo"] #=> [#<Couchbase::Result:0x00000001650df0 ...>, ...]
 
-* RCBC-6 Implement OBSERVE command.
+* RCBC-49 Storage functions with durability requirements
 
-* RCBC-49 :observe option for storage functions.
+        # Ensure that the key will be persisted at least on the one node
+        c.set("foo", "bar", :observe => {:persisted => 1})
 
-* RCBC-50 Allow to read keys from replica.
+* RCBC-50 Allow to read keys from replica
 
-* RCBC-57 Expose timers API from libcouchbase.
+* RCBC-57 Expose timers API from libcouchbase
 
-* RCBC-59 Replicate flags in Bucket#cas operation.
+* RCBC-59 Replicate flags in Bucket#cas operation
 
 * Apply timeout value before connection. Currently libcouchbase shares
   timeouts for connection and IO operations. This patch allows to
-  setup a timeout when instantiating the connection.
+  setup timeout on the instantiating the connection.
 
-* RCBC-39 Allow to specify delta for incr/decr in options.
+* RCBC-39 Allow to specify delta for incr/decr in options
 
 * RCBC-40 Fix Bucket#cas operation behaviour in async mode. The
   callback of the Bucket#cas method is triggered only once, when it
@@ -176,27 +269,27 @@ bugfixes. Do not forget to update this doc in every important patch.
   the next store operation was successful. Example, append JSON
   encoded value asynchronously:
 
-    c.default_format = :document
-    c.set("foo", {"bar" => 1})
-    c.run do
-      c.cas("foo") do |val|
-        case val.operation
-        when :get
-          val["baz"] = 2
-          val
-        when :set
-          # verify all is ok
-          puts "error: #{ret.error.inspect}" unless ret.success?
+        c.default_format = :document
+        c.set("foo", {"bar" => 1})
+        c.run do
+          c.cas("foo") do |val|
+            case val.operation
+            when :get
+              val["baz"] = 2
+              val
+            when :set
+              # verify all is ok
+              puts "error: #{ret.error.inspect}" unless ret.success?
+            end
+          end
         end
-      end
-    end
-    c.get("foo")      #=> {"bar" => 1, "baz" => 2}
+        c.get("foo")      #=> {"bar" => 1, "baz" => 2}
 
-* RCBC-43 More docs and examples on views.
+* RCBC-43 More docs and examples on views
 
-* RCBC-37 Bootstrapping using multiple nodes.
+* RCBC-37 Bootstrapping using multiple nodes
 
-    Couchbase.connect(:node_list => ['example.com:8091', 'example.org:8091', 'example.net'])
+        Couchbase.connect(:node_list => ['example.com:8091', 'example.org:8091', 'example.net'])
 
 * Inherit StandardError instead RuntimeError for errors
 
@@ -204,54 +297,55 @@ bugfixes. Do not forget to update this doc in every important patch.
 
  12 files changed, 939 insertions(+), 20 deletions(-)
 
-* Integrate with Rack and Rails session store.
+* Integrate with Rack and Rails session store
 
-    # rack
-    require 'rack/session/couchbase'
-    use Rack::Session::Couchbase
+        # rack
+        require 'rack/session/couchbase'
+        use Rack::Session::Couchbase
 
-    # rails
-    require 'action_dispatch/middleware/session/couchbase_store'
-    AppName::Application.config.session_store :couchbase_store
+        # rails
+        require 'action_dispatch/middleware/session/couchbase_store'
+        AppName::Application.config.session_store :couchbase_store
 
-* Implement cache store adapter for Rails.
+* Implement cache store adapter for Rails
 
-    cache_options = {
-      :bucket => 'protected',
-      :username => 'protected',
-      :password => 'secret',
-      :expires_in => 30.seconds
-    }
-    config.cache_store = :couchbase_store, cache_options
+        cache_options = {
+          :bucket => 'protected',
+          :username => 'protected',
+          :password => 'secret',
+          :expires_in => 30.seconds
+        }
+        config.cache_store = :couchbase_store, cache_options
 
-* Implement key prefix (simple namespacing).
+* Implement key prefix (simple namespacing)
 
-    Couchbase.connect(:key_prefix => "prefix:")
+        Couchbase.connect(:key_prefix => "prefix:")
 
-* Allow to force assembling result Hash for multi-get.
+* Allow to force assembling result Hash for multi-get
 
-    connection.get("foo", "bar")
-    #=> [1, 2]
-    connection.get("foo", "bar", :assemble_hash => true)
-    #=> {"foo" => 1, "bar" => 2}
+        connection.get("foo", "bar")
+        #=> [1, 2]
+        connection.get("foo", "bar", :assemble_hash => true)
+        #=> {"foo" => 1, "bar" => 2}
 
 ## 1.2.0.dp4 (2012-06-07)
 
  4 files changed, 34 insertions(+), 19 deletions(-)
 
-* Update replace documentation: it accepts :cas option.
+* Update Bucket#replace documentation: it accepts :cas option
 
-* RCBC-36 Fix segfault. Ocassional segfault when accessing the
+* RCBC-36 Fix segfault. Occasional segfault when accessing the
   results of a View. https://gist.github.com/2883925
 
 ## 1.2.0.dp3 (2012-06-06)
 
  4 files changed, 22 insertions(+), 4 deletions(-)
 
-* Fix for multi_json < 1.3.3.
+* Fix for multi_json < 1.3.3
 
-* Break out from event loop for non-chunked responses (fix creating
-  design create).
+* Break out from event loop for non-chunked responses. View results
+  are chunked by default, so there no problems, but other requests
+  like Bucket#save_design_doc() were "locking" awaiting forever.
 
 ## 1.2.0.dp2 (2012-06-06)
 
@@ -263,15 +357,15 @@ bugfixes. Do not forget to update this doc in every important patch.
   I have n items to return. If there happens to be only one item it
   will be treated differently than if there happens to be 2 items.
 
-    get(["foo"])  #=> ["bar"]
-    get("foo")    #=> "bar"
-    get(["x"], :extended => true) #=> {"x"=>["xval", 0, 18336939621176836096]}
+        get(["foo"])  #=> ["bar"]
+        get("foo")    #=> "bar"
+        get(["x"], :extended => true) #=> {"x"=>["xval", 0, 18336939621176836096]}
 
-* Use monotonic high resolution clock.
+* Use monotonic high resolution clock
 
-* Implement threshold for outgoing commands.
+* Implement threshold for outgoing commands
 
-* Allow event loop to be stopped from ruby.
+* Allow to stop event loop from ruby
 
 * RCBC-35 Fix the View parameters escaping. More info at
   https://gist.github.com/2775050
@@ -281,17 +375,28 @@ bugfixes. Do not forget to update this doc in every important patch.
   various gems. The most compatible way to use yajl is to call
   Yajl::Parser and Yajl::Encoder directly.
 
-* Allow block and wait for part of the request.
+* Allow to block and wait for part of the requests
 
-* Fix view iterator to not lock the event loop anymore.
+* Fixed view iterator. It doesn't lock event loop anymore This used to
+  cause "locks", memory leaks or even segmentation fault.
 
-* Define views only if "views" key presented.
+* Define views only if "views" key presented
 
-* Require yajl as development dependency.
+* Require yajl as development dependency
 
-* Implement get with lock operation.
+* RCBC-76 Implement get with lock operation. Examples:
 
-* Update documentation.
+        # Get and lock key using default timeout
+        c.get("foo", :lock => true)
+
+        # Determine lock timeout parameters
+        c.stats.values_at("ep_getl_default_timeout", "ep_getl_max_timeout")
+        #=> [{"127.0.0.2:11210"=>"15"}, {"127.0.0.1:11210"=>"30"}]
+
+        # Get and lock key using custom timeout
+        c.get("foo", :lock => 3)
+
+* Update documentation
 
 ## 1.1.3 (2012-07-27)
 
@@ -302,15 +407,15 @@ bugfixes. Do not forget to update this doc in every important patch.
   function, which copy the internals and initializes new connection.
 
 * RCBC-59 The flags might be reset if caller will use
-  Couchbase::Bucket#cas operation. Here is IRB session demostrating
+  Couchbase::Bucket#cas operation. Here is IRB session demonstrating
   the issue:
 
-    irb>Couchbase.bucket.set("foo", "bar", :flags => 0x100)
-    17982951084586893312
-    irb> Couchbase.bucket.cas("foo") { "baz" }
-    1712422461213442048
-    irb> Couchbase.bucket.get("foo", :extended => true)
-    ["baz", 0, 1712422461213442048]
+        irb> Couchbase.bucket.set("foo", "bar", :flags => 0x100)
+        17982951084586893312
+        irb> Couchbase.bucket.cas("foo") { "baz" }
+        1712422461213442048
+        irb> Couchbase.bucket.get("foo", :extended => true)
+        ["baz", 0, 1712422461213442048]
 
 
 * RCBC-60 Make object_space GC protector per-bucket object. Previous
@@ -334,9 +439,17 @@ bugfixes. Do not forget to update this doc in every important patch.
 
  19 files changed, 1606 insertions(+), 93 deletions(-)
 
-* Properly handle hashes as Couchbase.connection_options
+* Properly handle hashes as Couchbase.connection_options. Fixed a bug
+  when 'Couchbase.connection_options' for "default" connection, when
+  there are several arguments to pass to the connect() function when
+  establishing thread local connection as below:
 
-* Implement views
+        Couchbase.connection_options = {:port => 9000, :bucket => 'myapp'}
+
+* Implement views. Couchbase Server Views are accessible using the
+  view APIs. Please refer to
+  http://www.couchbase.com/docs/couchbase-manual-2.0/couchbase-views.html
+  for getting started with views.
 
 * Use verbose mode by default throwing exceptions on NOT_FOUND errors.
   This means that quiet attribute is false now on new connections.
@@ -370,8 +483,8 @@ bugfixes. Do not forget to update this doc in every important patch.
   connections when running in multi-thread environment. Each thread
   has its own connection reference.
 
-* The direct dependency on libevent and sasl has been removed. Now the
-  library doesn't require libevent headers installed.
+* The direct dependency on libevent and libsasl has been removed. Now
+  the library doesn't require libevent headers installed.
 
 * The disconnect and reconnect interfaces are implemented which
   provide routines for explicit resource management. Connections were
@@ -384,10 +497,10 @@ bugfixes. Do not forget to update this doc in every important patch.
   below. No timeout will occur unless there is a problem with the
   connection.
 
-    connection.run do
-      connection.get("foo") {|ret| puts "got foo = #{ret.value}"}
-      sleep(5)
-    end
+        connection.run do
+          connection.get("foo") {|ret| puts "got foo = #{ret.value}"}
+          sleep(5)
+        end
 
 * It is not required to install libcouchbase or libvbucket on windows.
 
@@ -398,7 +511,7 @@ bugfixes. Do not forget to update this doc in every important patch.
 * Based on the time out fix (CCBC-20), clients will be notified when
   the connection was dropped or host isn't available.
 
-## 1.0.0 (2012-03-01)
+## 1.0.0 (2012-01-23)
 
  50 files changed, 4696 insertions(+), 2647 deletions(-)
 
@@ -424,28 +537,26 @@ bugfixes. Do not forget to update this doc in every important patch.
   * marshal
   * plain
 
-* Removed Views support.
+* Removed Views support
 
 * Added benchmarks, couchbase vs. memcached vs. dalli
 
-* Implement asynchronous protocol.
-
-* e36c2e7 Implement basic commands.
+* Implement asynchronous protocol
 
 ## 0.9.8 (2011-12-16)
 
  3 files changed, 8 insertions(+), 3 deletions(-)
 
 * RCBC-10 Always specify credentials for non-default buckets. It was
-  impossible to store data in non-default buckets.
+  impossible to store data in non-default buckets
 
 ## 0.9.7 (2011-10-05)
 
  7 files changed, 31 insertions(+), 19 deletions(-)
 
-* Fix design doc removal.
+* Fix design doc removing
 
-* Fix 'set' method signature: add missing options argument.
+* Fix 'set' method signature: add missing options argument
 
 * Rename gem to 'couchbase' for easy of use. The github project still
   is 'couchbase-ruby-client'
@@ -468,29 +579,29 @@ bugfixes. Do not forget to update this doc in every important patch.
 
  4 files changed, 59 insertions(+), 28 deletions(-)
 
-* Update README. Make it more human-friendly.
+* Update README. Make it more human-friendly
 
-* Removed depency on will_paginate in development mode.
+* Removed dependency on will_paginate in development mode
 
 ## 0.9.4 (2011-08-01)
 
  24 files changed, 1240 insertions(+), 78 deletions(-)
 
-* Use streaming json parser to iterate over view results.
+* Use streaming json parser to iterate over view results
 
-* Update memcached gem dependency to v1.3.
+* Update memcached gem dependency to v1.3
 
-* Proxy TOUCH command to memcached client.
+* Proxy TOUCH command to memcached client
 
-* Fix minor bugs in RestClient and Document classes.
+* Fix minor bugs in RestClient and Document classes
 
 * Disable CouchDB API for nodes without 'couchApiBase' key provided.
 
-* Fix bug with unicode parsing in config listener.
+* Fix bug with unicode parsing in config listener
 
 * 61f394e RCBC-5 Add Dave's test case: ensure memcached client
   initialized. Fixes Timeout error on connecting to membase with
-  Couchbase.new on Ruby 1.8.7.
+  Couchbase.new on Ruby 1.8.7
 
 ## 0.9.3 (2011-07-29)
 
@@ -499,28 +610,28 @@ bugfixes. Do not forget to update this doc in every important patch.
 * Use Latch (via Mutex and ConditionVariable) to wait until initial
   setup will be finished.
 
-* Update prefix for development views (from '$dev_' to 'dev_').
+* Update prefix for development views (from '$dev_' to 'dev_')
 
 ## 0.9.2 (2011-07-28)
 
  5 files changed, 31 insertions(+), 20 deletions(-)
 
-* Use zero TTL by default to store records forever.
+* Use zero TTL by default to store records forever
 
-* Update documentation.
+* Update documentation
 
-* Wait until configuration is done.
+* Wait until configuration is done
 
 ## 0.9.1 (2011-07-25)
 
  3 files changed, 5 insertions(+), 2 deletions(-)
 
-* Minor bugfix for RestClient initialization.
+* Minor bugfix for RestClient initialization
 
 ## 0.9.0 (2011-07-25)
 
  19 files changed, 1174 insertions(+)
 
-* Initial public release. It suppors most of the binary protocol
+* Initial public release. It supports most of the binary protocol
   commands through memcached gem and also is able to listen to bucket
   configuration and make View requests.