rroonga 2.1.0-x86-mingw32 → 2.1.1-x86-mingw32

data/doc/text/news.textile

@@ -1,5 +1,12 @@
 h1. NEWS
 
+h2(#2-1-1). 2.1.1: 2012-12-29
+
+h3. Improvements
+
+* Required groonga 2.1.1 because groonga 2.1.0 has a serious bug
+  related to key normalization.
+
 h2(#2-1-0). 2.1.0: 2012-12-29
 
 h3. Improvements

data/ext/groonga/rb-grn.h

@@ -76,7 +76,7 @@ RB_GRN_BEGIN_DECLS
 
 #define RB_GRN_MAJOR_VERSION 2
 #define RB_GRN_MINOR_VERSION 1
-#define RB_GRN_MICRO_VERSION 0
+#define RB_GRN_MICRO_VERSION 1
 
 #define RB_GRN_QUERY_DEFAULT_MAX_EXPRESSIONS 32
 

data/rroonga-build.rb

@@ -19,7 +19,7 @@ module RroongaBuild
   module RequiredGroongaVersion
     MAJOR = 2
     MINOR = 1
-    MICRO = 0
+    MICRO = 1
     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/kou/work/c/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/kou/work/c/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/kou/work/c/groonga.clean/packages/windows/dist-x86/var/lib/groonga/db/db;
 
   # Create a groonga database automatically if the groonga database doesn't
   # exist.
@@ -37,7 +37,7 @@ http {
     }
 
     location / {
-      root /home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/share/groonga/html/admin;
+      root /home/kou/work/c/groonga.clean/packages/windows/dist-x86/share/groonga/html/admin;
       index index.html;
     }
 

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

@@ -610,12 +610,6 @@ typedef enum {
   GRN_DB_TRIGRAM
 } grn_builtin_tokenizer;
 
-typedef enum {
-  GRN_DB_NORMALIZER_AUTO = 96,
-  GRN_DB_NORMALIZER_NFKC51,          /* Normalization Form KC for Unicode 5.1 */
-  GRN_DB_NORMALIZER_UCA              /* Unicode Collation Algorithm */
-} grn_builtin_normalizer;
-
 GRN_API grn_obj *grn_ctx_at(grn_ctx *ctx, grn_id id);
 
 /**

data/vendor/local/lib/groonga/plugins/query_expanders/tsv.la

@@ -1,5 +1,5 @@
 # tsv.la - a libtool library file
-# Generated by libtool (GNU libtool) 2.4.2 Debian-2.4.2-1ubuntu1
+# Generated by libtool (GNU libtool) 2.4.2 Debian-2.4.2-1
 #
 # Please DO NOT delete this file!
 # It is necessary for linking the library.
@@ -17,7 +17,7 @@ old_library='tsv.a'
 inherited_linker_flags=''
 
 # Libraries that this one depends upon.
-dependency_libs=' /home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/lib/libgroonga.la -L/home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/lib /home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/lib/libmsgpack.la -lws2_32'
+dependency_libs=' /home/kou/work/c/groonga.clean/packages/windows/dist-x86/lib/libgroonga.la -L/home/kou/work/c/groonga.clean/packages/windows/dist-x86/lib /home/kou/work/c/groonga.clean/packages/windows/dist-x86/lib/libmsgpack.la -lws2_32'
 
 # Names of additional weak libraries provided by this library
 weak_library_names=''
@@ -38,4 +38,4 @@ dlopen=''
 dlpreopen=''
 
 # Directory that this library needs to be installed in:
-libdir='/home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/lib/groonga/plugins/query_expanders'
+libdir='/home/kou/work/c/groonga.clean/packages/windows/dist-x86/lib/groonga/plugins/query_expanders'

data/vendor/local/lib/groonga/plugins/suggest/suggest.la

@@ -1,5 +1,5 @@
 # suggest.la - a libtool library file
-# Generated by libtool (GNU libtool) 2.4.2 Debian-2.4.2-1ubuntu1
+# Generated by libtool (GNU libtool) 2.4.2 Debian-2.4.2-1
 #
 # Please DO NOT delete this file!
 # It is necessary for linking the library.
@@ -17,7 +17,7 @@ old_library='suggest.a'
 inherited_linker_flags=''
 
 # Libraries that this one depends upon.
-dependency_libs=' /home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/lib/libgroonga.la -L/home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/lib -lws2_32 /home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/lib/libmsgpack.la'
+dependency_libs=' /home/kou/work/c/groonga.clean/packages/windows/dist-x86/lib/libgroonga.la -L/home/kou/work/c/groonga.clean/packages/windows/dist-x86/lib -lws2_32 /home/kou/work/c/groonga.clean/packages/windows/dist-x86/lib/libmsgpack.la'
 
 # Names of additional weak libraries provided by this library
 weak_library_names=''
@@ -38,4 +38,4 @@ dlopen=''
 dlpreopen=''
 
 # Directory that this library needs to be installed in:
-libdir='/home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/lib/groonga/plugins/suggest'
+libdir='/home/kou/work/c/groonga.clean/packages/windows/dist-x86/lib/groonga/plugins/suggest'

data/vendor/local/lib/groonga/plugins/table/table.la

@@ -1,5 +1,5 @@
 # table.la - a libtool library file
-# Generated by libtool (GNU libtool) 2.4.2 Debian-2.4.2-1ubuntu1
+# Generated by libtool (GNU libtool) 2.4.2 Debian-2.4.2-1
 #
 # Please DO NOT delete this file!
 # It is necessary for linking the library.
@@ -17,7 +17,7 @@ old_library='table.a'
 inherited_linker_flags=''
 
 # Libraries that this one depends upon.
-dependency_libs=' /home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/lib/libgroonga.la -L/home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/lib -lws2_32 /home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/lib/libmsgpack.la'
+dependency_libs=' /home/kou/work/c/groonga.clean/packages/windows/dist-x86/lib/libgroonga.la -L/home/kou/work/c/groonga.clean/packages/windows/dist-x86/lib -lws2_32 /home/kou/work/c/groonga.clean/packages/windows/dist-x86/lib/libmsgpack.la'
 
 # Names of additional weak libraries provided by this library
 weak_library_names=''
@@ -38,4 +38,4 @@ dlopen=''
 dlpreopen=''
 
 # Directory that this library needs to be installed in:
-libdir='/home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/lib/groonga/plugins/table'
+libdir='/home/kou/work/c/groonga.clean/packages/windows/dist-x86/lib/groonga/plugins/table'

data/vendor/local/lib/groonga/plugins/tokenizers/mecab.la

@@ -1,5 +1,5 @@
 # mecab.la - a libtool library file
-# Generated by libtool (GNU libtool) 2.4.2 Debian-2.4.2-1ubuntu1
+# Generated by libtool (GNU libtool) 2.4.2 Debian-2.4.2-1
 #
 # Please DO NOT delete this file!
 # It is necessary for linking the library.
@@ -17,7 +17,7 @@ old_library='mecab.a'
 inherited_linker_flags=''
 
 # Libraries that this one depends upon.
-dependency_libs=' -L/home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/lib /home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/lib/libmecab.la /home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/lib/libgroonga.la /home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/lib/libmsgpack.la -lws2_32'
+dependency_libs=' -L/home/kou/work/c/groonga.clean/packages/windows/dist-x86/lib /home/kou/work/c/groonga.clean/packages/windows/dist-x86/lib/libmecab.la /home/kou/work/c/groonga.clean/packages/windows/dist-x86/lib/libgroonga.la /home/kou/work/c/groonga.clean/packages/windows/dist-x86/lib/libmsgpack.la -lws2_32'
 
 # Names of additional weak libraries provided by this library
 weak_library_names=''
@@ -38,4 +38,4 @@ dlopen=''
 dlpreopen=''
 
 # Directory that this library needs to be installed in:
-libdir='/home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/lib/groonga/plugins/tokenizers'
+libdir='/home/kou/work/c/groonga.clean/packages/windows/dist-x86/lib/groonga/plugins/tokenizers'

data/vendor/local/lib/libgroonga.la

@@ -1,5 +1,5 @@
 # libgroonga.la - a libtool library file
-# Generated by libtool (GNU libtool) 2.4.2 Debian-2.4.2-1ubuntu1
+# Generated by libtool (GNU libtool) 2.4.2 Debian-2.4.2-1
 #
 # Please DO NOT delete this file!
 # It is necessary for linking the library.
@@ -17,7 +17,7 @@ old_library='libgroonga.a'
 inherited_linker_flags=''
 
 # Libraries that this one depends upon.
-dependency_libs=' -L/home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/lib /home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/lib/libmsgpack.la -lws2_32'
+dependency_libs=' -L/home/kou/work/c/groonga.clean/packages/windows/dist-x86/lib /home/kou/work/c/groonga.clean/packages/windows/dist-x86/lib/libmsgpack.la -lws2_32'
 
 # Names of additional weak libraries provided by this library
 weak_library_names=''
@@ -38,4 +38,4 @@ dlopen=''
 dlpreopen=''
 
 # Directory that this library needs to be installed in:
-libdir='/home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/lib'
+libdir='/home/kou/work/c/groonga.clean/packages/windows/dist-x86/lib'

data/vendor/local/lib/libmecab.la

@@ -38,4 +38,4 @@ dlopen=''
 dlpreopen=''
 
 # Directory that this library needs to be installed in:
-libdir='/home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/lib'
+libdir='/home/kou/work/c/groonga.clean/packages/windows/dist-x86/lib'

data/vendor/local/lib/libmsgpack.la

@@ -1,5 +1,5 @@
 # libmsgpack.la - a libtool library file
-# Generated by libtool (GNU libtool) 2.4.2 Debian-2.4.2-1ubuntu1
+# Generated by libtool (GNU libtool) 2.4.2 Debian-2.4.2-1.2
 #
 # Please DO NOT delete this file!
 # It is necessary for linking the library.
@@ -38,4 +38,4 @@ dlopen=''
 dlpreopen=''
 
 # Directory that this library needs to be installed in:
-libdir='/home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/lib'
+libdir='/home/kou/work/c/groonga.clean/packages/windows/dist-x86/lib'

data/vendor/local/lib/libmsgpackc.la

@@ -1,5 +1,5 @@
 # libmsgpackc.la - a libtool library file
-# Generated by libtool (GNU libtool) 2.4.2 Debian-2.4.2-1ubuntu1
+# Generated by libtool (GNU libtool) 2.4.2 Debian-2.4.2-1.2
 #
 # Please DO NOT delete this file!
 # It is necessary for linking the library.
@@ -38,4 +38,4 @@ dlopen=''
 dlpreopen=''
 
 # Directory that this library needs to be installed in:
-libdir='/home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86/lib'
+libdir='/home/kou/work/c/groonga.clean/packages/windows/dist-x86/lib'

data/vendor/local/lib/pkgconfig/groonga.pc

@@ -1,4 +1,4 @@
-prefix=/home/khayashi/work/groonga/groonga.clean/packages/windows/dist-x86
+prefix=/home/kou/work/c/groonga.clean/packages/windows/dist-x86
 exec_prefix=${prefix}
 bindir=${exec_prefix}/bin
 libdir=${exec_prefix}/lib
@@ -9,10 +9,10 @@ document_root=${datadir}/groonga/html/admin
 pluginsdir=${libdir}/groonga/plugins
 groonga=${bindir}/groonga.exe
 groonga_suggest_create_dataset=${bindir}/groonga-suggest-create-dataset.exe
-groonga_version=2.1.0
+groonga_version=2.1.1
 
 Name: Groonga
 Description: An Embeddable Fulltext Search Engine
-Version: 2.1.0
+Version: 2.1.1
 Libs: -L${libdir} -lgroonga
 Cflags: -I${includedir}/groonga

data/vendor/local/share/doc/groonga/en/html/.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 5f9c8a711be523d3cc47db1539d895ab
+config: 577333647baffc110782466a6449b3c0
 tags: fbb0d17656682115ca4d033fb2f83ba1

data/vendor/local/share/doc/groonga/en/html/_sources/news.txt

@@ -5,20 +5,40 @@
 News
 ====
 
+.. _release-2-1-1:
+
+Release 2.1.1 - 2012/12/29
+--------------------------
+
+This is bug fix release of 2.1.0. All of 2.1.0 users should use 2.1.1
+instead.
+
+Fixes
+^^^^^
+
+* Fixed a bug that ``KEY_NORMALIZE`` information in database that is
+  created by groonga 2.0.8 or ealier is dropped.
+
 .. _release-2-1-0:
 
 Release 2.1.0 - 2012/12/29
 --------------------------
 
+.. Caution::
+
+   Use 2.1.1 instead of 2.1.0. 2.1.0 has a serious bug related
+   ``KEY_NORMALIZE``.
+
 .. Caution::
 
    This release has backward incompatible changes against ``table_list`` and
    ``column_list`` commands. If you use own program which depends on the output
    results above commands, you need to support null instead of "null" string.
 
-   This release has supported ``--normalizer`` option, but there is side effect for
-   this feature. If you open old version of groonga database at least once, 
-   you can not open its database by old version of groonga.
+   This release has supported ``--normalizer`` option, but there is
+   side effect for this feature. If you open old version of groonga
+   database at least once, you can not open its database by old
+   version of groonga.
 
    There is also another backward incompatible change agaist plugin API for
    tokenizer. The argument of ``grn_tokenizer_query_open`` API has changed.
@@ -42,7 +62,7 @@ Improvements
   related commands such as ``table_list`` and ``column_list``.
 * Added a flag which controls behavior about normalizer as the last argument
   of ``grn_tokenizer_query_open`` API.
-* Supported continuous line in command list.
+* Supported continuous line in :ref:`command-list-with-continuous-line` list.
 * Improved to support not only no key table, but also hash table, patricia trie
   and double array trie for :ref:`nested-index-search`.
 

data/vendor/local/share/doc/groonga/en/html/_sources/reference.txt

@@ -11,7 +11,9 @@
    reference/executables
    reference/output
    reference/command
-   reference/type
+   reference/types
+   reference/tables
+   reference/normalizers
    reference/tokenizers
    reference/query_expanders
    reference/pseudo_column

data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/select.txt

@@ -5,8 +5,8 @@
 .. groonga-command
 .. database: commands_select
 
-select
-======
+``select``
+==========
 
 Summary
 -------

data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/table_create.txt

@@ -2,115 +2,285 @@
 
 .. highlightlang:: none
 
-table_create
-============
+.. groonga-command
+.. database: commands_table_create
 
-名前
-----
+``table_create``
+================
 
-table_create - テーブルの追加
+Summary
+-------
 
-書式
-----
-::
+``table_create`` creates a new table in the current database. You need
+to create one or more tables to store and search data.
 
- table_create name [flags [key_type [value_type [default_tokenizer]]]]
+Syntax
+------
 
-説明
-----
+``table_create`` has many parameters. The required parameter is only
+``name`` and otehrs are optional::
 
-groonga組込コマンドの一つであるtable_createについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+  table_create name
+               [flags=TABLE_HASH_KEY]
+               [key_type=null]
+               [value_type=null]
+               [default_tokenizer=null]
+               [normalizer=null]
 
-table_createコマンドは、使用しているデータベースに対してテーブルを追加します。groongaには名前付きテーブルと名前なしテーブル、永続テーブルと一時テーブルがありますが、table_createコマンドでは、名前付きの永続テーブルのみが作成できます。テーブルはレコードの集合であり、全てのレコードは一意なIDを持ちます。IDはレコードを追加した順序に従って自動的に付与されます。
+Usage
+-----
 
-テーブルにカラムを追加する時にはcolumn_createコマンドを使用します。また、テーブルを作成した時点でいくつかの疑似カラムが使用可能になっています。
+``table_create`` command creates a new persistent table. See
+:doc:`/reference/tables` for table details.
 
-引数
-----
+Create data store table
+^^^^^^^^^^^^^^^^^^^^^^^
+
+You can use all table types for data store table. See
+:doc:`/reference/tables` for all table types.
+
+Table type is specified as ``TABLE_${TYPE}`` to ``flags`` parameter.
+
+Here is an example to create ``TABLE_NO_KEY`` table:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/table_create/data_store_table_no_key.log
+.. table_create Logs TABLE_NO_KEY
+
+The ``table_create`` command creates a table that is named ``Logs``
+and is ``TABLE_NO_KEY`` type.
+
+If your records aren't searched by key, ``TABLE_NO_KEY`` type table is
+suitable. Because ``TABLE_NO_KEY`` doesn't support key but it is fast
+and small table. Storing logs into groonga database is the case.
+
+If your records are searched by key or referenced by one or more
+columns, ``TABLE_NO_KEY`` type isn't suitable. Lexicon for fulltext
+search is the case.
+
+Create lexicon table
+^^^^^^^^^^^^^^^^^^^^
+
+You can use all table types except ``TABLE_NO_KEY`` for lexicon table.
+Lexicon table needs key support but ``TABLE_NO_KEY`` doesn't support
+key.
+
+Here is an example to create ``TABLE_PAT_KEY`` table:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/table_create/lexicon_table_pat_key.log
+.. table_create Lexicon TABLE_PAT_KEY ShortText --default_tokenizer TokenBigram --normalizer NormalizerAuto
+
+The ``table_create`` command creates the following table:
+
+* The table is named ``Lexicon``.
+* The table is ``TABLE_PAT_KEY`` type table.
+* The table's key is ``ShortText`` type.
+* The table uses ``TokenBigram`` tokenizer to extract tokens from a
+  normalized text.
+* The table uses ``NormalizerAuto`` normalizer to normalize a text.
+
+``TABLE_PAT_KEY`` is suitable table type for lexicon table. Lexicon
+table is used for fulltext search.
+
+In fulltext search, predictive search may be used for fuzzy
+search. Predictive search is supported by ``TABLE_PAT_KEY`` and
+``TABLE_DAT_KEY``.
+
+Lexicon table has many keys because a fulltext target text has many
+tokens. Table that has many keys should consider table size because
+large table requires large memory. Requiring large memory causes disk
+I/O. It blocks fast search. So table size is important for a table
+that has many keys. ``TABLE_PAT_KEY`` is less table size than
+``TABLE_DAT_KEY``.
+
+Because of the above reasons, ``TABLE_PAT_KEY`` is suitable table type
+for lexicon table.
+
+Create tag index table
+^^^^^^^^^^^^^^^^^^^^^^
+
+You can use all table types except ``TABLE_NO_KEY`` for tag index
+table. Tag index table needs key support but ``TABLE_NO_KEY`` doesn't
+support key.
+
+Here is an example to create ``TABLE_HASH_KEY`` table:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/table_create/tag_index_table_hash_key.log
+.. table_create Tags TABLE_HASH_KEY ShortText
+
+The ``table_create`` command creates a table that is named ``Tags``,
+is ``TABLE_HASH_KEY`` type and has ``ShortText`` type key.
+
+``TABLE_HASH_KEY`` or ``TABLE_DAT_KEY`` are suitable table types for
+tag index table.
+
+If you need only exact match tag search feature, ``TABLE_HASH_KEY`` is
+suitable. It is the common case.
+
+If you also need predictive tag search feature (for example, searching
+``"groonga"`` by ``"gr"`` keyword.), ``TABLE_DAT_KEY`` is suitable.
+``TABLE_DAT_KEY`` is large table size but it is not important because
+the number of tags will not be large.
+
+Create range index table
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+You can use ``TABLE_PAT_KEY`` and ``TABLE_DAT_KEY`` table types for
+range index table. Range index table needs range search support but
+``TABLE_NO_KEY`` and ``TABLE_HASH_KEY`` don't support it.
+
+Here is an example to create ``TABLE_DAT_KEY`` table:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/table_create/tag_index_table_hash_key.log
+.. table_create Ages TABLE_DAT_KEY UInt32
+
+The ``table_create`` command creates a table that is named ``Ages``,
+is ``TABLE_DAT_KEY`` type and has ``UInt32`` type key.
+
+``TABLE_PAT_KEY`` and ``TABLE_DAT_KEY`` are suitable table types for
+range index table.
+
+If you don't have many indexed items, ``TABLE_DAT_KEY`` is
+suitable. Index for age is the case in the above example. Index for
+age will have only 0-100 items because human doesn't live so long.
+
+If you have many indexed items, ``TABLE_PAT_KEY`` is suitable. Because
+``TABLE_PAT_KEY`` is smaller than ``TABLE_DAT_KEY``.
+
+Parameters
+----------
+
+This section describes all parameters.
 
 ``name``
+^^^^^^^^
+
+It specifies a table name to be created. ``name`` must be specified.
 
-  作成するテーブルの名前を指定します。nameはデータベース内で一意な、未定義の名前でなければなりません。組込型名・組込コマンド名・組込関数名は予約済みであり、テーブル名には 使用できません。また、ピリオド('.'), コロン(':')を含む名前のテーブルは作成できません。
+Here are available characters:
+
+* ``0`` .. ``9`` (digit)
+* ``a`` .. ``z`` (alphabet, lower case)
+* ``A`` .. ``Z`` (alphabet, upper case)
+* ``#`` (hash)
+* ``@`` (at mark)
+* ``-`` (hyphen)
+* ``_`` (underscore) (NOTE: Underscore can't be used as the first
+  character.)
+
+You need to create a name with one or more the above chracters. Note
+that you cannot use ``_`` as the first charcter such as
+``_name``.
 
 ``flags``
+^^^^^^^^^
 
-  作成するテーブルの属性を示す数値か、パイプ('|')で組み合わせたシンボル名を指定します。(デフォルト値は0(="TABLE_HASH_KEY"))
+It specifies a table type and table customize options.
 
-   0, ``TABLE_HASH_KEY``
-     主キー値をハッシュ表で管理するテーブルを作成します。ハッシュ表を使用したテーブルでは、主キー値に完全一致するレコードを非常に高速に検索することができます。
+Here are available flags:
 
-   1, ``TABLE_PAT_KEY``
-     主キー値をパトリシア木で管理するテーブルを作成します。パトリシア木を使用したテーブルでは、主キー値に完全一致するレコードを検索することができるとともに、前方一致するレコード、および最長共通接頭辞となるレコードを高速に検索することができます。また、キー値の昇降順でレコードを取り出したり、キー値の範囲での検索を行うことができます。また、flagsの値に64を加えることによって、後方一致検索も可能となります。
++--------------------+------------------------------+
+|      flags         | description                  |
++--------------------+------------------------------+
+| ``TABLE_NO_KEY``   | Array table.                 |
++--------------------+------------------------------+
+| ``TABLE_HASH_HEY`` | Hash table.                  |
++--------------------+------------------------------+
+| ``TABLE_PAT_KEY``  | Patricia trie.               |
++--------------------+------------------------------+
+| ``TABLE_DAT_KEY``  | Double Array trie.           |
++--------------------+------------------------------+
+| ``KEY_WITH_SIS``   | Enable Semi Infinite String. |
+|                    | Require ``TABLE_PAT_KEY``.   |
++--------------------+------------------------------+
 
-   2, ``TABLE_DAT_KEY``
-     主キー値をダブル配列で管理するテーブルを作成します。ダブル配列を使用したテーブルでは、主キー値に完全一致するレコードを高速に検索することができるとともに、前方一致するレコード、および最長共通接頭辞となるレコードを検索することができます。また、キー値の昇降順でレコードを取り出したり、キー値の範囲での検索を行うことができます。
+.. note::
+   Since groonga 2.1.0 ``KEY_NORMALIZE`` flag is deprecated. Use
+   ``normalizer`` option with ``NormalizerAuto`` instead.
 
-   3, ``TABLE_NO_KEY``
-     主キーを持たないテーブルを作成します。各レコードはIDのみによって特定することができます。
+You must specify one of ``TABLE_${TYPE}`` flags. You cannot specify two
+or more ``TABLE_${TYPE}`` flags. For example,
+``TABLE_NO_KEY|TABLE_HASH_KEY`` is invalid.
 
-   4, ``TABLE_VIEW``
-     複数のテーブルをまとめて操作するための仮想的なテーブル(view)を作成します。
+You can combine flags with ``|`` (vertical bar) such as
+``TABLE_PAT_KEY|KEY_WITH_SIS``.
 
-   64, ``KEY_WITH_SIS``
-     語彙表となるパトリシア木型のテーブルにおいて、後方一致検索を可能とします。
+See :doc:`/reference/tables` for difference between table types.
 
-   128, ``KEY_NORMALIZE``
-     ハッシュ表型か、パトリシア木型のテーブルにおいて、主キー値を正規化した上で登録します。この値が指定されたテーブルではたとえば、主キー値'abc'と'ABC' は同一のレコードに対応するものとみなされます。
+The default flags are ``TABLE_HASH_KEY``.
 
 ``key_type``
+^^^^^^^^^^^^
+
+It specifies key type.
 
-  主キー値の型を指定します。主キー値を持つテーブルに限り有効です。型にはgroongaの組込型か、同一データベースに定義済みのユーザ定義型、定義済みのテーブルを指定することができます。
+If you specify ``TABLE_HASH_KEY``, ``TABLE_PAT_KEY`` or
+``TABLE_DAT_KEY`` as ``flags`` parameter, you need to specify
+``key_type`` option.
+
+See :doc:`/reference/types` for all types.
+
+The default value is none.
 
 ``value_type``
+^^^^^^^^^^^^^^
 
-  値の型を指定します。tableの値には固定長の型のみが指定できます。(可変長の値が必要な場合は別途カラムを作成します) 型にはgroongaの組込型か、同一データベースに定義済みのユーザ定義型、またはテーブルを指定することができます。(デフォルトはvalueなし)
+It specifies value type.
 
-``default_tokenizer``
+You can use value when you specify ``TABLE_NO_KEY``,
+``TABLE_HASH_KEY`` or ``TABLE_PAT_KEY`` as ``flags`` parameter. Value
+type must be a fixed size type. For example, ``UInt32`` can be used
+but ``ShortText`` cannot be used. Use columns instead of value.
 
-  作成するテーブルを語彙表として使用する場合、文字列を分割するトークナイザを指定します。
+The default value is none.
 
-  組込のトークナイザとして、以下が準備されています。
+``default_tokenizer``
+^^^^^^^^^^^^^^^^^^^^^
 
-  ``TokenDelimit``
-    空白で区切られた文字列をトークンとする
+It specifies the default tokenizer that is used on searching and data
+loading.
 
-  ``TokenUnigram``
-    unigram(1文字を1トークンとする)
+You cannot use ``default_tokenizer`` with ``TABLE_NO_KEY`` because
+``TABLE_NO_KEY`` cannot be used for index.
 
-  ``TokenBigram``
-    bigram(2文字の文字列要素をトークンとする)
+You must specify ``default_tokenizer`` for a table that is used for
+fulltext search index.
 
-  ``TokenTrigram``
-    trigram(3文字の文字列要素をトークンとする)
+See :doc:`/reference/tokenizers` for all tokenizers
 
-  ``TokenMecab``
-    形態素解析器mecabで解析した形態素をトークンとする。(mecabを組み込んだ場合のみ有効)
+The default value is none.
 
-  トークナイザが指定されなかった場合は、対象の文字列を分割せずに語彙表に登録します。
+``normalizer``
+^^^^^^^^^^^^^^
 
-返値
-----
+It specifies a normalizer that is used to normalize key.
 
-json形式
-^^^^^^^^
+You cannot use ``normalizer`` with ``TABLE_NO_KEY`` because
+``TABLE_NO_KEY`` doesn't support key.
 
-::
+See :doc:`/reference/normalizers` for all normalizsers.
 
- [成功かどうかのフラグ]
+The default value is none.
 
- ``成功かどうかのフラグ``
+Return value
+------------
 
-   エラーが生じなかった場合にはtrue、エラーが生じた場合にはfalseを返す。
+``table_create`` returns ``true`` as body on success such as::
 
-例
---
+  [HEADER, true]
 
-ShortText型の主キーを持つハッシュ表型のテーブル、Entryを作成します。::
+If ``table_create`` fails, error details are in ``HEADER``.
 
-  table_create Entry --key_type ShortText
-  [true]
+See :doc:`/reference/command/output_format` for ``HEADER``.
 
-ShortText型の主キーを持つパトリシア木型のテーブル、Termを作成します。主キー値は正規化して管理します。また、このテーブルを語彙表とする転置索引を作成する場合には、バイグラムの索引を作成します。::
+See also
+--------
 
-  table_create Term --flags TABLE_PAT_KEY|KEY_NORMALIZE --key_type ShortText --default_tokenizer TokenBigram
-  [true]
+* :doc:`/reference/tables`
+* :doc:`/reference/commands/column_create`
+* :doc:`/reference/tokenizers`
+* :doc:`/reference/normalizers`
+* :doc:`/reference/command/output_format`