RubyGems - rroonga - Versions diffs - 2.0.0-x86-mingw32 → 2.0.1-x86-mingw32 - Mend

rroonga 2.0.0-x86-mingw32 → 2.0.1-x86-mingw32

Files changed (357) hide show

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

@@ -1,4 +1,4 @@
-.TH "GROONGA" "1" "2012 年 02 月 28 日" "2.0.0" "groonga"
+.TH "GROONGA" "1" "2012 年 03 月 29 日" "2.0.0" "groonga"
 .SH NAME
 groonga \- groongaのドキュメント
 .
@@ -106,9 +106,19 @@ deb\-src http://packages.groonga.org/debian/ squeeze main
 .ft P
 .fi
 .sp
-\fI\%Munin\fP プラグインを提供するパッケージもあります。もし、muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
+\fI\%MeCab\fP をトークナイザとして使いたいときは、groonga\-tokenizer\-mecabパッケージをインストールしてください。
 .sp
-groonga\-munin\-pluginsパッケージをインストール:
+groonga\-tokenizer\-mecabパッケージのインストール:
+.sp
+.nf
+.ft C
+% sudo aptitude \-V \-D \-y install groonga\-tokenizer\-mecab
+.ft P
+.fi
+.sp
+\fI\%Munin\fP プラグインを提供するパッケージもあります。Muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
+.sp
+groonga\-munin\-pluginsパッケージのインストール:
 .sp
 .nf
 .ft C
@@ -136,7 +146,19 @@ deb\-src http://packages.groonga.org/debian/ wheezy main
 .ft P
 .fi
 .sp
-groonga\-munin\-pluginsパッケージをインストール:
+\fI\%MeCab\fP をトークナイザとして使いたいときは、groonga\-tokenizer\-mecabパッケージをインストールしてください。
+.sp
+groonga\-tokenizer\-mecabパッケージのインストール:
+.sp
+.nf
+.ft C
+% sudo aptitude \-V \-D \-y install groonga\-tokenizer\-mecab
+.ft P
+.fi
+.sp
+\fI\%Munin\fP プラグインを提供するパッケージもあります。Muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
+.sp
+groonga\-munin\-pluginsパッケージのインストール:
 .sp
 .nf
 .ft C
@@ -164,7 +186,19 @@ deb\-src http://packages.groonga.org/debian/ unstable main
 .ft P
 .fi
 .sp
-groonga\-munin\-pluginsパッケージをインストール:
+\fI\%MeCab\fP をトークナイザとして使いたいときは、groonga\-tokenizer\-mecabパッケージをインストールしてください。
+.sp
+groonga\-tokenizer\-mecabパッケージのインストール:
+.sp
+.nf
+.ft C
+% sudo aptitude \-V \-D \-y install groonga\-tokenizer\-mecab
+.ft P
+.fi
+.sp
+\fI\%Munin\fP プラグインを提供するパッケージもあります。Muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
+.sp
+groonga\-munin\-pluginsパッケージのインストール:
 .sp
 .nf
 .ft C
@@ -195,7 +229,19 @@ deb\-src http://packages.groonga.org/ubuntu/ lucid universe
 .ft P
 .fi
 .sp
-groonga\-munin\-pluginsパッケージをインストール:
+\fI\%MeCab\fP をトークナイザとして使いたいときは、groonga\-tokenizer\-mecabパッケージをインストールしてください。
+.sp
+groonga\-tokenizer\-mecabパッケージのインストール:
+.sp
+.nf
+.ft C
+% sudo apt\-get \-y install groonga\-tokenizer\-mecab
+.ft P
+.fi
+.sp
+\fI\%Munin\fP プラグインを提供するパッケージもあります。Muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
+.sp
+groonga\-munin\-pluginsパッケージのインストール:
 .sp
 .nf
 .ft C
@@ -226,7 +272,19 @@ deb\-src http://packages.groonga.org/ubuntu/ natty universe
 .ft P
 .fi
 .sp
-groonga\-munin\-pluginsパッケージをインストール:
+\fI\%MeCab\fP をトークナイザとして使いたいときは、groonga\-tokenizer\-mecabパッケージをインストールしてください。
+.sp
+groonga\-tokenizer\-mecabパッケージのインストール:
+.sp
+.nf
+.ft C
+% sudo apt\-get \-y install groonga\-tokenizer\-mecab
+.ft P
+.fi
+.sp
+\fI\%Munin\fP プラグインを提供するパッケージもあります。Muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
+.sp
+groonga\-munin\-pluginsパッケージのインストール:
 .sp
 .nf
 .ft C
@@ -257,7 +315,19 @@ deb\-src http://packages.groonga.org/ubuntu/ oneiric universe
 .ft P
 .fi
 .sp
-groonga\-munin\-pluginsパッケージをインストール:
+\fI\%MeCab\fP をトークナイザとして使いたいときは、groonga\-tokenizer\-mecabパッケージをインストールしてください。
+.sp
+groonga\-tokenizer\-mecabパッケージのインストール:
+.sp
+.nf
+.ft C
+% sudo apt\-get \-y install groonga\-tokenizer\-mecab
+.ft P
+.fi
+.sp
+\fI\%Munin\fP プラグインを提供するパッケージもあります。Muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
+.sp
+groonga\-munin\-pluginsパッケージのインストール:
 .sp
 .nf
 .ft C
@@ -276,11 +346,21 @@ groonga\-munin\-pluginsパッケージをインストール:
 .ft P
 .fi
 .sp
-\fI\%Munin\fP プラグインを提供するパッケージもあります。もし、muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
+\fI\%MeCab\fP をトークナイザとして使いたいときは、groonga\-tokenizer\-mecabパッケージをインストールしてください。
+.sp
+groonga\-tokenizer\-mecabパッケージのインストール:
+.sp
+.nf
+.ft C
+% sudo yum install \-y groonga\-tokenizer\-mecab
+.ft P
+.fi
+.sp
+\fI\%Munin\fP プラグインを提供するパッケージもあります。Muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
 .IP ノート
-groonga\-munin\-pluginsパッケージはmunin\-nodeパッケージを必要としますが、munin\-nodeパッケージはCentOSの公式リポジトリには含まれていません。munin\-nodeパッケージをyumでインストールするために \fI\%RPMforge\fP リポジトリか \fI\%EPEL\fP リポジトリを有効にする必要があります。
+groonga\-munin\-pluginsパッケージはmunin\-nodeパッケージを必要としますが、munin\-nodeパッケージはCentOSの公式リポジトリには含まれていません。munin\-nodeパッケージをyumでインストールするために \fI\%Repoforge (RPMforge)\fP リポジトリか \fI\%EPEL\fP リポジトリを有効にする必要があります。
 .sp
-i386環境でRPMforgeリポジトリを有効にする:
+i386環境でRepoforge (RPMforge)リポジトリを有効にする:
 .sp
 .nf
 .ft C
@@ -288,7 +368,7 @@ i386環境でRPMforgeリポジトリを有効にする:
 .ft P
 .fi
 .sp
-x86_64環境でRPMforgeリポジトリを有効にする:
+x86_64環境でRepoforge (RPMforge)リポジトリを有効にする:
 .sp
 .nf
 .ft C
@@ -305,7 +385,7 @@ EPELリポジトリを有効にする（環境非依存）:
 .fi
 .RE
 .sp
-groonga\-munin\-pluginsパッケージをインストール:
+groonga\-munin\-pluginsパッケージのインストール:
 .sp
 .nf
 .ft C
@@ -325,11 +405,21 @@ groonga\-munin\-pluginsパッケージをインストール:
 .ft P
 .fi
 .sp
-\fI\%Munin\fP プラグインを提供するパッケージもあります。もし、muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
+\fI\%MeCab\fP をトークナイザとして使いたいときは、groonga\-tokenizer\-mecabパッケージをインストールしてください。
+.sp
+groonga\-tokenizer\-mecabパッケージのインストール:
+.sp
+.nf
+.ft C
+% sudo yum install \-y groonga\-tokenizer\-mecab
+.ft P
+.fi
+.sp
+\fI\%Munin\fP プラグインを提供するパッケージもあります。Muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
 .IP ノート
-groonga\-munin\-pluginsパッケージはmunin\-nodeパッケージを必要としますが、munin\-nodeパッケージはCentOSの公式リポジトリには含まれていません。munin\-nodeパッケージをyumでインストールするために \fI\%RPMforge\fP リポジトリか \fI\%EPEL\fP リポジトリを有効にする必要があります。
+groonga\-munin\-pluginsパッケージはmunin\-nodeパッケージを必要としますが、munin\-nodeパッケージはCentOSの公式リポジトリには含まれていません。munin\-nodeパッケージをyumでインストールするために \fI\%Repoforge (RPMforge)\fP リポジトリか \fI\%EPEL\fP リポジトリを有効にする必要があります。
 .sp
-i686環境でRPMforgeリポジトリを有効にする:
+i686環境でRepoforge (RPMforge)リポジトリを有効にする:
 .sp
 .nf
 .ft C
@@ -337,7 +427,7 @@ i686環境でRPMforgeリポジトリを有効にする:
 .ft P
 .fi
 .sp
-x86_64環境でRPMforgeリポジトリを有効にする:
+x86_64環境でRepoforge (RPMforge)リポジトリを有効にする:
 .sp
 .nf
 .ft C
@@ -354,7 +444,7 @@ EPELリポジトリを有効にする（環境非依存）:
 .fi
 .RE
 .sp
-groonga\-munin\-pluginsパッケージをインストール:
+groonga\-munin\-pluginsパッケージのインストール:
 .sp
 .nf
 .ft C
@@ -374,9 +464,19 @@ groonga\-munin\-pluginsパッケージをインストール:
 .ft P
 .fi
 .sp
-\fI\%Munin\fP プラグインを提供するパッケージもあります。もし、muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
+\fI\%MeCab\fP をトークナイザとして使いたいときは、groonga\-tokenizer\-mecabパッケージをインストールしてください。
 .sp
-groonga\-munin\-pluginsパッケージをインストール:
+groonga\-tokenizer\-mecabパッケージのインストール:
+.sp
+.nf
+.ft C
+% sudo yum install \-y groonga\-tokenizer\-mecab
+.ft P
+.fi
+.sp
+\fI\%Munin\fP プラグインを提供するパッケージもあります。Muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
+.sp
+groonga\-munin\-pluginsパッケージのインストール:
 .sp
 .nf
 .ft C
