rroonga 2.0.5 → 2.0.6

data/Rakefile

@@ -164,7 +164,11 @@ Rake::ExtensionTask.new("groonga", spec) do |ext|
 end
 
 file "Makefile" => ["extconf.rb", "ext/groonga/extconf.rb"] do
-  ruby("extconf.rb")
+  extconf_args = []
+  if ENV["TRAVIS"]
+    extconf_args << "--enable-debug-build"
+  end
+  ruby("extconf.rb", *extconf_args)
 end
 
 desc "Configure"

data/ext/groonga/extconf.rb

@@ -215,13 +215,45 @@ have_header("ruby/st.h") unless have_macro("HAVE_RUBY_ST_H", "ruby.h")
 have_func("rb_errinfo", "ruby.h")
 have_type("enum ruby_value_type", "ruby.h")
 
-checking_for(checking_message("debug flag")) do
-  debug = with_config("debug")
-  if debug
+checking_for(checking_message("--enable-debug-log option")) do
+  enable_debug_log = enable_config("debug-log", false)
+  if enable_debug_log
     debug_flag = "-DRB_GRN_DEBUG"
     $defs << debug_flag unless $defs.include?(debug_flag)
   end
-  debug
+  enable_debug_log
+end
+
+def gcc?
+  CONFIG["GCC"] == "yes"
+end
+
+def disable_optimization_build_flag(flags)
+  if gcc?
+    flags.gsub(/(^|\s)?-O\d(\s|$)?/, '\\1-O0\\2')
+  else
+    flags
+  end
+end
+
+def enable_debug_build_flag(flags)
+  if gcc?
+    flags.gsub(/(^|\s)?-g\d?(\s|$)?/, '\\1-ggdb3\\2')
+  else
+    flags
+  end
+end
+
+checking_for(checking_message("--enable-debug-build option")) do
+  enable_debug_build = enable_config("debug-build", false)
+  if enable_debug_build
+    $CFLAGS = disable_optimization_build_flag($CFLAGS)
+    $CFLAGS = enable_debug_build_flag($CFLAGS)
+
+    CONFIG["CXXFLAGS"] = disable_optimization_build_flag(CONFIG["CXXFLAGS"])
+    CONFIG["CXXFLAGS"] = enable_debug_build_flag(CONFIG["CXXFLAGS"])
+  end
+  enable_debug_build
 end
 
 if ENV["INSTALL_RB"] == "yes"

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

@@ -74,17 +74,15 @@ rb_grn_accessor_finalizer (grn_ctx *context, grn_obj *grn_object,
 }
 
 /*
- * call-seq:
- *   accessor.local_name
- *
  * アクセサ名を返す。
  *
- * <pre>
- * items = Groonga::Array.create(:name => "Items")
- * id = items.column("_id")
- * id.name # => nil
- * id.local_name # => "_id"
- * </pre>
+ * @overload local_name
+ *
+ * @example
+ *   items = Groonga::Array.create(:name => "Items")
+ *   id = items.column("_id")
+ *   id.name # => nil
+ *   id.local_name # => "_id"
  */
 static VALUE
 rb_grn_accessor_get_local_name (VALUE self)
@@ -105,7 +103,7 @@ rb_grn_accessor_get_local_name (VALUE self)
  * Document-class: Groonga::Accessor < Groonga::Object
  *
  * キー、値、スコアなど種々の値へのアクセスをカプセル化した
- * オブジェクト。Groonga::Table#columnで取得できる。
+ * オブジェクト。 {Groonga::Table#column} で取得できる。
  */
 void
 rb_grn_init_accessor (VALUE mGrn)

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

@@ -23,8 +23,8 @@ VALUE rb_cGrnArrayCursor;
 /*
  * Document-class: Groonga::ArrayCursor < Groonga::TableCursor
  *
- * Groonga::Arrayに登録されているレコードを順番に取り出すため
- * のオブジェクト。利用できるメソッドはGroonga::TableCursorを
+ * {Groonga::Array} に登録されているレコードを順番に取り出すため
+ * のオブジェクト。利用できるメソッドは {Groonga::TableCursor} を
  * 参照。
  */
 

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

@@ -50,62 +50,38 @@ VALUE rb_cGrnArray;
  *
  * @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でグループに含まれるレコー
- *     ドの件数を取得できる。
+ *   @!macro [new] array.create.options
+ *     @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} でグループに含まれるレコー
+ *       ドの件数を取得できる。
+ *   @!macro array.create.options
  * @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でグループに含まれるレコー
- *     ドの件数を取得できる。
+ *   @!macro array.create.options
  */
 static VALUE
 rb_grn_array_s_create (int argc, VALUE *argv, VALUE klass)
@@ -167,16 +143,13 @@ rb_grn_array_s_create (int argc, VALUE *argv, VALUE klass)
 }
 
 /*
- * call-seq:
- *   array.add(values=nil) -> Groonga::Recordまたはnil
- *
  * レコード追加し、追加したレコードを返す。レコードの追加に失
  * 敗した場合は +nil+ を返す。
  *
  * _values_ にはレコードのカラムに設定する値を指定する。省略
  * した場合または +nil+ を指定した場合はカラムは設定しない。カ
- * ラムの値は<tt>{:カラム名1 => 値1, :カラム名2 => 値2,
- * ...}</tt>と指定する。
+ * ラムの値は @{:カラム名1 => 値1, :カラム名2 => 値2,
+ * ...}@ と指定する。
  *
  * @example
  *   #以下のようなユーザを格納するGroonga::Arrayが
@@ -193,6 +166,9 @@ rb_grn_array_s_create (int argc, VALUE *argv, VALUE klass)
  *   #gunyara-kunユーザを追加する。
  *   gunyara_kun = users.add(:name => "gunyara-kun",
  *                           :uri => "http://d.hatena.ne.jp/tasukuchan/")
+ * @overload add(values=nil)
+ *   @return [Groonga::Recordまたはnil]
+ *
  */
 static VALUE
 rb_grn_array_add (int argc, VALUE *argv, VALUE self)

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

@@ -31,13 +31,14 @@ VALUE rb_cGrnColumn;
  * 加することができる。
  *
  * カラムには大きく分けて3種類ある。
- * [Groonga::FixSizeColumn]
- *   固定長のデータを格納するカラム。
- * [Groonga::VariableSizeColumn]
- *   可変長のデータを格納するカラム。
- * [Groonga::IndexColumn]
+ *
+ * - {Groonga::FixSizeColumn} :=
+ *   固定長のデータを格納するカラム。 =:
+ * - {Groonga::VariableSizeColumn} :=
+ *   可変長のデータを格納するカラム。 =:
+ * - {Groonga::IndexColumn} :=
  *   転置インデックスを格納するカラム。全文検索や参照元レコー
- *   ドの検索を行う場合はこのカラムを使用する。
+ *   ドの検索を行う場合はこのカラムを使用する。 =:
  *
  * 固定長データ用カラム・可変長データ用カラムは1つのデータだ
  * けを格納するか複数のデータを格納するかを選ぶことができる。
@@ -110,10 +111,10 @@ rb_grn_column_deconstruct (RbGrnColumn *rb_column,
 }
 
 /*
- * call-seq:
- *   column.table -> Groonga::Table
- *
  * カラムが所属するテーブルを返す。
+ *
+ * @overload table
+ *   @return [Groonga::Table]
  */
 static VALUE
 rb_grn_column_get_table (VALUE self)
@@ -132,14 +133,14 @@ rb_grn_column_get_table (VALUE self)
 }
 
 /*
- * call-seq:
- *   column.local_name
- *
- * @example テーブル名を除いたカラム名を返す。
+ * テーブル名を除いたカラム名を返す。
+ * @example
  *   items = Groonga::Array.create(:name => "Items")
  *   title = items.define_column("title", "ShortText")
  *   title.name # => "Items.title"
  *   title.local_name # => "title"
+ *
+ * @overload local_name
  */
 static VALUE
 rb_grn_column_get_local_name (VALUE self)
@@ -171,8 +172,8 @@ rb_grn_column_get_local_name (VALUE self)
  * カラムが所属するテーブルからブロックまたは文字列で指定し
  * た条件にマッチするレコードを返す。返されたテーブルには
  * +expression+ という特異メソッドがあり、指定した条件を表し
- * ているGroonga::Expressionを取得できる。
- * Groonga::Expression#snippetを使うことにより、指定した条件
+ * ている {Groonga::Expression} を取得できる。
+ * {Groonga::Expression#snippet} を使うことにより、指定した条件
  * 用のスニペットを簡単に生成できる。
  *
  * bc. !!!ruby
@@ -190,62 +191,85 @@ rb_grn_column_get_local_name (VALUE self)
  *   end
  *
  * 出力例
+ *
  * <pre>
- *   rroongaの説明文の中で「groonga」が含まれる部分
- *   ---
- *   rroongaは<em>groonga</em>のいわゆるDB-APIの層の...
- *   ---
+ * !!!text
+ * rroongaの説明文の中で「groonga」が含まれる部分
+ * ---
+ * rroongaは<em>groonga</em>のいわゆるDB-APIの層の...
+ * ---
+ * </pre>
  *
  * @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)
- *     マッチしたレコードをどのように扱うか。指定可能な値は以
- *     下の通り。
+ *     検索条件を指定するのに、 _record_ に対して次のメソッドを使って検索条
+ *     件を指定できます。
+ *
+ *     @==@ 、 @=~@ 、 @<@ 、 @<=@ 、 @>@ 、 @>=@ 、 @+@ 、 @-@ 、
+ *     @*@ 、 @/@ 、 @%@ 、
+ *     @match(query, :syntax => :query/:script, &block)@
+ *     （ _query_ に指定した
+ *     "grn_expr":http://groonga.org/ja/docs/reference/grn_expr.html
+ *     とのマッチ）、
+ *     @similar_search(text)@ （ _text_ との類似文書探索）、
+ *     @term_extract(text)@ （ _text_ 内から _record_ の単語を抽出）
  *
- *     [Groonga::Operator::OR]
- *     マッチしたレコードを追加。すでにレコードが追加され
- *     ている場合は何もしない。
- *     [Groonga::Operator::AND]
- *     マッチしたレコードのスコアを増加。マッチしなかった
- *     レコードを削除。
- *     [Groonga::Operator::BUT]
- *     マッチしたレコードを削除。
- *     [Groonga::Operator::ADJUST]
- *     マッチしたレコードのスコアを増加。
+ *   @!macro [new] column.select.options
+ *     @param [::Hash] options The name and value
+ *       pairs. Omitted names are initialized as the default value.
+ *     @option options :operator (Groonga::Operator::OR)
+ *       マッチしたレコードをどのように扱うか。指定可能な値は以
+ *       下の通り。
  *
- *   @option options :result
- *     検索結果を格納するテーブル。マッチしたレコードが追加さ
- *     れていく。省略した場合は新しくテーブルを作成して返す。
+ *       - Groonga::Operator::OR :=
+ *         マッチしたレコードを追加。すでにレコードが追加され
+ *         ている場合は何もしない。 =:
+ *       - Groonga::Operator::AND :=
+ *         マッチしたレコードのスコアを増加。マッチしなかった
+ *         レコードを削除。 =:
+ *       - Groonga::Operator::BUT :=
+ *         マッチしたレコードを削除。 =:
+ *       - Groonga::Operator::ADJUST :=
+ *         マッチしたレコードのスコアを増加。 =:
  *
- *   @option options :name
- *     条件の名前。省略した場合は名前を付けない。
+ *     @option options :result
+ *       検索結果を格納するテーブル。マッチしたレコードが追加さ
+ *       れていく。省略した場合は新しくテーブルを作成して返す。
  *
- *   @option options :syntax (:query)
- *     _query_ の構文。
+ *     @option options :name
+ *       条件の名前。省略した場合は名前を付けない。
  *
- *     参考: Groonga::Expression#parse.
+ *     @option options :syntax (:query)
+ *       _query_ の構文。
  *
