rroonga 2.0.5 → 2.0.6

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

@@ -121,13 +121,11 @@ rb_grn_plugin_s_register (int argc, VALUE *argv, VALUE klass)
     return Qnil;
 }
 
-/**
- * call-seq:
- *   Groonga::Plugin.system_plugins_dir
- *
+/*
  * Returns the system plugins directory.
  *
- * @return The system plugins directory.
+ * @overload system_plugins_dir
+ *   @return [String]
  */
 static VALUE
 rb_grn_plugin_s_system_plugins_dir (VALUE klass)
@@ -135,13 +133,11 @@ rb_grn_plugin_s_system_plugins_dir (VALUE klass)
     return rb_str_new2(grn_plugin_get_system_plugins_dir());
 }
 
-/**
- * call-seq:
- *   Groonga::Plugin.suffix
- *
+/*
  * Returns the plugin file suffix. (e.g. ".so", ".dll" and so on.)
  *
- * @return The plugin file suffix.
+ * @overload suffix
+ *   @return [String]
  */
 static VALUE
 rb_grn_plugin_s_suffix (VALUE klass)

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

@@ -26,7 +26,7 @@ VALUE rb_cGrnTableCursor;
  * Document-class: Groonga::TableCursor
  *
  * テーブルに登録されているレコードを順番に取り出すための
- * オブジェクト。Groonga::Table#open_cursorで生成できる。
+ * オブジェクト。 {Groonga::Table#open_cursor} で生成できる。
  */
 
 grn_table_cursor *
@@ -128,7 +128,7 @@ rb_grn_table_cursor_order_by_to_flag (unsigned char table_type,
  * カレントレコードの値を返す。
  *
  * @overload value
- * @return [String] カレントレコードの値
+ *   @return [String] カレントレコードの値
  */
 static VALUE
 rb_grn_table_cursor_get_value (VALUE self)
@@ -178,10 +178,9 @@ rb_grn_table_cursor_set_value (VALUE self, VALUE value)
 }
 
 /*
- * call-seq:
- *   table_cursor.delete
- *
  * カレントレコードを削除する。
+ *
+ * @overload delete
  */
 static VALUE
 rb_grn_table_cursor_delete (VALUE self)
@@ -202,10 +201,10 @@ rb_grn_table_cursor_delete (VALUE self)
 }
 
 /*
- * call-seq:
- *   table_cursor.next -> Groonga::Record
- *
  * カレントレコードを一件進めてそのレコードを返す。
+ *
+ * @overload next
+ *   @return [Groonga::Record]
  */
 static VALUE
 rb_grn_table_cursor_next (VALUE self)
@@ -229,10 +228,10 @@ rb_grn_table_cursor_next (VALUE self)
 }
 
 /*
- * call-seq:
- *   table_cursor.each {|record| ...}
- *
  * カーソルの範囲内にあるレコードを順番にブロックに渡す。
+ *
+ * @overload each
+ *   @yield [record]
  */
 static VALUE
 rb_grn_table_cursor_each (VALUE self)
@@ -257,23 +256,17 @@ rb_grn_table_cursor_each (VALUE self)
 }
 
 /*
- * Document-method: close
- *
- * call-seq:
- *   cursor.close
- *
  * カーソルが使用しているリソースを開放する。これ以降カーソルを
  * 使うことはできない。
+ *
+ * @overload close
  */
 
 /*
- * Document-method: closed?
- *
- * call-seq:
- *   cursor.closed? -> true/false
- *
  * カーソルが開放済みの場合は +true+ を返し、そうでない場合は
  * +false+ を返す。
+ *
+ * @overload closed?
  */
 
 void

data/ext/groonga/rb-grn-table-key-support.c

@@ -25,8 +25,8 @@ VALUE rb_mGrnTableKeySupport;
 /*
  * Document-module: Groonga::Table::KeySupport
  *
- * 主キーを持つテーブルであるGroonga::Hashと
- * Groonga::PatriciaTrieに主キーの機能を提供するモジュール。
+ * 主キーを持つテーブルである {Groonga::Hash} と
+ * {Groonga::PatriciaTrie} に主キーの機能を提供するモジュール。
  */
 
 void
