rroonga 3.0.7-x86-mingw32 → 3.0.8-x86-mingw32

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3420bf2c0abc82b26b4ee440b7239d69248707f5
+  data.tar.gz: bc8e0a681fe7c55c1268f1c5676bc7c4f6be2d85
+SHA512:
+  metadata.gz: bff9809d62e9d33899973d34bc7b8c5e7fd1abc6d24a97fb0fc8ffbcff0c97c9bef22d4e49057583c80a74b9e8efda9a11990be91996423ddaaf9c80ef811bd1
+  data.tar.gz: da72819a55b29f3cca27df59d9980fa991c969e9d7e4500c9181677fb03165362b20a1049524b9ade12b55ea3b00783536b13e0649e445337c625f1b8533227e

data/Rakefile

@@ -111,8 +111,8 @@ namespace :win32 do
   namespace :groonga do
     task :download do
       require "open-uri"
-      require "rroonga-build"
-      groonga_version = RroongaBuild::RequiredGroongaVersion::VERSION.join(".")
+      require "./rroonga-build"
+      groonga_version = RroongaBuild::LatestGroongaVersion::VERSION.join(".")
       base_name = "groonga-#{groonga_version}-"
       if groonga_win32_i386_p
         base_name << "x86"
@@ -150,7 +150,17 @@ Rake::ExtensionTask.new("groonga", spec) do |ext|
     ext.cross_compile = true
     ext.cross_compiling do |_spec|
       if windows?(_spec.platform.to_s)
-        _spec.files += collect_binary_files(relative_binary_dir)
+        binary_files = collect_binary_files(relative_binary_dir)
+        _spec.files += binary_files
+        stage_path = "#{ext.tmp_dir}/#{_spec.platform}/stage"
+        binary_files.each do |binary_file|
+          stage_binary_file = "#{stage_path}/#{binary_file}"
+          stage_binary_dir = File.dirname(stage_binary_file)
+          directory stage_binary_dir
+          file stage_binary_file => [stage_binary_dir, binary_file] do
+            cp binary_file, stage_binary_file
+          end
+        end
       end
     end
   end

data/doc/text/news.textile

@@ -1,5 +1,13 @@
 h1. NEWS
 
