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

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

@@ -1,4 +1,4 @@
-.TH "GROONGA" "1" "September 28, 2012" "2.0.7" "groonga"
+.TH "GROONGA" "1" "November 28, 2012" "2.0.9" "groonga"
 .SH NAME
 groonga \- groonga documentation
 .
@@ -104,19 +104,19 @@ memory error with a 32\-bit package even if you just process medium
 size data.
 .SS Installer
 .sp
-For 32\-bit environment, download \fI\%groonga-2.0.7-x86.exe\fP
+For 32\-bit environment, download \fI\%groonga-2.0.9-x86.exe\fP
 and run it.
 .sp
-For 64\-bit environment, download \fI\%groonga-2.0.7-x64.exe\fP
+For 64\-bit environment, download \fI\%groonga-2.0.9-x64.exe\fP
 and run it.
 .sp
 Use command prompt for \fB/reference/executables/groonga\fP installed in start menu.
 .SS zip
 .sp
-For 32\-bit environment, download \fI\%groonga-2.0.7-x86.zip\fP
+For 32\-bit environment, download \fI\%groonga-2.0.9-x86.zip\fP
 and extract it.
 .sp
-For 64\-bit environment, download \fI\%groonga-2.0.7-x64.zip\fP
+For 64\-bit environment, download \fI\%groonga-2.0.9-x64.zip\fP
 and extract it.
 .sp
 \fB/reference/executables/groonga\fP is in \fBbin\fP folder.
@@ -135,7 +135,7 @@ Windows. Here are required tools:
 .UNINDENT
 .UNINDENT
 .sp
-Download zipped source \fI\%groonga-2.0.7.zip\fP
+Download zipped source \fI\%groonga-2.0.9.zip\fP
 and extract it.
 .sp
 Start \fBVisual Studio Command Prompt (2010)\fP installed by Microsoft
