rroonga 4.0.1-x86-mingw32 → 4.0.2-x86-mingw32

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

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "GROONGA" "1" "2014 年 03 月 28 日" "4.0.1" "Groonga"
+.TH "GROONGA" "1" "2014 年 05 月 29 日" "4.0.2" "Groonga"
 .SH NAME
 groonga \- Groonga documentation
 .
@@ -76,10 +76,10 @@ Groonga では転置索引を応用して高速な位置情報検索を実現し
 Groonga の基本機能は C ライブラリとして提供されているので、任意のアプリケーションに組み込んで利用することができます。C/C++ 以外については、Ruby から Groonga を利用するライブラリなどが関連プロジェクトにおいて提供されています。詳しくは \fI\%関連プロジェクト\fP を参照してください。
 .SS Groonga サーバ
 .sp
-Groonga にはサーバ機能があるため、レンタルサーバなどの新しいライブラリをインストールできない環境においても利用できます。対応しているのは HTTP, memcached binary プロトコル、およびに Groonga の独自プロトコルである GQTP（Groonga Query Transfer Protocol） です。サーバとして利用するときはクエリのキャッシュ機能が有効になるため、同じクエリを受け取ったときは応答時間が短くなるという特徴があります。
-.SS Groonga ストレージエンジン
+Groonga にはサーバ機能があるため、レンタルサーバなどの新しいライブラリをインストールできない環境においても利用できます。対応しているのは HTTP, memcached binary プロトコル、および Groonga の独自プロトコルである GQTP（Groonga Query Transfer Protocol） です。サーバとして利用するときはクエリのキャッシュ機能が有効になるため、同じクエリを受け取ったときは応答時間が短くなるという特徴があります。
+.SS Mroonga ストレージエンジン
 .sp
-Groonga は独自のカラムストアを持つ列指向のデータベースとしての側面を持っていますが、既存の RDBMS のストレージエンジンとして利用することもできます。たとえば、Groonga をベースとする MySQL のストレージエンジンとして \fI\%mroonga\fP が開発されています。mroonga は MySQL のプラグインとして動的にロードすることが可能であり、Groonga のカラムストアをストレージとして利用したり、全文検索エンジンとして Groonga を MyISAM や InnoDB と連携させたりすることができます。Groonga 単体での利用、およびに MyISAM, InnoDB との連携には一長一短があるので、用途に応じて適切な組み合わせを選ぶことが大切です。詳しくは \fI\%関連プロジェクト\fP を参照してください。
+Groonga は独自のカラムストアを持つ列指向のデータベースとしての側面を持っていますが、既存の RDBMS のストレージエンジンとして利用することもできます。たとえば、Groonga をベースとする MySQL のストレージエンジンとして \fI\%Mroonga\fP が開発されています。Mroonga は MySQL のプラグインとして動的にロードすることが可能であり、Groonga のカラムストアをストレージとして利用したり、全文検索エンジンとして Groonga を MyISAM や InnoDB と連携させたりすることができます。Groonga 単体での利用、および MyISAM, InnoDB との連携には一長一短があるので、用途に応じて適切な組み合わせを選ぶことが大切です。詳しくは \fI\%関連プロジェクト\fP を参照してください。
 .SH インストール
 .sp
 このセクションではGroongaのインストール方法を環境毎に説明します。主要なプラットフォームにはパッケージがあります。自分でGroongaをビルドするよりもパッケージを使うことを推奨します。しかし、心配しないでください。ソースからGroongaをビルドするためのドキュメントもあります。
@@ -97,7 +97,7 @@ Groonga は独自のカラムストアを持つ列指向のデータベースと
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.1\-x86.exe\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.2\-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\-4.0.1\-x64.exe\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.2\-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\-4.0.1\-x86.zip\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.2\-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\-4.0.1\-x64.zip\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.2\-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\-4.0.1.zip\fP
+\fI\%http://packages.groonga.org/source/groonga/groonga\-4.0.2.zip\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -176,7 +176,7 @@ Groongaのソースフォルダへと移動します:
 .sp
 .nf
 .ft C
-> cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-4.0.1
+> cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-4.0.2
 .ft P
 .fi
 .UNINDENT
@@ -188,7 +188,7 @@ Groongaのソースフォルダへと移動します:
 .sp
 .nf
 .ft C
-groonga\-4.0.1> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\egroonga
+groonga\-4.0.2> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\egroonga
 .ft P
 .fi
 .UNINDENT
@@ -200,7 +200,7 @@ groonga\-4.0.1> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\
 .sp
 .nf
 .ft C
-groonga\-4.0.1> cmake \-\-build . \-\-config Release
+groonga\-4.0.2> cmake \-\-build . \-\-config Release
 .ft P
 .fi
 .UNINDENT
@@ -212,7 +212,7 @@ groonga\-4.0.1> cmake \-\-build . \-\-config Release
 .sp
 .nf
 .ft C
-groonga\-4.0.1> cmake \-\-build . \-\-config Release \-\-target Install
+groonga\-4.0.2> cmake \-\-build . \-\-config Release \-\-target Install
 .ft P
 .fi
 .UNINDENT
@@ -222,8 +222,6 @@ groonga\-4.0.1> cmake \-\-build . \-\-config Release \-\-target Install
 .SS Mac OS X
 .sp
 このセクションではMac OS X上でGroongaをインストールする方法を説明します。 \fI\%MacPorts\fP か \fI\%Homebrew\fP を使ってインストールできます。
-.sp
-32\-bit用と64\-bit用のパッケージを配布していますが、サーバ用途には64\-bitパッケージを利用することをオススメします。32\-bit用パッケージはテスト用か開発用にだけ使って下さい。32\-bit用パッケージを使った場合は、中程度のサイズのデータでもメモリ不足エラーになることがあります。
 .SS MacPorts
 .sp
 インストール:
@@ -250,6 +248,18 @@ groonga\-4.0.1> cmake \-\-build . \-\-config Release \-\-target Install
 .fi
 .UNINDENT
 .UNINDENT
+.sp
+\fI\%MeCab\fP をトークナイザーとして使いたいときは、 \fB\-\-with\-mecab\fP オプションを指定してください。
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% brew install groonga \-\-with\-mecab
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
 .SS ソースからビルド
 .sp
 \fI\%Xcode\fP をインストールしてください。
@@ -260,9 +270,9 @@ groonga\-4.0.1> cmake \-\-build . \-\-config Release \-\-target Install
 .sp
 .nf
 .ft C
-% curl \-O http://packages.groonga.org/source/groonga/groonga\-4.0.1.tar.gz
-% tar xvzf groonga\-4.0.1.tar.gz
-% cd groonga\-4.0.1
+% curl \-O http://packages.groonga.org/source/groonga/groonga\-4.0.2.tar.gz
+% tar xvzf groonga\-4.0.2.tar.gz
+% cd groonga\-4.0.2
 .ft P
 .fi
 .UNINDENT
@@ -351,9 +361,9 @@ deb\-src http://packages.groonga.org/debian/ wheezy main
 .nf
 .ft C
 % sudo apt\-get update
-% sudo apt\-get \-y \-\-allow\-unauthenticated install groonga\-keyring
+% sudo apt\-get install \-y \-\-allow\-unauthenticated groonga\-keyring
 % sudo apt\-get update
-% sudo apt\-get \-y install groonga
+% sudo apt\-get install \-y \-V groonga
 .ft P
 .fi
 .UNINDENT
@@ -367,7 +377,7 @@ groonga\-tokenizer\-mecabパッケージのインストール:
 .sp
 .nf
 .ft C
-% sudo aptitude \-V \-D \-y install groonga\-tokenizer\-mecab
+% sudo apt\-get install \-y \-V groonga\-tokenizer\-mecab
 .ft P
 .fi
 .UNINDENT
@@ -381,7 +391,7 @@ groonga\-munin\-pluginsパッケージのインストール:
 .sp
 .nf
 .ft C
-% sudo aptitude \-V \-D \-y install groonga\-munin\-plugins
+% sudo apt\-get install \-y \-V groonga\-munin\-plugins
 .ft P
 .fi
 .UNINDENT
@@ -395,7 +405,7 @@ groonga\-normalizer\-mysqlパッケージのインストール:
 .sp
 .nf
 .ft C
-% sudo aptitude \-V \-D \-y install groonga\-normalizer\-mysql
+% sudo apt\-get install \-y \-V groonga\-normalizer\-mysql
 .ft P
 .fi
 .UNINDENT
@@ -424,9 +434,9 @@ deb\-src http://packages.groonga.org/debian/ jessie main
 .nf
 .ft C
 % sudo apt\-get update
-% sudo apt\-get \-y \-\-allow\-unauthenticated install groonga\-keyring
+% sudo apt\-get install \-y \-\-allow\-unauthenticated groonga\-keyring
 % sudo apt\-get update
-% sudo apt\-get \-y install groonga
+% sudo apt\-get install \-y groonga
 .ft P
 .fi
 .UNINDENT
@@ -440,7 +450,7 @@ groonga\-tokenizer\-mecabパッケージのインストール:
 .sp
 .nf
 .ft C
-% sudo aptitude \-V \-D \-y install groonga\-tokenizer\-mecab
+% sudo apt\-get install \-y \-V groonga\-tokenizer\-mecab
 .ft P
 .fi
 .UNINDENT
@@ -454,7 +464,7 @@ groonga\-munin\-pluginsパッケージのインストール:
 .sp
 .nf
 .ft C
-% sudo aptitude \-V \-D \-y install groonga\-munin\-plugins
+% sudo apt\-get install \-y \-V groonga\-munin\-plugins
 .ft P
 .fi
 .UNINDENT
