rroonga 9.0.3 → 11.0.0

data/ext/groonga/rb-grn-patricia-trie.c

@@ -1,7 +1,7 @@
 /* -*- coding: utf-8; mode: C; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
 /* vim: set sts=4 sw=4 ts=8 noet: */
 /*
-  Copyright (C) 2009-2014  Kouhei Sutou <kou@clear-code.com>
+  Copyright (C) 2009-2021  Sutou Kouhei <kou@clear-code.com>
 
   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public
@@ -19,7 +19,7 @@
 
 #include "rb-grn.h"
 
-#define SELF(object) ((RbGrnTableKeySupport *)DATA_PTR(object))
+#define SELF(object) ((RbGrnTableKeySupport *)RTYPEDDATA_DATA(object))
 
 VALUE rb_cGrnPatriciaTrie;
 

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

@@ -1,6 +1,6 @@
 /* -*- coding: utf-8; mode: C; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
 /*
-  Copyright (C) 2011-2015  Kouhei Sutou <kou@clear-code.com>
+  Copyright (C) 2011-2021  Sutou Kouhei <kou@clear-code.com>
   Copyright (C) 2016  Masafumi Yokoyama <yokoyama@clear-code.com>
 
   This library is free software; you can redistribute it and/or
@@ -17,34 +17,19 @@
   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 */
 
-#include "rb-grn.h"
-
-#define SELF(object) (RVAL2GRNCONTEXT(object))
-
-static VALUE cGrnPlugin;
-
 /*
  * Document-class: Groonga::Plugin
  *
- * プラグイン。現在のところ、Rubyでgroongaのプラグインを作成
+ * プラグイン。現在のところ、RubyでGroongaのプラグインを作成
  * することはできず、Cで作成された既存のプラグインを登録する
  * ことができるだけです。
  */
 
-grn_id
-rb_grn_plugin_from_ruby_object (VALUE object)
-{
-    RbGrnPlugin *rb_grn_plugin;
+#include "rb-grn.h"
 
-    if (!RVAL2CBOOL(rb_obj_is_kind_of(object, cGrnPlugin))) {
-        rb_raise(rb_eTypeError, "not a groonga plugin");
-    }
+#define SELF(object) (RVAL2GRNCONTEXT(object))
 
-    Data_Get_Struct(object, RbGrnPlugin, rb_grn_plugin);
-    if (!rb_grn_plugin)
-        rb_raise(rb_eGrnError, "groonga plugin is NULL");
-    return rb_grn_plugin->id;
-}
+static VALUE cGrnPlugin;
 
 void
 rb_grn_plugin_fin (grn_id id)
@@ -59,10 +44,37 @@ rb_grn_plugin_free (void *pointer)
     xfree(rb_grn_plugin);
 }
 