@@ -110,21 +110,21 @@ rb_grn_table_key_support_add_raw (VALUE self, VALUE rb_key, int *added)
 }
 
 /*
- * call-seq:
- *   table.add(key, values=nil) -> Groonga::Recordまたはnil
- *
  * 主キーが _key_ のレコード追加し、追加したレコードを返す。レ
  * コードの追加に失敗した場合は +nil+ を返す。
  *
  * すでに同じキーのレコードが存在する場合は追加せずに同じレ
  * コードを返す。追加されたかどうかは
- * +Groonga::Record#added?+ で調べることができる。 +true+ を返
+ * {Groonga::Record#added?} で調べることができる。 +true+ を返
  * したら追加されたということを示す。
  *
  * _values_ にはレコードのカラムに設定する値を指定する。省略
  * した場合または +nil+ を指定した場合はカラムは設定しない。カ
- * ラムの値は<tt>{:カラム名1 => 値1, :カラム名2 => 値2,
- * ...}</tt>と指定する。
+ * ラムの値は @{:カラム名1 => 値1, :カラム名2 => 値2,
+ * ...}@ と指定する。
+ *
+ * @overload add(key, values=nil)
+ *   @return [Groonga::Recordまたはnil]
  */
 static VALUE
 rb_grn_table_key_support_add (int argc, VALUE *argv, VALUE self)
@@ -168,14 +168,15 @@ rb_grn_table_key_support_get (VALUE self, VALUE rb_key)
 }
 
 /*
- * call-seq:
- *   table.id -> テーブルID
- *   table.id(key) -> レコードID
- *
  * _key_ を指定しない場合はテーブルのIDを返す。
  *
  * _key_ を指定した場合はテーブルの _key_ に対応するレコードの
  * IDを返す。
+ *
+ * @overload id
+ *   @return [テーブルID]
+ * @overload id(key)
+ *   @return [レコードID]
  */
 static VALUE
 rb_grn_table_key_support_get_id (int argc, VALUE *argv, VALUE self)
@@ -198,10 +199,10 @@ rb_grn_table_key_support_get_id (int argc, VALUE *argv, VALUE self)
 }
 
 /*
- * call-seq:
- *   table.key(id) -> 主キー
- *
  * テーブルの _id_ に対応する主キーを返す。
+ *
+ * @overload key(id)
+ *   @return [主キー]
  */
 static VALUE
 rb_grn_table_key_support_get_key (VALUE self, VALUE rb_id)
@@ -234,10 +235,9 @@ rb_grn_table_key_support_get_key (VALUE self, VALUE rb_id)
 }
 
 /*
- * call-seq:
- *   table.has_key?(key) -> true/false
- *
  * テーブルに主キーが _key_ のレコードがあるならtrueを返す。
+ *
+ * @overload has_key?(key)
  */
 static VALUE
 rb_grn_table_key_support_has_key (VALUE self, VALUE rb_key)
@@ -283,11 +283,10 @@ rb_grn_table_key_support_delete_by_key (VALUE self, VALUE rb_key)
 }
 
 /*
- * call-seq:
- *   table.delete(id)
- *   table.delete(key)
- *
  * テーブルの _id_ または _key_ に対応するレコードを削除する。
+ *
+ * @overload delete(id)
+ * @overload delete(key)
  */
 static VALUE
 rb_grn_table_key_support_delete (VALUE self, VALUE rb_id_or_key)
@@ -300,9 +299,9 @@ rb_grn_table_key_support_delete (VALUE self, VALUE rb_id_or_key)
 }
 
 /*
- * _table_ の _key_ に対応するGroonga::Recordを返す。
+ * _table_ の _key_ に対応する {Groonga::Record} を返す。
  *
- * 0.9.0から値ではなくGroonga::Recordを返すようになった。
+ * 0.9.0から値ではなく {Groonga::Record} を返すようになった。
  *
  * @overload [](key)
  * @return [Groonga::Record]
@@ -592,10 +591,10 @@ rb_grn_table_key_support_set_value (int argc, VALUE *argv, VALUE self)
 }
 
 /*
- * call-seq:
- *   table.default_tokenizer -> nilまたはGroonga::Procedure
+ * {Groonga::IndexColumn} で使用するトークナイザを返す。
  *
- * Groonga::IndexColumnで使用するトークナイザを返す。
+ * @overload default_tokenizer
+ *   @return [nilまたはGroonga::Procedure]
  */
 static VALUE
 rb_grn_table_key_support_get_default_tokenizer (VALUE self)