- *   @option options :allow_pragma
- *     query構文時にプラグマを利用するかどうか。省略した場合は
- *     利用する。
+ *       参考: {Groonga::Expression#parse} .
  *
- *     参考: Groonga::Expression#parse.
+ *     @option options :allow_pragma
+ *       query構文時にプラグマを利用するかどうか。省略した場合は
+ *       利用する。
  *
- *   @option options :allow_column The allow_column
- *     query構文時にカラム指定を利用するかどうか。省略した場合
- *     は利用する。
+ *       参考: {Groonga::Expression#parse} .
  *
- *     参考: Groonga::Expression#parse.
+ *     @option options :allow_column The allow_column
+ *       query構文時にカラム指定を利用するかどうか。省略した場合
+ *       は利用する。
  *
- *   @option options :allow_update
- *     script構文時に更新操作を利用するかどうか。省略した場合
- *     は利用する。
+ *       参考: {Groonga::Expression#parse} .
  *
- *     参考: Groonga::Expression#parse.
+ *     @option options :allow_update
+ *       script構文時に更新操作を利用するかどうか。省略した場合
+ *       は利用する。
  *
+ *       参考: {Groonga::Expression#parse} .
+ *
+ *     @option options :allow_leading_not
+ *       指定語句の先頭に-を付けることで指定した語句を含まないレコードの
+ *       検索を有効にするかどうかを指定する。省略した場合は無効にする。
+ *
+ *       参考: {Groonga::Expression#parse} .
+ *
+ *   @!macro column.select.options
  * @overload select(query, options)
  *   @param [String] query 条件の指定
  *     _query_ には「[カラム名]:[演算子][値]」という書式で条件を
@@ -269,107 +293,11 @@ rb_grn_column_get_local_name (VALUE self)
  *       _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構文時にプラグマを利用するかどうか。省略した場合は
- *     利用する。
- *
- *     参考: Groonga::Expression#parse.
- *
- *   @option options :allow_column The allow_column
- *     query構文時にカラム指定を利用するかどうか。省略した場合
- *     は利用する。
- *
- *     参考: Groonga::Expression#parse.
- *
- *   @option options :allow_update
- *     script構文時に更新操作を利用するかどうか。省略した場合
- *     は利用する。
- *
- *     参考: Groonga::Expression#parse.
- *
+ *   @!macro column.select.options
  * @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::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.
- *
+ *     _expression_ には既に作成済みの {Groonga::Expression} を渡す。
+ *   @!macro column.select.options
  */
 static VALUE
 rb_grn_column_select (int argc, VALUE *argv, VALUE self)
@@ -380,7 +308,7 @@ rb_grn_column_select (int argc, VALUE *argv, VALUE self)
     VALUE options;
     VALUE rb_query, condition_or_options;
     VALUE rb_name, rb_operator, rb_result, rb_syntax;
-    VALUE rb_allow_pragma, rb_allow_column, rb_allow_update;
+    VALUE rb_allow_pragma, rb_allow_column, rb_allow_update, rb_allow_leading_not;
     VALUE builder;
     VALUE rb_expression = Qnil;
 
@@ -416,6 +344,7 @@ rb_grn_column_select (int argc, VALUE *argv, VALUE self)
 			"allow_pragma", &rb_allow_pragma,
 			"allow_column", &rb_allow_column,
 			"allow_update", &rb_allow_update,
+			"allow_leading_not", &rb_allow_leading_not,
 			NULL);
 
     if (!NIL_P(rb_operator))
@@ -437,6 +366,7 @@ rb_grn_column_select (int argc, VALUE *argv, VALUE self)
       rb_funcall(builder, rb_intern("allow_pragma="), 1, rb_allow_pragma);
       rb_funcall(builder, rb_intern("allow_column="), 1, rb_allow_column);
       rb_funcall(builder, rb_intern("allow_update="), 1, rb_allow_update);
+      rb_funcall(builder, rb_intern("allow_leading_not="), 1, rb_allow_leading_not);
       rb_expression = rb_grn_column_expression_builder_build(builder);
     }
     rb_grn_object_deconstruct(RB_GRN_OBJECT(DATA_PTR(rb_expression)),
@@ -499,27 +429,22 @@ rb_grn_column_unlock_ensure (VALUE self)
 
 /*
  * _column_ をロックする。ロックに失敗した場合は
- * Groonga::ResourceDeadlockAvoided例外が発生する。
+ * {Groonga::ResourceDeadlockAvoided} 例外が発生する。
  *
  * @overload lock(options={})
- *   @param [::Hash] options 利用可能なオプションは以下の通り。
- *   @option options :timeout
- *     ロックを獲得できなかった場合は _:timeout_ 秒間ロックの獲
- *     得を試みる。 _:timeout_ 秒以内にロックを獲得できなかった
- *     場合は例外が発生する。
- *   @option options :id
- *     _:id_で指定したレコードをロックする。（注: groonga側が
- *     未実装のため、現在は無視される）
+ *   @!macro [new] column.lock.options
+ *     @param [::Hash] options 利用可能なオプションは以下の通り。
+ *     @option options :timeout
+ *       ロックを獲得できなかった場合は _:timeout_ 秒間ロックの獲
+ *       得を試みる。 _:timeout_ 秒以内にロックを獲得できなかった
+ *       場合は例外が発生する。
+ *     @option options :id
+ *       _:id_で指定したレコードをロックする。（注: groonga側が
+ *       未実装のため、現在は無視される）
+ *   @!macro column.lock.options
  * @overload lock(options={})
  *   @yield ブロックを指定した場合はブロックを抜けたときにunlockする。
- *   @param [::Hash] options 利用可能なオプションは以下の通り。
- *   @option options :timeout
- *     ロックを獲得できなかった場合は _:timeout_秒間ロックの獲
- *     得を試みる。 _:timeout_秒以内にロックを獲得できなかった
- *     場合は例外が発生する。
- *   @option options :id
- *     _:id_で指定したレコードをロックする。（注: groonga側が
- *     未実装のため、現在は無視される）
+ *   @!macro column.lock.options
  */
 static VALUE
 rb_grn_column_lock (int argc, VALUE *argv, VALUE self)
@@ -630,15 +555,12 @@ rb_grn_column_is_locked (int argc, VALUE *argv, VALUE self)
 }
 
 /*
- * Document-method: reference?
- *
- * call-seq:
- *   column.reference? -> true/false
- *
  * _column_ の値がテーブルのレコードとなる場合は +true+ を返し、
  * そうでない場合は +false+ を返す。
  *
  * @since 1.0.5
+ *
+ * @overload reference?
  */
 static VALUE
 rb_grn_column_reference_p (VALUE self)
@@ -668,15 +590,12 @@ rb_grn_column_reference_p (VALUE self)
 }
 
 /*
- * Document-method: index?
- *
- * call-seq:
- *   column.index? -> true/false
- *
- * _column_ がGroonga::IndexColumnの場合は +true+ を返し、
+ * _column_ が {Groonga::IndexColumn} の場合は +true+ を返し、
  * そうでない場合は +false+ を返す。
  *
  * @since 1.0.5
+ *
+ * @overload index?
  */
 static VALUE
 rb_grn_column_index_p (VALUE self)
@@ -696,15 +615,12 @@ rb_grn_column_index_p (VALUE self)
 }
 
 /*
- * Document-method: vector?
- *
- * call-seq:
- *   column.vector? -> true/false
- *
  * _column_ がベクターカラムの場合は +true+ を返し、
  * そうでない場合は +false+ を返す。
  *
  * @since 1.0.5
+ *
+ * @overload vector?
  */
 static VALUE
 rb_grn_column_vector_p (VALUE self)
@@ -726,15 +642,12 @@ rb_grn_column_vector_p (VALUE self)
 }
 
 /*
- * Document-method: scalar?
- *
- * call-seq:
- *   column.scalar? -> true/false
- *
  * _column_ がスカラーカラムの場合は +true+ を返し、
  * そうでない場合は +false+ を返す。
  *
  * @since 1.0.5
+ *
+ * @overload scalar?
  */
 static VALUE
 rb_grn_column_scalar_p (VALUE self)