GridFS docs fixes.

Author: ajdavis

gridfs/__init__.py

@@ -609,8 +609,9 @@ def download_to_stream(self, file_id, destination):
  # Get _id of file to read
  file_id = fs.upload_from_stream("test_file", "data I want to store!")
  # Get file to write to
- file = open('myfile','rwb')
+ file = open('myfile','wb+')
  fs.download_to_stream(file_id, file)
+ file.seek(0)
  contents = file.read()
 
  Raises :exc:`~gridfs.errors.NoFile` if no file with file_id exists.
@@ -715,12 +716,13 @@ def open_download_stream_by_name(self, filename, revision=-1):
  Defaults to -1 (the most recent revision).
 
  :Note: Revision numbers are defined as follows:
- 0 = the original stored file
- 1 = the first revision
- 2 = the second revision
- etc...
- -2 = the second most recent revision
- -1 = the most recent revision
+
+ - 0 = the original stored file
+ - 1 = the first revision
+ - 2 = the second revision
+ - etc...
+ - -2 = the second most recent revision
+ - -1 = the most recent revision
  """
  validate_string("filename", filename)
 
@@ -764,12 +766,13 @@ def download_to_stream_by_name(self, filename, destination, revision=-1):
  Defaults to -1 (the most recent revision).
 
  :Note: Revision numbers are defined as follows:
- 0 = the original stored file
- 1 = the first revision
- 2 = the second revision
- etc...
- -2 = the second most recent revision
- -1 = the most recent revision
+
+ - 0 = the original stored file
+ - 1 = the first revision
+ - 2 = the second revision
+ - etc...
+ - -2 = the second most recent revision
+ - -1 = the most recent revision
  """
  gout = self.open_download_stream_by_name(filename, revision)
  for chunk in gout: