rroonga 2.0.4 → 2.0.5

data/Rakefile

@@ -74,7 +74,7 @@ module YARD
   module CodeObjects
     class Proxy
       alias_method :initialize_original, :initialize
-      def initialize(namespace, name)
+      def initialize(namespace, name, type=nil)
         name = name.to_s.gsub(/\AGrn(.*)\z/) do
           suffix = $1
           case suffix
@@ -86,7 +86,7 @@ module YARD
             "Groonga::#{suffix}"
           end
         end
-        initialize_original(namespace, name)
+        initialize_original(namespace, name, type)
       end
     end
   end
@@ -163,6 +163,23 @@ Rake::ExtensionTask.new("groonga", spec) do |ext|
   end
 end
 
+file "Makefile" => ["extconf.rb", "ext/groonga/extconf.rb"] do
+  ruby("extconf.rb")
+end
+
+desc "Configure"
+task :configure => "Makefile"
+
+desc "Build"
+task :build => :configure do
+  sh("make")
+end
+
+desc "Run test"
+task :test => :configure do
+  ruby("-rubygems", "test/run-test.rb")
+end
+
 namespace :test do
   task :install do
     gemspec_helper = Rake.application.jeweler.gemspec_helper
@@ -174,3 +191,5 @@ namespace :test do
     ruby("-rubygems", "#{installed_path}/test/run-test.rb")
   end
 end
+
+task :default => :test

data/bin/grndump

@@ -69,7 +69,7 @@ option_parser = OptionParser.new do |parser|
   parser.on("--order-by=TYPE", types,
             "sort output recoreds by TYPE.",
             "available TYPEs: #{types.join(', ')}",
-            "(#{options.type})") do |type|
+            "(#{options.order_by})") do |type|
     options.order_by = type
   end
 end