+static rb_data_type_t data_type = {
+    "Groonga::Plugin",
+    {
+        NULL,
+        rb_grn_plugin_free,
+        NULL,
+    },
+    NULL,
+    NULL,
+    RUBY_TYPED_FREE_IMMEDIATELY
+};
+
+grn_id
+rb_grn_plugin_from_ruby_object (VALUE object)
+{
+    RbGrnPlugin *rb_grn_plugin;
+
+    if (!RVAL2CBOOL(rb_obj_is_kind_of(object, cGrnPlugin))) {
+        rb_raise(rb_eTypeError, "not a groonga plugin");
+    }
+
+    TypedData_Get_Struct(object, RbGrnPlugin, &data_type, rb_grn_plugin);
+    if (!rb_grn_plugin)
+        rb_raise(rb_eGrnError, "groonga plugin is NULL");
+    return rb_grn_plugin->id;
+}
+
 static VALUE
 rb_grn_plugin_alloc (VALUE klass)
 {
-    return Data_Wrap_Struct(klass, NULL, rb_grn_plugin_free, NULL);
+    return TypedData_Wrap_Struct(klass, &data_type, NULL);
 }
 
 /*
@@ -245,7 +257,7 @@ rb_grn_plugin_s_names (int argc, VALUE *argv, VALUE klass)
 void
 rb_grn_init_plugin (VALUE mGrn)
 {
-    cGrnPlugin = rb_define_class_under(mGrn, "Plugin", rb_cData);
+    cGrnPlugin = rb_define_class_under(mGrn, "Plugin", rb_cObject);
     rb_define_alloc_func(cGrnPlugin, rb_grn_plugin_alloc);
 
     rb_define_singleton_method(cGrnPlugin, "register",

data/ext/groonga/rb-grn-request-timer-id.c

@@ -1,6 +1,6 @@
 /* -*- coding: utf-8; mode: C; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
 /*
-  Copyright (C) 2016  Kouhei Sutou <kou@clear-code.com>
+  Copyright (C) 2016-2021  Sutou Kouhei <kou@clear-code.com>
 
   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public
@@ -60,5 +60,5 @@ void
 rb_grn_init_request_timer_id (VALUE mGrn)
 {
     rb_cGrnRequestTimerID =
-        rb_define_class_under(mGrn, "RequestTimerID", rb_cData);
+        rb_define_class_under(mGrn, "RequestTimerID", rb_cObject);
 }

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

@@ -1,6 +1,6 @@
 /* -*- coding: utf-8; mode: C; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
 /*
-  Copyright (C) 2009-2014  Kouhei Sutou <kou@clear-code.com>
+  Copyright (C) 2009-2021  Sutou Kouhei <kou@clear-code.com>
 
   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public
@@ -18,7 +18,7 @@
 
 #include "rb-grn.h"
 
-#define SELF(object) ((RbGrnSnippet *)DATA_PTR(object))
+#define SELF(object) ((RbGrnSnippet *)RTYPEDDATA_DATA(object))
 
 VALUE rb_cGrnSnippet;
 
@@ -149,7 +149,7 @@ rb_grn_snippet_initialize (int argc, VALUE *argv, VALUE self)
     rb_grn_context_check(context, rb_ary_new_from_values(argc, argv));
 
     rb_grn_object_assign(Qnil, self, rb_context, context, snippet);
-    rb_grn_context_register_floating_object(DATA_PTR(self));
+    rb_grn_context_register_floating_object(RTYPEDDATA_DATA(self));
 
     rb_iv_set(self, "@context", rb_context);
 

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

@@ -1,6 +1,6 @@
 /* -*- coding: utf-8; mode: C; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
 /*
-  Copyright (C) 2009  Kouhei Sutou <kou@clear-code.com>
+  Copyright (C) 2009-2021  Sutou Kouhei <kou@clear-code.com>
 
   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public
@@ -18,7 +18,7 @@
 
 #include "rb-grn.h"
 
-#define SELF(object) ((RbGrnTableCursor *)DATA_PTR(object))
+#define SELF(object) ((RbGrnTableCursor *)RTYPEDDATA_DATA(object))
 
 VALUE rb_mGrnTableCursorKeySupport;
 

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

@@ -1,6 +1,6 @@
 /* -*- coding: utf-8; mode: C; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
 /*
-  Copyright (C) 2009-2013  Kouhei Sutou <kou@clear-code.com>
+  Copyright (C) 2009-2021  Sutou Kouhei <kou@clear-code.com>
 
   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public
@@ -18,7 +18,7 @@
 
 #include "rb-grn.h"
 
-#define SELF(object) ((RbGrnTableCursor *)DATA_PTR(object))
+#define SELF(object) ((RbGrnTableCursor *)RTYPEDDATA_DATA(object))
 
 VALUE rb_cGrnTableCursor;
 
@@ -277,7 +277,7 @@ rb_grn_table_cursor_each (VALUE self)
 void
 rb_grn_init_table_cursor (VALUE mGrn)
 {
-    rb_cGrnTableCursor = rb_define_class_under(mGrn, "TableCursor", rb_cData);
+    rb_cGrnTableCursor = rb_define_class_under(mGrn, "TableCursor", rb_cObject);
     rb_define_alloc_func(rb_cGrnTableCursor, rb_grn_object_alloc);
 
     rb_include_module(rb_cGrnTableCursor, rb_mEnumerable);

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

@@ -1,6 +1,6 @@
 /* -*- coding: utf-8; mode: C; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
 /*
-  Copyright (C) 2009-2014  Kouhei Sutou <kou@clear-code.com>
+  Copyright (C) 2009-2021  Sutou Kouhei <kou@clear-code.com>
   Copyright (C) 2014-2016  Masafumi Yokoyama <yokoyama@clear-code.com>
 
   This library is free software; you can redistribute it and/or
@@ -19,7 +19,7 @@
 
 #include "rb-grn.h"
 
-#define SELF(object) ((RbGrnTableKeySupport *)DATA_PTR(object))
+#define SELF(object) ((RbGrnTableKeySupport *)RTYPEDDATA_DATA(object))
 
 VALUE rb_mGrnTableKeySupport;
 
@@ -481,8 +481,10 @@ typedef struct _SetValueData
 } SetValueData;
 
 static VALUE
-set_value (VALUE args, SetValueData *data)
+set_value (RB_BLOCK_CALL_FUNC_ARGLIST(yielded_arg, callback_arg))
 {
+    VALUE args = yielded_arg;
+    SetValueData *data = (SetValueData *)callback_arg;
     VALUE rb_name, rb_value, rb_column;
     RbGrnObject *rb_grn_object;
 
@@ -496,7 +498,7 @@ set_value (VALUE args, SetValueData *data)
                  rb_grn_inspect(rb_name), rb_grn_inspect(data->self));
     }
 
-    rb_grn_object = RB_GRN_OBJECT(DATA_PTR(rb_column));
+    rb_grn_object = RB_GRN_OBJECT(RTYPEDDATA_DATA(rb_column));
     return rb_grn_object_set_raw(rb_grn_object,
                                  data->id, rb_value, GRN_OBJ_SET, data->self);
 }
@@ -911,7 +913,9 @@ rb_grn_table_key_support_get_normalizer (VALUE self)
  *   # Specifies normalizer object.
  *   table.normalizer = Groonga::Context["NormalizerNFKC51"]
  *   # Uses auto normalizer that is a normalizer for backward compatibility.
- *   table.normalizer = "TNormalizerAuto"
+ *   table.normalizer = "NormalizerAuto"
+ *   # Uses a normalizer with options.
+ *   table.normalizer = "NormalizerNFKC121('unify_kana', true)"
  *
  * @overload normalizer=(name)
  *    @param [String] name Set a nomalizer named @name@.
@@ -927,7 +931,6 @@ rb_grn_table_key_support_set_normalizer (VALUE self, VALUE rb_normalizer)
 {
     grn_ctx *context;
     grn_obj *table;
-    grn_obj *normalizer;
     grn_rc rc;
 
     rb_grn_table_key_support_deconstruct(SELF(self), &table, &context,
@@ -935,9 +938,25 @@ rb_grn_table_key_support_set_normalizer (VALUE self, VALUE rb_normalizer)
                                          NULL, NULL, NULL,
                                          NULL);
 
-    normalizer = RVAL2GRNOBJECT(rb_normalizer, &context);
-    rc = grn_obj_set_info(context, table, GRN_INFO_NORMALIZER, normalizer);
-    rb_grn_context_check(context, self);
+    if (RB_TYPE_P(rb_normalizer, RUBY_T_STRING)) {
+        grn_obj normalizer;
+        VALUE exception;
+        GRN_TEXT_INIT(&normalizer, GRN_OBJ_DO_SHALLOW_COPY);
+        GRN_TEXT_SET(context,
+                     &normalizer,
+                     RSTRING_PTR(rb_normalizer),
+                     RSTRING_LEN(rb_normalizer));
+        rc = grn_obj_set_info(context, table, GRN_INFO_NORMALIZER, &normalizer);
+        exception = rb_grn_context_to_exception(context, self);
+        GRN_OBJ_FIN(context, &normalizer);
+        if (!NIL_P(exception)) {
+            rb_exc_raise(exception);
+        }
+    } else {
+        grn_obj *normalizer = RVAL2GRNOBJECT(rb_normalizer, &context);
+        rc = grn_obj_set_info(context, table, GRN_INFO_NORMALIZER, normalizer);
+        rb_grn_context_check(context, self);
+    }
     rb_grn_rc_check(rc, self);
 
     return Qnil;

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

@@ -1,7 +1,8 @@
 /* -*- coding: utf-8; mode: C; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
 /*
-  Copyright (C) 2009-2017  Kouhei Sutou <kou@clear-code.com>
+  Copyright (C) 2009-2021  Sutou Kouhei <kou@clear-code.com>
   Copyright (C) 2014-2016  Masafumi Yokoyama <yokoyama@clear-code.com>
+  Copyright (C) 2019  Horimoto Yasuhiro <horimoto@clear-code.com>
 
   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public
@@ -19,20 +20,66 @@
 
 #include "rb-grn.h"
 
-#define SELF(object) ((RbGrnTable *)DATA_PTR(object))
+/*
+ * Document-class: Groonga::Table < Groonga::Object
+ *
+ * This class is base class which represents Rroonga's table.
+ * {Groonga::Array} , {Groonga::Hash} , {Groonga::PatriciaTrie}
+ * are extended from this class.
+ */
+
+#define SELF(object) ((RbGrnTable *)RTYPEDDATA_DATA(object))
 
 VALUE rb_cGrnTable;
 
 static ID id_array_reference;
 static ID id_array_set;
 
