rroonga 1.2.9 → 1.3.0

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

@@ -1,4 +1,4 @@
-/* -*- c-file-style: "ruby" -*- */
+/* -*- coding: utf-8; c-file-style: "ruby" -*- */
 /*
   Copyright (C) 2009  Kouhei Sutou <kou@clear-code.com>
 
@@ -132,17 +132,17 @@ rb_grn_operator_from_ruby_object (VALUE rb_operator)
  * call-seq:
  *   query.new(string, options={})
  *
- * _string_をパースした上で、クエリを作成する。作成されたオ
+ * _string_ をパースした上で、クエリを作成する。作成されたオ
  * ブジェクトはGroonga::IndexColumn#searchに渡すことで使用す
  * ることができる。
  *
- * _options_に指定可能な値は以下の通り。
+ * _options_ に指定可能な値は以下の通り。
+ * @param options [::Hash] The name and value
+ *   pairs. Omitted names are initialized as the default value.
+ * @option options :context (Groonga::Context.default) The context
+ *   クエリが利用するGroonga::Context。
  *
- * [+:context+]
- *   クエリが利用するGroonga::Context。省略すると
- *   Groonga::Context.defaultを用いる。
- *
- * [+:default_operator+]
+ * @option options :default_operator The default_operator
  *   演算子の既定値(演算子を省略した場合にどの演算を行うか)
  *   を指定する。
  *
@@ -153,7 +153,7 @@ rb_grn_operator_from_ruby_object (VALUE rb_operator)
  *     (FIXME: 挙動の違いを検証する必要性あり?
  *            Groonga::Expressionとの関連性は?)
  *
- * [+:max_expressions+]
+ * @option options :max_expressions
  *   検索クエリに指定する式の最大値を指定する。
  */
 static VALUE
@@ -206,7 +206,7 @@ rb_grn_query_initialize (int argc, VALUE *argv, VALUE self)
  * call-seq:
  *   query.close
  *
- * _query_が使用しているリソースを開放する。これ以降_query_を
+ * _query_ が使用しているリソースを開放する。これ以降 _query_ を
  * 使うことはできない。
  */
 static VALUE
@@ -230,8 +230,8 @@ rb_grn_query_close (VALUE self)
  * call-seq:
  *   query.closed? -> true/false
  *
- * _query_が開放済みの場合は+true+を返し、そうでない場合は
- * +false+を返す。
+ * _query_ が開放済みの場合は +true+ を返し、そうでない場合は
+ * +false+ を返す。
  */
 static VALUE
 rb_grn_query_closed_p (VALUE self)

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

@@ -1,4 +1,4 @@
-/* -*- c-file-style: "ruby" -*- */
+/* -*- coding: utf-8; c-file-style: "ruby" -*- */
 /*
   Copyright (C) 2009-2011  Kouhei Sutou <kou@clear-code.com>
 

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

@@ -1,4 +1,4 @@
-/* -*- c-file-style: "ruby" -*- */
+/* -*- coding: utf-8; c-file-style: "ruby" -*- */
 /*
   Copyright (C) 2009-2010  Kouhei Sutou <kou@clear-code.com>
 
@@ -103,35 +103,39 @@ rb_grn_snippet_alloc (VALUE klass)
  * call-seq:
  *   Groonga::Snippet.new(options={})
  *
- * スニペットを作成する。_options_に指定可能な値は以下の通
+ * スニペットを作成する。 _options_ に指定可能な値は以下の通
  * り。
+ * @param options [::Hash] The name and value
+ *   pairs. Omitted names are initialized as the default value.
+ * @option options :context (Groonga::Context.default) The context
  *
- * [+:context+]
  *   スキーマ作成時に使用するGroonga::Contextを指定する。
- *   省略した場合はGroonga::Context.defaultを使用する。
  *
- * [+:normalize+]
+ * @option options :normalize The normalize
+ *
  *   キーワード文字列・スニペット元の文字列を正規化するかど
- *   うか。省略した場合は+false+で正規化しない。
+ *   うか。省略した場合は +false+ で正規化しない。
+ *
+ * @option options :skip_leading_spaces (false) The skip_leading_spaces
  *
- * [+:skip_leading_spaces+]
- *   先頭の空白を無視するかどうか。省略した場合は+false+で無
+ *   先頭の空白を無視するかどうか。省略した場合は で無
  *   視しない。
  *
- * [+:width+]
+ * @option options :width (100) The width
+ *
  *   スニペット文字列の長さ。省略した場合は100文字。
  *
- * [+:max_results+]
+ * @option options :max_results (3) The max_results
  *   生成するスニペットの最大数。省略した場合は3。
  *
- * [+:html_escape+]
+ * @option options :html_escape (false) The html_escape
  *   スニペット内の+<+, +>+, +&+, +"+をHTMLエスケープするか
  *   どうか。省略した場合は+false+で、HTMLエスケープしない。
  *
- * [+:default_open_tag+]
+ * @option options :default_open_tag ("") The default_open_tag
  *   デフォルトの開始タグ。省略した場合は""(空文字列)
  *
- * [+:default_close_tag+]
+ * @option options :default_close_tag ("") The default_close_tag
  *   デフォルトの終了タグ。省略した場合は""(空文字列)
  */
 static VALUE
@@ -213,14 +217,17 @@ rb_grn_snippet_initialize (int argc, VALUE *argv, VALUE self)
  * call-seq:
  *   snippet.add_keyword(keyword, options={})
  *
- * _keyword_を追加する。_options_に指定可能な値は以下の通
- * り。
+ * _keyword_ を追加する。 _options_ に指定可能な値は
+ * 以下の通り。
+ * @param options [::Hash] The name and value
+ *   pairs. Omitted names are initialized as the default value.
+ * @option options :open_tag (default_open_tag) The open_tag
  *
- * [+:open_tag+]
  *   開始タグ。省略した場合はGroonga::Snippet.newで指定し
  *   た+:default_open_tag+。
  *