@@ -84,7 +84,8 @@ db_path = args[0]
 database = Groonga::Database.open(db_path)
 dumper_options = {
   :database => database,
-  :output => STDOUT,
+  :output => $stdout,
+  :error_output => $stderr,
   :dump_schema => options.dump_schema,
   :dump_tables => options.dump_tables,
   :tables => options.tables,

data/ext/groonga/extconf.rb

@@ -183,12 +183,7 @@ def build_groonga(major, minor, micro)
     end
 
     message("installing...")
-    if [major, minor, micro] == [0, 1, 6]
-      make_install_args = " MKDIR_P='mkdir -p --'"
-    else
-      make_install_args = ""
-    end
-    if xsystem("make install#{make_install_args}")
+    if xsystem("make install")
       message(" done\n")
     else
       message(" failed\n")

data/ext/groonga/rb-grn-array.c

@@ -30,10 +30,6 @@ VALUE rb_cGrnArray;
  */
 
 /*
- * call-seq:
- *   Groonga::Array.create(options={})                -> Groonga::Array
- *   Groonga::Array.create(options={}) {|table| ... }
- *
  * キーのないテーブルを生成する。ブロックを指定すると、そのブ
  * ロックに生成したテーブルが渡され、ブロックを抜けると自動的
  * にテーブルが破棄される。
@@ -52,33 +48,64 @@ VALUE rb_cGrnArray;
  *   #それぞれのレコードに512バイトの値を格納できる無名一時テーブルを生成する。
  *   Groonga::Array.create(:value => 512)
  *
- * @param [::Hash] options The name and value
- *   pairs. Omitted names are initialized as the default value.
- * @option options [Grrnga::Context] :context (Groonga::Context.default) The context
- *   テーブルが利用するGrrnga::Context
- * @option options :name The name
- *   テーブルの名前。名前をつけると、Groonga::Context#[]に名
- *   前を指定してテーブルを取得することができる。省略すると
- *   無名テーブルになり、テーブルIDでのみ取得できる。
- * @option options :path The path
- *   テーブルを保存するパス。パスを指定すると永続テーブルとな
- *   り、プロセス終了後もレコードは保持される。次回起動時に
- *   Groonga::Context#[]で保存されたレコードを利用することが
- *   できる。省略すると一時テーブルになり、プロセスが終了する
- *   とレコードは破棄される。
- * @option options :persistent The persistent
- *   +true+ を指定すると永続テーブルとなる。 +path+ を省略した
- *   場合は自動的にパスが付加される。 +:context+ で指定した
- *   Groonga::Contextに結びついているデータベースが一時デー
- *   タベースの場合は例外が発生する。
- * @option options :value_type (nil) The value_type
- *   値の型を指定する。省略すると値のための領域を確保しない。
- *   値を保存したい場合は必ず指定すること。
- *   参考: Groonga::Type.new
- * @option options [Groonga::Record#n_sub_records] :sub_records The sub_records
- *   +true+ を指定すると#groupでグループ化したときに、
- *   Groonga::Record#n_sub_recordsでグループに含まれるレコー
- *   ドの件数を取得できる。
+ * @overload create(options={})
+ *   @return [Groonga::Array]
+ *   @param [::Hash] options The name and value
+ *     pairs. Omitted names are initialized as the default value.
+ *   @option options [Groonga::Context] :context (Groonga::Context.default)
+ *     テーブルが利用するGroonga::Context
+ *   @option options :name The name
+ *     テーブルの名前。名前をつけると、Groonga::Context#[]に名
+ *     前を指定してテーブルを取得することができる。省略すると
+ *     無名テーブルになり、テーブルIDでのみ取得できる。
+ *   @option options :path
+ *     テーブルを保存するパス。パスを指定すると永続テーブルとな
+ *     り、プロセス終了後もレコードは保持される。次回起動時に
+ *     Groonga::Context#[]で保存されたレコードを利用することが
+ *     できる。省略すると一時テーブルになり、プロセスが終了する
+ *     とレコードは破棄される。
+ *   @option options :persistent
+ *     +true+ を指定すると永続テーブルとなる。 +path+ を省略した
+ *     場合は自動的にパスが付加される。 +:context+ で指定した
+ *     Groonga::Contextに結びついているデータベースが一時デー
+ *     タベースの場合は例外が発生する。
+ *   @option options :value_type (nil)
+ *     値の型を指定する。省略すると値のための領域を確保しない。
+ *     値を保存したい場合は必ず指定すること。
+ *     参考: Groonga::Type.new
+ *   @option options [Groonga::Record#n_sub_records] :sub_records
+ *     +true+ を指定すると#groupでグループ化したときに、
+ *     Groonga::Record#n_sub_recordsでグループに含まれるレコー
+ *     ドの件数を取得できる。
+ * @overload create(options={})
+ *   @yield [table] 生成されたテーブル。ブロックを抜けると破棄される。
+ *   @param [::Hash] options The name and value
+ *     pairs. Omitted names are initialized as the default value.
+ *   @option options [Groonga::Context] :context (Groonga::Context.default)
+ *     テーブルが利用するGroonga::Context
+ *   @option options :name
+ *     テーブルの名前。名前をつけると、Groonga::Context#[]に名
+ *     前を指定してテーブルを取得することができる。省略すると
+ *     無名テーブルになり、テーブルIDでのみ取得できる。
+ *   @option options :path
+ *     テーブルを保存するパス。パスを指定すると永続テーブルとな
+ *     り、プロセス終了後もレコードは保持される。次回起動時に
+ *     Groonga::Context#[]で保存されたレコードを利用することが
+ *     できる。省略すると一時テーブルになり、プロセスが終了する
+ *     とレコードは破棄される。
+ *   @option options :persistent
+ *     +true+ を指定すると永続テーブルとなる。 +path+ を省略した
+ *     場合は自動的にパスが付加される。 +:context+ で指定した
+ *     Groonga::Contextに結びついているデータベースが一時デー
+ *     タベースの場合は例外が発生する。
+ *   @option options :value_type (nil)
+ *     値の型を指定する。省略すると値のための領域を確保しない。
+ *     値を保存したい場合は必ず指定すること。
+ *     参考: Groonga::Type.new
+ *   @option options [Groonga::Record#n_sub_records] :sub_records
+ *     +true+ を指定すると#groupでグループ化したときに、
+ *     Groonga::Record#n_sub_recordsでグループに含まれるレコー
+ *     ドの件数を取得できる。
  */
 static VALUE
 rb_grn_array_s_create (int argc, VALUE *argv, VALUE klass)

data/ext/groonga/rb-grn-column.c

@@ -167,12 +167,7 @@ rb_grn_column_get_local_name (VALUE self)
     return rb_name;
 }
 
