README.md in postgres_ext-1.0.0 vs README.md in postgres_ext-2.0.0
- old
+ new
@@ -1,8 +1,8 @@
# PostgresExt
-Adds support for missing PostgreSQL data types to ActiveRecord.
+Adds missing native PostgreSQL data types to ActiveRecord and convenient querying extensions for ActiveRecord and Arel for Rails 4.x
[![Build Status](https://secure.travis-ci.org/dockyard/postgres_ext.png?branch=master)](http://travis-ci.org/dockyard/postgres_ext)
[![Code Climate](https://codeclimate.com/badge.png)](https://codeclimate.com/github/dockyard/postgres_ext)
## Looking for help? ##
@@ -28,58 +28,17 @@
$ gem install postgres_ext
## Usage
Just `require 'postgres_ext'` and use ActiveRecord as you normally would! postgres\_ext extends
-ActiveRecord's data type handling.
+ActiveRecord's data type handling and query methods in both Arel and
+ActiveRecord.
- * [Migration/Schema.rb support](docs/migrations.md)
- * [Type Casting support](docs/type_casting.md)
* [Querying PostgreSQL datatypes](docs/querying.md)
- * [Indexes](docs/indexes.md)
-## Usage Notes
-Avoid the use of in place operators (ie `Array#<<`). These changes are
-*not* tracked by Rails ([this issue](https://github.com/rails/rails/issues/6954))
-explains why). In place modifications also modify the default object.
-
-Assuming we have the following model:
-
-```ruby
-create_table :items do |t|
- t.string :names, :array => true, :default => []
-end
-
-class Item < ActiveRecord::Base
-end
-```
-
-The following will modify the default value of the names attribute.
-
-```ruby
-a = Item.new
-a.names << 'foo'
-
-b = Item.new
-puts b.names
-# => ['foo']
-```
-
-The supported way of modifying `a.names`:
-
-```ruby
-a = Item.new
-a.names += ['foo']
-
-b = Item.new
-puts b.names
-# => []
-```
-
-As a result, in place operators are discouraged and will not be
-supported in postgres\_ext at this time.
-
-
+Where are the datatypes from PostgresExt 1.x? ActiveRecord 4.x includes
+all the data types that PostgresExt added to ActiveRecord 3.2.x. We'll
+be adding more datatypes as we come across them.
## Authors
Dan McClain [twitter](http://twitter.com/_danmcclain) [github](http://github.com/danmcclain)