- * [+:close_tag+]
+ * @option options :close_tag (:default_close_tag) The close_tag
+ *
  *   終了タグ。省略した場合はGroonga::Snippet.newで指定し
  *   た+:default_close_tag+。
  */
@@ -276,7 +283,7 @@ rb_grn_snippet_add_keyword (int argc, VALUE *argv, VALUE self)
  * call-seq:
  *   snippet.execute(string) -> スニペットの配列
  *
- * _string_を走査し、スニペットを作成する。
+ * _string_ を走査し、スニペットを作成する。
  */
 static VALUE
 rb_grn_snippet_execute (VALUE self, VALUE rb_string)
@@ -339,7 +346,7 @@ rb_grn_snippet_execute (VALUE self, VALUE rb_string)
  * call-seq:
  *   snippet.close
  *
- * _snippet_が使用しているリソースを開放する。これ以降_snippet_を
+ * _snippet_ が使用しているリソースを開放する。これ以降 _snippet_ を
  * 使うことはできない。
  */
 static VALUE

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

@@ -1,4 +1,4 @@
-/* -*- c-file-style: "ruby" -*- */
+/* -*- coding: utf-8; c-file-style: "ruby" -*- */
 /*
   Copyright (C) 2009  Kouhei Sutou <kou@clear-code.com>
 

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

@@ -1,4 +1,4 @@
-/* -*- c-file-style: "ruby" -*- */
+/* -*- coding: utf-8; c-file-style: "ruby" -*- */
 /*
   Copyright (C) 2009-2011  Kouhei Sutou <kou@clear-code.com>
 
@@ -270,8 +270,8 @@ rb_grn_table_cursor_each (VALUE self)
  * call-seq:
  *   cursor.closed? -> true/false
  *
- * カーソルが開放済みの場合は+true+を返し、そうでない場合は
- * +false+を返す。
+ * カーソルが開放済みの場合は +true+ を返し、そうでない場合は
+ * +false+ を返す。
  */
 
 void
@@ -303,5 +303,6 @@ rb_grn_init_table_cursor (VALUE mGrn)
     rb_grn_init_array_cursor(mGrn);
     rb_grn_init_hash_cursor(mGrn);
     rb_grn_init_patricia_trie_cursor(mGrn);
+    rb_grn_init_double_array_trie_cursor(mGrn);
     rb_grn_init_view_cursor(mGrn);
 }

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

@@ -1,4 +1,4 @@
-/* -*- c-file-style: "ruby" -*- */
+/* -*- coding: utf-8; c-file-style: "ruby" -*- */
 /*
   Copyright (C) 2009-2011  Kouhei Sutou <kou@clear-code.com>
 
@@ -113,16 +113,16 @@ 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+を返す。
+ * 主キーが _key_ のレコード追加し、追加したレコードを返す。レ
+ * コードの追加に失敗した場合は +nil+ を返す。
  *
  * すでに同じキーのレコードが存在する場合は追加せずに同じレ
  * コードを返す。追加されたかどうかは
- * +Groonga::Record#added?+で調べることができる。+true+を返
+ * +Groonga::Record#added?+ で調べることができる。 +true+ を返
  * したら追加されたということを示す。
  *
- * _values_にはレコードのカラムに設定する値を指定する。省略
- * した場合または+nil+を指定した場合はカラムは設定しない。カ
+ * _values_ にはレコードのカラムに設定する値を指定する。省略
+ * した場合または +nil+ を指定した場合はカラムは設定しない。カ
  * ラムの値は<tt>{:カラム名1 => 値1, :カラム名2 => 値2,
  * ...}</tt>と指定する。
  */
@@ -172,9 +172,9 @@ rb_grn_table_key_support_get (VALUE self, VALUE rb_key)
  *   table.id -> テーブルID
  *   table.id(key) -> レコードID
  *
- * _key_を指定しない場合はテーブルのIDを返す。
+ * _key_ を指定しない場合はテーブルのIDを返す。
  *
- * _key_を指定した場合はテーブルの_key_に対応するレコードの
+ * _key_ を指定した場合はテーブルの _key_ に対応するレコードの
  * IDを返す。
  */
 static VALUE
@@ -201,7 +201,7 @@ rb_grn_table_key_support_get_id (int argc, VALUE *argv, VALUE self)
  * call-seq:
  *   table.key(id) -> 主キー
  *
- * テーブルの_id_に対応する主キーを返す。
+ * テーブルの _id_ に対応する主キーを返す。
  */
 static VALUE
 rb_grn_table_key_support_get_key (VALUE self, VALUE rb_id)
@@ -237,7 +237,7 @@ rb_grn_table_key_support_get_key (VALUE self, VALUE rb_id)
  * call-seq:
  *   table.has_key?(key) -> true/false
  *
- * テーブルに主キーが_key_のレコードがあるならtrueを返す。
+ * テーブルに主キーが _key_ のレコードがあるならtrueを返す。
  */
 static VALUE
 rb_grn_table_key_support_has_key (VALUE self, VALUE rb_key)
@@ -287,7 +287,7 @@ rb_grn_table_key_support_delete_by_key (VALUE self, VALUE rb_key)
  *   table.delete(id)
  *   table.delete(key)
  *
- * テーブルの_id_または_key_に対応するレコードを削除する。
+ * テーブルの _id_ または _key_ に対応するレコードを削除する。
  */
 static VALUE
 rb_grn_table_key_support_delete (VALUE self, VALUE rb_id_or_key)
@@ -305,7 +305,7 @@ rb_grn_table_key_support_delete (VALUE self, VALUE rb_id_or_key)
  * call-seq:
  *   table[key] -> Groonga::Record
  *
- * _table_の_key_に対応するGroonga::Recordを返す。
+ * _table_ の _key_ に対応するGroonga::Recordを返す。
  *
  * 0.9.0から値ではなくGroonga::Recordを返すようになった。
  */