@@ -143,7 +143,7 @@ Visual Studio 2010 Express and move to the groonga\(aqs source folder:
 .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
@@ -153,23 +153,41 @@ parameter instead:
 .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
-Build by Visual Studio:
+Build by 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
-Install:
+Install by Visual C++ 2010 Express:
+.sp
+.nf
+.ft C
+groonga\-2.0.9> msbuild groonga.sln /p:Configuration=Release /t:Install
+.ft P
+.fi
+.sp
+If you installed Visual Studio 2010, use can use devenv instead.
+.sp
+Build by 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
+Install by Visual Studio 2010:
+.sp
+.nf
+.ft C
+groonga\-2.0.9> devenv groonga.sln /Build Release /Project Install
 .ft P
 .fi
 .sp
@@ -211,9 +229,9 @@ Download source:
 .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
@@ -399,9 +417,9 @@ Download source:
 .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
@@ -658,6 +676,61 @@ Install groonga\-munin\-plugins package:
 % sudo apt\-get \-y install groonga\-munin\-plugins
 .ft P
 .fi
+.SS 12.10 Quantal Quetzal
+.IP Note
+Enable the universe repository to install groonga:
+.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
+Add the groonga apt repository.
+.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
+Install:
+.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
+If you want to use \fI\%MeCab\fP as a
+tokenizer, install groonga\-tokenizer\-mecab package.
+.sp
+Install groonga\-tokenizer\-mecab package:
+.sp
+.nf
+.ft C
+% sudo apt\-get \-y install groonga\-tokenizer\-mecab
+.ft P
+.fi
+.sp
+There is a package that provides \fI\%Munin\fP plugins. If you want to monitor
+groonga status by Munin, install groonga\-munin\-plugins package.
+.sp
+Install groonga\-munin\-plugins package:
+.sp
+.nf
+.ft C
+% sudo apt\-get \-y install groonga\-munin\-plugins
+.ft P
+.fi
 .SS Build from source
 .sp
 Install required packages to build groonga:
@@ -672,9 +745,9 @@ Download source:
 .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
@@ -734,6 +807,24 @@ Install groonga\-tokenizer\-mecab package:
 .ft P
 .fi
 .sp
+Then install MeCab dictionary. (mecab\-ipadic or mecab\-jumandic)
+.sp
+Install IPA dictionary:
+.sp
+.nf
+.ft C
+% sudo yum install \-y mecab\-ipadic
+.ft P
+.fi
+.sp
+Or install Juman dictionary:
+.sp
+.nf
+.ft C
+% sudo yum install \-y mecab\-jumandic
+.ft P
+.fi
+.sp
 There is a package that provides \fI\%Munin\fP plugins. If you want to monitor
 groonga status by Munin, install groonga\-munin\-plugins package.
 .IP Note
@@ -801,6 +892,24 @@ Install groonga\-tokenizer\-mecab package:
 .ft P
 .fi
 .sp
+Then install MeCab dictionary. (mecab\-ipadic or mecab\-jumandic)
+.sp
+Install IPA dictionary:
+.sp
+.nf
+.ft C
+% sudo yum install \-y mecab\-ipadic
+.ft P
+.fi
+.sp
+Or install Juman dictionary:
+.sp
+.nf
+.ft C
+% sudo yum install \-y mecab\-jumandic
+.ft P
+.fi
+.sp
 There is a package that provides \fI\%Munin\fP plugins. If you want to monitor
 groonga status by Munin, install groonga\-munin\-plugins package.
 .IP Note
@@ -839,9 +948,9 @@ Download source:
 .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
@@ -909,6 +1018,24 @@ Install groonga\-tokenizer\-mecab package:
 .ft P
 .fi
 .sp
+Then install MeCab dictionary. (mecab\-ipadic or mecab\-jumandic)
+.sp
+Install IPA dictionary:
+.sp
+.nf
+.ft C
+% sudo yum install \-y mecab\-ipadic
+.ft P
+.fi
+.sp
+Or install Juman dictionary:
+.sp
+.nf
+.ft C
+% sudo yum install \-y mecab\-jumandic
+.ft P
+.fi
+.sp
 There is a package that provides \fI\%Munin\fP plugins. If you want to monitor
 groonga status by Munin, install groonga\-munin\-plugins package.
 .sp
@@ -933,9 +1060,9 @@ Download source:
 .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
@@ -980,9 +1107,9 @@ Download source:
 .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
@@ -1106,9 +1233,9 @@ steps:
 .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
@@ -7301,7 +7428,7 @@ POST
 T}	T{
 x
 T}	T{
-x (comming soon)
+o
 T}
 _
 T{
@@ -7581,7 +7708,25 @@ formats in the future. The second, all requests for the \fIlocation\fP are
 processed by groonga. You don\(aqt need to consider about other modules.
 .SS POST
 .sp
-TODO
+You can load your data by POST JSON data. You need follow the
+following rules to use loading by POST.
+.INDENT 0.0
+.IP \(bu 2
+\fIContent\-Type\fP header value must be \fIapplication/json\fP.
+.IP \(bu 2
+JSON data is sent as body.
+.IP \(bu 2
+Table name is specified by query parameter such as \fBtable=NAME\fP.
+.UNINDENT
+.sp
+Here is an example curl command line that loads two users \fIalice\fP and
+\fIbob\fP to \fIUsers\fP table:
+.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
@@ -8765,6 +8910,12 @@ in MessagePack format:
 (... omitted because MessagePack is binary data format. ...)
 .ft P
 .fi
+.SS Command
+.sp
+Command is the most important processing unit in query API. You
+request a processing to groonga by a command.
+.sp
+This section describes about command and built\-in commands.
 .SS コマンドバージョン
 .SS 概要
 .sp
@@ -8839,164 +8990,505 @@ select \-\-command_version 1 \-\-table tablename
 .fi
 .sp
 指定されたコマンドバージョンでコマンドを実行します。指定されたコマンドバージョンがサポート対象外であった場合にはエラーが返されます。command\-versionが指定されなかった場合は、当該プロセス起動時にdefault\-command\-versionに指定した値が指定されたものとみなします。
-.SS コマンド
-.sp
-まず、すべてのコマンドに関係するコマンドバージョンについて説明します。その後、組み込みのコマンドを順に説明します。
-.SS コマンドバージョン
-.SS 概要
-.sp
-groonga1.1からコマンドバージョンという概念が導入されます。コマンドバージョンは、selectやloadなどのgroongaのコマンドの仕様の互換性を表します。groongaパッケージのバージョンが新しくなったとしても、同一のコマンドバージョンが使用可能であるなら、すべてのコマンドについて互換性が保証されます。コマンドバージョンが異なれば、同じ名前のコマンドであっても、動作に互換性がない可能性があります。
+.SS Output format
+.SS Summary
 .sp
-あるバージョンのgroongaは、二つのコマンドバージョンを同時にサポートするようになります。
-使用するコマンドバージョンは、groongaを起動する際のコマンドラインオプションないしコンフィグファイルにdefault\-commnad\-versionパラメータを与えることによって指定できます。また、個々のコマンドを実行する際に、command_versionパラメータを与えることによっても指定することができます。
+Commands output their result as JSON, MessagePack, XML or TSV format.
 .sp
-コマンドバージョンは1からはじまり、更新されるたびに1ずつ大きくなります。現状のgroongaのコマンドの仕様はcommand\-version 1という扱いになります。次回提供するgroongaは、command\-version 1とcommand\-version 2の二つをサポートすることになります。
-.SS バージョンの位置づけ
+JSON and MessagePack output have the same structure. XML and TSV are
+their original structure.
 .sp
-あるバージョンのgroongaにおいてサポートされるコマンドバージョンは、develop, stable,deprecatedのいずれかの位置づけとなります。
-.INDENT 0.0
-.TP
-.B develop
-まだ開発中であり、仕様が変更される可能性があります。
-.TP
-.B stable
-使用可能であり仕様も安定しています。その時点で使用することが推奨されます。
-.TP
-.B deprecated
-使用可能であり仕様も安定していますが、廃止予定であり使用が推奨されません。
-.UNINDENT
+JSON or MessagePack is recommend format. XML is useful for visual
+result check. TSV is just for special use. Normally you doesn\(aqt need
+to use TSV.
+.SS JSON and MessagePack
 .sp
-あるバージョンのgroongaがサポートする二つのコマンドバージョンのうち、いずれか一つが必ずstableの位置づけとなります。残りの一つは、developないしdeprecatedとなります。
+This secsion describes the structure of command result on JSON and
+MessagePack format. JSON is used to show structure because MessagePack
+is binary format. Binary format isn\(aqt proper for documenataion.
 .sp
-たとえば下記のようにgroongaのサポートするコマンドバージョンは推移します。:
+JSON and MessagePack uses the following structure:
 .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であるコマンドバージョンが指定されたものとみなします。
+For example:
 .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パラメータ
+In the example, the following part is \fBHEADER\fP:
 .sp
-groonga実行モジュールの引数としてdefault\-command\-versionパラメータを指定できます。
-(configファイルの中に指定することも可能です)
+.nf
+.ft C
+[
+  0,
+  1337566253.89858,
+  0.000355720520019531
+]
+.ft P
+.fi
 .sp
-実行例:
+The following part is \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 is an array. The content of \fBHEADER\fP has some patterns.
+.SS Success case
 .sp
-実行例:
+\fBHEADER\fP has three elements on success:
 .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 名前
+The first element is always \fB0\fP.
 .sp
-cache_limit \- cacheサイズの設定・取得
-.SS 書式
+\fBUNIX_TIME_WHEN_COMMAND_IS_STARTED\fP is the number of seconds
+since 1970\-01\-01 00:00:00 UTC when the command is started
+processing. \fBELAPSED_TIME\fP is the elapsed time for processing the
+command in seconds. Both \fBUNIX_TIME_WHEN_COMMAND_IS_STARTED\fP and
+\fBELAPSED_TIME\fP are float value. The precision of them are
+nanosecond.
+.SS Error case
+.sp
+\fBHEADER\fP has four or five elements on error:
 .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 may not be included in \fBHEADER\fP but other four
+elements are always included.
 .sp
-cache_limitは、クエリキャッシュの最大件数を取得したり設定したりします。
-.SS 引数
+\fBRETURN_CODE\fP is non 0 value. See \fBreturn_code\fP about available
+return codes.
 .sp
-\fBmax\fP
-.INDENT 0.0
-.INDENT 3.5
-クエリキャッシュの最大件数を整数で指定します。
-maxが指定されなかった場合には、クエリキャッシュの最大件数は変更せず、
-現在の設定値のみが返されます。
-.UNINDENT
-.UNINDENT
-.SS 返値
-.SS json
+\fBUNIX_TIME_WHEN_COMMAND_IS_STARTED\fP and \fBELAPSED_TIME\fP are the
+same as success case.
+.sp
+\fBERROR_MESSAGE\fP is an error message in string.
+.sp
+\fBERROR_LOCATION\fP is optional. If error location is collected,
+\fBERROR_LOCATION\fP is included. \fBERROR_LOCATION\fP is an
+array. \fBERROR_LOCATION\fP has one ore two elements:
 .sp
 .nf
 .ft C
-[以前の設定値]
-
-\(ga\(ga以前の設定値\(ga\(ga
-
-  すでに設定されていたクエリキャッシュの最大件数を返す。
+[
+  LOCATION_IN_GROONGA,
+  LOCATION_IN_INPUT
+]
 .ft P
 .fi
-.SS 例
+.sp
+\fBLOCATION_IN_GROONGA\fP is the source location that error is occurred
+in groonga. It is useful for groonga developers but not useful for
+users. \fBLOCATION_IN_GROONGA\fP is an array. \fBLOCATION_IN_GROONGA\fP has
+three elements:
 .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 is the name of function that error is occurred.
+.sp
+\fBSOURCE_FILE_NAME\fP is the name of groonga\(aqs source file that error is
+occurred.
+.sp
+\fBLINE_NUMBER\fP is the line number of \fBSOURCE_FILE_NAME\fP that error
+is occurred.
+.sp
+\fBLOCATION_IN_INPUT\fP is optional. \fBLOCATION_IN_INPUT\fP is included
+when the location that error is occurred in input file is
+collected. Input file can be specified by \fB\-\-file\fP command line
+option for \fBgroonga\fP command. \fBLOCATION_IN_GROONGA\fP is an
+array. \fBLOCATION_IN_GROONGA\fP has three elements:
 .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 is the input file name that error is occurred.
 .sp
-checkコマンドは、groongaプロセス内の指定したオブジェクトの状態を表示します。主にデータベースが壊れた場合など異常時の問題解決のために使用することを想定しています。デバッグ用のため、返値のフォーマットが安定しているということは保証されません。（フォーマットが変更される可能性が高い）
-.SS 引数
+\fBLINE_NUMBER\fP is the line number of \fBINPUT_FILE_NAME\fP that error
+is occurred.
 .sp
-\fBobj\fP
-.INDENT 0.0
-.INDENT 3.5
-状態を表示するオブジェクトの名前を指定します。
-.UNINDENT
-.UNINDENT
-.SS 返値
-.SS json形式
+\fBLINE_CONTENT\fP is the content at \fBLINE_NUMBER\fP in
+\fBINPUT_FILE_NAME\fP.
+.SS \fBBODY\fP
 .sp
-チェックするオブジェクトにより返される値が変わります。
+\fBBODY\fP content depends on the executed command. It may be omitted.
 .sp
-インデックスカラムの場合:
+\fBBODY\fP may be an error message on error case.
+.SS XML
 .sp
-.nf
-.ft C
-下記のような配列が出力されます。
-
+TODO
+.SS TSV
+.sp
+TODO
+.SS See also
+.INDENT 0.0
+.IP \(bu 2
+\fBreturn_code\fP describes about return code.
+.UNINDENT
+.SS Return code
+.SS Summary
+.sp
+Return code is used to show whether a processing is succeeded or
+not. If the processing is not succeeded, return code shows error type.
+.sp
+Return code is used in C API and query API. You can check return code
+via \fBgrn_ctx_t::rc\fP in C API. You can check return code by looking
+the header element in query API. See \fBoutput_format\fP about the
+header element in query API.
+.SS List
+.sp
+Here is a list of return codes. \fBGRN_SUCCESS\fP (= 0) means that the
+processing is succeeded. Return codes that have negative value show
+error type. \fBGRN_END_OF_DATA\fP is a special return code. It is used
+only C API. It is not showen in query 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 See also
+.INDENT 0.0
+.IP \(bu 2
+\fBoutput_format\fP shows where return code is appeared in query
+API response.
+.IP \(bu 2
+\fB/spec/gqtp\fP: GQTP protocol also uses return code as status but
+it uses 2byte unsigned integer. So return codes that have negative
+value are statuses that have positive value in GQTP protocol. You
+can convert status value in GQTP protocol to return code by
+handling it as 2byte signed integer.
+.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
+.nf
+.ft C
+下記のような配列が出力されます。
+
   [インデックスの状態, バッファの状態1, バッファの状態2, ...]
 
 \(ga\(gaインデックスの状態\(ga\(gaには下記の項目がハッシュ形式で出力されます。
@@ -10169,6 +10661,61 @@ quitは、groongaプロセスとのセッションを終了します。クライ
 quit
 .ft P
 .fi
+.SS register
+.SS Summary
+.sp
+\fBregister\fP command registers a plugin. You need to register a plugin
+before you use a plugin.
+.sp
+You need just one \fBregister\fP command for a plugin in the same
+database because registered plugin information is written into the
+database.  When you restart your \fBgroonga\fP process, \fBgroonga\fP
+process loads all registered plugins without \fBregister\fP command.
+.IP Note
+Registered plugins can\(aqt be removed for now.
+.RE
+.SS Syntax
+.sp
+\fBregister\fP has a parameter \fBpath\fP. It is required parameter:
+.sp
+.nf
+.ft C
+register path
+.ft P
+.fi
+.SS Usage
+.sp
+Here is a sample that registers \fBQueryExpanderTSV\fP query expander
+that is included in
+\fB${PREFIX}/lib/groonga/plugins/query_expanders/tsv.so\fP.
+.sp
+Execution example:
+.sp
+.nf
+.ft C
+register query_expanders/tsv
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+.ft P
+.fi
+.sp
+You can omit \fB${PREFIX}/lib/groonga/plugins/\fP and suffix (\fB.so\fP).
+They are completed automatically.
+.sp
+You can specify absolute path such as \fBregister
+/usr/lib/groonga/plugins/query_expanders/tsv.so\fP.
+.SS Return value
+.sp
+\fBregister\fP returns \fBtrue\fP as body on success such as:
+.sp
+.nf
+.ft C
+[HEADER, true]
+.ft P
+.fi
+.sp
+If \fBregister\fP fails, error details are in \fBHEADER\fP.
+.sp
+See \fB/reference/command/output_format\fP for \fBHEADER\fP.
 .SS select
 .SS Summary
 .sp
@@ -13793,53 +14340,268 @@ Object型はv1.2でサポートされます。
 .SS Tokenizers
 .sp
 TODO: Write me.
-.SS 疑似カラム (pseudo_column)
-.SS 名前
-.sp
-疑似カラム
-.SS 説明
-.sp
-groongaのデータベースで作成したテーブルには、いくつかのカラムが自動的に定義されます。
-.sp
-これらのカラムはいずれもアンダースコア(\(aq_\(aq)で始まる名前が付与されます。定義される疑似カラムは、テーブルの種類によって異なります。
+.SS Query expanders
+.SS QueryExpanderTSV
+.SS Summary
 .sp
-\fB_id\fP
-.INDENT 0.0
-.INDENT 3.5
-レコードに付与される一意な番号です。全てのテーブルに定義されます。値の範囲は1〜1073741824の整数で、通常はレコードを追加した順に1ずつ加算されます。_idの値は不変で、レコードが存在する限り変更することはできません。ただし、削除されたレコードの_idの値は再利用されます。
-.UNINDENT
-.UNINDENT
+\fBQueryExpanderTSV\fP is a query expander plugin that reads synonyms
+from TSV (Tab Separated Values) file. This plugin provides poor
+feature than the embedded query expansion feature. For example, it
+doesn\(aqt support word normalization. But it may be easy to use because
+you can manage your synonyms by TSV file. You can edit your synonyms
+by spreadsheet application such as Excel. With the embedded query
+expansion feature, you manage your synonyms by groonga\(aqs table.
+.SS Install
 .sp
-\fB_key\fP
-.INDENT 0.0
-.INDENT 3.5
-レコードの主キー値を表します。主キーを持つテーブルのみに定義されます。主キー値はテーブルの中で一意であり、変更することはできません。
-.UNINDENT
-.UNINDENT
+You need to register \fBquery_expanders/tsv\fP as a plugin before you
+use \fBQueryExpanderTSV\fP:
 .sp
-\fB_value\fP
-.INDENT 0.0
-.INDENT 3.5
-レコードの値を表します。value_typeを指定したテーブルのみに定義されます。自由に変更可能です。
-.UNINDENT
-.UNINDENT
+.nf
+.ft C
+register query_expanders/tsv
+.ft P
+.fi
+.SS Usage
 .sp
-\fB_score\fP
-.INDENT 0.0
-.INDENT 3.5
-各レコードのスコア値を表します。検索結果として生成されたテーブルのみに定義されます。
+You just add \fB\-\-query_expansion QueryExpanderTSV\fP parameter to
+\fBselect\fP command:
 .sp
-検索処理を実行する過程で値が設定されますが、自由に変更可能です。
-.UNINDENT
-.UNINDENT
+.nf
+.ft C
+select \-\-query "QUERY" \-\-query_expansion QueryExpanderTSV
+.ft P
+.fi
 .sp
-\fB_nsubrecs\fP
-.INDENT 0.0
-.INDENT 3.5
-主キーの値が同一であったレコードの件数を表します。検索結果として生成されたテーブルのみに定義されます。グループ化(drilldown)処理を実行すると、グループ化前のテーブルにおいて、グループ化キーの値が同一であったレコードの件数が、グループ化処理の結果を格納するテーブルの_nsubrecsに記録されます。
-.UNINDENT
-.UNINDENT
-.SS grn_expr
+If \fBQUERY\fP has registered synonyms, they are expanded. For example,
+there are the following synonyms.
+.TS
+center;
+|l|l|l|.
+_
+T{
+word
+T}	T{
+synonym 1
+T}	T{
+synonym 2
+T}
+_
+T{
+groonga
+T}	T{
+groonga
+T}	T{
+Senna
+T}
+_
+T{
+mroonga
+T}	T{
+mroonga
+T}	T{
+groonga MySQL
+T}
+_
+.TE
+.sp
+The table means that \fBsynonym 1\fP and \fBsynonym 2\fP are synonyms of
+\fBword\fP. For example, \fBgroonga\fP and \fBSenna\fP are synonyms of
+\fBgroonga\fP. And \fBmroonga\fP and \fBgroonga MySQL\fP are synonyms of
+\fBmroonga\fP.
+.sp
+Here is an example of query expnasion that uses \fBgroonga\fP as query:
+.sp
+.nf
+.ft C
+select \-\-query "groonga" \-\-query_expansion QueryExpanderTSV
+.ft P
+.fi
+.sp
+The above command equals to the following command:
+.sp
+.nf
+.ft C
+select \-\-query "groonga OR Senna" \-\-query_expansion QueryExpanderTSV
+.ft P
+.fi
+.sp
+Here is another example of query expnasion that uses \fBmroonga
+search\fP as query:
+.sp
+.nf
+.ft C
+select \-\-query "mroonga search" \-\-query_expansion QueryExpanderTSV
+.ft P
+.fi
+.sp
+The above command equals to the following command:
+.sp
+.nf
+.ft C
+select \-\-query "(mroonga OR (groonga MySQL)) search" \-\-query_expansion QueryExpanderTSV
+.ft P
+.fi
+.sp
+It is important that registered words (\fBgroonga\fP and \fBmroonga\fP)
+are only expanded to synonyms and not registered words (\fBsearch\fP)
+are not expanded. Query expansion isn\(aqt occurred
+recursively. \fBgroonga\fP is appeared in \fB(mroonga OR (groonga
+MySQL))\fP as query expansion result but it isn\(aqt expanded.
+.sp
+Normally, you need to include \fBword\fP itself into synonyms. For
+example, \fBgroonga\fP and \fBmroonga\fP are included in synonyms of
+themselves. If you want to ignore \fBword\fP itself, you don\(aqt include
+\fBword\fP itself into synonyms. For example, if you want to use query
+expansion as spelling correction, you should use the following
+synonyms.
+.TS
+center;
+|l|l|.
+_
+T{
+word
+T}	T{
+synonym
+T}
+_
+T{
+gronga
+T}	T{
+groonga
+T}
+_
+.TE
+.sp
+\fBgronga\fP in \fBword\fP has a typo. A \fBo\fP is missing. \fBgroonga\fP in
+\fBsynonym\fP is the correct word.
+.sp
+Here is an example of using query expnasion as spelling correction:
+.sp
+.nf
+.ft C
+select \-\-query "gronga" \-\-query_expansion QueryExpanderTSV
+.ft P
+.fi
+.sp
+The above command equals to the following command:
+.sp
+.nf
+.ft C
+select \-\-query "groonga" \-\-query_expansion QueryExpanderTSV
+.ft P
+.fi
+.sp
+The former command has a typo in \fB\-\-query\fP value but the latter
+command doesn\(aqt have any typos.
+.SS TSV File
+.sp
+Synonyms are defined in TSV format file. This section describes about
+it.
+.SS Location
+.sp
+The file name should be \fBsynonyms.tsv\fP and it is located at
+configuration directory. For example, \fB/etc/groonga/synonyms.tsv\fP is
+a TSV file location. The location is decided at build time.
+.sp
+You can change the location by environment variable
+\fBGRN_QUERY_EXPANDER_TSV_SYNONYMS_FILE\fP at run time:
+.sp
+.nf
+.ft C
+% env GRN_QUERY_EXPANDER_TSV_SYNONYMS_FILE=/tmp/synonyms.tsv groonga
+.ft P
+.fi
+.sp
+With the above command, \fB/tmp/synonyms.tsv\fP file is used.
+.SS Format
+.sp
+You can define zero or more synonyms in a TSV file. You define a
+\fBword\fP and \fBsynonyms\fP pair by a line. \fBword\fP is expanded to
+\fBsynonyms\fP in \fB\-\-query\fP value. \fBSynonyms\fP are combined by
+\fBOR\fP. For example, \fBgroonga\fP and \fBSenna\fP synonyms are expanded
+as \fBgroonga OR Senna\fP.
+.sp
+The first column is \fBword\fP and the rest columns are \fBsynonyms\fP of
+the \fBword\fP. Here is a sample line for \fBword\fP is \fBgroonga\fP and
+\fBsynonyms\fP are \fBgroonga\fP and \fBSenna\fP. \fB(TAB)\fP means a tab
+character (\fBU+0009\fP):
+.sp
+.nf
+.ft C
+groonga(TAB)groonga(TAB)Senna
+.ft P
+.fi
+.sp
+Comment line is supported. Lines that start with \fB#\fP are ignored.
+Here is an example for comment line. \fBgroonga\fP line is ignored as
+comment line:
+.sp
+.nf
+.ft C
+#groonga(TAB)groonga(TAB)Senna
+mroonga(TAB)mroonga(TAB)groonga MySQL
+.ft P
+.fi
+.SS Limitation
+.sp
+You need to restart groonga to reload your synonyms. TSV file is
+loaded only at the plugin load time.
+.SS See also
+.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
+.SS grn_expr
 .sp
 Grn_expr is an object that searches records with specified conditions
 and manipulates a database. It\(aqs pronounced as \fBgurun expression\fP.
@@ -17187,7 +17949,15 @@ are also normalized.
 .UNINDENT
 .UNINDENT
 .UNINDENT
-.SS 組み込み関数一覧
+.SS Function
+.sp
+Function can be used in some commands. For example, you can use
+function in \fB\-\-filter\fP, \fB\-\-scorer\fP and \fBoutput_columns\fP
+options of \fBcommands/select\fP.
+.sp
+This section describes about function and built\-in functions.
+.sp
+TODO: Add documentations about function.
 .SS edit_distance
 .SS 名前
 .sp
@@ -17474,16 +18244,11 @@ You can specify the value of \fBapproximate_type\fP by one of the followings.
 .IP Note
 There is a limitation about \fBgeo_distance\fP. \fBgeo_distance\fP can not
 calculate the value of distance between two points across meridian,
-euator or the date line.
+equator or the date line if you use \fBsphere\fP or \fBellipsoid\fP as
+approximate type. There is not such a limitation for \fBrectangle\fP.
 This is temporary limitation according to the implementation of groonga,
 but it will be fixed in the future release.
 .RE
-.IP Note
-There is a limitation about \fBgeo_distance\fP above notice.
-But it relaxes the limitation if you use \fBrectangle\fP as approximate type.
-You can calculate the correct distance if two point are placed at northern
-hemisphere or southern hemisphere.
-.RE
 .SS \fBrectangle\fP
 .sp
 This parameter require to approximate the geographical features
@@ -17560,6 +18325,110 @@ select Geo \-\-output_columns distance \-\-scorer \(aqdistance = geo_distance("1
 # ]
 .ft P
 .fi
+.sp
+Here are samples about calculating the value of distance with explicitly specified point across meridian, equator, the date line.
+.sp
+Execution example:
+.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
+This sample shows the value of distance across meridian.
+The return value of \fBgeo_distance("175904000x8464000", "145508000x\-13291000", "rectangle")\fP is the value of distance from Paris, Flance to Madrid, Spain.
+.sp
+Execution example:
+.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
+This sample shows the value of distance across equator.
+The return value of \fBgeo_distance("146566000x\-266422000", "\-56880000x\-172310000", "rectangle")\fP is the value of distance from New York, The United Status to Brasillia, Brasil.
+.sp
+Execution example:
+.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
+This sample shows the value of distance across the date line.
+The return value of \fBgeo_distance("143660000x419009000", "135960000x\-440760000", "rectangle")\fP is the value of distance from Beijin, China to San Francisco, The United States.
 .IP Note
 \fBgeo_distance\fP uses square approximation as default. If you omit \fBapproximate_type\fP, \fBgeo_distance\fP behaves like \fBrectangle\fP was specified.
 .RE
@@ -17866,10 +18735,194 @@ rand(10)
 3
 .ft P
 .fi
-.SS Indexing
+.SS snippet_html
+.IP Caution
+This feature is experimental. API will be changed.
+.RE
+.SS Summary
+.sp
+\fBsnippet_html\fP extracts snippets of target text around search
+keywords (\fBKWIC\fP. \fBKeyWord In Context\fP). The snippets are prepared
+for embedding HTML. Special characters such as \fB<\fP and \fB>\fP are
+escapsed as \fB&lt;\fP and \fB&gt;\fP. Keyword is surrounded with \fB<span
+class="keyword">\fP and \fB</span>\fP. For example, a snippet of \fBI am a
+groonga user. <3\fP for keyword \fBgroonga\fP is \fBI am a <span
+class="keyword">groonga</span> user. &lt;3\fP.
+.SS Syntax
+.sp
+\fBsnippet_html\fP has only one parameter:
+.sp
+.nf
+.ft C
+snippet_html(column)
+.ft P
+.fi
+.sp
+\fBsnippet_html\fP has many parameters internally but they can\(aqt be
+specified for now. You will be able to custom those parameters soon.
+.SS Usage
+.sp
+Here are a schema definition and sample data to show usage.
+.sp
+Execution example:
+.sp
+.nf
+.ft C
+table_create Documents TABLE_NO_KEY
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Documents content COLUMN_SCALAR Text
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+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 can be used in only \fB\-\-output_columns\fP in
+\fB/reference/commands/select\fP.
+.sp
+You need to specify \fB\-\-command_version 2\fP argument explicitly
+because function call in \fB\-\-output_columns\fP is experimental feature
+in groonga 2.0.9. It will be enabled by default soon.
+.sp
+You also need to specify \fB\-\-query\fP and/or \fB\-\-filter\fP. Keywords are
+extracted from \fB\-\-query\fP and \fB\-\-filter\fP arguments.
+.sp
+The following example uses \fB\-\-query "fast performance"\fP. In this
+case, \fBfast\fP and \fBperformance\fP are used as keywords.
+.sp
+Execution example:
+.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 matches to only the first record\(aqs
+content. \fBsnippet_html(content)\fP extracts two text parts that
+include the keywords \fBfast\fP or \fBperformance\fP and surronds the
+keywords with \fB<span class="keyword">\fP and \fB</span>\fP.
+.sp
+The max number of text parts is 3. If there are 4 or more text parts
+that include the keywords, only the leading 3 parts are only used.
+.sp
+The max size of a text part is 200byte. The unit is bytes not
+chracters. The size doesn\(aqt include inserted \fB<span keyword="keyword">\fP
+and \fB</span>\fP.
+.sp
+Both the max number of text parts and the max size of a text part
+aren\(aqt customizable.
+.sp
+You can specify string literal instead of column.
+.sp
+Execution example:
+.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 Return value
+.sp
+\fBsnippet_html\fP returns an array of string. An element of array is a
+snippet:
+.sp
+.nf
+.ft C
+[SNIPPET1, SNIPPET2, SNIPPET3]
+.ft P
+.fi
+.sp
+A snippet includes one or more keywords. The max byte size of a
+snippet except \fB<span keyword="keyword">\fP and \fB</span>\fP is
+200byte. The unit isn\(aqt the number of chracters.
+.sp
+The array size is larger than or equal to 0 and less than or equal
+to 3. The max size 3 will be customizable soon.
+.SS TODO
+.INDENT 0.0
+.IP \(bu 2
+Make the max number of text parts customizable.
+.IP \(bu 2
+Make the max size of a text part customizable.
+.IP \(bu 2
+Make keywords customizable.
+.IP \(bu 2
+Make tag that surrounds a keyword customizable.
+.IP \(bu 2
+Make normalization customizable.
+.IP \(bu 2
+Support options by object literal.
+.UNINDENT
+.SS See also
+.INDENT 0.0
+.IP \(bu 2
+\fB/reference/commands/select\fP
+.UNINDENT
+.SS Indexing
 .sp
 Groonga supports both online index construction and offline
-index construction since 1.3.1.
+index construction since 2.0.0.
 .SS Online index construction
 .sp
 In online index construction, registered documents can be
@@ -18363,6 +19416,416 @@ Example:
 .sp
 TODO...
 .SH SPECIFICATION
+.SS GQTP
+.sp
+GQTP is the acronym of Groonga Query Transfer Protocol. GQTP is the
+original protocol for groonga.
+.SS Protocol
+.sp
+GQTP is stateful client server model protocol. The following sequence
+is one processing unit:
+.INDENT 0.0
+.IP \(bu 2
+Client sends a request
+.IP \(bu 2
+Server receives the request
+.IP \(bu 2
+Server processes the request
+.IP \(bu 2
+Server sends a response
+.IP \(bu 2
+Client receives the response
+.UNINDENT
+.sp
+You can do zero or more processing units in a session.
+.sp
+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\(aqt defined in GQTP.
+.SS GQTP header
+.sp
+GQTP header consists of the following unsigned integer values:
+.TS
+center;
+|l|l|l|.
+_
+T{
+Name
+T}	T{
+Size
+T}	T{
+Description
+T}
+_
+T{
+\fBprotocol\fP
+T}	T{
+1byte
+T}	T{
+Protocol type.
+T}
+_
+T{
+\fBquery_type\fP
+T}	T{
+1byte
+T}	T{
+Content type of body.
+T}
+_
+T{
+\fBkey_length\fP
+T}	T{
+2byte
+T}	T{
+Not used.
+T}
+_
+T{
+\fBlevel\fP
+T}	T{
+1byte
+T}	T{
+Not used.
+T}
+_
+T{
+\fBflags\fP
+T}	T{
+1byte
+T}	T{
+Flags.
+T}
+_
+T{
+\fBstatus\fP
+T}	T{
+2byte
+T}	T{
+Return code.
+T}
+_
+T{
+\fBsize\fP
+T}	T{
+4byte
+T}	T{
+Body size.
+T}
+_
+T{
+\fBopaque\fP
+T}	T{
+4byte
+T}	T{
+Not used.
+T}
+_
+T{
+\fBcas\fP
+T}	T{
+8byte
+T}	T{
+Not used.
+T}
+_
+.TE
+.sp
+All header values are encoded by network byte order.
+.sp
+The following sections describes available values of each header value.
+.sp
+The total size of GQTP header is 24byte.
+.SS \fBprotocol\fP
+.sp
+The value is always \fB0xc7\fP in both request and response GQTP header.
+.SS \fBquery_type\fP
+.sp
+The value is one of the following values:
+.TS
+center;
+|l|l|l|.
+_
+T{
+Name
+T}	T{
+Value
+T}	T{
+Description
+T}
+_
+T{
+\fBNONE\fP
+T}	T{
+0
+T}	T{
+Free format.
+T}
+_
+T{
+\fBTSV\fP
+T}	T{
+1
+T}	T{
+Tab Separated Values.
+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
+This is not used in request GQTP header.
+.sp
+This is used in response GQTP header. Body is formatted as specified
+type.
+.SS \fBflags\fP
+.sp
+The value is bitwise OR of the following values:
+.TS
+center;
+|l|l|l|.
+_
+T{
+Name
+T}	T{
+Value
+T}	T{
+Description
+T}
+_
+T{
+\fBMORE\fP
+T}	T{
+0x01
+T}	T{
+There are more data.
+T}
+_
+T{
+\fBTAIL\fP
+T}	T{
+0x02
+T}	T{
+There are no more data.
+T}
+_
+T{
+\fBHEAD\fP
+T}	T{
+0x04
+T}	T{
+Not used.
+T}
+_
+T{
+\fBQUIET\fP
+T}	T{
+0x08
+T}	T{
+Be quiet.
+T}
+_
+T{
+\fBQUIT\fP
+T}	T{
+0x10
+T}	T{
+Quit.
+T}
+_
+.TE
+.sp
+You must specify \fBMORE\fP or \fBTAIL\fP flag.
+.sp
+If you use \fBMORE\fP flag, you should also use \fBQUIET\fP flag. Because
+you don\(aqt need to show a response for your partial request.
+.sp
+Use \fBQUIT\fP flag to quit this session.
+.SS \fBstatus\fP
+.sp
+Here are available values. The new statuses will be added in the
+future.
+.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
+The size of body. The maximum body size is 4GiB because \fBsize\fP is
+4byte unsigned integer. If you want to send 4GiB or more larger data,
+use \fBMORE\fP flag.
+.SS Example
+.sp
+TODO
+.SS See also
+.sp
+TODO
 .SS 検索
 .sp
 \fB/reference/commands/select\fP コマンドがqueryパラメータを使ってどのように検索するのかを説明します。
@@ -18501,14 +19964,25 @@ select Shops \-\-filter \(aq"point > 3 && description @ \e"スープカレー\e"
 .SH LIMITATIONS
 .sp
 Groonga has some limitations.
+.SS Limitations of table
+.sp
+A table has the following limitations.
+.INDENT 0.0
+.IP \(bu 2
+The maximum one key size: 4096Bytes
+.IP \(bu 2
+The maximum total size of keys: 4GBytes
+.UNINDENT
+.sp
+Keep in mind that these limitations may vary depending on conditions.
 .SS Limitations of indexing
 .sp
 A full\-text index has the following limitations.
 .INDENT 0.0
 .IP \(bu 2
-The maximum number of records: 268,435,455 (more than 26 million)
+The maximum number of records: 268,435,455 (more than 268 million)
 .IP \(bu 2
-The maximum number of distinct terms: 268,435,455 (more than 26 million)
+The maximum number of distinct terms: 268,435,455 (more than 268 million)
 .IP \(bu 2
 The maximum index size: 256GBytes
 .UNINDENT
@@ -18784,13 +20258,13 @@ report the bug. Coding and documentation are also welcome for groonga and
 its related projects.
 .INDENT 0.0
 .TP
-.B Use:
+.B As a user:
 If you are interested in groonga, please read this document and try it.
 .TP
-.B Introduction:
+.B As a spokesman:
 Please introduce groonga to your friends and colleagues.
 .TP
-.B Bug report, development and documentation:
+.B As a developer: Bug report, development and documentation
 This section describes the details.
 .UNINDENT
 .SS How to report a bug
@@ -19369,6 +20843,11 @@ make update\-poコマンドの実行により更新した各種.poファイル
 .fi
 .sp
 これにより$GROONGA_CLONE_DIR/groonga\-(バージョン).tar.gzが作成されます。
+.IP Note
+タグを打つ前にmake distを行うとversionが古いままになることがあります。
+するとgroonga \-\-versionで表示されるバージョン表記が更新されないので注意が必要です。
+make distで生成したtar.gzのversionおよびversion.shがタグと一致することを確認するのが望ましいです。
+.RE
 .SS パッケージのビルド
 .sp
 リリース用のアーカイブファイルができたので、パッケージ化する作業を行います。
@@ -19459,6 +20938,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パッケージが生成されます。
@@ -19841,6 +21322,17 @@ freecode.comのプロジェクトページは以下の通りです。
 \fI\%https://freecode.com/projects/groonga/releases/new\fP
 .UNINDENT
 .UNINDENT
+.IP Note
+投稿した内容に対するレビューが運営側で実施されるので、反映されるまでしばらく時間がかかります。
+.RE
+.SS Twitterでリリースアナウンスをする
+.sp
+blogroongaのリリースエントリには「リンクをあなたのフォロワーに共有する」ためのツイートボタンがあるので、そのボタンを使ってリリースアナウンスします。(画面下部に配置されている)
+.sp
+このボタンを経由する場合、ツイート内容に自動的にリリースタイトル(「groonga 2.0.8リリース」など)とblogroongaのリリースエントリのURLが挿入されます。
+.sp
+この作業はblogroongaの英語版、日本語版それぞれで行います。
+あらかじめgroongaアカウントでログインしておくとアナウンスを円滑に行うことができます。
 .sp
 以上でリリース作業は終了です。
 .SS リリース後にやること
@@ -19866,6 +21358,9 @@ $GROONGA_CLONE_DIRにて以下のコマンドを実行します。:
 .fi
 .sp
 これにより$GROONGA_CLONE_DIR/base_versionが更新されるのでコミットしておきます。
+.IP Note
+base_versionはtar.gzなどのリリース用のファイル名で使用します。
+.RE
 .SS ビルド時のTIPS
 .SS ビルドを並列化したい
 .sp