         callback?()
     )
 
-  # Public: Get all ops with version = start to version = end. Noninclusive.
-  # end is trimmed to the size of the document.
-  #
-  # If any documents are passed to the callback, the first one has v = start
-  # end can be null. If so, returns all documents from start onwards.
-  #
-  # Each document returned is in the form {op:o, meta:m, v:version}.
+  # Public: Get all operations between start and end noninclusive.
   #
   # docName - Name of the document
-  # start   - The noninclusive starting version.
-  # end     - The noninclusive ending version.
-  #
-  # Calls callback(null, data) on success and otherwise calls the callback with
-  # just the error.
+  # start   - The noninclusive starting version, must be less than end.
+  # end     - The noninclusive ending version, if null assumed to be maximum
+  #           value.
+  #
+  # Calls callback(error) on failure.
+  # Calls callback(null, [{ op:string, meta:string }]) on success.
   @getOps = (docName, start, end, callback) ->
     end = 2147483648 unless end?
     return callback("Start must be less than end", []) if start >= end


  # Public: Write an operation to a document.
  #
  # opData = { op:the op to append, v:version, meta:optional }
  # callback = callback when operation committed
  #
  # opData.v MUST be the subsequent version for the document.
  #
  # This function has UNDEFINED BEHAVIOUR if you call append before calling create().
  # (its either that, or I have _another_ check when you append an op that the document already exists
  # ... and that would slow it down a bit.)
  @writeOp = (docName, opData, callback) ->
    async.auto(
      write_metadata: (cb) ->

  # Public: Write new snapshot data to the database.
  #
  # docName - Name of document.
  # docData - { snapshot:string, type:typename, meta:string, v:int }
  # dbMeta  - This argument is unused as it's unused in other storage engines
  #
  # This function has UNDEFINED BEHAVIOUR if you call append before calling create().
  #
  # Calls callback('Document already exists') if the document already exists.
  # Calls callback(error) on failure.
  # Calls callback() on success.
  @writeSnapshot = (docName, docData, dbMeta, callback) ->
    async.auto(
      write_metadata: (cb) ->
