RubyGems - rroonga - Versions diffs - 4.0.7-x64-mingw32 → 4.0.8-x64-mingw32 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (560) hide show

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

@@ -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