rroonga 5.0.5-x64-mingw32 → 5.0.8-x64-mingw32

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

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "GROONGA" "1" "2015 年 08 月 31 日" "5.0.7" "Groonga"
+.TH "GROONGA" "1" "2015 年 09 月 28 日" "5.0.8" "Groonga"
 .SH NAME
 groonga \- Groonga documentation
 .
@@ -97,7 +97,7 @@ Groonga は独自のカラムストアを持つ列指向のデータベースと
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fI\%http://packages.groonga.org/windows/groonga/groonga\-5.0.7\-x86.exe\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-5.0.8\-x86.exe\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -109,7 +109,7 @@ Groonga は独自のカラムストアを持つ列指向のデータベースと
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fI\%http://packages.groonga.org/windows/groonga/groonga\-5.0.7\-x64.exe\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-5.0.8\-x64.exe\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -124,7 +124,7 @@ Groonga は独自のカラムストアを持つ列指向のデータベースと
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fI\%http://packages.groonga.org/windows/groonga/groonga\-5.0.7\-x86.zip\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-5.0.8\-x86.zip\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -136,7 +136,7 @@ Groonga は独自のカラムストアを持つ列指向のデータベースと
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fI\%http://packages.groonga.org/windows/groonga/groonga\-5.0.7\-x64.zip\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-5.0.8\-x64.zip\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -163,7 +163,7 @@ zipアーカイブをpackages.groonga.orgからダウンロードしてくださ
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fI\%http://packages.groonga.org/source/groonga/groonga\-5.0.7.zip\fP
+\fI\%http://packages.groonga.org/source/groonga/groonga\-5.0.8.zip\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -176,7 +176,7 @@ Groongaのソースフォルダへと移動します:
 .sp
 .nf
 .ft C
-> cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-5.0.7
+> cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-5.0.8
 .ft P
 .fi
 .UNINDENT
@@ -188,7 +188,7 @@ Groongaのソースフォルダへと移動します:
 .sp
 .nf
 .ft C
-groonga\-5.0.7> cmake . \-G "Visual Studio 12 2013 Win64" \-DCMAKE_INSTALL_PREFIX=C:\eGroonga
+groonga\-5.0.8> cmake . \-G "Visual Studio 12 2013 Win64" \-DCMAKE_INSTALL_PREFIX=C:\eGroonga
 .ft P
 .fi
 .UNINDENT
@@ -200,7 +200,7 @@ groonga\-5.0.7> cmake . \-G "Visual Studio 12 2013 Win64" \-DCMAKE_INSTALL_PREFI
 .sp
 .nf
 .ft C
-groonga\-5.0.7> cmake \-\-build . \-\-config Release
+groonga\-5.0.8> cmake \-\-build . \-\-config Release
 .ft P
 .fi
 .UNINDENT
@@ -212,7 +212,7 @@ groonga\-5.0.7> cmake \-\-build . \-\-config Release
 .sp
 .nf
 .ft C
-groonga\-5.0.7> cmake \-\-build . \-\-config Release \-\-target Install
+groonga\-5.0.8> cmake \-\-build . \-\-config Release \-\-target Install
 .ft P
 .fi
 .UNINDENT
@@ -270,9 +270,9 @@ groonga\-5.0.7> cmake \-\-build . \-\-config Release \-\-target Install
 .sp
 .nf
 .ft C
-% curl \-O http://packages.groonga.org/source/groonga/groonga\-5.0.7.tar.gz
-% tar xvzf groonga\-5.0.7.tar.gz
-% cd groonga\-5.0.7
+% curl \-O http://packages.groonga.org/source/groonga/groonga\-5.0.8.tar.gz
+% tar xvzf groonga\-5.0.8.tar.gz
+% cd groonga\-5.0.8
 .ft P
 .fi
 .UNINDENT
@@ -549,9 +549,9 @@ Groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-5.0.7.tar.gz
-% tar xvzf groonga\-5.0.7.tar.gz
-% cd groonga\-5.0.7
+% wget http://packages.groonga.org/source/groonga/groonga\-5.0.8.tar.gz
+% tar xvzf groonga\-5.0.8.tar.gz
+% cd groonga\-5.0.8
 .ft P
 .fi
 .UNINDENT
@@ -745,9 +745,9 @@ Groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-5.0.7.tar.gz
-% tar xvzf groonga\-5.0.7.tar.gz
-% cd groonga\-5.0.7
+% wget http://packages.groonga.org/source/groonga/groonga\-5.0.8.tar.gz
+% tar xvzf groonga\-5.0.8.tar.gz
+% cd groonga\-5.0.8
 .ft P
 .fi
 .UNINDENT
@@ -1119,9 +1119,9 @@ Groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-5.0.7.tar.gz
-% tar xvzf groonga\-5.0.7.tar.gz
-% cd groonga\-5.0.7
+% wget http://packages.groonga.org/source/groonga/groonga\-5.0.8.tar.gz
+% tar xvzf groonga\-5.0.8.tar.gz
+% cd groonga\-5.0.8
 .ft P
 .fi
 .UNINDENT
@@ -1305,9 +1305,9 @@ Groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-5.0.7.tar.gz
-% tar xvzf groonga\-5.0.7.tar.gz
-% cd groonga\-5.0.7
+% wget http://packages.groonga.org/source/groonga/groonga\-5.0.8.tar.gz
+% tar xvzf groonga\-5.0.8.tar.gz
+% cd groonga\-5.0.8
 .ft P
 .fi
 .UNINDENT
@@ -1371,9 +1371,9 @@ Groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-5.0.7.tar.gz
-% gtar xvzf groonga\-5.0.7.tar.gz
-% cd groonga\-5.0.7
+% wget http://packages.groonga.org/source/groonga/groonga\-5.0.8.tar.gz
+% gtar xvzf groonga\-5.0.8.tar.gz
+% cd groonga\-5.0.8
 .ft P
 .fi
 .UNINDENT
@@ -1494,9 +1494,9 @@ GroongaはGNUビルドシステムを使っています。以下は一番簡単
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-5.0.7.tar.gz
-% tar xvzf groonga\-5.0.7.tar.gz
-% cd groonga\-5.0.7
+% wget http://packages.groonga.org/source/groonga/groonga\-5.0.8.tar.gz
+% tar xvzf groonga\-5.0.8.tar.gz
+% cd groonga\-5.0.8
 % ./configure
 % make
 % sudo make install
@@ -1748,12 +1748,15 @@ Groongaに関する情報を共有するための場所がいくつかありま
 Groongaに関する話題を扱うメーリングリストがあります。
 .INDENT 0.0
 .TP
-.B For English speakers
+.B 英語
 \fI\%groonga\-talk@lists.sourceforge.net\fP
 .TP
-.B For Japanese speakers
+.B 日本語
 \fI\%groonga\-dev@lists.osdn.me\fP
 .UNINDENT
+.SS チャットルーム
+.sp
+\fI\%Gitterにあるgroonga/publicチャットルーム\fP に参加してください。（英語です。）
 .SS Twitter
 .sp
 \fI\%@groonga\fP がGroonga関連情報をツイートしています。
@@ -3211,7 +3214,7 @@ select \-\-table ToyBox \-\-output_columns _key,price,weight
 .sp
 文字列型は、長さの上限によって分けることができます。詳しくは \fB/reference/types\fP を参照してください。文字列型のデフォルト値は長さ0の文字列です。
 .sp
-以下の例では、ShortText型のカラムを作成し、IDが1と2のレコードを更新します。更新しないレコードについては、デフォルト値のままとなります。
+以下の例では、 \fBShortText\fP 型のカラムを作成し、既存のレコードを更新します。3つ目のレコード（キーが \fB"Block"\fP のレコード）は更新していないのでデフォルト値（長さが0の文字列）になります。
 .sp
 実行例:
 .INDENT 0.0
@@ -3279,7 +3282,7 @@ Groonga内部では経過秒数を整数のペアで保持しています。最
 .UNINDENT
 .UNINDENT
 .sp
-以下の例では、Time型のカラムを作成し、IDが2と3のレコードを更新します。更新しないレコードについては、デフォルト値のままとなります。
+以下の例では、 \fBTime\fP 型のカラムを作成し、既存のレコードを更新します。1つ目のレコード（キーが \fB"Monkey"\fP のレコード）は更新していないのでデフォルト値（ \fB0.0\fP ）になります。
 .sp
 実行例:
 .INDENT 0.0