-/*
- * Document-class: Groonga::Table < Groonga::Object
- *
- * Rroongaが提供するテーブルのベースとなるクラス。このクラス
- * から {Groonga::Array} , {Groonga::Hash} , {Groonga::PatriciaTrie}
- * が継承されている。
- */
+static void
+rb_grn_table_mark (void *data)
+{
+    RbGrnObject *rb_grn_object = data;
+    RbGrnTable *rb_grn_table = data;
+    grn_ctx *context;
+    grn_obj *table;
+
+    if (!rb_grn_object)
+        return;
+
+    rb_gc_mark(rb_grn_table->columns);
+
+    context = rb_grn_object->context;
+    table = rb_grn_object->object;
+    if (!context || !table)
+        return;
+
+    rb_grn_context_mark_grn_id(context, table->header.domain);
+    rb_grn_context_mark_grn_id(context, grn_obj_get_range(context, table));
+
+    if (!grn_obj_path(context, table))
+        return;
+
+    if (grn_obj_name(context, table, NULL, 0) == 0)
+        return;
+}
+
+static void
+rb_grn_table_free (void *pointer)
+{
+    rb_grn_object_free(pointer);
+}
+
+static rb_data_type_t data_type = {
+    "Groonga::Table",
+    {
+        rb_grn_table_mark,
+        rb_grn_table_free,
+        NULL,
+    },
+    &rb_grn_object_data_type,
+    NULL,
+    RUBY_TYPED_FREE_IMMEDIATELY
+};
 
 grn_obj *
 rb_grn_table_from_ruby_object (VALUE object, grn_ctx **context)