@@ -617,7 +616,7 @@ rb_grn_table_key_support_get_default_tokenizer (VALUE self)
 }
 
 /*
- * Groonga::IndexColumnで使用するトークナイザを設定する。
+ * {Groonga::IndexColumn} で使用するトークナイザを設定する。
  *
  * @example
  *   # 2-gramを使用。
@@ -660,11 +659,10 @@ rb_grn_table_key_support_set_default_tokenizer (VALUE self, VALUE rb_tokenizer)
 }
 
 /*
- * call-seq:
- *   table.normalize_key? -> true/false
- *
  * キーを正規化する場合は +true+ 、正規化しない場合は +false+ を返
  * す。
+ *
+ * @overload normalize_key?
  */
 static VALUE
 rb_grn_table_key_normalize_key_p (VALUE self)
@@ -679,11 +677,10 @@ rb_grn_table_key_normalize_key_p (VALUE self)
 }
 
 /*
- * call-seq:
- *   table.support_key? -> true/false
- *
  * テーブルでキーを使えるなら +true+ 、使えないなら +false+ を返
- * す。キーを使えないテーブルはGroonga::Arrayだけ。
+ * す。キーを使えないテーブルは {Groonga::Array} だけ。
+ *
+ * @overload support_key?
  */
 static VALUE
 rb_grn_table_key_support_support_key_p (VALUE self)

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

@@ -35,7 +35,7 @@ static ID id_array_set;
  * Document-class: Groonga::Table < Groonga::Object
  *
  * rroongaが提供するテーブルのベースとなるクラス。このクラス
- * からGroonga::Array, Groonga::Hash, Groonga::PatriciaTrie
+ * から {Groonga::Array} , {Groonga::Hash} , {Groonga::PatriciaTrie}
  * が継承されている。
  */
 
@@ -204,10 +204,10 @@ rb_grn_table_inspect_content (VALUE self, VALUE inspected)
 }
 
 /*
- * call-seq:
- *   table.inspect -> String
- *
  * テーブルの中身を人に見やすい文字列で返す。
+ *
+ * @overload inspect
+ *   @return [String]
  */
 static VALUE
 rb_grn_table_inspect (VALUE self)
@@ -240,13 +240,13 @@ rb_grn_table_inspect (VALUE self)
  *     カラムの値の格納方法について指定する。省略した場合は、
  *     +:scalar+ になる。
  *
- *     [+:scalar+] スカラ値(単独の値)を格納する。
- *     [+:vector+] 値の配列を格納する。
+ *     - +:scalar+ := スカラ値(単独の値)を格納する。
+ *     - +:vector+ := 値の配列を格納する。
  *   @option options :compress
  *     値の圧縮方法を指定する。省略した場合は、圧縮しない。
  *
- *     [+:zlib+] 値をzlib圧縮して格納する。
- *     [+:lzo+] 値をlzo圧縮して格納する。
+ *     - +:zlib+ := 値をzlib圧縮して格納する。
+ *     - +:lzo+ := 値をlzo圧縮して格納する。
  *
  * @return [Groonga::FixSizeColumn or Groonga::VariableSizeColumn]
  */
@@ -508,11 +508,11 @@ ruby_object_to_column_name (VALUE rb_name,
 }
 
 /*
- * call-seq:
- *   table.column(name) -> Groonga::Column or nil
- *
  * テーブルの _name_ に対応するカラムを返す。カラムが存在しな
  * い場合は +nil+ を返す。
+ *
+ * @overload column(name)
+ *   @return [Groonga::Column or nil]
  */
 VALUE
 rb_grn_table_get_column (VALUE self, VALUE rb_name)