@@ -421,9 +521,9 @@ groonga\-munin\-pluginsパッケージをインストール:
 .ft P
 .fi
 .sp
-prefixは、インストール先を指定するパラメータです。prefixを指定しない場合には、/usr/localが指定されたものとみなします。LD_LIBRARY_PATHなどに詳しくない人は、上記のように/usrを指定することをお勧めします。
+\fI\-\-prefix\fP オプションは、インストール先を指定するオプションです。明示的に指定しなければ、/usr/localが指定されたものとみなします。LD_LIBRARY_PATHなどに詳しくない人は、上記のように/usrを指定することをお勧めします。
 .sp
-groongaパッケージには \fI\%Munin\fP プラグインが含まれています。これらをインストールするためには \fI\-\-with\-munin\-plugins\fP オプションを指定する必要があります。
+groongaパッケージに含まれている \fI\%Munin\fP プラグインのインストールを有効にするには、 \fI\-\-with\-munin\-plugins\fP オプションを指定する必要があります。
 .SH コミュニティ
 .sp
 groongaに関する情報を共有するための場所がいくつかあります。あなたの参加をお待ちしています！
@@ -432,10 +532,10 @@ groongaに関する情報を共有するための場所がいくつかありま
 groongaに関する話題を扱うメーリングリストがあります。
 .INDENT 0.0
 .TP
-.B For English speaker
+.B For English speakers
 \fI\%groonga-talk@lists.sourceforge.net\fP
 .TP
-.B For Japanese speaker
+.B For Japanese speakers
 \fI\%groonga-dev@lists.sourceforge.jp\fP
 .UNINDENT
 .SH チュートリアル
@@ -444,56 +544,58 @@ groongaに関する話題を扱うメーリングリストがあります。
 groongaには、Cのライブラリとして使用する方法と、groonga実行ファイルを通して使用する方法があります。本チュートリアルでは、groonga実行ファイルを使用する方法について説明します。groonga実行ファイルを使って、データベースの作成・操作・サーバの起動・サーバへの接続などの操作が行えます。
 .SS データベースの作成
 .sp
-以下のようなコマンドを実行すると、データベースを新規に作成することができます。
+groongaユーザへの第一歩はデータベースの作成です。まずは以下の書式をご覧ください。
 .sp
 書式:
 .sp
 .nf
 .ft C
-groonga \-n DB_PATH_NAME
+groonga \-n DB_PATH
 .ft P
 .fi
 .sp
-\-nオプションは、データベースを作ることを指示します。DB_PATH_NAMEには、新しく作成するデータベースのパスを指定します。指定されたパスが既に存在するときはコマンドが失敗するので注意してください。
+\fI\-n\fP オプションは、データベースの作成を指示します。DB_PATHは、新しく作成するデータベースのパスを指定します。データベースは複数のファイルによって構成されるため、正確には、データベースの入り口となるファイルのパスとして使用されます。また、データベースを構成する他のファイルについては、DB_PATHがパスのプレフィックスとして使用されます。指定されたパスにファイルが存在しているときは失敗するので注意してください。
 .sp
-上記コマンドは、データベースを作成してから、コマンドの入力を受け付ける対話モードに入ります。Ctrlキーを押しながらdキーを押すと、対話モードから抜けることができます。
+上記のコマンドは、データベースを作成してから、コマンドの入力を受け付ける対話モードに入ります。Ctrlキーを押しながらdキーを押すと、対話モードから抜けることができます。
 .sp
 実行例:
 .sp
 .nf
 .ft C
-% groonga \-n /tmp/tutorial.db
-> Ctrl\-d
-%
+% groonga \-n /tmp/groonga\-databases/introduction.db
 .ft P
 .fi
+.sp
+データベースを作成に成功すれば、/tmp/groonga\-databases以下にデータベースを構成するファイルが配置されます。
 .SS データベースの操作
 .sp
+以下の書式は、既存のデータベースを操作する方法を示しています。
+.sp
 書式:
 .sp
 .nf
 .ft C
-groonga DB_PATH_NAME [COMMAND]
+groonga DB_PATH [COMMAND]
 .ft P
 .fi
 .sp
-操作対象のデータベースのパスをDB_PATH_NAMEに指定します。
+DB_PATHには操作対象のデータベースを指定します。指定したデータベースが存在しないときは失敗します。
 .sp
 COMMAND が指定された場合、COMMAND を実行した後、実行結果を返します。指定されなかった場合には、対話モードに入ります。対話モードでは、標準入力からコマンドを読み込み、順次実行します。本チュートリアルでは、対話モードを主に使用します。
 .sp
-それでは、statusというコマンドを実行してみましょう。statusコマンドは、groongaの実行状態を返すコマンドです。
+それでは、 \fB/commands/status\fP コマンドを実行して、groongaの実行状態を確認してみましょう。
 .sp
 実行例:
 .sp
 .nf
 .ft C
-% groonga \-n /tmp/groonga\-databases/introduction.db
+% groonga /tmp/groonga\-databases/introduction.db
 > status
-[[0,1322616280.40348,0.000158121],{"alloc_count":127,"starttime":1322616279,"uptime":1,"version":"1.2.8\-9\-gbf05b82","n_queries":0,"cache_hit_rate":0.0,"command_version":1,"default_command_version":1,"max_command_version":2}]
+[[0,1332484898.47079,0.000113010406494141],{"alloc_count":151,"starttime":1332484898,"uptime":0,"version":"2.0.0\-250\-g5a3cf19","n_queries":0,"cache_hit_rate":0.0,"command_version":1,"default_command_version":1,"max_command_version":2}]
 .ft P
 .fi
 .sp
-以上のように、コマンドの実行結果は基本的にjson形式の配列として返却されます。配列の先頭には、エラーコードや実行時間などの情報が入ります。2番目の要素には、コマンドによって指定された操作の実行結果が入ります。
+以上のように、コマンドの実行結果は基本的にjson形式の配列として返却されます。配列の先頭には、エラーコードや実行時間などの情報が入ります。2番目の要素には、指示された操作の実行結果が入ります。
 .SS コマンドの書式
 .sp
 データベースを操作するコマンドには、以下の書式で引数を与えます。:
@@ -510,7 +612,7 @@ Form_2: COMMAND \-\-NAME_1 VALUE_1 \-\-NAME_2 VALUE_2 ..
 .sp
 書式2では値を名前と一緒に渡します。そのため、任意の順序で引数を指定することができます。このような引数は、名前付き引数やキーワード引数と呼ばれることもあります。
 .sp