@@ -100,38 +147,10 @@ rb_grn_table_deconstruct (RbGrnTable *rb_grn_table,
         *columns = rb_grn_table->columns;
 }
 
-static void
-rb_grn_table_mark (void *data)
-{
-    RbGrnObject *rb_grn_object = data;
-    RbGrnTable *rb_grn_table = data;
-    grn_ctx *context;
-    grn_obj *table;
-
-    if (!rb_grn_object)
-        return;
-
-    rb_gc_mark(rb_grn_table->columns);
-
-    context = rb_grn_object->context;
-    table = rb_grn_object->object;
-    if (!context || !table)
-        return;
-
-    rb_grn_context_mark_grn_id(context, table->header.domain);
-    rb_grn_context_mark_grn_id(context, grn_obj_get_range(context, table));
-
-    if (!grn_obj_path(context, table))
-        return;
-
-    if (grn_obj_name(context, table, NULL, 0) == 0)
-        return;
-}
-
 static VALUE
 rb_grn_table_alloc (VALUE klass)
 {
-    return Data_Wrap_Struct(klass, rb_grn_table_mark, rb_grn_object_free, NULL);
+    return TypedData_Wrap_Struct(klass, &data_type, NULL);
 }
 
 static VALUE
@@ -183,7 +202,8 @@ rb_grn_table_inspect_content (VALUE self, VALUE inspected)
 }
 
 /*
- * テーブルの中身を人に見やすい文字列で返す。
+ * This function return contents of a table as a string.
+ * It's easy to understand for human.
  *
  * @overload inspect
  *   @return [String]
@@ -203,31 +223,33 @@ rb_grn_table_inspect (VALUE self)
 }
 
 /*
- * テーブルに名前が _name_ で型が _value_type_ のカラムを定義
- * し、新しく定義されたカラムを返す。
+ * Defines a column that name is `name` and type is `value_type`. It
+ * returns the newly defined column.
  *
  * @overload define_column(name, value_type, options={})
  *   @param options [::Hash] The name and value
  *     pairs. Omitted names are initialized as the default value.
- *   @option options :path
- *     カラムを保存するパス。
- *   @option options :persistent (永続カラム)
- *     +true+ を指定すると永続カラムとなる。省略した場合は永
- *     続カラムとなる。 +:path+ を省略した場合は自動的にパスが
- *     付加される。
+ *   @option options :path [String, nil] (nil)
+ *     The path to store the content of the column.
+ *     If this is omitted, path is generated automatically.
+ *   @option options :persistent [Boolean] (true)
+ *     Whether the column is a persistent column or not.
+ *     If this is `true` and `:path` is omitted, path is generated
+ *     automatically.
  *   @option options :type (:scalar)
- *     カラムの値の格納方法について指定する。省略した場合は、
- *     +:scalar+ になる。
+ *     This option specifies how to store a value of a column.
+ *     If this option is omitted, +:scalar+ is used.
  *
- *     - +:scalar+ := スカラ値(単独の値)を格納する。
- *     - +:vector+ := 値の配列を格納する。
+ *     - +:scalar+ := Store scalar value.
+ *     - +:vector+ := Store array value.
  *   @option options [Boolean] :with_weight (false)
  *     It specifies whether making the column weight vector column or not.
  *     Weight vector column can store weight for each element.
  *
  *     You can't use this option for scalar column.
  *   @option options :compress
- *     値の圧縮方法を指定する。省略した場合は、圧縮しない。
+ *     This option specifies how to compress values.
+ *     If we omit this option, values are not compressed.
  *
  *     * `:zlib`: Compressed by zlib.
  *     * `:lz4`: Compressed by LZ4.
@@ -338,39 +360,44 @@ rb_grn_table_define_column (int argc, VALUE *argv, VALUE self)
 
     rb_column = GRNCOLUMN2RVAL(Qnil, context, column, GRN_TRUE);
     rb_ary_push(columns, rb_column);
-    rb_grn_named_object_set_name(RB_GRN_NAMED_OBJECT(DATA_PTR(rb_column)),
+    rb_grn_named_object_set_name(RB_GRN_NAMED_OBJECT(RTYPEDDATA_DATA(rb_column)),
                                  name, name_size);
 
     return rb_column;
 }
 
 /*
- * テーブルに名前が _name_ で型が _value_type_ のインデックスカ
- * ラムを定義し、新しく定義されたカラムを返す。
+ * Defines an index column that name is `name` and type is
+ * `value_type`. It returns the newly defined index column.
  *
  * @overload define_index_column(name, value_type, options={})
  *   @param options [::Hash] The name and value
  *     pairs. Omitted names are initialized as the default value.
- *   @option options :path
- *     カラムを保存するパス。
- *   @option options :persistent (永続カラム)
- *     +true+ を指定すると永続カラムとなる。省略した場合は永
- *     続カラムとなる。 +:path+ を省略した場合は自動的にパスが
- *     付加される。
- *   @option options :with_section
- *     転置索引にsection(段落情報)を合わせて格納する。
- *   @option options :with_weight
- *     転置索引にweight情報を合わせて格納する。
- *   @option options :with_position
- *     転置索引に出現位置情報を合わせて格納する。
- *   @option options :size (nil)
- *     The size of index column. It must be `nil`, `:small` or
- *     `:medium`. `nil` means full size. `:small` means small
- *     size. `:medium` means medium size.
- *   @option options :source
- *    インデックス対象となるカラムを指定する。 +:sources+ との併用はできない。
- *   @option options :sources
- *    インデックス対象となる複数のカラムを指定する。 +:source+ との併用はできない。
+ *   @option options :path [String, nil] (nil)
+ *     The path to store the content of the index column.
+ *     If this is omitted, path is generated automatically.
+ *   @option options :persistent [Boolean] (true)
+ *     Whether the index column is a persistent indent column or not.
+ *     If this is `true` and `:path` is omitted, path is generated
+ *     automatically.
+ *   @option options :with_section [Boolean] (false)
+ *     Whether section information is stored to the index column or not.
+ *   @option options :with_weight [Boolean] (false)
+ *     Whether weight information is stored to the index column or not.
+ *   @option options :with_position [Boolean] (false)
+ *     Whether position information is stored to the index column or not.
+ *   @option options :size [Symbol, nil] (nil)
+ *     The size of index column. It must be `nil`, `:small`,
+ *     `:medium` or `:large`. `nil` means the default size.
+ *     `:small` means small size. `:medium` means medium size. Medium size
+ *     is smaller than the default size. `:large` means large size.
+ *     Large size is larger than the default size.
+ *   @option options :source [Groonga::Column, nil] (nil)
+ *     Specifies the source column of the index column.
+ *     This option can't be used with `:sources`.
+ *   @option options :sources [::Array<Groonga::Column>, nil] (nil)
+ *     Specifies the source columns of the index column.
+ *     This option can't be used with `:source`.
  *
  * @return [Groonga::IndexColumn]
  */