@@ -589,11 +589,11 @@ rb_grn_table_get_column_surely (VALUE self, VALUE rb_name)
 }
 
 /*
- * call-seq:
- *   table.columns(name=nil) -> Groonga::Columnの配列
- *
  * テーブルの全てのカラムを返す。 _name_ が指定された場合はカ
  * ラム名の先頭が _name_ で始まるカラムを返す。
+ *
+ * @overload columns(name=nil)
+ *   @return [Groonga::Columnの配列]
  */
 static VALUE
 rb_grn_table_get_columns (int argc, VALUE *argv, VALUE self)
@@ -665,10 +665,9 @@ rb_grn_table_get_columns (int argc, VALUE *argv, VALUE self)
 }
 
 /*
- * call-seq:
- *   table.have_column?(name) -> true/false
- *
  * テーブルが _name_ カラムを持っている場合は +true+ を返す。
+ *
+ * @overload have_column?(name)
  */
 static VALUE
 rb_grn_table_have_column (VALUE self, VALUE rb_name)
@@ -788,7 +787,7 @@ rb_grn_table_open_grn_cursor (int argc, VALUE *argv, VALUE self,
  *     +:key+ 指定するとキー順にレコードを取り出す。ただし、
  *     Groonga::PatriciaTrieにしか使えない。（PatriciaTrieのデ
  *     フォルト）
- *   @option options :greater_than The greater_than
+ *   @option options :greater_than
  *     +true+ を指定すると +:min+ で指定した値に一致した [ +key+ ] を
  *     範囲に含まない。
  *   @option options :less_than
@@ -820,7 +819,7 @@ rb_grn_table_open_grn_cursor (int argc, VALUE *argv, VALUE self,
  *     +:key+ 指定するとキー順にレコードを取り出す。ただし、
  *     Groonga::PatriciaTrieにしか使えない。（PatriciaTrieのデ
  *     フォルト）
- *   @option options :greater_than The greater_than
+ *   @option options :greater_than
  *     +true+ を指定すると +:min+ で指定した値に一致した [ +key+ ] を
  *     範囲に含まない。
  *   @option options :less_than
@@ -844,11 +843,11 @@ rb_grn_table_open_cursor (int argc, VALUE *argv, VALUE self)
 }
 
 /*
- * call-seq:
- *   table.records -> Groonga::Recordの配列
- *
  * テーブルに登録されている全てのレコードが入っている配列を
  * 返す。
+ *
+ * @overload records
+ *   @return [Groonga::Recordの配列]
  */
 static VALUE
 rb_grn_table_get_records (int argc, VALUE *argv, VALUE self)
@@ -872,7 +871,7 @@ rb_grn_table_get_records (int argc, VALUE *argv, VALUE self)
  * テーブルに登録されているレコード数を返す。
  *
  * @overload size
- * @return [Integer] レコード数
+ *   @return [Integer]
  */
 static VALUE
 rb_grn_table_get_size (VALUE self)
@@ -890,10 +889,9 @@ rb_grn_table_get_size (VALUE self)
 }
 
 /*
- * call-seq:
- *   table.empty? -> true/false
- *
  * テーブルにレコードが登録されていなければ +true+ を返す。
+ *
+ * @overload empty?
  */
 static VALUE
 rb_grn_table_empty_p (VALUE self)
@@ -911,10 +909,9 @@ rb_grn_table_empty_p (VALUE self)
 }
 
 /*
- * call-seq:
- *   table.truncate
- *
  * テーブルの全レコードを一括して削除する。
+ *
+ * @overload truncate
  */
 static VALUE
 rb_grn_table_truncate (VALUE self)
@@ -934,13 +931,17 @@ rb_grn_table_truncate (VALUE self)
 }
 
 /*
- * call-seq:
- *   table.each             {|record| } -> nil
- *   table.each(options={}) {|record| } -> nil
- *
  * テーブルに登録されているレコードを順番にブロックに渡す。
  *
- * _options_ is the same as #open_cursor's one.
+ * _options_ is the same as {#open_cursor} 's one.
+ *
+ * @overload each
+ *   @!macro [new] table.each.metadata
+ *     @yield [record]
+ *     @return [nil]
+ *   @!macro table.each.metadata
+ * @overload each(options={})
+ *   @!macro table.each.metadata
  */
 static VALUE
 rb_grn_table_each (int argc, VALUE *argv, VALUE self)