-空白や特殊な記号「"\(aq()」を含む値を指定したいときは、シングルクォート(\(aq)かダブルクォート(")で値を囲むようにしてください。
+空白や特殊な記号（ダブルクォート、シングルクォート、および丸括弧）を含む値を指定したいときは、シングルクォート(\(aq)かダブルクォート(")で値を囲むようにしてください。
 .sp
 詳しくは、 \fB/executables/groonga\fP のコマンドの項を参考にしてください。
 .SS 主なコマンド
@@ -547,18 +649,20 @@ groongaプロセスの状態を表示します。
 .sp
 groongaのテーブルには基本的に主キーが必要であり、テーブルを作成する際には型と格納方法も併せて指定する必要があります。
 .sp
-型については後で説明するので、ここではデータの種類を表しているものという程度に考えてください。主キーの格納方法は、主キーを条件とする検索にかかる時間や、前方一致検索の可否などを左右します。こちらも後で説明します。
+型には数値や文字列などがあります。ここではデータの種類を表しているものという程度に考えてください。詳細は \fB/type\fP に記述されています。主キーの格納方法は、主キーを条件とする検索にかかる時間や、前方一致検索の可否などを左右します。こちらも後で説明します。
 .sp
-それでは、\(aqSite\(aqという名前のテーブルを作成してみましょう。主キーについては、型がShortTextで格納方法はHASHとしています。
+それでは、テーブルを作成してみましょう。以下の例では、主キーのあるテーブルを作成します。 \fIname\fP 引数はテーブルの引数を指定します。 \fIflags\fP 引数は主キーの格納方法を指定するために使っています。 \fIkey_type\fP 引数は主キーの型を指定します。
 .sp
 実行例:
 .sp
 .nf
 .ft C
 > table_create \-\-name Site \-\-flags TABLE_HASH_KEY \-\-key_type ShortText
-[[0,1322616280.60791,0.01234375],true]
+[[0,1332484898.674,0.0103404521942139],true]
 .ft P
 .fi
+.sp
+実行結果の第2要素は、操作が成功したことを示しています。
 .SS テーブルの表示
 .sp
 \fB/commands/select\fP コマンドを用いて、テーブルの中身を表示することができます。
@@ -568,245 +672,277 @@ groongaのテーブルには基本的に主キーが必要であり、テーブ
 .nf
 .ft C
 > select \-\-table Site
-[[0,1322616280.82196,0.000451873],[[[0],[["_id","UInt32"],["_key","ShortText"]]]]]
+[[0,1332484898.88587,0.000526189804077148],[[[0],[["_id","UInt32"],["_key","ShortText"]]]]]
 .ft P
 .fi
 .sp
-selectにテーブル名のみを指定すると、指定したテーブルの中身を10件まで表示します。実行結果の[0]はテーブルに含まれるレコードの数を示しています。今回は何も登録されていないため0件です。レコード数の次に表示されている配列はテーブルの構成を示しています。["_id","Uint32"]はUInt32型の値を持つ\(aq_id\(aqという名前のカラム、["_key","ShortText"]はShortText型の値を持つ\(aq_key\(aqという名前のカラムをそれぞれ表しています。
+\fB/commands/select\fP にテーブル名のみを指定すると、指定したテーブルの中身を10件まで表示します。実行結果の[0]はテーブルに含まれるレコードの数を示しています。今回は何も登録されていないため0件です。レコード数の次に表示されている配列はテーブルの構成を示しています。["_id","Uint32"]はUInt32型の値を持つ_idという名前のカラム、["_key","ShortText"]はShortText型の値を持つ_keyという名前のカラムをそれぞれ表しています。
 .sp
-table_createコマンドで作成したテーブルには、最初から\(aq_id\(aq, \(aq_key\(aqという2つのカラムがあります。\(aq_id\(aqはgroongaが自動的に付与するID番号が格納されるカラムです。\(aq_key\(aqは主キーが格納されるカラムです。これらのカラム名を変更することはできません。
+\fB/commands/table_create\fP コマンドで作成したテーブルには、最初から_id, _keyという2つのカラムがあります。_idはgroongaが自動的に付与するID番号が格納されるカラムです。_keyは主キーが格納されるカラムです。これらのカラム名を変更することはできません。
 .SS カラムの作成
 .sp
 \fB/commands/column_create\fP コマンドを用いて、カラムを作成することができます。
 .sp
-ここでは、ShortText型の値を持つ\(aqtitle\(aqという名前のカラムを\(aqSite\(aqテーブルに追加してみましょう。
+それでは、カラムを作成してみましょう。以下の例では、新しいカラムをSiteテーブルに追加します。 \fItable\fP 引数はテーブルの名前を指定します。 \fIname\fP 引数は新しいカラムの名前を指定します。 \fItype\fP 引数はカラムに格納する値の型を指定します。
 .sp
 実行例:
 .sp
 .nf
 .ft C
-> column_create \-\-table Site \-\-name title \-\-flags COLUMN_SCALAR \-\-type ShortText
-[[0,1317212712.91734,0.077833747],true]
+> column_create \-\-table Site \-\-name title \-\-type ShortText
+[[0,1332484899.08879,0.00948214530944824],true]
 > select \-\-table Site
-[[0,1317212713.19572,0.000121119],[[[0],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"]]]]]
+[[0,1332484899.29974,0.000299215316772461],[[[0],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"]]]]]
 .ft P
 .fi
+.SS データのロード
 .sp
-COLUMN_SCALAR は\(aqcomment\(aqを通常のカラムとして作成することを指示しています。
-.SS 全文検索用の語彙表の作成
-.sp
-そろそろ全文検索の使い方について見ていきましょう。
-.sp
-groongaでは転置インデックスを使って高速な全文検索を実現しています。そのため、まずは転置インデックスとして用いるテーブルを作成する必要があります。テーブルの内容は、文書に含まれる単語やN\-gramなどの索引語を主キーとして、各カラムに索引語の位置情報を格納するという構成になります。結果として、主キーのカラムは全文検索における語彙表の役割を果たします。
+\fB/commands/load\fP コマンドは、JSON形式のレコードを受け取り、テーブルに格納します。
 .sp
-以下の例では、\(aqTerms\(aqという名前のテーブルを転置インデックスとして作成しています。索引語を格納するため、主キーの型はShortTextです。
+以下の例では9つのレコードをSiteテーブルに格納します。
 .sp
 実行例:
 .sp
 .nf
 .ft C
-> table_create \-\-name Terms \-\-flags TABLE_PAT_KEY|KEY_NORMALIZE \-\-key_type ShortText \-\-default_tokenizer TokenBigram
-[[0,1317212713.39679,0.092312046],true]
+> load \-\-table Site
+> [
+> {"_key":"http://example.org/","title":"This is test record 1!"},
+> {"_key":"http://example.net/","title":"test record 2."},
+> {"_key":"http://example.com/","title":"test test record three."},
+> {"_key":"http://example.net/afr","title":"test record four."},
+> {"_key":"http://example.org/aba","title":"test test test record five."},
+> {"_key":"http://example.com/rab","title":"test test test test record six."},
+> {"_key":"http://example.net/atv","title":"test test test record seven."},
+> {"_key":"http://example.org/gat","title":"test test record eight."},
+> {"_key":"http://example.com/vdw","title":"test test record nine."},
+> ]
+[[0,1332484899.50234,2.20460820198059],9]
 .ft P
 .fi
 .sp
-この実行例には、多くのパラメータが指定されています。本チュートリアルでは、これらをすべて理解する必要はありません。以下に簡単な説明を記しますが、読み飛ばしてもらってかまいません。
-.sp
-実行例にあるTABLE_PAT_KEY|KEY_NORMALIZEという値は、主キー値をパトリシア木に格納することと、各索引語を正規化して登録することを示しています。また、default_tokenizerというパラメータには、検索の対象となる文書をトークナイズする方式を与えるようになっています。この例では、一般的にN\-gramと呼ばれるインデックス方式に対応するTokenBigramを指定しています。
-.SS 全文検索用のインデックスカラムの作成
-.sp
-次に必要なのは、インデックス型のカラムを作成することです。このカラムは、関連付けられたカラムに対する全文検索に利用されます。つまり、全文検索を行いたいカラムに対してインデックスを作成することに相当します。
+実行結果の第2要素はロードされたレコードの数を示しています。上記の操作では、すべてのレコードを問題なくロードできています。
 .sp
-それでは、Siteテーブルのtitleカラムを全文検索の対象とするべく、インデックス型のカラムを作成してみましょう。
+念のため、データが入っていることを確認してみましょう。
 .sp
 実行例:
 .sp
 .nf
 .ft C
-> column_create \-\-table Terms \-\-name blog_title \-\-flags COLUMN_INDEX|WITH_POSITION \-\-type Site \-\-source title
-[[0,1317212713.68994,0.19739078],true]
+> select \-\-table Site
+[[0,1332484901.90868,0.000381231307983398],[[[9],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"]],[1,"http://example.org/","This is test record 1!"],[2,"http://example.net/","test record 2."],[3,"http://example.com/","test test record three."],[4,"http://example.net/afr","test record four."],[5,"http://example.org/aba","test test test record five."],[6,"http://example.com/rab","test test test test record six."],[7,"http://example.net/atv","test test test record seven."],[8,"http://example.org/gat","test test record eight."],[9,"http://example.com/vdw","test test record nine."]]]]
 .ft P
 .fi
+.SS レコードの取得
 .sp
-Siteテーブルのtitleカラムを検索対象とする、\(aqblog_title\(aqという名前のインデックス型カラムをTermsテーブルに作成しました。インデックス対象となるテーブルをtypeに、インデックス対象となるカラムをsourceに指定します。実行例のflagsのCOLUMN_INDEX|WITH_POSITIONという値は、索引語の位置情報を格納するインデックス型のカラムであることを示しています。通常の全文検索インデックスでは、COLUMN_INDEX|WITH_POSITIONを指定してください。索引語の位置情報を格納する意味については、本チュートリアルでは触れません。
-.SS データのロード
+\fB/commands/select\fP コマンドを用いて、テーブルの中身を表示することができます。
 .sp
-\fB/commands/load\fP コマンドを使用します。loadコマンドでは、json形式で受け取ったデータをテーブルに格納します。
+\fIquery\fP 引数を使って検索条件が指定された場合、 \fB/commands/select\fP コマンドは検索条件に適合するレコードを検索し、検索結果を出力します。
 .sp
-以下の例では9つのレコードをSiteテーブルに格納します。
+それでは、IDを指定してレコードを取り出してみましょう。以下の例では、Siteテーブルの先頭レコードを取り出します。正確には、 \fIquery\fP 引数を使って _id カラムに1が格納されているレコードを要求しています。
 .sp
 実行例:
 .sp
 .nf
 .ft C
-> load \-\-table Site
-> [
-> {"_key":"http://example.org/","title":"This is test record 1!"},
-> {"_key":"http://example.net/","title":"test record 2."},
-> {"_key":"http://example.com/","title":"test test record three."},
-> {"_key":"http://example.net/afr","title":"test record four."},
-> {"_key":"http://example.org/aba","title":"test test test record five."},
-> {"_key":"http://example.com/rab","title":"test test test test record six."},
-> {"_key":"http://example.net/atv","title":"test test test record seven."},
-> {"_key":"http://example.org/gat","title":"test test record eight."},
-> {"_key":"http://example.com/vdw","title":"test test record nine."},
-> ]
-[[0,1317212714.08816,2.203527402],9]
+> select \-\-table Site \-\-query _id:1
+[[0,1332484902.11683,0.000809431076049805],[[[1],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"]],[1,"http://example.org/","This is test record 1!"]]]]
 .ft P
 .fi
 .sp
-selectコマンドで、データが入っていることを確認しましょう。
+次に、主キーを指定してレコードを取り出してみましょう。以下の例では、主キーが "\fI\%http://example.org/\fP" のキーを取り出します。正確には、 \fIquery\fP 引数を使って _key カラムに "\fI\%http://example.org/\fP" が格納されているレコードを要求しています。
 .sp
 実行例:
 .sp
 .nf
 .ft C
-> select \-\-table Site
-[[0,1317212716.49285,0.000270908],[[[9],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"]],[1,"http://example.org/","This is test record 1!"],[2,"http://example.net/","test record 2."],[3,"http://example.com/","test test record three."],[4,"http://example.net/afr","test record four."],[5,"http://example.org/aba","test test test record five."],[6,"http://example.com/rab","test test test test record six."],[7,"http://example.net/atv","test test test record seven."],[8,"http://example.org/gat","test test record eight."],[9,"http://example.com/vdw","test test record nine."]]]]
+> select \-\-table Site \-\-query \(aq_key:"http://example.org/"\(aq
+[[0,1332484902.32106,0.000850200653076172],[[[1],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"]],[1,"http://example.org/","This is test record 1!"]]]]
 .ft P
 .fi
-.SS データの検索
+.SS 全文検索用の語彙表の作成
+.sp
+そろそろ全文検索の使い方について見ていきましょう。
 .sp
-データの準備もできたので全文検索を試してみたいところですが、その前に、\(aq_id\(aqカラムと\(aq_key\(aqカラムを用いた検索を行ってみましょう。これらのカラムは値を指定すればレコードが一意に決まります。
+groongaでは転置インデックスを使って高速な全文検索を実現しています。そのため、まずは転置インデックスとして用いるテーブルを作成する必要があります。テーブルの内容は、文書に含まれる単語やN\-gramなどの索引語を主キーとして、各カラムに索引語の位置情報を格納するという構成になります。結果として、主キーのカラムは全文検索における語彙表の役割を果たします。
 .sp
-selectコマンドにおいて、queryパラメータを用いるとデータの検索を行うことができます。
+以下の例では、Termsという名前のテーブルを転置インデックスの語彙表として作成しています。索引語を格納するため、主キーの型はShortTextです。
 .sp
 実行例:
 .sp
 .nf
 .ft C
-> select \-\-table Site \-\-query _id:1
-[[0,1317212716.69871,0.000308514],[[[1],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"]],[1,"http://example.org/","This is test record 1!"]]]]
+> table_create \-\-name Terms \-\-flags TABLE_PAT_KEY|KEY_NORMALIZE \-\-key_type ShortText \-\-default_tokenizer TokenBigram
+[[0,1332484902.52532,0.00777173042297363],true]
 .ft P
 .fi
 .sp
-queryパラメータに与えた「_id:1」というのは、\(aq_id\(aqという名前のカラムに\(aq1\(aqという値が入っているレコードを検索する、という意味です。
+\fB/commands/table_create\fP には多くの引数が指定されているものの、本チュートリアルではすべてを理解する必要はありません。以下に簡単な説明を述べますが、読み飛ばしてもらってかまいません。
 .sp
-_keyでも検索してみましょう。
+TABLE_PAT_KEYフラグは、主キーをパトリシア木に格納することを指示しています。KEY_NORMALIZEフラグは、索引語を正規化して登録することを指示しています。 \fIdefault_tokenizer\fP 引数には、検索対象の文書をトークナイズする方式を指定するようになっています。上記の例では、一般的にN\-gramと呼ばれるインデックス方式に対応するTokenBigramを指定しています。
+.SS 全文検索用のインデックスカラムの作成
+.sp
+次に必要なのは、インデックス型のカラムを作成することです。このカラムは、関連付けられたカラムに対する全文検索に利用されます。つまり、全文検索を行いたいカラムに対してインデックスを作成することに相当します。
+.sp
+それでは、インデックスカラムを作成してみましょう。以下の例では、Siteテーブルのカラムに対するインデックスカラムを作成します。それでは、Siteテーブルのtitleカラムを全文検索の対象とするべく、インデックス型のカラムを作成してみましょう。
 .sp
 実行例:
 .sp
 .nf
 .ft C
-> select \-\-table Site \-\-query "_key:\e"http://example.org/\e""
-[[0,1317212716.9005,0.000478343],[[[1],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"]],[1,"http://example.org/","This is test record 1!"]]]]
+> column_create \-\-table Terms \-\-name blog_title \-\-flags COLUMN_INDEX|WITH_POSITION \-\-type Site \-\-source title
+[[0,1332484902.73511,0.0202178955078125],true]
 .ft P
 .fi
 .sp
-queryパラメータに与えた「_key:"\fI\%http://example.org/\fP"」というのは、\(aq_key\(aqという名前のカラムに\(aq"\fI\%http://example.org/\fP"\(aqという値が入っているレコードを検索する、という意味です。
+\fItable\fP 引数は語彙表を指定し、 \fIname\fP 引数はインデックスカラムを指定します。また、 \fItype\fP 引数はインデックスの対象となるテーブルを指定し、 \fIsource\fP 引数はインデックスの対象となるカラムを指定します。COLUMN_INDEXフラグはインデックスカラムの作成を指示し、WITH_POSITIONフラグは各索引語の位置情報をインデックスに含めることを指示します。一般的な全文検索インデックスを作成したいときは、COLUMN_INDEX|WITH_POSITIONを指定してください。索引語の位置情報については、本チュートリアルでは触れません。
+.IP ノート
+語彙表とインデックスカラムを作成するタイミングは、データをロードする前後のどちらでも問題ありません。データをロードした後でインデックスを作成し、さらに新しいデータをロードすることもできます。インデックスの作成を指示したタイミングでレコードが既に存在するときは、静的にインデックスを作成します。一方、インデックスを作成した後で追加されたレコードについては、動的にインデックスを更新します。
+.RE
 .SS 全文検索
 .sp
-queryパラメータでは、インデックスを用いた全文検索を行うこともできます。
+インデックスを作成したことにより、 \fB/commands/select\fP コマンドによる全文検索が可能になります。
+.sp
+全文検索のクエリは \fIquery\fP 引数により指定することができます。以下の例では、titleカラムに "this" という文字列が含まれているレコードを検索します。 \fIquery\fP 引数に含まれる \(aq@\(aq は、全文検索を指示しています。語彙表の作成において KEY_NORMALIZE フラグを指定したときは、全角・半角や大文字・小文字などの違いが吸収されることに注意してください。
 .sp
 実行例:
 .sp
 .nf
 .ft C
 > select \-\-table Site \-\-query title:@this
-[[0,1317212717.10303,0.000581287],[[[1],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"]],[1,"http://example.org/","This is test record 1!"]]]]
+[[0,1332484902.95678,0.000878334045410156],[[[1],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"]],[1,"http://example.org/","This is test record 1!"]]]]
 .ft P
 .fi
 .sp
-queryパラメータに与えた「title:@this」は、\(aqtitle\(aqという名前のカラムに\(aqthis\(aqという文字列が含まれているレコードを検索する、という意味を持ちます。この例では1つのレコードが検索条件に該当しています。転置インデックスを作成するときにKEY_NORMALIZEという値を指定したため、大文字と小文字の違いが吸収されていることに注意してください。
+上記の例では、"This" という単語を含む先頭レコードのみが検索条件に適合します。
 .sp
-selectコマンドには、match_columnsというパラメータが存在します。このパラメータはデフォルトで検索対象にするカラムを指定するもので、カラム名を指定しない検索条件にのみ適用されます。[1]_
+\fB/commands/select\fP コマンドには、 \fImatch_columns\fP という引数が存在します。このパラメータはデフォルトで検索対象にするカラムを指定するもので、カラム名を指定しない検索条件にのみ適用されます。 [1]
 .sp
-match_columnsパラメータに\(aqtitle\(aq、queryパラメータに\(aqthis\(aqという文字列を指定すると、上記のクエリと同じ結果を得ることができます。
+"\fI\-\-match_columns\fP title" と "\fI\-\-query\fP this" の組み合わせを指定すると、 "\fI\-\-query\fP title:@this" を指定したときと同じ検索条件になります。
 .sp
 実行例:
 .sp
 .nf
 .ft C
 > select \-\-table Site \-\-match_columns title \-\-query this
-[[0,1317212717.30596,0.000716439],[[[1],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"]],[1,"http://example.org/","This is test record 1!"]]]]
+[[0,1332484903.16096,0.000757932662963867],[[[1],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"]],[1,"http://example.org/","This is test record 1!"]]]]
 .ft P
 .fi
 .SS 出力カラムの指定
 .sp
-selectコマンドにおいて、output_columnsパラメータを用いることで、検索結果に含めるカラムを指定することができます。複数のカラムを指定する場合は、カンマ(,)区切りで指定します。
+\fB/commands/select\fP コマンドにおいて \fIoutput_columns\fP 引数を用いることで、検索結果に含めるカラムを指定することができます。複数のカラムを指定するときは、カンマ（,）区切りでカラムを列挙します。
 .sp
 実行例:
 .sp
 .nf
 .ft C
 > select \-\-table Site \-\-output_columns _key,title,_score \-\-query title:@test
-[[0,1317212717.50916,0.00060758],[[[9],[["_key","ShortText"],["title","ShortText"],["_score","Int32"]],["http://example.org/","This is test record 1!",1],["http://example.net/","test record 2.",1],["http://example.com/","test test record three.",2],["http://example.net/afr","test record four.",1],["http://example.org/aba","test test test record five.",3],["http://example.com/rab","test test test test record six.",4],["http://example.net/atv","test test test record seven.",3],["http://example.org/gat","test test record eight.",2],["http://example.com/vdw","test test record nine.",2]]]]
+[[0,1332484903.36506,0.000709056854248047],[[[9],[["_key","ShortText"],["title","ShortText"],["_score","Int32"]],["http://example.org/","This is test record 1!",1],["http://example.net/","test record 2.",1],["http://example.com/","test test record three.",2],["http://example.net/afr","test record four.",1],["http://example.org/aba","test test test record five.",3],["http://example.com/rab","test test test test record six.",4],["http://example.net/atv","test test test record seven.",3],["http://example.org/gat","test test record eight.",2],["http://example.com/vdw","test test record nine.",2]]]]
 .ft P
 .fi
 .sp
-この例では、「_score」という名前のカラムを含む3つのカラムを指定しています。「_score」という名前のカラムはgroongaの検索結果に含まれるカラムです。このカラムには、全文検索の条件に合致する文書ほど高い数値が入ります。
+上記の例では、_scoreカラムを含む3つのカラムを指定しています。_scoreカラムはgroongaの検索結果に含まれるカラムであり、全文検索の条件に合致するレコードほど高い数値が入ります。
 .SS 表示範囲指定
 .sp
-selectコマンドにおいて、offset,limitパラメータを用いることで、検索結果から指定された範囲のみを表示することができます。大量の検索結果をページで分けて、1ページ分のみを表示したい場合に有用です。
+\fB/commands/select\fP コマンドにおいて \fIoffset\fP 引数と \fIlimit\fP 引数を用いることで、検索結果の一部のみを表示することができます。大量の検索結果を分割してページ単位で表示したい場合などに有用です。
 .sp
-offsetパラメータには、検索結果を返す始点を指定します。1件目から結果を返す場合には、0を指定します。limitパラメータには、検索結果の表示件数を指定します。
+\fIoffset\fP 引数には、検索結果における始点を指定します。検索結果の1件目が必要な場合、 \fIoffset\fP 引数を省略するか、0を指定するようにしてください。 \fIlimit\fP 引数には、検索結果の表示件数を指定します。
 .sp
 実行例:
 .sp
 .nf
 .ft C
 > select \-\-table Site \-\-offset 0 \-\-limit 3
-[[0,1317212717.71574,0.000238544],[[[9],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"]],[1,"http://example.org/","This is test record 1!"],[2,"http://example.net/","test record 2."],[3,"http://example.com/","test test record three."]]]]
+[[0,1332484903.57505,0.000303268432617188],[[[9],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"]],[1,"http://example.org/","This is test record 1!"],[2,"http://example.net/","test record 2."],[3,"http://example.com/","test test record three."]]]]
 > select \-\-table Site \-\-offset 3 \-\-limit 3
-[[0,1317212717.91925,0.00023617],[[[9],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"]],[4,"http://example.net/afr","test record four."],[5,"http://example.org/aba","test test test record five."],[6,"http://example.com/rab","test test test test record six."]]]]
+[[0,1332484903.77936,0.000320196151733398],[[[9],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"]],[4,"http://example.net/afr","test record four."],[5,"http://example.org/aba","test test test record five."],[6,"http://example.com/rab","test test test test record six."]]]]
 > select \-\-table Site \-\-offset 7 \-\-limit 3
-[[0,1317212718.12219,0.00019999],[[[9],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"]],[8,"http://example.org/gat","test test record eight."],[9,"http://example.com/vdw","test test record nine."]]]]
+[[0,1332484903.98409,0.000294685363769531],[[[9],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"]],[8,"http://example.org/gat","test test record eight."],[9,"http://example.com/vdw","test test record nine."]]]]
 .ft P
 .fi
-.SS 並び替え
+.SS 検索結果の並べ替え
 .sp
-selectコマンドにおいて、sortbyパラメータを用いることで、検索結果を並び替えることができます。
+\fB/commands/select\fP コマンドに \fIsortby\fP 引数を渡すことにより、検索結果を並べ替えることができます。
 .sp
-sortbyパラメータにカラム名を指定することで、そのカラムの値で昇順にソートします。また、カラム名の前にハイフン（\-）を付けることで、降順にソートすることもできます。
+\fIsortby\fP 引数には、整列の基準として用いるカラムを指定します。検索結果は指定したカラムの値が昇順になるように並べ替えられます。 \fIsortby\fP 引数の中でカラム名の前にハイフン（\-）を付けることにより、降順に並べ替えることもできます。
+.sp
+以下の例では、Siteテーブルのレコードを逆順に表示しています。
 .sp
 実行例:
 .sp
 .nf
 .ft C
 > select \-\-table Site \-\-sortby \-_id
-[[0,1317212718.32565,0.000385755],[[[9],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"]],[9,"http://example.com/vdw","test test record nine."],[8,"http://example.org/gat","test test record eight."],[7,"http://example.net/atv","test test test record seven."],[6,"http://example.com/rab","test test test test record six."],[5,"http://example.org/aba","test test test record five."],[4,"http://example.net/afr","test record four."],[3,"http://example.com/","test test record three."],[2,"http://example.net/","test record 2."],[1,"http://example.org/","This is test record 1!"]]]]
+[[0,1332484904.18805,0.000293493270874023],[[[9],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"]],[9,"http://example.com/vdw","test test record nine."],[8,"http://example.org/gat","test test record eight."],[7,"http://example.net/atv","test test test record seven."],[6,"http://example.com/rab","test test test test record six."],[5,"http://example.org/aba","test test test record five."],[4,"http://example.net/afr","test record four."],[3,"http://example.com/","test test record three."],[2,"http://example.net/","test record 2."],[1,"http://example.org/","This is test record 1!"]]]]
 .ft P
 .fi
 .sp
-出力カラムの指定で紹介した「_score」カラムは、ソートの条件としても使うことができます。
+次の例では、_scoreカラムを整列の基準とすることにより、検索結果のランキングをおこなっています。検索結果はクエリとの関連性が高い順に並べ替えられます。
 .sp
 実行例:
 .sp
 .nf
 .ft C
-> select \-\-table Site \-\-query title:@test \-\-output_columns _id,_score,title \-\-sortby _score
-[[0,1317212718.5331,0.000667311],[[[9],[["_id","UInt32"],["_score","Int32"],["title","ShortText"]],[1,1,"This is test record 1!"],[2,1,"test record 2."],[4,1,"test record four."],[3,2,"test test record three."],[9,2,"test test record nine."],[8,2,"test test record eight."],[7,3,"test test test record seven."],[5,3,"test test test record five."],[6,4,"test test test test record six."]]]]
+> select \-\-table Site \-\-query title:@test \-\-output_columns _id,_score,title \-\-sortby \-_score
+[[0,1332484904.39402,0.000802755355834961],[[[9],[["_id","UInt32"],["_score","Int32"],["title","ShortText"]],[6,4,"test test test test record six."],[5,3,"test test test record five."],[7,3,"test test test record seven."],[8,2,"test test record eight."],[3,2,"test test record three."],[9,2,"test test record nine."],[1,1,"This is test record 1!"],[4,1,"test record four."],[2,1,"test record 2."]]]]
 .ft P
 .fi
 .sp
-ソートするカラム名を複数指定したい場合は、カンマ(,)区切りで指定します。複数のカラムを指定した場合、最初のカラムで同一の値のレコードがあった場合に、次のカラムの値でソートさせることができます。
+整列の基準となるカラムを複数指定したいときは、カンマ（,）区切りでカラムを列挙します。複数のカラムを指定したときは、最初のカラムを基準として整列した後、最初のカラムに同じ値が格納されているレコードを次のカラムを基準として整列します。
 .sp
 実行例:
 .sp
 .nf
 .ft C
-> select \-\-table Site \-\-query title:@test \-\-output_columns _id,_score,title \-\-sortby _score,_id
-[[0,1317212718.73819,0.00069225],[[[9],[["_id","UInt32"],["_score","Int32"],["title","ShortText"]],[1,1,"This is test record 1!"],[2,1,"test record 2."],[4,1,"test record four."],[3,2,"test test record three."],[8,2,"test test record eight."],[9,2,"test test record nine."],[5,3,"test test test record five."],[7,3,"test test test record seven."],[6,4,"test test test test record six."]]]]
+> select \-\-table Site \-\-query title:@test \-\-output_columns _id,_score,title \-\-sortby \-_score,_id
+[[0,1332484904.60132,0.000498056411743164],[[[9],[["_id","UInt32"],["_score","Int32"],["title","ShortText"]],[6,4,"test test test test record six."],[5,3,"test test test record five."],[7,3,"test test test record seven."],[3,2,"test test record three."],[8,2,"test test record eight."],[9,2,"test test record nine."],[1,1,"This is test record 1!"],[2,1,"test record 2."],[4,1,"test record four."]]]]
 .ft P
 .fi
 脚注
 .IP [1] 5
-現在のバージョンでは、全文検索インデックスが存在する場合にのみ、match_columnsパラメータを利用することができます。通常のカラムでの絞り込みには利用できません。
-.SS ネットワークを通じた利用
+現在のバージョンでは、全文検索インデックスが存在する場合にのみ、 \fImatch_columns\fP 引数を利用することができます。通常のカラムでの絞り込みには利用できません。
+.SS リモートアクセス
+.sp
+groongaをサーバとして起動することにより、ネットワークを介してデータベースにアクセスできるようになります。groongaがサポートしているプロトコルは、groongaの専用プロトコルであるgqtp、memcachedバイナリプロトコル、HTTPの三種類です。
+.SS groonga専用プロトコル（gqtp）
+.SS gqtpサーバの起動
 .sp
-groongaはネットワークを通じて利用することができます。groonga独自プロトコルもしくはHTTPのどちらかを選択してgroongaを起動することにより、groongaはネットワーク接続を待ち受けます。
-.SS groonga専用プロトコルによる通信
-.SS groongaデーモンの起動
+groongaには、専用のプロトコルであるgqtpが存在します。gqtpを用いることにより、データベースへとリモートアクセスすることができます。以下の書式はgqtpサーバの起動方法を示しています。
 .sp
 書式:
 .sp
 .nf
 .ft C
-groonga [\-p PORT_NUMBER] \-d DB_PATH_NAME
+groonga [\-p PORT_NUMBER] \-s DB_PATH
 .ft P
 .fi
 .sp
-既存のデータベースのフルパス名をDBパス名に指定します。groongaがデーモンモードで起動し、指定したポート番号でgroongaの専用プロトコルを用いた通信をすることができます。(ポート番号を省略した場合は10041が使用されます)
+\fI\-s\fP オプションはgroongaをサーバとして起動するためのオプションです。DB_PATHには既存のデータベースのパスを指定します。 \fI\-p\fP オプションとその引数により、サーバのポート番号を指定することができます。ポート番号を省略した場合は10041が使用されます。
+.sp
+以下のコマンドにより、デフォルトのポート番号で待ち受けるサーバを起動することができます。サーバは指定されたデータベースへの操作を受け付けます。
+.sp
+実行例:
+.sp
+.nf
+.ft C
+% groonga \-s /tmp/groonga\-databases/introduction.db
+Ctrl\-c
+%
+.ft P
+.fi
+.SS gqtpデーモンの起動
+.sp
+gqtpサーバはデーモンとして起動することができます。オプションとして、 \fI\-s\fP の代わりに \fI\-d\fP を与えてください。
+.sp
+書式:
+.sp
+.nf
+.ft C
+groonga [\-p PORT_NUMBER] \-d DB_PATH
+.ft P
+.fi
+.sp
+groongaをデーモンとして起動したときは、デーモンのプロセスIDが表示されます。以下の例では、12345というプロセスIDが表示されています。サーバとして起動した場合と同様に、指定されたデータベースへの操作を受け付けます。
 .sp
 実行例:
 .sp
@@ -817,9 +953,9 @@ groonga [\-p PORT_NUMBER] \-d DB_PATH_NAME
 %
 .ft P
 .fi
+.SS gqtpサーバへの接続
 .sp
-デーモンモードで起動後、プロセス番号が表示されます。
-.SS groongaサーバへの接続
+gtqpサーバに接続するクライアントは、以下のように起動します。
 .sp
 書式:
 .sp
@@ -829,11 +965,7 @@ groonga [\-p PORT_NUMBER] \-c [HOST_NAME_OR_IP_ADDRESS]
 .ft P
 .fi
 .sp
-対象ホストで動作しているgroongaサーバに接続します。
-.sp
-対象ホスト名を省略した場合はlocalhostに対して接続し、対象ポート番号を省略した場合は10041ポートに対して接続します。
-.sp
-接続に成功すると対話モードに入り、標準入力からコマンドを読み込んで順次実行します。
+上記のコマンドによって起動されたクライアントは、サーバとの接続に成功すると対話モードに入ります。HOST_NAME_OR_IP_ADDRESSにはサーバのホスト名もしくはIPアドレスを指定します。HOST_NAME_OR_IP_ADDRESSが省略されたときは"localhost"をサーバのホスト名として採用します。また、 \fI\-p\fP オプションとその引数により、サーバのポート番号を指定することができます。ポート番号を省略した場合は10041が使用されます。
 .sp
 実行例:
 .sp
@@ -841,14 +973,16 @@ groonga [\-p PORT_NUMBER] \-c [HOST_NAME_OR_IP_ADDRESS]
 .ft C
 % groonga \-c
 > status
-[[0,1317212813.13814,0.000102148],{"alloc_count":184,"starttime":1317212806,"uptime":7,"version":"1.2.5\-84\-g5c190df","n_queries":14,"cache_hit_rate":0.0,"command_version":1,"default_command_version":1,"max_command_version":2}]
+[[0,1332486613.4953,9.918212890625e\-05],{"alloc_count":130,"starttime":1332486613,"uptime":0,"version":"2.0.0\-250\-g5a3cf19","n_queries":0,"cache_hit_rate":0.0,"command_version":1,"default_command_version":1,"max_command_version":2}]
 > ctrl\-d
 %
 .ft P
 .fi
-.SS groongaデーモンの終了
 .sp
-groongaデーモンにshutdownコマンドを発行することにより、終了させることができます。
+対話モードでは、標準入力からコマンドを読み込んで順次実行します。
+.SS gqtpサーバの終了
+.sp
+gqtpサーバを終了する安全は方法は、クライアントを起動して \fB/commands/shutdown\fP を発行することです。
 .sp
 実行例:
 .sp
@@ -859,128 +993,256 @@ groongaデーモンにshutdownコマンドを発行することにより、終
 %
 .ft P
 .fi
-.SS HTTPによる通信
+.SS memcachedバイナリプロトコル
 .sp
-groongaをHTTP経由で利用したい場合には、HTTPプロトコルモードで起動します。
+groongaはmemcachedバイナリプロトコルをサポートしています。以下の書式はmemcachedバイナリプロトコルのサーバをデーモンとして起動する方法を示しています。
 .sp
 書式:
 .sp
 .nf
 .ft C
-groonga [\-p PORT_NUMBER] \-d \-\-protocol http DB_PATH_NAME
+groonga [\-p PORT_NUMBER] \-d \-\-protocol memcached DB_PATH
 .ft P
 .fi
 .sp
-protocolオプションで、groongaが受け付けるプロトコルを指定できます。httpを指定すると、groongaはHTTPプロトコルでの通信を受け付けます。
-.SS HTML管理ツール
+\fI\-\-protocol\fP オプションとその引数により、サーバのプロトコルを指定することができます。"memcached"はmemcachedバイナリプロトコルを示しています。
+.SS HTTP
+.SS HTTPサーバの起動
+.sp
+groongaはHTTPをサポートしています。以下の書式はHTTPサーバをデーモンとして起動する方法を示しています。
 .sp
-コマンド実行後、http://[IPアドレスまたはホスト名]:[ポート番号]/ というURLにブラウザからアクセスすると、HTML管理ツールが表示されます。ブラウザは、JavaScriptの実行が有効になっている必要があります。
-.SS HTTPでのコマンド実行
+書式:
+.sp
+.nf
+.ft C
+groonga [\-p PORT_NUMBER] \-d \-\-protocol http DB_PATH
+.ft P
+.fi
 .sp
-groongaがHTTPプロトコルモードで起動されているとき、「/d/コマンド名」というURLにアクセスすると、コマンドを実行することができます。
+\fI\-\-protocol\fP オプションとその引数により、サーバのプロトコルを指定することができます。"http"はHTTPサーバの起動を指示しています。
 .sp
-コマンドのオプションは、HTTPのGETパラメータで渡します。つまり、「?オプション=値&オプション=値 …」という書式になります。
+以下のコマンドは、ポート番号80で待ち受けるHTTPサーバをデーモンとして起動します。
 .sp
 実行例:
 .sp
 .nf
 .ft C
-http://[IPまたはホスト名]:[ポート番号]/d/status
-実行される処理：
+% groonga \-p 80 \-d \-\-protocol http /tmp/groonga\-databases/introduction.db
+%
+.ft P
+.fi
+.SS HTTPサーバへのコマンド送信
+.sp
+groongaがHTTPサーバとして起動されているときは、/d/COMMAND_NAME というURLにアクセスすることにより、コマンドを実行することができます。コマンドの引数は、HTTPのGETパラメータとして渡します。引数の書式は "?NAME_1=VALUE_1&NAME_2=VALUE_2&..." となります。
+.sp
+以下の例は、HTTPサーバに対するコマンドの送り方を示しています。
+.sp
+実行例:
+.sp
+.nf
+.ft C
+http://HOST_NAME_OR_IP_ADDRESS[:PORT_NUMBER]/d/status
+Executed command:
 > status
-[[0,1317212813.33982,0.000109691],{"alloc_count":184,"starttime":1317212806,"uptime":7,"version":"1.2.5\-84\-g5c190df","n_queries":14,"cache_hit_rate":0.0,"command_version":1,"default_command_version":1,"max_command_version":2}]
+[[0,1332486613.69917,0.000123739242553711],{"alloc_count":131,"starttime":1332486613,"uptime":0,"version":"2.0.0\-250\-g5a3cf19","n_queries":0,"cache_hit_rate":0.0,"command_version":1,"default_command_version":1,"max_command_version":2}]
-http://[IPまたはホスト名]:[ポート番号]/d/select?table=Site&query=title:@this
-実行される処理：
+http://HOST_NAME_OR_IP_ADDRESS[:PORT_NUMBER]/d/select?table=Site&query=title:@this
+Executed command:
 > select \-\-table Site \-\-query title:@this
-[[0,1317212813.54112,6.7993e\-05],[[[1],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"]],[1,"http://example.org/","This is test record 1!"]]]]
+[[0,1332486613.90319,0.00245404243469238],[[[1],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"]],[1,"http://example.org/","This is test record 1!"]]]]
 .ft P
 .fi
+.SS ブラウザベースの管理ツール
+.sp
+groongaをHTTPサーバとして起動しているときは、ブラウザベースの管理ツールを使うことにより、データベースを簡単に管理することができます。管理ツールを使いたいときは、ブラウザを使って \fI\%http://HOST_NAME_OR_IP_ADDRESS[:PORT_NUMBER]/\fP へとアクセスしてください。管理ツールの使用には、JavaScriptの実行が有効になっている必要があります。
 .SS セキュリティ
 .sp
-groongaのネットワークサービスには認証機能がありません。誰でもデータベースの内容を閲覧・修正することができます。iptablesなどを用いて、アクセス元IPアドレスを制限することを薦めます。
-.SS さまざまな種類をもったデータの保存
+groongaのサーバには認証機能がありません。誰でもデータベースの内容を閲覧・修正することができます。iptablesなどを用いてアクセス元IPアドレスを制限することを推奨します。
+.SS いろいろなデータの保存
 .sp
-groongaでは、さまざまなデータを格納させることが出来ます。
-.SS データ型
+groongaは全文検索エンジンを起源として独自のカラムストアを持つに至るわけですが、索引語や文書を保存するだけでなく、数値や文字列、日時や経緯度など、いろいろなデータを保存することができます。本チュートリアルでは、groongaで保存できるデータの種類、およびに保存の方法を説明します。
+.SS データの種類
+.sp
+groongaにおいて利用できる基本型は、真偽値、数値、文字列、日時、経緯度の5種類に大別できます。基本型において、数値は整数・浮動小数点数の違い、符号の有無と割り当てるビット数によって細分化できるほか、文字列は長さの上限によって細分化できます。また、経緯度には測地系による分類があります。詳しくは \fB/type\fP を参照してください。
+.sp
+拡張型としては、別テーブルを参照するための情報であるテーブル参照を保存することができます。また、基本型もしくはテーブル参照を複数まとめて保存できるように、ベクターカラムをサポートしています。
+.sp
+それでは、本チュートリアルで使用するテーブルを作成しておきましょう。
+.sp
+実行例:
+.sp
+.nf
+.ft C
+> table_create \-\-name ToyBox \-\-flags TABLE_HASH_KEY \-\-key_type ShortText
+[[0,1332498286.03578,0.00542259216308594],true]
+.ft P
+.fi
+.SS 真偽値
+.sp
+ブール型は真偽値（true/false）を表現するための型です。ブール型のカラムを作成するには、 \fB/commands/column_create\fP コマンドの \fItype\fP 引数に Bool を指定します。ブール型のデフォルト値はfalseです。
+.sp
+以下の例では、ブール型のカラムを作成し、3つのレコードを追加します。3番目のレコードについては、値を省略しているため、デフォルト値が格納されます。
+.sp
+実行例:
+.sp
+.nf
+.ft C
+> column_create \-\-table ToyBox \-\-name is_animal \-\-type Bool
+[[0,1332498286.2427,0.00578594207763672],true]
+> load \-\-table ToyBox
+> [
+> {"_key":"Monkey","is_animal":true}
+> {"_key":"Flower","is_animal":false}
+> {"_key":"Block"}
+> ]
+[[0,1332498286.44978,1.00197458267212],3]
+> select \-\-table ToyBox \-\-output_columns _key,is_animal
+[[0,1332498287.65257,0.000472545623779297],[[[3],[["_key","ShortText"],["is_animal","Bool"]],["Monkey",true],["Flower",false],["Block",false]]]]
+.ft P
+.fi
+.SS 数値
+.sp
+数値型は、整数と浮動小数点数に分けることができます。整数は、符号付き整数と符号なし整数に分けることができるだけでなく、割り当てるビット数によっても分けることができます。割り当てるビット数を大きくすると、カラムのサイズは大きくなってしまいますが、表現できる整数の範囲を大きくすることができます。詳しくは \fB/type\fP を参照してください。数値型のデフォルト値はいずれも0です。
 .sp
-groongaでは、数値（整数・小数）や文字列や時刻や経緯度などの情報を格納することができます。
+以下の例では、Int8型のカラムとFloat型のカラムを作成し、既存のレコードを更新します。weightカラムについては、指定した値が問題なく格納されています。一方、priceカラムに指定した小数については、小数点以下を切り捨てた値が格納されています。また、表現できる範囲を超える値を格納しようとした2番目のレコードについては、指定した値とは異なる値が格納されています。このように、表現できる範囲を超える値を指定すると、操作後の値は未定義になるので注意してください。
 .sp
-ここでは、Int32型のカラムに整数を格納、Float型のカラムに浮動小数点の小数を、ShortText型のカラムに文字列を、Time型のカラムに時間を格納する例を示します。経緯度の格納については、のちのチュートリアルで触れます。
+実行例:
+.sp
+.nf
+.ft C
+> column_create \-\-table ToyBox \-\-name price \-\-type Int8
+[[0,1332498287.85609,0.00574946403503418],true]
+> column_create \-\-table ToyBox \-\-name weight \-\-type Float
+[[0,1332498288.06304,0.00493621826171875],true]
+> load \-\-table ToyBox
+> [
+> {"_key":"Monkey","price":15.9}
+> {"_key":"Flower","price":200,"weight":0.13}
+> {"_key":"Block","weight":25.7}
+> ]
+[[0,1332498288.26924,1.00213837623596],3]
+> select \-\-table ToyBox \-\-output_columns _key,price,weight
+[[0,1332498289.47254,0.000308036804199219],[[[3],[["_key","ShortText"],["price","Int8"],["weight","Float"]],["Monkey",15,0.0],["Flower",\-56,0.13],["Block",0,25.7]]]]
+.ft P
+.fi
+.SS 文字列
+.sp
+文字列型は、長さの上限によって分けることができます。詳しくは \fB/type\fP を参照してください。文字列型のデフォルト値は長さ0の文字列です。
 .sp
-その他のデータ型の一覧は、 \fB/type\fP を参照してください。
+以下の例では、ShortText型のカラムを作成し、IDが1と2のレコードを更新します。更新しないレコードについては、デフォルト値のままとなります。
 .sp
 実行例:
 .sp
 .nf
 .ft C
-> table_create \-\-name Type \-\-flags TABLE_HASH_KEY \-\-key_type ShortText
-[[0,1322616293.7274,0.012551106],true]
-> column_create \-\-table Type \-\-name number \-\-type Int32
-[[0,1322616293.94115,0.008619605],true]
-> column_create \-\-table Type \-\-name float \-\-type Float
-[[0,1322616294.15095,0.004959989],true]
-> column_create \-\-table Type \-\-name string \-\-type ShortText
-[[0,1322616294.35693,0.005551818],true]
-> column_create \-\-table Type \-\-name time \-\-type Time
-[[0,1322616294.56333,0.006356953],true]
-> load \-\-table Type
-> [{"_key":"sample","number":12345,"float":42.195,"string":"GROONGA","time":1234567890.12}]
-[[0,1322616294.77086,0.202357708],1]
-> select \-\-table Type
-[[0,1322616295.1744,0.000340057],[[[1],[["_id","UInt32"],["_key","ShortText"],["float","Float"],["number","Int32"],["string","ShortText"],["time","Time"]],[1,"sample",42.195,12345,"GROONGA",1234567890.12]]]]
+> column_create \-\-table ToyBox \-\-name name \-\-type ShortText
+[[0,1332498289.67627,0.00676369667053223],true]
+> load \-\-table ToyBox
+> [
+> {"_key":"Monkey","name":"Grease"}
+> {"_key":"Flower","name":"Rose"}
+> ]
+[[0,1332498289.88434,0.801783800125122],2]
+> select \-\-table ToyBox \-\-output_columns _key,name
+[[0,1332498290.88724,0.000265598297119141],[[[3],[["_key","ShortText"],["name","ShortText"]],["Monkey","Grease"],["Flower","Rose"],["Block",""]]]]
 .ft P
 .fi
-.SS テーブル型
+.SS 日時
 .sp
-table_createで作成したテーブルを、カラムの型として使うことが出来ます。
+日時を表現するための型はTimeです。内部では1970年1月1日0時0分0秒を基準とする経過時間をマイクロ秒単位で表現します。符号付きの整数を用いるため、1970年以前の日時も表現することができます。内部表現はマイクロ秒単位の整数ですが、 \fB/commands/load\fP コマンドおよび \fB/commands/select\fP コマンドでは、経過秒数による指定・表示となります。デフォルト値は1970年1月1日0時0分0秒のことを表す0.0です。
 .sp
-また、output_columnsにおいて「.」を区切りとして、参照先のテーブルに存在するカラムを指定すると、指定したカラムの値を表示することができます。
+以下の例では、Time型のカラムを作成し、IDが2と3のレコードを更新します。更新しないレコードについては、デフォルト値のままとなります。
 .sp
-ここでは、先のチュートリアルで作成したSiteテーブルに手を加え、どのサイトをリンクしているのかを保存してみましょう。
+実行例:
 .sp
-他のテーブルを参照するカラムにデータを入力する場合には、参照先のテーブルの_keyカラムの値を代入する必要があります。
+.nf
+.ft C
+> column_create \-\-table ToyBox \-\-name time \-\-type Time
+[[0,1332498291.0906,0.00631809234619141],true]
+> load \-\-table ToyBox
+> [
+> {"_key":"Flower","time":1234567890.1234569999}
+> {"_key":"Block","time":\-1234567890}
+> ]
+[[0,1332498291.29814,0.801807641983032],2]
+> select \-\-table ToyBox \-\-output_columns _key,time
+[[0,1332498292.30117,0.000299692153930664],[[[3],[["_key","ShortText"],["time","Time"]],["Monkey",0.0],["Flower",1234567890.12346],["Block",\-1234567890.0]]]]
+.ft P
+.fi
+.SS 経緯度
+.sp
+経緯度を表現するための型は、測地系によって分けることができます。詳しくは \fB/type\fP を参照してください。経緯度の指定・表示には、以下に示す形式の文字列を使います。
+.INDENT 0.0
+.IP \(bu 2
+"経度のミリ秒表記x緯度のミリ秒表記" （例: "128452975x503157902"）
+.IP \(bu 2
+"経度の度数表記x緯度の度数表記" （例: "35.6813819x139.7660839"）
+.UNINDENT
+.sp
+小数点を含んでいなければミリ秒表記、小数点を含んでいれば度数表記として扱われます。ミリ秒表記と度数表記を混ぜたときの動作は未定義なので注意してください。経度と緯度の区切りとしては、\(aqx\(aq のほかに \(aq,\(aq を使うことができます。経緯度のデフォルト値は "0x0" です。
+.sp
+以下の例では、世界測地系を用いるWGS84GeoPoint型のカラムを作成し、IDが1と3のレコードを更新します。更新しないレコードについては、デフォルト値のままとなります。
+.sp
+実行例:
+.sp
+.nf
+.ft C
+> column_create \-\-table ToyBox \-\-name location \-\-type WGS84GeoPoint
+[[0,1332498292.50467,0.0079643726348877],true]
+> load \-\-table ToyBox
+> [
+> {"_key":"Monkey","location":"128452975x503157902"}
+> {"_key":"Block","location":"35.6813819x139.7660839"}
+> ]
+[[0,1332498292.71385,0.801813840866089],2]
+> select \-\-table ToyBox \-\-output_columns _key,location
+[[0,1332498293.71678,0.000298976898193359],[[[3],[["_key","ShortText"],["location","WGS84GeoPoint"]],["Monkey","128452975x503157902"],["Flower","0x0"],["Block","128452975x503157902"]]]]
+.ft P
+.fi
+.SS テーブル参照
+.sp
+groongaでは、テーブル参照のカラム、すなわち関連付けたテーブルを参照するカラムを作成できます。より正確には、カラム作成時に参照先となるテーブルとの関連付けをおこない、参照先テーブルにおけるレコードIDを格納しておくことにより、参照先のレコードにアクセスできるようにします。
+.sp
+テーブル参照のカラムがあるときは、 \fIoutput_columns\fP 引数に "参照元カラム.参照先カラム" と指定することにより、参照先カラムの値を取り出すことができます。参照元カラムのみを指定したときは、 "参照元カラム名._key" と同様の扱いとなり、参照先レコードの主キーが取り出されます。テーブル参照が有効なレコードを指していないときは、参照先カラムのデフォルト値が取り出されるようになっています。
+.sp
+ここでは、先のチュートリアルで作成したSiteテーブルにlinkという新たなカラムを作成し、サイト間のリンク関係を保存できるようにしてみましょう。
 .sp
 実行例:
 .sp
 .nf
 .ft C
 > column_create \-\-table Site \-\-name link \-\-type Site
-[[0,1322616295.37864,0.005674045],true]
+[[0,1332498293.92066,0.00589966773986816],true]
 > load \-\-table Site
 > [{"_key":"http://example.org/","link":"http://example.net/"}]
-[[0,1322616295.5854,0.200879317],1]
+[[0,1332498294.1274,0.201014280319214],1]
 > select \-\-table Site \-\-output_columns _key,title,link._key,link.title \-\-query title:@this
-[[0,1322616295.98732,0.000872177],[[[1],[["_key","ShortText"],["title","ShortText"],["link._key","ShortText"],["link.title","ShortText"]],["http://example.org/","This is test record 1!","http://example.net/","test record 2."]]]]
+[[0,1332498294.52959,0.00171041488647461],[[[1],[["_key","ShortText"],["title","ShortText"],["link._key","ShortText"],["link.title","ShortText"]],["http://example.org/","This is test record 1!","http://example.net/","test record 2."]]]]
 .ft P
 .fi
 .sp
-このように、linkカラムに他のサイトへの参照を保存することができました。また、参照先の_keyとtitleカラムの内容を表示することができました。
+テーブル参照のカラムを作成するときは、 \fItype\fP 引数に参照先テーブルを指定します。この例では、同じテーブルに含まれる別のレコードを参照させたいので、Siteを指定することになります。次に、 "\fI\%http://example.org/\fP" から "\fI\%http://example.net/\fP" へのリンクを登録しています。テーブル参照を作成するときは、IDではなく主キーを指定することに注意してください。最後に、リンクの内容を確認しています。この例では、  \fIoutput_columns\fP 引数に link._key と link.title を指定しているので、参照先の主キーとタイトルが表示されています。
 .SS ベクターカラム
 .sp
-column_createコマンドでカラムを作成するとき、\-\-flagsオプションでCOLUMN_VECTORフラグを指定すると、複数の値を配列で格納できるカラムが作成されます。
+\fB/commands/column_create\fP コマンドでカラムを作成するとき、 \fIflags\fP 引数にCOLUMN_VECTORフラグを指定すると、 \fItype\fP 引数に指定した型の配列を格納するカラムになります。このようなカラムのことは、ベクターカラムと呼びます。ベクターカラムは、各レコードに複数の値を格納できるため、一対多の参照関係を表すのに便利です。
 .sp
-テーブル型で配列を格納するカラムは、1対多の参照関係を表すのに有効です。
-.sp
-テーブル型のチュートリアルでは、Siteテーブルに手を加え、どのサイトをリンクしているのかを保存しました。しかし、通常は1つのサイトから多くのサイトにリンクが張られています。複数のリンク情報を格納するために、複数の参照関係を保存するカラムを作成してみましょう。
-.sp
-他のテーブルを参照するベクターカラムにデータを入力する場合には、参照先のテーブルの_keyカラムの値の「配列」を代入する必要があります。
+さきほどテーブル参照の例として作成したカラムでは、各サイトに一つのリンクしか保存できませんでした。通常は一つのサイトから多くのサイトにリンクが張られているので、これでは残念な仕様になってしまいます。そこで、ベクターカラムを使って、複数のリンクを保存できるようにしてみましょう。
 .sp
 実行例:
 .sp
 .nf
 .ft C
 > column_create \-\-table Site \-\-name links \-\-flags COLUMN_VECTOR \-\-type Site
-[[0,1322616296.19238,0.007598942],true]
+[[0,1332498294.7353,0.00729537010192871],true]
 > load \-\-table Site
 > [{"_key":"http://example.org/","links":["http://example.net/","http://example.org/","http://example.com/"]}]
-[[0,1322616296.40092,0.201036234],1]
+[[0,1332498294.94353,0.200709581375122],1]
 > select \-\-table Site \-\-output_columns _key,title,links._key,links.title \-\-query title:@this
-[[0,1322616296.80305,0.000899975],[[[1],[["_key","ShortText"],["title","ShortText"],["links._key","ShortText"],["links.title","ShortText"]],["http://example.org/","This is test record 1!",["http://example.net/","http://example.org/","http://example.com/"],["test record 2.","This is test record 1!","test test record three."]]]]]
+[[0,1332498295.34514,0.00077366828918457],[[[1],[["_key","ShortText"],["title","ShortText"],["links._key","ShortText"],["links.title","ShortText"]],["http://example.org/","This is test record 1!",["http://example.net/","http://example.org/","http://example.com/"],["test record 2.","This is test record 1!","test test record three."]]]]]
 .ft P
 .fi
 .sp
-このように、複数の参照関係が保存できました。また、output_columnsによって、複数の参照先のカラム値も表示させることができました。
+新たなカラムにはSiteテーブルに対する参照の配列を格納するので、 \fItype\fP 引数にSiteを指定するとともに、 \fIflags\fP 引数にCOLUMN_VECTORフラグを指定しています。次に、 \fB/commands/load\fP による更新では、 "\fI\%http://example.org/\fP" から "\fI\%http://example.net/\fP" へのリンクに加えて、 "\fI\%http://example.org/\fP" と "\fI\%http://example.com/\fP" へのリンクも登録しています。そして、最後にリンクの内容を確認しています。この例では、 \fIoutput_columns\fP 引数に links._key と links.title を指定しているので、参照先の主キーとタイトルをそれぞれ配列にしたものが表示されています。
 .SS さまざまな検索条件の指定
 .sp
 groongaは、JavaScriptに似た文法での条件絞込や、計算した値を用いたソートを行うことができます。また、位置情報(緯度・経度)を用いた絞込・ソートを行うことができます。
@@ -5584,6 +5846,31 @@ groonga\-suggest\-create\-dataset /tmp/db\-path query
 .B Default:
 \fBauto\fP
 .UNINDENT
+.TP
+.B \fBsimilar_search\fP
+補正時に類似検索を実行するかどうかを指定します。
+.sp
+指定可能な値は以下の通りです。
+.INDENT 7.0
+.INDENT 3.5
+.INDENT 0.0
+.TP
+.B \fByes\fP
+常に類似検索を実行します。
+.TP
+.B \fBno\fP
+類似検索を実行しません。
+.TP
+.B \fBauto\fP
+他の検索でレコードが見つからない場合のみ類似検索を実行します。
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.INDENT 7.0
+.TP
+.B Default:
+\fBauto\fP
+.UNINDENT
 .UNINDENT
 .SS 返値
 .SS JSON形式
@@ -6099,123 +6386,132 @@ groongaのデータベースでは、テーブルの主キーや、カラムの
 \fBObject\fP
 .INDENT 0.0
 .INDENT 3.5
-任意のテーブルに属する全てのレコード [1]
+任意のテーブルに属する全てのレコードです。 [1]
 .UNINDENT
 .UNINDENT
 .sp
 \fBBool\fP
 .INDENT 0.0
 .INDENT 3.5
-bool型。trueとfalse。
+ブーリアン型やブール型などと呼ばれる型であり、真偽値を表します。取り得る値はtrueとfalseです。（デフォルト値: false）
+.sp
+\fB/commands/load\fP コマンドで値を格納するときは、false、0、空文字列のいずれかを指定するとfalseになり、それ以外を指定するとtrueになります。
 .UNINDENT
 .UNINDENT
 .sp
 \fBInt8\fP
 .INDENT 0.0
 .INDENT 3.5
-8bit符号付き整数。
+8bit符号付き整数であり、\-128以上127以下の整数を表します。（デフォルト値: 0）
 .UNINDENT
 .UNINDENT
 .sp
 \fBUInt8\fP
 .INDENT 0.0
 .INDENT 3.5
-8bit符号なし整数。
+8bit符号なし整数であり、0以上255以下の整数を表します。（デフォルト値: 0）
 .UNINDENT
 .UNINDENT
 .sp
 \fBInt16\fP
 .INDENT 0.0
 .INDENT 3.5
-16bit符号付き整数。
+16bit符号付き整数であり、\-32,768以上32,767以下の整数を表します。（デフォルト値: 0）
 .UNINDENT
 .UNINDENT
 .sp
 \fBUInt16\fP
 .INDENT 0.0
 .INDENT 3.5
-16bit符号なし整数。
+16bit符号なし整数であり、0以上65,535以下の整数を表します。（デフォルト値: 0）
 .UNINDENT
 .UNINDENT
 .sp
 \fBInt32\fP
 .INDENT 0.0
 .INDENT 3.5
-32bit符号付き整数。
+32bit符号付き整数であり、\-2,147,483,648以上2,147,483,647以下の整数を表します。（デフォルト値: 0）
 .UNINDENT
 .UNINDENT
 .sp
 \fBUInt32\fP
 .INDENT 0.0
 .INDENT 3.5
-32bit符号なし整数。
+32bit符号なし整数であり、0以上4,294,967,295以下の整数を表します。（デフォルト値: 0）
 .UNINDENT
 .UNINDENT
 .sp
 \fBInt64\fP
 .INDENT 0.0
 .INDENT 3.5
-64bit符号付き整数。
+64bit符号付き整数であり、\-9,223,372,036,854,775,808以上9,223,372,036,854,775,807以下の整数を表します。（デフォルト値: 0）
 .UNINDENT
 .UNINDENT
 .sp
 \fBUInt64\fP
 .INDENT 0.0
 .INDENT 3.5
-64bit符号なし整数。
+64bit符号なし整数であり、0以上18,446,744,073,709,551,615以下の整数を表します。（デフォルト値: 0）
 .UNINDENT
 .UNINDENT
 .sp
 \fBFloat\fP
 .INDENT 0.0
 .INDENT 3.5
-ieee754形式の64bit浮動小数点数。
+IEEE 754形式の倍精度浮動小数点数であり、実数を表します。（デフォルト値: 0.0）
+.sp
+IEEE 754形式の詳細については、 \fI\%IEEE 754 - Wikipedia\fP や \fI\%IEEE 754: Standard for Binary Floating-Point\fP を参照してください。
 .UNINDENT
 .UNINDENT
 .sp
 \fBTime\fP
 .INDENT 0.0
 .INDENT 3.5
-1970年1月1日0時0分0秒からの経過マイクロ秒数を64bit符号付き整数で表現した値。
+日時を表す型であり、1970年1月1日0時0分0秒からの経過時間を、マイクロ秒単位で64bit符号付き整数により表現します。（デフォルト値: 0）
+.sp
+\fB/commands/load\fP コマンドで値を格納するときは、1970年1月1日0時0分0秒からの経過秒数を指定します。秒単位より詳細な日時を指定するには、小数を使います。
 .UNINDENT
 .UNINDENT
 .sp
 \fBShortText\fP
 .INDENT 0.0
 .INDENT 3.5
-4Kbyte以下の文字列。
+4,095バイト以下の文字列を表します。（デフォルト値: ""）
 .UNINDENT
 .UNINDENT
 .sp
 \fBText\fP
 .INDENT 0.0
 .INDENT 3.5
-64Kbyte以下の文字列。
+65,535バイト以下の文字列を表します。（デフォルト値: ""）
 .UNINDENT
 .UNINDENT
 .sp
 \fBLongText\fP
 .INDENT 0.0
 .INDENT 3.5
-2Gbyte以下の文字列。
+2,147,483,647バイト以下の文字列を表します。（デフォルト値: ""）
 .UNINDENT
 .UNINDENT
 .sp
 \fBTokyoGeoPoint\fP
 .INDENT 0.0
 .INDENT 3.5
-日本測地系緯度経度座標。緯度と経度はミリ秒単位での整数。
-"経度のミリ秒x緯度のミリ秒"という文字列表現を持つ。
-度分秒形式であれば、x度y分z秒は(((x * 60) + y) * 60 + z) * 1000という計算式で変換した値を代入します。
+旧日本測地系による経緯度であり、経度と緯度をミリ秒単位で表現した整数の組により表現します。（デフォルト値: 0x0）
+.sp
+度分秒形式でx度y分z秒となる経度・緯度は、(((x * 60) + y) * 60 + z) * 1000という計算式でミリ秒単位へと変換されます。
+\fB/commands/load\fP コマンドで値を格納するときは、"ミリ秒単位の経度xミリ秒単位の緯度" もしくは "経度の小数表記x緯度の小数表記" という文字列表現を使って指定します。経度と緯度の区切りとしては、\(aqx\(aq のほかに \(aq,\(aq を使うことができます。
+.sp
+測地系の詳細については、 \fI\%測地系 - Wikipedia\fP を参照してください。
 .UNINDENT
 .UNINDENT
 .sp
 \fBWGS84GeoPoint\fP
 .INDENT 0.0
 .INDENT 3.5
-世界測地系緯度経度座標。緯度と経度はミリ秒単位での整数。
-"経度のミリ秒x緯度のミリ秒"という文字列表現を持つ。
-度分秒形式であれば、x度y分z秒は(((x * 60) + y) * 60 + z) * 1000という計算式で変換した値を代入します。
+世界測地系（World Geodetic System, WGS 84）による経緯度であり、経度と緯度をミリ秒単位で表現した整数の組により表現します。（デフォルト値: 0x0）
+.sp
+度分秒形式からミリ秒形式への変換方法や \fB/commands/load\fP コマンドにおける指定方法はTokyoGeoPointと同じです。
 .UNINDENT
 .UNINDENT
 .SS 型に関する制限事項