-/*
- * call-seq:
- *   column.select(options) {|record| ...} -> Groonga::Hash
- *   column.select(query, options) -> Groonga::Hash
- *   column.select(expression, options) -> Groonga::Hash
- *
+ /*
  * カラムが所属するテーブルからブロックまたは文字列で指定し
  * た条件にマッチするレコードを返す。返されたテーブルには
  * +expression+ という特異メソッドがあり、指定した条件を表し
@@ -181,99 +176,200 @@ rb_grn_column_get_local_name (VALUE self)
  * 用のスニペットを簡単に生成できる。
  *
  * bc. !!!ruby
- * results = description_column.select do |column|
- *   column =~ "groonga"
- * end
- * snippet = results.expression.snippet([["<em>", "</em>"]])
- * results.each do |record|
- *   puts "#{record['name']}の説明文の中で「groonga」が含まれる部分"
- *   snippet.execute(record["description"]).each do |snippet|
- *     puts "---"
- *     puts "#{snippet}..."
- *     puts "---"
+ *   results = description_column.select do |column|
+ *     column =~ "groonga"
+ *   end
+ *   snippet = results.expression.snippet([["<em>", "</em>"]])
+ *   results.each do |record|
+ *     puts "#{record['name']}の説明文の中で「groonga」が含まれる部分"
+ *     snippet.execute(record["description"]).each do |snippet|
+ *       puts "---"
+ *       puts "#{snippet}..."
+ *       puts "---"
+ *     end
  *   end
- * end
  *
  * 出力例
+ * <pre>
+ *   rroongaの説明文の中で「groonga」が含まれる部分
+ *   ---
+ *   rroongaは<em>groonga</em>のいわゆるDB-APIの層の...
+ *   ---
+ *
+ * @return [Groonga::Hash] 検索結果
+ * @overload select(options)
+ *   @yieldparam [Groonga::Record] record
+ *   @param [::Hash] options The name and value
+ *     pairs. Omitted names are initialized as the default value.
+ *   @option options :operator (Groonga::Operator::OR)
+ *     マッチしたレコードをどのように扱うか。指定可能な値は以
+ *     下の通り。
+ *
+ *     [Groonga::Operator::OR]
+ *     マッチしたレコードを追加。すでにレコードが追加され
+ *     ている場合は何もしない。
+ *     [Groonga::Operator::AND]
+ *     マッチしたレコードのスコアを増加。マッチしなかった
+ *     レコードを削除。
+ *     [Groonga::Operator::BUT]
+ *     マッチしたレコードを削除。
+ *     [Groonga::Operator::ADJUST]
+ *     マッチしたレコードのスコアを増加。
+ *
+ *   @option options :result
+ *     検索結果を格納するテーブル。マッチしたレコードが追加さ
+ *     れていく。省略した場合は新しくテーブルを作成して返す。
+ *
+ *   @option options :name
+ *     条件の名前。省略した場合は名前を付けない。
+ *
+ *   @option options :syntax (:query)
+ *     _query_ の構文。
+ *
+ *     参考: Groonga::Expression#parse.
+ *
+ *   @option options :allow_pragma
+ *     query構文時にプラグマを利用するかどうか。省略した場合は
+ *     利用する。
+ *
+ *     参考: Groonga::Expression#parse.
+ *
+ *   @option options :allow_column The allow_column
+ *     query構文時にカラム指定を利用するかどうか。省略した場合
+ *     は利用する。
+ *
+ *     参考: Groonga::Expression#parse.
+ *
+ *   @option options :allow_update
+ *     script構文時に更新操作を利用するかどうか。省略した場合
+ *     は利用する。
+ *
+ *     参考: Groonga::Expression#parse.
+ *
+ * @overload select(query, options)
+ *   @param [String] query 条件の指定
+ *     _query_ には「[カラム名]:[演算子][値]」という書式で条件を
+ *     指定する。演算子は以下の通り。
+ *
+ *     - なし := [カラム値] == [値]
+ *     - @!@ := [カラム値] != [値]
+ *     - @<@ := [カラム値] < [値]
+ *     - @>@ := [カラム値] > [値]
+ *     - @<=@ := [カラム値] <= [値]
+ *     - @>=@ := [カラム値] >= [値]
+ *     - @@@ := [カラム値]が[値]を含んでいるかどうか
+ *
+ *     例:
+ *
+ *     - @"groonga"@ := _column_ カラムの値が @"groonga"@ のレコードにマッチ
+ *     - @"name:daijiro"@ :=
+ *       _column_ カラムが属しているテーブルの @"name"@ カラムの値が
+ *       @"daijiro"@ のレコードにマッチ  =:
+ *     - @"description:@@@groonga"@ :=
+ *       _column_ カラムが属しているテーブルの @"description"@ カラムが
+ *       @"groonga"@ を含んでいるレコードにマッチ =:
+ *
+ *   @param [::Hash] options The name and value
+ *     pairs. Omitted names are initialized as the default value.
+ *   @option options :operator (Groonga::Operator::OR)
+ *     マッチしたレコードをどのように扱うか。指定可能な値は以
+ *     下の通り。
+ *
+ *     [Groonga::Operator::OR]
+ *     マッチしたレコードを追加。すでにレコードが追加され
+ *     ている場合は何もしない。
+ *     [Groonga::Operator::AND]
+ *     マッチしたレコードのスコアを増加。マッチしなかった
+ *     レコードを削除。
+ *     [Groonga::Operator::BUT]
+ *     マッチしたレコードを削除。
+ *     [Groonga::Operator::ADJUST]
+ *     マッチしたレコードのスコアを増加。
+ *
+ *   @option options :result
+ *     検索結果を格納するテーブル。マッチしたレコードが追加さ
+ *     れていく。省略した場合は新しくテーブルを作成して返す。
+ *
+ *   @option options :name
+ *     条件の名前。省略した場合は名前を付けない。
+ *
+ *   @option options :syntax (:query)
+ *     _query_ の構文。
+ *
+ *     参考: Groonga::Expression#parse.
+ *
+ *   @option options :allow_pragma
+ *     query構文時にプラグマを利用するかどうか。省略した場合は
+ *     利用する。
  *
- * pre. rroongaの説明文の中で「groonga」が含まれる部分
- * ---
- * rroongaは<em>groonga</em>のいわゆるDB-APIの層の...
- * ---
- *
- * _query_ には「[カラム名]:[演算子][値]」という書式で条件を
- * 指定する。演算子は以下の通り。
- *
- * - なし := [カラム値] == [値]
- * - @!@ := [カラム値] != [値]
- * - @<@ := [カラム値] < [値]
- * - @>@ := [カラム値] > [値]
- * - @<=@ := [カラム値] <= [値]
- * - @>=@ := [カラム値] >= [値]
- * - @@@ := [カラム値]が[値]を含んでいるかどうか
- *
- * 例:
- *
- * - @"groonga"@ := _column_ カラムの値が @"groonga"@ のレコードにマッチ
- * - @"name:daijiro"@ :=
- *   _column_ カラムが属しているテーブルの @"name"@ カラムの値が
- *   @"daijiro"@ のレコードにマッチ  =:
- * - @"description:@@@groonga"@ :=
- *   _column_ カラムが属しているテーブルの @"description"@ カラムが
- *   @"groonga"@ を含んでいるレコードにマッチ =:
- *
- * _expression_ には既に作成済みのGroonga::Expressionを渡す
- *
- * ブロックで条件を指定する場合は
- * {Groonga::ColumnExpressionBuilder} を参照。
- *
- * _options_ に指定可能な値は以下の通り。
- * @param [::Hash] options The name and value
- *   pairs. Omitted names are initialized as the default value.
- * @option options :operator (Groonga::Operator::OR) The operator
- *   マッチしたレコードをどのように扱うか。指定可能な値は以
- *   下の通り。
- *
- *   [Groonga::Operator::OR]
+ *     参考: Groonga::Expression#parse.
+ *
+ *   @option options :allow_column The allow_column
+ *     query構文時にカラム指定を利用するかどうか。省略した場合
+ *     は利用する。
+ *
+ *     参考: Groonga::Expression#parse.
+ *
+ *   @option options :allow_update
+ *     script構文時に更新操作を利用するかどうか。省略した場合
+ *     は利用する。
+ *
+ *     参考: Groonga::Expression#parse.
+ *
+ * @overload select(expression, options)
+ *   @param [Groonga::Expression] expression 条件を表すオブジェクト
+ *     _expression_ には既に作成済みのGroonga::Expressionを渡す
+ *
+ *     ブロックで条件を指定する場合は
+ *     {Groonga::ColumnExpressionBuilder} を参照。
+ *
+ *   @param [::Hash] options The name and value
+ *     pairs. Omitted names are initialized as the default value.
+ *   @option options :operator (Groonga::Operator::OR)
+ *     マッチしたレコードをどのように扱うか。指定可能な値は以
+ *     下の通り。
+ *
+ *     [Groonga::Operator::OR]
  *     マッチしたレコードを追加。すでにレコードが追加され
  *     ている場合は何もしない。
- *   [Groonga::Operator::AND]
+ *     [Groonga::Operator::AND]
  *     マッチしたレコードのスコアを増加。マッチしなかった
  *     レコードを削除。
- *   [Groonga::Operator::BUT]
+ *     [Groonga::Operator::BUT]
  *     マッチしたレコードを削除。
- *   [Groonga::Operator::ADJUST]
+ *     [Groonga::Operator::ADJUST]
  *     マッチしたレコードのスコアを増加。
  *
- * @option options :result The result
- *   検索結果を格納するテーブル。マッチしたレコードが追加さ
- *   れていく。省略した場合は新しくテーブルを作成して返す。
+ *   @option options :result
+ *     検索結果を格納するテーブル。マッチしたレコードが追加さ
+ *     れていく。省略した場合は新しくテーブルを作成して返す。
  *
- * @option options :name The name
- *   条件の名前。省略した場合は名前を付けない。
+ *   @option options :name
+ *     条件の名前。省略した場合は名前を付けない。
  *
- * @option options :syntax (:query) The syntax
- *   _query_の構文。
+ *   @option options :syntax (:query)
+ *     _query_ の構文。
  *
- *   参考: Groonga::Expression#parse.
+ *     参考: Groonga::Expression#parse.
  *
- * @option options :allow_pragma The allow_pragma
- *   query構文時にプラグマを利用するかどうか。省略した場合は
- *   利用する。
+ *   @option options :allow_pragma
+ *     query構文時にプラグマを利用するかどうか。省略した場合は
+ *     利用する。
  *
- *   参考: Groonga::Expression#parse.
+ *     参考: Groonga::Expression#parse.
  *
- * @option options :allow_column The allow_column
- *   query構文時にカラム指定を利用するかどうか。省略した場合
- *   は利用する。
+ *   @option options :allow_column The allow_column
+ *     query構文時にカラム指定を利用するかどうか。省略した場合
+ *     は利用する。
  *
- *   参考: Groonga::Expression#parse.
+ *     参考: Groonga::Expression#parse.
  *
- * @option options :allow_update
- *   script構文時に更新操作を利用するかどうか。省略した場合
- *   は利用する。
+ *   @option options :allow_update
+ *     script構文時に更新操作を利用するかどうか。省略した場合
+ *     は利用する。
+ *
+ *     参考: Groonga::Expression#parse.
  *
- *   参考: Groonga::Expression#parse.
  */
 static VALUE
 rb_grn_column_select (int argc, VALUE *argv, VALUE self)