@@ -969,10 +970,9 @@ rb_grn_table_each (int argc, VALUE *argv, VALUE self)
 }
 
 /*
- * call-seq:
- *   table.delete(id)
- *
  * テーブルの _id_ に対応するレコードを削除する。
+ *
+ * @overload delete(id)
  */
 VALUE
 rb_grn_table_delete (VALUE self, VALUE rb_id)
@@ -1168,13 +1168,14 @@ rb_grn_table_sort (int argc, VALUE *argv, VALUE self)
 }
 
 /*
- * call-seq:
- *   table.group([key1, key2, ...], options={}) -> [Groonga::Hash, ...]
- *   table.group(key, options={}) -> Groonga::Hash
- *
  * _table_ のレコードを _key1_ , _key2_ , _..._ で指定したキーの
  * 値でグループ化する。多くの場合、キーにはカラムを指定する。
  * カラムはカラム名（文字列）でも指定可能。
+ *
+ * @overload group([key1, key2, ...], options={})
+ *   @return [[Groonga::Hash, ...]]
+ * @overload group(key, options={})
+ *   @return [Groonga::Hash]
  */
 static VALUE
 rb_grn_table_group (int argc, VALUE *argv, VALUE self)
@@ -1268,14 +1269,12 @@ rb_grn_table_group (int argc, VALUE *argv, VALUE self)
 }
 
 /*
- * Document-method: []
- *
- * call-seq:
- *   table[id] -> Groonga::Record
+ * _table_ の _id_ に対応する {Groonga::Record} を返す。
  *
- * _table_ の _id_ に対応するGroonga::Recordを返す。
+ * 0.9.0から値ではなく {Groonga::Record} を返すようになった。
  *
- * 0.9.0から値ではなくGroonga::Recordを返すようになった。
+ * @overload [](id)
+ *   @return [Groonga::Record]
  */
 VALUE
 rb_grn_table_array_reference (VALUE self, VALUE rb_id)
@@ -1310,17 +1309,16 @@ rb_grn_table_get_value (VALUE self, VALUE rb_id)
 }
 
 /*
- * Document-method: value
- *
- * call-seq:
- *   table.value(id) -> 値
- *   table.value(id, :id => true) -> 値
- *
  * _table_ の _id_ に対応する値を返す。
  *
- * <tt>:id => true</tt>が指定できるのは利便性のため。
- * Groonga::ArrayでもGroonga::HashやGroonga::PatriciaTrieと
+ * @:id => true@ が指定できるのは利便性のため。
+ * {Groonga::Array} でも {Groonga::Hash} や {Groonga::PatriciaTrie} と
  * 同じ引数で動くようになる。
+ *
+ * @overload value(id)
+ *   @return [値]
+ * @overload value(id, :id => true)
+ *   @return [値]
  */
 static VALUE
 rb_grn_table_get_value_convenience (int argc, VALUE *argv, VALUE self)
@@ -1370,18 +1368,15 @@ rb_grn_table_set_value (VALUE self, VALUE rb_id, VALUE rb_value)
 }
 
 /*
- * Document-method: set_value
- *
- * call-seq:
- *   table.set_value(id, value)
- *   table.set_value(id, value, :id => true)
- *
  * _table_ の _id_ に対応する値として _value_ 設定する。既存の値は
  * 上書きされる。
  *
- * <tt>:id => true</tt>が指定できるのは利便性のため。
- * Groonga::ArrayでもGroonga::HashやGroonga::PatriciaTrieと
+ * @:id => true@ が指定できるのは利便性のため。
+ * {Groonga::Array} でも {Groonga::Hash} や {Groonga::PatriciaTrie} と
  * 同じ引数で動くようになる。
+ *
+ * @overload set_value(id, value)
+ * @overload set_value(id, value, :id => true)
  */
 static VALUE
 rb_grn_table_set_value_convenience (int argc, VALUE *argv, VALUE self)