@@ -461,9 +488,11 @@ rb_grn_table_define_index_column (int argc, VALUE *argv, VALUE self)
         flags |= GRN_OBJ_INDEX_SMALL;
     } else if (rb_grn_equal_option(rb_size, "medium")) {
         flags |= GRN_OBJ_INDEX_MEDIUM;
+    } else if (rb_grn_equal_option(rb_size, "large")) {
+        flags |= GRN_OBJ_INDEX_LARGE;
     } else {
         rb_raise(rb_eArgError,
-                 ":size must be nil, :small or :medium: <%" PRIsVALUE ">",
+                 ":size must be nil, :small, :medium or :large: <%" PRIsVALUE ">",
                  rb_size);
     }
 
@@ -486,7 +515,7 @@ rb_grn_table_define_index_column (int argc, VALUE *argv, VALUE self)
         rb_funcall(rb_column, rb_intern("sources="), 1, rb_sources);
 
     rb_ary_push(columns, rb_column);
-    rb_grn_named_object_set_name(RB_GRN_NAMED_OBJECT(DATA_PTR(rb_column)),
+    rb_grn_named_object_set_name(RB_GRN_NAMED_OBJECT(RTYPEDDATA_DATA(rb_column)),
                                  name, name_size);
 
     return rb_column;
@@ -514,8 +543,8 @@ ruby_object_to_column_name (VALUE rb_name,
 }
 
 /*
- * テーブルの _name_ に対応するカラムを返す。カラムが存在しな
- * い場合は +nil+ を返す。
+ * It returns the column has the specified name.
+ * If the specified column does not exist, it returns `nil`.
  *
  * @overload column(name)
  *   @return [Groonga::Column, nil]
@@ -547,7 +576,7 @@ rb_grn_table_get_column (VALUE self, VALUE rb_name)
         VALUE rb_column = raw_columns[i];
         RbGrnNamedObject *rb_grn_named_object;
 
-        rb_grn_named_object = RB_GRN_NAMED_OBJECT(DATA_PTR(rb_column));
+        rb_grn_named_object = RB_GRN_NAMED_OBJECT(RTYPEDDATA_DATA(rb_column));
         if (name_size == rb_grn_named_object->name_size &&
             memcmp(name, rb_grn_named_object->name, name_size) == 0) {
             return rb_column;
@@ -572,9 +601,9 @@ rb_grn_table_get_column (VALUE self, VALUE rb_name)
     owner = column->header.type == GRN_ACCESSOR;
     rb_column = GRNCOLUMN2RVAL(Qnil, context, column, owner);
     if (owner) {
-        rb_grn_context_register_floating_object(DATA_PTR(rb_column));
+        rb_grn_context_register_floating_object(RTYPEDDATA_DATA(rb_column));
     }
-    rb_grn_named_object_set_name(RB_GRN_NAMED_OBJECT(DATA_PTR(rb_column)),
+    rb_grn_named_object_set_name(RB_GRN_NAMED_OBJECT(RTYPEDDATA_DATA(rb_column)),
                                  name, name_size);
 
     return rb_column;
@@ -595,11 +624,15 @@ rb_grn_table_get_column_surely (VALUE self, VALUE rb_name)
 }
 
 /*
- * テーブルの全てのカラムを返す。 _name_ が指定された場合はカ
- * ラム名の先頭が _name_ で始まるカラムを返す。
+ * @overload columns(prefix=nil)
+ *   It returns the specified columns in the table.
+ *
+ *   @param prefix [String, nil]
+ *     If this is `nil`, it returns the all columns in table.
+ *
+ *     Otherwise it returns columns which have name starts with `prefix`.
  *
- * @overload columns(name=nil)
- *   @return [Groonga::Columnの配列]
+ *   @return [::Array<Groonga::Column>]
  */
 static VALUE
 rb_grn_table_get_columns (int argc, VALUE *argv, VALUE self)
@@ -611,9 +644,9 @@ rb_grn_table_get_columns (int argc, VALUE *argv, VALUE self)
     grn_rc rc;
     int n;
     grn_table_cursor *cursor;
-    VALUE rb_name, rb_columns;
-    char *name = NULL;
-    unsigned name_size = 0;
+    VALUE rb_prefix, rb_columns;
+    char *prefix = NULL;
+    unsigned prefix_size = 0;
     VALUE exception;
 
     rb_grn_table_deconstruct(SELF(self), &table, &context,
@@ -621,18 +654,18 @@ rb_grn_table_get_columns (int argc, VALUE *argv, VALUE self)
                              NULL, NULL, NULL,
                              NULL);
 
-    rb_scan_args(argc, argv, "01", &rb_name);
+    rb_scan_args(argc, argv, "01", &rb_prefix);
 
-    if (!NIL_P(rb_name)) {
-        name = StringValuePtr(rb_name);
-        name_size = RSTRING_LEN(rb_name);
+    if (!NIL_P(rb_prefix)) {
+        prefix = StringValuePtr(rb_prefix);
+        prefix_size = RSTRING_LEN(rb_prefix);
     }
 
     key_type = grn_ctx_at(context, GRN_DB_SHORT_TEXT);
     columns = grn_table_create(context, NULL, 0, NULL, GRN_TABLE_HASH_KEY,
                                key_type, 0);
     rb_grn_context_check(context, self);
-    n = grn_table_columns(context, table, name, name_size, columns);
+    n = grn_table_columns(context, table, prefix, prefix_size, columns);
     rb_grn_context_check(context, self);
 
     rb_columns = rb_ary_new2(n);
@@ -673,7 +706,7 @@ rb_grn_table_get_columns (int argc, VALUE *argv, VALUE self)
             RbGrnNamedObject *rb_grn_named_object;
             name_size = grn_column_name(context, column,
                                         name, GRN_TABLE_MAX_KEY_SIZE);
-            rb_grn_named_object = RB_GRN_NAMED_OBJECT(DATA_PTR(rb_column));
+            rb_grn_named_object = RB_GRN_NAMED_OBJECT(RTYPEDDATA_DATA(rb_column));
             rb_grn_named_object_set_name(rb_grn_named_object, name, name_size);
         }
 
@@ -690,9 +723,10 @@ rb_grn_table_get_columns (int argc, VALUE *argv, VALUE self)
 }
 
 /*
- * テーブルが _name_ カラムを持っている場合は +true+ を返す。
+ * Checks whether the table has a specified column or not.
  *
  * @overload have_column?(name)
+ *   @return [Boolean] `true` if the table has a `name` column, `false` otherwise.
  */
 static VALUE
 rb_grn_table_have_column (VALUE self, VALUE rb_name)
