Documentation and changelog updates for 3.2

Author: behackett

doc/api/bson/index.rst

@@ -11,7 +11,6 @@ Sub-modules:
  :maxdepth: 2
 
  binary
- regex
  code
  codec_options
  dbref
@@ -21,6 +20,8 @@ Sub-modules:
  max_key
  min_key
  objectid
+ raw_bson
+ regex
  son
  timestamp
  tz_util

doc/api/bson/raw_bson.rst

@@ -0,0 +1,5 @@
+:mod:`raw_bson` -- Tools for representing raw BSON documents.
+=============================================================
+.. automodule:: bson.raw_bson
+ :synopsis: Tools for representing raw BSON documents.
+ :members:

doc/api/pymongo/index.rst

@@ -43,6 +43,7 @@ Sub-modules:
  mongo_replica_set_client
  operations
  pool
+ read_concern
  read_preferences
  results
  son_manipulator

doc/api/pymongo/read_concern.rst

@@ -0,0 +1,7 @@
+:mod:`read_concern` -- Tools for working with read concern.
+===========================================================
+
+.. automodule:: pymongo.read_concern
+ :synopsis: Tools for working with read concern.
+ :members:
+ :inherited-members:

doc/changelog.rst

@@ -8,9 +8,23 @@ Version 3.2 implements the new server features introduced in MongoDB 3.2.
 
 Highlights include:
 
-- Certain MongoClient properties block until a connection is established or
- raise ServerSelectionTimeoutError if no server is available. See
- :class:`~pymongo.MongoClient` for details.
+- Full support for MongoDB 3.2 including:
+
+ - Support for :class:`~pymongo.read_concern.ReadConcern`
+ - :class:`~pymongo.write_concern.WriteConcern` is now applied to
+ :meth:`~pymongo.collection.Collection.find_one_and_replace`,
+ :meth:`~pymongo.collection.Collection.find_one_and_update`, and
+ :meth:`~pymongo.collection.Collection.find_one_and_delete`.
+ - Support for the new `bypassDocumentValidation` option in write
+ helpers.
+
+- Support for reading and writing raw BSON with
+ :class:`~bson.raw_bson.RawBSONDocument`
+
+.. note:: Certain :class:`~pymongo.mongo_client.MongoClient` properties now
+ block until a connection is established or raise
+ :exc:`~pymongo.errors.ServerSelectionTimeoutError` if no server is available.
+ See :class:`~pymongo.mongo_client.MongoClient` for details.
 
 Changes in Version 3.1.1
 ------------------------

doc/installation.rst

@@ -233,9 +233,9 @@ but can be found on the
 `github tags page <https://github.com/mongodb/mongo-python-driver/tags>`_.
 They can be installed by passing the full URL for the tag to pip::
 
- $ pip install https://github.com/mongodb/mongo-python-driver/archive/3.1rc0.tar.gz
+ $ pip install https://github.com/mongodb/mongo-python-driver/archive/3.2rc0.tar.gz
 
 or easy_install::
 
- $ easy_install https://github.com/mongodb/mongo-python-driver/archive/3.1rc0.tar.gz
+ $ easy_install https://github.com/mongodb/mongo-python-driver/archive/3.2rc0.tar.gz
 

pymongo/cursor.py

@@ -473,19 +473,18 @@ def max_time_ms(self, max_time_ms):
 
  def max_await_time_ms(self, max_await_time_ms):
  """Specifies a time limit for a getMore operation on a
- :attr:`~pymongo.CursorType.TAILABLE_AWAIT` cursor. For all other types
- of cursor max_await_time_ms is ignored.
+ :attr:`~pymongo.cursor.CursorType.TAILABLE_AWAIT` cursor. For all other
+ types of cursor max_await_time_ms is ignored.
 
  Raises :exc:`TypeError` if `max_await_time_ms` is not an integer or
- ``None``.
- Raises :exc:`~pymongo.errors.InvalidOperation` if this :class:`Cursor`
- has already been used.
+ ``None``. Raises :exc:`~pymongo.errors.InvalidOperation` if this
+ :class:`Cursor` has already been used.
 
  .. note:: `max_await_time_ms` requires server version **>= 3.2**
 
  :Parameters:
  - `max_await_time_ms`: the time limit after which the operation is
- aborted
+  aborted
 
  .. versionadded:: 3.2
  """