@@ -1423,17 +1418,16 @@ rb_grn_table_get_column_value (VALUE self, VALUE rb_id, VALUE rb_name)
 }
 
 /*
- * Document-method: column_value
- *
- * call-seq:
- *   table.column_value(id, name) -> 値
- *   table.column_value(id, name, :id => true) -> 値
- *
  * _table_ の _id_ に対応するカラム _name_ の値を返す。
  *
- * <tt>:id => true</tt>が指定できるのは利便性のため。
- * Groonga::ArrayでもGroonga::HashやGroonga::PatriciaTrieと
+ * @:id => true@ が指定できるのは利便性のため。
+ * {Groonga::Array} でも {Groonga::Hash} や {Groonga::PatriciaTrie} と
  * 同じ引数で動くようになる。
+ *
+ * @overload column_value(id, name)
+ *   @return [値]
+ * @overload column_value(id, name, :id => true)
+ *   @return [値]
  */
 static VALUE
 rb_grn_table_get_column_value_convenience (int argc, VALUE *argv, VALUE self)
@@ -1479,18 +1473,15 @@ rb_grn_table_set_column_value (VALUE self, VALUE rb_id,
 }
 
 /*
- * Document-method: set_column_value
- *
- * call-seq:
- *   table.set_column_value(id, name, value)
- *   table.set_column_value(id, name, value, :id => true)
- *
  * _table_ の _id_ に対応するカラム _name_ の値として _value_ 設定す
  * る。既存の値は上書きされる。
  *
- * <tt>:id => true</tt>が指定できるのは利便性のため。
- * Groonga::ArrayでもGroonga::HashやGroonga::PatriciaTrieと
+ * @:id => true@ が指定できるのは利便性のため。
+ * {Groonga::Array} でも {Groonga::Hash} や {Groonga::PatriciaTrie} と
  * 同じ引数で動くようになる。
+ *
+ * @overload set_column_value(id, name, value)
+ * @overload set_column_value(id, name, valuf, :id => true)
  */
 static VALUE
 rb_grn_table_set_column_value_convenience (int argc, VALUE *argv, VALUE self)
@@ -1516,18 +1507,14 @@ rb_grn_table_set_column_value_convenience (int argc, VALUE *argv, VALUE self)
 }
 
 /*
- * Document-method: unlock
- *
- * call-seq:
- *   table.unlock(options={})
- *
  * _table_ のロックを解除する。
  *
- * 利用可能なオプションは以下の通り。
- *
- * [ _:id_ ]
- *   _:id_ で指定したレコードのロックを解除する。（注:
- *   groonga側が未実装のため、現在は無視される）
+ * @overload unlock(options={})
+ *   @param options [::Hash] The name and value
+ *     pairs. Omitted names are initialized as the default value.
+ *   @option options :id
+ *     _:id_ で指定したレコードのロックを解除する。（注:
+ *     groonga側が未実装のため、現在は無視される）
  */
 static VALUE
 rb_grn_table_unlock (int argc, VALUE *argv, VALUE self)
