rroonga 2.0.7-x86-mingw32 → 2.0.8-x86-mingw32

data/vendor/local/share/doc/groonga/source/server/http/comparison.txt

@@ -27,7 +27,7 @@ There are many differences between :doc:`groonga` and
 +----------------------------+------------------------+----------------------+
 |      Gzip compression      | x                      | o                    |
 +----------------------------+------------------------+----------------------+
-|            POST            | x                      | x (comming soon)     |
+|            POST            | x                      | o                    |
 +----------------------------+------------------------+----------------------+
 |           HTTPS            | x                      | o                    |
 +----------------------------+------------------------+----------------------+
@@ -270,7 +270,17 @@ processed by groonga. You don't need to consider about other modules.
 POST
 ----
 
-TODO
+You can load your data by POST JSON data. You need follow the
+following rules to use loading by POST.
+
+* `Content-Type` header value must be `application/json`.
+* JSON data is sent as body.
+* Table name is specified by query parameter such as ``table=NAME``.
+
+Here is an example curl command line that loads two users `alice` and
+`bob` to `Users` table::
+
+  % curl --data-binary '[{"_key": "alice"}, {"_key": "bob"}]' -H "Content-Type: application/json" "http://localhost:10041/d/load?table=Users"
 
 HTTPS
 -----

data/vendor/local/share/doc/groonga/source/spec/gqtp.txt

@@ -0,0 +1,214 @@
+.. -*- rst -*-
+
+.. highlightlang:: none
+
+GQTP
+====
+
+GQTP is the acronym of Groonga Query Transfer Protocol. GQTP is the
+original protocol for groonga.
+
+Protocol
+--------
+
+GQTP is stateful client server model protocol. The following sequence
+is one processing unit:
+
+* Client sends a request
+* Server receives the request
+* Server processes the request
+* Server sends a response
+* Client receives the response
+
+You can do zero or more processing units in a session.
+
+Both request and response consist of GQTP header and body. GQTP header
+is fixed size data. Body is variable size data and its size is stored
+in GQTP header. The content of body isn't defined in GQTP.
+
+.. _gqtp-header-spec:
+
+GQTP header
+^^^^^^^^^^^
+
+GQTP header consists of the following unsigned integer values:
+
++----------------+-------+----------------------------+
+|      Name      |  Size |        Description         |
++================+=======+============================+
+|  ``protocol``  | 1byte | Protocol type.             |
++----------------+-------+----------------------------+
+| ``query_type`` | 1byte | Content type of body.      |
++----------------+-------+----------------------------+
+| ``key_length`` | 2byte | Not used.                  |
++----------------+-------+----------------------------+
+|   ``level``    | 1byte | Not used.                  |
++----------------+-------+----------------------------+
+|   ``flags``    | 1byte | Flags.                     |
++----------------+-------+----------------------------+
+|   ``status``   | 2byte | Return code.               |
++----------------+-------+----------------------------+
+|    ``size``    | 4byte | Body size.                 |
++----------------+-------+----------------------------+
+|   ``opaque``   | 4byte | Not used.                  |
++----------------+-------+----------------------------+
+|    ``cas``     | 8byte | Not used.                  |
++----------------+-------+----------------------------+
+
+All header values are encoded by network byte order.
+
+The following sections describes available values of each header value.
+
+The total size of GQTP header is 24byte.
+
+``protocol``
+""""""""""""
+
+The value is always ``0xc7`` in both request and response GQTP header.
+
+``query_type``
+""""""""""""""
+
+The value is one of the following values:
+
++-------------+--------+----------------------------+
+|    Name     | Value  |        Description         |
++=============+========+============================+
+|  ``NONE``   |   0    | Free format.               |
++-------------+--------+----------------------------+
+|   ``TSV``   |   1    | Tab Separated Values.      |
++-------------+--------+----------------------------+
+|  ``JSON``   |   2    | JSON.                      |
++-------------+--------+----------------------------+
+|   ``XML``   |   3    | XML.                       |
++-------------+--------+----------------------------+
+| ``MSGPACK`` |   4    | MessagePack.               |
++-------------+--------+----------------------------+
+
+This is not used in request GQTP header.
+
+This is used in response GQTP header. Body is formatted as specified
+type.
+
+``flags``
+"""""""""
+
+The value is bitwise OR of the following values:
+
++-----------+--------+----------------------------+
+|   Name    | Value  |        Description         |
++===========+========+============================+
+| ``MORE``  |  0x01  | There are more data.       |
++-----------+--------+----------------------------+
+| ``TAIL``  |  0x02  | There are no more data.    |
++-----------+--------+----------------------------+
+| ``HEAD``  |  0x04  | Not used.                  |
++-----------+--------+----------------------------+
+| ``QUIET`` |  0x08  | Be quiet.                  |
++-----------+--------+----------------------------+
+| ``QUIT``  |  0x10  | Quit.                      |
++-----------+--------+----------------------------+
+
+You must specify ``MORE`` or ``TAIL`` flag.
+
+If you use ``MORE`` flag, you should also use ``QUIET`` flag. Because
+you don't need to show a response for your partial request.
+
+Use ``QUIT`` flag to quit this session.
+
+``status``
+""""""""""
+
+Here are available values. The new statuses will be added in the
+future.
+
+* 0: ``SUCCESS``
+* 1: ``END_OF_DATA``
+* 65535: ``UNKNOWN_ERROR``
+* 65534: ``OPERATION_NOT_PERMITTED``
+* 65533: ``NO_SUCH_FILE_OR_DIRECTORY``
+* 65532: ``NO_SUCH_PROCESS``
+* 65531: ``INTERRUPTED_FUNCTION_CALL``
+* 65530: ``INPUT_OUTPUT_ERROR``
+* 65529: ``NO_SUCH_DEVICE_OR_ADDRESS``
+* 65528: ``ARG_LIST_TOO_LONG``
+* 65527: ``EXEC_FORMAT_ERROR``
+* 65526: ``BAD_FILE_DESCRIPTOR``
+* 65525: ``NO_CHILD_PROCESSES``
+* 65524: ``RESOURCE_TEMPORARILY_UNAVAILABLE``
+* 65523: ``NOT_ENOUGH_SPACE``
+* 65522: ``PERMISSION_DENIED``
+* 65521: ``BAD_ADDRESS``
+* 65520: ``RESOURCE_BUSY``
+* 65519: ``FILE_EXISTS``
+* 65518: ``IMPROPER_LINK``
+* 65517: ``NO_SUCH_DEVICE``
+* 65516: ``NOT_A_DIRECTORY``
+* 65515: ``IS_A_DIRECTORY``
+* 65514: ``INVALID_ARGUMENT``
+* 65513: ``TOO_MANY_OPEN_FILES_IN_SYSTEM``
+* 65512: ``TOO_MANY_OPEN_FILES``
+* 65511: ``INAPPROPRIATE_I_O_CONTROL_OPERATION``
+* 65510: ``FILE_TOO_LARGE``
+* 65509: ``NO_SPACE_LEFT_ON_DEVICE``
+* 65508: ``INVALID_SEEK``
+* 65507: ``READ_ONLY_FILE_SYSTEM``
+* 65506: ``TOO_MANY_LINKS``
+* 65505: ``BROKEN_PIPE``
+* 65504: ``DOMAIN_ERROR``
+* 65503: ``RESULT_TOO_LARGE``
+* 65502: ``RESOURCE_DEADLOCK_AVOIDED``
+* 65501: ``NO_MEMORY_AVAILABLE``
+* 65500: ``FILENAME_TOO_LONG``
+* 65499: ``NO_LOCKS_AVAILABLE``
+* 65498: ``FUNCTION_NOT_IMPLEMENTED``
+* 65497: ``DIRECTORY_NOT_EMPTY``
+* 65496: ``ILLEGAL_BYTE_SEQUENCE``
+* 65495: ``SOCKET_NOT_INITIALIZED``
+* 65494: ``OPERATION_WOULD_BLOCK``
+* 65493: ``ADDRESS_IS_NOT_AVAILABLE``
+* 65492: ``NETWORK_IS_DOWN``
+* 65491: ``NO_BUFFER``
+* 65490: ``SOCKET_IS_ALREADY_CONNECTED``
+* 65489: ``SOCKET_IS_NOT_CONNECTED``
+* 65488: ``SOCKET_IS_ALREADY_SHUTDOWNED``
+* 65487: ``OPERATION_TIMEOUT``
+* 65486: ``CONNECTION_REFUSED``
+* 65485: ``RANGE_ERROR``
+* 65484: ``TOKENIZER_ERROR``
+* 65483: ``FILE_CORRUPT``
+* 65482: ``INVALID_FORMAT``
+* 65481: ``OBJECT_CORRUPT``
+* 65480: ``TOO_MANY_SYMBOLIC_LINKS``
+* 65479: ``NOT_SOCKET``
+* 65478: ``OPERATION_NOT_SUPPORTED``
+* 65477: ``ADDRESS_IS_IN_USE``
+* 65476: ``ZLIB_ERROR``
+* 65475: ``LZO_ERROR``
+* 65474: ``STACK_OVER_FLOW``
+* 65473: ``SYNTAX_ERROR``
+* 65472: ``RETRY_MAX``
+* 65471: ``INCOMPATIBLE_FILE_FORMAT``
+* 65470: ``UPDATE_NOT_ALLOWED``
+* 65469: ``TOO_SMALL_OFFSET``
+* 65468: ``TOO_LARGE_OFFSET``
+* 65467: ``TOO_SMALL_LIMIT``
+* 65466: ``CAS_ERROR``
+* 65465: ``UNSUPPORTED_COMMAND_VERSION``
+
+``size``
+""""""""
+
+The size of body. The maximum body size is 4GiB because ``size`` is
+4byte unsigned integer. If you want to send 4GiB or more larger data,
+use ``MORE`` flag.
+
+Example
+-------
+
+TODO
+
+See also
+--------
+
+TODO

data/vendor/local/share/groonga/html/admin/js/groonga-admin.js

