doc: put parameter name before parameter type

lib/groonga/client.rb

@@ -37,7 +37,7 @@ def default_options
         @@deafult_options
       end
 
-      # @param [Hash] options The new default options for
+      # @param options [Hash] The new default options for
       #   {Groonga::Client.new}.
       #
       # @since 0.2.0
@@ -46,7 +46,7 @@ def default_options=(options)
       end
 
       # @!macro [new] initialize_options
-      #   @param [Hash] options The options.
+      #   @param options [Hash] The options.
       #   @option options [String, URI::Generic, URI::HTTP, URI::HTTPS]
       #     :url The URL of Groonga server.
       #   @option options [:gqtp, :http, :https] :protocol The

lib/groonga/client/request/select.rb

@@ -61,16 +61,16 @@ def query(value)
         #   The new request with the given condition.
         #
         # @overload filter(column_name, value)
-        #   @param [String, Symbol] column_name The target column name.
-        #   @param [Object] value The column value. It's escaped automatically.
+        #   @param column_name [String, Symbol] The target column name.
+        #   @param value [Object] The column value. It's escaped automatically.
         #
         #   Adds a `#{column_name} == #{value}` condition.
         #
         # @overload filter(expression, values=nil)
-        #   @param [String] expression The script syntax expression.
+        #   @param expression [String] The script syntax expression.
         #      It can includes `%{name}`s as placeholder. They are expanded
         #      by `String#%` with the given `values` argument.
-        #   @param [nil, ::Hash] values The values to be expanded.
+        #   @param values [nil, ::Hash] The values to be expanded.
         #      If the given `expression` doesn't have placeholder, you
         #      should specify `nil`.
         #
@@ -193,9 +193,9 @@ def initialize(request)
           #      filter.in_values("tags")
           #        # -> --filter ''
           #
-          # @param [String, Symbol] column_name The target column name.
+          # @param column_name [String, Symbol] The target column name.
           #
-          # @param [Object] values The column values that cover target
+          # @param values [Object] The column values that cover target
           #   column values.
           #
           # @return [Groonga::Client::Request::Select]

lib/groonga/client/response/base.rb

@@ -38,9 +38,11 @@ def find(name)
         # Parses the response for the request of the command and returns
         # response object.
         #
-        # @param [Groonga::Command::Base] The command of the request.
-        # @param [String] The raw (not parsed) response returned by Groonga
-        #   server.
+        # @param command [Groonga::Command::Base] The command of the request.
+        #
+        # @param raw_response [String] The raw (not parsed) response
+        #   returned by Groonga server.
+        #
         # @return [Base]
         def parse(command, raw_response)
           klass = find(command.command_name)