RUBY-705 Clean up API documentation

Author: estolfo

README.md

@@ -7,13 +7,17 @@ Installation
 
 **Gem Installation**<br>
 The Ruby driver is released and distributed through RubyGems and it can be installed with the following command:
+
 ```bash
 gem install mongo
 ```
+
 For a significant performance boost, you'll want to install the C-extension:
+
 ```bash
 gem install bson_ext
 ```
+
 **Github Installation**<br>
 For development and test environments (not recommended for production) you can also install the Ruby driver directly from source:
 
@@ -36,6 +40,7 @@ rake install
 Usage
 -----
 Here is a quick example of basic usage for the Ruby driver:
+
 ```ruby
 require 'mongo'
 include Mongo

lib/bson/types/binary.rb

@@ -35,7 +35,7 @@ class Binary < ByteBuffer
     #
     # @param [Array, String] data to story as BSON binary. If a string is given, the on
     #   Ruby 1.9 it will be forced to the binary encoding.
-    # @param [Fixnum] one of four values specifying a BSON binary subtype. Possible values are
+    # @param [Fixnum] subtype one of four values specifying a BSON binary subtype. Possible values are
     #   SUBTYPE_BYTES, SUBTYPE_UUID, SUBTYPE_MD5, and SUBTYPE_USER_DEFINED.
     #
     # @see http://www.mongodb.org/display/DOCS/BSON#BSON-noteondatabinary BSON binary subtypes.

lib/bson/types/code.rb

@@ -23,7 +23,7 @@ class Code
     # Wrap code to be evaluated by MongoDB.
     #
     # @param [String] code the JavaScript code.
-    # @param [Hash] a document mapping identifiers to values, which
+    # @param [Hash] scope a document mapping identifiers to values, which
     #   represent the scope in which the code is to be executed.
     def initialize(code, scope={})
       @code  = code

lib/bson/types/dbref.rb

@@ -21,8 +21,8 @@ class DBRef
 
     # Create a DBRef. Use this class in conjunction with DB#dereference.
     #
-    # @param [String] a collection name
-    # @param [ObjectId] an object id
+    # @param [String] namespace a collection name.
+    # @param [ObjectId] object_id an object id.
     def initialize(namespace, object_id)
       @namespace = namespace
       @object_id = object_id

lib/bson/types/regex.rb

@@ -32,7 +32,7 @@ class Regex
     # Create a new regexp.
     #
     # @param pattern [String]
-    # @param options [Array, String]
+    # @param opts [Array, String]
     def initialize(pattern, *opts)
       @pattern = pattern
       @options = opts.first.is_a?(Fixnum) ? opts.first : str_opts_to_int(opts.join)

lib/mongo/collection.rb

@@ -159,7 +159,7 @@ def hint=(hint=nil)
     end
 
     # Set a hint field using a named index.
-    # @param [String] hinted index name
+    # @param [String] hint index name
     def named_hint=(hint=nil)
       @hint = hint
       self

lib/mongo/cursor.rb

@@ -189,7 +189,7 @@ def has_next?
 
     # Get the size of the result set for this query.
     #
-    # @param [Boolean] whether of not to take notice of skip and limit
+    # @param [Boolean] skip_and_limit whether or not to take skip or limit into account.
     #
     # @return [Integer] the number of objects in the result set for this query.
     #

lib/mongo/functional/authentication.rb

@@ -296,7 +296,7 @@ def issue_gssapi(auth, opts={})
 
     # Helper to fetch a nonce value from a given database instance.
     #
-    # @param db [Mongo::DB] The DB instance to use for issue the nonce command.
+    # @param database [Mongo::DB] The DB instance to use for issue the nonce command.
     # @param opts [Hash] Hash of optional settings and configuration values.
     #
     # @option opts [Socket] socket (nil) Optional socket instance to use.

lib/mongo/functional/uri_parser.rb

@@ -153,8 +153,6 @@ class URIParser
     # @note Passwords can contain any character except for ','
     #
     # @param [String] uri The MongoDB URI string.
-    # @param [Hash,nil] extra_opts Extra options. Will override anything
-    #   already specified in the URI.
     def initialize(uri)
       if uri.start_with?('mongodb://')
         uri = uri[10..-1]

lib/mongo/gridfs/grid.rb

@@ -81,7 +81,7 @@ def put(data, opts={})
 
     # Read a file from the file store.
     #
-    # @param [] id the file's unique id.
+    # @param id the file's unique id.
     #
     # @return [Mongo::GridIO]
     def get(id)
@@ -95,7 +95,7 @@ def get(id)
     # is attempting to read a file while it's being deleted. While the odds for this
     # kind of race condition are small, it's important to be aware of.
     #
-    # @param [] id
+    # @param id
     #
     # @return [Boolean]
     def delete(id)