@@ -468,7 +478,7 @@ groonga\-normalizer\-mysqlパッケージのインストール:
 .sp
 .nf
 .ft C
-% sudo aptitude \-V \-D \-y install groonga\-normalizer\-mysql
+% sudo apt\-get install \-y \-V groonga\-normalizer\-mysql
 .ft P
 .fi
 .UNINDENT
@@ -496,10 +506,10 @@ deb\-src http://packages.groonga.org/debian/ unstable main
 .sp
 .nf
 .ft C
-% sudo aptitude update
-% sudo aptitude \-V \-D \-y \-\-allow\-untrusted install groonga\-keyring
-% sudo aptitude update
-% sudo aptitude \-V \-D \-y install groonga
+% sudo apt\-get update
+% sudo apt\-get install \-y \-\-allow\-unauthenticated groonga\-keyring
+% sudo apt\-get update
+% sudo apt\-get install \-y \-V groonga
 .ft P
 .fi
 .UNINDENT
@@ -513,7 +523,7 @@ groonga\-tokenizer\-mecabパッケージのインストール:
 .sp
 .nf
 .ft C
-% sudo aptitude \-V \-D \-y install groonga\-tokenizer\-mecab
+% sudo apt\-get install \-y \-V groonga\-tokenizer\-mecab
 .ft P
 .fi
 .UNINDENT
@@ -527,7 +537,7 @@ groonga\-munin\-pluginsパッケージのインストール:
 .sp
 .nf
 .ft C
-% sudo aptitude \-V \-D \-y install groonga\-munin\-plugins
+% sudo apt\-get install \-y \-V groonga\-munin\-plugins
 .ft P
 .fi
 .UNINDENT
@@ -541,7 +551,7 @@ groonga\-normalizer\-mysqlパッケージのインストール:
 .sp
 .nf
 .ft C
-% sudo aptitude \-V \-D \-y install groonga\-normalizer\-mysql
+% sudo apt\-get install \-y \-V groonga\-normalizer\-mysql
 .ft P
 .fi
 .UNINDENT
@@ -554,7 +564,7 @@ Groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% sudo aptitude \-V \-D \-y install wget tar build\-essential zlib1g\-dev liblzo2\-dev libmsgpack\-dev libzmq\-dev libevent\-dev libmecab\-dev
+% sudo apt\-get install \-y \-V  wget tar build\-essential zlib1g\-dev liblzo2\-dev libmsgpack\-dev libzmq\-dev libevent\-dev libmecab\-dev
 .ft P
 .fi
 .UNINDENT
@@ -566,9 +576,9 @@ Groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-4.0.1.tar.gz
-% tar xvzf groonga\-4.0.1.tar.gz
-% cd groonga\-4.0.1
+% wget http://packages.groonga.org/source/groonga/groonga\-4.0.2.tar.gz
+% tar xvzf groonga\-4.0.2.tar.gz
+% cd groonga\-4.0.2
 .ft P
 .fi
 .UNINDENT
@@ -633,291 +643,45 @@ groonga\-server\-gqtp (GQTPサーバー)
 詳細は \fB/server\fP を参照してください。
 .UNINDENT
 .UNINDENT