@@ -357,8 +357,8 @@ set_value (VALUE args, SetValueData *data)
  * call-seq:
  *   table[key] = {:column_name => value, ...}
  *
- * _table_の_key_に対応するカラム_column_name_の値を設定する。
- * _key_に対応するレコードがない場合は新しく作成される。
+ * _table_ の _key_ に対応するカラム _column_name_ の値を設定する。
+ * _key_ に対応するレコードがない場合は新しく作成される。
  *
  * 0.9.0から値ではなくカラムの値を設定するようになった。
  */
@@ -397,8 +397,8 @@ rb_grn_table_key_support_array_set (VALUE self, VALUE rb_key, VALUE rb_values)
  *   table.set_column_value(key, name, value)
  *   table.set_column_value(id, name, value, :id => true)
  *
- * _table_の_key_に対応するカラム_name_の値を設定する。
- * _key_に対応するレコードがない場合は新しく作成される。
+ * _table_ の _key_ に対応するカラム _name_ の値を設定する。
+ * _key_ に対応するレコードがない場合は新しく作成される。
  */
 static VALUE
 rb_grn_table_key_support_set_column_value (int argc, VALUE *argv, VALUE self)
@@ -437,9 +437,9 @@ rb_grn_table_key_support_set_column_value (int argc, VALUE *argv, VALUE self)
  *   table.column_value(key, name)
  *   table.column_value(id, name, :id => true)
  *
- * _table_の_key_に対応するカラム_name_の値を設定する。
+ * _table_ の _key_ に対応するカラム _name_ の値を設定する。
  *
- * TODO: _key_に対応するレコードがない場合は例外？
+ * TODO: _key_ に対応するレコードがない場合は例外？
  */
 static VALUE
 rb_grn_table_key_support_get_column_value (int argc, VALUE *argv, VALUE self)
@@ -496,7 +496,7 @@ rb_grn_table_key_support_get_value_by_key (VALUE self, VALUE rb_key)
  *   table.value(id, :id => true) -> 値
  *   table.value(key) -> 値
  *
- * _table_の_id_または_key_に対応する値を返す。
+ * _table_ の _id_ または _key_ に対応する値を返す。
  */
 static VALUE
 rb_grn_table_key_support_get_value (int argc, VALUE *argv, VALUE self)