@@ -873,11 +907,10 @@ rb_grn_table_open_cursor (int argc, VALUE *argv, VALUE self)
 }
 
 /*
- * テーブルに登録されている全てのレコードが入っている配列を
- * 返す。
- *
  * @overload records
- *   @return [Groonga::Recordの配列]
+ *   It returns all records in the table.
+ *
+ *   @return [::Array<Groonga::Record>]
  */
 static VALUE
 rb_grn_table_get_records (int argc, VALUE *argv, VALUE self)
@@ -898,9 +931,9 @@ rb_grn_table_get_records (int argc, VALUE *argv, VALUE self)
 }
 
 /*
- * テーブルに登録されているレコード数を返す。
- *
  * @overload size
+ *   It returns the number of records in the table.
+ *
  *   @return [Integer]
  */
 static VALUE
@@ -919,9 +952,10 @@ rb_grn_table_get_size (VALUE self)
 }
 
 /*
- * テーブルにレコードが登録されていなければ +true+ を返す。
- *
  * @overload empty?
+ *
+ *   @return [Boolean] `true` if the table has no records,
+ *     `false` otherwise.
  */
 static VALUE
 rb_grn_table_empty_p (VALUE self)
@@ -939,9 +973,11 @@ rb_grn_table_empty_p (VALUE self)
 }
 
 /*
- * テーブルの全レコードを一括して削除する。
+ * Deletes all records in the table at once.
  *
  * @overload truncate
+ *
+ *   @return [void]
  */
 static VALUE
 rb_grn_table_truncate (VALUE self)
