rroonga 4.0.7-x64-mingw32 → 4.0.8-x64-mingw32

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

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "GROONGA" "1" "November 29, 2014" "4.0.8" "Groonga"
+.TH "GROONGA" "1" "December 29, 2014" "4.0.9" "Groonga"
 .SH NAME
 groonga \- Groonga documentation
 .
@@ -110,7 +110,7 @@ packages.groonga.org:
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.8\-x86.exe\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.9\-x86.exe\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -123,7 +123,7 @@ packages.goronga.org:
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.8\-x64.exe\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.9\-x64.exe\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -140,7 +140,7 @@ packages.groonga.org:
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.8\-x86.zip\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.9\-x86.zip\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -153,7 +153,7 @@ packages.groonga.org:
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.8\-x64.zip\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.9\-x64.zip\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -181,7 +181,7 @@ Download zipped source from packages.groonga.org:
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fI\%http://packages.groonga.org/source/groonga/groonga\-4.0.8.zip\fP
+\fI\%http://packages.groonga.org/source/groonga/groonga\-4.0.9.zip\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -194,7 +194,7 @@ Move to the Groonga\(aqs source folder:
 .sp
 .nf
 .ft C
-> cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-4.0.8
+> cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-4.0.9
 .ft P
 .fi
 .UNINDENT
@@ -208,7 +208,7 @@ parameter instead:
 .sp
 .nf
 .ft C
-groonga\-4.0.8> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\egroonga
+groonga\-4.0.9> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\egroonga
 .ft P
 .fi
 .UNINDENT
@@ -220,7 +220,7 @@ Build:
 .sp
 .nf
 .ft C
-groonga\-4.0.8> cmake \-\-build . \-\-config Release
+groonga\-4.0.9> cmake \-\-build . \-\-config Release
 .ft P
 .fi
 .UNINDENT
@@ -232,7 +232,7 @@ Install:
 .sp
 .nf
 .ft C
-groonga\-4.0.8> cmake \-\-build . \-\-config Release \-\-target Install
+groonga\-4.0.9> cmake \-\-build . \-\-config Release \-\-target Install
 .ft P
 .fi
 .UNINDENT
@@ -293,9 +293,9 @@ Download source:
 .sp
 .nf
 .ft C
-% curl \-O http://packages.groonga.org/source/groonga/groonga\-4.0.8.tar.gz
-% tar xvzf groonga\-4.0.8.tar.gz
-% cd groonga\-4.0.8
+% curl \-O http://packages.groonga.org/source/groonga/groonga\-4.0.9.tar.gz
+% tar xvzf groonga\-4.0.9.tar.gz
+% cd groonga\-4.0.9
 .ft P
 .fi
 .UNINDENT
@@ -412,6 +412,21 @@ Install groonga\-tokenizer\-mecab package:
 .UNINDENT
 .UNINDENT
 .sp
+If you want to use TokenFilterStem as a token filter, install
+groonga\-token\-filter\-stem package.
+.sp
+Install groonga\-token\-filter\-stem package:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% sudo apt\-get install \-y \-V groonga\-token\-filter\-stem
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.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
@@ -462,9 +477,9 @@ Download source:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-4.0.8.tar.gz
-% tar xvzf groonga\-4.0.8.tar.gz
-% cd groonga\-4.0.8
+% wget http://packages.groonga.org/source/groonga/groonga\-4.0.9.tar.gz
+% tar xvzf groonga\-4.0.9.tar.gz
+% cd groonga\-4.0.9
 .ft P
 .fi
 .UNINDENT
@@ -606,6 +621,21 @@ Install groonga\-tokenizer\-mecab package:
 .UNINDENT
 .UNINDENT
 .sp
+If you want to use TokenFilterStem as a token filter, install
+groonga\-token\-filter\-stem package.
+.sp
+Install groonga\-token\-filter\-stem package:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% sudo apt\-get \-y install groonga\-token\-filter\-stem
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.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
@@ -656,9 +686,9 @@ Download source:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-4.0.8.tar.gz
-% tar xvzf groonga\-4.0.8.tar.gz
-% cd groonga\-4.0.8
+% wget http://packages.groonga.org/source/groonga/groonga\-4.0.9.tar.gz
+% tar xvzf groonga\-4.0.9.tar.gz
+% cd groonga\-4.0.9
 .ft P
 .fi
 .UNINDENT
@@ -1063,9 +1093,9 @@ Download source:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-4.0.8.tar.gz
-% tar xvzf groonga\-4.0.8.tar.gz
-% cd groonga\-4.0.8
+% wget http://packages.groonga.org/source/groonga/groonga\-4.0.9.tar.gz
+% tar xvzf groonga\-4.0.9.tar.gz
+% cd groonga\-4.0.9
 .ft P
 .fi
 .UNINDENT
@@ -1266,9 +1296,9 @@ Download source:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-4.0.8.tar.gz
-% tar xvzf groonga\-4.0.8.tar.gz
-% cd groonga\-4.0.8
+% wget http://packages.groonga.org/source/groonga/groonga\-4.0.9.tar.gz
+% tar xvzf groonga\-4.0.9.tar.gz
+% cd groonga\-4.0.9
 .ft P
 .fi
 .UNINDENT
@@ -1333,9 +1363,9 @@ Download source:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-4.0.8.tar.gz
-% gtar xvzf groonga\-4.0.8.tar.gz
-% cd groonga\-4.0.8
+% wget http://packages.groonga.org/source/groonga/groonga\-4.0.9.tar.gz
+% gtar xvzf groonga\-4.0.9.tar.gz
+% cd groonga\-4.0.9
 .ft P
 .fi
 .UNINDENT