-.SS 12.04 LTS Precise Pangolin
-.sp
-\fBノート:\fP
-.INDENT 0.0
-.INDENT 3.5
-Groongaをインストールするためにuniverseリポジトリを有効にしてください:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo cp /etc/apt/sources.list /etc/apt/sources.list.d/universe.list
-% sudo sed \-i\(aq\(aq \-e \(aqs/main/universe/\(aq /etc/apt/sources.list.d/universe.list
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.UNINDENT
-.UNINDENT
-.sp
-Groongaのaptリポジトリを追加します。
-.sp
-/etc/apt/sources.list.d/groonga.list:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-deb http://packages.groonga.org/ubuntu/ precise universe
-deb\-src http://packages.groonga.org/ubuntu/ precise universe
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-インストール:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo apt\-get update
-% sudo apt\-get \-y \-\-allow\-unauthenticated install groonga\-keyring
-% sudo apt\-get update
-% sudo apt\-get \-y install groonga
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
+.SS PPA（Personal Package Archive）
 .sp
-\fI\%MeCab\fP をトークナイザーとして使いたいときは、groonga\-tokenizer\-mecabパッケージをインストールしてください。
+Ubuntu用のGroongaのAPTリポジトリーはLaunchpad上のPPA（Personal Package Archive）を使っています。このPPAからAPTでGroongaをインストールできます。
 .sp
-groonga\-tokenizer\-mecabパッケージのインストール:
+サポートしているUbuntuのバージョンは次の通りです。
 .INDENT 0.0
 .INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo apt\-get \-y install groonga\-tokenizer\-mecab
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-\fI\%Munin\fP プラグインを提供するパッケージもあります。MuninでGroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
-.sp
-groonga\-munin\-pluginsパッケージのインストール:
 .INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo apt\-get \-y install groonga\-munin\-plugins
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-MySQL互換のノーマライザーをGroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
-.sp
-groonga\-normalizer\-mysqlパッケージのインストール:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo apt\-get \-y install groonga\-normalizer\-mysql
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.SS 12.10 Quantal Quetzal
-.sp
-\fBノート:\fP
-.INDENT 0.0
-.INDENT 3.5
-Groongaをインストールするためにuniverseリポジトリを有効にしてください:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo cp /etc/apt/sources.list /etc/apt/sources.list.d/universe.list
-% sudo sed \-i\(aq\(aq \-e \(aqs/main/universe/\(aq /etc/apt/sources.list.d/universe.list
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.UNINDENT
-.UNINDENT
-.sp
-Groongaのaptリポジトリを追加します。
-.sp
-/etc/apt/sources.list.d/groonga.list:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-deb http://packages.groonga.org/ubuntu/ quantal universe
-deb\-src http://packages.groonga.org/ubuntu/ quantal universe
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-インストール:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo apt\-get update
-% sudo apt\-get \-y \-\-allow\-unauthenticated install groonga\-keyring
-% sudo apt\-get update
-% sudo apt\-get \-y install groonga
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-\fI\%MeCab\fP をトークナイザーとして使いたいときは、groonga\-tokenizer\-mecabパッケージをインストールしてください。
-.sp
-groonga\-tokenizer\-mecabパッケージのインストール:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo apt\-get \-y install groonga\-tokenizer\-mecab
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-\fI\%Munin\fP プラグインを提供するパッケージもあります。MuninでGroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
-.sp
-groonga\-munin\-pluginsパッケージのインストール:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo apt\-get \-y install groonga\-munin\-plugins
-.ft P
-.fi
-.UNINDENT
+.IP \(bu 2
+12.04 LTS Precise Pangolin
+.IP \(bu 2
+13.10 Saucy Salamander
+.IP \(bu 2
+14.04 LTS Trusty Tahr
 .UNINDENT
-.sp
-MySQL互換のノーマライザーをGroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
-.sp
-groonga\-normalizer\-mysqlパッケージのインストール:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo apt\-get \-y install groonga\-normalizer\-mysql
-.ft P
-.fi
 .UNINDENT
 .UNINDENT
-.SS 13.04 Raring Ringtail
 .sp
-\fBノート:\fP
-.INDENT 0.0
-.INDENT 3.5
 Groongaをインストールするためにuniverseリポジトリを有効にしてください:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% sudo cp /etc/apt/sources.list /etc/apt/sources.list.d/universe.list
-% sudo sed \-i\(aq\(aq \-e \(aqs/main/universe/\(aq /etc/apt/sources.list.d/universe.list
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.UNINDENT
-.UNINDENT
-.sp
-Groongaのaptリポジトリを追加します。
-.sp
-/etc/apt/sources.list.d/groonga.list:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-deb http://packages.groonga.org/ubuntu/ raring universe
-deb\-src http://packages.groonga.org/ubuntu/ raring universe
+% sudo apt\-get \-y install software\-properties\-common
+% sudo add\-apt\-repository \-y universe
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-インストール:
+\fBppa:groonga/ppa\fP PPAをシステムに登録します:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
+% sudo add\-apt\-repository \-y ppa:groonga/ppa
 % sudo apt\-get update
-% sudo apt\-get \-y \-\-allow\-unauthenticated install groonga\-keyring
-% sudo apt\-get update
-% sudo apt\-get \-y install groonga
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-\fI\%MeCab\fP をトークナイザーとして使いたいときは、groonga\-tokenizer\-mecabパッケージをインストールしてください。
-.sp
-groonga\-tokenizer\-mecabパッケージのインストール:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo apt\-get \-y install groonga\-tokenizer\-mecab
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-\fI\%Munin\fP プラグインを提供するパッケージもあります。MuninでGroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
-.sp
-groonga\-munin\-pluginsパッケージのインストール:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo apt\-get \-y install groonga\-munin\-plugins
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-MySQL互換のノーマライザーをGroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
-.sp
-groonga\-normalizer\-mysqlパッケージのインストール:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo apt\-get \-y install groonga\-normalizer\-mysql
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.SS 13.10 Saucy Salamander
-.sp
-Groongaのaptリポジトリを追加します。
-.sp
-/etc/apt/sources.list.d/groonga.list:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-deb http://packages.groonga.org/ubuntu/ saucy universe
-deb\-src http://packages.groonga.org/ubuntu/ saucy universe
 .ft P
 .fi
 .UNINDENT
@@ -929,9 +693,6 @@ deb\-src http://packages.groonga.org/ubuntu/ saucy universe
 .sp
 .nf
 .ft C
-% sudo apt\-get update
-% sudo apt\-get \-y \-\-allow\-unauthenticated install groonga\-keyring
-% sudo apt\-get update
 % sudo apt\-get \-y install groonga
 .ft P
 .fi
@@ -999,9 +760,9 @@ Groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-4.0.1.tar.gz
-% tar xvzf groonga\-4.0.1.tar.gz
-% cd groonga\-4.0.1
+% wget http://packages.groonga.org/source/groonga/groonga\-4.0.2.tar.gz
+% tar xvzf groonga\-4.0.2.tar.gz
+% cd groonga\-4.0.2
 .ft P
 .fi
 .UNINDENT
@@ -1190,7 +951,7 @@ groonga\-normalizer\-mysqlパッケージのインストール:
 .sp
 .nf
 .ft C
-% sudo yum install \-y install groonga\-normalizer\-mysql
+% sudo yum install \-y groonga\-normalizer\-mysql
 .ft P
 .fi
 .UNINDENT
@@ -1292,7 +1053,7 @@ groonga\-normalizer\-mysqlパッケージのインストール:
 .sp
 .nf
 .ft C
-% sudo yum install \-y install groonga\-normalizer\-mysql
+% sudo yum install \-y groonga\-normalizer\-mysql
 .ft P
 .fi
 .UNINDENT
@@ -1317,9 +1078,9 @@ Groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-4.0.1.tar.gz
-% tar xvzf groonga\-4.0.1.tar.gz
-% cd groonga\-4.0.1
+% wget http://packages.groonga.org/source/groonga/groonga\-4.0.2.tar.gz
+% tar xvzf groonga\-4.0.2.tar.gz
+% cd groonga\-4.0.2
 .ft P
 .fi
 .UNINDENT
@@ -1505,9 +1266,9 @@ Groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-4.0.1.tar.gz
-% tar xvzf groonga\-4.0.1.tar.gz
-% cd groonga\-4.0.1
+% wget http://packages.groonga.org/source/groonga/groonga\-4.0.2.tar.gz
+% tar xvzf groonga\-4.0.2.tar.gz
+% cd groonga\-4.0.2
 .ft P
 .fi
 .UNINDENT
@@ -1571,9 +1332,9 @@ Groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-4.0.1.tar.gz
-% gtar xvzf groonga\-4.0.1.tar.gz
-% cd groonga\-4.0.1
+% wget http://packages.groonga.org/source/groonga/groonga\-4.0.2.tar.gz
+% gtar xvzf groonga\-4.0.2.tar.gz
+% cd groonga\-4.0.2
 .ft P
 .fi
 .UNINDENT
@@ -1694,9 +1455,9 @@ GroongaはGNUビルドシステムを使っています。以下は一番簡単
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-4.0.1.tar.gz
-% tar xvzf groonga\-4.0.1.tar.gz
-% cd groonga\-4.0.1
+% wget http://packages.groonga.org/source/groonga/groonga\-4.0.2.tar.gz
+% tar xvzf groonga\-4.0.2.tar.gz
+% cd groonga\-4.0.2
 % ./configure
 % make
 % sudo make install
@@ -8805,6 +8566,28 @@ load \-\-table event_query \-\-each \(aqsuggest_preparer(_id, type, item, sequen
 .fi
 .UNINDENT
 .UNINDENT
+.SS How to extract learning data
+.sp
+The learning data is stored into item_DATASET and pair_DATASET tables.
+By using select command for such tables, you can all extract learing data.
+.sp
+Here is the query to extract all learning data:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+select item_DATASET \-\-limit \-1
+select pair_DATASET \-\-filter \(aqfreq0 > 0 || freq1 > 0 || freq2 > 0\(aq \-\-limit \-1
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Without \(aq\-\-limit \-1\(aq, you can\(aqt get all data.
+In pair table, the valid value of freq0, freq1 and freq2 column must be larger than 0.
+.sp
+Don\(aqt execute above query via HTTP request because enourmous number of records are fetched.
 .SH 位置情報検索
 .sp
 Groongaは位置情報検索をサポートしています。検索にはインデックスを使うので全文検索と同様に位置情報も高速に検索できます。
@@ -9280,7 +9063,7 @@ TODO
 \fB/reference/executables/groonga\fP を参照してください。
 .SS HTTP
 .sp
-groongaは2つのHTTPサーバー実装を提供しています。
+Groongaは2つのHTTPサーバー実装を提供しています。
 .INDENT 0.0
 .IP \(bu 2
 \fBhttp/groonga\fP
@@ -9414,7 +9197,7 @@ _
 \fBgroonga\fP と \fBgroonga\-httpd\fP はどちらも非常に高速です。どちらも同じスループットで動きます。
 .SS 複数CPUコア対応
 .sp
-groongaは複数のCPUコアを使って性能を向上できます。 \fBgroonga\fP はマルチスレッドを使って性能を向上させます。 \fBgroonga\-httpd\fP はマルチプロセスを使って性能を向上させます。
+Groongaは複数のCPUコアを使って性能を向上できます。 \fBgroonga\fP はマルチスレッドを使って性能を向上させます。 \fBgroonga\-httpd\fP はマルチプロセスを使って性能を向上させます。
 .sp
 \fBgroonga\fP はデフォルトでCPUコアと同じ数のスレッドを使います。もし、CPUコアが8個あった場合は、デフォルトで8個のスレッドを使います。
 .sp
@@ -9501,7 +9284,7 @@ http {
 .UNINDENT
 .SS コマンドバージョンの変更
 .sp
-groongaには \fB/reference/command/command_version\fP という仕組みがあります。これは後方互換性を維持したままgroongaコマンドをアップグレードするための仕組みです。
+Groongaには \fB/reference/command/command_version\fP という仕組みがあります。これは後方互換性を維持したままgroongaコマンドをアップグレードするための仕組みです。
 .sp
 \fBgroonga\fP は \fB\-\-default\-command\-version\fP オプションでデフォルトのコマンドバージョンを変更できます。以下はデフォルトのコマンドバージョンとしてコマンドバージョン2を使うコマンドライン例です。:
 .INDENT 0.0
@@ -10420,12 +10203,7 @@ groonga サーバが動作していないか？　groonga\-benchmarkは、\-i, \
 .SS groonga\-httpd
 .SS 概要
 .sp
-groonga\-httpd is a program to communicate with a Groonga server using
-the HTTP protocol. It functions as same as
-\fBgroonga\-server\-http\fP\&. Although \fBgroonga\-server\-http\fP has
-limited support for HTTP with a minimal built\-in HTTP server,
-groonga\-httpd has full support for HTTP with an embedded \fI\%nginx\fP\&. All standards\-compliance and features provided
-by nginx is also available in groonga\-httpd.
+groonga\-httpdはGroongaサーバーとHTTPプロトコルで通信するプログラムです。 機能的には、 \fBgroonga\-server\-http\fP と同じです。 \fBgroonga\-server\-http\fP はHTTPサーバーとしては最小限の機能しか持ちませんが、groonga\-httpdは \fI\%nginx\fP を組み込むことでnginxが準拠しているHTTPの仕様と機能をすべて利用できます。
 .sp
 groonga\-httpdにはHTML + JavaScriptで実装された管理ツールが標準で付属しています。ウェブブラウザでhttp://hostname:port/にアクセスすると、管理ツールを利用できます。
 .SS 書式
@@ -11198,15 +10976,71 @@ groonga\-suggest\-httpd [options] database_path
 .SS 使い方
 .SS 設定をする
 .sp
-First you need to set up database for suggestion.
+最初に提案用のデータベースをセットアップする必要があります。
+.sp
+実行例:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% groonga\-suggest\-create\-dataset /tmp/groonga\-databases/groonga\-suggest\-httpd query
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
 .SS Launch groonga\-suggest\-httpd
 .sp
 Execute groonga\-suggest\-httpd command:
 .sp
+実行例:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% groonga\-suggest\-httpd /tmp/groonga\-databases/groonga\-suggest\-httpd
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
 After executing above command, groonga\-suggest\-httpd accepts HTTP request on 8080 port.
+.sp
+If you just want to save requests into log file, use \fB\-l\fP option.
+.sp
+Here is the example to save log files under \fBlogs\fP directory with \fBlog\fP prefix for each file.:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% groonga\-suggest\-httpd \-l logs/log /tmp/groonga\-databases/groonga\-suggest\-httpd
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Under \fBlogs\fP directory, log files such as \fBlogYYYYmmddHHMMSS\-00\fP are created.
 .SS Request to groonga\-suggest\-httpd
 .sp
-TODO
+Here is the sample requests to learn \fBgroonga\fP for \fBquery\fP dataset:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% curl \(aqhttp://localhost:8080/?i=127.0.0.1&l=query&s=92619&t=complete&q=g\(aq
+% curl \(aqhttp://localhost:8080/?i=127.0.0.1&l=query&s=93850&t=complete&q=gr\(aq
+% curl \(aqhttp://localhost:8080/?i=127.0.0.1&l=query&s=94293&t=complete&q=gro\(aq
+% curl \(aqhttp://localhost:8080/?i=127.0.0.1&l=query&s=94734&t=complete&q=groo\(aq
+% curl \(aqhttp://localhost:8080/?i=127.0.0.1&l=query&s=95147&t=complete&q=grooon\(aq
+% curl \(aqhttp://localhost:8080/?i=127.0.0.1&l=query&s=95553&t=complete&q=groonga\(aq
+% curl \(aqhttp://localhost:8080/?i=127.0.0.1&l=query&s=95959&t=submit&q=groonga
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
 .SS Options
 .INDENT 0.0
 .TP
@@ -11217,6 +11051,8 @@ Specify http server port number. The default value is 8080.
 .TP
 .B \-t, \-\-n\-threads
 Specify number of threads. The default value is 8.
+This option accepts 128 as the max value, but use the number of CPU cores for
+performance.
 .UNINDENT
 .INDENT 0.0
 .TP
@@ -11248,17 +11084,17 @@ Specify this option to daemonize.
 .B \-\-disable\-max\-fd\-check
 Specify this option to disable checking max fd on start.
 .UNINDENT
-.SS Command line Parameters
+.SS コマンドライン引数
 .sp
 \fBdatabase_path\fP だけが必須の引数です。
 .SS \fBdatabase_path\fP
 .sp
 Specifies the path to a Groonga database. This database must be created by \fBgroonga\-suggest\-create\-dataset\fP command because it executes required initialization for suggestion.
-.SS GET Parameters
+.SS GETの引数
 .sp
 groonga\-suggest\-httpd accepts following GET parameters.
 .sp
-There are required parameters which depends on type of query.
+必須の引数があります。どれが必須かはクエリーの種類に依存します。
 .SS 必須引数
 .TS
 center;
@@ -11282,12 +11118,12 @@ _
 T{
 t
 T}	T{
-The type of query. The value of type must be complete, correct, suggest or submit. It also accepts multiple type of query which is concatinated by \(aq|\(aq. Note that \(aqsubmit\(aq is invalid value when you specify multiple type of query.
+The type of query. The value of type must be complete, correct, suggest or submit. It also accepts multiple type of query which is concatinated by \fB|\fP\&. Note that \fBsubmit\fP is invalid value when you specify multiple type of query.
 T}	T{
 T}
 _
 .TE
-.SS Required parameters for learning
+.SS 学習時に必須の引数
 .TS
 center;
 |l|l|l|.
@@ -11305,7 +11141,7 @@ s
 T}	T{
 Elapsed time from 0:00 January 1, 1970
 T}	T{
-Note that you need specify the value of \(aqs\(aq in milliseconds
+Note that you need specify the value of \fBs\fP in milliseconds
 T}
 _
 T{
@@ -11319,13 +11155,13 @@ _
 T{
 l
 T}	T{
-Specify the name of dataset for learning. It also accepts multiple dataset name which is concatinated by \(aq|\(aq
+Specify the name of dataset for learning. It also accepts multiple dataset name which is concatinated by \fB|\fP
 T}	T{
-Note that dataset name must be matched to following regular expression \(aq[A\-Za\-z ][A\-Za\-z0\-9 ]{0,15}\(aq
+Note that dataset name must be matched to following regular expression \fB[A\-Za\-z ][A\-Za\-z0\-9 ]{0,15}\fP
 T}
 _
 .TE
-.SS Required parameters for suggestion
+.SS 提案時に必須の引数
 .TS
 center;
 |l|l|l|.
@@ -11341,7 +11177,7 @@ _
 T{
 n
 T}	T{
-Specify the name of dataset for suggestion
+提案用のデータベース名を指定します。
 T}	T{
 This dataset name is used to calculate suggestion results
 T}
@@ -11365,7 +11201,7 @@ callback
 T}	T{
 Specify the name of function if you prefer JSONP as response format
 T}	T{
-The name of function must be matched to reqular expression \(aq[A\-Za\-z ][A\-Za\-z0\-9 ]{0,15}\(aq
+The name of function must be matched to reqular expression \fB[A\-Za\-z ][A\-Za\-z0\-9 ]{0,15}\fP
 T}
 _
 .TE
@@ -11373,7 +11209,7 @@ _
 .sp
 \fBgroonga\-suggest\-httpd\fP command returns following response in JSON or JSONP format.
 .sp
-In JSON format:
+JSON形式:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -11385,7 +11221,7 @@ In JSON format:
 .UNINDENT
 .UNINDENT
 .sp
-In JSONP format:
+JSONP形式:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -11400,7 +11236,7 @@ FUNCTION({TYPE: [[CANDIDATE_1, SCORE_1], [CANDIDATE_2, SCORE_2], ... [CANDIDATE_
 \fBTYPE\fP
 .INDENT 0.0
 .INDENT 3.5
-\(aqcomplete\(aq, \(aqcorrect\(aq or \(aqsuggest\(aq.
+\fBcomplete\fP 、 \fBcorrect\fP 、 \fBsuggest\fP のどれか。
 .UNINDENT
 .UNINDENT
 .sp
@@ -11414,13 +11250,15 @@ The string of candidate (UTF\-8).
 \fBSCORE_N\fP
 .INDENT 0.0
 .INDENT 3.5
-The number of score.
+スコア。
 .UNINDENT
 .UNINDENT
 .SS groonga\-suggest\-learner
 .SS 概要
 .sp
-TODO
+groonga\-suggest\-learner is a program to learn suggest result from data which derived from groonga\-suggest\-httpd.
+Usually, it is used with groonga\-suggest\-httpd, but It is allowed to launch standalone.
+In such a case, groonga\-suggest\-learner loads data from log directory.
 .SS 書式
 .INDENT 0.0
 .INDENT 3.5
@@ -11434,29 +11272,71 @@ groonga\-suggest\-learner [options] database_path
 .UNINDENT
 .SS 使い方
 .sp
-TODO
+groonga\-suggest\-leaner supports the two way of learning data.
+One is learning data from groonga\-suggest\-httpd, the other is
+learning data from already existing log files.
+.SS Learning data from groonga\-suggest\-httpd
+.sp
+Execute groonga\-suggest\-learner.:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+groonga\-suggest\-learner testdb/db
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS Learning data from log files
+.sp
+Execute groonga\-suggest\-learner with \fB\-l\fP option.
+.sp
+Here is the sample to load log data under \fBlogs\fP directory:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+groonga\-suggest\-learner \-l logs testdb/db
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
 .SS Options
 .INDENT 0.0
 .TP
-.B \-r, \-\-receive\-endpoint
+.B \-r
 Specify endpoint for receiver.
 .UNINDENT
 .INDENT 0.0
 .TP
-.B \-s, \-\-send\-endpoint
+.B \-s
 Specify endpoint for sender.
 .UNINDENT
 .INDENT 0.0
 .TP
-.B \-d, \-\-daemon
+.B \-d
 Specify this option to daemonize.
 .UNINDENT
+.INDENT 0.0
+.TP
+.B \-l
+Specify log directory.
+.UNINDENT
 .SS 引数
 .sp
 \fBdatabase_path\fP だけが必須の引数です。
 .SS \fBdatabase_path\fP
 .sp
 groongaデータベースのパスを指定します。
+.SS 関連するテーブル
+.sp
+Here is the list of table which learned data is stored. If you specify \fBquery\fP as dataset name, following \fB_DATASET\fP suffix are replaced. Thus, \fBevent_query\fP table is used.
+.INDENT 0.0
+.IP \(bu 2
+event_DATASET
+.UNINDENT
 .SS 出力
 .sp
 Groongaは以下の出力形式をサポートしています。
@@ -12752,11 +12632,13 @@ column_create Term entry_body COLUMN_INDEX|WITH_POSITION Entry body
 コマンドの実行が成功するとtrueを返します。失敗するとエラーとしてfalseを返します。
 .UNINDENT
 .UNINDENT
-.SS column_list
-.SS 名前
+.SS \fBcolumn_list\fP
+.SS 概要
 .sp
-column_list \- テーブルに定義されているカラムのリスト表示
-.SS 書式
+\fBcolumn_list\fP コマンドはテーブルにあるカラムの一覧を返します。
+.SS 構文
+.sp
+\fBcolumn_list\fP コマンドの引数は1つで必須です:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -12767,140 +12649,381 @@ column_list table
 .fi
 .UNINDENT
 .UNINDENT
-.SS 説明
+.SS 使い方
+.sp
+以下は \fBcolumn_list\fP コマンドの簡単な使用例です。
 .sp
-Groonga組込コマンドの一つであるcolumn_listについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+実行例:
+.INDENT 0.0
+.INDENT 3.5
 .sp
-column_listはテーブルに定義されているカラムをリスト表示します。
+.nf
+.ft C
+table_create Users TABLE_PAT_KEY ShortText
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Users age COLUMN_SCALAR UInt8
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Users tags COLUMN_VECTOR ShortText
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_list Users
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         "id",
+#         "UInt32"
+#       ],
+#       [
+#         "name",
+#         "ShortText"
+#       ],
+#       [
+#         "path",
+#         "ShortText"
+#       ],
+#       [
+#         "type",
+#         "ShortText"
+#       ],
+#       [
+#         "flags",
+#         "ShortText"
+#       ],
+#       [
+#         "domain",
+#         "ShortText"
+#       ],
+#       [
+#         "range",
+#         "ShortText"
+#       ],
+#       [
+#         "source",
+#         "ShortText"
+#       ]
+#     ],
+#     [
+#       256,
+#       "_key",
+#       "",
+#       "",
+#       "COLUMN_SCALAR",
+#       "Users",
+#       "ShortText",
+#       []
+#     ],
+#     [
+#       257,
+#       "age",
+#       "/tmp/groonga\-databases/commands_column_list.0000101",
+#       "fix",
+#       "COLUMN_SCALAR|PERSISTENT",
+#       "Users",
+#       "UInt8",
+#       []
+#     ],
+#     [
+#       258,
+#       "tags",
+#       "/tmp/groonga\-databases/commands_column_list.0000102",
+#       "var",
+#       "COLUMN_VECTOR|PERSISTENT",
+#       "Users",
+#       "ShortText",
+#       []
+#     ]
+#   ]
+# ]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
 .SS 引数
+.sp
+このセクションでは \fBcolumn_list\fP の引数について説明します。
+.SS 必須引数
+.sp
+すべての引数は必須です。
+.SS \fBtable\fP
+.sp
+カラムの一覧を取得するテーブルの名前を指定します。
+.SS 戻り値
+.sp
+\fBcolumn_list\fP returns the list of column information in the table:
 .INDENT 0.0
-.TP
-.B \fBtable\fP
-カラム情報を出力するテーブルの名前を指定します。
+.INDENT 3.5
+.sp
+.nf
+.ft C
+[
+  HEADER,
+  [
+    COLUMN_LIST_HEADER,
+    COLUMN_INFORMATION1,
+    COLUMN_INFORMATION2,
+    ...
+  ]
+]
+.ft P
+.fi
 .UNINDENT
-.SS 返値
-.SS json形式
+.UNINDENT
+.sp
+\fBHEADER\fP
+.INDENT 0.0
+.INDENT 3.5
+\fBHEADER\fP については \fB/reference/command/output_format\fP を参照してください。
+.UNINDENT
+.UNINDENT
+.sp
+\fBCOLUMN_LIST_HEADER\fP
+.INDENT 0.0
+.INDENT 3.5
+\fBCOLUMN_LIST_HEADER\fP describes about content of each
+\fBCOLUMN_INFORMATION\fP\&.
 .sp
-カラム名一覧を以下の形式で返却します。:
+\fBCOLUMN_LIST_HEADER\fP is the following format:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-[[[カラム情報名1,カラム情報型1],...], カラム情報1,...]
+[
+  ["id",     "UInt32"],
+  ["name",   "ShortText"],
+  ["path",   "ShortText"],
+  ["type",   "ShortText"],
+  ["flags",  "ShortText"],
+  ["domain", "ShortText"],
+  ["range",  "ShortText"],
+  ["source", "ShortText"]
+]
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-\fBカラム情報名n\fP
+以下のことを意味します。
 .INDENT 0.0
 .INDENT 3.5
-\fBカラム情報n\fP には複数の情報が含まれますが、そこに入る情報がどんな内容かを示す名前を出力します。
-情報名は以下の通りです。
+.INDENT 0.0
+.IP \(bu 2
+\fBCOLUMN_INFORMATION\fP の1番目の要素は \fBid\fP の値で、その値の型は \fBUInt32\fP です。
+.IP \(bu 2
+\fBCOLUMN_INFORMATION\fP の2番目の要素は \fBname\fP の値で、その値の型は \fBShortText\fP です。
+.IP \(bu 2
+\fBCOLUMN_INFORMATION\fP の3番目の要素は…
+.UNINDENT
+.UNINDENT
+.UNINDENT
 .sp
-\fBid\fP
+See the following \fBCOLUMN_INFORMATION\fP description for details.
+.sp
+This field provides meta\-data of column information. So this field
+will be useful for programs rather than humans.
+.UNINDENT
+.UNINDENT
+.sp
+\fBCOLUMN_INFORMATION\fP
+.INDENT 0.0
+.INDENT 3.5
+Each \fBCOLUMN_INFORMATION\fP is the following format:
 .INDENT 0.0
 .INDENT 3.5
-カラムオブジェクトに割り当てられたID
+.sp
+.nf
+.ft C
+[
+  ID,
+  NAME,
+  PATH,
+  TYPE,
+  FLAGS,
+  DOMAIN,
+  RANGE,
+  SOURCES
+]
+.ft P
+.fi
 .UNINDENT
 .UNINDENT
 .sp
-\fBname\fP
+\fBID\fP
 .INDENT 0.0
 .INDENT 3.5
-カラム名
+The column ID in the Groonga database. Normally, you don\(aqt care
+about it.
 .UNINDENT
 .UNINDENT
 .sp
-\fBpath\fP
+\fBNAME\fP
 .INDENT 0.0
 .INDENT 3.5
-カラム値を格納するファイル名
+カラム名。
 .UNINDENT
 .UNINDENT
 .sp
-\fBtype\fP
+\fBPATH\fP
 .INDENT 0.0
 .INDENT 3.5
-スカラ型、ベクタ型、インデックス型の種別
+カラムのデータを保存しているパス。
 .UNINDENT
 .UNINDENT
 .sp
-\fBflags\fP
+\fBTYPE\fP
+.INDENT 0.0
+.INDENT 3.5
+カラムの型。次のうちのどれかです。
+.TS
+center;
+|l|l|.
+_
+T{
+Value
+T}	T{
+説明
+T}
+_
+T{
+\fBfix\fP
+T}	T{
+The column is a fixed size column. Scalar column that its
+type is fixed size type is fixed size column.
+T}
+_
+T{
+\fBvar\fP
+T}	T{
+The column is a variable size column. Vector column or
+scalar column that its type is variable size type are
+variable size column.
+T}
+_
+T{
+\fBindex\fP
+T}	T{
+このカラムはインデックスカラムです。
+T}
+_
+.TE
+.UNINDENT
+.UNINDENT
+.sp
+\fBFLAGS\fP
 .INDENT 0.0
 .INDENT 3.5
-カラムのflags属性
+The flags of the column. Each flag is separated by \fB|\fP like
+\fBCOLUMN_VECTOR|WITH_WEIGHT\fP\&. \fBFLAGS\fP must include one of
+\fBCOLUMN_SCALAR\fP, \fBCOLUMN_VECTOR\fP or \fBCOLUMN_INDEX\fP\&. Other
+flags are optional.
+.sp
+有効なフラグは以下の通りです。
+.TS
+center;
+|l|l|.
+_
+T{
+フラグ
+T}	T{
+説明
+T}
+_
+T{
+\fBCOLUMN_SCALAR\fP
+T}	T{
+このカラムはスカラーカラムです。
+T}
+_
+T{
+\fBCOLUMN_VECTOR\fP
+T}	T{
+このカラムはベクターカラムです。
+T}
+_
+T{
+\fBCOLUMN_INDEX\fP
+T}	T{
+このカラムはインデックスカラムです。
+T}
+_
+T{
+\fBWITH_WEIGHT\fP
+T}	T{
+The column can have weight. \fBCOLUMN_VECTOR\fP and \fBCOLUMN_INDEX\fP
+may have it. \fBCOLUMN_SCALAR\fP doesn\(aqt have it.
+T}
+_
+T{
+\fBWITH_SECTION\fP
+T}	T{
+The column can have section information. \fBCOLUMN_INDEX\fP
+may have it.  \fBCOLUMN_SCALAR\fP and \fBCOLUMN_VECTOR\fP don\(aqt
+have it.
+.sp
+マルチカラムインデックスはこのフラグを持ちます。
+T}
+_
+T{
+\fBWITH_POSITION\fP
+T}	T{
+The column can have position information. \fBCOLUMN_INDEX\fP
+may have it.  \fBCOLUMN_SCALAR\fP and \fBCOLUMN_VECTOR\fP don\(aqt
+have it.
+.sp
+全文検索インデックスはこのフラグを持つべきです。
+T}
+_
+T{
+\fBPERSISTENT\fP
+T}	T{
+The column is a persistent column. It means that the column
+isn\(aqt a \fB/reference/columns/pseudo\fP\&.
+T}
+_
+.TE
 .UNINDENT
 .UNINDENT
 .sp
-\fBdomain\fP
+\fBDOMAIN\fP
 .INDENT 0.0
 .INDENT 3.5
-カラムの値の属する型
+カラムを持っているテーブルの生です。
 .UNINDENT
 .UNINDENT
 .sp
-\fBrange\fP
+\fBRANGE\fP
 .INDENT 0.0
 .INDENT 3.5
-テーブルのkeyの型
+The value type name of the column. It is a type name or a table
+name.
 .UNINDENT
 .UNINDENT
 .sp
-\fBsource\fP
+\fBSOURCES\fP
 .INDENT 0.0
 .INDENT 3.5
-インデックスカラムのとき、インデックス対象カラム名の配列
-.UNINDENT
-.UNINDENT
-.UNINDENT
-.UNINDENT
+An array of the source column names of the index. If the index
+column is multiple column index, the array has two or more
+source column names.
 .sp
-\fBカラム情報型n\fP
-.INDENT 0.0
-.INDENT 3.5
-カラム情報の型を出力します。
+It is always an empty array for \fBCOLUMN_SCALAR\fP and
+\fBCOLUMN_VECTOR\fP\&.
 .UNINDENT
 .UNINDENT
-.sp
-\fBカラム情報n\fP
-.INDENT 0.0
-.INDENT 3.5
-\fBカラム情報名n\fP で示された情報の配列を出力します。
-情報の順序は \fBカラム情報名n\fP の順序と同じです。
 .UNINDENT
 .UNINDENT
-.SS 例
+.SS 参考
 .INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-column_list Entry
-
-[[["id", "UInt32"],
-  ["name","ShortText"],
-  ["path","ShortText"],
-  ["type","ShortText"],
-  ["flags","ShortText"],
-  ["domain", "ShortText"],
-  ["range", "ShortText"],
-  ["source","ShortText"]],
- [258,
-  "Entry.body",
-  "test.db.0000102",
-  "var",
-  "COLUMN_SCALAR|COMPRESS_NONE|PERSISTENT",
-  "Entry",
-  "ShortText",
-  []]]
-.ft P
-.fi
-.UNINDENT
+.IP \(bu 2
+\fB/reference/commands/column_create\fP
+.IP \(bu 2
+\fB/reference/column\fP
 .UNINDENT
-.sp
-注: 実際は改行が入りません。
 .SS column_remove
 .SS 名前
 .sp
@@ -13148,16 +13271,16 @@ select Users
 このセクションでは \fBcolumn_rename\fP の引数について説明します。
 .SS 必須引数
 .sp
-All parameters are required.
+すべての引数は必須です。
 .SS \fBtable\fP
 .sp
-It specifies the name of table that has the column to be renamed.
+名前を変更したいカラムが所属するテーブルの名前を指定します。
 .SS \fBname\fP
 .sp
-It specifies the column name to be renamed.
+名前を変更するカラムを指定します。
 .SS \fBnew_name\fP
 .sp
-It specifies the new column name.
+新しいカラム名を指定します。
 .SS 戻り値
 .INDENT 0.0
 .INDENT 3.5
@@ -13180,7 +13303,7 @@ It specifies the new column name.
 \fBSUCCEEDED_OR_NOT\fP
 .INDENT 0.0
 .INDENT 3.5
-It is \fBtrue\fP on success, \fBfalse\fP otherwise.
+コマンドの実行が成功するとtrueを返します。失敗するとfalseを返します。
 .UNINDENT
 .UNINDENT
 .SS define_selector
@@ -14327,6 +14450,108 @@ _
 .IP \(bu 2
 \fB/reference/normalizers\fP
 .UNINDENT
+.SS \fBnormalizer_list\fP
+.SS 概要
+.sp
+\fBnormalizer_list\fP command lists normalizers in a database.
+.SS 構文
+.sp
+\fBnormalizer_list\fP command takes no parameter.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+normalizer_list
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS 使い方
+.sp
+以下は簡単な使用例です。
+.sp
+実行例:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+normalzer_list
+# [
+#   [
+#     0,
+#     0.0,
+#     0.0
+#   ],
+#   [
+#     {
+#       "name": "NormalizerAuto"
+#     },
+#     {
+#       "name": "NormalizerNFKC51"
+#     }
+#   ]
+# ]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+It returns normalizers in a database.
+.SS 戻り値
+.sp
+\fBnormalizer_list\fP command returns normalizers. Each normalizers has an attribute
+that contains the name. The attribute will be increased in the feature:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+[HEADER, normalizer]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+\fBHEADER\fP
+.INDENT 0.0
+.INDENT 3.5
+\fBHEADER\fP については \fB/reference/command/output_format\fP を参照してください。
+.UNINDENT
+.UNINDENT
+.sp
+\fBnormalizer\fP
+.INDENT 0.0
+.INDENT 3.5
+\fBnormalizer\fP is an array of normalizer. Normalizer is an object that has the following
+attributes.
+.TS
+center;
+|l|l|.
+_
+T{
+名前
+T}	T{
+説明
+T}
+_
+T{
+\fBname\fP
+T}	T{
+Normalizer name.
+T}
+_
+.TE
+.UNINDENT
+.UNINDENT
+.SS 参考
+.INDENT 0.0
+.IP \(bu 2
+\fB/reference/normalizers\fP
+.IP \(bu 2
+\fB/reference/commands/normalize\fP
+.UNINDENT
 .SS quit
 .SS 名前
 .sp
@@ -14608,7 +14833,7 @@ select table
        [limit=10]
        [drilldown=null]
        [drilldown_sortby=null]
-       [drilldown_output_columns=null]
+       [drilldown_output_columns="_key, _nsubrecs"]
        [drilldown_offset=0]
        [drilldown_limit=10]
        [cache=yes]
@@ -16295,7 +16520,7 @@ select Entries \-\-output_columns \(aq_id, _key\(aq \-\-limit 1
 この \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/pseudo_column\fP\&.
+\fB/reference/columns/pseudo\fP\&.
 .sp
 以下は \fB*\fP の使用例です。
 .sp
@@ -16946,6 +17171,74 @@ select Entries \e
 .sp
 \fBFACTOR\fP を省略した \fBadjuster\fP の使用例です。
 .sp
+実行例:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+select Entries \e
+  \-\-filter true \e
+  \-\-adjuster \(aqcontent @ "groonga"\(aq \e
+  \-\-output_columns _key,content,_score
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         5
+#       ],
+#       [
+#         [
+#           "_key",
+#           "ShortText"
+#         ],
+#         [
+#           "content",
+#           "Text"
+#         ],
+#         [
+#           "_score",
+#           "Int32"
+#         ]
+#       ],
+#       [
+#         "The first post!",
+#         "Welcome! This is my first post!",
+#         1
+#       ],
+#       [
+#         "Groonga",
+#         "I started to use groonga. It\(aqs very fast!",
+#         2
+#       ],
+#       [
+#         "Mroonga",
+#         "I also started to use mroonga. It\(aqs also very fast! Really fast!",
+#         1
+#       ],
+#       [
+#         "Good\-bye Senna",
+#         "I migrated all Senna system!",
+#         1
+#       ],
+#       [
+#         "Good\-bye Tritonn",
+#         "I also migrated all Tritonn system!",
+#         1
+#       ]
+#     ]
+#   ]
+# ]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
 この \fBselect\fP コマンドの \fBadjuster\fP は \fBFACTOR\fP がありません。そのため、係数は1になります。 \fBEntries.content\fP カラムに \fB"groonga"\fP を含むレコードは1つだけです。キーが \fB"Groonga"\fP のレコードです。このレコードのスコアーは2（ \fB= 1 + 1\fP ）になります。
 .sp
 複数の \fBSCORE_ADJUST_EXPRESSION\fP を使った \fBadjuster\fP の使用例です。
@@ -17026,11 +17319,7 @@ select Entries \e
 .sp
 最終的なスコアーの増分は9（ \fB= 1 + 5 + 3\fP ）です。
 .sp
-A \fBSCORE_ADJUST_EXPRESSION\fP has a factor for \fB"KEYWORD"\fP\&. This
-means that increased scores of all records that has \fB"KEYWORD"\fP are
-the same value. You can change increase score for each record that has
-the same \fB"KEYWORD"\fP\&. It is useful to tune search score. See
-\fIweight\-vector\-column\fP for details.
+1つの \fBSCORE_ADJUST_EXPRESSION\fP は \fB"KEYWORD"\fP に対して1つの係数を持ちます。これは、 \fB"KEYWORD"\fP を持つすべてのレコードでスコアーの増加分は同じということです。 \fB"KEYWORD"\fP を持つそれぞれのレコード毎にスコアーの増加分を変えることができます。これは検索スコアーをチューニングするときに便利です。詳細は \fIweight\-vector\-column\fP を参照してください。
 .SS 返値
 .sp
 TODO: write in English and add example.
@@ -18988,37 +19277,147 @@ tokenize TokenBigramSplitSymbolAlpha "Fulltext Search" NormalizerAuto
 .UNINDENT
 .UNINDENT
 .sp
-すべてのアルファベットが2文字ごとにトークナイズされています。そして、すべての文字が小文字にノーマライズされています。例えば、 \fBfu\fP で1つのトークンになっています。
-.SS \fBflags\fP
-.sp
-トークナイズ処理をカスタマイズするオプションを指定します。「 \fB|\fP 」で区切って複数のオプションを指定することができます。例えば、 \fBNONE|ENABLE_TOKENIZED_DELIMITER\fP というように指定できます。
+すべてのアルファベットが2文字ごとにトークナイズされています。そして、すべての文字が小文字にノーマライズされています。例えば、 \fBfu\fP で1つのトークンになっています。
+.SS \fBflags\fP
+.sp
+トークナイズ処理をカスタマイズするオプションを指定します。「 \fB|\fP 」で区切って複数のオプションを指定することができます。例えば、 \fBNONE|ENABLE_TOKENIZED_DELIMITER\fP というように指定できます。
+.sp
+指定可能なフラグは以下の通りです。
+.TS
+center;
+|l|l|.
+_
+T{
+フラグ
+T}	T{
+説明
+T}
+_
+T{
+\fBNONE\fP
+T}	T{
+無視されます。
+T}
+_
+T{
+\fBENABLE_TOKENIZED_DELIMITER\fP
+T}	T{
+トークナイズ済み区切り文字を有効にします。トークナイズ済み区切り文字の詳細は \fB/reference/tokenizers\fP を参照してください。
+T}
+_
+.TE
+.sp
+以下は \fBENABLE_TOKENIZED_DELIMITER\fP を使った例です。
+.sp
+実行例:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+tokenize TokenDelimit "Full￾text Sea￾crch" NormalizerAuto ENABLE_TOKENIZED_DELIMITER
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     {
+#       "position": 0,
+#       "value": "full"
+#     },
+#     {
+#       "position": 1,
+#       "value": "text sea"
+#     },
+#     {
+#       "position": 2,
+#       "value": "crch"
+#     }
+#   ]
+# ]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+\fBTokenDelimit\fP トークナイザーはトークナイズ済み区切り文字をサポートしているトークナイザーの1つです。 \fBENABLE_TOKENIZED_DELIMITER\fP でトークナイズ済み区切り文字を有効に出来ます。トークナイズ済み区切り文字はトークンの区切りを表す特別な文字です。この文字は \fBU+FFFE\fP です。この文字コードはどの文字にも割り当てられていません。つまり、通常の文字列にはこの文字は現れません。よって、トークンの区切りを表すという目的には適切な文字です。 \fBENABLE_TOKENIZED_DELIMITER\fP が有効のときは、対象文字列はすでにトークナイズ済みであると扱われます。トークナイザーは単にトークナイズ済み区切り文字で区切ってトークナイズします。
+.SS 戻り値
+.sp
+\fBtokenize\fP コマンドはトークナイズしたトークンをすべて返します。各トークンはトークン自身の文字列情報以外にいくつかの属性を持ちます。属性は今後増えていく可能性があります:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+[HEADER, tokens]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+\fBHEADER\fP
+.INDENT 0.0
+.INDENT 3.5
+\fBHEADER\fP については \fB/reference/command/output_format\fP を参照してください。
+.UNINDENT
+.UNINDENT
 .sp
-指定可能なフラグは以下の通りです。
+\fBtokens\fP
+.INDENT 0.0
+.INDENT 3.5
+\fBtokens\fP はトークンの配列です。トークンは以下の属性を持ったオブジェクトです。
 .TS
 center;
 |l|l|.
 _
 T{
-フラグ
+名前
 T}	T{
 説明
 T}
 _
 T{
-\fBNONE\fP
+\fBvalue\fP
 T}	T{
-無視されます。
+トークン自身
 T}
 _
 T{
-\fBENABLE_TOKENIZED_DELIMITER\fP
+\fBposition\fP
 T}	T{
-トークナイズ済み区切り文字を有効にします。トークナイズ済み区切り文字の詳細は \fB/reference/tokenizers\fP を参照してください。
+N番目のトークン。
 T}
 _
 .TE
+.UNINDENT
+.UNINDENT
+.SS 参考
+.INDENT 0.0
+.IP \(bu 2
+\fB/reference/tokenizers\fP
+.UNINDENT
+.SS \fBtokenizer_list\fP
+.SS 概要
 .sp
-以下は \fBENABLE_TOKENIZED_DELIMITER\fP を使った例です。
+\fBtokenizer_list\fP command lists tokenizers in a database.
+.SS 構文
+.sp
+\fBtokenizer_list\fP command takes no parameter.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+tokenizer_list
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS 使い方
+.sp
+以下は簡単な使用例です。
 .sp
 実行例:
 .INDENT 0.0
@@ -19026,25 +19425,52 @@ _
 .sp
 .nf
 .ft C
-tokenize TokenDelimit "Full￾text Sea￾crch" NormalizerAuto ENABLE_TOKENIZED_DELIMITER
+tokenizer_list
 # [
 #   [
 #     0,
-#     1337566253.89858,
-#     0.000355720520019531
+#     0.0,
+#     0.0
 #   ],
 #   [
 #     {
-#       "position": 0,
-#       "value": "full"
+#       "name": "TokenMecab"
 #     },
 #     {
-#       "position": 1,
-#       "value": "text sea"
+#       "name": "TokenDelimit"
 #     },
 #     {
-#       "position": 2,
-#       "value": "crch"
+#       "name": "TokenUnigram"
+#     },
+#     {
+#       "name": "TokenBigram"
+#     },
+#     {
+#       "name": "TokenTrigram"
+#     },
+#     {
+#       "name": "TokenBigramSplitSymbol"
+#     },
+#     {
+#       "name": "TokenBigramSplitSymbolAlpha"
+#     },
+#     {
+#       "name": "TokenBigramSplitSymbolAlphaDigit"
+#     },
+#     {
+#       "name": "TokenBigramIgnoreBlank"
+#     },
+#     {
+#       "name": "TokenBigramIgnoreBlankSplitSymbol"
+#     },
+#     {
+#       "name": "TokenBigramIgnoreBlankSplitSymbolAlpha"
+#     },
+#     {
+#       "name": "TokenBigramIgnoreBlankSplitSymbolAlphaDigit"
+#     },
+#     {
+#       "name": "TokenDelimitNull"
 #     }
 #   ]
 # ]
@@ -19053,16 +19479,17 @@ tokenize TokenDelimit "Full
 .UNINDENT
 .UNINDENT
 .sp
-\fBTokenDelimit\fP トークナイザーはトークナイズ済み区切り文字をサポートしているトークナイザーの1つです。 \fBENABLE_TOKENIZED_DELIMITER\fP でトークナイズ済み区切り文字を有効に出来ます。トークナイズ済み区切り文字はトークンの区切りを表す特別な文字です。この文字は \fBU+FFFE\fP です。この文字コードはどの文字にも割り当てられていません。つまり、通常の文字列にはこの文字は現れません。よって、トークンの区切りを表すという目的には適切な文字です。 \fBENABLE_TOKENIZED_DELIMITER\fP が有効のときは、対象文字列はすでにトークナイズ済みであると扱われます。トークナイザーは単にトークナイズ済み区切り文字で区切ってトークナイズします。
+It returns tokenizers in a database.
 .SS 戻り値
 .sp
-\fBtokenize\fP コマンドはトークナイズしたトークンをすべて返します。各トークンはトークン自身の文字列情報以外にいくつかの属性を持ちます。属性は今後増えていく可能性があります:
+\fBtokenizer_list\fP command returns tokenizers. Each tokenizers has an attribute
+that contains the name. The attribute will be increased in the feature:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-[HEADER, tokens]
+[HEADER, tokenizer]
 .ft P
 .fi
 .UNINDENT
@@ -19075,10 +19502,11 @@ tokenize TokenDelimit "Full
 .UNINDENT
 .UNINDENT
 .sp
-\fBtokens\fP
+\fBtokenizer\fP
 .INDENT 0.0
 .INDENT 3.5
-\fBtokens\fP はトークンの配列です。トークンは以下の属性を持ったオブジェクトです。
+\fBtokenizer\fP is an array of tokenizer. Tokenizer is an object that has the following
+attributes.
 .TS
 center;
 |l|l|.
@@ -19090,15 +19518,9 @@ T}	T{
 T}
 _
 T{
-\fBvalue\fP
-T}	T{
-トークン自身
-T}
-_
-T{
-\fBposition\fP
+\fBname\fP
 T}	T{
-N番目のトークン。
+Tokenizer name.
 T}
 _
 .TE
@@ -19108,6 +19530,8 @@ _
 .INDENT 0.0
 .IP \(bu 2
 \fB/reference/tokenizers\fP
+.IP \(bu 2
+\fB/reference/commands/tokenize\fP
 .UNINDENT
 .SS \fBtruncate\fP
 .SS 概要
@@ -19652,6 +20076,8 @@ _
 \fBcolumns/scalar\fP
 .IP \(bu 2
 \fBcolumns/vector\fP
+.IP \(bu 2
+\fBcolumns/pseudo\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -20117,52 +20543,6 @@ mroonga(TAB)mroonga(TAB)groonga MySQL
 .UNINDENT
 .UNINDENT
 .UNINDENT
-.SS 疑似カラム (pseudo_column)
-.SS 名前
-.sp
-疑似カラム
-.SS 説明
-.sp
-Groongaのデータベースで作成したテーブルには、いくつかのカラムが自動的に定義されます。
-.sp
-これらのカラムはいずれもアンダースコア(\(aq_\(aq)で始まる名前が付与されます。定義される疑似カラムは、テーブルの種類によって異なります。
-.sp
-\fB_id\fP
-.INDENT 0.0
-.INDENT 3.5
-レコードに付与される一意な番号です。全てのテーブルに定義されます。値の範囲は1〜1073741824の整数で、通常はレコードを追加した順に1ずつ加算されます。_idの値は不変で、レコードが存在する限り変更することはできません。ただし、削除されたレコードの_idの値は再利用されます。
-.UNINDENT
-.UNINDENT
-.sp
-\fB_key\fP
-.INDENT 0.0
-.INDENT 3.5
-レコードの主キー値を表します。主キーを持つテーブルのみに定義されます。主キー値はテーブルの中で一意であり、変更することはできません。
-.UNINDENT
-.UNINDENT
-.sp
-\fB_value\fP
-.INDENT 0.0
-.INDENT 3.5
-レコードの値を表します。value_typeを指定したテーブルのみに定義されます。自由に変更可能です。
-.UNINDENT
-.UNINDENT
-.sp
-\fB_score\fP
-.INDENT 0.0
-.INDENT 3.5
-各レコードのスコア値を表します。検索結果として生成されたテーブルのみに定義されます。
-.sp
-検索処理を実行する過程で値が設定されますが、自由に変更可能です。
-.UNINDENT
-.UNINDENT
-.sp
-\fB_nsubrecs\fP
-.INDENT 0.0
-.INDENT 3.5
-主キーの値が同一であったレコードの件数を表します。検索結果として生成されたテーブルのみに定義されます。グループ化(drilldown)処理を実行すると、グループ化前のテーブルにおいて、グループ化キーの値が同一であったレコードの件数が、グループ化処理の結果を格納するテーブルの_nsubrecsに記録されます。
-.UNINDENT
-.UNINDENT
 .SS grn_expr
 .sp
 grn_exprは特定の条件にマッチするレコードを検索したり、データベースを操作するオブジェクトです。 \fBぐるんしき\fP と読みます。（由来は「Groongaの式」。）
@@ -20270,7 +20650,9 @@ load \-\-table Entries
 .UNINDENT
 .UNINDENT
 .sp
-エスケープする代わりにクォートすることもできます。クォート構文は \fB"..."\fP または \fB\(aq...\(aq\fP です。 \fB"..."\fP クォート構文中では \fB"\fP を \fB\e"\fP にエスケープする必要があります。 \fB\(aq...\(aq\fP クォート構文中では \fB\(aq\fP を \fB\e\(aq\fP にエスケープする必要があります。例えば、 \fBAlice\(aqs brother (Bob)\fP は \fB"Alice\(aqs brother (Bob)"\fP あるいは \fB\(aqAlice\e\(aqs brother (Bob)\(aq\fP とクォートします。
+\fB\e\fP （バックスラッシュ）以外はエスケープする代わりにクォートすることもできます。クォート中でバックスラッシュをエスケープするときは \fB\e\e\fP というようにバックスラッシュを使います。
+.sp
+クォート構文は \fB"..."\fP または \fB\(aq...\(aq\fP です。 \fB"..."\fP クォート構文中では \fB"\fP を \fB\e"\fP にエスケープする必要があります。 \fB\(aq...\(aq\fP クォート構文中では \fB\(aq\fP を \fB\e\(aq\fP にエスケープする必要があります。例えば、 \fBAlice\(aqs brother (Bob)\fP は \fB"Alice\(aqs brother (Bob)"\fP あるいは \fB\(aqAlice\e\(aqs brother (Bob)\(aq\fP とクォートします。
 .sp
 \fBノート:\fP
 .INDENT 0.0
@@ -26954,7 +27336,7 @@ TODO...
 .INDENT 0.0
 .TP
 .B GRN_COLUMN_NAME_ID
-It returns the name of \fB/reference/pseudo_column\fP \fB_id\fP\&.
+It returns the name of \fB/reference/columns/pseudo\fP \fB_id\fP\&.
 .sp
 It is useful to use with \fBGRN_COLUMN_NAME_ID_LEN\fP like
 the following:
@@ -26982,7 +27364,7 @@ Since 3.1.1.
 .INDENT 0.0
 .TP
 .B GRN_COLUMN_NAME_KEY
-It returns the name of \fB/reference/pseudo_column\fP \fB_key\fP\&.
+It returns the name of \fB/reference/columns/pseudo\fP \fB_key\fP\&.
 .sp
 It is useful to use with \fBGRN_COLUMN_NAME_KEY_LEN\fP like
 the following:
@@ -27010,7 +27392,7 @@ Since 3.1.1.
 .INDENT 0.0
 .TP
 .B GRN_COLUMN_NAME_VALUE
-It returns the name of \fB/reference/pseudo_column\fP \fB_value\fP\&.
+It returns the name of \fB/reference/columns/pseudo\fP \fB_value\fP\&.
 .sp
 It is useful to use with \fBGRN_COLUMN_NAME_VALUE_LEN\fP like
 the following:
@@ -27038,7 +27420,7 @@ Since 3.1.1.
 .INDENT 0.0
 .TP
 .B GRN_COLUMN_NAME_SCORE
-It returns the name of \fB/reference/pseudo_column\fP \fB_score\fP\&.
+It returns the name of \fB/reference/columns/pseudo\fP \fB_score\fP\&.
 .sp
 It is useful to use with \fBGRN_COLUMN_NAME_SCORE_LEN\fP like
 the following:
@@ -27066,7 +27448,7 @@ Since 3.1.1.
 .INDENT 0.0
 .TP
 .B GRN_COLUMN_NAME_NSUBRECS
-It returns the name of \fB/reference/pseudo_column\fP \fB_nsubrecs\fP\&.
+It returns the name of \fB/reference/columns/pseudo\fP \fB_nsubrecs\fP\&.
 .sp
 It is useful to use with \fBGRN_COLUMN_NAME_NSUBRECS_LEN\fP like
 the following:
@@ -29314,6 +29696,25 @@ objectに登録できるユーザデータへのポインタを返します。ta
 .UNINDENT
 .UNINDENT
 .UNINDENT
+.SS Plugin
+.SS 概要
+.sp
+Groonga supports plugin. You can create a new plugin with the
+following API.
+.sp
+TOOD: Describe about how to create the minimum plugin here or create a
+tutorial about it.
+.SS リファレンス
+.INDENT 0.0
+.TP
+.B grn_obj grn_plugin_proc_get_var(grn_ctx\fI\ *ctx\fP, grn_user_data\fI\ *user_data\fP, const char\fI\ *name\fP, int\fI\ name_size\fP)
+TODO...
+.UNINDENT
+.INDENT 0.0
+.TP
+.B grn_obj *grn_plugin_proc_get_var_by_offset(grn_ctx *ctx, grn_user_data *user_data, unsigned int offset);
+TODO...
+.UNINDENT
 .SH 仕様
 .SS GQTP
 .sp
@@ -30188,7 +30589,7 @@ Travis CIは64\-bit版のUbuntu 12.04 LTS サーバ版を使っています。
 .nf
 .ft C
 before_install:
-  \- curl https://raw.github.com/groonga/groonga/master/data/travis/setup.sh | sh
+  \- curl \-\-silent \-\-location https://github.com/groonga/groonga/raw/master/data/travis/setup.sh | sh
 .ft P
 .fi
 .UNINDENT
@@ -30268,11 +30669,111 @@ GroongaプロジェクトではGroongaについて議論するための \fB/comm
 .SS ドキュメント関連のコントリビュート方法
 .sp
 ドキュメントツールとして \fI\%Sphinx\fP を使います。
-.SS C API
+.SS Introduction
 .sp
-今のところ、C APIのドキュメントはinclude/groonga.hにありますが、これをdoc/source/c\-api/*.txtに移動したいと思っています。C APIのドキュメントを移動して、パッチを送ってくれるととても喜びます。
+This documentation describes about how to write, generate and manage
+Groonga documentation.
+.SS Install depended softwares
 .sp
-Sphinxの \fI\%the C domain markup\fP を使う予定です。
+Groonga uses \fI\%Sphinx\fP as documentation tool. Groonga requires newer
+Sphinx. So Groonga clones the latest Sphinx from Sphinx repository
+automatically. You need only \fI\%Mercurial\fP, \fI\%Docutils\fP and \fI\%Jinja\fP\&.
+.sp
+Here are command lines to install needed softwares.
+.sp
+Debian GNU/Linux, Ubuntu:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% sudo apt\-get install \-V \-y mercurial python\-docutils python\-jinja2
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+CentOS, Fedora:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% sudo yum install \-y mercurial python\-docutils python\-jinja2
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+OS X:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% brew install mercurial
+% pip install docutils
+% pip install jinja
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS Run \fBconfigure\fP with \fB\-\-enable\-document\fP
+.sp
+Groonga disables documentation generation by default. You need to
+enable it explicitly by adding \fB\-\-enable\-document\fP option to
+\fBconfigure\fP:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% ./configure \-\-enable\-document
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Now, your Groonga build is documentation ready.
+.SS HTMLファイルを生成
+.sp
+You can generate HTML by the following command:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% make \-C doc html
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+You can find generated HTML documentation at \fBdoc/locale/en/html/\fP\&.
+.SS Update
+.sp
+You can find sources of documentation at \fBdoc/source/\fP\&. The sources
+should be written in English. See \fBi18n\fP about how to translate
+documentation.
+.sp
+You can update the target file when you update the existing
+documentation file.
+.sp
+You need to update file list after you add a new file, change file
+path and delete existing file. You can update file list by the
+following command:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% make \-C doc update\-files
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+The command updates \fBdoc/files.am\fP\&.
 .SS 国際化
 .sp
 今のところ、Groongaには日本語でのドキュメントしかありません。1.2.2からgettextベースの \fI\%Sphinx I18N feature\fP を使ってドキュメントの国際化対応を始めました。この仕組みではベースの言語として英語を使い、日本語などの他の言語には英語からその言語に翻訳します。すべてのドキュメントはdoc/source/以下において、それをSphinxで処理します。
@@ -30513,7 +31014,12 @@ doc/locale/${LANGUAGE}/LC_MESSAGES/以下を.tar.gzや.zipなどでアーカイ
 言語名を表記するためのコード
 .UNINDENT
 .UNINDENT
-.SS groonga開発者向け情報
+.SS C API
+.sp
+今のところ、C APIのドキュメントはinclude/groonga.hにありますが、これをdoc/source/c\-api/*.txtに移動したいと思っています。C APIのドキュメントを移動して、パッチを送ってくれるととても喜びます。
+.sp
+Sphinxの \fI\%the C domain markup\fP を使う予定です。
+.SS Groonga開発者向け情報
 .SS リポジトリ
 .sp
 Groongaのリポジトリは \fI\%GitHub\fP 上にあります。次のコマンドでcloneできます。
@@ -30629,65 +31135,6 @@ Groonga関連で気軽につぶやけないとなると開発者は困ってい
 .SS 対応
 .sp
 twitterでやりとりを完結できるようにします。
-.SS ドキュメント作成
-.SS Sphinxのインストール
-.sp
-Groongaのドキュメントは、Sphinxというツールを用いて作成されています。Sphinxは以下のように導入します。:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-# aptitude install python\-setuptools
-# easy_install \-U sphinx
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.SS htmlの作成
-.sp
-以下のコマンドでhtmlが作成されます。:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% make html
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-このドキュメントはソースアーカイブの形式で配布され、随時更新しています。最新のドキュメントをソース形式で参照したいなら、GitHubのリポジトリブラウザ経由で閲覧できます。(\fI\%https://github.com/groonga/groonga/tree/master/doc/source\fP)
-.SS pdfの作成
-.sp
-Groongaのドキュメントは、pdf出力することもできます。rst2pdfと、IPAフォント(IPA Gothic/IPAexGothic)が必要となります。
-.SS rst2pdfのインストール
-.sp
-以下のようにしてインストールできます。:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-# easy_install rst2pdf
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.SS pdfの作成
-.sp
-以下のコマンドでpdfが作成されます。:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% make pdf
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
 .SS クエリの実現
 .sp
 Groongaのデータベースには大量のデータを格納し、その中から必要な部分を高速に取り出すことができます。必要な部分をGroongaのデータベースに問い合わせるためのクエリの表現と実行に関して、Groongaは複数の手段を用意しています。