@@ -548,8 +548,9 @@ jQuery.extend(GroongaAdmin.prototype, {
               td.append($('<input/>')
                         .attr("type", "button")
                         .attr("value", "編集")
+                        .attr("data-record-id", line[0])
                         .click(function () {
-                          that.show_edit_record(line[0]);
+                          that.show_edit_record($(this).attr("data-record-id"));
                         }));
               break;
             case 2: // Table
@@ -558,8 +559,10 @@ jQuery.extend(GroongaAdmin.prototype, {
               td.append($('<input/>')
                         .attr("type", "button")
                         .attr("value", "詳細")
+                        .attr("data-table-name", line[1])
                         .click(function () {
-                          $("#side-menu-tablelist-link-" + line[1]).click();
+                          var tableName = $(this).attr("data-table-name");
+                          $("#side-menu-tablelist-link-" + tableName).click();
                         }));
               break;
             }

data/vendor/local/share/man/ja/man1/groonga.1

@@ -1,4 +1,4 @@
-.TH "GROONGA" "1" "2012 年 09 月 24 日" "2.0.7" "groonga"
+.TH "GROONGA" "1" "2012 年 11 月 28 日" "2.0.9" "groonga"
 .SH NAME
 groonga \- groongaのドキュメント
 .
@@ -92,16 +92,16 @@ groonga は独自のカラムストアを持つ列指向のデータベースと
 32\-bit用と64\-bit用のパッケージを配布していますが、サーバ用途には64\-bitパッケージを利用することをオススメします。32\-bit用パッケージはテスト用か開発用にだけ使って下さい。32\-bit用パッケージを使った場合は、中程度のサイズのデータでもメモリ不足エラーになることがあります。
 .SS インストーラー
 .sp
-32\-bit環境の場合は \fI\%groonga-2.0.7-x86.exe\fP をダウンロードして実行してください。
+32\-bit環境の場合は \fI\%groonga-2.0.9-x86.exe\fP をダウンロードして実行してください。
 .sp
-64\-bit環境の場合は \fI\%groonga-2.0.7-x64.exe\fP をダウンロードして実行してください。
+64\-bit環境の場合は \fI\%groonga-2.0.9-x64.exe\fP をダウンロードして実行してください。
 .sp
 スタートメニュー内に \fB/reference/executables/groonga\fP 用のコマンドプロンプトがインストールされるのでそれを使ってください。
 .SS zip
 .sp
-32\-bit環境の場合は \fI\%groonga-2.0.7-x86.zip\fP をダウンロードして展開してください。
+32\-bit環境の場合は \fI\%groonga-2.0.9-x86.zip\fP をダウンロードして展開してください。
 .sp
-64\-bit環境の場合は \fI\%groonga-2.0.7-x64.zip\fP をダウンロードして展開してください。
+64\-bit環境の場合は \fI\%groonga-2.0.9-x64.zip\fP をダウンロードして展開してください。
 .sp
 \fB/reference/executables/groonga\fP は \fBbin\fP フォルダーにあります。
 .SS ソースからビルド
@@ -118,13 +118,13 @@ groonga は独自のカラムストアを持つ列指向のデータベースと
 .UNINDENT
 .UNINDENT
 .sp
-zipでアーカイブされたソース \fI\%groonga-2.0.7.zip\fP をダウンロードして展開します。
+zipでアーカイブされたソース \fI\%groonga-2.0.9.zip\fP をダウンロードして展開します。
 .sp
 Microsoft Visual Studio 2010 Expressがインストールする \fBVisual Studio コマンド プロンプト (2010)\fP を実行して、groongaのソースがあるフォルダーへ移動してください:
 .sp
 .nf
 .ft C
-> cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-2.0.7
+> cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-2.0.9
 .ft P
 .fi
 .sp
@@ -132,23 +132,41 @@ Microsoft Visual Studio 2010 Expressがインストールする \fBVisual Studio
 .sp
 .nf
 .ft C
-groonga\-2.0.7> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\egroonga
+groonga\-2.0.9> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\egroonga
 .ft P
 .fi
 .sp
-Visual Studioでビルドします:
+Visual C++ 2010 Expressでビルドします:
 .sp
 .nf
 .ft C
-groonga\-2.0.7> devenv groonga.sln /Build Release
+groonga\-2.0.9> msbuild groonga.sln /p:Configuration=Release
 .ft P
 .fi
 .sp
-インストール:
+Visual C++ 2010 Expressでビルドします:
+.sp
+.nf
+.ft C
+groonga\-2.0.9> msbuild groonga.sln /p:Configuration=Release /t:Install
+.ft P
+.fi
+.sp
+Visual Studio 2010をインストールした場合、devenvを使うことができます。
+.sp
+Visual Studio 2010でビルドします:
 .sp
 .nf
 .ft C
-groonga\-2.0.7> devenv groonga.sln /Build Release /Project Install
+groonga\-2.0.9> devenv groonga.sln /Build Release
+.ft P
+.fi
+.sp
+Visual Studio 2010でインストールします:
+.sp
+.nf
+.ft C
+groonga\-2.0.9> devenv groonga.sln /Build Release /Project Install
 .ft P
 .fi
 .sp
@@ -184,9 +202,9 @@ groonga\-2.0.7> devenv groonga.sln /Build Release /Project Install
 .sp
 .nf
 .ft C
-% curl \-O http://packages.groonga.org/source/groonga/groonga\-2.0.7.tar.gz
-% tar xvzf groonga\-2.0.7.tar.gz
-% cd groonga\-2.0.7
+% curl \-O http://packages.groonga.org/source/groonga/groonga\-2.0.9.tar.gz
+% tar xvzf groonga\-2.0.9.tar.gz
+% cd groonga\-2.0.9
 .ft P
 .fi
 .sp
@@ -361,9 +379,9 @@ groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-2.0.7.tar.gz
-% tar xvzf groonga\-2.0.7.tar.gz
-% cd groonga\-2.0.7
+% wget http://packages.groonga.org/source/groonga/groonga\-2.0.9.tar.gz
+% tar xvzf groonga\-2.0.9.tar.gz
+% cd groonga\-2.0.9
 .ft P
 .fi
 .sp
@@ -607,6 +625,59 @@ groonga\-munin\-pluginsパッケージのインストール:
 % sudo apt\-get \-y install groonga\-munin\-plugins
 .ft P
 .fi
+.SS 12.10 Quantal Quetzal
+.IP ノート
+groongaをインストールするためにuniverseリポジトリを有効にしてください:
+.sp
+.nf
+.ft C
+% sudo cp /etc/apt/sources.list /etc/apt/sources.list.d/universe.list
+% sudo sed \-i\(aq\(aq \-e \(aqs/main/universe/\(aq /etc/apt/sources.list.d/universe.list
+.ft P
+.fi
+.RE
+.sp
+groongaのaptリポジトリを追加します。
+.sp
+/etc/apt/sources.list.d/groonga.list:
+.sp
+.nf
+.ft C
+deb http://packages.groonga.org/ubuntu/ quantal universe
+deb\-src http://packages.groonga.org/ubuntu/ quantal universe
+.ft P
+.fi
+.sp
+インストール:
+.sp
+.nf
+.ft C
+% sudo apt\-get update
+% sudo apt\-get \-y \-\-allow\-unauthenticated install groonga\-keyring
+% sudo apt\-get update
+% sudo apt\-get \-y install groonga
+.ft P
+.fi
+.sp
+\fI\%MeCab\fP をトークナイザーとして使いたいときは、groonga\-tokenizer\-mecabパッケージをインストールしてください。
+.sp
+groonga\-tokenizer\-mecabパッケージのインストール:
+.sp
+.nf
+.ft C
+% sudo apt\-get \-y install groonga\-tokenizer\-mecab
+.ft P
+.fi
+.sp
+\fI\%Munin\fP プラグインを提供するパッケージもあります。Muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
+.sp
+groonga\-munin\-pluginsパッケージのインストール:
+.sp
+.nf
+.ft C
+% sudo apt\-get \-y install groonga\-munin\-plugins
+.ft P
+.fi
 .SS ソースからビルド
 .sp
 groongaをビルドするために必要なパッケージをインストールします:
@@ -621,9 +692,9 @@ groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-2.0.7.tar.gz
-% tar xvzf groonga\-2.0.7.tar.gz
-% cd groonga\-2.0.7
+% wget http://packages.groonga.org/source/groonga/groonga\-2.0.9.tar.gz
+% tar xvzf groonga\-2.0.9.tar.gz
+% cd groonga\-2.0.9
 .ft P
 .fi
 .sp
@@ -677,6 +748,24 @@ groonga\-tokenizer\-mecabパッケージのインストール:
 .ft P
 .fi
 .sp
+それからMeCabの辞書をインストールします。(mecab\-ipadicもしくはmecab\-jumandic)
+.sp
+IPA辞書をインストールします:
+.sp
+.nf
+.ft C
+% sudo yum install \-y mecab\-ipadic
+.ft P
+.fi
+.sp
+あるいはJuman辞書をインストールします:
+.sp
+.nf
+.ft C
+% sudo yum install \-y mecab\-jumandic
+.ft P
+.fi
+.sp
 \fI\%Munin\fP プラグインを提供するパッケージもあります。Muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
 .IP ノート
 groonga\-munin\-pluginsパッケージはmunin\-nodeパッケージを必要としますが、munin\-nodeパッケージはCentOSの公式リポジトリには含まれていません。munin\-nodeパッケージを \fByum\fP でインストールするために \fI\%Repoforge (RPMforge)\fP リポジトリか \fI\%EPEL\fP リポジトリを有効にする必要があります。
@@ -738,6 +827,24 @@ groonga\-tokenizer\-mecabパッケージのインストール:
 .ft P
 .fi
 .sp
+それからMeCabの辞書をインストールします。(mecab\-ipadicもしくはmecab\-jumandic)
+.sp
+IPA辞書をインストールします:
+.sp
+.nf
+.ft C
+% sudo yum install \-y mecab\-ipadic
+.ft P
+.fi
+.sp
+あるいはJuman辞書をインストールします:
+.sp
+.nf
+.ft C
+% sudo yum install \-y mecab\-jumandic
+.ft P
+.fi
+.sp
 \fI\%Munin\fP プラグインを提供するパッケージもあります。Muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
 .IP ノート
 groonga\-munin\-pluginsパッケージはmunin\-nodeパッケージを必要としますが、munin\-nodeパッケージはCentOSの公式リポジトリには含まれていません。munin\-nodeパッケージを \fByum\fP でインストールするために \fI\%EPEL\fP リポジトリを有効にする必要があります。
@@ -772,9 +879,9 @@ groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-2.0.7.tar.gz
-% tar xvzf groonga\-2.0.7.tar.gz
-% cd groonga\-2.0.7
+% wget http://packages.groonga.org/source/groonga/groonga\-2.0.9.tar.gz
+% tar xvzf groonga\-2.0.9.tar.gz
+% cd groonga\-2.0.9
 .ft P
 .fi
 .sp
@@ -830,6 +937,24 @@ groonga\-tokenizer\-mecabパッケージのインストール:
 .ft P
 .fi
 .sp
+それからMeCabの辞書をインストールします。(mecab\-ipadicもしくはmecab\-jumandic)
+.sp
+IPA辞書をインストールします:
+.sp
+.nf
+.ft C
+% sudo yum install \-y mecab\-ipadic
+.ft P
+.fi
+.sp
+あるいはJuman辞書をインストールします:
+.sp
+.nf
+.ft C
+% sudo yum install \-y mecab\-jumandic
+.ft P
+.fi
+.sp
 \fI\%Munin\fP プラグインを提供するパッケージもあります。Muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
 .sp
 groonga\-munin\-pluginsパッケージのインストール:
@@ -853,9 +978,9 @@ groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-2.0.7.tar.gz
-% tar xvzf groonga\-2.0.7.tar.gz
-% cd groonga\-2.0.7
+% wget http://packages.groonga.org/source/groonga/groonga\-2.0.9.tar.gz
+% tar xvzf groonga\-2.0.9.tar.gz
+% cd groonga\-2.0.9
 .ft P
 .fi
 .sp
@@ -899,9 +1024,9 @@ groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-2.0.7.tar.gz
-% gtar xvzf groonga\-2.0.7.tar.gz
-% cd groonga\-2.0.7
+% wget http://packages.groonga.org/source/groonga/groonga\-2.0.9.tar.gz
+% gtar xvzf groonga\-2.0.9.tar.gz
+% cd groonga\-2.0.9
 .ft P
 .fi
 .sp
@@ -1006,9 +1131,9 @@ groongaはGNUビルドシステムを使っています。以下は一番簡単
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-2.0.7.tar.gz
-% tar xvzf groonga\-2.0.7.tar.gz
-% cd groonga\-2.0.7
+% wget http://packages.groonga.org/source/groonga/groonga\-2.0.9.tar.gz
+% tar xvzf groonga\-2.0.9.tar.gz
+% cd groonga\-2.0.9
 % ./configure
 % make
 % sudo make install
@@ -2836,7 +2961,7 @@ select \-\-table ToyBox \-\-output_columns _key,location
 .sp
 groongaでは、テーブル参照のカラム、すなわち関連付けたテーブルを参照するカラムを作成できます。より正確には、カラム作成時に参照先となるテーブルとの関連付けをおこない、参照先テーブルにおけるレコードIDを格納しておくことにより、参照先のレコードにアクセスできるようにします。
 .sp
-You can specify a column in the associated table to the \fIoutput_columns\fP parameter of a \fB/reference/commands/select\fP command. The format is "Src.Dest" where Src is the name of the reference column and Dest is the name of the target column. If only the reference column is specified, it is handled as "Src._key". Note that if a reference does not point to a valid record, a \fB/reference/commands/select\fP command outputs the default value of the target column.
+テーブル参照のカラムがあるときは、 \fBreference/command/select\fP コマンドの \fIoutput_columns\fP 引数に "参照元カラム.参照先カラム" と指定することにより、参照先カラムの値を取り出すことができます。参照元カラムのみを指定したときは、 "参照元カラム名._key" と同様の扱いとなり、参照先レコードの主キーが取り出されます。テーブル参照が有効なレコードを指していないときは、参照先カラムのデフォルト値が取り出されるようになっています。
 .sp
 ここでは、先のチュートリアルで作成したSiteテーブルにlinkという新たなカラムを作成し、サイト間のリンク関係を保存できるようにしてみましょう。
 .sp
@@ -2891,7 +3016,7 @@ select \-\-table Site \-\-output_columns _key,title,link._key,link.title \-\-que
 .ft P
 .fi
 .sp
-The \fItype\fP parameter of the \fB/reference/commands/column_create\fP command specifies the table to be associated with the reference column. In this example, the reference column is associated with the own table. Then, the \fB/reference/commands/load\fP command registers a link from "\fI\%http://example.org\fP" to "\fI\%http://example.net\fP". Note that a reference column requires the primary key, not the ID, of the record to be referred to. After that, the link is confirmed by the \fB/reference/commands/select\fP command. In this case, the primary key and the title of the referred record are output because link._key and link.title are specified to the \fIoutput_columns\fP parameter.
+テーブル参照のカラムを作成するときは、 \fB/reference/commands/column_create\fP コマンドの \fItype\fP 引数に参照先テーブルを指定します。この例では、同じテーブルに含まれる別のレコードを参照させたいので、Siteを指定することになります。次に、 "\fI\%http://example.org/\fP" から "\fI\%http://example.net/\fP" へのリンクを登録しています。テーブル参照を作成するときは、IDではなく主キーを指定することに注意してください。最後に、リンクの内容を確認しています。この例では、  \fIoutput_columns\fP 引数に link._key と link.title を指定しているので、参照先の主キーとタイトルが表示されています。
 .SS ベクターカラム
 .sp
 \fB/reference/commands/column_create\fP コマンドでカラムを作成するとき、 \fIflags\fP 引数にCOLUMN_VECTORフラグを指定すると、 \fItype\fP 引数に指定した型の配列を格納するカラムになります。このようなカラムのことは、ベクターカラムと呼びます。ベクターカラムは、各レコードに複数の値を格納できるため、一対多の参照関係を表すのに便利です。
@@ -7049,7 +7174,7 @@ POST
 T}	T{
 ×
 T}	T{
-×（まもなく実装予定）
+○
 T}
 _
 T{
@@ -7283,7 +7408,23 @@ http {
 \fBgroonga\-httpd\fP のレスポンスデータをgzip圧縮するには、明示的に \fIgzip_types *\fP または \fIgzip_types application/json text/xml application/x\-msgpack\fP と指定する必要があります。 \fIgzip_types *\fP の方がおすすめです。理由は2つあります。1つは、groongaが、将来、他のフォーマットもサポートする可能性もあるからという理由です。2つめは、この \fIlocation\fP のすべてのリクエストはgroongaが処理するので、他のモジュールのことについて考えなくてもよいからという理由です。
 .SS POST
 .sp
-TODO
+JSONデータをPOSTすることでデータをロードすることができます。POSTでロードする場合は以下のルールに従ってください。
+.INDENT 0.0
+.IP \(bu 2
+\fIContent\-Type\fP ヘッダーの値を \fIapplication/json\fP にする。
+.IP \(bu 2
+JSONデータはbodyとして送る。
+.IP \(bu 2
+テーブル名は \fBtable=名前\fP というようにクエリーパラメーターで指定する。
+.UNINDENT
+.sp
+以下はcurlを使って \fIalice\fP と \fIbob\fP という2人のユーザーを \fIUsers\fP テーブルにロードするコマンドラインの例です:
+.sp
+.nf
+.ft C
+% curl \-\-data\-binary \(aq[{"_key": "alice"}, {"_key": "bob"}]\(aq \-H "Content\-Type: application/json" "http://localhost:10041/d/load?table=Users"
+.ft P
+.fi
 .SS HTTPS
 .sp
 TODO
@@ -7988,9 +8129,9 @@ http {
 % groonga\-httpd
 .ft P
 .fi
-.SS クエリを実行する
+.SS クエリーを実行する
 .sp
-動作を確認するため、簡単なクエリ（ \fB/reference/commands/status\fP ）をリクエストしてみます。
+動作を確認するため、簡単なクエリー（ \fB/reference/commands/status\fP ）をリクエストしてみます。
 .sp
 実行例:
 .sp
@@ -8140,7 +8281,7 @@ location /d/ {
 以下のディレクティブはgronoga\-httpdの性能に関連しているディレクティブです。
 .SS \fBworker_processes\fP
 .sp
-最適なパフォーマンスを得るためには、CPU数あるいはコア数と同じ数になるようにこのディレクティブを設定してください。大抵の場合、groongaのクエリはCPU負荷が高いものとなり、複数のCPU/コアを使い切るためには、このディレクティブを設定する必要があります。
+最適なパフォーマンスを得るためには、CPU数あるいはコア数と同じ数になるようにこのディレクティブを設定してください。大抵の場合、groongaのクエリーはCPU負荷が高いものとなり、複数のCPU/コアを使い切るためには、このディレクティブを設定する必要があります。
 .sp
 このディレクティブはgroonga\-httpdのディレクティブではなく、nginxのディレクティブです。詳細は、 \fI\%http://wiki.nginx.org/CoreModule#worker_processes\fP を参照してください。
 .sp
@@ -8251,7 +8392,7 @@ TSV（タブ区切り形式）
 JSONがデフォルトの出力形式です。
 .SS 使い方
 .sp
-groongaには以下のクエリインターフェイスがあります。
+groongaには以下のクエリーインターフェイスがあります。
 .INDENT 0.0
 .INDENT 3.5
 .INDENT 0.0
@@ -8266,7 +8407,7 @@ HTTP
 それぞれのインターフェイスで出力形式を変更する方法は異なります。
 .SS コマンドライン
 .sp
-\fBgroonga DB_PATH\fP または \fBgroonga \-c\fP でコマンドラインクエリインターフェイスを使うことができます。これらのgroongaコマンドでは \fB> \(ga\(ga というプロンプトが表示されます。クエリインターフェイスでは \(ga\(gaoutput_type\fP オプションで出力形式を指定できます。
+\fBgroonga DB_PATH\fP または \fBgroonga \-c\fP でコマンドラインクエリーインターフェイスを使うことができます。これらのgroongaコマンドでは \fB> \(ga\(ga というプロンプトが表示されます。クエリーインターフェイスでは \(ga\(gaoutput_type\fP オプションで出力形式を指定できます。
 .sp
 \fBoutput_type\fP オプションを指定しない場合はJSON形式の出力になります:
 .sp
@@ -8345,7 +8486,7 @@ MessagePack形式の出力にする場合は \fBoutput_type\fP に \fBmsgpack\fP
 .fi
 .SS HTTP
 .sp
-\fBgroonga \-\-protocol http \-s DB_PATH\fP でHTTPクエリインターフェイスを使うことができます。groonga HTTPサーバーはデフォルトで10041番ポートで起動します。このクエリインターフェイスでは拡張子で出力形式を指定します。
+\fBgroonga \-\-protocol http \-s DB_PATH\fP でHTTPクエリーインターフェイスを使うことができます。groonga HTTPサーバーはデフォルトで10041番ポートで起動します。このクエリーインターフェイスでは拡張子で出力形式を指定します。
 .sp
 拡張子を指定しない場合はJSON形式の出力になります:
 .sp
@@ -8422,6 +8563,11 @@ MessagePack形式の出力にする場合は \fBmsgpack\fP 拡張子を指定し
 (... omitted because MessagePack is binary data format. ...)
 .ft P
 .fi
+.SS コマンド
+.sp
+コマンドはクエリーAPIでもっとも重要な処理単位です。コマンドでgroongaに処理をリクエストします。
+.sp
+このセクションではコマンドについての説明と組み込みのコマンドについて説明します。
 .SS コマンドバージョン
 .SS 概要
 .sp
@@ -8496,157 +8642,460 @@ select \-\-command_version 1 \-\-table tablename
 .fi
 .sp
 指定されたコマンドバージョンでコマンドを実行します。指定されたコマンドバージョンがサポート対象外であった場合にはエラーが返されます。command\-versionが指定されなかった場合は、当該プロセス起動時にdefault\-command\-versionに指定した値が指定されたものとみなします。
-.SS コマンド
-.sp
-まず、すべてのコマンドに関係するコマンドバージョンについて説明します。その後、組み込みのコマンドを順に説明します。
-.SS コマンドバージョン
+.SS 出力形式
 .SS 概要
 .sp
-groonga1.1からコマンドバージョンという概念が導入されます。コマンドバージョンは、selectやloadなどのgroongaのコマンドの仕様の互換性を表します。groongaパッケージのバージョンが新しくなったとしても、同一のコマンドバージョンが使用可能であるなら、すべてのコマンドについて互換性が保証されます。コマンドバージョンが異なれば、同じ名前のコマンドであっても、動作に互換性がない可能性があります。
-.sp
-あるバージョンのgroongaは、二つのコマンドバージョンを同時にサポートするようになります。
-使用するコマンドバージョンは、groongaを起動する際のコマンドラインオプションないしコンフィグファイルにdefault\-commnad\-versionパラメータを与えることによって指定できます。また、個々のコマンドを実行する際に、command_versionパラメータを与えることによっても指定することができます。
+コマンドは実行結果をJSONまたはMessagePack、XML、TSVのどれかで出力します。
 .sp
-コマンドバージョンは1からはじまり、更新されるたびに1ずつ大きくなります。現状のgroongaのコマンドの仕様はcommand\-version 1という扱いになります。次回提供するgroongaは、command\-version 1とcommand\-version 2の二つをサポートすることになります。
-.SS バージョンの位置づけ
+JSONとMessagePackの出力は同じ構造になっています。XMLとTSVはそれぞれ独自の構造になっています。
 .sp
-あるバージョンのgroongaにおいてサポートされるコマンドバージョンは、develop, stable,deprecatedのいずれかの位置づけとなります。
-.INDENT 0.0
-.TP
-.B develop
-まだ開発中であり、仕様が変更される可能性があります。
-.TP
-.B stable
-使用可能であり仕様も安定しています。その時点で使用することが推奨されます。
-.TP
-.B deprecated
-使用可能であり仕様も安定していますが、廃止予定であり使用が推奨されません。
-.UNINDENT
+JSONまたはMessagePackの利用を推奨します。XMLは目視で結果を確認する時に便利です。TSVは特殊な用途では有用です。通常はTSVを使う必要はありません。
+.SS JSONとMessagePack
 .sp
-あるバージョンのgroongaがサポートする二つのコマンドバージョンのうち、いずれか一つが必ずstableの位置づけとなります。残りの一つは、developないしdeprecatedとなります。
+このセクションではJSONとMessagePack形式を使った時のコマンド実行結果の構造を説明します。MessagePackはバイナリー形式なのでここでは構造を示すためにJSONを使います。バイナリー形式はドキュメントには向いていません。
 .sp
-たとえば下記のようにgroongaのサポートするコマンドバージョンは推移します。:
+JSON形式、MessagePack形式のときは以下のような構造になります:
 .sp
 .nf
 .ft C
-groonga1.1: command\-version1=stable     command\-version2=develop
-groonga1.2: command\-version1=deprecated command\-version2=stable
-groonga1.3: command\-version2=stable     command\-version3=develop
-groonga1.4: command\-version2=deprecated command\-version3=stable
-groonga1.5: command\-version3=stable     command\-version4=develop
+[HEADER, BODY]
 .ft P
 .fi
 .sp
-あるコマンドバージョンははじめにdevelop扱いとしてリリースされ、やがてstableに移行します。
-その後二世代経過するとそのコマンドバージョンはdeprecated扱いとなります。さらに次のコマンドバージョンがリリースされると、deprecatedだったコマンドバージョンはサポート対象外となります。
-.sp
-default\-commnad\-versionパラメータやcommand_versionパラメータを指定せずにgroongaコマンドを実行した際には、その時点でstableであるコマンドバージョンが指定されたものとみなします。
+実行例:
 .sp
-groongaプロセス起動時に、default\-command\-versionパラメータにstable扱いでないコマンドバージョンを指定した場合には、警告メッセージがログファイルに出力されます。また、サポート範囲外のコマンドバージョンを指定した場合にはエラーとなり、プロセスは速やかに停止します。
-.SS コマンドバージョンの指定方法
+.nf
+.ft C
+[
+  [
+    0,
+    1337566253.89858,
+    0.000355720520019531
+  ],
+  [
+    [
+      [
+        1
+      ],
+      [
+        [
+          "_id",
+          "UInt32"
+        ],
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "content",
+          "Text"
+        ],
+        [
+          "n_likes",
+          "UInt32"
+        ]
+      ],
+      [
+        2,
+        "Groonga",
+        "I started to use groonga. It\(aqs very fast!",
+        10
+      ]
+    ]
+  ]
+]
+.ft P
+.fi
 .sp
-コマンドバージョンの指定方法はgroonga実行モジュールの引数として指定する方法と各コマンドの引数として指定する方法があります。
-.SS default\-command\-versionパラメータ
+この例では、以下の部分が \fBHEADER\fP に相当します:
 .sp
-groonga実行モジュールの引数としてdefault\-command\-versionパラメータを指定できます。
-(configファイルの中に指定することも可能です)
+.nf
+.ft C
+[
+  0,
+  1337566253.89858,
+  0.000355720520019531
+]
+.ft P
+.fi
 .sp
-実行例:
+\fBBODY\fP に相当する部分は以下です:
 .sp
 .nf
 .ft C
-groonga \-\-default\-command\-version 1
+[
+  [
+    [
+      1
+    ],
+    [
+      [
+        "_id",
+        "UInt32"
+      ],
+      [
+        "_key",
+        "ShortText"
+      ],
+      [
+        "content",
+        "Text"
+      ],
+      [
+        "n_likes",
+        "UInt32"
+      ]
+    ],
+    [
+      2,
+      "Groonga",
+      "I started to use groonga. It\(aqs very fast!",
+      10
+    ]
+  ]
+]
 .ft P
 .fi
+.SS \fBHEADER\fP
 .sp
-そのプロセスで実行するすべてのコマンドについて、デフォルトのコマンドバージョンとして指定されたバージョンを使用します。指定されたコマンドバージョンがstableであった場合にはなんのメッセージも表示されずそのまま起動します。指定されたコマンドバージョンがdevelopあるいはdeprecatedであった場合には、groonga.logファイルに警告メッセージを出力します。指定されたコマンドバージョンがサポート対象外であった場合には標準エラー出力にエラーメッセージを出力し、プロセスは速やかに終了します。
-.SS command_versionパラメータ
-.sp
-select,loadなどのすべてのgroongaコマンドにcommand_versionが指定できます。
+\fBHEADER\fP は配列です。 \fBHEADER\fP の内容にはいくつかのパターンがあります。
+.SS 成功した場合
 .sp
-実行例:
+コマンドが成功した場合は \fBHEADER\fP には3つの要素があります:
 .sp
 .nf
 .ft C
-select \-\-command_version 1 \-\-table tablename
+[0, UNIX_TIME_WHEN_COMMAND_IS_STARTED, ELAPSED_TIME]
 .ft P
 .fi
 .sp
-指定されたコマンドバージョンでコマンドを実行します。指定されたコマンドバージョンがサポート対象外であった場合にはエラーが返されます。command\-versionが指定されなかった場合は、当該プロセス起動時にdefault\-command\-versionに指定した値が指定されたものとみなします。
-.SS cache_limit
-.SS 名前
+最初の値は常に \fB0\fP です。
 .sp
-cache_limit \- cacheサイズの設定・取得
-.SS 書式
+\fBUNIX_TIME_WHEN_COMMAND_IS_STARTED\fP はコマンドの実行が始まったときの時刻です。時刻は1970\-01\-01 00:00:00から経過した秒数で表現されています。 \fBELAPSED_TIME\fP はコマンドの実行にかかった時間です。単位は秒です。 \fBUNIX_TIME_WHEN_COMMAND_IS_STARTED\fP も \fBELAPSED_TIME\fP も浮動小数点数です。小数部分はナノ秒を表します。
+.SS エラーの場合
+.sp
+エラーの場合、 \fBHEADER\fP には4個または5個の要素があります:
 .sp
 .nf
 .ft C
-cache_limit max
+[
+  RETURN_CODE,
+  UNIX_TIME_WHEN_COMMAND_IS_STARTED,
+  ELAPSED_TIME,
+  ERROR_MESSAGE,
+  ERROR_LOCATION
+]
 .ft P
 .fi
-.SS 説明
 .sp
-groonga組込コマンドの一つであるcache_limitについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+\fBERROR_LOCATION\fP は \fBHEADER\fP には含まれないかもしれませんが、他の4個の要素は常に含まれます。
 .sp
-cache_limitは、クエリキャッシュの最大件数を取得したり設定したりします。
-.SS 引数
+\fBRETURN_CODE\fP は0ではない値です。リターンコードの詳細は \fBreturn_code\fP を見てください。
 .sp
-\fBmax\fP
-.INDENT 0.0
-.INDENT 3.5
-クエリキャッシュの最大件数を整数で指定します。
-maxが指定されなかった場合には、クエリキャッシュの最大件数は変更せず、
-現在の設定値のみが返されます。
-.UNINDENT
-.UNINDENT
-.SS 返値
-.SS json
+\fBUNIX_TIME_WHEN_COMMAND_IS_STARTED\fP と \fBELAPSED_TIME\fP は成功した時と同じです。
+.sp
+\fBERROR_MESSAGE\fP はエラーメッセージです。文字列です。
+.sp
+\fBERROR_LOCATION\fP は存在しないことがあります。もし、エラーが発生した場所の情報を収集できていた場合は \fBERROR_LOCATION\fP が含まれます。 \fBERROR_LOCATION\fP は配列です。 \fBERROR_LOCATION\fP は1個または2個の要素を含みます:
 .sp
 .nf
 .ft C
-[以前の設定値]
-
-\(ga\(ga以前の設定値\(ga\(ga
-
-  すでに設定されていたクエリキャッシュの最大件数を返す。
+[
+  LOCATION_IN_GROONGA,
+  LOCATION_IN_INPUT
+]
 .ft P
 .fi
-.SS 例
+.sp
+\fBLOCATION_IN_GROONGA\fP はgroonga内でエラーが発生したソースコードの場所です。この情報はgroonga開発者には役に立ちますが、ユーザーの役には立ちません。 \fBLOCATION_IN_GROONGA\fP は配列です。 \fBLOCATION_IN_GROONGA\fP には3個の要素があります:
 .sp
 .nf
 .ft C
-cache_limit 4
-[100]
+[
+  FUNCTION_NAME,
+  SOURCE_FILE_NAME,
+  LINE_NUMBER
+]
 .ft P
 .fi
-.SS check
-.SS 名前
 .sp
-check \- オブジェクトの状態表示
-.SS 書式
+\fBFUNCTION_NAME\fP はエラーが発生した関数の名前です。
+.sp
+\fBSOURCE_FILE_NAME\fP はエラーが発生した箇所を含んだgroongaのソースコードのファイル名です。
+.sp
+\fBLINE_NUMBER\fP はエラーが発生した箇所の \fBSOURCE_FILE_NAME\fP での行番号です。
+.sp
+\fBLOCATION_IN_INPUT\fP は存在しないことがあります。 \fBLOCATION_IN_INPUT\fP は入力ファイルでエラーが発生した場所の情報を収集できたときに含まれます。入力ファイルは \fBgroonga\fP コマンドのコマンドラインオプション \fB\-\-file\fP で指定できます。 \fBLOCATION_IN_GROONGA\fP は配列です。 \fBLOCATION_IN_GROONGA\fP には3個の要素があります:
 .sp
 .nf
 .ft C
-check obj
+[
+  INPUT_FILE_NAME,
+  LINE_NUMBER,
+  LINE_CONTENT
+]
 .ft P
 .fi
-.SS 説明
 .sp
-groonga組込コマンドの一つであるcheckについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+\fBINPUT_FILE_NAME\fP はエラーが発生した入力ファイルのファイル名です。
 .sp
-checkコマンドは、groongaプロセス内の指定したオブジェクトの状態を表示します。主にデータベースが壊れた場合など異常時の問題解決のために使用することを想定しています。デバッグ用のため、返値のフォーマットが安定しているということは保証されません。（フォーマットが変更される可能性が高い）
-.SS 引数
+\fBLINE_NUMBER\fP はエラーが発生した箇所の \fBINPUT_FILE_NAME\fP での行番号です。
 .sp
-\fBobj\fP
+\fBLINE_CONTENT\fP は \fBINPUT_FILE_NAME\fP 内の \fBLINE_NUMBER\fP 行目の内容です。
+.SS \fBBODY\fP
+.sp
+\fBBODY\fP の内容は実行したコマンドに依存します。 \fBBODY\fP がないこともあります。
+.sp
+エラーが発生した時に、 \fBBODY\fP にエラーメッセージが入っていることもあります。
+.SS XML
+.sp
+TODO
+.SS TSV
+.sp
+TODO
+.SS 参考
 .INDENT 0.0
-.INDENT 3.5
-状態を表示するオブジェクトの名前を指定します。
-.UNINDENT
+.IP \(bu 2
+\fBreturn_code\fP describes about return code.
 .UNINDENT
-.SS 返値
-.SS json形式
+.SS リターンコード
+.SS 概要
 .sp
-チェックするオブジェクトにより返される値が変わります。
+リターンコードは処理が成功したかどうかを示すために使われます。もし、処理が成功していなければリターンコードはエラーの種類を示します。
+.sp
+リターンコードはCのAPIでもクエリーAPIでも使われます。CのAPIでは \fBgrn_ctx_t::rc\fP でリターンコードを確認できます。クエリーAPIではヘッダー要素を見るとリターンコードを確認できます。クエリーAPIでのヘッダー要素については \fBoutput_format\fP を参照してください。
+.SS 一覧
+.sp
+以下はリターンコードの一覧です。 \fBGRN_SUCCESS\fP (= 0) は処理が成功したことを示しています。負の値のリターンコードはエラーの種類を表しています。 \fBGRN_END_OF_DATA\fP は特別なリターンコードです。このリターンコードはCのAPIでだけ使われていて、クエリーAPIにはでてきません。
+.INDENT 0.0
+.IP \(bu 2
+0: \fBGRN_SUCCESS\fP
+.IP \(bu 2
+1: \fBGRN_END_OF_DATA\fP
+.IP \(bu 2
+\-1: \fBGRN_UNKNOWN_ERROR\fP
+.IP \(bu 2
+\-2: \fBGRN_OPERATION_NOT_PERMITTED\fP
+.IP \(bu 2
+\-3: \fBGRN_NO_SUCH_FILE_OR_DIRECTORY\fP
+.IP \(bu 2
+\-4: \fBGRN_NO_SUCH_PROCESS\fP
+.IP \(bu 2
+\-5: \fBGRN_INTERRUPTED_FUNCTION_CALL\fP
+.IP \(bu 2
+\-6: \fBGRN_INPUT_OUTPUT_ERROR\fP
+.IP \(bu 2
+\-7: \fBGRN_NO_SUCH_DEVICE_OR_ADDRESS\fP
+.IP \(bu 2
+\-8: \fBGRN_ARG_LIST_TOO_LONG\fP
+.IP \(bu 2
+\-9: \fBGRN_EXEC_FORMAT_ERROR\fP
+.IP \(bu 2
+\-10: \fBGRN_BAD_FILE_DESCRIPTOR\fP
+.IP \(bu 2
+\-11: \fBGRN_NO_CHILD_PROCESSES\fP
+.IP \(bu 2
+\-12: \fBGRN_RESOURCE_TEMPORARILY_UNAVAILABLE\fP
+.IP \(bu 2
+\-13: \fBGRN_NOT_ENOUGH_SPACE\fP
+.IP \(bu 2
+\-14: \fBGRN_PERMISSION_DENIED\fP
+.IP \(bu 2
+\-15: \fBGRN_BAD_ADDRESS\fP
+.IP \(bu 2
+\-16: \fBGRN_RESOURCE_BUSY\fP
+.IP \(bu 2
+\-17: \fBGRN_FILE_EXISTS\fP
+.IP \(bu 2
+\-18: \fBGRN_IMPROPER_LINK\fP
+.IP \(bu 2
+\-19: \fBGRN_NO_SUCH_DEVICE\fP
+.IP \(bu 2
+\-20: \fBGRN_NOT_A_DIRECTORY\fP
+.IP \(bu 2
+\-21: \fBGRN_IS_A_DIRECTORY\fP
+.IP \(bu 2
+\-22: \fBGRN_INVALID_ARGUMENT\fP
+.IP \(bu 2
+\-23: \fBGRN_TOO_MANY_OPEN_FILES_IN_SYSTEM\fP
+.IP \(bu 2
+\-24: \fBGRN_TOO_MANY_OPEN_FILES\fP
+.IP \(bu 2
+\-25: \fBGRN_INAPPROPRIATE_I_O_CONTROL_OPERATION\fP
+.IP \(bu 2
+\-26: \fBGRN_FILE_TOO_LARGE\fP
+.IP \(bu 2
+\-27: \fBGRN_NO_SPACE_LEFT_ON_DEVICE\fP
+.IP \(bu 2
+\-28: \fBGRN_INVALID_SEEK\fP
+.IP \(bu 2
+\-29: \fBGRN_READ_ONLY_FILE_SYSTEM\fP
+.IP \(bu 2
+\-30: \fBGRN_TOO_MANY_LINKS\fP
+.IP \(bu 2
+\-31: \fBGRN_BROKEN_PIPE\fP
+.IP \(bu 2
+\-32: \fBGRN_DOMAIN_ERROR\fP
+.IP \(bu 2
+\-33: \fBGRN_RESULT_TOO_LARGE\fP
+.IP \(bu 2
+\-34: \fBGRN_RESOURCE_DEADLOCK_AVOIDED\fP
+.IP \(bu 2
+\-35: \fBGRN_NO_MEMORY_AVAILABLE\fP
+.IP \(bu 2
+\-36: \fBGRN_FILENAME_TOO_LONG\fP
+.IP \(bu 2
+\-37: \fBGRN_NO_LOCKS_AVAILABLE\fP
+.IP \(bu 2
+\-38: \fBGRN_FUNCTION_NOT_IMPLEMENTED\fP
+.IP \(bu 2
+\-39: \fBGRN_DIRECTORY_NOT_EMPTY\fP
+.IP \(bu 2
+\-40: \fBGRN_ILLEGAL_BYTE_SEQUENCE\fP
+.IP \(bu 2
+\-41: \fBGRN_SOCKET_NOT_INITIALIZED\fP
+.IP \(bu 2
+\-42: \fBGRN_OPERATION_WOULD_BLOCK\fP
+.IP \(bu 2
+\-43: \fBGRN_ADDRESS_IS_NOT_AVAILABLE\fP
+.IP \(bu 2
+\-44: \fBGRN_NETWORK_IS_DOWN\fP
+.IP \(bu 2
+\-45: \fBGRN_NO_BUFFER\fP
+.IP \(bu 2
+\-46: \fBGRN_SOCKET_IS_ALREADY_CONNECTED\fP
+.IP \(bu 2
+\-47: \fBGRN_SOCKET_IS_NOT_CONNECTED\fP
+.IP \(bu 2
+\-48: \fBGRN_SOCKET_IS_ALREADY_SHUTDOWNED\fP
+.IP \(bu 2
+\-49: \fBGRN_OPERATION_TIMEOUT\fP
+.IP \(bu 2
+\-50: \fBGRN_CONNECTION_REFUSED\fP
+.IP \(bu 2
+\-51: \fBGRN_RANGE_ERROR\fP
+.IP \(bu 2
+\-52: \fBGRN_TOKENIZER_ERROR\fP
+.IP \(bu 2
+\-53: \fBGRN_FILE_CORRUPT\fP
+.IP \(bu 2
+\-54: \fBGRN_INVALID_FORMAT\fP
+.IP \(bu 2
+\-55: \fBGRN_OBJECT_CORRUPT\fP
+.IP \(bu 2
+\-56: \fBGRN_TOO_MANY_SYMBOLIC_LINKS\fP
+.IP \(bu 2
+\-57: \fBGRN_NOT_SOCKET\fP
+.IP \(bu 2
+\-58: \fBGRN_OPERATION_NOT_SUPPORTED\fP
+.IP \(bu 2
+\-59: \fBGRN_ADDRESS_IS_IN_USE\fP
+.IP \(bu 2
+\-60: \fBGRN_ZLIB_ERROR\fP
+.IP \(bu 2
+\-61: \fBGRN_LZO_ERROR\fP
+.IP \(bu 2
+\-62: \fBGRN_STACK_OVER_FLOW\fP
+.IP \(bu 2
+\-63: \fBGRN_SYNTAX_ERROR\fP
+.IP \(bu 2
+\-64: \fBGRN_RETRY_MAX\fP
+.IP \(bu 2
+\-65: \fBGRN_INCOMPATIBLE_FILE_FORMAT\fP
+.IP \(bu 2
+\-66: \fBGRN_UPDATE_NOT_ALLOWED\fP
+.IP \(bu 2
+\-67: \fBGRN_TOO_SMALL_OFFSET\fP
+.IP \(bu 2
+\-68: \fBGRN_TOO_LARGE_OFFSET\fP
+.IP \(bu 2
+\-69: \fBGRN_TOO_SMALL_LIMIT\fP
+.IP \(bu 2
+\-70: \fBGRN_CAS_ERROR\fP
+.IP \(bu 2
+\-71: \fBGRN_UNSUPPORTED_COMMAND_VERSION\fP
+.UNINDENT
+.SS 参考
+.INDENT 0.0
+.IP \(bu 2
+\fBoutput_format\fP はクエリーAPIでのレスポンスの中でどこにリターンコードがあるかを説明しています。
+.IP \(bu 2
+\fB/spec/gqtp\fP: GQTPプロトコルもステータスとしてリターンコードを使っていますが、ステータスは2バイトの符号なし整数です。そのため、GQTPプロトコルでは、負の値のリターンコードは正の値のステータスになります。GQTPプロトコルのステータスの値を2バイトの符号付き整数として扱うとステータスをリターンコードに変換できます。
+.UNINDENT
+.SS cache_limit
+.SS 名前
+.sp
+cache_limit \- cacheサイズの設定・取得
+.SS 書式
+.sp
+.nf
+.ft C
+cache_limit max
+.ft P
+.fi
+.SS 説明
+.sp
+groonga組込コマンドの一つであるcache_limitについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+.sp
+cache_limitは、クエリキャッシュの最大件数を取得したり設定したりします。
+.SS 引数
+.sp
+\fBmax\fP
+.INDENT 0.0
+.INDENT 3.5
+クエリキャッシュの最大件数を整数で指定します。
+maxが指定されなかった場合には、クエリキャッシュの最大件数は変更せず、
+現在の設定値のみが返されます。
+.UNINDENT
+.UNINDENT
+.SS 返値
+.SS json
+.sp
+.nf
+.ft C
+[以前の設定値]
+
+\(ga\(ga以前の設定値\(ga\(ga
+
+  すでに設定されていたクエリキャッシュの最大件数を返す。
+.ft P
+.fi
+.SS 例
+.sp
+.nf
+.ft C
+cache_limit 4
+[100]
+.ft P
+.fi
+.SS check
+.SS 名前
+.sp
+check \- オブジェクトの状態表示
+.SS 書式
+.sp
+.nf
+.ft C
+check obj
+.ft P
+.fi
+.SS 説明
+.sp
+groonga組込コマンドの一つであるcheckについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+.sp
+checkコマンドは、groongaプロセス内の指定したオブジェクトの状態を表示します。主にデータベースが壊れた場合など異常時の問題解決のために使用することを想定しています。デバッグ用のため、返値のフォーマットが安定しているということは保証されません。（フォーマットが変更される可能性が高い）
+.SS 引数
+.sp
+\fBobj\fP
+.INDENT 0.0
+.INDENT 3.5
+状態を表示するオブジェクトの名前を指定します。
+.UNINDENT
+.UNINDENT
+.SS 返値
+.SS json形式
+.sp
+チェックするオブジェクトにより返される値が変わります。
 .sp
 インデックスカラムの場合:
 .sp
@@ -9826,6 +10275,53 @@ quitは、groongaプロセスとのセッションを終了します。クライ
 quit
 .ft P
 .fi
+.SS register
+.SS 概要
+.sp
+\fBregister\fP コマンドはプラグインを登録します。プラグインを使う前にプラグインを登録する必要があります。
+.sp
+同じデータベースに対しては1つのプラグインについて一度だけ \fIregister\(ga\fP コマンドを実行すれば十分です。これは、登録されたプラグイン情報はデータベースに記録されているからです。 \fBgroonga\fP プロセスを再起動したときは、 \fBregister\fP コマンドを実行しなくてもすでに登録されているプラグインを読み込みます。
+.IP ノート
+今のところ、登録したプラグインは削除できません。
+.RE
+.SS 構文
+.sp
+\fBregister\fP の引数は \fBpath\fP だけです。これは必須の引数です:
+.sp
+.nf
+.ft C
+register path
+.ft P
+.fi
+.SS 使い方
+.sp
+これは \fB${PREFIX}/lib/groonga/plugins/query_expanders/tsv.so\fP に含まれている \fBQueryExpanderTSV\fP クエリー展開オブジェクトを登録する例です。
+.sp
+実行例:
+.sp
+.nf
+.ft C
+register query_expanders/tsv
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+.ft P
+.fi
+.sp
+\fB${PREFIX}/lib/groonga/plugins/\fP と拡張子（ \fB.so\fP ）は省略可能です。これらは自動で補完されます。
+.sp
+\fBregister /usr/lib/groonga/plugins/query_expanders/tsv.so\fP というように絶対パスを指定することもできます。
+.SS 戻り値
+.sp
+\fBregister\fP が成功したときは以下のようにボディは \fBtrue\fP になります:
+.sp
+.nf
+.ft C
+[HEADER, true]
+.ft P
+.fi
+.sp
+\fBregister\fP が失敗すると、エラーの詳細は \fBHEADER\fP に含まれます。
+.sp
+\fBHEADER\fP については \fB/reference/command/output_format\fP を参照してください。
 .SS select
 .SS 概要
 .sp
@@ -10049,7 +10545,7 @@ select Entries \-\-match_columns content \-\-query fast
 .sp
 この \fBselect\fP コマンドは \fBEntries\fP テーブルの中から \fBcontent\fP カラムの値に \fBfast\fP を含んでいるレコードを検索します。
 .sp
-\fBquery\fP はクエリ構文という構文を使いますが、詳細はここでは説明しません。詳細は \fB/reference/grn_expr/query_syntax\fP を参照してください。
+\fBquery\fP はクエリー構文という構文を使いますが、詳細はここでは説明しません。詳細は \fB/reference/grn_expr/query_syntax\fP を参照してください。
 .SS 検索条件: \fBfilter\fP
 .sp
 \fBfilter\fP は複雑な検索条件を指定するために用意されています。ECMAScriptのような構文で  \fBfilter\fP に検索条件を指定します。
@@ -10383,7 +10879,7 @@ select Entries \-\-match_columns \(aq_key * 10 || content\(aq \-\-query groonga
 \fB\-\-match_columns \(aq_key * 10 || content\(aq\fP はデフォルト検索対象カラムが \fB_key\fP カラムと \fBcontent\fP カラムで、 \fB_key\fP カラムの重みは10、 \fBcontent\fP カラムの重みは1という意味です。この重み付けは \fB_key\fP カラムの値は \fBcontent\fP カラムの値よりも重要だという意味になります。この例では、ブログエントリのタイトルはブログエントリの内容よりも重要だということです。
 .SS \fBquery\fP
 .sp
-クエリテキストを指定します。通常、全文検索をするために \fBmatch_columns\fP 引数と一緒に使います。 \fBquery\fP 引数はWebページにある全文検索フォームで使いやすいように設計されています。クエリテキストは \fB/reference/grn_expr/query_syntax\fP という書式を使います。この書式はGoogleの検索フォームのように一般的な検索フォームと似ています。例えば、 \fBword1 word2\fP は \fBword1\fP と \fBword2\fP を含んでいるレコードを検索するという意味になります。 \fBword1 OR word2\fP は \fBword1\fP または \fBword2\fP を含んでいるレコードを検索するという意味になります。
+クエリーテキストを指定します。通常、全文検索をするために \fBmatch_columns\fP 引数と一緒に使います。 \fBquery\fP 引数はWebページにある全文検索フォームで使いやすいように設計されています。クエリーテキストは \fB/reference/grn_expr/query_syntax\fP という書式を使います。この書式はGoogleの検索フォームのように一般的な検索フォームと似ています。例えば、 \fBword1 word2\fP は \fBword1\fP と \fBword2\fP を含んでいるレコードを検索するという意味になります。 \fBword1 OR word2\fP は \fBword1\fP または \fBword2\fP を含んでいるレコードを検索するという意味になります。
 .sp
 以下は論理積を使った検索の簡単な例です。
 .sp
@@ -10846,15 +11342,15 @@ select Entries \-\-match_columns content \-\-query groo \-\-match_escalation_thr
 2番目の \fBselect\fP コマンドも \fBEntries\fP テーブルから \fBcontent\fP カラムの値に \fBgroo\fP という単語を含むレコードを検索します。そして、この \fBselect\fP コマンドもマッチしません。この場合、マッチしたレコード数（0）が \fBmatch_escalation_threshold\fP （\-1）より大きいので、検索方法をエスカレーションしません。そして、1つもレコードがマッチしません。
 .SS \fBquery_expansion\fP
 .sp
-クエリ展開用の引数です。クエリ展開はクエリ中の特定の単語を別の単語に置換します。通常は類義語検索に使います。
+クエリー展開用の引数です。クエリー展開はクエリー中の特定の単語を別の単語に置換します。通常は類義語検索に使います。
 .sp
 \fBquery\fP 引数の値を置換するために使うカラムを指定します。この引数の値の書式は「 \fB${TABLE}.${COLUMN}\fP 」です。例えば、 「 \fBTerms.synonym\fP 」は \fBTerms\fP テーブルの \fBsynonym\fP カラムを指定しています。
 .sp
-クエリ展開用のテーブルを「置換テーブル」と呼びます。置換テーブルのキーは \fBShortText\fP にしてください。そのため、配列テーブル（ \fBTABLE_NO_KEY\fP ）は置換テーブルに使うことはできません。なぜなら、配列テーブルにはキーがないからです。
+クエリー展開用のテーブルを「置換テーブル」と呼びます。置換テーブルのキーは \fBShortText\fP にしてください。そのため、配列テーブル（ \fBTABLE_NO_KEY\fP ）は置換テーブルに使うことはできません。なぜなら、配列テーブルにはキーがないからです。
 .sp
-クエリ展開用のカラムを「置換カラム」と呼びます。置換カラムの値の型は \fBShortText\fP にしてください。カラムの種類はベクター（ \fBCOLUMN_VECTOR\fP ）にしてください。
+クエリー展開用のカラムを「置換カラム」と呼びます。置換カラムの値の型は \fBShortText\fP にしてください。カラムの種類はベクター（ \fBCOLUMN_VECTOR\fP ）にしてください。
 .sp
-クエリ展開はクエリの中にある置換テーブルのキーを置換カラムの値で置換します。 \fBquery\fP の中にある単語が置換テーブルのキーだったら、キーに対応する置換カラムの値でその単語を置換します。置換は再帰的に実行しません。これは、置換されたクエリ内に置換対象の単語があっても置換されないということです。
+クエリー展開はクエリーの中にある置換テーブルのキーを置換カラムの値で置換します。 \fBquery\fP の中にある単語が置換テーブルのキーだったら、キーに対応する置換カラムの値でその単語を置換します。置換は再帰的に実行しません。これは、置換されたクエリー内に置換対象の単語があっても置換されないということです。
 .sp
 以下は \fBquery_expansion\fP の簡単な使用例を示すためのサンプル置換テーブルです。
 .sp
@@ -11017,11 +11513,11 @@ select Entries \-\-match_columns content \-\-query "((mroonga) OR (tritonn) OR (
 .ft P
 .fi
 .sp
-最初の \fBselect\fP コマンドはクエリ展開を使いません。そのため、 \fB"tritonn"\fP という単語を含んでいるレコードは見つかりません。2番目の \fBselect\fP コマンドはクエリ展開を使っています。そのため、 \fB"tritonn"\fP という単語を含んでいるレコードが見つかります。3番目の \fBselect\fP コマンドはクエリ展開を使っていませんが、2番目の \fBselect\fP コマンドと同じ結果になります。これは、3番目の \fBselect\fP コマンドは展開後のクエリを使っているからです。
+最初の \fBselect\fP コマンドはクエリー展開を使いません。そのため、 \fB"tritonn"\fP という単語を含んでいるレコードは見つかりません。2番目の \fBselect\fP コマンドはクエリー展開を使っています。そのため、 \fB"tritonn"\fP という単語を含んでいるレコードが見つかります。3番目の \fBselect\fP コマンドはクエリー展開を使っていませんが、2番目の \fBselect\fP コマンドと同じ結果になります。これは、3番目の \fBselect\fP コマンドは展開後のクエリーを使っているからです。
 .sp
 それぞれの置換する値は \fB(...)\fP や \fBOR\fP といった \fB/reference/grn_expr/query_syntax\fP を使えます。これらの構文を使うことにより複雑な置換をすることができます。
 .sp
-以下はクエリ構文を使った複雑な置換の使用例です。
+以下はクエリー構文を使った複雑な置換の使用例です。
 .sp
 実行例:
 .sp
@@ -11080,7 +11576,7 @@ select Entries \-\-match_columns content \-\-query "popular" \-\-query_expansion
 .ft P
 .fi
 .sp
-この \fBload\fP コマンドは新しく \fB"popular"\fP という類義語を登録しています。これは \fB((popular) OR (n_likes:>=10))\fP に置換されます。置換されたクエリは、「popular」というのは「popular」という単語を含んでいるか10以上の「いいね！」数を持つエントリという意味になります。
+この \fBload\fP コマンドは新しく \fB"popular"\fP という類義語を登録しています。これは \fB((popular) OR (n_likes:>=10))\fP に置換されます。置換されたクエリーは、「popular」というのは「popular」という単語を含んでいるか10以上の「いいね！」数を持つエントリという意味になります。
 .sp
 この \fBselect\fP コマンドは \fBEntries\fP テーブルの中から \fBn_likes\fP カラムの値が \fB10\fP 以上のレコードを出力します。
 .SS \fBquery_flags\fP
@@ -11107,7 +11603,7 @@ select Entries \-\-match_columns content \-\-query "popular" \-\-query_expansion
 .sp
 \fBALLOW_UPDATE\fP を指定すると \fBCOLUMN:=NEW_VALUE\fP という構文を使って \fBquery\fP でカラムの値を更新できます。カラム更新用の構文ではカラムを指定する必要があるため、 \fBALLOW_COLUMN\fP も一緒に指定する必要があります。
 .sp
-\fBALLOW_LEADING_NOT\fP を指定すると \fB\-WORD\fP という構文を使って最初の条件として否定条件を指定できます。このクエリは \fBWORD\fP にマッチしないレコードを検索します。最初の条件に否定条件を使ったクエリは多くの場合重いクエリになります。これは多くのレコードにマッチするからです。そのため、このフラグはデフォルトでは無効になっています。もし、このフラグを使う場合は重いクエリとなるということを十分気をつけてください。
+\fBALLOW_LEADING_NOT\fP を指定すると \fB\-WORD\fP という構文を使って最初の条件として否定条件を指定できます。このクエリーは \fBWORD\fP にマッチしないレコードを検索します。最初の条件に否定条件を使ったクエリーは多くの場合重いクエリーになります。これは多くのレコードにマッチするからです。そのため、このフラグはデフォルトでは無効になっています。もし、このフラグを使う場合は重いクエリーとなるということを十分気をつけてください。
 .sp
 \fBNONE\fP は単に無視されます。フラグを指定しないときに \fBNONE\fP を使えます。
 .sp
@@ -12150,7 +12646,7 @@ status
 .RE
 .SS 名前
 .sp
-suggest \- 指定されたクエリに対する補完・補正・提案候補を返す。
+suggest \- 指定されたクエリーに対する補完・補正・提案候補を返す。
 .SS 書式
 .sp
 .nf
@@ -12160,7 +12656,7 @@ suggest types table column query [sortby [output_columns [offset [limit [frequen
 .fi
 .SS 説明
 .sp
-suggestコマンドは指定されたクエリに対する補完・補正・提案候補を返します。
+suggestコマンドは指定されたクエリーに対する補完・補正・提案候補を返します。
 .sp
 補完・補正・提案については \fB/suggest/introduction\fP を参照してください。
 .SS オプション
@@ -12228,7 +12724,7 @@ groonga\-suggest\-create\-dataset /tmp/db\-path query
 \fBtable\fP で指定したテーブルにあるふりがな情報を含むカラムを指定します。ふりがなはカタカナで指定します。
 .TP
 .B \fBquery\fP
-補完・補正・提案対象のクエリを指定します。
+補完・補正・提案対象のクエリーを指定します。
 .TP
 .B \fBsortby\fP
 ソートキーを指定します。
@@ -12334,7 +12830,7 @@ groonga\-suggest\-create\-dataset /tmp/db\-path query
 \fBauto\fP
 .UNINDENT
 .UNINDENT
-.SS 返値
+.SS 戻り値
 .SS JSON形式
 .sp
 返されるJSON形式は以下の通りです:
@@ -13220,49 +13716,226 @@ Object型はv1.2でサポートされます。
 .SS Tokenizers
 .sp
 TODO: Write me.
-.SS 疑似カラム (pseudo_column)
-.SS 名前
+.SS クエリー展開オブジェクト一覧
+.SS QueryExpanderTSV
+.SS 概要
 .sp
-疑似カラム
-.SS 説明
+\fBQueryExpanderTSV\fP はクエリー展開プラグインです。同義語はTSV（データをタブで区切るファイルフォーマット）ファイルから読み込みます。このプラグインは組み込みのクエリー展開機能よりも機能が少ないです。例えば、単語の正規化をサポートしていません。しかし、TSVファイルで同義語を管理できるためこちらの方が使いやすいかもしれません。TSVファイルなのでExcelなどの表計算ソフトで同義語を編集できます。組み込みのクエリー展開機能では、groongaのテーブルとして同義語を管理します。
+.SS インストール
 .sp
-groongaのデータベースで作成したテーブルには、いくつかのカラムが自動的に定義されます。
+\fBQueryExpanderTSV\fP を使う前に \fBquery_expanders/tsv\fP をプラグインとして登録します:
 .sp
-これらのカラムはいずれもアンダースコア(\(aq_\(aq)で始まる名前が付与されます。定義される疑似カラムは、テーブルの種類によって異なります。
+.nf
+.ft C
+register query_expanders/tsv
+.ft P
+.fi
+.SS 使い方
 .sp
-\fB_id\fP
-.INDENT 0.0
-.INDENT 3.5
-レコードに付与される一意な番号です。全てのテーブルに定義されます。値の範囲は1〜1073741824の整数で、通常はレコードを追加した順に1ずつ加算されます。_idの値は不変で、レコードが存在する限り変更することはできません。ただし、削除されたレコードの_idの値は再利用されます。
-.UNINDENT
-.UNINDENT
+\fBselect\fP コマンドに \fB\-\-query_expansion QueryExpanderTSV\fP パラメーターを追加します:
 .sp
-\fB_key\fP
-.INDENT 0.0
-.INDENT 3.5
-レコードの主キー値を表します。主キーを持つテーブルのみに定義されます。主キー値はテーブルの中で一意であり、変更することはできません。
-.UNINDENT
-.UNINDENT
+.nf
+.ft C
+select \-\-query "QUERY" \-\-query_expansion QueryExpanderTSV
+.ft P
+.fi
 .sp
-\fB_value\fP
-.INDENT 0.0
-.INDENT 3.5
-レコードの値を表します。value_typeを指定したテーブルのみに定義されます。自由に変更可能です。
-.UNINDENT
-.UNINDENT
+\fBQUERY\fP 内に登録済みの同義語がある場合はそれらが展開されます。例えば、以下の同義語があるとします。
+.TS
+center;
+|l|l|l|.
+_
+T{
+単語
+T}	T{
+同義語1
+T}	T{
+同義語2
+T}
+_
+T{
+groonga
+T}	T{
+groonga
+T}	T{
+Senna
+T}
+_
+T{
+mroonga
+T}	T{
+mroonga
+T}	T{
+groonga MySQL
+T}
+_
+.TE
 .sp
-\fB_score\fP
-.INDENT 0.0
-.INDENT 3.5
-各レコードのスコア値を表します。検索結果として生成されたテーブルのみに定義されます。
+この表は、 \fB単語\fP の同義語は \fB同義語1\fP と \fB同義語2\fP という意味です。例えば、 \fBgroonga\fP の同義語は \fBgroonga\fP と \fBSenna\fP です。また、 \fBmroonga\fP の同義語は \fBmroonga\fP と \fBgroonga MySQL\fP です。
 .sp
-検索処理を実行する過程で値が設定されますが、自由に変更可能です。
-.UNINDENT
-.UNINDENT
+クエリーが \fBgroonga\fP のときのクエリー展開の例です:
 .sp
-\fB_nsubrecs\fP
-.INDENT 0.0
-.INDENT 3.5
+.nf
+.ft C
+select \-\-query "groonga" \-\-query_expansion QueryExpanderTSV
+.ft P
+.fi
+.sp
+上記のコマンドは以下のコマンドと同じ意味です:
+.sp
+.nf
+.ft C
+select \-\-query "groonga OR Senna" \-\-query_expansion QueryExpanderTSV
+.ft P
+.fi
+.sp
+クエリーが \fBmroonga search\fP のときのクエリー展開の例です:
+.sp
+.nf
+.ft C
+select \-\-query "mroonga search" \-\-query_expansion QueryExpanderTSV
+.ft P
+.fi
+.sp
+上記のコマンドは以下のコマンドと同じ意味です:
+.sp
+.nf
+.ft C
+select \-\-query "(mroonga OR (groonga MySQL)) search" \-\-query_expansion QueryExpanderTSV
+.ft P
+.fi
+.sp
+登録されている単語だけ（ここでは \fBgroonga\fP と \fBmroonga\fP ）クエリー展開されて、登録されていない単語（ここでは \fBsearch\fP ）はクエリー展開されていないことが大事なポイントです。また、再帰的にクエリー展開しません。クエリー展開した結果の \fB(mroonga OR (groonga MySQL))\fP の中に \fBgroonga\fP がありますが、これは展開されません。
+.sp
+通常、同義語の中に \fB単語\fP 自身も含める必要があります。例えば、 \fBgroonga\fP と \fBmroonga\fP が同義語の中に含まれています。もし、 \fB単語\fP 自身を無視したい場合は同義語の中に \fB単語\fP を含めないでください。例えば、クエリー展開機能をスペル訂正機能として使う場合は、以下のような同義語を使ってください。
+.TS
+center;
+|l|l|.
+_
+T{
+単語
+T}	T{
+同義語
+T}
+_
+T{
+gronga
+T}	T{
+groonga
+T}
+_
+.TE
+.sp
+\fB単語\fP の \fBgronga\fP には誤字があります。 \fBo\fP がひとつ足りません。 \fB同義語\fP の \fBgroonga\fP が正しい単語です。
+.sp
+スペル訂正機能としてクエリー展開機能を使う例です:
+.sp
+.nf
+.ft C
+select \-\-query "gronga" \-\-query_expansion QueryExpanderTSV
+.ft P
+.fi
+.sp
+上記のコマンドは以下のコマンドと同じ意味です:
+.sp
+.nf
+.ft C
+select \-\-query "groonga" \-\-query_expansion QueryExpanderTSV
+.ft P
+.fi
+.sp
+前者のコマンドは \fB\-\-query\fP の値に誤字がありますが、後者のコマンドは誤字がありません。
+.SS TSVファイル
+.sp
+同義語はTSVフォーマットのファイルで定義します。このセクションでは定義方法について説明します。
+.SS 場所
+.sp
+TSVファイルのファイル名は \fBsynonyms.tsv\fP で、設定ディレクトリに置かなければいけません。例えば、 \fB/etc/groonga/synonyms.tsv\fP がTSVファイルの場所になります。場所はビルド時に決まります。
+.sp
+環境変数 \fBGRN_QUERY_EXPANDER_TSV_SYNONYMS_FILE\fP を指定することで実行時に場所を変更することもできます:
+.sp
+.nf
+.ft C
+% env GRN_QUERY_EXPANDER_TSV_SYNONYMS_FILE=/tmp/synonyms.tsv groonga
+.ft P
+.fi
+.sp
+上述のコマンドでは \fB/tmp/synonyms.tsv\fP ファイルが使われます。
+.SS フォーマット
+.sp
+TSVファイル内に0個以上の同義語を定義することができます。1行につき \fB単語\fP と \fB同義語リスト\fP のペアを定義します。 \fB\-\-query\fP の値の中にでてきた \fB単語\fP は \fB同義語リスト\fP に展開されます。 \fB同義語リスト\fP は \fBOR\fP でまとめます。例えば、同義語リスト \fBgroonga\fP と \fBSenna\fP は \fBgroonga OR Senna\fP と展開されます。
+.sp
+最初のカラムが \fB単語\fP で、残りのカラムが \fB単語\fP の \fB同義語リスト\fP になります。以下は、 \fB単語\fP が \fBgroonga\fP で、 \fB同義語リスト\fP が \fBgroonga\fP と \fBsynonyms\fP の例です。 \fB(TAB)\fP はタブ文字（ \fBU+0009\fP ）という意味です:
+.sp
+.nf
+.ft C
+groonga(TAB)groonga(TAB)Senna
+.ft P
+.fi
+.sp
+コメント行をサポートしています。 \fB#\fP から始まる行は無視します。以下はコメント行の例です。 \fBgroonga\fP とある行はコメント行として無視されます:
+.sp
+.nf
+.ft C
+#groonga(TAB)groonga(TAB)Senna
+mroonga(TAB)mroonga(TAB)groonga MySQL
+.ft P
+.fi
+.SS 制限
+.sp
+同義語を再読み込みするにはgroongaを再起動する必要があります。TSVファイルはプラグイン読み込み時に一度だけ読み込みます。
+.SS 参考
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.IP \(bu 2
+\fIquery\-expansion\fP
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.SS 疑似カラム (pseudo_column)
+.SS 名前
+.sp
+疑似カラム
+.SS 説明
+.sp
+groongaのデータベースで作成したテーブルには、いくつかのカラムが自動的に定義されます。
+.sp
+これらのカラムはいずれもアンダースコア(\(aq_\(aq)で始まる名前が付与されます。定義される疑似カラムは、テーブルの種類によって異なります。
+.sp
+\fB_id\fP
+.INDENT 0.0
+.INDENT 3.5
+レコードに付与される一意な番号です。全てのテーブルに定義されます。値の範囲は1〜1073741824の整数で、通常はレコードを追加した順に1ずつ加算されます。_idの値は不変で、レコードが存在する限り変更することはできません。ただし、削除されたレコードの_idの値は再利用されます。
+.UNINDENT
+.UNINDENT
+.sp
+\fB_key\fP
+.INDENT 0.0
+.INDENT 3.5
+レコードの主キー値を表します。主キーを持つテーブルのみに定義されます。主キー値はテーブルの中で一意であり、変更することはできません。
+.UNINDENT
+.UNINDENT
+.sp
+\fB_value\fP
+.INDENT 0.0
+.INDENT 3.5
+レコードの値を表します。value_typeを指定したテーブルのみに定義されます。自由に変更可能です。
+.UNINDENT
+.UNINDENT
+.sp
+\fB_score\fP
+.INDENT 0.0
+.INDENT 3.5
+各レコードのスコア値を表します。検索結果として生成されたテーブルのみに定義されます。
+.sp
+検索処理を実行する過程で値が設定されますが、自由に変更可能です。
+.UNINDENT
+.UNINDENT
+.sp
+\fB_nsubrecs\fP
+.INDENT 0.0
+.INDENT 3.5
 主キーの値が同一であったレコードの件数を表します。検索結果として生成されたテーブルのみに定義されます。グループ化(drilldown)処理を実行すると、グループ化前のテーブルにおいて、グループ化キーの値が同一であったレコードの件数が、グループ化処理の結果を格納するテーブルの_nsubrecsに記録されます。
 .UNINDENT
 .UNINDENT
@@ -13291,11 +13964,11 @@ grn_expr関連のAPIを呼ぶ。
 \fB/reference/grn_expr/script_syntax\fP はECMAScriptに似た構文です。 \fB/reference/grn_expr/script_syntax\fP ではすべての条件式と集合演算を使えます。 \fB/reference/grn_expr/script_syntax\fP は \fB/reference/commands/select\fP の \fBfilter\fP オプションで指定する検索条件や \fBscorer\fP オプションで指定する式で使えます。
 .sp
 groongaをライブラリとして使うと、grn_expr関連のAPIを呼び出してgrn_exprを作ることができます。 \fB/reference/grn_expr/script_syntax\fP のように、APIを呼び出すと全ての機能を使えます。grn_exprを作る構文を新しく作るときにはAPIが便利です。APIは \fI\%rroonga\fP というgroongaのRubyバインディングで使われています。rroongaでは文字列をパースするのではなく、Rubyの構文を使ってgrn_exprを作ることができます。
-.SS クエリ構文
+.SS クエリー構文
 .sp
-クエリ構文は一般的なWebの検索フォームで検索条件を指定するための構文です。Googleの検索フォームで使われている構文に似ています。例えば、 \fBword1 word2\fP は \fBword1\fP と \fBword2\fP の両方の単語を含んだレコードを検索するという意味です。 \fBword1 OR word2\fP は \fBword1\fP または \fBword2\fP のどちらかの単語を含んだレコードを検索します。
+クエリー構文は一般的なWebの検索フォームで検索条件を指定するための構文です。Googleの検索フォームで使われている構文に似ています。例えば、 \fBword1 word2\fP は \fBword1\fP と \fBword2\fP の両方の単語を含んだレコードを検索するという意味です。 \fBword1 OR word2\fP は \fBword1\fP または \fBword2\fP のどちらかの単語を含んだレコードを検索します。
 .sp
-クエリ構文は \fB条件式\fP と \fB結合式\fP と \fB代入式\fP から成ります。通常、 \fB代入式\fP は考えなくてよいです。なぜなら、 \fB代入式\fP は \fB/reference/commands/select\fP の \fB\-\-query\fP オプションでは無効になっているからです。groongaをライブラリとして使ったときは、クエリ構文のパーサーのオプションをカスタマイズすることで \fB代入式\fP を有効にすることができます。
+クエリー構文は \fB条件式\fP と \fB結合式\fP と \fB代入式\fP から成ります。通常、 \fB代入式\fP は考えなくてよいです。なぜなら、 \fB代入式\fP は \fB/reference/commands/select\fP の \fB\-\-query\fP オプションでは無効になっているからです。groongaをライブラリとして使ったときは、クエリー構文のパーサーのオプションをカスタマイズすることで \fB代入式\fP を有効にすることができます。
 .sp
 \fB条件式\fP は条件を指定します。 \fB結合式\fP は1つ以上の \fB条件式\fP 、 \fB結合式\fP 、 \fB代入式\fP から成ります。 \fB代入式\fP はカラムに値を代入します。
 .SS サンプルデータ
@@ -13347,7 +14020,7 @@ load \-\-table Entries
 これで例を示すためのスキーマとデータの準備ができました。
 .SS エスケープ
 .sp
-クエリ構文には特別な文字があります。特別な文字それ自体を使うためには文字の前に \fB\e\fP をつけてエスケープしなければいけません。例えば、 \fB"\fP は特別な文字です。これは \fB\e"\fP というようにエスケープします。
+クエリー構文には特別な文字があります。特別な文字それ自体を使うためには文字の前に \fB\e\fP をつけてエスケープしなければいけません。例えば、 \fB"\fP は特別な文字です。これは \fB\e"\fP というようにエスケープします。
 .sp
 以下が特別な文字のリストです:
 .INDENT 0.0
@@ -14478,11 +15151,11 @@ select Entries \-\-query \(aqn_likes:<5 (content:@senna OR content:@fast)\(aq
 .sp
 このセクションは高度なユーザー向けです。それは、代入式は \fB/reference/commands/select\fP の \fB\-\-query\fP オプションではデフォルトでは無効になっているからです。代入式を有効にするには \fB\-\-query_flags\fP オプションに \fBALLOW_COLUMN|ALLOW_UPDATE\fP を指定してください。
 .sp
-クエリ構文における代入式にはいくつか制限があります。代入にはクエリ構文の代りに \fB/reference/grn_expr/script_syntax\fP を使ってください。
+クエリー構文における代入式にはいくつか制限があります。代入にはクエリー構文の代りに \fB/reference/grn_expr/script_syntax\fP を使ってください。
 .sp
 代入式の構文は1つだけです。 \fBcolumn:=value\fP となります。
 .sp
-\fBvalue\fP は \fBcolumn\fP に代入されます。 \fBvalue\fP は常にクエリ構文では文字列として扱われます。 \fBvalue\fP は \fBcolumn\fP の型へと自動的にキャストされます。 キャストにはいくつか制限があります。例えば \fBtrue\fP や \fBfalse\fP といった真偽値のリテラルを \fBBool\fP 型のカラムに使用することができません。 \fBfalse\fP については空文字列を使う必要がありますが、クエリ構文は \fBcolumn:=\fP 構文をサポートしていません。
+\fBvalue\fP は \fBcolumn\fP に代入されます。 \fBvalue\fP は常にクエリー構文では文字列として扱われます。 \fBvalue\fP は \fBcolumn\fP の型へと自動的にキャストされます。 キャストにはいくつか制限があります。例えば \fBtrue\fP や \fBfalse\fP といった真偽値のリテラルを \fBBool\fP 型のカラムに使用することができません。 \fBfalse\fP については空文字列を使う必要がありますが、クエリー構文は \fBcolumn:=\fP 構文をサポートしていません。
 .sp
 キャストについては \fB/reference/cast\fP を参照してください。
 .SS スクリプト構文
@@ -16275,7 +16948,13 @@ select Words \-\-filter \(aq_key *T "Groonga is the successor project to Senna."
 .UNINDENT
 .UNINDENT
 .UNINDENT
-.SS 組み込み関数一覧
+.SS 関数
+.sp
+関数はいくつかのコマンドの中で使えます。 \fBcommands/select\fP コマンドの \fB\-\-filter\fP 、 \fB\-\-scorer\fP 、 \fBoutput_columns\fP オプションで使えます。
+.sp
+このセクションでは関数についての説明と組み込みの関数について説明します。
+.sp
+TODO: Add documentations about function.
 .SS edit_distance
 .SS 名前
 .sp
@@ -16539,10 +17218,7 @@ GeoPointと座標については \fB/reference/type\fP を参照してくださ
 .UNINDENT
 .UNINDENT
 .IP ノート
-\fBgeo_distance\fP には制限があります。子午線や日付変更線、赤道といった境界をまたぐ距離の計算を行うことができません。これはgroongaの実装上の一時的な制限ですが、将来的には修正される予定です。
-.RE
-.IP ノート
-\fBgeo_distance\fP には上記の制限がありますが、近似方法に \fBrectangle\fP を選択した場合には制限が緩和されます。二点が両方とも北半球に存在するか、二点が両方とも北半球に存在する場合に限って距離を正しく算出することができます。
+\fBgeo_distance\fP には制限があります。 \fBsphere\fP や \fBellipsoid\fP を近似方法として選択した場合、子午線や日付変更線、赤道といった境界をまたぐ距離の計算を行うことができません。この制限は \fBrectangle\fP を近似方法として選択した場合にはありません。これはgroongaの実装上の一時的な制限ですが、将来的には修正される予定です。
 .RE
 .SS \fBrectangle\fP
 .sp
@@ -16617,6 +17293,107 @@ select Geo \-\-output_columns distance \-\-scorer \(aqdistance = geo_distance("1
 # ]
 .ft P
 .fi
+.sp
+明示的に子午線や赤道、日付変更線をまたぐような位置を指定して距離を計算するサンプルは以下の通りです。
+.sp
+実行例:
+.sp
+.nf
+.ft C
+select Geo \-\-output_columns distance \-\-scorer \(aqdistance = geo_distance("175904000x8464000", "145508000x\-13291000", "rectangle")\(aq
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         1
+#       ],
+#       [
+#         [
+#           "distance",
+#           "Int32"
+#         ]
+#       ],
+#       [
+#         1051293
+#       ]
+#     ]
+#   ]
+# ]
+.ft P
+.fi
+.sp
+このサンプルは子午線をまたいだ場合の距離を示します。 \fBgeo_distance("175904000x8464000", "145508000x\-13291000", "rectangle")\fP はパリ(フランス)からマドリード(スペイン)間の距離を返します。
+.sp
+実行例:
+.sp
+.nf
+.ft C
+select Geo \-\-output_columns distance \-\-scorer \(aqdistance = geo_distance("146566000x\-266422000", "\-56880000x\-172310000", "rectangle")\(aq
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         1
+#       ],
+#       [
+#         [
+#           "distance",
+#           "Int32"
+#         ]
+#       ],
+#       [
+#         6880439
+#       ]
+#     ]
+#   ]
+# ]
+.ft P
+.fi
+.sp
+このサンプルは赤道をまたいだ場合の距離を示します。 \fBgeo_distance("146566000x\-266422000", "\-56880000x\-172310000", "rectangle")\fP はニューヨーク(アメリカ)からブラジリア(ブラジル)間の距離を返します。
+.sp
+実行例:
+.sp
+.nf
+.ft C
+select Geo \-\-output_columns distance \-\-scorer \(aqdistance = geo_distance("143660000x419009000", "135960000x\-440760000", "rectangle")\(aq
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         1
+#       ],
+#       [
+#         [
+#           "distance",
+#           "Int32"
+#         ]
+#       ],
+#       [
+#         10475205
+#       ]
+#     ]
+#   ]
+# ]
+.ft P
+.fi
+.sp
+このサンプルは日付変更線をまたいだ場合の距離を示します。 \fBgeo_distance("143660000x419009000", "135960000x\-440760000", "rectangle")\fP は北京(中国)からサンフランシスコ(アメリカ)間の距離を返します。
 .IP ノート
 \fBgeo_distance\fP は方形近似をデフォルトとして使用します。 \fBapproximate_type\fP を省略すると \fBgeo_distance\fP は \fBrectangle\fP が指定されたものとして振舞います。
 .RE
@@ -16703,7 +17480,7 @@ select Cities \-\-output_columns _score \-\-filter 1 \-\-scorer \(aq_score = geo
 # ]
 .ft P
 .fi
-.SS 返値
+.SS 戻り値
 .sp
 \fBgeo_distance\fP はFloat型の値を距離として返します。単位はメートルです。
 脚注
@@ -16912,43 +17689,204 @@ rand(10)
 3
 .ft P
 .fi
-.SS インデックス構築
-.sp
-groongaは1.3.1から動的なインデックス構築方法と静的なインデックス構築方法を両方サポートしています。
-.SS 動的なインデックス構築方法
+.SS snippet_html
+.IP ご用心
+この機能は実験的です。APIが変わる可能性があります。
+.RE
+.SS 概要
 .sp
-動的なインデックス構築方法では、登録された文書はインデックス構築中にすぐに検索できるようになります。しかし、静的なインデックス構築方法に比べてコストがかかります。
+\fBsnippet_html\fP は対象テキスト中から検索キーワード周辺のテキスト（ \fBKWIC\fP 。 \fBKeyWord In Context\fP ）を抽出します。抽出されたテキストのことをスニペットと呼びます。スニペットはHTML中に埋め込みやすいように処理されています。 \fB<\fP や \fB>\fP などの特殊文字は \fB&lt;\fP や \fB&gt;\fP にエスケープされています。キーワードは \fB<span class="keyword">\fP と \fB</span>\fP で囲まれています。たとえば、 \fBI am a groonga user. <3\fP という対象テキストのキーワード \fBgroonga\fP でのスニペットは \fBI am a <span class="keyword">groonga</span> user. &lt;3\fP となります。
+.SS 構文
 .sp
-動的なインデックス構築方法は鮮度が重要な検索システムに適しています。例えば、つぶやきやニュースやブログ記事などを検索するシステムは鮮度が重要になるでしょう。動的なインデックス構築方法はできたばかりの文書を検索できるようにし、インデックス構築中も検索できます。
-.SS 静的なインデックス構築方法
+\fBsnippet_html\fP の引数は1つだけです:
 .sp
-静的なインデックス構築方法では、動的なインデックス構築方法よりもインデックス構築にかかるコストが小さくなります。インデックス構築時間は短くなるでしょう。インデックスは小さくなるでしょう。インデックス構築に必要なリソースは少なくなるでしょう。しかし、登録中の文書は登録しようとしている全ての文書のインデックス構築が終わるまで検索できません。
+.nf
+.ft C
+snippet_html(column)
+.ft P
+.fi
 .sp
-静的なインデックス構築方法は消費リソースが少ないことが重要な検索システムに適しています。鮮度が重要でないシステムであれば静的なインデックス構築方法が適しているでしょう。例えば、リファレンスマニュアルを検索するシステムは鮮度を重視しません。これは、リファレンスマニュアルはリリース時にだけ更新されるだけだからです。
+\fBsnippet_html\fP は内部にはたくさんのオプションがありますが、今はまだ指定できません。じきに指定できるようになる予定です。
 .SS 使い方
 .sp
-groongaはデフォルトで動的なインデックス構築方法を使います。文書を登録するとすぐに検索できるようになります。
-.sp
-すでにデータが格納されているカラムにインデックスを追加した場合は静的なインデックス構築方法を使います。
-.sp
-スキーマを定義します。
+使い方を示すために使うスキーマ定義とサンプルデータは以下の通りです。
 .sp
 実行例:
 .sp
 .nf
 .ft C
-table_create Tweets TABLE_NO_KEY
+table_create Documents TABLE_NO_KEY
 # [[0, 1337566253.89858, 0.000355720520019531], true]
-column_create Tweets content COLUMN_SCALAR ShortText
+column_create Documents content COLUMN_SCALAR Text
 # [[0, 1337566253.89858, 0.000355720520019531], true]
-table_create Lexicon TABLE_HASH_KEY|KEY_NORMALIZE ShortText \-\-default_tokenizer TokenBigram
+table_create Terms TABLE_PAT_KEY|KEY_NORMALIZE ShortText \-\-default_tokenizer TokenBigram
 # [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Terms documents_content_index COLUMN_INDEX|WITH_POSITION Documents content
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+load \-\-table Documents
+[
+["content"],
+["Groonga is a fast and accurate full text search engine based on inverted index. One of the characteristics of groonga is that a newly registered document instantly appears in search results. Also, groonga allows updates without read locks. These characteristics result in superior performance on real\-time applications."],
+["Groonga is also a column\-oriented database management system (DBMS). Compared with well\-known row\-oriented systems, such as MySQL and PostgreSQL, column\-oriented systems are more suited for aggregate queries. Due to this advantage, groonga can cover weakness of row\-oriented systems."]
+]
+# [[0, 1337566253.89858, 0.000355720520019531], 2]
 .ft P
 .fi
 .sp
-データを登録します:
+\fBsnippet_html\fP は \fB/reference/commands/select\fP コマンドの \fB\-\-output_columns\fP 内でのみ指定できます。
 .sp
-実行例:
+groonga 2.0.9では \fBoutput_columns\fP 内での関数呼び出しはまだ実験的な機能なので、明示的に \fB\-\-command_version 2\fP オプションを指定する必要があります。この機能はじきに有効になる予定です。
+.sp
+また、 \fB\-\-query\fP と \fB\-\-filter\fP オプションも指定する必要があります。（どちらか一方でも構いません。）これは、 \fB\-\-query\fP と \fB\-\-filter\fP オプションからキーワードを抽出しているためです。
+.sp
+以下の例は \fB\-\-query "fast performance"\fP を使っています。この場合は、キーワードとして \fBfast\fP と \fBperformance\fP を使います。
+.sp
+実行例:
+.sp
+.nf
+.ft C
+select Documents \-\-output_columns "snippet_html(content)" \-\-command_version 2 \-\-match_columns content \-\-query "fast performance"
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         1
+#       ],
+#       [
+#         [
+#           "snippet_html",
+#           "null"
+#         ]
+#       ],
+#       [
+#         [
+#           "Groonga is a <span class=\e"keyword\e">fast</span> and accurate full text search engine based on inverted index. One of the characteristics of groonga is that a newly registered document instantly appears in search results. Also, gro",
+#           "onga allows updates without read locks. These characteristics result in superior <span class=\e"keyword\e">performance</span> on real\-time applications."
+#         ]
+#       ]
+#     ]
+#   ]
+# ]
+.ft P
+.fi
+.sp
+\fB\-\-query "fast performance"\fP は最初のレコードの内容にだけマッチします。 \fBsnippet_html(content)\fP は、テキスト中からキーワード \fBfast\fP と \fBperformance\fP の少なくともどちらか一方を含んでいるテキストの断片を抽出します。今回は2箇所抽出しています。そして、抽出したテキストの断片内にあるキーワードを \fB<span class="keyword">\fP と \fB</span>\fP で囲みます。
+.sp
+テキストの断片数は多くても3です。4つ以上のテキストの断片が抽出できるときは、最初の3つだけを使います。
+.sp
+テキストの断片の最大サイズは200バイトです。単位は文字数ではなくバイトです。挿入される \fB<span keyword="keyword">\fP と \fB</span>\fP のバイト数はこのサイズの中には含まれません。
+.sp
+テキストの断片の最大数とテキストの断片の最大サイズはカスタマイズできません。
+.sp
+カラムの代わりに文字列リテラルを指定することもできます。
+.sp
+実行例:
+.sp
+.nf
+.ft C
+select Documents \-\-output_columns \(aqsnippet_html("Groonga is very fast fulltext search engine.")\(aq \-\-command_version 2 \-\-match_columns content \-\-query "fast performance"
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         1
+#       ],
+#       [
+#         [
+#           "snippet_html",
+#           "null"
+#         ]
+#       ],
+#       [
+#         [
+#           "Groonga is very <span class=\e"keyword\e">fast</span> fulltext search engine."
+#         ]
+#       ]
+#     ]
+#   ]
+# ]
+.ft P
+.fi
+.SS 戻り値
+.sp
+\fBsnippet_html\fP は文字列の配列を返します。それぞれの要素がスニペットになります:
+.sp
+.nf
+.ft C
+[SNIPPET1, SNIPPET2, SNIPPET3]
+.ft P
+.fi
+.sp
+スニペットには1つ以上のキーワードが含まれています。 \fB<span keyword="keyword">\fP と \fB</span>\fP を除いたスニペットの最大サイズは200byteです。単位は文字数ではなくてバイトです。
+.sp
+配列のサイズは0以上3以下です。最大サイズの3は、じきにカスタマイズできるようになる予定です。
+.SS TODO
+.INDENT 0.0
+.IP \(bu 2
+テキストの断片の最大数をカスタマイズできるようにする。
+.IP \(bu 2
+テキストの断片最大サイズをカスタマイズできるようにする。
+.IP \(bu 2
+キーワードをカスタマイズできるようにする。
+.IP \(bu 2
+キーワードを囲むタグをカスタマイズできるようにする。
+.IP \(bu 2
+正規化の方法をカスタマイズできるようにする。
+.IP \(bu 2
+オブジェクトリテラル形式でのオプション指定をサポートする。
+.UNINDENT
+.SS 参考
+.INDENT 0.0
+.IP \(bu 2
+\fB/reference/commands/select\fP
+.UNINDENT
+.SS インデックス構築
+.sp
+groongaは2.0.0から動的なインデックス構築方法と静的なインデックス構築方法を両方サポートしています。
+.SS 動的なインデックス構築方法
+.sp
+動的なインデックス構築方法では、登録された文書はインデックス構築中にすぐに検索できるようになります。しかし、静的なインデックス構築方法に比べてコストがかかります。
+.sp
+動的なインデックス構築方法は鮮度が重要な検索システムに適しています。例えば、つぶやきやニュースやブログ記事などを検索するシステムは鮮度が重要になるでしょう。動的なインデックス構築方法はできたばかりの文書を検索できるようにし、インデックス構築中も検索できます。
+.SS 静的なインデックス構築方法
+.sp
+静的なインデックス構築方法では、動的なインデックス構築方法よりもインデックス構築にかかるコストが小さくなります。インデックス構築時間は短くなるでしょう。インデックスは小さくなるでしょう。インデックス構築に必要なリソースは少なくなるでしょう。しかし、登録中の文書は登録しようとしている全ての文書のインデックス構築が終わるまで検索できません。
+.sp
+静的なインデックス構築方法は消費リソースが少ないことが重要な検索システムに適しています。鮮度が重要でないシステムであれば静的なインデックス構築方法が適しているでしょう。例えば、リファレンスマニュアルを検索するシステムは鮮度を重視しません。これは、リファレンスマニュアルはリリース時にだけ更新されるだけだからです。
+.SS 使い方
+.sp
+groongaはデフォルトで動的なインデックス構築方法を使います。文書を登録するとすぐに検索できるようになります。
+.sp
+すでにデータが格納されているカラムにインデックスを追加した場合は静的なインデックス構築方法を使います。
+.sp
+スキーマを定義します。
+.sp
+実行例:
+.sp
+.nf
+.ft C
+table_create Tweets TABLE_NO_KEY
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Tweets content COLUMN_SCALAR ShortText
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+table_create Lexicon TABLE_HASH_KEY|KEY_NORMALIZE ShortText \-\-default_tokenizer TokenBigram
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+.ft P
+.fi
+.sp
+データを登録します:
+.sp
+実行例:
 .sp
 .nf
 .ft C
@@ -17113,7 +18051,7 @@ customized by \fI\-\-log\-path\fP option.  Each log has its
 log level. If a log is smaller than groonga process\(aq log
 level, it\(aqs not logged. Log level can be customized by
 \fI\-l\fP or \fBcommands/log_level\fP.
-.SS Format
+.SS フォーマット
 .sp
 Process log uses the following format:
 .sp
@@ -17229,7 +18167,7 @@ log opened.
 .sp
 Query log is disabled by default. It can be enabled by
 \fI\-\-query\-log\-path\fP option.
-.SS Format
+.SS フォーマット
 .sp
 Query log uses the following formats:
 .sp
@@ -17386,6 +18324,407 @@ rc=0
 .sp
 TODO...
 .SH 仕様
+.SS GQTP
+.sp
+GQTPはGroonga Query Transfer Protocolの頭文字です。GQTPはgroonga用の独自プロトコルです。
+.SS プロトコル
+.sp
+GQTPはステートフルなクライアント・サーバーモデルのプロトコルです。以下の流れが1つの処理単位です:
+.INDENT 0.0
+.IP \(bu 2
+クライアントがリクエストを送る
+.IP \(bu 2
+サーバーがリクエストを受け取る
+.IP \(bu 2
+サーバーがリクエストを処理する
+.IP \(bu 2
+サーバーがレスポンスを返す
+.IP \(bu 2
+クライアントがレスポンスを受け取る
+.UNINDENT
+.sp
+1つのセッション内で0個以上の処理単位を実行できます。
+.sp
+リクエストもレスポンスもGQTPヘッダーとボディから成ります。GQTPヘッダーは固定長のデータです。ボディは可変長サイズのデータです。ボディのサイズはGQTPヘッダーの中に入っています。GQTPではボディの中身については何も定義しません。
+.SS GQTPヘッダー
+.sp
+GQTPヘッダーは以下の符号なし整数値から成ります:
+.TS
+center;
+|l|l|l|.
+_
+T{
+名前
+T}	T{
+サイズ
+T}	T{
+説明
+T}
+_
+T{
+\fBprotocol\fP
+T}	T{
+1byte
+T}	T{
+プロトコルの種類。
+T}
+_
+T{
+\fBquery_type\fP
+T}	T{
+1byte
+T}	T{
+ボディのコンテントタイプ。
+T}
+_
+T{
+\fBkey_length\fP
+T}	T{
+2byte
+T}	T{
+未使用。
+T}
+_
+T{
+\fBlevel\fP
+T}	T{
+1byte
+T}	T{
+未使用。
+T}
+_
+T{
+\fBflags\fP
+T}	T{
+1byte
+T}	T{
+フラグ。
+T}
+_
+T{
+\fBstatus\fP
+T}	T{
+2byte
+T}	T{
+リターンコード。
+T}
+_
+T{
+\fBsize\fP
+T}	T{
+4byte
+T}	T{
+ボディのサイズ。
+T}
+_
+T{
+\fBopaque\fP
+T}	T{
+4byte
+T}	T{
+未使用。
+T}
+_
+T{
+\fBcas\fP
+T}	T{
+8byte
+T}	T{
+未使用。
+T}
+_
+.TE
+.sp
+ヘッダーのすべての値はネットワークバイトオーダーを使っています。
+.sp
+以下のセクションではそれぞれのヘッダーの値で利用可能な値について説明します。
+.sp
+GQTPヘッダーは全部で24byteになります。
+.SS \fBprotocol\fP
+.sp
+リクエストのGQTPヘッダーでもレスポンスのGQTPヘッダーでも、この値は常に \fB0xc7\fP になります。
+.SS \fBquery_type\fP
+.sp
+この値は以下のいずれかの値です:
+.TS
+center;
+|l|l|l|.
+_
+T{
+名前
+T}	T{
+値
+T}	T{
+説明
+T}
+_
+T{
+\fBNONE\fP
+T}	T{
+0
+T}	T{
+自由形式。
+T}
+_
+T{
+\fBTSV\fP
+T}	T{
+1
+T}	T{
+値をタブで区切った形式。
+T}
+_
+T{
+\fBJSON\fP
+T}	T{
+2
+T}	T{
+JSON。
+T}
+_
+T{
+\fBXML\fP
+T}	T{
+3
+T}	T{
+XML。
+T}
+_
+T{
+\fBMSGPACK\fP
+T}	T{
+4
+T}	T{
+MessagePack。
+T}
+_
+.TE
+.sp
+リクエストGQTPヘッダーでは使われません。
+.sp
+レスポンスGQTPヘッダーで使われます。ボディは指定した形式にします。
+.SS \fBflags\fP
+.sp
+この値は以下の値をビット単位ORしたものになります:
+.TS
+center;
+|l|l|l|.
+_
+T{
+名前
+T}	T{
+値
+T}	T{
+説明
+T}
+_
+T{
+\fBMORE\fP
+T}	T{
+0x01
+T}	T{
+まだデータがあります。
+T}
+_
+T{
+\fBTAIL\fP
+T}	T{
+0x02
+T}	T{
+これ以上データはありません。
+T}
+_
+T{
+\fBHEAD\fP
+T}	T{
+0x04
+T}	T{
+未使用。
+T}
+_
+T{
+\fBQUIET\fP
+T}	T{
+0x08
+T}	T{
+レスポンスを出力しません。
+T}
+_
+T{
+\fBQUIT\fP
+T}	T{
+0x10
+T}	T{
+終了します。
+T}
+_
+.TE
+.sp
+\fBMORE\fP あるいは \fBTAIL\fP フラグは必ず指定しないといけません。
+.sp
+\fBMORE\fP フラグを使うときは \fBQUIET\fP フラグも使うべきです。リクエストが途中のときはレスポンスを出力する必要がないからです。
+.sp
+セッションを終了するときは \fBQUIT\fP フラグを使ってください。
+.SS \fBstatus\fP
+.sp
+利用可能な値です。将来的に新しいステータスが追加される可能性があります。
+.INDENT 0.0
+.IP \(bu 2
+0: \fBSUCCESS\fP
+.IP \(bu 2
+1: \fBEND_OF_DATA\fP
+.IP \(bu 2
+65535: \fBUNKNOWN_ERROR\fP
+.IP \(bu 2
+65534: \fBOPERATION_NOT_PERMITTED\fP
+.IP \(bu 2
+65533: \fBNO_SUCH_FILE_OR_DIRECTORY\fP
+.IP \(bu 2
+65532: \fBNO_SUCH_PROCESS\fP
+.IP \(bu 2
+65531: \fBINTERRUPTED_FUNCTION_CALL\fP
+.IP \(bu 2
+65530: \fBINPUT_OUTPUT_ERROR\fP
+.IP \(bu 2
+65529: \fBNO_SUCH_DEVICE_OR_ADDRESS\fP
+.IP \(bu 2
+65528: \fBARG_LIST_TOO_LONG\fP
+.IP \(bu 2
+65527: \fBEXEC_FORMAT_ERROR\fP
+.IP \(bu 2
+65526: \fBBAD_FILE_DESCRIPTOR\fP
+.IP \(bu 2
+65525: \fBNO_CHILD_PROCESSES\fP
+.IP \(bu 2
+65524: \fBRESOURCE_TEMPORARILY_UNAVAILABLE\fP
+.IP \(bu 2
+65523: \fBNOT_ENOUGH_SPACE\fP
+.IP \(bu 2
+65522: \fBPERMISSION_DENIED\fP
+.IP \(bu 2
+65521: \fBBAD_ADDRESS\fP
+.IP \(bu 2
+65520: \fBRESOURCE_BUSY\fP
+.IP \(bu 2
+65519: \fBFILE_EXISTS\fP
+.IP \(bu 2
+65518: \fBIMPROPER_LINK\fP
+.IP \(bu 2
+65517: \fBNO_SUCH_DEVICE\fP
+.IP \(bu 2
+65516: \fBNOT_A_DIRECTORY\fP
+.IP \(bu 2
+65515: \fBIS_A_DIRECTORY\fP
+.IP \(bu 2
+65514: \fBINVALID_ARGUMENT\fP
+.IP \(bu 2
+65513: \fBTOO_MANY_OPEN_FILES_IN_SYSTEM\fP
+.IP \(bu 2
+65512: \fBTOO_MANY_OPEN_FILES\fP
+.IP \(bu 2
+65511: \fBINAPPROPRIATE_I_O_CONTROL_OPERATION\fP
+.IP \(bu 2
+65510: \fBFILE_TOO_LARGE\fP
+.IP \(bu 2
+65509: \fBNO_SPACE_LEFT_ON_DEVICE\fP
+.IP \(bu 2
+65508: \fBINVALID_SEEK\fP
+.IP \(bu 2
+65507: \fBREAD_ONLY_FILE_SYSTEM\fP
+.IP \(bu 2
+65506: \fBTOO_MANY_LINKS\fP
+.IP \(bu 2
+65505: \fBBROKEN_PIPE\fP
+.IP \(bu 2
+65504: \fBDOMAIN_ERROR\fP
+.IP \(bu 2
+65503: \fBRESULT_TOO_LARGE\fP
+.IP \(bu 2
+65502: \fBRESOURCE_DEADLOCK_AVOIDED\fP
+.IP \(bu 2
+65501: \fBNO_MEMORY_AVAILABLE\fP
+.IP \(bu 2
+65500: \fBFILENAME_TOO_LONG\fP
+.IP \(bu 2
+65499: \fBNO_LOCKS_AVAILABLE\fP
+.IP \(bu 2
+65498: \fBFUNCTION_NOT_IMPLEMENTED\fP
+.IP \(bu 2
+65497: \fBDIRECTORY_NOT_EMPTY\fP
+.IP \(bu 2
+65496: \fBILLEGAL_BYTE_SEQUENCE\fP
+.IP \(bu 2
+65495: \fBSOCKET_NOT_INITIALIZED\fP
+.IP \(bu 2
+65494: \fBOPERATION_WOULD_BLOCK\fP
+.IP \(bu 2
+65493: \fBADDRESS_IS_NOT_AVAILABLE\fP
+.IP \(bu 2
+65492: \fBNETWORK_IS_DOWN\fP
+.IP \(bu 2
+65491: \fBNO_BUFFER\fP
+.IP \(bu 2
+65490: \fBSOCKET_IS_ALREADY_CONNECTED\fP
+.IP \(bu 2
+65489: \fBSOCKET_IS_NOT_CONNECTED\fP
+.IP \(bu 2
+65488: \fBSOCKET_IS_ALREADY_SHUTDOWNED\fP
+.IP \(bu 2
+65487: \fBOPERATION_TIMEOUT\fP
+.IP \(bu 2
+65486: \fBCONNECTION_REFUSED\fP
+.IP \(bu 2
+65485: \fBRANGE_ERROR\fP
+.IP \(bu 2
+65484: \fBTOKENIZER_ERROR\fP
+.IP \(bu 2
+65483: \fBFILE_CORRUPT\fP
+.IP \(bu 2
+65482: \fBINVALID_FORMAT\fP
+.IP \(bu 2
+65481: \fBOBJECT_CORRUPT\fP
+.IP \(bu 2
+65480: \fBTOO_MANY_SYMBOLIC_LINKS\fP
+.IP \(bu 2
+65479: \fBNOT_SOCKET\fP
+.IP \(bu 2
+65478: \fBOPERATION_NOT_SUPPORTED\fP
+.IP \(bu 2
+65477: \fBADDRESS_IS_IN_USE\fP
+.IP \(bu 2
+65476: \fBZLIB_ERROR\fP
+.IP \(bu 2
+65475: \fBLZO_ERROR\fP
+.IP \(bu 2
+65474: \fBSTACK_OVER_FLOW\fP
+.IP \(bu 2
+65473: \fBSYNTAX_ERROR\fP
+.IP \(bu 2
+65472: \fBRETRY_MAX\fP
+.IP \(bu 2
+65471: \fBINCOMPATIBLE_FILE_FORMAT\fP
+.IP \(bu 2
+65470: \fBUPDATE_NOT_ALLOWED\fP
+.IP \(bu 2
+65469: \fBTOO_SMALL_OFFSET\fP
+.IP \(bu 2
+65468: \fBTOO_LARGE_OFFSET\fP
+.IP \(bu 2
+65467: \fBTOO_SMALL_LIMIT\fP
+.IP \(bu 2
+65466: \fBCAS_ERROR\fP
+.IP \(bu 2
+65465: \fBUNSUPPORTED_COMMAND_VERSION\fP
+.UNINDENT
+.SS \fBsize\fP
+.sp
+ボディのサイズです。ボディの最大サイズは4GiBです。これは \fBsize\fP が4byteの符号なし整数だからです。4GiB以上のサイズのデータを送りたい場合は \fBMORE\fP フラグを使ってください。
+.SS 例
+.sp
+TODO
+.SS 参照
+.sp
+TODO
 .SS 検索
 .sp
 \fB/reference/commands/select\fP コマンドがqueryパラメータを使ってどのように検索するのかを説明します。
@@ -17524,6 +18863,17 @@ select Shops \-\-filter \(aq"point > 3 && description @ \e"スープカレー\e"
 .SH 制限事項
 .sp
 groongaにはいくつか制限事項があります。
+.SS テーブルの制限
+.sp
+テーブルには以下の制限があります。
+.INDENT 0.0
+.IP \(bu 2
+1つのキーの最大サイズ: 4096Bytes
+.IP \(bu 2
+キーのサイズを合計した上限値: 4GByte
+.UNINDENT
+.sp
+実際には他の諸条件の制約により上記の値まで到達しない場合もあります。
 .SS インデックス上限値
 .sp
 1つのインデックスにおける論理上の上限値は以下のとおりです。
@@ -17789,13 +19139,13 @@ Travis CI上でgroongaを使っているオープンソースソフトウェア
 groongaプロジェクトではみなさんからのコントリビュートを歓迎します！コントリビュートの方法はいくつもあります。groongaを使ったり誰かに紹介することもコントリビュートですし、バグレポートを送ったり、groonga本体やgroonga関連の開発に参加することもコントリビュートです。プログラムではなく、ドキュメントでのコントリビュートも歓迎します！
 .INDENT 0.0
 .TP
-.B Use:
+.B As a user:
 このドキュメントを読んでください。
 .TP
-.B Introduction:
+.B As a spokesman:
 groongaについてまわりの人に話してください。
 .TP
-.B Bug report, development and documentation:
+.B As a developer: Bug report, development and documentation
 これらについてはこのセクションで説明します。
 .UNINDENT
 .SS バグレポートの送り方
@@ -18370,6 +19720,11 @@ make update\-poコマンドの実行により更新した各種.poファイル
 .fi
 .sp
 これにより$GROONGA_CLONE_DIR/groonga\-(バージョン).tar.gzが作成されます。
+.IP ノート
+タグを打つ前にmake distを行うとversionが古いままになることがあります。
+するとgroonga \-\-versionで表示されるバージョン表記が更新されないので注意が必要です。
+make distで生成したtar.gzのversionおよびversion.shがタグと一致することを確認するのが望ましいです。
+.RE
 .SS パッケージのビルド
 .sp
 リリース用のアーカイブファイルができたので、パッケージ化する作業を行います。
@@ -18460,6 +19815,8 @@ natty i386/amd64
 oneiric i386/amd64
 .IP \(bu 2
 precise i386/amd64
+.IP \(bu 2
+quantal i386/amd64
 .UNINDENT
 .sp
 正常にビルドが終了すると$GROONGA_CLONE_DIR/packages/apt/repositories配下に.debパッケージが生成されます。
@@ -18842,6 +20199,17 @@ freecode.comのプロジェクトページは以下の通りです。
 \fI\%https://freecode.com/projects/groonga/releases/new\fP
 .UNINDENT
 .UNINDENT
+.IP ノート
+投稿した内容に対するレビューが運営側で実施されるので、反映されるまでしばらく時間がかかります。
+.RE
+.SS Twitterでリリースアナウンスをする
+.sp
+blogroongaのリリースエントリには「リンクをあなたのフォロワーに共有する」ためのツイートボタンがあるので、そのボタンを使ってリリースアナウンスします。(画面下部に配置されている)
+.sp
+このボタンを経由する場合、ツイート内容に自動的にリリースタイトル(「groonga 2.0.8リリース」など)とblogroongaのリリースエントリのURLが挿入されます。
+.sp
+この作業はblogroongaの英語版、日本語版それぞれで行います。
+あらかじめgroongaアカウントでログインしておくとアナウンスを円滑に行うことができます。
 .sp
 以上でリリース作業は終了です。
 .SS リリース後にやること
@@ -18867,6 +20235,9 @@ $GROONGA_CLONE_DIRにて以下のコマンドを実行します。:
 .fi
 .sp
 これにより$GROONGA_CLONE_DIR/base_versionが更新されるのでコミットしておきます。
+.IP ノート
+base_versionはtar.gzなどのリリース用のファイル名で使用します。
+.RE
 .SS ビルド時のTIPS
 .SS ビルドを並列化したい
 .sp