@@ -1458,7 +1488,7 @@ editing in \fB/reference/executables/groonga\fP
 .IP \(bu 2
 \fI\%zlib\fP for compressing column value
 .IP \(bu 2
-\fI\%LZO\fP for compressing
+\fI\%LZ4\fP for compressing
 column value
 .UNINDENT
 .UNINDENT
@@ -1475,9 +1505,9 @@ steps:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-4.0.8.tar.gz
-% tar xvzf groonga\-4.0.8.tar.gz
-% cd groonga\-4.0.8
+% wget http://packages.groonga.org/source/groonga/groonga\-4.0.9.tar.gz
+% tar xvzf groonga\-4.0.9.tar.gz
+% cd groonga\-4.0.9
 % ./configure
 % make
 % sudo make install
@@ -8158,7 +8188,7 @@ Custom command version
 T}	T{
 o
 T}	T{
-x (comming soon)
+o
 T}
 _
 T{
@@ -8558,6 +8588,121 @@ to Groonga server in some program languages. See \fI\%Client libraries\fP for de
 .SS Executables
 .sp
 This section describes executable files provided by groonga package.
+.SS \fBgrndb\fP
+.SS Summary
+.sp
+\fBNOTE:\fP
+.INDENT 0.0
+.INDENT 3.5
+This executable command is an experimental feature.
+.UNINDENT
+.UNINDENT
+.sp
+New in version 4.0.9.
+
+.sp
+\fBgrndb\fP manages a Groonga database.
+.sp
+Here are features:
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.IP \(bu 2
+Checks whether database is broken or not.
+.IP \(bu 2
+Recovers broken database automatically if the database is
+recoverable.
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.SS Syntax
+.sp
+\fBgrndb\fP requires command and database path:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+grndb COMMAND [OPTIONS] DATABASE_PATH
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Here are available commands:
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.IP \(bu 2
+\fBcheck\fP \- Checks whether database is broken or not.
+.IP \(bu 2
+\fBrecover\fP \- Recovers database.
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.SS Usage
+.sp
+Here is an example to check the database at \fB/var/lib/groonga/db/db\fP:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+$ grndb check /var/lib/groonga/db/db
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Here is an example to recover the database at \fB/var/lib/groonga/db/db\fP:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+$ grndb recover /var/lib/groonga/db/db
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS Commands
+.sp
+This section describes available commands.
+.SS \fBcheck\fP
+.sp
+It checks an existing Groonga database. If the database is broken,
+\fBgrndb\fP reports reasons and exits with non\-\fB0\fP exit status.
+.sp
+\fBNOTE:\fP
+.INDENT 0.0
+.INDENT 3.5
+You must not use this command for opened database. If the database
+is opened, this command may report wrong result.
+.UNINDENT
+.UNINDENT
+.SS \fBrecover\fP
+.sp
+It recovers an existing broken Groonga database.
+.sp
+If the database is not broken, \fBgrndb\fP does nothing and exits with
+\fB0\fP exit status.
+.sp
+If the database is broken and one or more index columns are only
+broken, \fBgrndb\fP recovers these index columns and exists with \fB0\fP
+exit status. It may take a long time for large indexed data.
+.sp
+If the database is broken and tables or data columns are broken,
+\fBgrndb\fP reports broken reasons and exits with non\-\fB0\fP exit
+status. You can know whether the database is recoverable or not by
+\fBcheck\fP command.
+.sp
+\fBNOTE:\fP
+.INDENT 0.0
+.INDENT 3.5
+You must not use this command for opened database. If the database
+is opened, this command may break the database.
+.UNINDENT
+.UNINDENT
 .SS grnslap
 .SS 名前
 .sp
@@ -8681,7 +8826,7 @@ Groongaのデータベースは、groongaコマンドかCライブラリイン
 .INDENT 0.0
 .TP
 .B \-a, \-\-address <ip/hostname>
-Deprecated since version 1.2.2: Use \fI\%\-\-bind\-address\fP instead.
+Deprecated since version 1.2.2: Use \fI\-\-bind\-address\fP instead.
 
 .UNINDENT
 .INDENT 0.0
@@ -9565,7 +9710,7 @@ groonga_database_auto_create on | off;
 .sp
 Specifies whether Groonga database is created automatically or not. If
 the value is \fBon\fP and the Groonga database specified by
-\fI\%groonga_database\fP doesn\(aqt exist, the Groonga database is created
+\fIgroonga\-database\fP doesn\(aqt exist, the Groonga database is created
 automatically. If the Groonga database exists, groonga\-httpd does
 nothing.
 .sp
@@ -11135,6 +11280,46 @@ TODO
 .IP \(bu 2
 \fBreturn_code\fP describes about return code.
 .UNINDENT
+.SS Request ID
+.SS Summary
+.sp
+New in version 4.0.9.
+
+.sp
+You can assign ID to each request.
+.sp
+The ID can be used by canceling the request. See also
+\fB/reference/commands/request_cancel\fP for details about canceling
+a request.
+.sp
+Request ID should be managed by user. If you assign the same ID for
+some running requests, you can\(aqt cancel the request.
+.sp
+The simplest ID sequence is incremented numbers such as \fB1\fP,
+\fB2\fP , \fB\&...\fP\&.
+.sp
+A request ID is a string. The maximum request ID size is 4096 byte.
+.SS How to assign ID to request
+.sp
+All commands accept \fBrequest_id\fP parameter. You can assign ID to
+request by adding \fBrequest_id\fP parameter.
+.sp
+Here is an example to assign \fBid\-1\fP ID to a request:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+select Users \-\-request_id id\-1
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS See also
+.INDENT 0.0
+.IP \(bu 2
+\fB/reference/commands/request_cancel\fP
+.UNINDENT
 .SS Return code
 .SS Summary
 .sp
@@ -11656,6 +11841,9 @@ check Terms.name
 .UNINDENT
 .SS \fBclearlock\fP
 .SS Summary
+.sp
+Deprecated since version 4.0.9: Use \fBlock_clear\fP instead.
+
 .sp
 clearlock \- オブジェクトにセットされたロックを解除する
 .sp
@@ -13279,94 +13467,140 @@ load \-\-table Entry \-\-input_type json
 .SS See also
 .sp
 \fB/reference/grn_expr\fP
-.SS \fBlog_level\fP
+.SS \fBlock_clear\fP
 .SS Summary
 .sp
-log_level \- ログ出力レベルの設定
+New in version 4.0.9.
+
 .sp
-Groonga組込コマンドの一つであるlog_levelについて説明します。組込コマンドは、groonga実行ファイルの引数、標準>入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+\fBlock_clear\fP command clear the lock of the target object
+recursively. The target object is one of database, table and column.
 .sp
-log_levelは、ログ出力レベルを設定します。
+\fBNOTE:\fP
+.INDENT 0.0
+.INDENT 3.5
+This is a dangerous command. You must not use this command while
+other process or thread is doing a write operation to the target
+object. If you do it, your database may be broken and/or your
+process may be crashed.
+.UNINDENT
+.UNINDENT
 .SS Syntax
+.sp
+\fBtruncate\fP command takes only one parameter.
+.sp
+There is no required parameter:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-log_level level
+lock_clear [target_name=null]
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
+.sp
+If \fBtarget_name\fP parameters is omitted, database is used for the
+target object. It means that all locks in the database are cleared.
 .SS Usage
+.sp
+Here is an example to clear all locks in the database:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-log_level warning
-[true]
+\&.. groonga\-command
+\&.. include:: ../../example/reference/commands/lock_clear/database.log
+\&.. lock_clear
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
-.SS Parameters
 .sp
-\fBlevel\fP
+Here is an example to clear locks of \fBEntry\fP table and \fBEntry\fP
+table columns:
 .INDENT 0.0
 .INDENT 3.5
-設定するログ出力レベルの値を以下のいずれかで指定します。
-.INDENT 0.0
-.INDENT 3.5
-EMERG
-ALERT
-CRIT
-error
-warning
-notice
-info
-debug
+.sp
+.nf
+.ft C
+\&.. groonga\-command
+\&.. include:: ../../example/reference/commands/lock_clear/table.log
+\&.. table_create Entry TABLE_NO_KEY
+\&.. column_create Entry body COLUMN_SCALAR Text
+\&.. lock_clear Entry
+.ft P
+.fi
 .UNINDENT
 .UNINDENT
+.sp
+Here is an example to clear the lock of \fBSite.title\fP column:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+\&.. groonga\-command
+\&.. include:: ../../example/reference/commands/lock_clear/column.log
+\&.. table_create Site TABLE_HASH_KEY ShortText
+\&.. column_create Site title COLUMN_SCALAR ShortText
+\&.. lock_clear Site.title
+.ft P
+.fi
 .UNINDENT
 .UNINDENT
+.SS Parameters
+.sp
+This section describes all parameters.
+.SS \fBtarget_name\fP
+.sp
+It specifies the name of table or column.
+.sp
+If you don\(aqt specify it, database is used for the target object.
+.sp
+The default is none. It means that the target object is database.
 .SS Return value
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-[成功かどうかのフラグ]
+[HEADER, SUCCEEDED_OR_NOT]
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-\fB成功かどうかのフラグ\fP
+\fBHEADER\fP
 .INDENT 0.0
 .INDENT 3.5
-エラーが生じなかった場合にはtrue、エラーが生じた場合にはfalseを返す。
+See \fB/reference/command/output_format\fP about \fBHEADER\fP\&.
 .UNINDENT
 .UNINDENT
-.SS See also
 .sp
-\fBlog_put\fP
-\fBlog_reopen\fP
-.SS \fBlog_put\fP
+\fBSUCCEEDED_OR_NOT\fP
+.INDENT 0.0
+.INDENT 3.5
+If command succeeded, it returns true, otherwise it returns false on error.
+.UNINDENT
+.UNINDENT
+.SS \fBlog_level\fP
 .SS Summary
 .sp
-log_put \- ログ出力
+log_level \- ログ出力レベルの設定
 .sp
-groonga組込コマンドの一つであるlog_putについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入>力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるlog_levelについて説明します。組込コマンドは、groonga実行ファイルの引数、標準>入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
-log_putは、ログにmessageを出力します。
+log_levelは、ログ出力レベルを設定します。
 .SS Syntax
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-log_put level message
+log_level level
 .ft P
 .fi
 .UNINDENT
@@ -13377,7 +13611,7 @@ log_put level message
 .sp
 .nf
 .ft C
-log_put ERROR ****MESSAGE****
+log_level warning
 [true]
 .ft P
 .fi
@@ -13403,13 +13637,6 @@ debug
 .UNINDENT
 .UNINDENT
 .UNINDENT
-.sp
-\fBmessage\fP
-.INDENT 0.0
-.INDENT 3.5
-出力する文字列を指定します。
-.UNINDENT
-.UNINDENT
 .SS Return value
 .INDENT 0.0
 .INDENT 3.5
@@ -13430,26 +13657,23 @@ debug
 .UNINDENT
 .SS See also
 .sp
-\fBlog_level\fP
+\fBlog_put\fP
 \fBlog_reopen\fP
-.SS \fBlog_reopen\fP
+.SS \fBlog_put\fP
 .SS Summary
 .sp
-log_reopen \- ログファイルの再読み込み
-.sp
-Groonga組込コマンドの一つであるlog_reopenについて説明します。組込コマンドは、groonga実行ファイルの引数、標準
-入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+log_put \- ログ出力
 .sp
-log_reopenは、ログファイルを再読み込みします。
+groonga組込コマンドの一つであるlog_putについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入>力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
-現在、デフォルトのログ関数を用いている場合のみに対応しています。
+log_putは、ログにmessageを出力します。
 .SS Syntax
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-log_reopen
+log_put level message
 .ft P
 .fi
 .UNINDENT
@@ -13460,27 +13684,110 @@ log_reopen
 .sp
 .nf
 .ft C
-log_reopen
-
+log_put ERROR ****MESSAGE****
 [true]
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
-.SS log_reopenを用いたログのローテーション
+.SS Parameters
+.sp
+\fBlevel\fP
 .INDENT 0.0
-.IP 1. 3
-ログファイルをmvなどで移動する。
-ログはmvで移動された先のファイルに書き込まれる。
-.IP 2. 3
-log_reopenコマンドを実行する。
-.IP 3. 3
-既存のログファイル名と同じファイル名で、新たなログファイルが作成される。
-今後のログは新たなログファイルに書き込まれる。
+.INDENT 3.5
+設定するログ出力レベルの値を以下のいずれかで指定します。
+.INDENT 0.0
+.INDENT 3.5
+EMERG
+ALERT
+CRIT
+error
+warning
+notice
+info
+debug
+.UNINDENT
+.UNINDENT
+.UNINDENT
 .UNINDENT
-.SS Parameters
 .sp
-ありません。
+\fBmessage\fP
+.INDENT 0.0
+.INDENT 3.5
+出力する文字列を指定します。
+.UNINDENT
+.UNINDENT
+.SS Return value
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+[成功かどうかのフラグ]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+\fB成功かどうかのフラグ\fP
+.INDENT 0.0
+.INDENT 3.5
+エラーが生じなかった場合にはtrue、エラーが生じた場合にはfalseを返す。
+.UNINDENT
+.UNINDENT
+.SS See also
+.sp
+\fBlog_level\fP
+\fBlog_reopen\fP
+.SS \fBlog_reopen\fP
+.SS Summary
+.sp
+log_reopen \- ログファイルの再読み込み
+.sp
+Groonga組込コマンドの一つであるlog_reopenについて説明します。組込コマンドは、groonga実行ファイルの引数、標準
+入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+.sp
+log_reopenは、ログファイルを再読み込みします。
+.sp
+現在、デフォルトのログ関数を用いている場合のみに対応しています。
+.SS Syntax
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+log_reopen
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS Usage
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+log_reopen
+
+[true]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS log_reopenを用いたログのローテーション
+.INDENT 0.0
+.IP 1. 3
+ログファイルをmvなどで移動する。
+ログはmvで移動された先のファイルに書き込まれる。
+.IP 2. 3
+log_reopenコマンドを実行する。
+.IP 3. 3
+既存のログファイル名と同じファイル名で、新たなログファイルが作成される。
+今後のログは新たなログファイルに書き込まれる。
+.UNINDENT
+.SS Parameters
+.sp
+ありません。
 .SS Return value
 .INDENT 0.0
 .INDENT 3.5
@@ -13735,12 +14042,12 @@ Execution example:
 .sp
 .nf
 .ft C
-normalzer_list
+normalizer_list
 # [
 #   [
 #     0,
-#     0.0,
-#     0.0
+#     1337566253.89858,
+#     0.000355720520019531
 #   ],
 #   [
 #     {
@@ -13931,6 +14238,188 @@ You can specify absolute path such as \fBregister
 If \fBregister\fP fails, error details are in \fBHEADER\fP\&.
 .sp
 See \fB/reference/command/output_format\fP for \fBHEADER\fP\&.
+.SS \fBrequest_cancel\fP
+.SS Summary
+.sp
+\fBNOTE:\fP
+.INDENT 0.0
+.INDENT 3.5
+\fBrequest_cancel\fP command is an experimental feature.
+.UNINDENT
+.UNINDENT
+.sp
+New in version 4.0.9.
+
+.sp
+\fBrequest_cancel\fP command cancels a running request.
+.sp
+There are some limitations:
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.IP \(bu 2
+Request ID must be managed by user. (You need to assign unique key
+for each request.)
+.IP \(bu 2
+Cancel request may be ignored. (You can send \fBrequest_cancel\fP
+command multiple times for the same request ID.)
+.IP \(bu 2
+Only multithreading type Groonga server is supported. (You can use
+with \fB/reference/executables/groonga\fP based server but can\(aqt
+use with \fB/reference/executables/groonga\-httpd\fP\&.)
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.sp
+See \fB/reference/command/request_id\fP about request ID.
+.sp
+If request is canceled, the canceled request has \fB\-5\fP
+(\fBGRN_INTERRUPTED_FUNCTION_CALL\fP) as
+\fB/reference/command/return_code\fP\&.
+.SS Syntax
+.sp
+\fBrequest_cancel\fP command takes only one parameter.
+.sp
+The required parameter is only \fBid\fP:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+request_cancel id
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS Usage
+.sp
+Here is an example of \fBrequest_cancel\fP command:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+$ curl \(aqhttp://localhost:10041/d/select?table=LargeTable&filter=true&request_id=unique\-id\-1\(aq &
+# The above "select" takes a long time...
+# Point: "request_id=unique\-id\-1"
+$ curl \(aqhttp://localhost:10041/d/request_cancel?id=unique\-id\-1\(aq
+[[...], {"id": "unique\-id\-1", "canceled": true}]
+# Point: "id=unique\-id\-1"
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Assume that the first \fBselect\fP command takes a long
+time. \fBunique\-id\-1\fP request ID is assigned to the \fBselect\fP command
+by \fBrequest_id=unique\-id\-1\fP parameter.
+.sp
+The second \fBrequest_cancel\fP command passes \fBid=unique\-id\-1\fP
+parameter. \fBunique\-id\-1\fP is the same request ID passed in \fBselect\fP
+command.
+.sp
+The \fBselect\fP command may not be canceled immediately. And the cancel
+request may be ignored.
+.sp
+You can send cancel request for the same request ID multiple times. If
+the target request is canceled or finished, \fB"canceled"\fP value is
+changed to \fBfalse\fP from \fBtrue\fP:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+$ curl \(aqhttp://localhost:10041/d/request_cancel?id=unique\-id\-1\(aq
+[[...], {"id": "unique\-id\-1", "canceled": true}]
+# "select" is still running... ("canceled" is "true")
+$ curl \(aqhttp://localhost:10041/d/request_cancel?id=unique\-id\-1\(aq
+[[...], {"id": "unique\-id\-1", "canceled": true}]
+# "select" is still running... ("canceled" is "true")
+$ curl \(aqhttp://localhost:10041/d/request_cancel?id=unique\-id\-1\(aq
+[[...], {"id": "unique\-id\-1", "canceled": false}]
+# "select" is canceled or finished. ("canceled" is "false")
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+If the \fBselect\fP command is canceled, response of the \fBselect\fP
+command has \fB\-5\fP (\fBGRN_INTERRUPTED_FUNCTION_CALL\fP) as
+\fB/reference/command/return_code\fP:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+$ curl \(aqhttp://localhost:10041/d/select?table=LargeTable&filter=true&request_id=unique\-id\-1\(aq &
+[[\-5, ...], ...]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS Parameters
+.sp
+This section describes parameters of \fBrequest_cancel\fP\&.
+.SS Required parameter
+.sp
+There is required parameter, \fBid\fP\&.
+.SS \fBid\fP
+.sp
+It specifies the ID for the target request.
+.SS Return value
+.sp
+\fBrequest_cancel\fP command returns the result of the cancel request:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+[
+  HEADER,
+  {
+    "id":       ID,
+    "canceled": CANCEL_REQUEST_IS_ACCEPTED_OR_NOT
+  }
+]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+\fBHEADER\fP
+.INDENT 0.0
+.INDENT 3.5
+See \fB/reference/command/output_format\fP about \fBHEADER\fP\&.
+.UNINDENT
+.UNINDENT
+.sp
+\fBID\fP
+.INDENT 0.0
+.INDENT 3.5
+The ID of the target request.
+.UNINDENT
+.UNINDENT
+.sp
+\fBCANCEL_REQUEST_IS_ACCEPTED_OR_NOT\fP
+.INDENT 0.0
+.INDENT 3.5
+If the cancel request is accepted, this is \fBtrue\fP, otherwise this
+is \fBfalse\fP\&.
+.sp
+Note that "cancel request is accepted" doesn\(aqt means that "the
+target request is canceled". It just means "cancel request is
+notified to the target request but the cancel request may be ignored
+by the target request".
+.sp
+If request assigned with the request ID doesn\(aqt exist, this is
+\fBfalse\fP\&.
+.UNINDENT
+.UNINDENT
+.SS See also
+.INDENT 0.0
+.IP \(bu 2
+\fB/reference/command/request_id\fP
+.UNINDENT
 .SS \fBruby_eval\fP
 .SS Summary
 .sp
@@ -14569,7 +15058,7 @@ select Nonexistent
 #       [
 #         "grn_select",
 #         "proc.c",
-#         778
+#         1108
 #       ]
 #     ]
 #   ]
@@ -15313,7 +15802,7 @@ records (0) is larger than \fBmatch_escalation_threshold\fP (\-1). So no
 more searches aren\(aqt executed. And no records are matched.
 .SS \fBquery_expansion\fP
 .sp
-Deprecated. Use \fI\%query_expander\fP instead.
+Deprecated. Use \fIquery\-expander\fP instead.
 .SS \fBquery_flags\fP
 .sp
 It customs \fBquery\fP parameter syntax. You cannot update column value
@@ -17045,14 +17534,14 @@ status
 #     0.000355720520019531
 #   ],
 #   {
-#     "uptime": 7,
+#     "uptime": 0,
 #     "max_command_version": 2,
-#     "n_queries": 39,
+#     "n_queries": 0,
 #     "cache_hit_rate": 0.0,
-#     "version": "4.0.1",
-#     "alloc_count": 309,
+#     "version": "4.0.8\-82\-g721d5c7",
+#     "alloc_count": 181,
 #     "command_version": 1,
-#     "starttime": 1395806014,
+#     "starttime": 1419775504,
 #     "default_command_version": 1
 #   }
 # ]
@@ -19475,25 +19964,33 @@ _
 .SS \fBtruncate\fP
 .SS Summary
 .sp
-\fBtruncate\fP command deletes all records from specified table.
+\fBtruncate\fP command deletes all records from specified table or all
+values from specified column.
 .SS Syntax
 .sp
 \fBtruncate\fP command takes only one parameter.
 .sp
-The required parameter is only \fBtable\fP:
+The required parameter is only \fBtarget_name\fP:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-truncate table
+truncate target_name
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
+.sp
+New in version 4.0.9: \fBtarget_name\fP parameter can be used since 4.0.9. You need to use
+\fBtable\fP parameter for 4.0.8 or earlier.
+.sp
+For backward compatibility, \fBtruncate\fP command accepts \fBtable\fP
+parameter. But it should not be used for newly written code.
+
 .SS Usage
 .sp
-Here is a simple example of \fBtruncate\fP command.
+Here is a simple example of \fBtruncate\fP command against a table.
 .sp
 Execution example:
 .INDENT 0.0
@@ -19503,6 +20000,8 @@ Execution example:
 .ft C
 table_create Users TABLE_PAT_KEY ShortText
 # [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Users score COLUMN_SCALAR Int32
+# [[0, 1337566253.89858, 0.000355720520019531], true]
 load \-\-table Users
 [
 {"_key": "Alice",  "score": 2},
@@ -19530,19 +20029,26 @@ select Users
 #         [
 #           "_key",
 #           "ShortText"
+#         ],
+#         [
+#           "score",
+#           "Int32"
 #         ]
 #       ],
 #       [
 #         1,
-#         "Alice"
+#         "Alice",
+#         2
 #       ],
 #       [
 #         2,
-#         "Bob"
+#         "Bob",
+#         0
 #       ],
 #       [
 #         3,
-#         "Carlos"
+#         "Carlos",
+#         \-1
 #       ]
 #     ]
 #   ]
@@ -19569,7 +20075,125 @@ select Users
 #         [
 #           "_key",
 #           "ShortText"
+#         ],
+#         [
+#           "score",
+#           "Int32"
+#         ]
+#       ]
+#     ]
+#   ]
+# ]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Here is a simple example of \fBtruncate\fP command against a column.
+.sp
+Execution example:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+table_create Users TABLE_PAT_KEY ShortText
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Users score COLUMN_SCALAR Int32
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+load \-\-table Users
+[
+{"_key": "Alice",  "score": 2},
+{"_key": "Bob",    "score": 0},
+{"_key": "Carlos", "score": \-1}
+]
+# [[0, 1337566253.89858, 0.000355720520019531], 3]
+select Users
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         3
+#       ],
+#       [
+#         [
+#           "_id",
+#           "UInt32"
+#         ],
+#         [
+#           "_key",
+#           "ShortText"
+#         ],
+#         [
+#           "score",
+#           "Int32"
+#         ]
+#       ],
+#       [
+#         1,
+#         "Alice",
+#         2
+#       ],
+#       [
+#         2,
+#         "Bob",
+#         0
+#       ],
+#       [
+#         3,
+#         "Carlos",
+#         \-1
+#       ]
+#     ]
+#   ]
+# ]
+truncate Users.score
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+select Users
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         3
+#       ],
+#       [
+#         [
+#           "_id",
+#           "UInt32"
+#         ],
+#         [
+#           "_key",
+#           "ShortText"
+#         ],
+#         [
+#           "score",
+#           "Int32"
 #         ]
+#       ],
+#       [
+#         1,
+#         "Alice",
+#         0
+#       ],
+#       [
+#         2,
+#         "Bob",
+#         0
+#       ],
+#       [
+#         3,
+#         "Carlos",
+#         0
 #       ]
 #     ]
 #   ]
@@ -19583,11 +20207,13 @@ select Users
 This section describes parameters of \fBtruncate\fP\&.
 .SS Required parameter
 .sp
-There is required parameter, \fBtable_name\fP\&.
-.SS \fBtable_name\fP
+There is required parameter, \fBtarget_name\fP\&.
+.SS \fBtarget_name\fP
 .sp
-It specifies the name of table.
+It specifies the name of table or column.
 .SS Return value
+.sp
+\fBtruncate\fP command returns whether truncation is succeeded or not:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -20265,53 +20891,15 @@ table_create NFKC51Lexicon TABLE_HASH_KEY ShortText \-\-normalizer NormalizerNFK
 .UNINDENT
 .SS Additional normalizers
 .sp
-Here is a list of additional normalizers provided by \fBgroonga\-normalizer\-mysql\fP plugins:
+There are additional normalizers:
 .INDENT 0.0
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fBNormalizerMySQLGeneralCI\fP
-.IP \(bu 2
-\fBNormalizerMySQLUnicodeCI\fP
-.IP \(bu 2
-\fBNormalizerMySQLUnicodeCIExceptKanaCIKanaWithVoicedSoundMark\fP
+\fIgroonga\-normalizer\-mysql <https://github.com/groonga/groonga\-normalizer\-mysql>_\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
-.sp
-\fBgroonga\-normalizer\-mysql\fP is a Groonga plugin.
-It provides MySQL compatible normalizers to Groonga.
-\fBNormalizerMySQLGeneralCI\fP corresponds to \fButf8mb4_general_ci\fP\&.
-.sp
-You need to register \fBnormalizers/mysql\fP plugin in advance.
-.sp
-Execution example:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-register normalizers/mysql
-# [[0, 1337566253.89858, 0.000355720520019531], true]
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-Here is an example that uses \fBNormalizerMySQLGeneralCI\fP normalizer:
-.sp
-Execution example:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-table_create MySQLGeneralLexicon TABLE_HASH_KEY ShortText \-\-normalizer NormalizerMySQLGeneralCI
-# [[0, 1337566253.89858, 0.000355720520019531], true]
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
 .SS See also
 .INDENT 0.0
 .IP \(bu 2
@@ -20370,11 +20958,13 @@ Execution example:
 .sp
 .nf
 .ft C
+register token_filters/stop_word
+# [[0, 1337566253.89858, 0.000355720520019531], true]
 table_create Terms TABLE_PAT_KEY ShortText \e
   \-\-default_tokenizer TokenBigram \e
   \-\-normalizer NormalizerAuto \e
   \-\-token_filters TokenFilterStopWord
-# [[0,0.0,0.0],true]
+# [[0, 1337566253.89858, 0.000355720520019531], true]
 .ft P
 .fi
 .UNINDENT
@@ -20407,38 +20997,38 @@ Execution example:
 .nf
 .ft C
 register token_filters/stop_word
-# [[0,0.0,0.0],true]
+# [[0, 1337566253.89858, 0.000355720520019531], true]
 table_create Memos TABLE_NO_KEY
-# [[0,0.0,0.0],true]
+# [[0, 1337566253.89858, 0.000355720520019531], true]
 column_create Memos content COLUMN_SCALAR ShortText
-# [[0,0.0,0.0],true]
+# [[0, 1337566253.89858, 0.000355720520019531], true]
 table_create Terms TABLE_PAT_KEY ShortText \e
   \-\-default_tokenizer TokenBigram \e
   \-\-normalizer NormalizerAuto \e
   \-\-token_filters TokenFilterStopWord
-# [[0,0.0,0.0],true]
+# [[0, 1337566253.89858, 0.000355720520019531], true]
 column_create Terms memos_content COLUMN_INDEX|WITH_POSITION Memos content
-# [[0,0.0,0.0],true]
+# [[0, 1337566253.89858, 0.000355720520019531], true]
 column_create Terms is_stop_word COLUMN_SCALAR Bool
-# [[0,0.0,0.0],true]
+# [[0, 1337566253.89858, 0.000355720520019531], true]
 load \-\-table Terms
 [
 {"_key": "and", "is_stop_word": true}
 ]
-# [[0,0.0,0.0],1]
+# [[0, 1337566253.89858, 0.000355720520019531], 1]
 load \-\-table Memos
 [
 {"content": "Hello"},
 {"content": "Hello and Good\-bye"},
 {"content": "Good\-bye"}
 ]
-# [[0,0.0,0.0],3]
+# [[0, 1337566253.89858, 0.000355720520019531], 3]
 select Memos \-\-match_columns content \-\-query "Hello and"
 # [
 #   [
 #     0,
-#     0.0,
-#     0.0
+#     1337566253.89858,
+#     0.000355720520019531
 #   ],
 #   [
 #     [
@@ -20488,31 +21078,31 @@ Execution example:
 .nf
 .ft C
 register token_filters/stem
-# [[0,0.0,0.0],true]
+# [[0, 1337566253.89858, 0.000355720520019531], true]
 table_create Memos TABLE_NO_KEY
-# [[0,0.0,0.0],true]
+# [[0, 1337566253.89858, 0.000355720520019531], true]
 column_create Memos content COLUMN_SCALAR ShortText
-# [[0,0.0,0.0],true]
+# [[0, 1337566253.89858, 0.000355720520019531], true]
 table_create Terms TABLE_PAT_KEY ShortText \e
   \-\-default_tokenizer TokenBigram \e
   \-\-normalizer NormalizerAuto \e
   \-\-token_filters TokenFilterStem
-# [[0,0.0,0.0],true]
+# [[0, 1337566253.89858, 0.000355720520019531], true]
 column_create Terms memos_content COLUMN_INDEX|WITH_POSITION Memos content
-# [[0,0.0,0.0],true]
+# [[0, 1337566253.89858, 0.000355720520019531], true]
 load \-\-table Memos
 [
 {"content": "I develop Groonga"},
 {"content": "I\(aqm developing Groonga"},
 {"content": "I developed Groonga"}
 ]
-# [[0,0.0,0.0],3]
+# [[0, 1337566253.89858, 0.000355720520019531], 3]
 select Memos \-\-match_columns content \-\-query "develops"
 # [
 #   [
 #     0,
-#     0.0,
-#     0.0
+#     1337566253.89858,
+#     0.000355720520019531
 #   ],
 #   [
 #     [
@@ -28893,10 +29483,10 @@ works. Query log is just for query processing.
 .SS Process log
 .sp
 Process log is enabled by default. Log path can be
-customized by \fB\-\-log\-path\fP option.  Each log has its
+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
-\fB\-l\fP or \fBcommands/log_level\fP\&.
+\fI\-l\fP or \fBcommands/log_level\fP\&.
 .SS Format
 .sp
 Process log uses the following format:
@@ -29036,7 +29626,7 @@ Example:
 .SS Query log
 .sp
 Query log is disabled by default. It can be enabled by
-\fB\-\-query\-log\-path\fP option.
+\fI\-\-query\-log\-path\fP option.
 .SS Format
 .sp
 Query log uses the following formats:
@@ -29318,7 +29908,7 @@ You must have memory and swap that is larger than database.
 This section describes how to configure parameters on Linux.
 .SS nofile
 .sp
-You can relax the \fI\%The max number of open files per process\fP parameter by creating
+You can relax the \fItuning\-max\-n\-open\-files\fP parameter by creating
 a configuration file \fB/etc/security/limits.d/groonga.conf\fP that has
 the following content:
 .INDENT 0.0
@@ -29352,7 +29942,7 @@ The configuration is applied after your groonga service is restarted
 or re\-login as your groonga user.
 .SS vm.overcommit_memory
 .sp
-This is \fI\%Memory usage\fP related parameter. You can handle a
+This is \fItuning\-memory\-usage\fP related parameter. You can handle a
 database that is larger than your memory and swap by setting
 \fBvm.overcommit_memory\fP kernel parameter to 1. 1 means that Groonga
 can always map database files onto memory. It is no problem until
@@ -29389,7 +29979,7 @@ following command:
 .UNINDENT
 .SS vm.max_map_count
 .sp
-This is \fI\%Memory usage\fP related parameter. You can handle a
+This is \fItuning\-memory\-usage\fP related parameter. You can handle a
 16GiB or more larger size database by increasing \fBvm.max_map_count\fP
 kernel parameter. The parameter limits the max number of memory maps.
 .sp
@@ -29481,7 +30071,7 @@ The lock timeout.
 .B grn_rc grn_set_lock_timeout(int\fI\ timeout\fP)
 Sets the lock timeout.
 .sp
-See \fI\%grn_get_lock_timeout()\fP about lock timeout.
+See \fBgrn_get_lock_timeout()\fP about lock timeout.
 .sp
 There are some special values for \fBtimeout\fP\&.
 .INDENT 7.0
@@ -29523,7 +30113,7 @@ This API is experimental.
 object. It is only for \fB/reference/commands/select\fP command.
 .sp
 You can just change the current cache object by
-\fI\%grn_cache_current_set()\fP\&. \fB/reference/commands/select\fP
+\fBgrn_cache_current_set()\fP\&. \fB/reference/commands/select\fP
 command response cache is done internally.
 .sp
 \fB/reference/commands/select\fP command uses one global cache
@@ -29560,8 +30150,8 @@ grn_cache_current_set(ctx, cache_previous);
 .TP
 .B grn_cache
 It is an opaque cache object. You can create a \fBgrn_cache\fP by
-\fI\%grn_cache_open()\fP and free the created object by
-\fI\%grn_cache_close()\fP\&.
+\fBgrn_cache_open()\fP and free the created object by
+\fBgrn_cache_close()\fP\&.
 .UNINDENT
 .INDENT 0.0
 .TP
@@ -29581,7 +30171,7 @@ is returned. Error information is stored into the \fBctx\fP\&.
 .B Returns
 A newly allocated cache object on success, \fBNULL\fP
 otherwise. The returned cache object must be freed by
-\fI\%grn_cache_close()\fP\&.
+\fBgrn_cache_close()\fP\&.
 .UNINDENT
 .UNINDENT
 .INDENT 0.0
@@ -29691,7 +30281,7 @@ TODO...
 .B GRN_COLUMN_NAME_ID
 It returns the name of \fB/reference/columns/pseudo\fP \fB_id\fP\&.
 .sp
-It is useful to use with \fI\%GRN_COLUMN_NAME_ID_LEN\fP like
+It is useful to use with \fBGRN_COLUMN_NAME_ID_LEN\fP like
 the following:
 .INDENT 7.0
 .INDENT 3.5
@@ -29710,7 +30300,7 @@ Since 3.1.1.
 .INDENT 0.0
 .TP
 .B GRN_COLUMN_NAME_ID_LEN
-It returns the byte size of \fI\%GRN_COLUMN_NAME_ID\fP\&.
+It returns the byte size of \fBGRN_COLUMN_NAME_ID\fP\&.
 .sp
 Since 3.1.1.
 .UNINDENT
@@ -29719,7 +30309,7 @@ Since 3.1.1.
 .B GRN_COLUMN_NAME_KEY
 It returns the name of \fB/reference/columns/pseudo\fP \fB_key\fP\&.
 .sp
-It is useful to use with \fI\%GRN_COLUMN_NAME_KEY_LEN\fP like
+It is useful to use with \fBGRN_COLUMN_NAME_KEY_LEN\fP like
 the following:
 .INDENT 7.0
 .INDENT 3.5
@@ -29738,7 +30328,7 @@ Since 3.1.1.
 .INDENT 0.0
 .TP
 .B GRN_COLUMN_NAME_KEY_LEN
-It returns the byte size of \fI\%GRN_COLUMN_NAME_KEY\fP\&.
+It returns the byte size of \fBGRN_COLUMN_NAME_KEY\fP\&.
 .sp
 Since 3.1.1.
 .UNINDENT
@@ -29747,7 +30337,7 @@ Since 3.1.1.
 .B GRN_COLUMN_NAME_VALUE
 It returns the name of \fB/reference/columns/pseudo\fP \fB_value\fP\&.
 .sp
-It is useful to use with \fI\%GRN_COLUMN_NAME_VALUE_LEN\fP like
+It is useful to use with \fBGRN_COLUMN_NAME_VALUE_LEN\fP like
 the following:
 .INDENT 7.0
 .INDENT 3.5
@@ -29766,7 +30356,7 @@ Since 3.1.1.
 .INDENT 0.0
 .TP
 .B GRN_COLUMN_NAME_VALUE_LEN
-It returns the byte size of \fI\%GRN_COLUMN_NAME_VALUE\fP\&.
+It returns the byte size of \fBGRN_COLUMN_NAME_VALUE\fP\&.
 .sp
 Since 3.1.1.
 .UNINDENT
@@ -29775,7 +30365,7 @@ Since 3.1.1.
 .B GRN_COLUMN_NAME_SCORE
 It returns the name of \fB/reference/columns/pseudo\fP \fB_score\fP\&.
 .sp
-It is useful to use with \fI\%GRN_COLUMN_NAME_SCORE_LEN\fP like
+It is useful to use with \fBGRN_COLUMN_NAME_SCORE_LEN\fP like
 the following:
 .INDENT 7.0
 .INDENT 3.5
@@ -29794,7 +30384,7 @@ Since 3.1.1.
 .INDENT 0.0
 .TP
 .B GRN_COLUMN_NAME_SCORE_LEN
-It returns the byte size of \fI\%GRN_COLUMN_NAME_SCORE\fP\&.
+It returns the byte size of \fBGRN_COLUMN_NAME_SCORE\fP\&.
 .sp
 Since 3.1.1.
 .UNINDENT
@@ -29803,7 +30393,7 @@ Since 3.1.1.
 .B GRN_COLUMN_NAME_NSUBRECS
 It returns the name of \fB/reference/columns/pseudo\fP \fB_nsubrecs\fP\&.
 .sp
-It is useful to use with \fI\%GRN_COLUMN_NAME_NSUBRECS_LEN\fP like
+It is useful to use with \fBGRN_COLUMN_NAME_NSUBRECS_LEN\fP like
 the following:
 .INDENT 7.0
 .INDENT 3.5
@@ -29822,7 +30412,7 @@ Since 3.1.1.
 .INDENT 0.0
 .TP
 .B GRN_COLUMN_NAME_NSUBRECS_LEN
-It returns the byte size of \fI\%GRN_COLUMN_NAME_NSUBRECS\fP\&.
+It returns the byte size of \fBGRN_COLUMN_NAME_NSUBRECS\fP\&.
 .sp
 Since 3.1.1.
 .UNINDENT
@@ -29959,6 +30549,36 @@ columnに張られているindexのうち、opの操作を実行可能なもの
 .UNINDENT
 .UNINDENT
 .UNINDENT
+.INDENT 0.0
+.TP
+.B grn_rc grn_column_truncate(grn_ctx\fI\ *ctx\fP, grn_obj\fI\ *column\fP)
+.sp
+\fBNOTE:\fP
+.INDENT 7.0
+.INDENT 3.5
+This is a dangerous API. You must not use this API when other
+thread or process accesses the target column. If you use this
+API against shared column, the process that accesses the column
+may be broken and the column may be broken.
+.UNINDENT
+.UNINDENT
+.sp
+New in version 4.0.9.
+
+.sp
+Clears all values in the column.
+.INDENT 7.0
+.TP
+.B Parameters
+.INDENT 7.0
+.IP \(bu 2
+\fBcolumn\fP \-\- The column to be truncated.
+.UNINDENT
+.TP
+.B Returns
+\fBGRN_SUCCESS\fP on success, not \fBGRN_SUCCESS\fP on error.
+.UNINDENT
+.UNINDENT
 .SS \fBgrn_command_version\fP
 .SS Summary
 .sp
@@ -30004,7 +30624,7 @@ TODO...
 .SS \fBgrn_content_type\fP
 .SS Summary
 .sp
-\fI\%grn_content_type\fP shows input type and output
+\fBgrn_content_type\fP shows input type and output
 type. Currently, it is used only for output type.
 .sp
 Normally, you don\(aqt need to use this type. It is used internally in
@@ -30037,7 +30657,7 @@ Groonga. If you don\(aqt have MessagePack library, you can\(aqt use this type.
 .SS \fBgrn_ctx\fP
 .SS Summary
 .sp
-\fI\%grn_ctx\fP is the most important object. \fI\%grn_ctx\fP
+\fBgrn_ctx\fP is the most important object. \fBgrn_ctx\fP
 keeps the current infomation such as:
 .INDENT 0.0
 .IP \(bu 2
@@ -30050,7 +30670,7 @@ The default thresholds. (e.g. \fImatch\-escalation\-threshold\fP)
 The default command version. (See \fB/reference/command/command_version\fP)
 .UNINDENT
 .sp
-\fI\%grn_ctx\fP provides platform features such as:
+\fBgrn_ctx\fP provides platform features such as:
 .INDENT 0.0
 .IP \(bu 2
 Memory management.
@@ -30058,11 +30678,11 @@ Memory management.
 Logging.
 .UNINDENT
 .sp
-Most APIs receive \fI\%grn_ctx\fP as the first argument.
+Most APIs receive \fBgrn_ctx\fP as the first argument.
 .sp
-You can\(aqt use the same \fI\%grn_ctx\fP from two or more threads. You
-need to create a \fI\%grn_ctx\fP for a thread. You can use two or
-more \fI\%grn_ctx\fP in a thread but it is not needed for usual
+You can\(aqt use the same \fBgrn_ctx\fP from two or more threads. You
+need to create a \fBgrn_ctx\fP for a thread. You can use two or
+more \fBgrn_ctx\fP in a thread but it is not needed for usual
 use\-case.
 .SS Example
 .sp
@@ -30096,7 +30716,7 @@ ctxを初期化します。
 .B grn_rc grn_ctx_fin(grn_ctx\fI\ *ctx\fP)
 ctxの管理するメモリを解放し、使用を終了します。
 .sp
-If \fBctx\fP is initialized by \fI\%grn_ctx_open()\fP not \fI\%grn_ctx_init()\fP\&. You need also to call \fI\%grn_ctx_close()\fP\&.
+If \fBctx\fP is initialized by \fBgrn_ctx_open()\fP not \fBgrn_ctx_init()\fP\&. You need also to call \fBgrn_ctx_close()\fP\&.
 .INDENT 7.0
 .TP
 .B Parameters
@@ -30112,11 +30732,11 @@ If \fBctx\fP is initialized by \fI\%grn_ctx_open()\fP not \fI\%grn_ctx_init()\fP
 .INDENT 0.0
 .TP
 .B grn_ctx *grn_ctx_open(int\fI\ flags\fP)
-初期化された \fI\%grn_ctx\fP オブジェクトを返します。
+初期化された \fBgrn_ctx\fP オブジェクトを返します。
 .sp
-\fI\%grn_ctx_init()\fP で初期化された \fI\%grn_ctx\fP オブジェクトは構造体の実体をAPIの呼び元で確保するのに対して、 \fI\%grn_ctx_open()\fP ではGroongaライブラリの内部で、実体を確保します。
-どちらで初期化された \fI\%grn_ctx\fP も、 \fI\%grn_ctx_fin()\fP で解放できます。
-\fI\%grn_ctx_open()\fP で確保した \fI\%grn_ctx\fP 構造体に関しては、\fI\%grn_ctx_fin()\fP で解放した後に、その \fI\%grn_ctx\fP で作成した \fBgrn_obj\fP を \fBgrn_obj_close()\fP によって解放しても問題ありません。
+\fBgrn_ctx_init()\fP で初期化された \fBgrn_ctx\fP オブジェクトは構造体の実体をAPIの呼び元で確保するのに対して、 \fBgrn_ctx_open()\fP ではGroongaライブラリの内部で、実体を確保します。
+どちらで初期化された \fBgrn_ctx\fP も、 \fBgrn_ctx_fin()\fP で解放できます。
+\fBgrn_ctx_open()\fP で確保した \fBgrn_ctx\fP 構造体に関しては、\fBgrn_ctx_fin()\fP で解放した後に、その \fBgrn_ctx\fP で作成した \fBgrn_obj\fP を \fBgrn_obj_close()\fP によって解放しても問題ありません。
 .INDENT 7.0
 .TP
 .B Parameters
@@ -30126,19 +30746,19 @@ If \fBctx\fP is initialized by \fI\%grn_ctx_open()\fP not \fI\%grn_ctx_init()\fP
 .UNINDENT
 .TP
 .B Returns
-初期化された \fI\%grn_ctx\fP オブジェクトを返します。
+初期化された \fBgrn_ctx\fP オブジェクトを返します。
 .UNINDENT
 .UNINDENT
 .INDENT 0.0
 .TP
 .B grn_rc grn_ctx_close(grn_ctx\fI\ *ctx\fP)
-It calls \fI\%grn_ctx_fin()\fP and frees allocated memory for \fBctx\fP by \fI\%grn_ctx_open()\fP\&.
+It calls \fBgrn_ctx_fin()\fP and frees allocated memory for \fBctx\fP by \fBgrn_ctx_open()\fP\&.
 .INDENT 7.0
 .TP
 .B Parameters
 .INDENT 7.0
 .IP \(bu 2
-\fBctx\fP \-\- no longer needed \fI\%grn_ctx\fP\&.
+\fBctx\fP \-\- no longer needed \fBgrn_ctx\fP\&.
 .UNINDENT
 .TP
 .B Returns
@@ -30186,7 +30806,7 @@ command_versionを変更します。
 .B grn_rc grn_ctx_use(grn_ctx\fI\ *ctx\fP, grn_obj\fI\ *db\fP)
 ctxが操作対象とするdbを指定します。NULLを指定した場合は、dbを操作しない状態(init直後の状態)になります。
 .sp
-Don\(aqt use it with \fI\%grn_ctx\fP that has \fBGRN_CTX_PER_DB\fP flag.
+Don\(aqt use it with \fBgrn_ctx\fP that has \fBGRN_CTX_PER_DB\fP flag.
 .INDENT 7.0
 .TP
 .B Parameters
@@ -30289,7 +30909,7 @@ TODO...
 .INDENT 0.0
 .TP
 .B grn_db_create_optarg
-It is used for specifying options for \fI\%grn_db_create()\fP\&.
+It is used for specifying options for \fBgrn_db_create()\fP\&.
 .UNINDENT
 .INDENT 0.0
 .TP
@@ -30367,6 +30987,77 @@ objの属するdbを返します。
 .UNINDENT
 .UNINDENT
 .UNINDENT
+.INDENT 0.0
+.TP
+.B grn_rc grn_db_recover(grn_ctx\fI\ *ctx\fP, grn_obj\fI\ *db\fP)
+.sp
+\fBNOTE:\fP
+.INDENT 7.0
+.INDENT 3.5
+This is an experimental API.
+.UNINDENT
+.UNINDENT
+.sp
+\fBNOTE:\fP
+.INDENT 7.0
+.INDENT 3.5
+This is a dangerous API. You must not use this API when other
+thread or process opens the target database. If you use this API
+against shared database, the database may be broken.
+.UNINDENT
+.UNINDENT
+.sp
+New in version 4.0.9.
+
+.sp
+Checks the passed database and recovers it if it is broken and it
+can be recovered.
+.sp
+This API uses lock existence for checking whether the database is
+broken or not.
+.sp
+Here are recoverable cases:
+.INDENT 7.0
+.INDENT 3.5
+.INDENT 0.0
+.IP \(bu 2
+Index column is broken. The index column must have source column.
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.sp
+Here are unrecoverable cases:
+.INDENT 7.0
+.INDENT 3.5
+.INDENT 0.0
+.IP \(bu 2
+Object name management feature is broken.
+.IP \(bu 2
+Table is broken.
+.IP \(bu 2
+Data column is broken.
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.sp
+Object name management feature is used for managing table name,
+column name and so on. If the feature is broken, the database can\(aqt
+be recovered. Please re\-create the database from backup.
+.sp
+Table and data column can be recovered by removing an existence
+lock and re\-add data.
+.INDENT 7.0
+.TP
+.B Parameters
+.INDENT 7.0
+.IP \(bu 2
+\fBdb\fP \-\- The database to be recovered.
+.UNINDENT
+.TP
+.B Returns
+\fBGRN_SUCCESS\fP on success, not \fBGRN_SUCCESS\fP on error.
+.UNINDENT
+.UNINDENT
 .SS \fBgrn_encoding\fP
 .SS Summary
 .sp
@@ -30437,7 +31128,7 @@ is a list of what expression can do:
 .INDENT 0.0
 .IP \(bu 2
 Expression can apply some operations to a record by
-\fI\%grn_expr_exec()\fP\&.
+\fBgrn_expr_exec()\fP\&.
 .IP \(bu 2
 Expression can represents search condition. \fBgrn_table_select()\fP
 can select records that match against the search condition represented
@@ -31148,27 +31839,27 @@ objのIDに対応するレコードの値を更新します。対応するレコ
 .INDENT 2.0
 .INDENT 2.0
 .IP \(bu 2
-\fI\%GRN_OBJ_SET\fP
+\fBGRN_OBJ_SET\fP
 .IP \(bu 2
-\fI\%GRN_OBJ_INCR\fP
+\fBGRN_OBJ_INCR\fP
 .IP \(bu 2
-\fI\%GRN_OBJ_DECR\fP
+\fBGRN_OBJ_DECR\fP
 .UNINDENT
 .INDENT 2.0
 .IP \(bu 2
-\fI\%GRN_OBJ_APPEND\fP
+\fBGRN_OBJ_APPEND\fP
 .IP \(bu 2
-\fI\%GRN_OBJ_PREPEND\fP
+\fBGRN_OBJ_PREPEND\fP
 .IP \(bu 2
-\fI\%GRN_OBJ_GET\fP
+\fBGRN_OBJ_GET\fP
 .UNINDENT
 .INDENT 2.0
 .IP \(bu 2
-\fI\%GRN_OBJ_COMPARE\fP
+\fBGRN_OBJ_COMPARE\fP
 .IP \(bu 2
-\fI\%GRN_OBJ_LOCK\fP
+\fBGRN_OBJ_LOCK\fP
 .IP \(bu 2
-\fI\%GRN_OBJ_UNLOCK\fP
+\fBGRN_OBJ_UNLOCK\fP
 .UNINDENT
 .UNINDENT
 
@@ -31217,7 +31908,7 @@ objのIDに対応するレコードの値を更新します。対応するレコ
 .INDENT 0.0
 .TP
 .B GRN_OBJ_LOCK
-当該レコードをロックします。\fI\%GRN_OBJ_COMPARE\fP と共に指定された場合は、レコードの値とvalueが等しい場合に限ってロックします。
+当該レコードをロックします。\fBGRN_OBJ_COMPARE\fP と共に指定された場合は、レコードの値とvalueが等しい場合に限ってロックします。
 .UNINDENT
 .INDENT 0.0
 .TP
@@ -31259,7 +31950,7 @@ ctxが使用するdbにおいてobjに対応する名前をnameに更新しま
 .B grn_rc grn_obj_close(grn_ctx\fI\ *ctx\fP, grn_obj\fI\ *obj\fP)
 一時的なobjectであるobjをメモリから解放します。objに属するobjectも再帰的にメモリから解放されます。
 .sp
-永続的な、table, column, exprなどは解放してはいけません。一般的には、一時的か永続的かを気にしなくてよい \fI\%grn_obj_unlink()\fP を用いるべきです。
+永続的な、table, column, exprなどは解放してはいけません。一般的には、一時的か永続的かを気にしなくてよい \fBgrn_obj_unlink()\fP を用いるべきです。
 .INDENT 7.0
 .TP
 .B Parameters
@@ -31526,13 +32217,13 @@ nameに対応する新たなproc(手続き)をctxが使用するdbに定義し
 .INDENT 0.0
 .TP
 .B grn_obj *grn_proc_get_info(grn_ctx\fI\ *ctx\fP, grn_user_data\fI\ *user_data\fP, grn_expr_var\fI\ **vars\fP, unsigned int\fI\ *nvars\fP, grn_obj\fI\ **caller\fP)
-user_dataをキーとして、現在実行中の \fI\%grn_proc_func\fP 関数および定義されている変数( \fBgrn_expr_var\fP )の配列とその数を取得します。
+user_dataをキーとして、現在実行中の \fBgrn_proc_func\fP 関数および定義されている変数( \fBgrn_expr_var\fP )の配列とその数を取得します。
 .INDENT 7.0
 .TP
 .B Parameters
 .INDENT 7.0
 .IP \(bu 2
-\fBuser_data\fP \-\- \fI\%grn_proc_func\fP に渡されたuser_dataを指定します。
+\fBuser_data\fP \-\- \fBgrn_proc_func\fP に渡されたuser_dataを指定します。
 .IP \(bu 2
 \fBnvars\fP \-\- 変数の数を取得します。
 .UNINDENT
@@ -32044,7 +32735,7 @@ maxとmax_sizeが指定され、かつ、テーブルのkeyが固定長型の場
 .INDENT 0.0
 .TP
 .B grn_rc grn_table_cursor_close(grn_ctx\fI\ *ctx\fP, grn_table_cursor\fI\ *tc\fP)
-\fI\%grn_table_cursor_open()\fP で生成したcursorを解放します。
+\fBgrn_table_cursor_open()\fP で生成したcursorを解放します。
 .INDENT 7.0
 .TP
 .B Parameters
@@ -32960,6 +33651,8 @@ A table has the following limitations.
 The maximum one key size: 4096Bytes
 .IP \(bu 2
 The maximum total size of keys: 4GBytes
+.IP \(bu 2
+The maximum number of records: 268,435,455 (more than 268 million)
 .UNINDENT
 .sp
 Keep in mind that these limitations may vary depending on conditions.
@@ -32968,8 +33661,6 @@ Keep in mind that these limitations may vary depending on conditions.
 A full\-text index has the following limitations.
 .INDENT 0.0
 .IP \(bu 2
-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 268 million)
 .IP \(bu 2
 The maximum index size: 256GBytes
@@ -33386,11 +34077,9 @@ This documentation describes about how to write, generate and manage
 Groonga documentation.
 .SS Install depended software
 .sp
-Groonga uses \fI\%Sphinx\fP as documentation tool. Groonga requires newer
-Sphinx. So Groonga clones the latest Sphinx from Sphinx repository
-automatically. You need only \fI\%Mercurial\fP, \fI\%Docutils\fP and \fI\%Jinja\fP\&.
+Groonga uses \fI\%Sphinx\fP as documentation tool.
 .sp
-Here are command lines to install needed software.
+Here are command lines to install Sphinx.
 .sp
 Debian GNU/Linux, Ubuntu:
 .INDENT 0.0
@@ -33398,7 +34087,7 @@ Debian GNU/Linux, Ubuntu:
 .sp
 .nf
 .ft C
-% sudo apt\-get install \-V \-y mercurial python\-docutils python\-jinja2
+% sudo apt\-get install \-V \-y python\-sphinx
 .ft P
 .fi
 .UNINDENT
@@ -33410,7 +34099,8 @@ CentOS, Fedora:
 .sp
 .nf
 .ft C
-% sudo yum install \-y mercurial python\-docutils python\-jinja2
+% sudo yum install \-y python\-pip
+% sudo pip install sphinx
 .ft P
 .fi
 .UNINDENT
@@ -33422,9 +34112,10 @@ OS X:
 .sp
 .nf
 .ft C
-% brew install mercurial
-% pip install docutils
-% pip install jinja
+% brew install python
+% brew install gettext
+% export PATH=\(gabrew \-\-prefix gettext\(ga/bin:$PATH
+% pip install sphinx
 .ft P
 .fi
 .UNINDENT