@@ -359,18 +455,12 @@ rb_grn_column_select (int argc, VALUE *argv, VALUE self)
 }
 
 /*
- * Document-method: unlock
- *
- * call-seq:
- *   column.unlock(options={})
- *
  * _column_ のロックを解除する。
- *
- * 利用可能なオプションは以下の通り。
- *
- * [_:id_]
- *   _:id_ で指定したレコードのロックを解除する。
- *   （注: groonga側が未実装のため、現在は無視される）
+ * @overload unlock(options={})
+ *   @param [::Hash] options 利用可能なオプションは以下の通り。
+ *   @option options :id
+ *     _:id_ で指定したレコードのロックを解除する。
+ *     （注: groonga側が未実装のため、現在は無視される）
  */
 static VALUE
 rb_grn_column_unlock (int argc, VALUE *argv, VALUE self)
@@ -408,26 +498,28 @@ rb_grn_column_unlock_ensure (VALUE self)
 }
 
 /*
- * Document-method: lock
- *
- * call-seq:
- *   column.lock(options={})
- *   column.lock(options={}) {...}
- *
  * _column_ をロックする。ロックに失敗した場合は
  * Groonga::ResourceDeadlockAvoided例外が発生する。
  *
- * ブロックを指定した場合はブロックを抜けたときにunlockする。
- *
- * 利用可能なオプションは以下の通り。
- *
- * [_:timeout_]
- *   ロックを獲得できなかった場合は_:timeout_秒間ロックの獲
- *   得を試みる。_:timeout_秒以内にロックを獲得できなかった
- *   場合は例外が発生する。
- * [_:id_]
- *   _:id_で指定したレコードをロックする。（注: groonga側が
- *   未実装のため、現在は無視される）
+ * @overload lock(options={})
+ *   @param [::Hash] options 利用可能なオプションは以下の通り。
+ *   @option options :timeout
+ *     ロックを獲得できなかった場合は _:timeout_ 秒間ロックの獲
+ *     得を試みる。 _:timeout_ 秒以内にロックを獲得できなかった
+ *     場合は例外が発生する。
+ *   @option options :id
+ *     _:id_で指定したレコードをロックする。（注: groonga側が
+ *     未実装のため、現在は無視される）
+ * @overload lock(options={})
+ *   @yield ブロックを指定した場合はブロックを抜けたときにunlockする。
+ *   @param [::Hash] options 利用可能なオプションは以下の通り。
+ *   @option options :timeout
+ *     ロックを獲得できなかった場合は _:timeout_秒間ロックの獲
+ *     得を試みる。 _:timeout_秒以内にロックを獲得できなかった
+ *     場合は例外が発生する。
+ *   @option options :id
+ *     _:id_で指定したレコードをロックする。（注: groonga側が
+ *     未実装のため、現在は無視される）
  */
 static VALUE
 rb_grn_column_lock (int argc, VALUE *argv, VALUE self)