@@ -1567,7 +1554,7 @@ rb_grn_table_unlock_ensure (VALUE self)
 
 /*
  * _table_ をロックする。ロックに失敗した場合は
- * Groonga::ResourceDeadlockAvoided例外が発生する。
+ * {Groonga::ResourceDeadlockAvoided} 例外が発生する。
  *
  * ブロックを指定した場合はブロックを抜けたときにunlockする。
  *
@@ -1712,8 +1699,8 @@ rb_grn_table_is_locked (int argc, VALUE *argv, VALUE self)
  * _table_ からブロックまたは文字列で指定した条件にマッチする
  * レコードを返す。返されたテーブルには +expression+ という特
  * 異メソッドがあり、指定した条件を表している
- * Groonga::Expressionを取得できる。
- * Groonga::Expression#snippetを使うことにより、指定した条件
+ * {Groonga::Expression} を取得できる。
+ * {Groonga::Expression#snippet} を使うことにより、指定した条件
  * 用のスニペットを簡単に生成できる。
  *
  * <pre>
@@ -1765,49 +1752,53 @@ rb_grn_table_is_locked (int argc, VALUE *argv, VALUE self)
  *       # => ["Hello Good-bye!", "Hello World"]
  *     </pre>
  *
- *   @param options [::Hash] The name and value
- *     pairs. Omitted names are initialized as the default value.
- *   @option options :default_column
- *     "column_name:hoge"ではなく"hoge"のようにcolumn_nameが指
- *     定されない条件の検索対象となるカラムを指定する。
- *   @option options :operator (Groonga::Operator::OR)
- *     マッチしたレコードをどのように扱うか。指定可能な値は以
- *     下の通り。省略した場合は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
- *     query構文時にカラム指定を利用するかどうか。省略した場合
- *     は利用する。
- *
- *     参考: Groonga::Expression#parse.
- *   @option options :allow_update
- *     script構文時に更新操作を利用するかどうか。省略した場合
- *     は利用する。
- *
- *     参考: Groonga::Expression#parse.
+ *   @!macro [new] table.select.options
+ *     @param options [::Hash] The name and value
+ *       pairs. Omitted names are initialized as the default value.
+ *     @option options :default_column
+ *       "column_name:hoge"ではなく"hoge"のようにcolumn_nameが指
+ *       定されない条件の検索対象となるカラムを指定する。
+ *     @option options :operator (Groonga::Operator::OR)
+ *       マッチしたレコードをどのように扱うか。指定可能な値は以
+ *       下の通り。省略した場合は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
+ *       query構文時にカラム指定を利用するかどうか。省略した場合
+ *       は利用する。
+ *
+ *       参考: {Groonga::Expression#parse} .
+ *
+ *     @option options :allow_update
+ *       script構文時に更新操作を利用するかどうか。省略した場合
+ *       は利用する。
+ *
+ *     参考: {Groonga::Expression#parse} .
  *
  * @overload select(query, options)
  *   _query_ には「[カラム名]:[演算子][値]」という書式で条件を
@@ -1830,96 +1821,11 @@ rb_grn_table_is_locked (int argc, VALUE *argv, VALUE self)
  *                          # "groonga"を含んでいるレコードにマッチ
  *   </pre>
  *
- *   @param options [::Hash] The name and value
- *     pairs. Omitted names are initialized as the default value.
- *   @option options :default_column
- *     "column_name:hoge"ではなく"hoge"のようにcolumn_nameが指
- *     定されない条件の検索対象となるカラムを指定する。
- *   @option options :operator (Groonga::Operator::OR)
- *     マッチしたレコードをどのように扱うか。指定可能な値は以
- *     下の通り。省略した場合は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
- *     query構文時にカラム指定を利用するかどうか。省略した場合
- *     は利用する。
- *
- *     参考: Groonga::Expression#parse.
- *   @option options :allow_update
- *     script構文時に更新操作を利用するかどうか。省略した場合
- *     は利用する。
- *
- *     参考: Groonga::Expression#parse.
- *
+ *   @!macro table.select.options
  * @overload select(expression, options)
- *   _expression_ には既に作成済みのGroonga::Expressionを渡す
+ *   _expression_ には既に作成済みの {Groonga::Expression} を渡す。
  *
- *   @param options [::Hash] The name and value
- *     pairs. Omitted names are initialized as the default value.
- *   @option options :default_column
- *     "column_name:hoge"ではなく"hoge"のようにcolumn_nameが指
- *     定されない条件の検索対象となるカラムを指定する。
- *   @option options :operator (Groonga::Operator::OR)
- *     マッチしたレコードをどのように扱うか。指定可能な値は以
- *     下の通り。省略した場合は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
- *     query構文時にカラム指定を利用するかどうか。省略した場合
- *     は利用する。
- *
- *     参考: Groonga::Expression#parse.
- *   @option options :allow_update
- *     script構文時に更新操作を利用するかどうか。省略した場合
- *     は利用する。
- *
- *     参考: Groonga::Expression#parse.
+ *   @!macro table.select.options
  * @return [Groonga::Hash]
  */
 static VALUE
@@ -1930,7 +1836,7 @@ rb_grn_table_select (int argc, VALUE *argv, VALUE self)
     grn_operator operator = GRN_OP_OR;
     VALUE rb_query = Qnil, condition_or_options, 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 rb_default_column;
     VALUE rb_expression = Qnil, builder;
 