@@ -566,7 +566,7 @@ rb_grn_table_key_support_set_value_by_key (VALUE self,
  *   table.set_value(id, value, :id => true)
  *   table.set_value(key, value)
  *
- * _table_の_id_または_key_に対応する値を_value_に設定する。
+ * _table_ の _id_ または _key_ に対応する値を _value_ に設定する。
  * 既存の値は上書きされる。
  */
 static VALUE
@@ -628,7 +628,7 @@ rb_grn_table_key_support_get_default_tokenizer (VALUE self)
  *
  * Groonga::IndexColumnで使用するトークナイザを設定する。
  *
- * 例:
+ * @example
  *   # 2-gramを使用。
  *   table.default_tokenizer = "TokenBigram"
  *   # オブジェクトで指定
@@ -670,7 +670,7 @@ rb_grn_table_key_support_set_default_tokenizer (VALUE self, VALUE rb_tokenizer)
  * call-seq:
  *   table.normalize_key? -> true/false
  *
- * キーを正規化する場合は+true+、正規化しない場合は+false+を返
+ * キーを正規化する場合は +true+ 、正規化しない場合は +false+ を返
  * す。
  */
 static VALUE
@@ -689,7 +689,7 @@ rb_grn_table_key_normalize_key_p (VALUE self)
  * call-seq:
  *   table.support_key? -> true/false
  *
- * テーブルでキーを使えるなら+true+、使えないなら+false+を返
+ * テーブルでキーを使えるなら +true+ 、使えないなら +false+ を返
  * す。キーを使えないテーブルはGroonga::Arrayだけ。
  */
 static VALUE

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

@@ -1,4 +1,4 @@
-/* -*- c-file-style: "ruby" -*- */
+/* -*- coding: utf-8; c-file-style: "ruby" -*- */
 /*
   Copyright (C) 2009-2011  Kouhei Sutou <kou@clear-code.com>
 
@@ -228,27 +228,28 @@ rb_grn_table_inspect (VALUE self)
  *   table.define_column(name, value_type, options={}) ->
  *     Groonga::FixSizeColumnかGroonga::VariableSizeColumn
  *
- * テーブルに名前が_name_で型が_value_type_のカラムを定義
+ * テーブルに名前が _name_ で型が _value_type_ のカラムを定義
  * し、新しく定義されたカラムを返す。
  *
- * _options_に指定可能な値は以下の通り。
- *
- * [+:path+]
+ * _options_ に指定可能な値は以下の通り。
+ * @param options [::Hash] The name and value
+ *   pairs. Omitted names are initialized as the default value.
+ * @option options :path The path
  *   カラムを保存するパス。
  *
- * [+:persistent+]
- *   +true+を指定すると永続カラムとなる。省略した場合は永
- *   続カラムとなる。+:path+を省略した場合は自動的にパスが
+ * @option options :persistent (永続カラム) The persistent
+ *   +true+ を指定すると永続カラムとなる。省略した場合は永
+ *   続カラムとなる。 +:path+ を省略した場合は自動的にパスが
  *   付加される。
  *
- * [+:type+]
+ * @option options :type (:scalar) The type
  *   カラムの値の格納方法について指定する。省略した場合は、
- *   +:scalar+になる。
+ *   +:scalar+ になる。
  *
  *   [+:scalar+] スカラ値(単独の値)を格納する。
  *   [+:vector+] 値の配列を格納する。
  *
- * [+:compress+]
+ * @param options :compress The compress
  *   値の圧縮方法を指定する。省略した場合は、圧縮しない。
  *
  *   [+:zlib+] 値をzlib圧縮して格納する。
@@ -366,33 +367,34 @@ n_gram_tokenizer_p(grn_ctx *context, grn_obj *tokenizer)
  * call-seq:
  *   table.define_index_column(name, value_type, options={}) -> Groonga::IndexColumn
  *
- * テーブルに名前が_name_で型が_value_type_のインデックスカ
+ * テーブルに名前が _name_ で型が _value_type_ のインデックスカ
  * ラムを定義し、新しく定義されたカラムを返す。
  *
- * _options_に指定可能な値は以下の通り。
- *
- * [+:path+]
+ * _options_ に指定可能な値は以下の通り。
+ * @param options [::Hash] The name and value
+ *   pairs. Omitted names are initialized as the default value.
+ * @option options :path The path
  *   カラムを保存するパス。
  *
- * [+:persistent+]
- *   +true+を指定すると永続カラムとなる。省略した場合は永
- *   続カラムとなる。+:path+を省略した場合は自動的にパスが
+ * @option options :persistent (永続カラム) The persistent
+ *   +true+ を指定すると永続カラムとなる。省略した場合は永
+ *   続カラムとなる。 +:path+ を省略した場合は自動的にパスが
  *   付加される。
  *
- * [+:with_section+]
+ * @option options :with_section The with_section
  *   転置索引にsection(段落情報)を合わせて格納する。
  *
- * [+:with_weight+]
+ * @option options :with_weight  The with_weight
  *   転置索引にweight情報を合わせて格納する。
  *
- * [+:with_position+]
+ * @option options :with_position The with_position
  *   転置索引に出現位置情報を合わせて格納する。
  *
- * [+:source+]
- *  インデックス対象となるカラムを指定する。+:sources+との併用はできない。
+ * @option options :source The source
+ *  インデックス対象となるカラムを指定する。 +:sources+ との併用はできない。
  *
- * [+:sources+]
- *  インデックス対象となる複数のカラムを指定する。+:source+との併用はできない。
+ * @option options :sources The sources
+ *  インデックス対象となる複数のカラムを指定する。 +:source+ との併用はできない。
  */
 static VALUE
 rb_grn_table_define_index_column (int argc, VALUE *argv, VALUE self)
@@ -521,8 +523,8 @@ ruby_object_to_column_name (VALUE rb_name,
  * call-seq:
  *   table.column(name) -> Groonga::Column or nil
  *
- * テーブルの_name_に対応するカラムを返す。カラムが存在しな
- * い場合は+nil+を返す。
+ * テーブルの _name_ に対応するカラムを返す。カラムが存在しな
+ * い場合は +nil+ を返す。
  */
 VALUE
 rb_grn_table_get_column (VALUE self, VALUE rb_name)
@@ -602,8 +604,8 @@ rb_grn_table_get_column_surely (VALUE self, VALUE rb_name)
  * call-seq:
  *   table.columns(name=nil) -> Groonga::Columnの配列
  *
- * テーブルの全てのカラムを返す。_name_が指定された場合はカ
- * ラム名の先頭が_name_で始まるカラムを返す。
+ * テーブルの全てのカラムを返す。 _name_ が指定された場合はカ
+ * ラム名の先頭が _name_ で始まるカラムを返す。
  */
 static VALUE
 rb_grn_table_get_columns (int argc, VALUE *argv, VALUE self)
@@ -670,7 +672,7 @@ rb_grn_table_get_columns (int argc, VALUE *argv, VALUE self)
  * call-seq:
  *   table.have_column?(name) -> true/false
  *
- * テーブルが_name_カラムを持っている場合は+true+を返す。
+ * テーブルが _name_ カラムを持っている場合は +true+ を返す。
  */
 static VALUE
 rb_grn_table_have_column (VALUE self, VALUE rb_name)
@@ -769,43 +771,44 @@ rb_grn_table_open_grn_cursor (int argc, VALUE *argv, VALUE self,
  * カーソルが破棄される。
  *
  * _options_に指定可能な値は以下の通り。
- *
- * [+:min+]
+ * @param options [::Hash] The name and value
+ *   pairs. Omitted names are initialized as the default value.
+ * @option options :min The min
  *  キーの下限
  *
- * [+:max+]
+ * @option  options :max The max
  *  キーの上限
  *
- * [+:offset+]
- *   該当する範囲のレコードのうち、(0ベースで)_:offset_番目
+ * @option options :offset The offset
+ *   該当する範囲のレコードのうち、(0ベースで) _:offset_ 番目
  *   からレコードを取り出す。
  *
- * [+:limit+]
- *   該当する範囲のレコードのうち、_:limit_件のみを取り出す。
+ * @option options :limit The limit
+ *   該当する範囲のレコードのうち、 _:limit_ 件のみを取り出す。
  *   省略された場合または-1が指定された場合は、全件が指定され
  *   たものとみなす。
  *
- * [+:order+]
- *   +:asc+または+:ascending+を指定すると昇順にレコードを取
+ * @option options :order (asc) The order
+ *   +:asc+ または +:ascending+ を指定すると昇順にレコードを取
  *   り出す。（デフォルト）
  *
- *   +:desc+または+:descending+を指定すると降順にレコードを
+ *   +:desc+ または +:descending+ を指定すると降順にレコードを
  *   取り出す。
  *
- * [+:order_by+]
- *   +:id+を指定するとID順にレコードを取り出す。（Arrayと
+ * @option options :order_by The order_by
+ *   +:id+ を指定するとID順にレコードを取り出す。（Arrayと
  *   Hashのデフォルト）
  *
- *   +:key+指定するとキー順にレコードを取り出す。ただし、
+ *   +:key+ 指定するとキー順にレコードを取り出す。ただし、
  *   Groonga::PatriciaTrieにしか使えない。（PatriciaTrieのデ
  *   フォルト）
  *
- * [+:greater_than+]
- *   +true+を指定すると+:min+で指定した値に一致した[+key+]を
+ * @option options :greater_than The greater_than
+ *   +true+ を指定すると +:min+ で指定した値に一致した [ +key+ ] を
  *   範囲に含まない。
  *
- * [+:less_than+]
- *   +true+を指定すると+:max+で指定した値に一致した[+key+]を
+ * @option options :less_than The less_than
+ *   +true+ を指定すると +:max+ で指定した値に一致した [ +key+ ] を
  *   範囲に含まない。
  */
 static VALUE
@@ -874,7 +877,7 @@ rb_grn_table_get_size (VALUE self)
  * call-seq:
  *   table.empty? -> true/false
  *
- * テーブルにレコードが登録されていなければ+true+を返す。
+ * テーブルにレコードが登録されていなければ +true+ を返す。
  */
 static VALUE
 rb_grn_table_empty_p (VALUE self)
@@ -888,7 +891,7 @@ rb_grn_table_empty_p (VALUE self)
 			     NULL, NULL, NULL,
 			     NULL);
     size = grn_table_size(context, table);
-    return size == 0;
+    return CBOOL2RVAL(size == 0);
 }
 
 /*
@@ -953,7 +956,7 @@ rb_grn_table_each (VALUE self)
  * call-seq:
  *   table.delete(id)
  *
- * テーブルの_id_に対応するレコードを削除する。
+ * テーブルの _id_ に対応するレコードを削除する。
  */
 VALUE
 rb_grn_table_delete (VALUE self, VALUE rb_id)
@@ -982,41 +985,50 @@ rb_grn_table_delete (VALUE self, VALUE rb_id)
  * テーブルに登録されているレコードを_keys_で指定されたルー
  * ルに従ってソートしたレコードの配列を返す。
  *
- * _order_には+:asc+, +:ascending+, +:desc+, +:descending+の
+ * _order_ には +:asc+ ,  +:ascending+ , +:desc+ , +:descending+ の
  * いずれを指定する。
  *
- * [ハッシュの配列で指定する方法]
- *   オーソドックスな指定方法。
- *
- *     [
- *      {:key => "第1ソートキー", :order => order},
- *      {:key => "第2ソートキー", :order => order},
- *      ...,
- *     ]
- *
- * [配列の配列で指定する方法]
- *   少し簡単化した指定方法。
- *
- *     [
- *      ["第1ソートキー", order],
- *      ["第2ソートキー", order],
- *      ...,
- *     ]
- *
- * [ソートキーの配列で指定する方法]
- *   _order_は常に昇順（+:ascending+）になるが、最も簡単
- *   に指定できる。
- *
- *     ["第1ソートキー", "第2ソートキー", ...]
- *
- * _options_に指定可能な値は以下の通り。
- *
- * [+:offset+]
- *   ソートされたレコードのうち、(0ベースで)_:offset_番目
+ * - ハッシュの配列で指定する方法 :=
+ * オーソドックスな指定方法。
+ *
+ * <pre lang="ruby">
+ * [
+ *  {:key => "第1ソートキー", :order => order},
+ *  {:key => "第2ソートキー", :order => order},
+ *  ...,
+ * ]
+ * </pre>
+ * =:
+ *
+ * - 配列の配列で指定する方法 :=
+ * 少し簡単化した指定方法。
+ *
+ * <pre lang="ruby">
+ * [
+ *  ["第1ソートキー", order],
+ *  ["第2ソートキー", order],
+ *  ...,
+ * ]
+ * </pre>
+ * =:
+ *
+ * - ソートキーの配列で指定する方法 :=
+ * _order_ は常に昇順（ +:ascending+ ）になるが、最も簡単
+ * に指定できる。
+ *
+ * <pre lang="ruby">
+ * ["第1ソートキー", "第2ソートキー", ...]
+ * </pre>
+ * =:
+ *
+ * @param options [::Hash] The name and value
+ *   pairs. Omitted names are initialized as the default value.
+ * @option options :offset The offset
+ *   ソートされたレコードのうち、(0ベースで) _:offset_ 番目
  *   からレコードを取り出す。
  *
- * [+:limit+]
- *   ソートされたレコードのうち、_:limit_件のみを取り出す。
+ * @option options :limit The limit
+ *   ソートされたレコードのうち、 _:limit_ 件のみを取り出す。
  *   省略された場合または-1が指定された場合は、全件が指定され
  *   たものとみなす。
  */
@@ -1143,7 +1155,7 @@ rb_grn_table_sort (int argc, VALUE *argv, VALUE self)
  *   table.group([key1, key2, ...], options={}) -> [Groonga::Hash, ...]
  *   table.group(key, options={}) -> Groonga::Hash
  *
- * _table_のレコードを_key1_, _key2_, _..._で指定したキーの
+ * _table_ のレコードを _key1_ , _key2_ , _..._ で指定したキーの
  * 値でグループ化する。多くの場合、キーにはカラムを指定する。
  * カラムはカラム名（文字列）でも指定可能。
  */
@@ -1244,7 +1256,7 @@ rb_grn_table_group (int argc, VALUE *argv, VALUE self)
  * call-seq:
  *   table[id] -> Groonga::Record
  *
- * _table_の_id_に対応するGroonga::Recordを返す。
+ * _table_ の _id_ に対応するGroonga::Recordを返す。
  *
  * 0.9.0から値ではなくGroonga::Recordを返すようになった。
  */
@@ -1287,7 +1299,7 @@ rb_grn_table_get_value (VALUE self, VALUE rb_id)
  *   table.value(id) -> 値
  *   table.value(id, :id => true) -> 値
  *
- * _table_の_id_に対応する値を返す。
+ * _table_ の _id_ に対応する値を返す。
  *
  * <tt>:id => true</tt>が指定できるのは利便性のため。
  * Groonga::ArrayでもGroonga::HashやGroonga::PatriciaTrieと
@@ -1347,7 +1359,7 @@ rb_grn_table_set_value (VALUE self, VALUE rb_id, VALUE rb_value)
  *   table.set_value(id, value)
  *   table.set_value(id, value, :id => true)
  *
- * _table_の_id_に対応する値として_value_設定する。既存の値は
+ * _table_ の _id_ に対応する値として _value_ 設定する。既存の値は
  * 上書きされる。
  *
  * <tt>:id => true</tt>が指定できるのは利便性のため。
@@ -1400,7 +1412,7 @@ rb_grn_table_get_column_value (VALUE self, VALUE rb_id, VALUE rb_name)
  *   table.column_value(id, name) -> 値
  *   table.column_value(id, name, :id => true) -> 値
  *
- * _table_の_id_に対応するカラム_name_の値を返す。
+ * _table_ の _id_ に対応するカラム _name_ の値を返す。
  *
  * <tt>:id => true</tt>が指定できるのは利便性のため。
  * Groonga::ArrayでもGroonga::HashやGroonga::PatriciaTrieと
@@ -1456,7 +1468,7 @@ rb_grn_table_set_column_value (VALUE self, VALUE rb_id,
  *   table.set_column_value(id, name, value)
  *   table.set_column_value(id, name, value, :id => true)
  *
- * _table_の_id_に対応するカラム_name_の値として_value_設定す
+ * _table_ の _id_ に対応するカラム _name_ の値として _value_ 設定す
  * る。既存の値は上書きされる。
  *
  * <tt>:id => true</tt>が指定できるのは利便性のため。
@@ -1492,12 +1504,12 @@ rb_grn_table_set_column_value_convenience (int argc, VALUE *argv, VALUE self)
  * call-seq:
  *   table.unlock(options={})
  *
- * _table_のロックを解除する。
+ * _table_ のロックを解除する。
  *
  * 利用可能なオプションは以下の通り。
  *
- * [_:id_]
- *   _:id_で指定したレコードのロックを解除する。（注:
+ * [ _:id_ ]
+ *   _:id_ で指定したレコードのロックを解除する。（注:
  *   groonga側が未実装のため、現在は無視される）
  */
 static VALUE
@@ -1543,19 +1555,23 @@ rb_grn_table_unlock_ensure (VALUE self)
  *   table.lock(options={})
  *   table.lock(options={}) {}
  *
- * _table_をロックする。ロックに失敗した場合は
+ * _table_ をロックする。ロックに失敗した場合は
  * Groonga::ResourceDeadlockAvoided例外が発生する。
  *
  * ブロックを指定した場合はブロックを抜けたときにunlockする。
  *
  * 利用可能なオプションは以下の通り。
+ * @param options [::Hash] The name and value
+ *   pairs. Omitted names are initialized as the default value.
+ * @option options :timeout The timeout
  *
- * [_:timeout_]
- *   ロックを獲得できなかった場合は_:timeout_秒間ロックの獲
- *   得を試みる。_:timeout_秒以内にロックを獲得できなかった
+ *   ロックを獲得できなかった場合は _:timeout_ 秒間ロックの獲
+ *   得を試みる。 _:timeout_ 秒以内にロックを獲得できなかった
  *   場合は例外が発生する。
- * [_:id_]
- *   _:id_で指定したレコードをロックする。（注: groonga側が
+ *
+ * @option options :id The id
+ *
+ *   _:id_ で指定したレコードをロックする。（注: groonga側が
  *   未実装のため、現在は無視される）
  */
 static VALUE
@@ -1603,12 +1619,14 @@ rb_grn_table_lock (int argc, VALUE *argv, VALUE self)
  * call-seq:
  *   table.clear_lock(options={})
  *
- * _table_のロックを強制的に解除する。
+ * _table_ のロックを強制的に解除する。
  *
  * 利用可能なオプションは以下の通り。
+ * @param options [::Hash] The name and value
+ *   pairs. Omitted names are initialized as the default value.
+ * @option options :id The id
  *
- * [_:id_]
- *   _:id_で指定したレコードのロックを強制的に解除する。
+ *   _:id_ で指定したレコードのロックを強制的に解除する。
  *   （注: groonga側が未実装のため、現在は無視される。実装さ
  *   れるのではないかと思っているが、実装されないかもしれな
  *   い。）
@@ -1646,12 +1664,14 @@ rb_grn_table_clear_lock (int argc, VALUE *argv, VALUE self)
  * call-seq:
  *   table.locked?(options={})
  *
- * _table_がロックされていれば+true+を返す。
+ * _table_ がロックされていれば +true+ を返す。
  *
  * 利用可能なオプションは以下の通り。
+ * @param options [options] The name and value
+ *   pairs. Omitted names are initialized as the default value.
+ * @option options :id The id
  *
- * [_:id_]
- *   _:id_で指定したレコードがロックされていれば+true+を返す。
+ *   _:id_ で指定したレコードがロックされていれば +true+ を返す。
  *   （注: groonga側が未実装のため、現在は無視される。実装さ
  *   れるのではないかと思っているが、実装されないかもしれな
  *   い。）
@@ -1687,14 +1707,14 @@ rb_grn_table_is_locked (int argc, VALUE *argv, VALUE self)
  *   table.select(query, options) -> Groonga::Hash
  *   table.select(expression, options) -> Groonga::Hash
  *
- * _table_からブロックまたは文字列で指定した条件にマッチする
- * レコードを返す。返されたテーブルには+expression+という特
+ * _table_ からブロックまたは文字列で指定した条件にマッチする
+ * レコードを返す。返されたテーブルには +expression+ という特
  * 異メソッドがあり、指定した条件を表している
  * Groonga::Expressionを取得できる。
  * Groonga::Expression#snippetを使うことにより、指定した条件
  * 用のスニペットを簡単に生成できる。
- *
- *   results = table.select do |record|
+ * <pre>
+ *   ==results = table.select do |record|
  *     record["description"] =~ "groonga"
  *   end
  *   snippet = results.expression.snippet([["<em>", "</em>"]])
@@ -1705,65 +1725,72 @@ rb_grn_table_is_locked (int argc, VALUE *argv, VALUE self)
  *       puts "#{snippet}..."
  *       puts "---"
  *     end
- *   end
- *
+ *   end==
+ * </pre>
  * 出力例
  *   Ruby/groongaの説明文の中で「groonga」が含まれる部分
  *   ---
  *   Ruby/<em>groonga</em>は<em>groonga</em>のいわゆるDB-APIの層の...
  *   ---
  *
- * _query_には「[カラム名]:[演算子][値]」という書式で条件を
+ * _query_ には「[カラム名]:[演算子][値]」という書式で条件を
  * 指定する。演算子は以下の通り。
- *
- * [なし]
- *   \[カラム値] == [値]
- * [<tt>!</tt>]
- *   \[カラム値] != [値]
- * [<tt><</tt>]
- *   \[カラム値] < [値]
- * [<tt>></tt>]
- *   \[カラム値] > [値]
- * [<tt><=</tt>]
- *   \[カラム値] <= [値]
- * [<tt>>=</tt>]
- *   \[カラム値] >= [値]
- * [<tt>@</tt>]
- *   \[カラム値]が[値]を含んでいるかどうか
+ * <pre>
+ *   [なし]
+ *     \[カラム値] == [値]
+ *   [<tt>!</tt>]
+ *     \[カラム値] != [値]
+ *   [<tt><</tt>]
+ *     \[カラム値] < [値]
+ *   [<tt>></tt>]
+ *     \[カラム値] > [値]
+ *   [<tt><=</tt>]
+ *     \[カラム値] <= [値]
+ *   [<tt>>=</tt>]
+ *     \[カラム値] >= [値]
+ *   [<tt>@</tt>]
+ *     \[カラム値]が[値]を含んでいるかどうか
+ * </pre>
  *
  * 例:
- *   "name:daijiro" # "name"カラムの値が"daijiro"のレコードにマッチ
+ * <pre>
+ *   =="name:daijiro" # "name"カラムの値が"daijiro"のレコードにマッチ
  *   "description:@groonga" # "description"カラムが
- *                          # "groonga"を含んでいるレコードにマッチ
+ *                          # "groonga"を含んでいるレコードにマッチ==
+ * </pre>
  *
- * _expression_には既に作成済みのGroonga::Expressionを渡す
+ * _expression_ には既に作成済みのGroonga::Expressionを渡す
  *
  * ブロックで条件を指定する場合は
  * Groonga::RecordExpressionBuilderを参照。
  *
  * Ruby1.9以降では、ブロックで条件を指定する際に
  * Groonga::ColumnExpressionBuilderの他に"!="も使用可能。
+ *
  * 例:
- *  comments = Groonga::Array.create(:name => "Comments")
+ * <pre>
+ *  ==comments = Groonga::Array.create(:name => "Comments")
  *  comments.define_column("content", "Text")
- *
  *  comments.add(:content => "Hello Good-bye!")
  *  comments.add(:content => "Hello World")
  *  comments.add(:content => "test")
- *
  *  result = comments.select do |record|
  *    record.content != "test"
  *  end
  *  p result.collect {|record| record.content}
- *    # => ["Hello Good-bye!", "Hello World"]
+ *    # => ["Hello Good-bye!", "Hello World"]==
+ * </pre>
  *
- * _options_に指定可能な値は以下の通り。
+ * _options_ に指定可能な値は以下の通り。
+ * @param options [::Hash] The name and value
+ *   pairs. Omitted names are initialized as the default value.
+ * @option options :default_column
  *
- * [+:default_column+]
  *   "column_name:hoge"ではなく"hoge"のようにcolumn_nameが指
  *   定されない条件の検索対象となるカラムを指定する。
  *
- * [+:operator+]
+ * @option options :operator (Groonga::Operator::OR) The operator
+ *
  *   マッチしたレコードをどのように扱うか。指定可能な値は以
  *   下の通り。省略した場合はGroonga::Operator::OR。
  *
@@ -1777,31 +1804,37 @@ rb_grn_table_is_locked (int argc, VALUE *argv, VALUE self)
  *   [Groonga::Operator::ADJUST] マッチしたレコードのスコア
  *                               を増加。
  *
- * [+:result+]
+ * @option options :result The result
+ *
  *   検索結果を格納するテーブル。マッチしたレコードが追加さ
  *   れていく。省略した場合は新しくテーブルを作成して返す。
  *
- * [+:name+]
+ * @option options :name The name
+ *
  *   条件の名前。省略した場合は名前を付けない。
  *
- * [+:syntax+]
- *   _query_の構文。省略した場合は+:query+。
+ * @option options :syntax The syntax
+ *
+ *   _query_ の構文。省略した場合は +:query+ 。
  *
  *   参考: Groonga::Expression#parse.
  *
- * [+:allow_pragma+]
+ * @option options :allow_pragma The allow_pragma
+ *
  *   query構文時にプラグマを利用するかどうか。省略した場合は
  *   利用する。
  *
  *   参考: Groonga::Expression#parse.
  *
- * [+:allow_column+]
+ * @option options :allow_column The allow_column
+ *
  *   query構文時にカラム指定を利用するかどうか。省略した場合
  *   は利用する。
  *
  *   参考: Groonga::Expression#parse.
  *
- * [+:allow_update+]
+ * @option options :allow_update The allow_update
+ *
  *   script構文時に更新操作を利用するかどうか。省略した場合
  *   は利用する。
  *
@@ -1918,8 +1951,8 @@ rb_grn_table_set_operation_bang (VALUE self, VALUE rb_other,
  * call-seq:
  *   table.union!(other) -> Groonga::Table
  *
- * キーを比較し、_table_には登録されていない_other_のレコー
- * ドを_table_に作成する。
+ * キーを比較し、 _table_ には登録されていない _other_ のレコー
+ * ドを _table_ に作成する。
  *
  */
 static VALUE
@@ -1933,8 +1966,8 @@ rb_grn_table_union_bang (VALUE self, VALUE rb_other)
  * call-seq:
  *   table.intersection!(other) -> Groonga::Table
  *
- * キーを比較し、_other_には登録されていないレコードを
- * _table_から削除する。
+ * キーを比較し、 _other_ には登録されていないレコードを
+ * _table_ から削除する。
  *
  */
 static VALUE
@@ -1947,7 +1980,7 @@ rb_grn_table_intersection_bang (VALUE self, VALUE rb_other)
  * call-seq:
  *   table.difference!(other) -> Groonga::Table
  *
- * キーを比較し、_other_にも登録されているレコードを_table_
+ * キーを比較し、 _other_ にも登録されているレコードを _table_
  * から削除する。
  *
  */
@@ -1961,8 +1994,8 @@ rb_grn_table_difference_bang (VALUE self, VALUE rb_other)
  * call-seq:
  *   table.merge!(other) -> Groonga::Table
  *
- * キーを比較し、_other_にも登録されている_table_のレコード
- * のスコアを_other_のスコアと同値にする。
+ * キーを比較し、 _other_ にも登録されている _table_ のレコード
+ * のスコアを _other_ のスコアと同値にする。
  *
  */
 static VALUE
@@ -1975,8 +2008,8 @@ rb_grn_table_merge_bang (VALUE self, VALUE rb_other)
  * call-seq:
  *   table.support_key? -> true/false
  *
- * _table_に主キーが設定されていれば+true+、されていなければ
- * +false+を返す。
+ * _table_ に主キーが設定されていれば +true+ 、されていなければ
+ * +false+ を返す。
  */
 static VALUE
 rb_grn_table_support_key_p (VALUE self)
@@ -1989,7 +2022,7 @@ rb_grn_table_support_key_p (VALUE self)
  *   table.support_sub_records? -> true/false
  *
  * グループ化したとき、テーブルにグループに含まれるレコード
- * 数を格納できる場合は+true+、格納できない場合は+false+を返
+ * 数を格納できる場合は +true+ 、格納できない場合は +false+ を返
  * す。
  */
 static VALUE
@@ -2008,8 +2041,8 @@ rb_grn_table_support_sub_records_p (VALUE self)
  * call-seq:
  *   table.exist?(id) -> true/false
  *
- * _table_に_id_で指定したIDのレコードが存在する場合は+true+、
- * 存在しない場合は+false+を返す。
+ * _table_ に _id_ で指定したIDのレコードが存在する場合は +true+ 、
+ * 存在しない場合は +false+ を返す。
  *
  * 注意: 実行には相応のコストがかかるのであまり頻繁に呼ばな
  * いようにして下さい。
@@ -2027,6 +2060,83 @@ rb_grn_table_exist_p (VALUE self, VALUE id)
     return CBOOL2RVAL(grn_table_at(context, table, NUM2UINT(id)));
 }
 
+/*
+ * Document-method: defrag
+ *
+ * call-seq:
+ *   table.defrag(options={}) -> n_segments
+ *
+ * Defrags all variable size columns in the table.
+ *
+ * @return [Integer] the number of defraged segments
+ * @option options [Integer] :threshold (0) the threshold to
+ *   determine whether a segment is defraged. Available
+ *   values are -4..22. -4 means all segments are defraged.
+ *   22 means no segment is defraged.
+ * @since 1.3.0
+ */
+static VALUE
+rb_grn_table_defrag (int argc, VALUE *argv, VALUE self)
+{
+    grn_ctx *context;
+    grn_obj *table;
+    int n_segments;
+    VALUE options, rb_threshold;
+    int threshold = 0;
+
+    rb_scan_args(argc, argv, "01", &options);
+    rb_grn_scan_options(options,
+			"threshold", &rb_threshold,
+			NULL);
+    if (!NIL_P(rb_threshold)) {
+	threshold = NUM2INT(rb_threshold);
+    }
+
+    rb_grn_table_deconstruct(SELF(self), &table, &context,
+			     NULL, NULL, NULL,
+			     NULL, NULL,
+			     NULL);
+    n_segments = grn_obj_defrag(context, table, threshold);
+    rb_grn_context_check(context, self);
+
+    return INT2NUM(n_segments);
+}
+
+/*
+ * Document-method: rename
+ *
+ * call-seq:
+ *   table.rename(name)
+ *
+ * Renames the table to name.
+ *
+ * @param name [String] the new name
+ * @since 1.3.0
+ */
+static VALUE
+rb_grn_table_rename (VALUE self, VALUE rb_name)
+{
+    int rc;
+    grn_ctx *context;
+    grn_obj *table;
+    char *name;
+    int name_size;
+
+    rb_grn_table_deconstruct(SELF(self), &table, &context,
+			     NULL, NULL, NULL,
+			     NULL, NULL,
+			     NULL);
+
+    name = StringValueCStr(rb_name);
+    name_size = RSTRING_LEN(rb_name);
+
+    rc = grn_table_rename(context, table, name, name_size);
+    rb_grn_context_check(context, self);
+    rb_grn_rc_check(rc, self);
+
+    return self;
+}
+
 void
 rb_grn_init_table (VALUE mGrn)
 {
@@ -2101,9 +2211,14 @@ rb_grn_init_table (VALUE mGrn)
 
     rb_define_method(rb_cGrnTable, "exist?", rb_grn_table_exist_p, 1);
 
+    rb_define_method(rb_cGrnTable, "defrag", rb_grn_table_defrag, -1);
+
+    rb_define_method(rb_cGrnTable, "rename", rb_grn_table_rename, 1);
+
     rb_grn_init_table_key_support(mGrn);
     rb_grn_init_array(mGrn);
     rb_grn_init_hash(mGrn);
     rb_grn_init_patricia_trie(mGrn);
+    rb_grn_init_double_array_trie(mGrn);
     rb_grn_init_view(mGrn);
 }