@@ -468,20 +560,14 @@ rb_grn_column_lock (int argc, VALUE *argv, VALUE self)
 }
 
 /*
- * Document-method: clear_lock
- *
- * call-seq:
- *   column.clear_lock(options={})
- *
- * _column_のロックを強制的に解除する。
- *
- * 利用可能なオプションは以下の通り。
- *
- * [_:id_]
- *   _:id_で指定したレコードのロックを強制的に解除する。
- *   （注: groonga側が未実装のため、現在は無視される。実装さ
- *   れるのではないかと思っているが、実装されないかもしれな
- *   い。）
+ * _column_ のロックを強制的に解除する。
+ * @overload clear_lock(options={})
+ *   @param [::Hash] options 利用可能なオプションは以下の通り。
+ *   @option options :id
+ *     _:id_で指定したレコードのロックを強制的に解除する。
+ *     （注: groonga側が未実装のため、現在は無視される。実装さ
+ *     れるのではないかと思っているが、実装されないかもしれな
+ *     い。）
  */
 static VALUE
 rb_grn_column_clear_lock (int argc, VALUE *argv, VALUE self)
@@ -510,20 +596,14 @@ rb_grn_column_clear_lock (int argc, VALUE *argv, VALUE self)
 }
 
 /*
- * Document-method: locked?
- *
- * call-seq:
- *   column.locked?(options={})
- *
  * _column_ がロックされていれば +true+ を返す。
- *
- * 利用可能なオプションは以下の通り。
- *
- * [_:id_]
- *   _:id_で指定したレコードがロックされていれば +true+ を返す。
- *   （注: groonga側が未実装のため、現在は無視される。実装さ
- *   れるのではないかと思っているが、実装されないかもしれな
- *   い。）
+ * @overload locked?(options={})
+ *   @param [::Hash] options 利用可能なオプションは以下の通り。
+ *   @option options :id
+ *     _:id_で指定したレコードがロックされていれば +true+ を返す。
+ *     （注: groonga側が未実装のため、現在は無視される。実装さ
+ *     れるのではないかと思っているが、実装されないかもしれな
+ *     い。）
  */
 static VALUE
 rb_grn_column_is_locked (int argc, VALUE *argv, VALUE self)
@@ -682,14 +762,11 @@ rb_grn_column_scalar_p (VALUE self)
 }
 
 /*
- * Document-method: indexes
- *
- * call-seq:
- *   column.indexes(operator=Groonga::Operator::MATCH) -> [index_column, ...]
- *
- * _operation_ を実行できる _column_ のインデックスを返す。
- *
+ * _operator_ を実行できる _column_ のインデックスを返す。
  * @since 1.0.9
+ * @return [Array<index_column>] _operator_ を実行できる _column_ のインデックス
+ * @overload indexes(operator=Groonga::Operator::MATCH)
+ *   @param [Groonga::Operator::XXX] operator
  */
 static VALUE
 rb_grn_column_get_indexes (int argc, VALUE *argv, VALUE self)
@@ -731,15 +808,10 @@ rb_grn_column_get_indexes (int argc, VALUE *argv, VALUE self)
 }
 
 /*
- * Document-method: rename
- *
- * call-seq:
- *   table.rename(name)
- *
  * Renames the table to name.
- *
- * @param name [String] the new name
  * @since 1.3.0
+ * @overload rename(name)
+ *   @param name [String] the new name
  */
 static VALUE
 rb_grn_column_rename (VALUE self, VALUE rb_name)