Fix a few documentation issues.

Author: behackett

bson/json_util.py

@@ -131,9 +131,9 @@ def loads(s, *args, **kwargs):
  Automatically passes the object_hook for BSON type conversion.
 
  :Parameters:
- - `compile_re` (optional): if ``False``, don't attempt to compile
- BSON regular expressions into Python regular expressions. Return
- instances of :class:`~bson.bsonregex.BSONRegex` instead.
+ - `compile_re` (optional): if ``False``, don't attempt to compile BSON
+  regular expressions into Python regular expressions. Return instances
+   of :class:`~bson.bsonregex.BSONRegex` instead.
 
  .. versionchanged:: 2.7
  Added ``compile_re`` option.

doc/tools.rst

@@ -83,8 +83,8 @@ MotorEngine
  `MotorEngine <http://motorengine.readthedocs.org/>`_ is a port of
  MongoEngine to Motor, for asynchronous access with Tornado.
  It implements the same modeling APIs to be data-portable, meaning that a
- model defined in MongoEngine can be read in MotorEngine. The source `is on
- github <http://github.com/heynemann/motorengine>`_.
+ model defined in MongoEngine can be read in MotorEngine. The source is
+ `available on github <http://github.com/heynemann/motorengine>`_.
 
 Framework Tools
 ---------------

gridfs/__init__.py

@@ -105,7 +105,7 @@ def put(self, data, **kwargs):
  try:
  f = new_file(**kwargs)
  f.write(data)
- finally
+ finally:
  f.close()
 
  `data` can be either an instance of :class:`str` (:class:`bytes`
@@ -284,18 +284,18 @@ def find(self, *args, **kwargs):
 
  Returns a cursor that iterates across files matching
  arbitrary queries on the files collection. Can be combined
- with other modifiers for additional control. For example
+ with other modifiers for additional control. For example::
 
- >>> for grid_out in fs.find({"filename": "lisa.txt"}, timeout=False):
- >>> data = grid_out.read()
+   for grid_out in fs.find({"filename": "lisa.txt"}, timeout=False):
+   data = grid_out.read()
 
  would iterate through all versions of "lisa.txt" stored in GridFS.
  Note that setting timeout to False may be important to prevent the
  cursor from timing out during long multi-file processing work.
 
- As another example, the call
+ As another example, the call::
 
- >>> most_recent_three = fs.find().sort("uploadDate", -1).limit(3)
+   most_recent_three = fs.find().sort("uploadDate", -1).limit(3)
 
  would return a cursor to the three most recently uploaded files
  in GridFS.