+h2(#3-0-8). 3.0.8: 2013-09-29
+
+h3. Improvements
+
+* Supported groonga 3.0.8.
+* Supported x64-mingw32 Ruby.
+* Supported Ruby 2.1.0 preview1.
+
 h2(#3-0-7). 3.0.7: 2013-09-19
 
 h3. Improvements

data/ext/groonga/extconf.rb

@@ -232,7 +232,7 @@ end
 unless PKGConfig.have_package(package_name, major, minor, micro)
   unless have_local_groonga?(package_name, major, minor, micro)
     required_version = [major, minor, micro]
-    if (required_version <=> LatestGroongaVersion::VERSION) > 0
+    if (required_version <=> LatestGroongaVersion::VERSION) < 0
       target_version = LatestGroongaVersion::VERSION
     else
       target_version = required_version
@@ -258,8 +258,6 @@ 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")
 
-have_func("grn_table_tokenize", "groonga.h")
-
 checking_for(checking_message("--enable-debug-log option")) do
   enable_debug_log = enable_config("debug-log", false)
   if enable_debug_log

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

@@ -877,7 +877,6 @@ rb_grn_table_key_support_support_key_p (VALUE self)
     return table->header.domain == GRN_ID_NIL ? Qfalse : Qtrue;
 }
 
-#ifdef HAVE_GRN_TABLE_TOKENIZE
 /*
  * Tokenize a string using the table as lexicon.
  *
@@ -930,7 +929,6 @@ rb_grn_table_key_support_tokenize (int argc, VALUE *argv, VALUE self)
 
     return rb_tokens;
 }
-#endif
 
 void
 rb_grn_init_table_key_support (VALUE mGrn)
@@ -984,8 +982,6 @@ rb_grn_init_table_key_support (VALUE mGrn)
     rb_define_method(rb_mGrnTableKeySupport, "support_key?",
                      rb_grn_table_key_support_support_key_p, 0);
 
-#ifdef HAVE_GRN_TABLE_TOKENIZE
     rb_define_method(rb_mGrnTableKeySupport, "tokenize",
                      rb_grn_table_key_support_tokenize, -1);
-#endif
 }

data/ext/groonga/rb-grn.h

@@ -84,7 +84,7 @@ RB_GRN_BEGIN_DECLS
 
 #define RB_GRN_MAJOR_VERSION 3
 #define RB_GRN_MINOR_VERSION 0
-#define RB_GRN_MICRO_VERSION 7
+#define RB_GRN_MICRO_VERSION 8
 
 #define RB_GRN_QUERY_DEFAULT_MAX_EXPRESSIONS 32
 

data/rroonga-build.rb

@@ -19,15 +19,15 @@ module RroongaBuild
   module RequiredGroongaVersion
     MAJOR = 3
     MINOR = 0
-    MICRO = 5
+    MICRO = 8
     VERSION = [MAJOR, MINOR, MICRO]
-    RELEASED_DATE = Time.utc(2013, 6, 29)
+    RELEASED_DATE = Time.utc(2013, 9, 29)
   end
 
   module LatestGroongaVersion
     MAJOR = 3
     MINOR = 0
-    MICRO = 7
+    MICRO = 8
     VERSION = [MAJOR, MINOR, MICRO]
   end
 

data/vendor/local/bin/mecab-config

@@ -1,6 +1,6 @@
 #!/bin/sh
 
-prefix=/home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86
+prefix=/home/kenhys/work/groonga/groonga.clean/packages/windows/dist-x86
 exec_prefix=${prefix}
 exec_prefix_set=no
 
@@ -107,7 +107,7 @@ while test $# -gt 0; do
 	;;
 
     --libexecdir)
-       	echo /home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/libexec/mecab
+       	echo /home/kenhys/work/groonga/groonga.clean/packages/windows/dist-x86/libexec/mecab
        	;;
 	
     --sysconfdir)

data/vendor/local/etc/groonga/httpd/groonga-httpd.conf

@@ -15,7 +15,7 @@ http {
   keepalive_timeout 65;
 
   # The default groonga database path.
-  groonga_database /home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/var/lib/groonga/db/db;
+  groonga_database /home/kenhys/work/groonga/groonga.clean/packages/windows/dist-x86/var/lib/groonga/db/db;
 
   # Create a groonga database automatically if the groonga database doesn't
   # exist.
@@ -26,18 +26,26 @@ http {
   # groonga-httpd, you should do it.
   groonga_database_auto_create on;
 
+  # The default groonga cache limit. The cache limit can be set
+  # for each worker. It can't be set for each groonga database.
+  # groonga_cache_limit 100;
+
   server {
     listen 10041;
     server_name localhost;
 
     location /d/ {
       groonga on;
+      # You can disable log for groonga.
+      # groonga_log_path off;
+      # You can disable query log for groonga.
+      # groonga_query_log_path off;
       # You can custom database path.
       # groonga_database /path/to/groonga/db;
     }
 
     location / {
-      root /home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/share/groonga/html/admin;
+      root /home/kenhys/work/groonga/groonga.clean/packages/windows/dist-x86/share/groonga/html/admin;
       index index.html;
     }
 

data/vendor/local/include/groonga/groonga.h

@@ -220,64 +220,12 @@ struct _grn_ctx {
 #define GRN_CTX_PER_DB                 (0x08)
 
 GRN_API grn_rc grn_ctx_init(grn_ctx *ctx, int flags);
-
-/**
- * grn_ctx_fin:
- * @ctx: 解放するctx構造体へのポインタを指定します。
- *
- * ctxの管理するメモリを解放し、使用を終了します。
- *
- * If @ctx is initialized by grn_ctx_open() not
- * grn_ctx_init(). You need also to call grn_ctx_close().
- **/
 GRN_API grn_rc grn_ctx_fin(grn_ctx *ctx);
-
-/**
- * grn_ctx_open:
- * @flags: 初期化するctxのオプションを指定します。
- *
- *
- * 初期化されたgrn_ctxオブジェクトを返します。
- * grn_ctx_initで初期化されたgrn_ctxオブジェクトは構造体の実体を
- * APIの呼び元で確保するのに対して、grn_ctx_openではgroongaライブラリの内部で、
- * 実体を確保します。どちらで初期化されたgrn_ctxも、grn_ctx_fin()で解放できます。
- * grn_ctx_openで確保したgrn_ctx構造体に関しては、grn_ctx_fin()で解放した後に、
- * そのgrn_ctxで作成したgrn_objをgrn_obj_close()によって解放しても問題ありません。
- **/
-
 GRN_API grn_ctx *grn_ctx_open(int flags);
-
-/**
- * grn_ctx_close:
- * @ctx: no longer needed grn_ctx.
- *
- * It calls grn_ctx_fin() and frees allocated memory for
- * @ctx by grn_ctx_open().
- **/
 GRN_API grn_rc grn_ctx_close(grn_ctx *ctx);
-
-/**
- * grn_ctx_set_finalizer:
- * @ctx: 対象ctx
- * @func: @ctxを破棄するときに呼ばれる関数
- *
- * @ctxを破棄するときに呼ばれる関数を設定する。
- **/
 GRN_API grn_rc grn_ctx_set_finalizer(grn_ctx *ctx, grn_proc_func *func);
 
-/**
- * grn_get_default_encoding:
- *
- * デフォルトのencodingを返します。
- **/
 GRN_API grn_encoding grn_get_default_encoding(void);
-
-/**
- * grn_set_default_encoding:
- * @encoding: 変更後のデフォルトのencodingを指定します。
- *
- * デフォルトのencodingを変更します。
- **/
 GRN_API grn_rc grn_set_default_encoding(grn_encoding encoding);
 
 #define GRN_CTX_GET_ENCODING(ctx) ((ctx)->encoding)
@@ -287,95 +235,34 @@ GRN_API grn_rc grn_set_default_encoding(grn_encoding encoding);
 GRN_API const char *grn_get_version(void);
 GRN_API const char *grn_get_package(void);
 
-/**
- * grn_get_default_command_version:
- *
- * デフォルトのcommand_versionを返します。
- **/
 GRN_API grn_command_version grn_get_default_command_version(void);
-
-/**
- * grn_set_default_command_version:
- * @version: 変更後のデフォルトのcommand_versionを指定します。
- *
- * デフォルトのcommand_versionを変更します。
- **/
 GRN_API grn_rc grn_set_default_command_version(grn_command_version version);
-
-/**
- * grn_ctx_get_command_version:
- *
- * command_versionを返します。
- **/
 GRN_API grn_command_version grn_ctx_get_command_version(grn_ctx *ctx);
-
-/**
- * grn_ctx_set_command_version:
- * @version: 変更後のcommand_versionを指定します。
- *
- * command_versionを変更します。
- **/
 GRN_API grn_rc grn_ctx_set_command_version(grn_ctx *ctx, grn_command_version version);
-
-/**
- * grn_ctx_get_match_escalation_threshold:
- *
- * 検索の挙動をエスカレーションする閾値を返します。エスカレー
- * ションの詳細は検索の仕様に関するドキュメントを参照してく
- * ださい。
- **/
 GRN_API long long int grn_ctx_get_match_escalation_threshold(grn_ctx *ctx);
-
-/**
- * grn_ctx_set_match_escalation_threshold:
- * @threshold: 変更後の検索の挙動をエスカレーションする閾値を指定します。
- *
- * 検索の挙動をエスカレーションする閾値を変更します。エスカレー
- * ションの詳細は検索の仕様に関するドキュメントを参照してくだ
- * さい。
- **/
 GRN_API grn_rc grn_ctx_set_match_escalation_threshold(grn_ctx *ctx, long long int threshold);
-
-/**
- * grn_get_default_match_escalation_threshold:
- *
- * デフォルトの検索の挙動をエスカレーションする閾値を返します。
- * エスカレーションの詳細は検索の仕様に関するドキュメントを参
- * 照してください。
- **/
 GRN_API long long int grn_get_default_match_escalation_threshold(void);
-
-/**
- * grn_set_default_match_escalation_threshold:
- * @threshold: 変更後のデフォルトの検索の挙動をエスカレーションする閾値を指定します。
- *
- * デフォルトの検索の挙動をエスカレーションする閾値を変更しま
- * す。エスカレーションの詳細は詳細は検索の仕様に関するドキュ
- * メントを参照してください。
- **/
 GRN_API grn_rc grn_set_default_match_escalation_threshold(long long int threshold);
 
+/* cache */
+#define GRN_CACHE_DEFAULT_MAX_N_ENTRIES 100
+typedef struct _grn_cache grn_cache;
+
+GRN_API grn_cache *grn_cache_open(grn_ctx *ctx);
+GRN_API grn_rc grn_cache_close(grn_ctx *ctx, grn_cache *cache);
+
+GRN_API grn_rc grn_cache_current_set(grn_ctx *ctx, grn_cache *cache);
+GRN_API grn_cache *grn_cache_current_get(grn_ctx *ctx);
+
+GRN_API grn_rc grn_cache_set_max_n_entries(grn_ctx *ctx,
+                                           grn_cache *cache,
+                                           unsigned int n);
+GRN_API unsigned int grn_cache_get_max_n_entries(grn_ctx *ctx,
+                                                 grn_cache *cache);
+
 /* grn_encoding */
-/**
- * grn_encoding_to_string:
- * @encoding: The encoding.
- *
- * Returns string representation for the encoding. For example,
- * 'grn_encoding_to_string(GRN_ENC_UTF8)' returns '"utf8"'.
- *
- * "unknown" is returned for invalid encoding.
- **/
-GRN_API const char *grn_encoding_to_string(grn_encoding encoding);
 
-/**
- * grn_encoding_parse:
- * @name: The encoding name.
- *
- * Parses encoding name and returns grn_encoding.
- * For example, 'grn_encoding_to_string("UTF8")' returns 'GRN_ENC_UTF8'.
- *
- * 'GRN_ENC_UTF8' is returned for invalid encoding name.
- **/
+GRN_API const char *grn_encoding_to_string(grn_encoding encoding);
 GRN_API grn_encoding grn_encoding_parse(const char *name);
 
 /* obj */
@@ -511,18 +398,6 @@ struct _grn_obj {
 
 #define GRN_OBJ_FIN(ctx,obj) (grn_obj_close((ctx), (obj)))
 
-/**
- * grn_db_create:
- * @path: 作成するdbを格納するファイルパス。NULLならtemporary dbとなる。
- * NULL以外のパスを指定した場合はpersistent dbとなる。
- * @optarg: 作成するdbの組み込み型の名前を変更する時に指定する。
- * optarg.builtin_type_namesには組み込み型の名前となるnul終端文字列の配列を指定する。
- * optarg.n_builtin_type_namesには、optarg.builtin_type_namesで指定する文字列の数を
- * 指定する。配列のoffsetはenum型grn_builtin_typeの値に対応する。
- *
- * 新たなdbを作成する。
- **/
-
 typedef struct _grn_db_create_optarg grn_db_create_optarg;
 
 struct _grn_db_create_optarg {
@@ -535,61 +410,13 @@ GRN_API grn_obj *grn_db_create(grn_ctx *ctx, const char *path, grn_db_create_opt
 #define GRN_DB_OPEN_OR_CREATE(ctx,path,optarg,db) \
   (((db) = grn_db_open((ctx), (path))) || (db = grn_db_create((ctx), (path), (optarg))))
 
-/**
- * grn_db_open:
- * @path: 開こうとするdbを格納するファイルパス。
- *
- * 既存のdbを開く。
- **/
 GRN_API grn_obj *grn_db_open(grn_ctx *ctx, const char *path);
-
-/**
- * grn_db_touch:
- * @db: 内容が変更されたdbを指定します。
- *
- * dbの内容の最終更新時刻を現在時刻にします。最終更新時刻は
- * キャッシュが有効かどうかの判断などに利用されます。
- **/
 GRN_API void grn_db_touch(grn_ctx *ctx, grn_obj *db);
 
-/**
- * grn_ctx_use:
- * @db: ctxが使用するdbを指定します。
- *
- * ctxが操作対象とするdbを指定します。NULLを指定した場合は、
- * dbを操作しない状態(init直後の状態)になります。
- *
- * Don't use it with grn_ctx that has GRN_CTX_PER_DB flag.
- **/
 GRN_API grn_rc grn_ctx_use(grn_ctx *ctx, grn_obj *db);
-
-/**
- * grn_ctx_db:
- *
- * ctxが現在操作対象としているdbを返します。
- * dbを使用していない場合はNULLを返します。
- **/
 GRN_API grn_obj *grn_ctx_db(grn_ctx *ctx);
-
-/**
- * grn_ctx_get:
- * @name: 検索しようとするオブジェクトの名前。
- * @name_size: The number of bytes of @name. If negative value is specified,
- *   @name is assumed that NULL-terminated string.
- *
- * ctxが使用するdbからnameに対応するオブジェクトを検索して返す。
- * nameに一致するオブジェクトが存在しなければNULLを返す。
- **/
 GRN_API grn_obj *grn_ctx_get(grn_ctx *ctx, const char *name, int name_size);
 
-/**
- * grn_ctx_at:
- * @id: 検索しようとするオブジェクトのid。
- *
- * ctx、またはctxが使用するdbからidに対応するオブジェクトを検索して返す。
- * idに一致するオブジェクトが存在しなければNULLを返す。
- **/
-
 typedef enum {
   GRN_DB_VOID = 0,
   GRN_DB_DB,
@@ -622,17 +449,6 @@ typedef enum {
 
 GRN_API grn_obj *grn_ctx_at(grn_ctx *ctx, grn_id id);
 
-/**
- * grn_type_create:
- * @name: 作成するtypeの名前。
- * @flags: GRN_OBJ_KEY_VAR_SIZE, GRN_OBJ_KEY_FLOAT, GRN_OBJ_KEY_INT, GRN_OBJ_KEY_UINT
- *        のいずれかを指定
- * @size: GRN_OBJ_KEY_VAR_SIZEの場合は最大長、
- *        それ以外の場合は長さを指定(単位:byte)
- *
- * nameに対応する新たなtype(型)をdbに定義する。
- **/
-
 GRN_API grn_obj *grn_type_create(grn_ctx *ctx, const char *name, unsigned int name_size,
                                  grn_obj_flags flags, unsigned int size);
 
@@ -641,21 +457,6 @@ GRN_API grn_rc grn_plugin_register_by_path(grn_ctx *ctx, const char *path);
 GRN_API const char *grn_plugin_get_system_plugins_dir(void);
 GRN_API const char *grn_plugin_get_suffix(void);
 
-/**
- * grn_proc_create:
- * @name: 作成するprocの名前。
- * @name_size: The number of bytes of @name. If negative value is specified,
- *   @name is assumed that NULL-terminated string.
- * @type: procの種類。
- * @init: 初期化関数のポインタ
- * @next: 実処理関数のポインタ
- * @fin: 終了関数のポインタ
- * @nvars: procで使用する変数の数
- * @vars: procで使用する変数の定義(grn_expr_var構造体の配列)
- *
- * nameに対応する新たなproc(手続き)をctxが使用するdbに定義する。
- **/
-
 typedef struct {
   const char *name;
   unsigned int name_size;
@@ -676,15 +477,6 @@ GRN_API grn_obj *grn_proc_create(grn_ctx *ctx,
                                  const char *name, int name_size, grn_proc_type type,
                                  grn_proc_func *init, grn_proc_func *next, grn_proc_func *fin,
                                  unsigned int nvars, grn_expr_var *vars);
-/**
- * grn_proc_vars:
- * @user_data: grn_proc_funcに渡されたuser_data
- * @nvars: 変数の数
- *
- * user_dataをキーとして、現在実行中のgrn_proc_func関数および
- * 定義されている変数(grn_expr_var)の配列とその数を取得する。
- **/
-
 GRN_API grn_obj *grn_proc_get_info(grn_ctx *ctx, grn_user_data *user_data,
                                    grn_expr_var **vars, unsigned int *nvars, grn_obj **caller);
 
@@ -694,27 +486,6 @@ GRN_API grn_obj *grn_proc_get_info(grn_ctx *ctx, grn_user_data *user_data,
 
 #define GRN_TABLE_MAX_KEY_SIZE         (0x1000)
 
-/**
- * grn_table_create:
- * @name: 作成するtableの名前。NULLなら無名tableとなる。
- *        persistent dbに対して名前をありのtableを作成するときには、
- *        flagsにGRN_OBJ_PERSISTENTが指定されていなければならない。
- * @path: 作成するtableのファイルパス。
- *        flagsにGRN_OBJ_PERSISTENTが指定されている場合のみ有効。
- *        NULLなら自動的にファイルパスが付与される。
- * @flags: GRN_OBJ_PERSISTENTを指定すると永続tableとなる。
- *         GRN_OBJ_TABLE_PAT_KEY,GRN_OBJ_TABLE_HASH_KEY,GRN_OBJ_TABLE_NO_KEY
- *         のいずれかを指定する。
- *         GRN_OBJ_KEY_NORMALIZEを指定すると正規化された文字列がkeyとなる。
- *         GRN_OBJ_KEY_WITH_SISを指定するとkey文字列の全suffixが自動的に登録される。
- * @key_type: keyの型を指定する。GRN_OBJ_TABLE_NO_KEYが指定された場合は無効。
- *            既存のtypeあるいはtableを指定できる。
- *            key_typeにtable Aを指定してtable Bを作成した場合、Bは必ずAのサブセットとなる。
- * @value_type: keyに対応する値を格納する領域の型。tableはcolumnとは別に、
- *              keyに対応する値を格納する領域を一つだけ持つことができる。
- *
- * nameに対応する新たなtableをctxが使用するdbに定義する。
- **/
 GRN_API grn_obj *grn_table_create(grn_ctx *ctx,
                                   const char *name, unsigned int name_size,
                                   const char *path, grn_obj_flags flags,
@@ -724,134 +495,24 @@ GRN_API grn_obj *grn_table_create(grn_ctx *ctx,
   (((table) = grn_ctx_get((ctx), (name), (name_size))) ||\
    ((table) = grn_table_create((ctx), (name), (name_size), (path), (flags), (key_type), (value_type))))
 
-/**
- * grn_table_add:
- * @table: 対象table
- * @key: 検索key
- * @added: NULL以外の値が指定された場合、
- * 新たにrecordが追加された時には1が、既存recordだった時には0がセットされる。
- *
- * keyに対応する新しいrecordをtableに追加し、そのIDを返す。
- * keyに対応するrecordがすでにtableに存在するならば、そのrecordのIDを返す。
- * GRN_OBJ_TABLE_NO_KEYが指定されたtableでは、key, key_size は無視される。
- **/
 /* TODO: int *added -> grn_bool *added */
 GRN_API grn_id grn_table_add(grn_ctx *ctx, grn_obj *table,
                              const void *key, unsigned int key_size, int *added);
-
-/**
- * grn_table_get:
- * @table: The table or database
- * @key: The record or object key to be found
- *
- * It finds a record that has @key and returns ID of the
- * found record. If @table is a database, it finds an object
- * (table, column and so on) that has @key and returns ID of
- * the found object.
- **/
 GRN_API grn_id grn_table_get(grn_ctx *ctx, grn_obj *table,
                              const void *key, unsigned int key_size);
-
-
-/**
- * grn_table_at:
- * @table: 対象table
- * @id: 検索id
- *
- * tableにidに対応するrecordが存在するか確認し、存在すれば指定されたIDを、
- * 存在しなければGRN_ID_NILを返します。
- * 注意: 実行には相応のコストがかかるのであまり頻繁に呼ばないようにして下さい。
- **/
 GRN_API grn_id grn_table_at(grn_ctx *ctx, grn_obj *table, grn_id id);
-
-
-/**
- * grn_table_lcp_search:
- * @table: 対象table
- * @key: 検索key
- *
- * tableがGRN_TABLE_PAT_KEYもしくはGRN_TABLE_DAT_KEYを指定して作ったtableなら、
- * longest common prefix searchを行い、対応するIDを返す。
- * tableがGRN_TABLE_HASH_KEYを指定して作ったtableなら、
- * 完全に一致するキーを検索し、対応するIDを返す。
- **/
 GRN_API grn_id grn_table_lcp_search(grn_ctx *ctx, grn_obj *table,
                                     const void *key, unsigned int key_size);
-
-/**
- * grn_table_get_key:
- * @table: 対象table
- * @id: 対象レコードのID
- * @keybuf: keyを格納するバッファ(呼出側で準備する)
- * @buf_size: keybufのサイズ(byte長)
- *
- * tableのIDに対応するレコードのkeyを取得する。対応するレコードが存在する場合はkey長を返す。
- * 見つからない場合は0を返す。
- * 対応するキーの検索に成功し、またbuf_sizeの長さがkey長以上であった場合は、
- * keybufに該当するkeyをコピーする。
- *
- **/
 GRN_API int grn_table_get_key(grn_ctx *ctx, grn_obj *table,
                               grn_id id, void *keybuf, int buf_size);
-
-/**
- * grn_table_delete:
- * @table: 対象table
- * @key: 検索key
- * @key_size: 検索keyのサイズ
- *
- * tableのkeyに対応するレコードを削除する。
- * 対応するレコードが存在しない場合はGRN_INVALID_ARGUMENTを返す。
- **/
 GRN_API grn_rc grn_table_delete(grn_ctx *ctx, grn_obj *table,
                                 const void *key, unsigned int key_size);
-
-/**
- * grn_table_delete_by_id:
- * @table: 対象table
- * @id: レコードID
- *
- * tableのidに対応するレコードを削除する。
- * 対応するレコードが存在しない場合はGRN_INVALID_ARGUMENTを返す。
- **/
 GRN_API grn_rc grn_table_delete_by_id(grn_ctx *ctx, grn_obj *table, grn_id id);
-
-/**
- * grn_table_update_by_id:
- * @table: 対象table
- * @id: レコードID
- *
- * tableのidに対応するレコードのkeyを変更する。
- * 新しいkeyとそのbyte長をdest_keyとdest_key_sizeに指定する。
- * この操作は、GRN_TABLE_DAT_KEY型のテーブルのみ使用できる。
- **/
 GRN_API grn_rc grn_table_update_by_id(grn_ctx *ctx, grn_obj *table, grn_id id,
                                       const void *dest_key, unsigned int dest_key_size);
-
-/**
- * grn_table_update:
- * @table: 対象table
- * @src_key: 対象レコードのkey
- * @src_key_size: 対象レコードのkeyの長さ(byte)
- * @dest_key: 変更後のkey
- * @dest_key_size: 変更後のkeyの長さ(byte)
- *
- * tableのsrc_keyに対応するレコードのkeyを変更する。
- * 新しいkeyとそのbyte長をdest_keyとdest_key_sizeに指定する。
- * この操作は、GRN_TABLE_DAT_KEY型のテーブルのみ使用できる。
- **/
 GRN_API grn_rc grn_table_update(grn_ctx *ctx, grn_obj *table,
                                 const void *src_key, unsigned int src_key_size,
                                 const void *dest_key, unsigned int dest_key_size);
-
-/**
- * grn_table_truncate:
- * @table: 対象table
- *
- * tableの全レコードを一括して削除する。
- * 注意: multithread環境では他のthreadのアクセスによって
- *       存在しないアドレスへアクセスし、SIGSEGVが発生する可能性がある。
- **/
 GRN_API grn_rc grn_table_truncate(grn_ctx *ctx, grn_obj *table);
 
 typedef grn_obj grn_table_cursor;
@@ -868,150 +529,17 @@ typedef grn_obj grn_table_cursor;
 #define GRN_CURSOR_SIZE_BY_BIT         (0x01<<5)
 #define GRN_CURSOR_RK                  (0x01<<6)
 
-/**
- * grn_table_cursor_open:
- * @table: 対象table
- * @min: keyの下限 (NULLは下限なしと見なす)、GRN_CURSOR_PREFIXについては後述
- * @min_size: @minのsize、GRN_CURSOR_PREFIXについては後述
- * @max: keyの上限 (NULLは上限なしと見なす)、GRN_CURSOR_PREFIXについては後述
- * @max_size: @maxのsize、GRN_CURSOR_PREFIXについては無視される場合がある
- * @flags: GRN_CURSOR_ASCENDINGを指定すると昇順にレコードを取り出す。
- *
- *         GRN_CURSOR_DESCENDINGを指定すると降順にレコードを取り出す。
- *         (下記GRN_CURSOR_PREFIXを指定し、
- *          keyが近いレコードを取得する場合、
- *          もしくは、common prefix searchを行う場合には、
- *          GRN_CURSOR_ASCENDING/DESCENDINGは無視される)
- *
- *         GRN_CURSOR_GTを指定するとminに一致したkeyをcursorの範囲に含まない。
- *         (minがNULLの場合もしくは、下記GRN_CURSOR_PREFIXを指定し、
- *          keyが近いレコードを取得する場合、
- *          もしくは、common prefix searchを行う場合には、
- *          GRN_CURSOR_GTは無視される)
- *
- *         GRN_CURSOR_LTを指定するとmaxに一致したkeyをcursorの範囲に含まない。
- *         (maxがNULLの場合もしくは、下記GRN_CURSOR_PREFIXを指定した場合には、
- *          GRN_CURSOR_LTは無視される)
- *
- *         GRN_CURSOR_BY_IDを指定するとID順にレコードを取り出す。
- *         (下記GRN_CURSOR_PREFIXを指定した場合には、
- *          GRN_CURSOR_BY_IDは無視される)
- *         GRN_OBJ_TABLE_PAT_KEYを指定したtableについては、
- *         GRN_CURSOR_BY_KEYを指定するとkey順にレコードを取り出す。
- *         (GRN_OBJ_TABLE_HASH_KEY,GRN_OBJ_TABLE_NO_KEYを指定したテーブルでは
- *          GRN_CURSOR_BY_KEYは無視される)
- *
- *         GRN_CURSOR_PREFIXを指定すると、
- *         GRN_OBJ_TABLE_PAT_KEYを指定したテーブルに関する
- *         下記のレコードを取り出すカーソルが作成される。
- *
- *         maxがNULLの場合には、keyがminと前方一致するレコードを取り出す。
- *         max_sizeパラメータは無視される。
- *
- *         maxとmax_sizeが指定され、かつ、テーブルのkeyがShortText型である場合、
- *         maxとcommon prefix searchを行い、
- *         common prefixがmin_sizeバイト以上のレコードを取り出す。
- *         minは無視される。
- *
- *         maxとmax_sizeが指定され、かつ、テーブルのkeyが固定長型の場合、
- *         maxとPAT木上で近い位置にあるノードから順番にレコードを取り出す。
- *         ただし、keyのパトリシア木で、min_sizeバイト未満のビットに対する
- *         ノードで、maxと異なった方向にあるノードに対応するレコードについては
- *         取り出さない。
- *         PAT木上で位置が近いこととkeyの値が近いことは同一ではない。
- *         この場合、maxで与えられるポインタが指す値は、
- *         対象テーブルのkeyサイズと同じか超える幅である必要がある。
- *         minは無視される。
- *
- *         GRN_CURSOR_BY_ID/GRN_CURSOR_BY_KEY/GRN_CURSOR_PREFIXの3フラグは、
- *         同時に指定することができない。
- *
- *         GRN_OBJ_TABLE_PAT_KEYを指定して作ったテーブルで、
- *         GRN_CURSOR_PREFIXとGRN_CURSOR_RKを指定すると、
- *         半角小文字のアルファベット文字列から、それを旧JIS X 4063:2000規格に
- *         従って全角カタカナに変換した文字列に前方一致する値をkeyとするレコードを
- *         取り出す。GRN_ENC_UTF8のみをサポートしている。
- *         GRN_CURSOR_ASCENDING/DESCENDINGは無効であり、レコードをkey値の昇降順で
- *         取り出すことはできない。
- *
- * @offset: 該当する範囲のレコードのうち、
- *          (0ベースで)offset番目からレコードを取り出す。
- *
- *         GRN_CURSOR_PREFIXを指定したときは負の数を指定する
- *         ことはできない。
- * @limit: 該当する範囲のレコードのうち、limit件のみを取り出す。
- *         -1が指定された場合は、全件が指定されたものとみなす。
- *
- *         GRN_CURSOR_PREFIXを指定したときは-1より小さい負の
- *         数を指定することはできない。
- *
- * tableに登録されているレコードを順番に取り出すためのカーソルを生成して返す。
- **/
 GRN_API grn_table_cursor *grn_table_cursor_open(grn_ctx *ctx, grn_obj *table,
                                                 const void *min, unsigned int min_size,
                                                 const void *max, unsigned int max_size,
                                                 int offset, int limit, int flags);
-
-/**
- * grn_table_cursor_close:
- * @tc: 対象cursor
- *
- * grn_table_cursor_openで生成したcursorを解放する。
- **/
 GRN_API grn_rc grn_table_cursor_close(grn_ctx *ctx, grn_table_cursor *tc);
-
-/**
- * grn_table_cursor_next:
- * @tc: 対象cursor
- *
- * cursorのカレントレコードを一件進めてそのIDを返す。
- * cursorの対象範囲の末尾に達するとGRN_ID_NILを返す。
- **/
 GRN_API grn_id grn_table_cursor_next(grn_ctx *ctx, grn_table_cursor *tc);
-
-/**
- * grn_table_cursor_get_key:
- * @tc: 対象cursor
- * @key: カレントレコードのkeyへのポインタがセットされる。
- * cursorのカレントレコードのkeyを@keyにセットし、その長さを返す。
- **/
 GRN_API int grn_table_cursor_get_key(grn_ctx *ctx, grn_table_cursor *tc, void **key);
-
-/**
- * grn_table_cursor_get_value:
- * @tc: 対象cursor
- * @value: カレントレコードのvalueへのポインタがセットされる。
- * cursorのカレントレコードのvalueを@valueにセットし、その長さを返す。
- **/
 GRN_API int grn_table_cursor_get_value(grn_ctx *ctx, grn_table_cursor *tc, void **value);
-
-/**
- * grn_table_cursor_set_value:
- * @tc: 対象cursor
- * @value: 新しいvalueの値。
- * @flags: grn_obj_set_valueのflagsと同様の値を指定できる。
- *
- * cursorのカレントレコードのvalueを引数の内容に置き換える。
- * cursorのカレントレコードが存在しない場合はGRN_INVALID_ARGUMENTを返す。
- **/
 GRN_API grn_rc grn_table_cursor_set_value(grn_ctx *ctx, grn_table_cursor *tc,
                                           const void *value, int flags);
-
-/**
- * grn_table_cursor_delete:
- * @tc: 対象cursor
- *
- * cursorのカレントレコードを削除する。
- * cursorのカレントレコードが存在しない場合はGRN_INVALID_ARGUMENTを返す。
- **/
 GRN_API grn_rc grn_table_cursor_delete(grn_ctx *ctx, grn_table_cursor *tc);
-
-/**
- * grn_table_cursor_table:
- * @tc: 対象cursor
- *
- * cursorが属するtableを返す。
- **/
 GRN_API grn_obj *grn_table_cursor_table(grn_ctx *ctx, grn_table_cursor *tc);
 
 typedef struct {
@@ -1023,31 +551,8 @@ typedef struct {
   unsigned int rest;
 } grn_posting;
 
-/**
- * grn_index_cursor_open
- * @tc: 対象cursor
- * @index: 対象インデックスカラム
- * @rid_min: 出力するレコードidの下限
- * @rid_max: 出力するレコードidの上限
- *
- * grn_table_cursorから取得できるそれぞれのレコードについて、
- * GRN_OBJ_COLUMN_INDEX型のカラムの値を順番に取り出すためのカーソルを生成して返す。
- * rid_min,rid_maxを指定して取得するレコードidの値を制限することができる。
- * 戻り値であるgrn_index_cursorはgrn_obj_closeを使って解放する。
- **/
 GRN_API grn_obj *grn_index_cursor_open(grn_ctx *ctx, grn_table_cursor *tc, grn_obj *index,
                                        grn_id rid_min, grn_id rid_max, int flags);
-
-/**
- * grn_index_cursor_next
- * @ic: 対象cursor
- * @tid: テーブルレコードID
- *
- * cursorの範囲内のインデックスの値を順番に取り出す。
- * tidにNULL以外を指定した場合は、
- * index_cursorを作成するときに指定したtable_cursorの現在の対象レコードのidを返す。
- * 戻り値であるgrn_posting構造体は解放する必要はない。
- **/
 GRN_API grn_posting *grn_index_cursor_next(grn_ctx *ctx, grn_obj *ic, grn_id *tid);
 
 #define GRN_TABLE_EACH(ctx,table,head,tail,id,key,key_size,value,block) do {\
@@ -1081,22 +586,6 @@ GRN_API grn_posting *grn_index_cursor_next(grn_ctx *ctx, grn_obj *ic, grn_id *ti
   }\
 } while (0)
 
-/**
- * grn_table_sort:
- * @table: 対象table
- * @offset: sortされたレコードのうち、(0ベースで)offset番目から順にresにレコードを格納する
- * @limit: resに格納するレコードの上限
- * @result: 結果を格納するtable
- * @keys: ソートキー配列へのポインタ
- * @n_keys: ソートキー配列のサイズ
- *
- * table内のレコードをソートし、上位limit個の要素をresultに格納する。
- * keys.keyには、tableのcolumn,accessor,procのいずれかが指定できる。
- * keys.flagsには、GRN_TABLE_SORT_ASC/GRN_TABLE_SORT_DESCのいずれかを指定できる。
- * GRN_TABLE_SORT_ASCでは昇順、GRN_TABLE_SORT_DESCでは降順でソートされる。
- * keys.offsetは、内部利用のためのメンバである。
- **/
-
 typedef struct _grn_table_sort_key grn_table_sort_key;
 typedef unsigned char grn_table_sort_flags;
 
@@ -1112,17 +601,6 @@ struct _grn_table_sort_key {
 GRN_API int grn_table_sort(grn_ctx *ctx, grn_obj *table, int offset, int limit,
                            grn_obj *result, grn_table_sort_key *keys, int n_keys);
 
-/**
- * grn_table_group:
- * @table: 対象table
- * @keys: group化キー構造体の配列へのポインタ
- * @n_keys: group化キー構造体の配列のサイズ
- * @results: group化の結果を格納する構造体の配列へのポインタ
- * @n_results:group化の結果を格納する構造体の配列のサイズ
- *
- * tableのレコードを特定の条件でグループ化する
- **/
-
 typedef struct _grn_table_group_result grn_table_group_result;
 typedef unsigned int grn_table_group_flags;
 
@@ -1226,100 +704,23 @@ struct _grn_table_group_result {
 GRN_API grn_rc grn_table_group(grn_ctx *ctx, grn_obj *table,
                                grn_table_sort_key *keys, int n_keys,
                                grn_table_group_result *results, int n_results);
-
-/**
- * grn_table_setoperation:
- * @table1: 対象table1
- * @table2: 対象table2
- * @res: 結果を格納するtable
- * @op: 実行する演算の種類
- *
- * table1とtable2をopの指定に従って集合演算した結果をresに格納する。
- * resにtable1あるいはtable2そのものを指定した場合を除けば、table1, table2は破壊されない。
- **/
 GRN_API grn_rc grn_table_setoperation(grn_ctx *ctx, grn_obj *table1, grn_obj *table2,
                                       grn_obj *res, grn_operator op);
-
-/**
- * grn_table_difference:
- * @table1: 対象table1
- * @table2: 対象table2
- * @res1: 結果を格納するtable
- * @res2: 結果を格納するtable
- *
- * table1とtable2から重複するレコードを取り除いた結果をそれぞれres1, res2に格納する。
- **/
 GRN_API grn_rc grn_table_difference(grn_ctx *ctx, grn_obj *table1, grn_obj *table2,
                                     grn_obj *res1, grn_obj *res2);
-
-/**
- * grn_table_columns:
- * @table: 対象table
- * @name: 取得したいカラム名のprefix
- * @name_size: @nameの長さ
- * @res: 結果を格納するGRN_TABLE_HASH_KEYのtable
- *
- * @nameから始まるtableのカラムIDを@resに格納する。
- * @name_sizeが0の場合はすべてのカラムIDを格納する。格納した
- * カラムIDの数を返す。
- **/
 GRN_API int grn_table_columns(grn_ctx *ctx, grn_obj *table,
                               const char *name, unsigned int name_size,
                               grn_obj *res);
 
-/**
- * grn_obj_column:
- * @table: 対象table
- * @name: カラム名
- *
- * nameがカラム名の場合、それに対応するtableのカラムを返す。
- * 対応するカラムが存在しなければNULLを返す。
- * nameはアクセサ文字列の場合、それに対応するaccessorを返す。
- * アクセサ文字列とは、カラム名等を'.'で連結した文字列である。
- * '_id', '_key'は特殊なアクセサで、それぞれレコードID/keyを返す。
- * 例) 'col1' / 'col2.col3' / 'col2._id'
- **/
 GRN_API grn_obj *grn_obj_column(grn_ctx *ctx, grn_obj *table,
                                 const char *name, unsigned int name_size);
 
-
-/**
- * grn_table_size:
- * @table: 対象table
- *
- * tableに登録されているレコードの件数を返す。
- **/
 GRN_API unsigned int grn_table_size(grn_ctx *ctx, grn_obj *table);
 
 /*-------------------------------------------------------------
  * column操作のための関数
  */
 
-/**
- * grn_column_create:
- * @table: 対象table
- * @name: カラム名
- * @name_size: @nameのsize(byte)
- * @path: カラムを格納するファイルパス。
- *        flagsにGRN_OBJ_PERSISTENTが指定されている場合のみ有効。
- *        NULLなら自動的にファイルパスが付与される。
- * @flags: GRN_OBJ_PERSISTENTを指定すると永続columnとなる。
- *         GRN_OBJ_COLUMN_INDEXを指定すると転置インデックスとなる。
- *         GRN_OBJ_COLUMN_SCALARを指定するとスカラ値(単独の値)を格納する。
- *         GRN_OBJ_COLUMN_VECTORを指定すると値の配列を格納する。
- *         GRN_OBJ_COMPRESS_ZLIBを指定すると値をzlib圧縮して格納する。
- *         GRN_OBJ_COMPRESS_LZOを指定すると値をlzo圧縮して格納する。
- *         GRN_OBJ_COLUMN_INDEXと共にGRN_OBJ_WITH_SECTIONを指定すると、
- *         転置索引にsection(段落情報)を合わせて格納する。
- *         GRN_OBJ_COLUMN_INDEXと共にGRN_OBJ_WITH_WEIGHTを指定すると、
- *         転置索引にweight情報を合わせて格納する。
- *         GRN_OBJ_COLUMN_INDEXと共にGRN_OBJ_WITH_POSITIONを指定すると、
- *         転置索引に出現位置情報を合わせて格納する。
- * @type: カラム値の型。定義済みのtypeあるいはtableを指定できる。
- *
- * tableに新たなカラムを定義する。nameは省略できない。
- * 一つのtableに同一のnameのcolumnを複数定義することはできない。
- **/
 GRN_API grn_obj *grn_column_create(grn_ctx *ctx, grn_obj *table,
                                    const char *name, unsigned int name_size,
                                    const char *path, grn_obj_flags flags, grn_obj *type);
@@ -1328,28 +729,9 @@ GRN_API grn_obj *grn_column_create(grn_ctx *ctx, grn_obj *table,
   (((column) = grn_obj_column((ctx), (table), (name), (name_size))) ||\
    ((column) = grn_column_create((ctx), (table), (name), (name_size), (path), (flags), (type))))
 
-/**
- * grn_column_index_update
- * @column: 対象column
- * @id: 対象レコードのID
- * @section: 対象レコードのセクション番号
- * @oldvalue: 更新前の値
- * @newvalue: 更新後の値
- *
- * oldvalue, newvalueの値から得られるキーに対応するcolumnの値の中の、
- * id, sectionに対応するエントリを更新する。
- * columnはGRN_OBJ_COLUMN_INDEX型のカラムでなければならない。
- **/
 GRN_API grn_rc grn_column_index_update(grn_ctx *ctx, grn_obj *column,
                                        grn_id id, unsigned int section,
                                        grn_obj *oldvalue, grn_obj *newvalue);
-
-/**
- * grn_column_table:
- * @column: 対象column
- *
- * columnが属するtableを返す。
- **/
 GRN_API grn_obj *grn_column_table(grn_ctx *ctx, grn_obj *column);
 
 /*-------------------------------------------------------------
@@ -1391,87 +773,16 @@ typedef enum {
   GRN_INFO_NORMALIZER
 } grn_info_type;
 
-/**
- * grn_obj_get_info:
- * @obj: 対象obj
- * @type: 取得する情報の種類
- * @valuebuf: 値を格納するバッファ(呼出側で準備)
- *
- * objのtypeに対応する情報をvaluebufに格納する。
- **/
 GRN_API grn_obj *grn_obj_get_info(grn_ctx *ctx, grn_obj *obj, grn_info_type type, grn_obj *valuebuf);
-
-/**
- * grn_obj_set_info:
- * @obj: 対象obj
- * @type: 設定する情報の種類
- * @value: 設定しようとする値
- *
- * objのtypeに対応する情報をvalueの内容に更新する。
- **/
 GRN_API grn_rc grn_obj_set_info(grn_ctx *ctx, grn_obj *obj, grn_info_type type, grn_obj *value);
-
-/**
- * grn_obj_get_element_info:
- * @obj: 対象obj
- * @id: 対象ID
- * @type: 取得する情報の種類
- * @value: 値を格納するバッファ(呼出側で準備)
- *
- * objのidに対応するレコードの、typeに対応する情報をvaluebufに格納する。
- * 呼出側ではtypeに応じて十分なサイズのバッファを確保しなければならない。
- **/
 GRN_API grn_obj *grn_obj_get_element_info(grn_ctx *ctx, grn_obj *obj, grn_id id,
                                           grn_info_type type, grn_obj *value);
-
-/**
- * grn_obj_set_element_info:
- * @obj: 対象object
- * @id: 対象ID
- * @type: 設定する情報の種類
- * @value: 設定しようとする値
- *
- * objのidに対応するレコードのtypeに対応する情報をvalueの内容に更新する。
- **/
 GRN_API grn_rc grn_obj_set_element_info(grn_ctx *ctx, grn_obj *obj, grn_id id,
                                         grn_info_type type, grn_obj *value);
 
-/**
- * c:function:: grn_bool grn_obj_is_builtin(grn_ctx *ctx, grn_obj *obj)
- *
- * Check whether groonga built-in object.
- *
- * :param ctx: context
- * :param obj: target object
- * :retype: ``GRN_TRUE`` for built-in groonga object, ``GRN_FALSE`` otherwise.
- **/
 GRN_API grn_bool grn_obj_is_builtin(grn_ctx *ctx, grn_obj *obj);
 
-/**
- * grn_obj_get_value:
- * @obj: 対象object
- * @id: 対象レコードのID
- * @value: 値を格納するバッファ(呼出側で準備する)
- *
- * objのIDに対応するレコードのvalueを取得する。
- * valueを戻り値として返す。
- **/
 GRN_API grn_obj *grn_obj_get_value(grn_ctx *ctx, grn_obj *obj, grn_id id, grn_obj *value);
-
-/**
- * grn_obj_get_values:
- * @obj: 対象object
- * @offset: 値を取得する範囲の開始位置となるレコードID
- * @values: 値の配列がセットされる
- *
- * objに指定されたカラムについて、offsetに指定されたレコードIDを開始位置として、IDが連続
- * するレコードに対応するカラム値が昇順に格納された配列へのポインタをvaluesにセットします。
- * 取得できた件数が戻り値として返される。エラーが発生した場合は -1 が返されます。
- * 注意: 値が固定長であるカラムのみがobjに指定できます。
- *       範囲内のIDに対応するレコードが有効であるとは限りません。
- *       delete操作を実行したことのあるテーブルに対しては、
- *       grn_table_at()などによって各レコードの存否を別途確認しなければなりません。
- **/
 GRN_API int grn_obj_get_values(grn_ctx *ctx, grn_obj *obj, grn_id offset, void **values);
 
 #define GRN_COLUMN_EACH(ctx,column,id,value,block) do {\
@@ -1484,27 +795,6 @@ GRN_API int grn_obj_get_values(grn_ctx *ctx, grn_obj *obj, grn_id offset, void *
   }\
 } while (0)
 
-/**
- * grn_obj_set_value:
- * @obj: 対象object
- * @id: 対象レコードのID
- * @value: 格納する値
- * @flags: 以下の値を指定できる
- *  GRN_OBJ_SET: レコードの値をvalueと置き換える。
- *  GRN_OBJ_INCR: レコードの値にvalueを加算する。
- *  GRN_OBJ_DECR: レコードの値にvalueを減算する。
- *  GRN_OBJ_APPEND: レコードの値の末尾にvalueを追加する。
- *  GRN_OBJ_PREPEND: レコードの値の先頭にvalueを追加する。
- *  GRN_OBJ_GET: 新しいレコードの値をvalueにセットする。
- *  GRN_OBJ_COMPARE: レコードの値とvalueが等しいか調べる。
- *  GRN_OBJ_LOCK: 当該レコードをロックする。GRN_OBJ_COMPAREと共に指定された場合は、
- *                レコードの値とvalueが等しい場合に限ってロックする。
- *  GRN_OBJ_UNLOCK: 当該レコードのロックを解除する。
- *
- * objのIDに対応するレコードの値を更新する。
- * 対応するレコードが存在しない場合はGRN_INVALID_ARGUMENTを返す。
- **/
-
 #define GRN_OBJ_SET_MASK               (0x07)
 #define GRN_OBJ_SET                    (0x01)
 #define GRN_OBJ_INCR                   (0x02)
@@ -1517,231 +807,45 @@ GRN_API int grn_obj_get_values(grn_ctx *ctx, grn_obj *obj, grn_id offset, void *
 #define GRN_OBJ_UNLOCK                 (0x01<<7)
 
 GRN_API grn_rc grn_obj_set_value(grn_ctx *ctx, grn_obj *obj, grn_id id, grn_obj *value, int flags);
-
-/**
- * grn_obj_remove:
- * @obj: 対象object
- *
- * objをメモリから解放し、それが永続オブジェクトであった場合は、
- * 該当するファイル一式を削除する。
- **/
 GRN_API grn_rc grn_obj_remove(grn_ctx *ctx, grn_obj *obj);
-
-/**
- * grn_obj_rename:
- * @obj: 対象object
- * @name: 新しい名前
- * @name_size: @nameのsize(byte)
- *
- * ctxが使用するdbにおいてobjに対応する名前をnameに更新する。
- * objは永続オブジェクトでなければならない。
- **/
 GRN_API grn_rc grn_obj_rename(grn_ctx *ctx, grn_obj *obj,
                               const char *name, unsigned int name_size);
-
-/**
- * grn_table_rename:
- * @table: 対象table
- * @name: 新しい名前
- * @name_size: @nameのsize(byte)
- *
- * ctxが使用するdbにおいてtableに対応する名前をnameに更新する。
- * tableの全てのcolumnも同時に名前が変更される。
- * tableは永続オブジェクトでなければならない。
- **/
 GRN_API grn_rc grn_table_rename(grn_ctx *ctx, grn_obj *table,
                                 const char *name, unsigned int name_size);
 
-/**
- * grn_column_rename:
- * @column: 対象column
- * @name: 新しい名前
- * @name_size: @nameのsize(byte)
- *
- * ctxが使用するdbにおいてcolumnに対応する名前をnameに更新する。
- * columnは永続オブジェクトでなければならない。
- **/
 GRN_API grn_rc grn_column_rename(grn_ctx *ctx, grn_obj *column,
                                  const char *name, unsigned int name_size);
 
-/**
- * grn_obj_close:
- * @obj: 対象object
- *
- * 一時的なobjectであるobjをメモリから解放する。
- * objに属するobjectも再帰的にメモリから解放される。
- * 永続的な、table・column・exprなどは解放してはならない。
- * 一般的には、一時的か永続的かを気にしなくてよいgrn_obj_unlinkを用いるべき。
- **/
 GRN_API grn_rc grn_obj_close(grn_ctx *ctx, grn_obj *obj);
-
-/**
- * grn_obj_reinit:
- * @obj: 対象object
- * @domain: 変更後のobjの型
- * @flags: GRN_OBJ_VECTORを指定するとdomain型の値のベクタを格納するオブジェクトになる。
- *
- * objの型を変更する。objはGRN_OBJ_INITマクロなどで初期化済みでなければならない。
- **/
 GRN_API grn_rc grn_obj_reinit(grn_ctx *ctx, grn_obj *obj, grn_id domain, unsigned char flags);
-
-/**
- * grn_obj_unlink:
- * @obj: 対象object
- *
- * objをメモリから解放する。
- * objに属するobjectも再帰的にメモリから解放される。
- **/
 GRN_API void grn_obj_unlink(grn_ctx *ctx, grn_obj *obj);
 
-/**
- * grn_obj_user_data
- * @obj: 対象object
- *
- * objectに登録できるユーザデータへのポインタを返す。table, column, proc, exprのみ使用可能。
- **/
 GRN_API grn_user_data *grn_obj_user_data(grn_ctx *ctx, grn_obj *obj);
 
-/**
- * grn_obj_set_finalizer
- * @obj: 対象object
- * @func: objectを破棄するときに呼ばれる関数
- *
- * objectを破棄するときに呼ばれる関数を設定する。table, column, proc, exprのみ設定可能。
- **/
 GRN_API grn_rc grn_obj_set_finalizer(grn_ctx *ctx, grn_obj *obj, grn_proc_func *func);
 
-/**
- * grn_obj_path:
- * @obj: 対象object
- *
- * objに対応するファイルパスを返す。一時objectならNULLを返す。
- **/
 GRN_API const char *grn_obj_path(grn_ctx *ctx, grn_obj *obj);
-
-/**
- * grn_obj_name:
- * @obj: 対象object
- * @namebuf: 名前を格納するバッファ(呼出側で準備する)
- * @buf_size: namebufのサイズ(byte長)
- *
- * objの名前の長さを返す。無名objectなら0を返す。
- * 名前付きのobjectであり、buf_sizeの長さが名前の長以上であった場合は、
- * namebufに該当する名前をコピーする。
- **/
 GRN_API int grn_obj_name(grn_ctx *ctx, grn_obj *obj, char *namebuf, int buf_size);
 
-/**
- * grn_column_name:
- * @obj: 対象object
- * @namebuf: 名前を格納するバッファ(呼出側で準備する)
- * @buf_size: namebufのサイズ(byte長)
- *
- * カラムobjの名前の長さを返す。
- * buf_sizeの長さが名前の長以上であった場合は、
- * namebufに該当する名前をコピーする。
- **/
 GRN_API int grn_column_name(grn_ctx *ctx, grn_obj *obj, char *namebuf, int buf_size);
 
-/**
- * grn_obj_get_range:
- * @obj: 対象object
- *
- * @objのとる値の範囲を表わしているオブジェクトのIDを返す。
- * 例えば、grn_builtin_typeにあるGRN_DB_INTなどを返す。
- **/
 GRN_API grn_id grn_obj_get_range(grn_ctx *ctx, grn_obj *obj);
 
 #define GRN_OBJ_GET_DOMAIN(obj) \
   ((obj)->header.type == GRN_TABLE_NO_KEY ? GRN_ID_NIL : (obj)->header.domain)
 
-/**
- * grn_obj_expire:
- * @obj: 対象object
- *
- * objの占有するメモリのうち、可能な領域をthresholdを指標として解放する。
- **/
 GRN_API int grn_obj_expire(grn_ctx *ctx, grn_obj *obj, int threshold);
-
-/**
- * grn_obj_check:
- * @obj: 対象object
- *
- * objに対応するファイルの整合性を検査する。
- **/
 GRN_API int grn_obj_check(grn_ctx *ctx, grn_obj *obj);
-
-/**
- * grn_obj_lock:
- * @obj: 対象object
- *
- * objをlockする。timeout(秒)経過してもlockを取得できない場合は
- * GRN_RESOURCE_DEADLOCK_AVOIDEDを返す。
- **/
 GRN_API grn_rc grn_obj_lock(grn_ctx *ctx, grn_obj *obj, grn_id id, int timeout);
-
-/**
- * grn_obj_unlock:
- * @obj: 対象object
- *
- * objをunlockする。
- **/
 GRN_API grn_rc grn_obj_unlock(grn_ctx *ctx, grn_obj *obj, grn_id id);
-
-/**
- * grn_obj_clear_lock:
- * @obj: 対象object
- *
- * 強制的にロックをクリアする。
- **/
 GRN_API grn_rc grn_obj_clear_lock(grn_ctx *ctx, grn_obj *obj);
-
-/**
- * grn_obj_is_locked;
- * @obj: 対象object
- *
- * objが現在lockされていれば0以外の値を返す。
- **/
 GRN_API unsigned int grn_obj_is_locked(grn_ctx *ctx, grn_obj *obj);
-
-/**
- * grn_obj_defrag;
- * @obj: 対象object
- *
- * objの占有するDBファイル領域のうち、可能な領域をthresholdを指標としてフラグメントの解消を行う。
- * フラグメント解消が実行されたセグメントの数を返す。
- **/
 GRN_API int grn_obj_defrag(grn_ctx *ctx, grn_obj *obj, int threshold);
 
-/**
- * grn_obj_db:
- * @obj: 対象object
- *
- * objの属するdbを返す。
- **/
 GRN_API grn_obj *grn_obj_db(grn_ctx *ctx, grn_obj *obj);
 
-/**
- * grn_obj_id:
- * @obj: 対象object
- *
- * objのidを返す。
- **/
 GRN_API grn_id grn_obj_id(grn_ctx *ctx, grn_obj *obj);
 
-
-/**
- * grn_obj_search:
- * @obj: 検索対象のobject
- * @query: 検索クエリ
- * @res: 検索結果を格納するテーブル
- * @op: GRN_OP_OR, GRN_OP_AND, GRN_OP_AND_NOT, GRN_OP_ADJUSTのいずれかを指定する
- * @optarg: 詳細検索条件
- *
- * objを対象としてqueryにマッチするレコードを検索し、
- * opの指定に従ってresにレコードを追加あるいは削除する。
- **/
-
 typedef struct _grn_search_optarg grn_search_optarg;
 
 struct _grn_search_optarg {
@@ -1787,92 +891,19 @@ typedef enum {
   GRN_HOOK_SELECT
 } grn_hook_entry;
 
-/**
- * grn_obj_add_hook:
- * @obj: 対象object
- * @entry: GRN_HOOK_GETは、objectの参照時に呼び出されるhookを定義する。
-          GRN_HOOK_SETは、objectの更新時に呼び出されるhookを定義する。
-          GRN_HOOK_SELECTは、検索処理の実行中に適時呼び出され、
-          処理の実行状況を調べたり、実行の中断を指示することができる。
- * @offset: hookの実行順位。offsetに対応するhookの直前に新たなhookを挿入する。
-            0を指定した場合は先頭に挿入される。-1を指定した場合は末尾に挿入される。
-            objectに複数のhookが定義されている場合は順位の順に呼び出される。
- * @proc: 手続き
- * @data: hook固有情報
- *
- * objに対してhookを追加する。
- **/
 GRN_API grn_rc grn_obj_add_hook(grn_ctx *ctx, grn_obj *obj, grn_hook_entry entry,
                                 int offset, grn_obj *proc, grn_obj *data);
-
-/**
- * grn_obj_get_nhooks:
- * @obj: 対象object
- * @entry: hookタイプ
- *
- * objに定義されているhookの数を返す。
- **/
 GRN_API int grn_obj_get_nhooks(grn_ctx *ctx, grn_obj *obj, grn_hook_entry entry);
-
-/**
- * grn_obj_get_hook:
- * @obj: 対象object
- * @entry: hookタイプ
- * @offset: 実行順位
- * @data: hook固有情報格納バッファ
- *
- * objに定義されているhookの手続き(proc)を返す。hook固有情報が定義されている場合は、
- * その内容をdataにコピーして返す。
- **/
 GRN_API grn_obj *grn_obj_get_hook(grn_ctx *ctx, grn_obj *obj, grn_hook_entry entry,
                                   int offset, grn_obj *data);
-
-/**
- * grn_obj_delete_hook:
- * @obj: 対象object
- * @entry: hookタイプ
- * @offset: 実行順位
- *
- * objに定義されているhookを削除する。
- **/
 GRN_API grn_rc grn_obj_delete_hook(grn_ctx *ctx, grn_obj *obj, grn_hook_entry entry, int offset);
 
 GRN_API grn_obj *grn_obj_open(grn_ctx *ctx, unsigned char type, grn_obj_flags flags, grn_id domain);
 
-/**
- * grn_column_index:
- * @column: 対象のcolumn
- * @op: indexで実行したい操作
- * @indexbuf: indexを格納するバッファ(呼出側で準備する)
- * @buf_size: namebufのサイズ(byte長)
- * @section: section番号を格納するint長バッファ(呼出側で準備する)
- *
- * columnに張られているindexのうち、opの操作を実行可能なものの数を返す。
- * またそれらのidを、buf_sizeに指定された個数を上限としてindexbufに返す。
- **/
 GRN_API int grn_column_index(grn_ctx *ctx, grn_obj *column, grn_operator op,
                              grn_obj **indexbuf, int buf_size, int *section);
 
-
-/**
- * grn_obj_delete_by_id:
- * @db: The target database.
- * @id: The object (table, column and so on) ID to be deleted.
- * @removep: If GRN_TRUE, clear object cache and remove relation
- *   between ID and key in database. Otherwise, just clear object cache.
- *
- * dbからidに対応するテーブルやカラムなどを削除します。mroonga向けに用意した内部APIです。
- **/
 GRN_API grn_rc grn_obj_delete_by_id(grn_ctx *ctx, grn_obj *db, grn_id id, grn_bool removep);
-
-/**
- * grn_obj_path_by_id:
- * @db: The target database.
- * @id: The object (table, column and so on) ID to be deleted.
- * @buffer: path string corresponding to the id will be set in this buffer.
- *
- * dbのidに対応するpathを返します。mroonga向けに用意した内部APIです。
- **/
 GRN_API grn_rc grn_obj_path_by_id(grn_ctx *ctx, grn_obj *db, grn_id id, char *buffer);
 
 /* geo */
@@ -1882,83 +913,22 @@ typedef struct {
   int longitude;
 } grn_geo_point;
 
-
-/**
- * grn_geo_select_in_rectangle:
- * @index: the index column for TokyoGeoPoint or WGS84GeoPpoint type.
- * @top_left_point: the top left point of the target
- * rectangle. (ShortText, Text, LongText, TokyoGeoPoint or
- * WGS84GeoPoint)
- * @bottom_right_point: the bottom right point of the target
- * rectangle. (ShortText, Text, LongText, TokyoGeoPoint or
- * WGS84GeoPoint)
- * @res: the table to store found record IDs. It must be
- * GRN_TABLE_HASH_KEY type table.
- * @op: the operator for matched records.
- *
- * It selects records that are in the rectangle specified by
- * @top_left_point and @bottom_right_point. Records are
- * searched by @index. Found records are added to @res table
- * with @op operation.
- **/
 GRN_API grn_rc grn_geo_select_in_rectangle(grn_ctx *ctx,
                                            grn_obj *index,
                                            grn_obj *top_left_point,
                                            grn_obj *bottom_right_point,
                                            grn_obj *res,
                                            grn_operator op);
-
-/**
- * grn_geo_estimate_in_rectangle:
- * @index: the index column for TokyoGeoPoint or WGS84GeoPpoint type.
- * @top_left_point: the top left point of the target
- * rectangle. (ShortText, Text, LongText, TokyoGeoPoint or
- * WGS84GeoPoint)
- * @bottom_right_point: the bottom right point of the target
- * rectangle. (ShortText, Text, LongText, TokyoGeoPoint or
- * WGS84GeoPoint)
- *
- * It estimates number of records in the rectangle specified
- * by @top_left_point and @bottom_right_point. Number of
- * records is estimated by @index. If an error is occurred,
- * -1 is returned.
- **/
 GRN_API int grn_geo_estimate_in_rectangle(grn_ctx *ctx,
                                           grn_obj *index,
                                           grn_obj *top_left_point,
                                           grn_obj *bottom_right_point);
-
-/**
- * grn_geo_cursor_open_in_rectangle:
- * @index: the index column for TokyoGeoPoint or WGS84GeoPpoint type.
- * @top_left_point: the top left point of the target
- * rectangle. (ShortText, Text, LongText, TokyoGeoPoint or
- * WGS84GeoPoint)
- * @bottom_right_point: the bottom right point of the target
- * rectangle. (ShortText, Text, LongText, TokyoGeoPoint or
- * WGS84GeoPoint)
- * @offset: the cursor returns records from @offset
- * position. @offset is based on 0.
- * @limit: the cursor returns at most @limit records. -1
- * means no limit.
- *
- * It opens a cursor to get records in the rectangle
- * specfied by @top_left_point and @bottom_right_point.
- **/
 GRN_API grn_obj *grn_geo_cursor_open_in_rectangle(grn_ctx *ctx,
                                                   grn_obj *index,
                                                   grn_obj *top_left_point,
                                                   grn_obj *bottom_right_point,
                                                   int offset,
                                                   int limit);
-
-/**
- * grn_geo_cursor_next:
- * @cursor: the geo cursor.
- *
- * It returns the next posting that has record ID. It
- * returns NULL after all records are returned.
- **/
 GRN_API grn_posting *grn_geo_cursor_next(grn_ctx *ctx, grn_obj *cursor);
 
 
@@ -2675,6 +1645,15 @@ GRN_API grn_obj *grn_expr_append_const_int(grn_ctx *ctx, grn_obj *expr, int i,
                                            grn_operator op, int nargs);
 GRN_API grn_rc grn_expr_append_op(grn_ctx *ctx, grn_obj *expr, grn_operator op, int nargs);
 
+GRN_API grn_rc grn_expr_syntax_escape(grn_ctx *ctx,
+                                      const char *query, int query_size,
+                                      const char *target_characters,
+                                      char escape_character,
+                                      grn_obj *escaped_query);
+GRN_API grn_rc grn_expr_syntax_escape_query(grn_ctx *ctx,
+                                            const char *query, int query_size,
+                                            grn_obj *escaped_query);
+
 GRN_API grn_rc grn_expr_compile(grn_ctx *ctx, grn_obj *expr);
 GRN_API grn_obj *grn_expr_exec(grn_ctx *ctx, grn_obj *expr, int nargs);
 GRN_API grn_rc grn_ctx_push(grn_ctx *ctx, grn_obj *obj);
@@ -2742,6 +1721,10 @@ GRN_API unsigned int grn_table_get_subrecs(grn_ctx *ctx, grn_obj *table,
                                            grn_id id, grn_id *subrecbuf,
                                            int *scorebuf, int buf_size);
 
+GRN_API grn_obj *grn_table_tokenize(grn_ctx *ctx, grn_obj *table,
+                                    const char *str, unsigned int str_len,
+                                    grn_obj *buf, grn_bool addp);
+
 GRN_API grn_rc grn_load(grn_ctx *ctx, grn_content_type input_type,
                         const char *table, unsigned int table_len,
                         const char *columns, unsigned int columns_len,
@@ -3043,7 +2026,6 @@ GRN_API grn_rc grn_dat_cursor_delete(grn_ctx *ctx, grn_dat_cursor *c,
 } while (0)
 
 /* buffered index builder */
-/* 特定のアプリケーション用に準備した内部APIです。 */
 
 typedef struct _grn_ii grn_ii;
 typedef struct _grn_ii_buffer grn_ii_buffer;