@@ -1964,6 +1870,7 @@ rb_grn_table_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,
 			"default_column", &rb_default_column,
 			NULL);
 
@@ -1987,6 +1894,7 @@ rb_grn_table_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_funcall(builder, rb_intern("default_column="), 1, rb_default_column);
       rb_expression = rb_grn_record_expression_builder_build(builder);
     }
@@ -2030,12 +1938,11 @@ rb_grn_table_set_operation_bang (VALUE self, VALUE rb_other,
 }
 
 /*
- * call-seq:
- *   table.union!(other) -> Groonga::Table
- *
  * キーを比較し、 _table_ には登録されていない _other_ のレコー
  * ドを _table_ に作成する。
  *
+ * @overload union!(other)
+ *   @return [Groonga::Table]
  */
 static VALUE
 rb_grn_table_union_bang (VALUE self, VALUE rb_other)
@@ -2045,12 +1952,11 @@ rb_grn_table_union_bang (VALUE self, VALUE rb_other)
 
 
 /*
- * call-seq:
- *   table.intersection!(other) -> Groonga::Table
- *
  * キーを比較し、 _other_ には登録されていないレコードを
  * _table_ から削除する。
  *
+ * @overload intersection!(other)
+ *   @return [Groonga::Table]
  */
 static VALUE
 rb_grn_table_intersection_bang (VALUE self, VALUE rb_other)
@@ -2059,12 +1965,11 @@ rb_grn_table_intersection_bang (VALUE self, VALUE rb_other)
 }
 
 /*
- * call-seq:
- *   table.difference!(other) -> Groonga::Table
- *
  * キーを比較し、 _other_ にも登録されているレコードを _table_
  * から削除する。
  *
+ * @overload difference!(other)
+ *   @return [Groonga::Table]
  */
 static VALUE
 rb_grn_table_difference_bang (VALUE self, VALUE rb_other)
@@ -2073,12 +1978,11 @@ rb_grn_table_difference_bang (VALUE self, VALUE rb_other)
 }
 
 /*
- * call-seq:
- *   table.merge!(other) -> Groonga::Table
- *
  * キーを比較し、 _other_ にも登録されている _table_ のレコード
  * のスコアを _other_ のスコアと同値にする。
  *
+ * @overload merge!(other)
+ *   @return [Groonga::Table]
  */
 static VALUE
 rb_grn_table_merge_bang (VALUE self, VALUE rb_other)
@@ -2087,11 +1991,10 @@ rb_grn_table_merge_bang (VALUE self, VALUE rb_other)
 }
 
 /*
- * call-seq:
- *   table.support_key? -> true/false
- *
  * _table_ に主キーが設定されていれば +true+ 、されていなければ
  * +false+ を返す。
+ *
+ * @overload support_key?
  */
 static VALUE
 rb_grn_table_support_key_p (VALUE self)
@@ -2100,12 +2003,11 @@ rb_grn_table_support_key_p (VALUE self)
 }
 
 /*
- * call-seq:
- *   table.support_sub_records? -> true/false
- *
  * グループ化したとき、テーブルにグループに含まれるレコード
  * 数を格納できる場合は +true+ 、格納できない場合は +false+ を返
  * す。
+ *
+ * @overload support_sub_records?
  */
 static VALUE
 rb_grn_table_support_sub_records_p (VALUE self)
@@ -2120,14 +2022,13 @@ rb_grn_table_support_sub_records_p (VALUE self)
 }
 
 /*
- * call-seq:
- *   table.exist?(id) -> true/false
- *
  * _table_ に _id_ で指定したIDのレコードが存在する場合は +true+ 、
  * 存在しない場合は +false+ を返す。
  *
  * 注意: 実行には相応のコストがかかるのであまり頻繁に呼ばな
  * いようにして下さい。
+ *
+ * @overload exist?(id)
  */
 static VALUE
 rb_grn_table_exist_p (VALUE self, VALUE id)
@@ -2183,15 +2084,11 @@ rb_grn_table_defrag (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
+ *   @since 1.3.0
  */
 static VALUE
 rb_grn_table_rename (VALUE self, VALUE rb_name)