@@ -1074,7 +1110,7 @@ rb_grn_table_delete_by_expression (VALUE self)
 
     rb_builder = rb_grn_record_expression_builder_new(self, Qnil);
     rb_expression = rb_grn_record_expression_builder_build(rb_builder);
-    rb_grn_object_deconstruct(RB_GRN_OBJECT(DATA_PTR(rb_expression)),
+    rb_grn_object_deconstruct(RB_GRN_OBJECT(RTYPEDDATA_DATA(rb_expression)),
                               &expression, NULL,
                               NULL, NULL, NULL, NULL);
 
@@ -1112,7 +1148,7 @@ rb_grn_table_delete_by_expression (VALUE self)
  *
  *   @param id [Integer] The ID of delete target record.
  *
- *   @return void
+ *   @return [void]
  *
  * @overload delete
  *   Delete records that are matched with the given condition
@@ -1130,7 +1166,7 @@ rb_grn_table_delete_by_expression (VALUE self)
  *   @yieldreturn [Groonga::ExpressionBuilder]
  *     TODO: See #select.
  *
- *   @return void
+ *   @return [void]
  */
 static VALUE
 rb_grn_table_delete (int argc, VALUE *argv, VALUE self)
@@ -1613,9 +1649,10 @@ rb_grn_table_each_sub_record (VALUE self, VALUE rb_id)
 }
 
 /*
- * _table_ の _id_ に対応する {Groonga::Record} を返す。
+ * It returns the {Groonga::Record} for the `id` in the `table`.
  *
- * 0.9.0から値ではなく {Groonga::Record} を返すようになった。
+ * The return value has been changed to {Groonga::Record} from `id`
+ * itself since 0.9.0.
  *
  * @overload [](id)
  *   @return [Groonga::Record]
@@ -1653,16 +1690,16 @@ rb_grn_table_get_value (VALUE self, VALUE rb_id)
 }
 
 /*
- * _table_ の _id_ に対応する値を返す。
+ * It returns the value for the `id` in the `table`.
  *
- * @:id => true@ が指定できるのは利便性のため。
- * {Groonga::Array} でも {Groonga::Hash} や {Groonga::PatriciaTrie} と
- * 同じ引数で動くようになる。
+ * You can specify `id: true` for the convenience. `id: true` works
+ * with {Groonga::Array} like for {Groonga::Hash},
+ * {Groonga::PatriciaTrie} and so on.
  *
  * @overload value(id)
- *   @return [値]
- * @overload value(id, :id => true)
- *   @return [値]
+ *   @return [value]
+ * @overload value(id, id: true)
+ *   @return [value]
  */
 static VALUE
 rb_grn_table_get_value_convenience (int argc, VALUE *argv, VALUE self)
