Mongoose 3.7 (unstable) released

[Aaron Heckmann]

Mongoose 3.7 (unstable) is now available.

Beginning with this release, the Mongoose project has moved to a release versioning approach similar to the MongoDB and Node.js projects. All odd numbered minor versions are to be considered unstable where you should expect larger, potentially breaking changes to occur during iteration towards the next even numbered (stable) release.

We feel this approach provides a cleaner, more consistent way to describe and iterate on new code branches than tagging pre-releases as "beta0", "beta1", etc.

Summary:

  X.OddNumber.X is an unstable release

  X.EvenNumber.X is a stable release

For example: 3.7.0, 3.7.1 and 4.11.398 are unstable, whereas 3.8.0, 3.8.1, and 3.20.1 are stable.

Install: `npm install mong...@3.7.0`

Please read the full release notes for details: https://github.com/LearnBoost/mongoose/wiki/3.7-(unstable)-Release-Notes

Changelog:

3.7.0 (unstable) / 2013-08-05

=====================

  * changed; query.within getter is now a method -> query.within()

  * changed; query.intersects getter is now a method -> query.intersects()

  * deprecated; promise#addBack (use promise#onResolve)

  * deprecated; promise#complete (use promise#fulfill)

  * deprecated; promise#addCallback (use promise#onFulFill)

  * deprecated; promise#addErrback (use promise#onReject)

  * deprecated; query.nearSphere() (use query.near)

  * deprecated; query.center() (use query.circle)

  * deprecated; query.centerSphere() (use query.circle)

  * deprecated; query#slaveOk (use query#read)

  * removed; namedscope (undocumented and broken) #679 #642 #455 #379

  * added; benchmarks [ebensing](https://github.com/ebensing)

  * added; publicly exposed connection states #1585

  * added; $geoWithin support #1529 $1455 [ebensing](https://github.com/ebensing)

  * added; query method chain validation

  * added; model.update `overwrite` option

  * added; model.geoNear() support #1563 [ebensing](https://github.com/ebensing)

  * added; model.geoSearch() support #1560 [ebensing](https://github.com/ebensing)

  * added; MongooseBuffer#subtype()

  * added; model.create() now returns a promise #1340

  * added; support for `awaitdata` query option

  * added; pass the doc to doc.remove() callback #1419 [JoeWagner](https://github.com/JoeWagner)

  * added; aggregation query builder #1404 [njoyard](https://github.com/njoyard)

  * updated; integrate mquery #1562 [ebensing](https://github.com/ebensing)

  * updated; error msg in doc.save() #1595

  * updated; bump driver to 1.3.15

  * updated; mpromise 0.3.0

  * updated; sliced 0.0.5

  * tests; fix sharding tests for MongoDB 2.4.5

  * tests; now 4-5 seconds faster

  * tests; fix race condition

  * docs; fix readme spelling #1483 [yorchopolis](https://github.com/yorchopolis)

  * docs; fixed up the README and examples [ebensing](https://github.com/ebensing)

  * website; add unstable docs

  * website; many improvements

  * website; fix copyright #1439

  * website; server.js -> static.js #1546 [nikmartin](https://github.com/nikmartin)

  * examples; improved and expanded [ebensing](https://github.com/ebensing)