@@ -3348,7 +3351,7 @@ select \-\-table ToyBox \-\-output_columns _key,time
 .sp
 小数点を含んでいなければミリ秒表記、小数点を含んでいれば度数表記として扱われます。ミリ秒表記と度数表記を混ぜたときの動作は未定義なので注意してください。経度と緯度の区切りとしては、\(aqx\(aq のほかに \(aq,\(aq を使うことができます。経緯度のデフォルト値は "0x0" です。
 .sp
-以下の例では、世界測地系を用いるWGS84GeoPoint型のカラムを作成し、IDが1と3のレコードを更新します。更新しないレコードについては、デフォルト値のままとなります。
+以下の例では、世界測地系を用いる \fBWGS84GeoPoint\fP 型のカラムを作成し、既存のレコードを更新します。2つ目のレコード（キーが \fB"Flower"\fP のレコード）は更新していないのでデフォルト値（ \fB"0x0"\fP ）になります。
 .sp
 実行例:
 .INDENT 0.0
@@ -3409,9 +3412,9 @@ select \-\-table ToyBox \-\-output_columns _key,location
 .sp
 Groongaでは、テーブル参照のカラム、すなわち関連付けたテーブルを参照するカラムを作成できます。より正確には、カラム作成時に参照先となるテーブルとの関連付けをおこない、参照先テーブルにおけるレコードIDを格納しておくことにより、参照先のレコードにアクセスできるようにします。
 .sp
-テーブル参照のカラムがあるときは、 \fB/reference/commands/select\fP コマンドの \fIoutput_columns\fP 引数に "参照元カラム.参照先カラム" と指定することにより、参照先カラムの値を取り出すことができます。参照元カラムのみを指定したときは、 "参照元カラム名._key" と同様の扱いとなり、参照先レコードの主キーが取り出されます。テーブル参照が有効なレコードを指していないときは、 \fB/reference/commands/select\fP コマンドは参照先カラムのデフォルト値を取り出すようになっています。
+テーブル参照のカラムがあるときは、 \fB/reference/commands/select\fP コマンドの \fBoutput_columns\fP 引数に \fB参照元カラム.参照先カラム\fP と指定することにより、参照先カラムの値を取り出すことができます。参照元カラムのみを指定したときは、 \fB参照元カラム名._key\fP と同様の扱いとなり、参照先レコードの主キーが取り出されます。テーブル参照が有効なレコードを指していないときは、 \fB/reference/commands/select\fP コマンドは参照先カラムのデフォルト値を取り出すようになっています。
 .sp
-ここでは、先のチュートリアルで作成したSiteテーブルにlinkという新たなカラムを作成し、サイト間のリンク関係を保存できるようにしてみましょう。
+ここでは、 tutorial\-introduction\-create\-table で作成した \fBSite\fP テーブルに参照カラムを作成します。作成する参照カラムは \fBlink\fP という名前にします。このカラムには \fBSite\fP テーブルのレコード間でのリンク関係を保存します。
 .sp
 実行例:
 .INDENT 0.0
@@ -3602,7 +3605,7 @@ _id <= 1
 .UNINDENT
 .UNINDENT
 .sp
-このケースでは、 \fB_id\fP の値が1であるという条件に合致するレコードを返します。
+このケースでは、 \fB_id\fP の値が1以下であるという条件に合致するレコードを返します。
 .sp
 また、 \fB&&\fP や \fB||\fP を使って、条件のAND・OR指定をすることもできます。
 .sp
@@ -5702,7 +5705,7 @@ select \-\-table Blog2 \-\-match_columns title \-\-query message
 \fB注釈:\fP
 .INDENT 0.0
 .INDENT 3.5
-"インデックスはどちらがよい方法なのか"と疑問に思うかも知れません。それは場合によります。
+"インデックスはどちらがよい方法なのか"と疑問に思うかもしれません。それは場合によります。
 .INDENT 0.0
 .IP \(bu 2
 カラムごとのインデックス \- マルチカラムインデックスよりも更新性能が良い傾向があります。一方、ディスク使用効率はあまり良くありません。
@@ -10442,7 +10445,7 @@ center;
 |l|l|l|.
 _
 T{
-Key
+キー
 T}	T{
 説明
 T}	T{
@@ -10470,7 +10473,7 @@ center;
 |l|l|l|.
 _
 T{
-Key
+キー
 T}	T{
 説明
 T}	T{
@@ -10508,7 +10511,7 @@ center;
 |l|l|l|.
 _
 T{
-Key
+キー
 T}	T{
 説明
 T}	T{
@@ -10530,7 +10533,7 @@ center;
 |l|l|l|.
 _
 T{
-Key
+キー
 T}	T{
 説明
 T}	T{
@@ -11523,7 +11526,7 @@ cache_limit
 .UNINDENT
 .UNINDENT
 .sp
-\fBmax\fP 引数を使うと、指定したあたいに設定される前の最大キャッシュエントリー数が戻り値になります。
+\fBmax\fP 引数を使うと、指定した値に設定される前の最大キャッシュエントリー数が戻り値になります。
 .SS 引数
 .sp
 このセクションではすべての引数について説明します。
@@ -12578,7 +12581,7 @@ select FromTable \-\-output_columns _key,from_column,to_column
 .sp
 \fBto_table\fP に \fBTABLE_NO_KEY\fP テーブルを指定することはできません。なぜなら、レコードのキーがないとGroongaはコピー先のレコードを特定できないからです。
 .sp
-例外が1つあります。 \fBfrom_table\fP と \fBto_table\fP に同じテーブル名を指定した場合は、 \fBto_table\fP に \fBTABLE_NO_KEY\fP テーブルを指定できます。なぜなら、コピー元テーブルとコピー先テーブルが同じテーブルならGroongaはコピー先のレコードを得適できるからです。
+例外が1つあります。 \fBfrom_table\fP と \fBto_table\fP に同じテーブル名を指定した場合は、 \fBto_table\fP に \fBTABLE_NO_KEY\fP テーブルを指定できます。なぜなら、コピー元テーブルとコピー先テーブルが同じテーブルならGroongaはコピー先のレコードを特定できるからです。
 .sp
 \fBto_table\fP を使った例です。
 .sp
@@ -13483,7 +13486,7 @@ select Users
 \fB注釈:\fP
 .INDENT 0.0
 .INDENT 3.5
-通常、 \fBdatabase_unmap\fP を使う必要はありません。なぜなら、OSが賢くメモリーを管理してくれるからです。もし、システムの残メモリーが少なくなったら、OSはGroongaが使っているメモリーをディスクに退避します。対比したメモリーは必要になったらまたメモリーに戻します。OSは使っていないメモリーを優先して退避します。
+通常、 \fBdatabase_unmap\fP を使う必要はありません。なぜなら、OSが賢くメモリーを管理してくれるからです。もし、システムの残メモリーが少なくなったら、OSはGroongaが使っているメモリーをディスクに退避します。退避したメモリーは必要になったらまたメモリーに戻します。OSは使っていないメモリーを優先して退避します。
 .UNINDENT
 .UNINDENT
 .sp
@@ -13587,7 +13590,7 @@ database_unmap
 .sp
 define_selector \- 検索コマンドを定義
 .sp
-Groonga組込コマンドの一つであるdefine_selectorについて説明します。組込コマンドは、groonga実行ファイルの引数>、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるdefine_selectorについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 define_selectorは、検索条件をカスタマイズした新たな検索コマンドを定義します。
 .SS 構文
@@ -15121,7 +15124,7 @@ debug
 .sp
 log_put \- ログ出力
 .sp
-groonga組込コマンドの一つであるlog_putについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入>力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+groonga組込コマンドの一つであるlog_putについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 log_putは、ログにmessageを出力します。
 .SS 構文
@@ -15201,8 +15204,7 @@ debug
 .sp
 log_reopen \- ログファイルの再読み込み
 .sp
-Groonga組込コマンドの一つであるlog_reopenについて説明します。組込コマンドは、groonga実行ファイルの引数、標準
-入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるlog_reopenについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 log_reopenは、ログファイルを再読み込みします。
 .sp
@@ -15314,7 +15316,7 @@ logical_count logical_table
 .sp
 \fBlogical_count\fP コマンドを使うには事前に \fBsharding\fP プラグインを登録します。
 .sp
-\fBlogical_count\fP コマンドは実験的なプラグインです。このコマンドは将来的に変更されるかも知れません。
+\fBlogical_count\fP コマンドは実験的なプラグインです。このコマンドは将来的に変更されるかもしれません。
 .sp
 この機能を使う簡単な例を示します。複数のテーブルに保存されている特定のログをカウントしてみましょう。
 .sp
@@ -18297,7 +18299,7 @@ TODO
 .INDENT 3.5
 このコマンドは実験的な機能です。
 .sp
-このコマンドは将来的に変更されるかも知れません。
+このコマンドは将来的に変更されるかもしれません。
 .UNINDENT
 .UNINDENT
 .SS 概要
@@ -18834,11 +18836,9 @@ plugin_unregister query_expanders/tsv
 .sp
 quit \- セッション終了
 .sp
-Groonga組込コマンドの一つであるquitについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、
-またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるquitについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
-quitは、groongaプロセスとのセッションを終了します。クライアントプロセスならばgroongaプロセスとの接続を切りま
-す。
+quitは、groongaプロセスとのセッションを終了します。クライアントプロセスならばgroongaプロセスとの接続を切ります。
 .SS 構文
 .INDENT 0.0
 .INDENT 3.5
@@ -19134,7 +19134,7 @@ ruby_eval script
 .sp
 \fBruby_eval\fP を使うと、mrubyがサポートしているスクリプトを実行できます。
 .sp
-Ruby \fB1 + 2\fP という計算するだけの例です。
+Rubyスクリプトとして \fB1 + 2\fP という計算するだけの例です。
 .sp
 実行例:
 .INDENT 0.0
@@ -19153,7 +19153,7 @@ ruby_eval "1 + 2"
 .sp
 \fBruby_eval\fP コマンドを使うには事前に \fBruby/eval\fP プラグインを登録します。
 .sp
-\fBruby_eval\fP コマンドは実験的なプラグインです。このコマンドは将来的に変更されるかも知れません。
+\fBruby_eval\fP コマンドは実験的なプラグインです。このコマンドは将来的に変更されるかもしれません。
 .SS 引数
 .sp
 このセクションではすべての引数について説明します。
@@ -19211,7 +19211,7 @@ ruby_load path
 .sp
 \fBruby_load\fP を使ってmrubyがサポートしているスクリプトを読み込むことができます。
 .sp
-Rubyスクリプトとして \fBexpression.rb\fP を単に読むこむ例です。
+Rubyスクリプトとして \fBexpression.rb\fP を単に読み込む例です。
 .sp
 実行例:
 .INDENT 0.0
@@ -19230,7 +19230,7 @@ ruby_load "expression.rb"
 .sp
 \fBruby_load\fP コマンドを使うには事前に \fBruby/load\fP プラグインを登録します。
 .sp
-\fBruby_load\fP コマンドは実験的なプラグインです。このコマンドは将来的に変更されるかも知れません。
+\fBruby_load\fP コマンドは実験的なプラグインです。このコマンドは将来的に変更されるかもしれません。
 .SS 引数
 .sp
 このセクションではすべての引数について説明します。
@@ -19987,7 +19987,7 @@ select Nonexistent
 \fBquery\fP と \fBfilter\fP を指定した場合は、 \fBquery\fP と \fBfilter\fP にマッチしたレコードが選択されます。 \fBquery\fP と \fBfilter\fP のどちらも指定しなかった場合はすべてのレコードが選択されます。
 .SS \fBmatch_columns\fP
 .sp
-\fBquery\fP 引数の値で全文検索をするときに使うデフォルトの検索対象カラムを指定します。全文検索対象のカラムは \fBquery\fP 引数でも指定できます。検索対象カラムを \fBmatch_columns\fP で指定する場合と \fBquery\fP で指定する場合の違いは重みを指定できるかどうかです。 \fBmatch_columns\fP では重みを指定できますが、 \fBquery\fP では指定できません。
+\fBquery\fP 引数の値で全文検索をするときに使うデフォルトの検索対象カラムを指定します。全文検索対象のカラムは \fBquery\fP 引数でも指定できます。検索対象カラムを \fBmatch_columns\fP で指定する場合と \fBquery\fP で指定する場合の違いは重みとスコアー関数を指定できるかどうかです。 \fBmatch_columns\fP では指定できますが、 \fBquery\fP では指定できません。
 .sp
 重みは検索対象カラムの相対的な重要度です。重みの大きい検索対象カラムでマッチした場合は小さい検索対象カラムでマッチした場合よりも多くのヒットスコアがつきます。デフォルトの重みは1です。
 .sp
@@ -20136,6 +20136,10 @@ select Entries \-\-match_columns \(aq_key * 10 || content\(aq \-\-query groonga
 .UNINDENT
 .sp
 \fB\-\-match_columns \(aq_key * 10 || content\(aq\fP はデフォルト検索対象カラムが \fB_key\fP カラムと \fBcontent\fP カラムで、 \fB_key\fP カラムの重みは10、 \fBcontent\fP カラムの重みは1という意味です。この重み付けは \fB_key\fP カラムの値は \fBcontent\fP カラムの値よりも重要だという意味になります。この例では、ブログエントリのタイトルはブログエントリの内容よりも重要だということです。
+.sp
+スコアー関数を指定することもできます。詳細は \fB/reference/scorer\fP を参照してください。
+.sp
+スコアー関数と \fI\%scorer\fP パラメーターは関係ないので注意してください。
 .SS \fBquery\fP
 .sp
 クエリーテキストを指定します。通常、全文検索をするために \fBmatch_columns\fP 引数と一緒に使います。 \fBquery\fP 引数はWebページにある全文検索フォームで使いやすいように設計されています。クエリーテキストは \fB/reference/grn_expr/query_syntax\fP という書式を使います。この書式はGoogleの検索フォームのように一般的な検索フォームと似ています。例えば、 \fBword1 word2\fP は \fBword1\fP と \fBword2\fP を含んでいるレコードを検索するという意味になります。 \fBword1 OR word2\fP は \fBword1\fP または \fBword2\fP を含んでいるレコードを検索するという意味になります。
@@ -21335,8 +21339,7 @@ select Entries \-\-output_columns \(aq_id, _key\(aq \-\-limit 1
 .sp
 この \fBselect\fP コマンドは \fB_id\fP と \fB_key\fP カラムの値だけを出力します。
 .sp
-\fB*\fP is a special value. It means that all columns that are not
-\fB/reference/columns/pseudo\fP\&.
+\fB*\fP は特別な値で \fB/reference/columns/pseudo\fP 以外のすべてのカラムという意味です。
 .sp
 以下は \fB*\fP の使用例です。
 .sp
@@ -24993,12 +24996,12 @@ shutdown
 .SS \fBstatus\fP
 .SS 概要
 .sp
-status \- groongaプロセスの状態表示
-.sp
-Groonga組込コマンドの一つであるstatusについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+\fBstatus\fP はこのリクエストを処理しているコンテキストの現在のステータスを返します。
 .sp
-statusコマンドは、groongaプロセスの状態を表示します。主にgroongaサーバプロセスに対して使用することを想定しています。
+コンテキストはリクエストを処理する単位です。通常、各スレッドごとにコンテキストを作ります。
 .SS 構文
+.sp
+このコマンドに引数はありません:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -25011,6 +25014,8 @@ status
 .UNINDENT
 .SS 使い方
 .sp
+以下は簡単な使用例です。
+.sp
 実行例:
 .INDENT 0.0
 .INDENT 3.5
@@ -25025,56 +25030,194 @@ status
 #     0.000355720520019531
 #   ],
 #   {
-#     "uptime": 1,
+#     "uptime": 0,
 #     "max_command_version": 2,
-#     "n_queries": 0,
+#     "start_time": 1441980651,
 #     "cache_hit_rate": 0.0,
-#     "version": "5.0.6\-128\-g8029ddb",
+#     "version": "5.0.7\-126\-gb6fd7f7",
 #     "alloc_count": 206,
 #     "command_version": 1,
-#     "starttime": 1439994621,
-#     "default_command_version": 1
+#     "starttime": 1441980651,
+#     "default_command_version": 1,
+#     "n_queries": 0
 #   }
 # ]
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
+.sp
+このリクエストを処理しているコンテキストの現在のステータスを返します。詳細は \fI\%戻り値\fP を参照してください。
 .SS 引数
 .sp
-ありません。
+このセクションではすべての引数について説明します。
+.SS 必須引数
+.sp
+必須の引数はありません。
+.SS 省略可能引数
+.sp
+省略可能な引数はありません。
 .SS 戻り値
+.sp
+このコマンドはオブジェクトとして現在のステータスを返します。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-下記の項目がハッシュ形式で出力されます。
+[
+  HEADER,
+  {
+    "alloc_count": ALLOC_COUNT,
+    "cache_hit_rate": CACHE_HIT_RATE,
+    "command_version": COMMAND_VERSION,
+    "default_command_version": DEFAULT_COMMAND_VERSION,
+    "max_command_version": MAX_COMMAND_VERSION,
+    "n_queries": N_QUERIES,
+    "start_time": START_TIME,
+    "starttime": STARTTIME,
+    "uptime": UPTIME,
+    "version": VERSION
+  }
+]
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
+\fBHEADER\fP については \fB/reference/command/output_format\fP を参照してください。
+.sp
+以下は値の説明です。実際の値は \fI\%使い方\fP を参照してください。
+.TS
+center;
+|l|l|l|.
+_
+T{
+キー
+T}	T{
+説明
+T}	T{
+例
+T}
+_
+T{
 \fBalloc_count\fP
-.INDENT 0.0
-.INDENT 3.5
-groongaプロセスの内部でアロケートされ、まだ解放されてないメモリブロックの数を示します。Groongaをbuildする際に、configureオプションで \-\-enable\-exact\-alloc\-countが指定されていたならば、正確な値を返します。それ以外の場合は不正確な値を返す場合があります。
-.UNINDENT
-.UNINDENT
+T}	T{
+まだ解放されていないメモリーブロックの数です。もし、この値が継続的に増えていっているならメモリーリークがあるかもしれません。
+T}	T{
+\fB1400\fP
+T}
+_
+T{
+\fBcache_hit_rate\fP
+T}	T{
+このGroongaプロセスがキャッシュを使って返したレスポンスの割合です。もし、10リクエストのうち7つのレスポンスはキャッシュを使ったなら、 \fBcache_hit_rate\fP は \fB70.0\fP になります。この割合はキャッシュをサポートしているコマンドを使ったリクエストのみで計算します。
 .sp
-開始時間
+以下はキャッシュをサポートしているコマンドです。
 .INDENT 0.0
 .INDENT 3.5
-groongaプロセスが起動した時刻のtvsec値を返します。
+.INDENT 0.0
+.IP \(bu 2
+\fBselect\fP
+.IP \(bu 2
+\fBlogical_select\fP
+.IP \(bu 2
+\fBlogical_range_filter\fP
+.IP \(bu 2
+\fBlogical_count\fP
+.UNINDENT
 .UNINDENT
 .UNINDENT
+T}	T{
+\fB29.4\fP
+T}
+_
+T{
+\fBcommand_version\fP
+T}	T{
+このコンテキストが使っている \fB/reference/command/command_version\fP です。
+T}	T{
+\fB1\fP
+T}
+_
+T{
+\fBdefault_command_version\fP
+T}	T{
+このGroongaプロセスのデフォルト \fB/reference/command/command_version\fP です。
+T}	T{
+\fB1\fP
+T}
+_
+T{
+\fBmax_command_version\fP
+T}	T{
+このGroongaプロセスがサポートしている最大 \fB/reference/command/command_version\fP です。
+T}	T{
+\fB2\fP
+T}
+_
+T{
+\fBn_queries\fP
+T}	T{
+このGroongaプロセスが処理したリクエスト数です。ただし、キャッシュをサポートしたコマンドを使ったリクエストだけを数えます。
 .sp
-稼動時間
+以下はキャッシュをサポートしているコマンドです。
 .INDENT 0.0
 .INDENT 3.5
-groongaプロセスが起動してから経過した秒数を返します。
+.INDENT 0.0
+.IP \(bu 2
+\fBselect\fP
+.IP \(bu 2
+\fBlogical_select\fP
+.IP \(bu 2
+\fBlogical_range_filter\fP
+.IP \(bu 2
+\fBlogical_count\fP
 .UNINDENT
 .UNINDENT
+.UNINDENT
+T}	T{
+\fB29\fP
+T}
+_
+T{
+\fBstart_time\fP
+T}	T{
+バージョン 5.0.8 で追加.
+
+.sp
+このGroongaプロセスが起動した時間です。UNIX時間です。
+T}	T{
+\fB1441761403\fP
+T}
+_
+T{
+\fBstarttime\fP
+T}	T{
+バージョン 5.0.8 で撤廃: 代わりに \fBstart_time\fP を使ってください。
+T}	T{
+\fB1441761403\fP
+T}
+_
+T{
+\fBuptime\fP
+T}	T{
+このGroongaプロセスが起動してから経過した時間です。単位は秒です。
+.sp
+たとえば、 \fB216639\fP は \fB2.5\fP （= \fB216639 / 60 / 60 / 24 = 2.507\fP ）日という意味です。
+T}	T{
+\fB216639\fP
+T}
+_
+T{
+\fBversion\fP
+T}	T{
+このGroongaプロセスのバージョンです。
+T}	T{
+\fB5.0.7\fP
+T}
+_
+.TE
 .SS \fBsuggest\fP
 .sp
 \fB注釈:\fP
@@ -25956,8 +26099,7 @@ Groonga 2.1.0から \fBKEY_NORMALIZE\fP フラグは非推奨になりました
 .sp
 table_list \- DBに定義されているテーブルをリスト表示
 .sp
-Groonga組込コマンドの一つであるtable_listについて説明します。組込コマンドは、groonga実行ファイルの引数、標準
-入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるtable_listについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 table_listは、DBに定義されているテーブルのリストを表示します。
 .SS 構文
@@ -26151,12 +26293,10 @@ valueが属する型
 .SS \fBtable_remove\fP
 .SS 概要
 .sp
-table_remove \- テーブルの削除
-.sp
-groonga組込コマンドの一つであるtable_removeについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
-.sp
-table_removeはテーブルと定義されているカラムを削除します。カラムに付随するインデックスも再帰的に削除されます。
+\fBtable_remove\fP はテーブルとそのカラムを削除します。もし、テーブルのキーあるいはそのテーブルのカラムにインデックスが張ってある場合はそれらも削除されます。
 .SS 構文
+.sp
+このコマンドの引数は1つで必須です:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -26168,42 +26308,406 @@ table_remove name
 .UNINDENT
 .UNINDENT
 .SS 使い方
+.sp
+削除したいテーブルの名前を指定するだけです。 \fBtable_remove\fP は指定されたテーブルとそのテーブルのカラムを削除します。もし、テーブルとそのテーブルのカラムにインデックスが張ってある場合は、張ってあるすべてのインデックスも削除します。
+.sp
+このセクションでは次のことについて説明します。
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.IP \(bu 2
+基本的な使い方
+.IP \(bu 2
+削除できないケース
+.IP \(bu 2
+利用リソースの削減
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.SS 基本的な使い方
+.sp
+次のケースを考えてみましょう。
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.IP \(bu 2
+\fBEntries\fP というテーブルがあります。
+.IP \(bu 2
+\fBEntries\fP テーブルにはいくつかカラムがあります。
+.IP \(bu 2
+\fBEntries\fP テーブルのキーにはインデックスが張ってあります。
+.IP \(bu 2
+\fBEntries\fP のあるカラムにはインデックスが張ってあります。
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.sp
+以下は \fBEntries\fP テーブルを作成するコマンドです。
+.sp
+実行例:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-table_remove Entry
-
-[true]
+table_create Entries TABLE_HASH_KEY UInt32
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Entries title COLUMN_SCALAR ShortText
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Entries content COLUMN_SCALAR Text
+# [[0, 1337566253.89858, 0.000355720520019531], true]
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
-.SS 引数
+.sp
+以下は \fBEntries\fP テーブルのキーにインデックスを張るコマンドです。
+.sp
+実行例:
 .INDENT 0.0
-.TP
-.B \fBname\fP
-削除対象のカラムが定義されているテーブルの名前を指定します。
+.INDENT 3.5
+.sp
+.nf
+.ft C
+table_create EntryKeys TABLE_HASH_KEY UInt32
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create EntryKeys key_index COLUMN_INDEX Entries _key
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+.ft P
+.fi
 .UNINDENT
-.SS 戻り値
+.UNINDENT
+.sp
+以下は \fBEntries\fP テーブルのカラムにインデックスを張るコマンドです。
+.sp
+実行例:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-[成功かどうかのフラグ]
+table_create Terms TABLE_PAT_KEY ShortText \e
+  \-\-default_tokenizer TokenBigram \e
+  \-\-normalizer NormalizerAuto
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Terms content_index COLUMN_INDEX Entries content
+# [[0, 1337566253.89858, 0.000355720520019531], true]
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-\fB成功かどうかのフラグ\fP
+\fBtable_remove\fP を実行する前に現在のスキーマを確認しましょう。
+.sp
+実行例:
 .INDENT 0.0
 .INDENT 3.5
-エラーが生じなかった場合にはtrue、エラーが生じた場合にはfalseを返す。
+.sp
+.nf
+.ft C
+dump
+# table_create Entries TABLE_HASH_KEY UInt32
+# column_create Entries content COLUMN_SCALAR Text
+# column_create Entries title COLUMN_SCALAR ShortText
+#
+# table_create EntryKeys TABLE_HASH_KEY UInt32
+#
+# table_create Terms TABLE_PAT_KEY ShortText \-\-default_tokenizer TokenBigram \-\-normalizer NormalizerAuto
+#
+# column_create EntryKeys key_index COLUMN_INDEX Entries _key
+# column_create Terms content_index COLUMN_INDEX Entries content
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+\fBEntries\fP テーブルを削除すると、次のテーブルとカラムが削除されます。
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.IP \(bu 2
+\fBEntries\fP
+.IP \(bu 2
+\fBEntries.title\fP
+.IP \(bu 2
+\fBEntries.context\fP
+.IP \(bu 2
+\fBEntryKeys.key_index\fP
+.IP \(bu 2
+\fBTerms.content_index\fP
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.sp
+次のテーブル（語彙表）は削除されません。
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.IP \(bu 2
+\fBEntryKeys\fP
+.IP \(bu 2
+\fBTerms\fP
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.sp
+\fBtable_remove\fP を実行しましょう。
+.sp
+実行例:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+table_remove Entries
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+以下が \fBtable_remove\fP 実行後のスキーマです。 \fBEntryKeys\fP と \fBTerms\fP だけが残っています。
+.sp
+実行例:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+dump
+# table_create EntryKeys TABLE_HASH_KEY UInt32
+#
+# table_create Terms TABLE_PAT_KEY ShortText \-\-default_tokenizer TokenBigram \-\-normalizer NormalizerAuto
+.ft P
+.fi
 .UNINDENT
 .UNINDENT
+.SS 削除できないケース
+.sp
+以下は削除できないケースです。
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.IP \(bu 2
+1つ以上のテーブルがこの削除対象のテーブルをキーの型として使っている。
+.IP \(bu 2
+1つ以上のカラムがこの削除対象のテーブルを値の型として使っている。
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.sp
+どちらのケースも参照先がなくなることを防ぎます。もし、削除対象のテーブルが型として参照されているままそのテーブルが削除されてしまうと、そのテーブルを参照しているテーブルとカラムは壊れてしまいます。
+.sp
+もし、削除対象のテーブルがどれかの条件を満たしたら \fBtable_remove\fP は失敗します。削除対象のテーブルも削除対象のテーブルのカラムも削除されません。
+.sp
+以下は削除対象のテーブルがキーの型に使われるケースの例です。
+.sp
+次のコマンドは削除対象のテーブルとそのテーブルをキーの型として使うテーブルを作成します。
+.sp
+実行例:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+table_create ReferencedByTable TABLE_HASH_KEY ShortText
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+table_create ReferenceTable TABLE_HASH_KEY ReferencedByTable
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+\fBReferencedByTable\fP に対する \fBtable_remove\fP は失敗します。
+.sp
+実行例:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+table_remove ReferencedByTable
+# [
+#   [
+#     \-2,
+#     1337566253.89858,
+#     0.000355720520019531,
+#     "[table][remove] a table that references the table exists: <ReferenceTable._key> \-> <ReferencedByTable>",
+#     [
+#       [
+#         "is_removable_table",
+#         "db.c",
+#         8480
+#       ]
+#     ]
+#   ],
+#   false
+# ]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+\fBReferencedByTable\fP を削除する前に \fBReferenceTable\fP を削除する必要があります。
+.sp
+実行例:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+table_remove ReferenceTable
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+table_remove ReferencedByTable
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+以下は削除対象のテーブルが値の型に使われるケースの例です。
+.sp
+次のコマンドは削除対象のテーブルとそのテーブルを値の型として使うカラムを作成します。
+.sp
+実行例:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+table_create ReferencedByColumn TABLE_HASH_KEY ShortText
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+table_create Table TABLE_NO_KEY
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Table reference_column COLUMN_SCALAR ReferencedByColumn
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+\fBReferencedByColumn\fP に対する \fBtable_remove\fP は失敗します。
+.sp
+実行例:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+table_remove ReferencedByColumn
+# [
+#   [
+#     \-2,
+#     1337566253.89858,
+#     0.000355720520019531,
+#     "[table][remove] a column that references the table exists: <Table.reference_column> \-> <ReferencedByColumn>",
+#     [
+#       [
+#         "is_removable_table",
+#         "db.c",
+#         8500
+#       ]
+#     ]
+#   ],
+#   false
+# ]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+\fBReferencedByColumn\fP を削除する前に \fBTable.reference_column\fP を削除する必要があります。
+.sp
+実行例:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+column_remove Table reference_column
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+table_remove ReferencedByColumn
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS 利用リソースの削減
+.sp
+\fBtable_remove\fP は \fI\%削除できないケース\fP のチェックをするためにデータベース内のすべてのテーブルとカラムを開きます。
+.sp
+もし、大量のテーブルとカラムがある場合、 \fBtable_remove\fP はたくさんのリソースを使うかもしれません。このケース用の回避策があります。
+.sp
+\fBtable_remove\fP は最大スレッド数が \fB1\fP のときはチェック用に一時的に開いたテーブルとカラムを閉じます。
+.sp
+\fBthread_limit\fP を使うと現在の最大スレッド数を確認・変更できます。
+.sp
+この機能は次のケースでは使われます。
+.sp
+実行例:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+table_create Entries TABLE_NO_KEY
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+thread_limit 2
+# [[0, 1337566253.89858, 0.000355720520019531], 1]
+table_remove Entries
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+この機能は次のケースでは使われません。
+.sp
+実行例:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+table_create Entries TABLE_NO_KEY
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+thread_limit 2
+# [[0, 1337566253.89858, 0.000355720520019531], 1]
+table_remove Entries
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS 引数
+.sp
+このセクションではすべての引数について説明します。
+.SS 必須引数
+.sp
+1つだけ必須の引数があります。
+.SS \fBname\fP
+.sp
+削除するテーブルの名前を指定します。
+.sp
+このパラメーターの使い方は \fI\%使い方\fP を参照してください。
+.SS 戻り値
+.sp
+このコマンドが成功したときは以下のようにボディは \fBtrue\fP になります:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+[HEADER, true]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+このコマンドが失敗すると、 \fBHEADER\fP にエラーの詳細が含まれます。
+.sp
+\fBHEADER\fP については \fB/reference/command/output_format\fP を参照してください。
 .SS \fBtable_rename\fP
 .SS 概要
 .sp
@@ -28089,138 +28593,68 @@ Groongaのデータベースでは、テーブルの主キーや、カラムの
 .SS 組込型
 .sp
 以下の型が組込型としてあらかじめ定義されています。
+.SS \fBBool\fP
 .sp
-\fBObject\fP
-.INDENT 0.0
-.INDENT 3.5
-以下の型が組込型としてあらかじめ定義されています。 [1]
-.UNINDENT
-.UNINDENT
-.sp
-\fBBool\fP
-.INDENT 0.0
-.INDENT 3.5
 ブーリアン型やブール型などと呼ばれる型であり、真偽値を表します。取り得る値はtrueとfalseです。（デフォルト値: false）
 .sp
 \fB/reference/commands/load\fP コマンドで値を格納するときは、false、0、空文字列のいずれかを指定するとfalseになり、それ以外を指定するとtrueになります。
-.UNINDENT
-.UNINDENT
+.SS \fBInt8\fP
 .sp
-\fBInt8\fP
-.INDENT 0.0
-.INDENT 3.5
 8bit符号付き整数であり、\-128以上127以下の整数を表します。（デフォルト値: 0）
-.UNINDENT
-.UNINDENT
+.SS \fBUInt8\fP
 .sp
-\fBUInt8\fP
-.INDENT 0.0
-.INDENT 3.5
 8bit符号なし整数であり、0以上255以下の整数を表します。（デフォルト値: 0）
-.UNINDENT
-.UNINDENT
+.SS \fBInt16\fP
 .sp
-\fBInt16\fP
-.INDENT 0.0
-.INDENT 3.5
 16bit符号付き整数であり、\-32,768以上32,767以下の整数を表します。（デフォルト値: 0）
-.UNINDENT
-.UNINDENT
+.SS \fBUInt16\fP
 .sp
-\fBUInt16\fP
-.INDENT 0.0
-.INDENT 3.5
 16bit符号なし整数であり、0以上65,535以下の整数を表します。（デフォルト値: 0）
-.UNINDENT
-.UNINDENT
+.SS \fBInt32\fP
 .sp
-\fBInt32\fP
-.INDENT 0.0
-.INDENT 3.5
 32bit符号付き整数であり、\-2,147,483,648以上2,147,483,647以下の整数を表します。（デフォルト値: 0）
-.UNINDENT
-.UNINDENT
+.SS \fBUInt32\fP
 .sp
-\fBUInt32\fP
-.INDENT 0.0
-.INDENT 3.5
 32bit符号なし整数であり、0以上4,294,967,295以下の整数を表します。（デフォルト値: 0）
-.UNINDENT
-.UNINDENT
+.SS \fBInt64\fP
 .sp
-\fBInt64\fP
-.INDENT 0.0
-.INDENT 3.5
 64bit符号付き整数であり、\-9,223,372,036,854,775,808以上9,223,372,036,854,775,807以下の整数を表します。（デフォルト値: 0）
-.UNINDENT
-.UNINDENT
+.SS \fBUInt64\fP
 .sp
-\fBUInt64\fP
-.INDENT 0.0
-.INDENT 3.5
 64bit符号なし整数であり、0以上18,446,744,073,709,551,615以下の整数を表します。（デフォルト値: 0）
-.UNINDENT
-.UNINDENT
+.SS \fBFloat\fP
 .sp
-\fBFloat\fP
-.INDENT 0.0
-.INDENT 3.5
 IEEE 754形式の倍精度浮動小数点数であり、実数を表します。（デフォルト値: 0.0）
 .sp
 IEEE 754形式の詳細については、 \fI\%IEEE 754 \- Wikipedia\fP や \fI\%IEEE 754: Standard for Binary Floating\-Point\fP を参照してください。
-.UNINDENT
-.UNINDENT
+.SS \fBTime\fP
 .sp
-\fBTime\fP
-.INDENT 0.0
-.INDENT 3.5
 日時を表す型であり、1970年1月1日0時0分0秒からの経過時間を、マイクロ秒単位で64bit符号付き整数により表現します。（デフォルト値: 0）
 .sp
 \fB/reference/commands/load\fP コマンドで値を格納するときは、1970年1月1日0時0分0秒からの経過秒数を指定します。秒単位より詳細な日時を指定するには、小数を使います。
-.UNINDENT
-.UNINDENT
+.SS \fBShortText\fP
 .sp
-\fBShortText\fP
-.INDENT 0.0
-.INDENT 3.5
 4,095バイト以下の文字列を表します。（デフォルト値: ""）
-.UNINDENT
-.UNINDENT
+.SS \fBText\fP
 .sp
-\fBText\fP
-.INDENT 0.0
-.INDENT 3.5
 65,535バイト以下の文字列を表します。（デフォルト値: ""）
-.UNINDENT
-.UNINDENT
+.SS \fBLongText\fP
 .sp
-\fBLongText\fP
-.INDENT 0.0
-.INDENT 3.5
 2,147,483,647バイト以下の文字列を表します。（デフォルト値: ""）
-.UNINDENT
-.UNINDENT
+.SS \fBTokyoGeoPoint\fP
 .sp
-\fBTokyoGeoPoint\fP
-.INDENT 0.0
-.INDENT 3.5
 旧日本測地系による経緯度であり、経度と緯度をミリ秒単位で表現した整数の組により表現します。（デフォルト値: 0x0）
 .sp
 度分秒形式でx度y分z秒となる経度・緯度は、(((x * 60) + y) * 60 + z) * 1000という計算式でミリ秒単位へと変換されます。
+.sp
 \fB/reference/commands/load\fP コマンドで値を格納するときは、"ミリ秒単位の経度xミリ秒単位の緯度" もしくは "経度の小数表記x緯度の小数表記" という文字列表現を使って指定します。経度と緯度の区切りとしては、\(aqx\(aq のほかに \(aq,\(aq を使うことができます。
 .sp
 測地系の詳細については、 \fI\%測地系 \- Wikipedia\fP を参照してください。
-.UNINDENT
-.UNINDENT
+.SS \fBWGS84GeoPoint\fP
 .sp
-\fBWGS84GeoPoint\fP
-.INDENT 0.0
-.INDENT 3.5
 世界測地系（World Geodetic System, WGS 84）による経緯度であり、経度と緯度をミリ秒単位で表現した整数の組により表現します。（デフォルト値: 0x0）
 .sp
 度分秒形式からミリ秒形式への変換方法や \fB/reference/commands/load\fP コマンドにおける指定方法はTokyoGeoPointと同じです。
-.UNINDENT
-.UNINDENT
 .SS 型に関する制限事項
 .SS テーブルの主キーに指定できない型
 .sp
@@ -28230,9 +28664,6 @@ Text型とLongText型については、テーブルの主キーに指定する
 Groongaのカラムは、ある型のベクターを保存することができます。しかし、ShortText, Text, LongTextの３つの型についてはベクターとして保存したり出力したりすることはできますが、検索条件やドリルダウン条件に指定することができません。
 .sp
 テーブル型は、ベクターとして格納することができます。よって、ShortTextのベクターを検索条件やドリルダウン条件に使用したい場合には、主キーがShortText型のテーブルを別途作成し、そのテーブルを型として利用します。
-脚注
-.IP [1] 5
-Object型はv1.2でサポートされます。
 .SS テーブル
 .SS 概要
 .sp
@@ -31560,58 +31991,38 @@ mroonga(TAB)mroonga(TAB)groonga MySQL
 .UNINDENT
 .UNINDENT
 .UNINDENT
-.SS Scorer
+.SS スコアラー
 .SS 概要
 .sp
-Groonga has scorer module that customizes score function. Score
-function computes score of matched record. The default scorer function
-uses the number of appeared terms. It is also known as TF (term
-frequency).
+Groongaにはスコアー関数をカスタマイズするスコアーモジュールがあります。スコアー関数はマッチしたレコードのスコアーを計算します。デフォルトのスコアー関数は出現単語数をスコアーにします。これはTF（term frequency。単語の出現数）と呼ばれている計算方法です。
 .sp
-TF is a fast score function but it\(aqs not suitable for the following
-cases:
+TFは高速なスコアー関数ですが、次のケースには適していません。
 .INDENT 0.0
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-Search query contains one or more frequently\-appearing words such
-as "the" and "a".
+検索クエリーが「the」や「a」のように非常によく出現する単語を含んでいる。
 .IP \(bu 2
-Document contains many same keywords such as "They are keyword,
-keyword, keyword ... and keyword". Search engine spammer may use
-the technique.
+文書中に「They are keyword, keyword, keyword ... and keyword」というように同じキーワードが大量に含まれている。検索エンジンのスパマーはこのテクニックを使うかもしれません。
 .UNINDENT
 .UNINDENT
 .UNINDENT
 .sp
-Score function can solve these cases. For example, \fI\%TF\-IDF\fP (term
-frequency\-inverse document frequency) can solve the first case.
-\fI\%Okapi BM25\fP can solve the
-second case. But their are slower than TF.
+スコアー関数でこれらのケースを解決できます。例えば、 \fI\%TF\-IDF\fP （term frequency\-inverse document frequency。その文書中での単語の出現数を、文書全体での単語の出現数で割ったもの）は最初のケースを解決できます。 \fI\%Okapi BM25\fP は2番目のケースを解決できます。しかし、これらはTFより遅いです。
 .sp
-Groonga provides TF\-IDF based scorer as
-\fB/reference/scorers/scorer_tf_idf\fP but doesn\(aqt provide Okapi BM25
-based scorer yet.
-.INDENT 0.0
-.TP
-.B orphan
-.UNINDENT
+Groongaは \fB/reference/scorers/scorer_tf_idf\fP としてTF\-IDFベースのスコアラーを提供しています。しかし、Okapi BM25ベースのスコアラーはまだ提供していません。
 .INDENT 0.0
 .INDENT 3.5
-You don\(aqt need to resolve scoring only by score function. Score
-function is highly depends on search query. You may be able to use
-metadata of matched record.
+スコアー関数だけでスコアの計算をする必要はありません。スコアー関数は検索クエリーに非常に依存しています。検索クエリーだけでなく、マッチしたレコードのメタデータも使えないか検討しましょう。
 .sp
-For example, Google uses \fI\%PageRank\fP for scoring. You may be
-able to use data type ("title" data are important rather than
-"memo" data), tag, geolocation and so on.
+たとえば、Googleはスコアーの計算に \fI\%ページランク\fP を使っています。あなたも、データの種類（たとえば、「メモ」データよりも「タイトル」データの方が重要など）、タグ、位置情報などを使えないか検討してみましょう。
 .sp
-Please stop to think about only score function for scoring.
+スコアーの計算をスコアー関数だけで考えることはやめましょう。
 .UNINDENT
 .UNINDENT
 .SS 使い方
 .sp
-このセクションではscorerの使い方について説明します。
+このセクションではスコアラーの使い方について説明します。
 .sp
 使い方を示すために使うスキーマ定義とサンプルデータは以下の通りです。
 .sp
@@ -31696,8 +32107,7 @@ load \-\-table Memos
 .sp
 select\-match\-columns の中でscore関数を使うことができます。次に構文を示します。
 .sp
-For score function that doesn\(aqt require any parameter such as
-\fB/reference/scorers/scorer_tf_idf\fP:
+\fB/reference/scorers/scorer_tf_idf\fP のように、いくつかのスコアー関数には引数はありません。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -31709,7 +32119,7 @@ SCORE_FUNCTION(COLUMN)
 .UNINDENT
 .UNINDENT
 .sp
-You can specify weight:
+重みを指定することができます。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -31721,8 +32131,7 @@ SCORE_FUNCTION(COLUMN) * WEIGHT
 .UNINDENT
 .UNINDENT
 .sp
-For score function that requires one or more parameters such as
-\fB/reference/scorers/scorer_tf_at_most\fP:
+\fB/reference/scorers/scorer_tf_at_most\fP のように引数が必要なスコアー関数もあります。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -31734,7 +32143,7 @@ SCORE_FUNCTION(COLUMN, ARGUMENT1, ARGUMENT2, ...)
 .UNINDENT
 .UNINDENT
 .sp
-You can specify weight:
+重みを指定することができます。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -31811,12 +32220,113 @@ select Memos \e
 .UNINDENT
 .UNINDENT
 .sp
-\fBGroonga! Groonga! Groonga! Groonga is very fast!\fP contains 4
-\fBGroonga\fP\&. If you use TF based scorer that is the default scorer,
-\fB_score\fP is \fB4\fP\&. But the actual \fB_score\fP is \fB2\fP\&. Because the
-\fBselect\fP command uses TF\-IDF based scorer \fBscorer_tf_idf()\fP\&.
+\fBGroonga! Groonga! Groonga! Groonga is very fast!\fP には \fBGroonga\fP が4つ含まれています。デフォルトのTFベースのスコアラーを使うと、 \fB_score\fP は \fB4\fP です。しかし、実際は \fB_score\fP は \fB2\fP になります。なぜなら、この \fBselect\fP コマンドはTF\-IDFベースの  \fBscorer_tf_idf()\fP スコアラーを使っているからです。
+.sp
+以下は重みを使った例です。
+.sp
+実行例:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+select Memos \e
+  \-\-match_columns "scorer_tf_idf(content) * 10" \e
+  \-\-query "Groonga" \e
+  \-\-output_columns "content, _score" \e
+  \-\-sortby "\-_score"
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         2
+#       ],
+#       [
+#         [
+#           "content",
+#           "Text"
+#         ],
+#         [
+#           "_score",
+#           "Int32"
+#         ]
+#       ],
+#       [
+#         "Groonga! Groonga! Groonga! Groonga is very fast!",
+#         22
+#       ],
+#       [
+#         "Groonga is very easy full text search engine!",
+#         10
+#       ]
+#     ]
+#   ]
+# ]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+\fBGroonga! Groonga! Groonga! Groonga is very fast!\fP の \fB_score\fP は \fB22\fP です。重みを指定していない前の例では \fB_score\fP は \fB2\fP でした。
+.sp
+以下は必ず引数を1つ指定しなければいけないスコアラーを使う例です。 \fB/reference/scorers/scorer_tf_at_most\fP スコアラーには引数を1つ指定しなければいけません。このスコアラーを使うと、TFのスコアーの最大値を制限することができます。
+.sp
+実行例:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+select Memos \e
+  \-\-match_columns "scorer_tf_at_most(content, 2.0)" \e
+  \-\-query "Groonga" \e
+  \-\-output_columns "content, _score" \e
+  \-\-sortby "\-_score"
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         2
+#       ],
+#       [
+#         [
+#           "content",
+#           "Text"
+#         ],
+#         [
+#           "_score",
+#           "Int32"
+#         ]
+#       ],
+#       [
+#         "Groonga! Groonga! Groonga! Groonga is very fast!",
+#         2
+#       ],
+#       [
+#         "Groonga is very easy full text search engine!",
+#         1
+#       ]
+#     ]
+#   ]
+# ]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+\fBGroonga! Groonga! Groonga! Groonga is very fast!\fP は \fBGroonga\fP を4つ含んでいます。もし、デフォルトのスコアラーである標準のTFベースのスコアラーを使っていた場合、 \fB_score\fP は \fB4\fP になります。しかし、実際の \fB_score\fP は \fB2\fP です。なぜなら、この \fBselect\fP コマンドが使っているスコアラーは最大スコアーを \fB2\fP に制限しているからです。
 .sp
-以下は重みを使った例です。
+以下は複数のスコアラーを使う例です。
 .sp
 実行例:
 .INDENT 0.0
@@ -31825,9 +32335,9 @@ select Memos \e
 .nf
 .ft C
 select Memos \e
-  \-\-match_columns "scorer_tf_idf(content) * 10" \e
+  \-\-match_columns "scorer_tf_idf(title) || scorer_tf_at_most(content, 2.0)" \e
   \-\-query "Groonga" \e
-  \-\-output_columns "content, _score" \e
+  \-\-output_columns "title, content, _score" \e
   \-\-sortby "\-_score"
 # [
 #   [
@@ -31842,6 +32352,10 @@ select Memos \e
 #       ],
 #       [
 #         [
+#           "title",
+#           "ShortText"
+#         ],
+#         [
 #           "content",
 #           "Text"
 #         ],
@@ -31851,12 +32365,14 @@ select Memos \e
 #         ]
 #       ],
 #       [
+#         "Groonga is fast",
 #         "Groonga! Groonga! Groonga! Groonga is very fast!",
-#         22
+#         3
 #       ],
 #       [
+#         "Groonga is easy",
 #         "Groonga is very easy full text search engine!",
-#         10
+#         2
 #       ]
 #     ]
 #   ]
@@ -31866,13 +32382,9 @@ select Memos \e
 .UNINDENT
 .UNINDENT
 .sp
-\fBGroonga! Groonga! Groonga! Groonga is very fast!\fP has \fB22\fP as
-\fB_score\fP\&. It had \fB2\fP as \fB_score\fP in the previous example that
-doesn\(aqt specify weight.
+この \fB\-\-match_columns\fP は \fBscorer_tf_idf(title)\fP と \fBscorer_tf_at_most(content, 2.0)\fP を使っています。 \fB_score\fP の値はこれら2つの値の合計になります。
 .sp
-Here is an example that uses scorer that requires one
-argument. \fB/reference/scorers/scorer_tf_at_most\fP scorer requires
-one argument. You can limit TF score by the scorer.
+同じ \fB\-\-match_columns\fP の中でデフォルトのスコアラーとカスタムスコアラーを使うことができます。単にマッチ対象のカラムを指定するとデフォルトのスコアラーを使います。
 .sp
 実行例:
 .INDENT 0.0
@@ -31881,9 +32393,9 @@ one argument. You can limit TF score by the scorer.
 .nf
 .ft C
 select Memos \e
-  \-\-match_columns "scorer_tf_at_most(content, 2.0)" \e
+  \-\-match_columns "title || scorer_tf_at_most(content, 2.0)" \e
   \-\-query "Groonga" \e
-  \-\-output_columns "content, _score" \e
+  \-\-output_columns "title, content, _score" \e
   \-\-sortby "\-_score"
 # [
 #   [
@@ -31898,6 +32410,10 @@ select Memos \e
 #       ],
 #       [
 #         [
+#           "title",
+#           "ShortText"
+#         ],
+#         [
 #           "content",
 #           "Text"
 #         ],
@@ -31907,12 +32423,14 @@ select Memos \e
 #         ]
 #       ],
 #       [
+#         "Groonga is fast",
 #         "Groonga! Groonga! Groonga! Groonga is very fast!",
-#         2
+#         3
 #       ],
 #       [
+#         "Groonga is easy",
 #         "Groonga is very easy full text search engine!",
-#         1
+#         2
 #       ]
 #     ]
 #   ]
@@ -31922,75 +32440,200 @@ select Memos \e
 .UNINDENT
 .UNINDENT
 .sp
-\fBGroonga! Groonga! Groonga! Groonga is very fast!\fP contains 4
-\fBGroonga\fP\&. If you use normal TF based scorer that is the default
-scorer, \fB_score\fP is \fB4\fP\&. But the actual \fB_score\fP is \fB2\fP\&.
-Because the scorer used in the \fBselect\fP command limits the maximum
-score value to \fB2\fP\&.
+この \fB\-\-match_columns\fP は \fBtitle\fP にはデフォルトのスコアラー（TF）を使い、 \fBcontent\fP には \fB/reference/scorers/scorer_tf_at_most\fP を使います。 \fB_score\fP の値はこれらのスコアラーの結果の合計になります。
+.SS 組み込みスコアラー
+.sp
+以下は組み込みのスコアラーです。
+.SS \fBscorer_tf_at_most\fP
 .sp
-以下は複数のスコアラーを使う例です。
+\fB注釈:\fP
+.INDENT 0.0
+.INDENT 3.5
+スコアラーは実験的な機能です。
+.UNINDENT
+.UNINDENT
+.sp
+バージョン 5.0.1 で追加.
+
+.SS 概要
+.sp
+\fBscorer_tf_at_most\fP はTF（term frequency。単語の出現数）ベースのスコアラーです。
+.sp
+TF\-IDFベースのスコアラーを含むTFベースのスコアラーは次のケースに対して適していません。
+.sp
+文書中に「They are keyword, keyword, keyword ... and keyword」というように同じキーワードが大量に含まれているとその文書のスコアーが高くなってしまいます。これは意図した挙動ではありません。検索エンジンのスパマーはこのテクニックを使うかもしれません。
+.sp
+\fBscorer_tf_at_most\fP はTFベースのスコアラーですが、このケースを解決できます。
+.sp
+\fBscorer_tf_at_most\fP はスコアーの最大値を制限します。つまり、 \fBscorer_tf_at_most\fP は1つのマッチの影響を制限することができるということです。
+.sp
+文書中に「They are keyword, keyword, keyword ... and keyword」というように同じキーワードが大量に含まれていても、 \fBscorer_tf_at_most(column, 2.0)\fP はスコアーの値として大きくても \fB2\fP しか返しません。
+.INDENT 0.0
+.INDENT 3.5
+スコアー関数だけでスコアの計算をする必要はありません。スコアー関数は検索クエリーに非常に依存しています。検索クエリーだけでなく、マッチしたレコードのメタデータも使えないか検討しましょう。
+.sp
+たとえば、Googleはスコアーの計算に \fI\%ページランク\fP を使っています。あなたも、データの種類（たとえば、「メモ」データよりも「タイトル」データの方が重要など）、タグ、位置情報などを使えないか検討してみましょう。
+.sp
+スコアーの計算をスコアー関数だけで考えることはやめましょう。
+.UNINDENT
+.UNINDENT
+.SS 構文
+.sp
+このスコアラーの引数は1つです。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-\&.. groonga\-command
-\&.. include:: ../example/reference/scorer/usage_multiple_scorers.log
-\&.. select Memos \e
-\&..   \-\-match_columns "scorer_tf_idf(title) || scorer_tf_at_most(content, 2.0)" \e
-\&..   \-\-query "Groonga" \e
-\&..   \-\-output_columns "title, content, _score" \e
-\&..   \-\-sortby "\-_score"
+scorer_tf_at_most(column, max)
+scorer_tf_at_most(index, max)
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
+.SS 使い方
+.sp
+このセクションではscorerの使い方について説明します。
+.sp
+使い方を示すために使うスキーマ定義とサンプルデータは以下の通りです。
 .sp
-The \fB\-\-match_columns\fP uses \fBscorer_tf_idf(title)\fP and
-\fBscorer_tf_at_most(content, 2.0)\fP\&. \fB_score\fP value is sum of them.
+サンプルスキーマ:
 .sp
-You can use the default scorer and custom scorer in the same
-\fB\-\-match_columns\fP\&. You can use the default scorer by just specifying
-a match column:
+実行例:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-\&.. groonga\-command
-\&.. include:: ../example/reference/scorer/usage_default_and_custom_scorers.log
-\&.. select Memos \e
-\&..   \-\-match_columns "title || scorer_tf_at_most(content, 2.0)" \e
-\&..   \-\-query "Groonga" \e
-\&..   \-\-output_columns "title, content, _score" \e
-\&..   \-\-sortby "\-_score"
+table_create Logs TABLE_NO_KEY
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Logs message COLUMN_SCALAR Text
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+table_create Terms TABLE_PAT_KEY ShortText \e
+  \-\-default_tokenizer TokenBigram \e
+  \-\-normalizer NormalizerAuto
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Terms message_index COLUMN_INDEX|WITH_POSITION Logs message
+# [[0, 1337566253.89858, 0.000355720520019531], true]
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-The \fB\-\-match_columns\fP uses the default scorer (TF) for \fBtitle\fP and
-\fB/reference/scorers/scorer_tf_at_most\fP for
-\fBcontent\fP\&. \fB_score\fP value is sum of them.
-.SS 組み込みスコアラー
+サンプルデータ:
 .sp
-以下は組み込みのスコアラーです。
-.SS \fBscorer_tf_at_most\fP
+実行例:
+.INDENT 0.0
+.INDENT 3.5
 .sp
-\fB注釈:\fP
+.nf
+.ft C
+load \-\-table Logs
+[
+{"message": "Notice"},
+{"message": "Notice Notice"},
+{"message": "Notice Notice Notice"},
+{"message": "Notice Notice Notice Notice"},
+{"message": "Notice Notice Notice Notice Notice"}
+]
+# [[0, 1337566253.89858, 0.000355720520019531], 5]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+次のように select\-match\-columns で \fBscorer_tf_at_most\fP を指定します。
+.sp
+実行例:
 .INDENT 0.0
 .INDENT 3.5
-スコアラーは実験的な機能です。
+.sp
+.nf
+.ft C
+select Logs \e
+  \-\-match_columns "scorer_tf_at_most(message, 3.0)" \e
+  \-\-query "Notice" \e
+  \-\-output_columns "message, _score" \e
+  \-\-sortby "\-_score"
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         5
+#       ],
+#       [
+#         [
+#           "message",
+#           "Text"
+#         ],
+#         [
+#           "_score",
+#           "Int32"
+#         ]
+#       ],
+#       [
+#         "Notice Notice Notice Notice Notice",
+#         3
+#       ],
+#       [
+#         "Notice Notice Notice Notice",
+#         3
+#       ],
+#       [
+#         "Notice Notice Notice",
+#         3
+#       ],
+#       [
+#         "Notice Notice",
+#         2
+#       ],
+#       [
+#         "Notice",
+#         1
+#       ]
+#     ]
+#   ]
+# ]
+.ft P
+.fi
 .UNINDENT
 .UNINDENT
 .sp
-バージョン 5.0.1 で追加.
-
-.SS 概要
+もし、文書が \fBNotice\fP という単語を3個以上含んでいたら、スコアーは \fB3\fP になります。なぜなら、この \fBselect\fP ではスコアーの最大値を \fB3.0\fP と指定しているからです。
 .sp
-\fBscorer_tf_at_most\fP is a scorer based on TF (term frequency).
+もし、文書が \fBNotice\fP という単語を1つか2つしか含んでいなかったら、スコアーは \fB1\fP か \fB2\fP になります。なぜなら、スコアーが指定された最大値 \fB3.0\fP より小さいからです。
+.SS 引数
 .sp
-TODO
+このセクションではすべての引数について説明します。
+.SS 必須引数
+.sp
+1つだけ必須の引数があります。
+.SS \fBcolumn\fP
+.sp
+マッチ対象のデータカラムです。このデータカラムにはインデックスが張られていなければいけません。
+.SS \fBindex\fP
+.sp
+検索に使うインデックスカラムです。
+.SS 省略可能引数
+.sp
+省略可能な引数はありません。
+.SS 戻り値
+.sp
+このスコアラーは builtin\-type\-float でスコアーの値を返します。
+.sp
+\fB/reference/commands/select\fP は \fBFloat\fP ではなく \fBInt32\fP で \fB_score\fP を返します。これは、後方互換性を維持するために \fBFloat\fP から \fBInt32\fP にキャストしているためです。
+.sp
+スコアーは制限つきのTFで計算します。
+.SS 参考
+.INDENT 0.0
+.IP \(bu 2
+\fB\&../scorer\fP
+.UNINDENT
 .SS \fBscorer_tf_idf\fP
 .sp
 \fB注釈:\fP
@@ -32004,45 +32647,42 @@ TODO
 
 .SS 概要
 .sp
-\fBscorer_tf_idf\fP is a scorer based of \fI\%TF\-IDF\fP (term
-frequency\-inverse document frequency) score function.
+\fBscorer_tf_idf\fP は \fI\%TF\-IDF\fP （term frequency\-inverse document frequency。その文書中での単語の出現数を、その単語を文書の数で割ったもの）ベースのスコアー関数です。
 .sp
-To put it simply, TF (term frequency) divided by DF (document
-frequency) is TF\-IDF. "TF" means that "the number of occurrences is
-more important". "TF divided by DF" means that "the number of
-occurrences of important term is more important".
+簡単に言うと、TF\-IDFとはTF（term frequency。その文書中での単語出現数）をDF（document frequency。その単語を含むドキュメント数）で割ったものです。「TF」は「単語がたくさん出現している方がより重要」という意味を表します。「TFをDFで割る」というのは「重要な単語がたくさん出現している方がより重要」という意味を表します。
 .sp
-The default score function in Groonga is TF (term frequency). It
-doesn\(aqt care about term importance but is fast.
+Groongaのデフォルトのスコアー関数はTF（term frequency。単語の出現数）です。この関数は単語の重要度は考慮しませんが高速です。
 .sp
-TF\-IDF cares about term importance but is slower than TF.
+TF\-IDFは単語の重要度を考慮しますが、TFより遅くなります。
 .sp
-TF\-IDF will compute more suitable score rather than TF for many cases.
-But it\(aqs not perfect.
+TF\-IDFは多くの場合でTFよりも適切なスコアーを計算しますが、完璧ではありません。
 .sp
-If document contains many same keywords such as "They are keyword,
-keyword, keyword ... and keyword". It increases score by TF and
-TF\-IDF. Search engine spammer may use the technique. But TF\-IDF
-doesn\(aqt guard from the technique.
+「They are keyword, keyword, keyword ... and keyword」のように文書中に同じキーワードがたくさん含まれている場合、TFでもTF\-IDFでもスコアーが増えます。検索エンジンのスパマーはこのテクニックを使うかもしれません。しかし、TF\-IDFはこのテクニックを防ぐことができません。
 .sp
-\fI\%Okapi BM25\fP can solve the
-case. But it\(aqs more slower than TF\-IDF and not implemented yet in
-Groonga.
+\fI\%Okapi BM25\fP はこのケースを解決できます。しかし、TF\-IDFよりも遅くなります。また、Groongaではまだ実装されていません。
+.sp
+Groongaは \fBscorer_tf_at_most\fP スコアラーという別の方法でこのケースを解決できるスコアラーを提供しています。
 .INDENT 0.0
-.TP
-.B orphan
+.INDENT 3.5
+スコアー関数だけでスコアの計算をする必要はありません。スコアー関数は検索クエリーに非常に依存しています。検索クエリーだけでなく、マッチしたレコードのメタデータも使えないか検討しましょう。
+.sp
+たとえば、Googleはスコアーの計算に \fI\%ページランク\fP を使っています。あなたも、データの種類（たとえば、「メモ」データよりも「タイトル」データの方が重要など）、タグ、位置情報などを使えないか検討してみましょう。
+.sp
+スコアーの計算をスコアー関数だけで考えることはやめましょう。
+.UNINDENT
 .UNINDENT
+.SS 構文
+.sp
+このスコアラーの引数は1つです。:
 .INDENT 0.0
 .INDENT 3.5
-You don\(aqt need to resolve scoring only by score function. Score
-function is highly depends on search query. You may be able to use
-metadata of matched record.
 .sp
-For example, Google uses \fI\%PageRank\fP for scoring. You may be
-able to use data type ("title" data are important rather than
-"memo" data), tag, geolocation and so on.
-.sp
-Please stop to think about only score function for scoring.
+.nf
+.ft C
+scorer_tf_idf(column)
+scorer_tf_idf(index)
+.ft P
+.fi
 .UNINDENT
 .UNINDENT
 .SS 使い方
@@ -32166,13 +32806,29 @@ select Logs \e
 .UNINDENT
 .UNINDENT
 .sp
-Both the score of \fBInfo Info Info\fP and the score of \fBError\fP are
-\fB2\fP even \fBInfo Info Info\fP includes three \fBInfo\fP terms. Because
-\fBError\fP is more important term rather than \fBInfo\fP\&. The number of
-documents that include \fBInfo\fP is \fB4\fP\&. The number of documents that
-include \fBError\fP is \fB1\fP\&. Term that is included in less documents
-means that the term is more characteristic term. Characteristic term
-is important term.
+\fBInfo Info Info\fP には \fBInfo\fP という単語が3回もでてきますが、 \fBInfo Info Info\fP も \fBError\fP もどちらもスコアーは \fB2\fP です。なぜなら、 \fBError\fP は \fBInfo\fP よりもより重要な単語だからです。 \fBInfo\fP を含むドキュメントの数は \fB4\fP です。 \fBError\fP を含むドキュメントの数は \fB1\fP です。少しのドキュメントにしか含まれていない単語はより特徴的な単語です。特徴的な単語は重要な単語です。
+.SS 引数
+.sp
+このセクションではすべての引数について説明します。
+.SS 必須引数
+.sp
+1つだけ必須の引数があります。
+.SS \fBcolumn\fP
+.sp
+マッチ対象のデータカラムです。このデータカラムにはインデックスが張られていなければいけません。
+.SS \fBindex\fP
+.sp
+検索に使うインデックスカラムです。
+.SS 省略可能引数
+.sp
+省略可能な引数はありません。
+.SS 戻り値
+.sp
+このスコアラーは builtin\-type\-float でスコアーの値を返します。
+.sp
+\fB/reference/commands/select\fP は \fBFloat\fP ではなく \fBInt32\fP で \fB_score\fP を返します。これは、後方互換性を維持するために \fBFloat\fP から \fBInt32\fP にキャストしているためです。
+.sp
+スコアーはTF\-IDFベースのアルゴリズムで計算します。
 .SS 参考
 .INDENT 0.0
 .IP \(bu 2
@@ -36310,10 +36966,22 @@ Groongaは正規表現を用いたパターンマッチをサポートしてい
 多くの場合は、正規表現検索は逐次検索で実行します。これはたくさんのレコードがあったり、たくさんのテキストがある場合は遅くなります。
 .sp
 いくつかの場合では、正規表現を使ったパターンマッチをインデックスを使って実現します。これは逐次検索よりも非常に高速です。インデックスを使って評価できるパターンについては後述します。
+.sp
+バージョン 5.0.7 で追加: Groongaは正規表現検索にインデックスを使わないときは、 normalizer\-auto ノーマライザーでマッチ対象のテキストを正規化します。これは、 \fBGroonga\fP というような大文字を使った正規表現は必ずマッチに失敗するということです。なぜなら、 normalizer\-auto ノーマライザーはすべてのアルファベットを小文字に正規化するからです。 \fBgroonga\fP は \fBGroonga\fP にも \fBgroonga\fP にも両方にマッチします。
+.sp
+なぜマッチ対象のテキストを正規化するのでしょうか？それは、インデックスを使って検索できるパターンを増やすためです。もし、Groongaがマッチ対象のテキストを正規化しなかった場合、大文字小文字を区別しないマッチをするために、 \fB[Dd][Ii][Ss][Kk]\fP や \fB(?i)disk\fP のような複雑な正規表現を書く必要があります。Groongaは複雑な正規表現に対してインデックスを使うことができません。
+.sp
+もし、大文字小文字を区別しないマッチに \fBdisk\fP という正規表現を使うなら、Groongaはインデックスを使ってこのパターンを検索できます。これは高速です。
+.sp
+この挙動を奇妙に思うかもしれません。しかし、この挙動のおかげで高速に検索できることはきっとあなたの役に立つはずです。
+
 .sp
 正規表現の構文はたくさんあります。GroongaはRubyと同じ構文を使います。なぜなら、Groongaが使っている正規表現エンジンはRubyが使っている正規表現エンジンと同じだからです。この正規表現エンジンは \fI\%Onigmo\fP といいます。他の正規表現の構文との特徴的な違いは \fB^\fP と \fB$\fP です。Rubyの正規表現の構文では \fB^\fP は行頭を表し、 \fB$\fP は行末を表します。他の多くの正規表現の構文では、 \fB^\fP はテキストの先頭を表し、 \fB$\fP はテキストの最後を表します。Rubyの正規表現の構文ではテキストの先頭を表す場合は \fB\eA\fP を使い、テキストの最後を表す場合は \fB\ez\fP を使います。
 .sp
-Groongaは5.0.6からマルチラインモードを有効にしています。これは、 \fB\&.\fP が \fB\en\fP にマッチするということです。
+バージョン 5.0.6 で追加: Groongaは5.0.6からマルチラインモードを有効にしています。これは、 \fB\&.\fP が \fB\en\fP にマッチするということです。
+.sp
+しかし、この挙動は意味がありません。なぜなら、 \fB\en\fP は normalizer\-auto ノーマライザーが削除するからです。
+
 .sp
 \fB/reference/commands/select\fP コマンドの select\-query オプションと select\-filter オプションで正規表現を使えます。
 .SS 使い方
@@ -36352,7 +37020,7 @@ select\-query で正規表現を使う例です。 \fB${COLUMN}:~${REGULAR_EXPRE
 .sp
 .nf
 .ft C
-select Logs \-\-query \(aqmessage:~"[Dd]isk"\(aq
+select Logs \-\-query \(aqmessage:~"disk (space|full)"\(aq
 # [
 #   [
 #     0,
@@ -36398,7 +37066,7 @@ select\-filter で正規表現を使う例です。 \fB${COLUMN} @~ ${REGULAR_EX
 .sp
 .nf
 .ft C
-select Logs \-\-filter \(aqmessage @~ "[Dd]isk"\(aq
+select Logs \-\-filter \(aqmessage @~ "disk (space|full)"\(aq
 # [
 #   [
 #     0,
@@ -36948,7 +37616,7 @@ select Logs \-\-filter \(aqmessage @~ "\e\e\e\e[(warning|info)\e\e\e\e]"\(aq
 .sp
 文字クラスの構文は \fB[...]\fP です。文字クラスはマッチする文字を複数指定するときに便利です。
 .sp
-たとえば、 \fB[Dd]\fP は \fBD\fP または \fBd\fP にマッチします。
+たとえば、 \fB[12]\fP は \fB1\fP または \fB2\fP にマッチします。
 .sp
 実行例:
 .INDENT 0.0
@@ -36956,7 +37624,7 @@ select Logs \-\-filter \(aqmessage @~ "\e\e\e\e[(warning|info)\e\e\e\e]"\(aq
 .sp
 .nf
 .ft C
-select Logs \-\-filter \(aqmessage @~ "[Dd]isk"\(aq
+select Logs \-\-filter \(aqmessage @~ "host[12]"\(aq
 # [
 #   [
 #     0,
@@ -36966,7 +37634,7 @@ select Logs \-\-filter \(aqmessage @~ "[Dd]isk"\(aq
 #   [
 #     [
 #       [
-#         2
+#         5
 #       ],
 #       [
 #         [
@@ -36979,12 +37647,24 @@ select Logs \-\-filter \(aqmessage @~ "[Dd]isk"\(aq
 #         ]
 #       ],
 #       [
+#         1,
+#         "host1:[error]: No memory"
+#       ],
+#       [
 #         2,
 #         "host1:[warning]: Remained disk space is less than 30%"
 #       ],
 #       [
 #         3,
 #         "host1:[error]: Disk full"
+#       ],
+#       [
+#         4,
+#         "host2:[error]: No memory"
+#       ],
+#       [
+#         5,
+#         "host2:[info]: Shutdown"
 #       ]
 #     ]
 #   ]
@@ -38393,18 +39073,21 @@ HTMLエスケープの有無を指定します。 \fBtrue\fP を指定すればH
 この機能は実験的です。APIが変わる可能性があります。
 .UNINDENT
 .UNINDENT
+.sp
+バージョン 4.0.5 で追加.
+
 .SS 概要
 .sp
 \fBhighlight_html\fP は対象テキストをタグ付けします。検索文字列をハイライトさせるために利用することができます。タグ付けされたテキストはHTML中に埋め込みやすいように処理されています。\fB<\fP や \fB>\fP などの特殊文字は &lt; や &gt; にエスケープされています。キーワードは \fB<span class="keyword">\fP と \fB</span>\fP で囲まれています。たとえば、 \fBI am a groonga user. <3\fP という対象テキストのキーワード \fBgroonga\fP でタグ付けされたテキストは \fBI am a <span class="keyword">groonga</span> user. &lt;3\fP となります。
 .SS 構文
 .sp
-\fBhighlight_html\fP の引数は1つだけです:
+この関数の引数は1つです。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-highlight_html(column)
+highlight_html(text)
 .ft P
 .fi
 .UNINDENT
@@ -38439,8 +39122,6 @@ load \-\-table Entries
 .sp
 \fBhighlight_html\fP は \fB/reference/commands/select\fP コマンドの \fB\-\-output_columns\fP 内でのみ指定できます。
 .sp
-\fBhighlight_html\fP を使うにはGroonga 4.0.5以降が必要です。
-.sp
 \fBhighlight_html\fP を使うには \fB/reference/command/command_version\fP 2以降を使う必要があります。
 .sp
 また、 \fB\-\-query\fP と \fB\-\-filter\fP オプションも指定する必要があります。（どちらか一方でも構いません。）これは、 \fB\-\-query\fP と \fB\-\-filter\fP オプションからキーワードを抽出しているためです。
@@ -38524,10 +39205,16 @@ select Entries \-\-output_columns \(aqhighlight_html("Groonga is very fast fullt
 .UNINDENT
 .SS 引数
 .sp
-引数は1つあります。 \fBcolumn\fP です。
-.SS \fBcolumn\fP
+このセクションではすべての引数について説明します。
+.SS 必須引数
 .sp
-テーブルのカラムを指定します。
+1つだけ必須の引数があります。
+.SS \fBtext\fP
+.sp
+HTMLでハイライトする対象のテキストです。
+.SS 省略可能引数
+.sp
+省略可能な引数はありません。
 .SS 戻り値
 .sp
 \fBhighlight_html\fP はタグ付の文字列もしくは null を返します。\fBhighlight_html\fP は該当するキーワードがない場合に null を返します。
@@ -41146,7 +41833,7 @@ logical_count logical_table
 .sp
 \fBlogical_count\fP コマンドを使うには事前に \fBsharding\fP プラグインを登録します。
 .sp
-\fBlogical_count\fP コマンドは実験的なプラグインです。このコマンドは将来的に変更されるかも知れません。
+\fBlogical_count\fP コマンドは実験的なプラグインです。このコマンドは将来的に変更されるかもしれません。
 .sp
 この機能を使う簡単な例を示します。複数のテーブルに保存されている特定のログをカウントしてみましょう。
 .sp
@@ -45781,6 +46468,24 @@ Normally, this function isn\(aqt needed.
 成功時は \fBGRN_SUCCESS\fP 、エラー時は \fBGRN_SUCCESS\fP 以外。
 .UNINDENT
 .UNINDENT
+.INDENT 0.0
+.TP
+.B grn_bool_rc grn_ctx_is_opened(grn_ctx\fI\ *ctx\fP, grn_id\fI\ id\fP)
+指定したIDのオブジェクトが開かれているかどうかをチェックします。
+.INDENT 7.0
+.TP
+.B パラメタ
+.INDENT 7.0
+.IP \(bu 2
+\fBctx\fP \-\- その時点のコンテキスト。
+.IP \(bu 2
+\fBid\fP \-\- チェック対象のオブジェクトのID。
+.UNINDENT
+.TP
+.B 戻り値
+指定したIDのオブジェクトが開かれていたら \fBGRN_TRUE\fP 、そうでなければ \fBGRN_FALSE\fP 。
+.UNINDENT
+.UNINDENT
 .SS \fBgrn_db\fP
 .SS 概要
 .sp
@@ -47080,6 +47785,42 @@ dbのidに対応するpathを返します。mroonga向けに用意した内部AP
 .UNINDENT
 .UNINDENT
 .UNINDENT
+.INDENT 0.0
+.TP
+.B grn_rc grn_obj_cast_by_id(grn_ctx\fI\ *ctx\fP, grn_obj\fI\ *source\fP, grn_obj\fI\ *destination\fP, grn_bool\fI\ add_record_if_not_exist\fP)
+It casts value of \fBsource\fP to value with type of
+\fBdestination\fP\&. Casted value is appended to \fBdestination\fP\&.
+.sp
+Both \fBsource\fP and \fBdestination\fP must be bulk.
+.sp
+If \fBdestination\fP is a reference type bulk. (Reference type bulk
+means that type of \fBdestination\fP is a table.)
+\fBadd_record_if_not_exist\fP is used. If \fBsource\fP value doesn\(aqt
+exist in the table that is a type of \fBdestination\fP\&. The \fBsource\fP
+value is added to the table.
+.INDENT 7.0
+.TP
+.B パラメタ
+.INDENT 7.0
+.IP \(bu 2
+\fBctx\fP \-\- その時点のコンテキスト。
+.IP \(bu 2
+\fBsource\fP \-\- The bulk to be casted.
+.IP \(bu 2
+\fBdestination\fP \-\- The bulk to specify cast target type and store
+casted value.
+.IP \(bu 2
+\fBadd_record_if_not_exist\fP \-\- Whether adding a new record if
+\fBsource\fP value doesn\(aqt exist in
+cast target table. This parameter
+is only used when \fBdestination\fP
+is a reference type bulk.
+.UNINDENT
+.TP
+.B 戻り値
+成功時は \fBGRN_SUCCESS\fP 、エラー時は \fBGRN_SUCCESS\fP 以外。
+.UNINDENT
+.UNINDENT
 .SS \fBgrn_proc\fP
 .SS 概要
 .sp
@@ -49832,7 +50573,7 @@ twitterでサポートされている安心感からGroongaユーザーの拡大
 .sp
 twitterは気軽につぶやけることが重要なので、気軽にできないことを相手に要求すると萎縮されてしまう可能性があります。
 .sp
-いきなりredmineでバグ報告をお願いすると、しりごみしてしまうかも知れません。:
+いきなりredmineでバグ報告をお願いすると、しりごみしてしまうかもしれません。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -49844,8 +50585,7 @@ twitterは気軽につぶやけることが重要なので、気軽にできな
 .UNINDENT
 .UNINDENT
 .sp
-Groonga関連で気軽につぶやけないとなると開発者は困っている人を見つけられないし、利用者は困ったままとなるので、双方にとって嬉しくない状態になっ
-てしまいます。
+Groonga関連で気軽につぶやけないとなると開発者は困っている人を見つけられないし、利用者は困ったままとなるので、双方にとって嬉しくない状態になってしまいます。
 .SS 対応
 .sp
 twitterでやりとりを完結できるようにします。