@@ -2375,7 +2412,7 @@ rb_grn_table_select (int argc, VALUE *argv, VALUE self)
       rb_funcall(builder, rb_intern("default_column="), 1, rb_default_column);
       rb_expression = rb_grn_record_expression_builder_build(builder);
     }
-    rb_grn_object_deconstruct(RB_GRN_OBJECT(DATA_PTR(rb_expression)),
+    rb_grn_object_deconstruct(RB_GRN_OBJECT(RTYPEDDATA_DATA(rb_expression)),
                               &expression, NULL,
                               NULL, NULL, NULL, NULL);
 
@@ -2482,8 +2519,8 @@ rb_grn_table_support_key_p (VALUE self)
 /*
  * @overload support_value?
  *
- *   @return @true@ if the table is created with value type, @false@
- *   otherwise.
+ *   @return [Boolean] `true` if the table is created with value type,
+ *     `false` otherwise.
  */
 static VALUE
 rb_grn_table_support_value_p (VALUE self)
@@ -2498,11 +2535,11 @@ rb_grn_table_support_value_p (VALUE self)
 }
 
 /*
- * グループ化したとき、テーブルにグループに含まれるレコード
- * 数を格納できる場合は +true+ 、格納できない場合は +false+ を返
- * す。
- *
  * @overload support_sub_records?
+ *
+ *   @return [Boolean] `true` if the table can store the number of
+ *     records for each group when the table is grouped, `false`
+ *     otherwise.
  */
 static VALUE
 rb_grn_table_support_sub_records_p (VALUE self)
@@ -2517,6 +2554,19 @@ rb_grn_table_support_sub_records_p (VALUE self)
     return CBOOL2RVAL(grn_table_is_grouped(context, table));
 }
 
+/*
+ * @overload support_score?
+ *
+ *   @return [Boolean] `true` if the table has `_score` column,
+ *     `false` otherwise.
+ */
+static VALUE
+rb_grn_table_support_score_p (VALUE self)
+{
+    return CBOOL2RVAL(rb_grn_table_have_column(self,
+                                               rb_str_new_literal("_score")));
+}
+
 /*
  * {Groonga::Table#group} returns a table that contains grouped
  * records. If grouped table has a space to store the number of
@@ -2554,13 +2604,11 @@ rb_grn_table_have_n_sub_records_space_p (VALUE self)
 }
 
 /*
- * _table_ に _id_ で指定したIDのレコードが存在する場合は +true+ 、
- * 存在しない場合は +false+ を返す。
- *
- * 注意: 実行には相応のコストがかかるのであまり頻繁に呼ばな
- * いようにして下さい。
- *
  * @overload exist?(id)
+ *   @return [Boolean] `true` if the table has a record specified ID
+ *      by `id`, `false` otherwise.
+ *
+ *   @note This method is heavy. You should not call this as much as possible.
  */
 static VALUE
 rb_grn_table_exist_p (VALUE self, VALUE id)
@@ -2890,6 +2938,8 @@ rb_grn_init_table (VALUE mGrn)
                      rb_grn_table_support_value_p, 0);
     rb_define_method(rb_cGrnTable, "support_sub_records?",
                      rb_grn_table_support_sub_records_p, 0);
+    rb_define_method(rb_cGrnTable, "support_score?",
+                     rb_grn_table_support_score_p, 0);
     rb_define_method(rb_cGrnTable, "have_n_sub_records_space?",
                      rb_grn_table_have_n_sub_records_space_p, 0);