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

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

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "GROONGA" "1" "March 28, 2014" "4.0.1" "Groonga"
+.TH "GROONGA" "1" "May 29, 2014" "4.0.2" "Groonga"
 .SH NAME
 groonga \- Groonga documentation
 .
@@ -77,15 +77,15 @@ The basic functions of Groonga are provided in a C library and any application c
 .SS Groonga server
 .sp
 Groonga provides a built\-in server command which supports HTTP, the memcached binary protocol and the Groonga Query Transfer Protocol (GQTP). Also, a Groonga server supports query caching, which significantly reduces response time for repeated read queries. Using this command, Groonga is available even on a server that does not allow you to install new libraries.
-.SS Groonga storage engine
+.SS Mroonga storage engine
 .sp
-Groonga works not only as an independent column\-oriented DBMS but also as storage engines of well\-known DBMSs. For example, \fI\%mroonga\fP is a MySQL pluggable storage engine using Groonga. By using mroonga, you can use Groonga for column\-oriented storage and full text search. A combination of a built\-in storage engine, MyISAM or InnoDB, and a groonga\-based full text search engine is also available. All the combinations have good and bad points and the best one depends on the application. See \fI\%related projects\fP for details.
+Groonga works not only as an independent column\-oriented DBMS but also as storage engines of well\-known DBMSs. For example, \fI\%Mroonga\fP is a MySQL pluggable storage engine using Groonga. By using Mroonga, you can use Groonga for column\-oriented storage and full text search. A combination of a built\-in storage engine, MyISAM or InnoDB, and a Groonga\-based full text search engine is also available. All the combinations have good and bad points and the best one depends on the application. See \fI\%related projects\fP for details.
 .SH INSTALL
 .sp
-This section describes how to install groonga on each
+This section describes how to install Groonga on each
 environment. There are packages for major platforms. It\(aqs recommended
-that you use package instead of building groonga by yourself. But
-don\(aqt warry. There is a document about building groonga from source.
+that you use package instead of building Groonga by yourself. But
+don\(aqt warry. There is a document about building Groonga from source.
 .sp
 We distribute both 32\-bit and 64\-bit packages but we strongly
 recommend a 64\-bit package for server. You should use a 32\-bit package
@@ -110,7 +110,7 @@ packages.groonga.org:
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.1\-x86.exe\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.2\-x86.exe\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -123,7 +123,7 @@ packages.goronga.org:
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.1\-x64.exe\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.2\-x64.exe\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -140,7 +140,7 @@ packages.groonga.org:
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.1\-x86.zip\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.2\-x86.zip\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -153,7 +153,7 @@ packages.groonga.org:
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.1\-x64.zip\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.2\-x64.zip\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -181,7 +181,7 @@ Download zipped source from packages.groonga.org:
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fI\%http://packages.groonga.org/source/groonga/groonga\-4.0.1.zip\fP
+\fI\%http://packages.groonga.org/source/groonga/groonga\-4.0.2.zip\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -194,7 +194,7 @@ Move to the Groonga\(aqs source folder:
 .sp
 .nf
 .ft C
-> cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-4.0.1
+> cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-4.0.2
 .ft P
 .fi
 .UNINDENT
@@ -208,7 +208,7 @@ parameter instead:
 .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
@@ -220,7 +220,7 @@ Build:
 .sp
 .nf
 .ft C
-groonga\-4.0.1> cmake \-\-build . \-\-config Release
+groonga\-4.0.2> cmake \-\-build . \-\-config Release
 .ft P
 .fi
 .UNINDENT
@@ -232,7 +232,7 @@ Install:
 .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
@@ -242,14 +242,8 @@ After the above steps, \fB/reference/executables/groonga\fP is found in
 \fBc:\egroonga\ebin\egroonga.exe\fP\&.
 .SS Mac OS X
 .sp
-This section describes how to install groonga on Mac OS X. You can
-install groonga by \fI\%MacPorts\fP or \fI\%Homebrew\fP\&.
-.sp
-We distribute both 32\-bit and 64\-bit packages but we strongly
-recommend a 64\-bit package for server. You should use a 32\-bit package
-just only for tests or development. You will encounter an out of
-memory error with a 32\-bit package even if you just process medium
-size data.
+This section describes how to install Groonga on Mac OS X. You can
+install Groonga by \fI\%MacPorts\fP or \fI\%Homebrew\fP\&.
 .SS MacPorts
 .sp
 Install:
@@ -276,6 +270,19 @@ Install:
 .fi
 .UNINDENT
 .UNINDENT
+.sp
+If you want to use \fI\%MeCab\fP as a
+tokenizer, specify \fB\-\-with\-mecab\fP option:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% brew install groonga \-\-with\-mecab
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
 .SS Build from source
 .sp
 Install \fI\%Xcode\fP\&.
@@ -286,9 +293,9 @@ Download source:
 .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
@@ -384,9 +391,9 @@ Install:
 .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
@@ -401,7 +408,7 @@ Install groonga\-tokenizer\-mecab package:
 .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
@@ -416,7 +423,7 @@ Install groonga\-munin\-plugins package:
 .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
@@ -432,7 +439,7 @@ Install groonga\-normalizer\-mysql package:
 .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
@@ -461,9 +468,9 @@ Install:
 .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
@@ -478,7 +485,7 @@ Install groonga\-tokenizer\-mecab package:
 .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
@@ -493,7 +500,7 @@ Install groonga\-munin\-plugins package:
 .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
@@ -509,7 +516,7 @@ Install groonga\-normalizer\-mysql package:
 .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
@@ -537,10 +544,10 @@ Install:
 .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
@@ -555,7 +562,7 @@ Install groonga\-tokenizer\-mecab package:
 .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
@@ -570,7 +577,7 @@ Install groonga\-munin\-plugins package:
 .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
@@ -586,20 +593,20 @@ Install groonga\-normalizer\-mysql package:
 .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
 .UNINDENT
 .SS Build from source
 .sp
-Install required packages to build groonga:
+Install required packages to build Groonga:
 .INDENT 0.0
 .INDENT 3.5
 .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
@@ -611,9 +618,9 @@ Download source:
 .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
@@ -685,226 +692,46 @@ groonga\-server\-gqtp (GQTP protocol based server package)
 See \fB/server\fP section about details.
 .UNINDENT
 .UNINDENT
-.SS 12.04 LTS Precise Pangolin
-.sp
-\fBNOTE:\fP
-.INDENT 0.0
-.INDENT 3.5
-Enable the universe repository to install groonga:
-.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
-Add the Groonga apt repository.
-.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
-Install:
-.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
-If you want to use \fI\%MeCab\fP as a
-tokenizer, install groonga\-tokenizer\-mecab package.
-.sp
-Install groonga\-tokenizer\-mecab package:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo apt\-get \-y install groonga\-tokenizer\-mecab
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-There is a package that provides \fI\%Munin\fP plugins. If you want to monitor
-groonga status by Munin, install groonga\-munin\-plugins package.
-.sp
-Install groonga\-munin\-plugins package:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo apt\-get \-y install groonga\-munin\-plugins
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-There is a package that provides MySQL compatible normalizer as
-Groonga plugins.
-If you want to use that one, install groonga\-normalizer\-mysql package.
-.sp
-Install groonga\-normalizer\-mysql package:
-.INDENT 0.0
-.INDENT 3.5
+.SS PPA (Personal Package Archive)
 .sp
-.nf
-.ft C
-% sudo apt\-get \-y install groonga\-normalizer\-mysql
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.SS 12.10 Quantal Quetzal
+The Groonga APT repository for Ubuntu uses PPA (Personal Package
+Archive) on Launchpad. You can install Groonga by APT from the PPA.
 .sp
-\fBNOTE:\fP
+Here are supported Ubuntu versions:
 .INDENT 0.0
 .INDENT 3.5
-Enable the universe repository to install groonga:
 .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
+.IP \(bu 2
+12.04 LTS Precise Pangolin
+.IP \(bu 2
+13.10 Saucy Salamander
+.IP \(bu 2
+14.04 LTS Trusty Tahr
 .UNINDENT
 .UNINDENT
 .UNINDENT
 .sp
-Add the Groonga apt repository.
-.sp
-/etc/apt/sources.list.d/groonga.list:
+Enable the universe repository to install Groonga:
 .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
+% sudo apt\-get \-y install software\-properties\-common
+% sudo add\-apt\-repository \-y universe
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-Install:
+Add the \fBppa:groonga/ppa\fP PPA to your system:
 .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
-If you want to use \fI\%MeCab\fP as a
-tokenizer, install groonga\-tokenizer\-mecab package.
-.sp
-Install groonga\-tokenizer\-mecab package:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo apt\-get \-y install groonga\-tokenizer\-mecab
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-There is a package that provides \fI\%Munin\fP plugins. If you want to monitor
-Groonga status by Munin, install groonga\-munin\-plugins package.
-.sp
-Install groonga\-munin\-plugins package:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo apt\-get \-y install groonga\-munin\-plugins
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-There is a package that provides MySQL compatible normalizer as
-Groonga plugins.
-If you want to use that one, install groonga\-normalizer\-mysql package.
-.sp
-Install groonga\-normalizer\-mysql package:
-.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
-\fBNOTE:\fP
-.INDENT 0.0
-.INDENT 3.5
-Enable the universe repository to install groonga:
-.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
-Add the Groonga apt repository.
-.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
 .ft P
 .fi
 .UNINDENT
@@ -916,9 +743,6 @@ Install:
 .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
@@ -956,83 +780,6 @@ Install groonga\-munin\-plugins package:
 .UNINDENT
 .sp
 There is a package that provides MySQL compatible normalizer as
-groonga plugins.
-If you want to use that one, install groonga\-normalizer\-mysql package.
-.sp
-Install groonga\-normalizer\-mysql package:
-.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
-Add the Groonga apt repository.
-.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
-.UNINDENT
-.sp
-Install:
-.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
-If you want to use \fI\%MeCab\fP as a
-tokenizer, install groonga\-tokenizer\-mecab package.
-.sp
-Install groonga\-tokenizer\-mecab package:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo apt\-get \-y install groonga\-tokenizer\-mecab
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-There is a package that provides \fI\%Munin\fP plugins. If you want to monitor
-Groonga status by Munin, install groonga\-munin\-plugins package.
-.sp
-Install groonga\-munin\-plugins package:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo apt\-get \-y install groonga\-munin\-plugins
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-There is a package that provides MySQL compatible normalizer as
 Groonga plugins.
 If you want to use that one, install groonga\-normalizer\-mysql package.
 .sp
@@ -1049,7 +796,7 @@ Install groonga\-normalizer\-mysql package:
 .UNINDENT
 .SS Build from source
 .sp
-Install required packages to build groonga:
+Install required packages to build Groonga:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -1067,9 +814,9 @@ Download source:
 .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
@@ -1112,7 +859,7 @@ Install:
 .UNINDENT
 .SS CentOS
 .sp
-This section describes how to install groonga related RPM packages on
+This section describes how to install Groonga related RPM packages on
 CentOS. You can install them by \fByum\fP\&.
 .sp
 We distribute both 32\-bit and 64\-bit packages but we strongly
@@ -1273,7 +1020,7 @@ Install groonga\-normalizer\-mysql package:
 .sp
 .nf
 .ft C
-% sudo yum install \-y install groonga\-normalizer\-mysql
+% sudo yum install \-y groonga\-normalizer\-mysql
 .ft P
 .fi
 .UNINDENT
@@ -1382,14 +1129,14 @@ Install groonga\-normalizer\-mysql package:
 .sp
 .nf
 .ft C
-% sudo yum install \-y install groonga\-normalizer\-mysql
+% sudo yum install \-y groonga\-normalizer\-mysql
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .SS Build from source
 .sp
-Install required packages to build groonga:
+Install required packages to build Groonga:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -1407,9 +1154,9 @@ Download source:
 .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
@@ -1452,7 +1199,7 @@ Install:
 .UNINDENT
 .SS Fedora
 .sp
-This section describes how to install groonga related RPM packages on
+This section describes how to install Groonga related RPM packages on
 Fedora. You can install them by \fByum\fP\&.
 .sp
 \fBNOTE:\fP
@@ -1596,7 +1343,7 @@ Install groonga\-normalizer\-mysql package:
 .UNINDENT
 .SS Build from source
 .sp
-Install required packages to build groonga:
+Install required packages to build Groonga:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -1614,9 +1361,9 @@ Download source:
 .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
@@ -1663,7 +1410,7 @@ This section describes how to install Groonga from source on Oracle
 Solaris.
 .SS Oracle Solaris 11
 .sp
-Install required packages to build groonga:
+Install required packages to build Groonga:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -1681,9 +1428,9 @@ Download source:
 .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
@@ -1729,10 +1476,10 @@ Install:
 .UNINDENT
 .SS Others
 .sp
-This section describes how to install groonga from source on UNIX like
+This section describes how to install Groonga from source on UNIX like
 environment.
 .sp
-To get more detail about installing groonga from source on the
+To get more detail about installing Groonga from source on the
 specific environment, find the document for the specific environment
 from \fB/install\fP\&.
 .SS Dependencies
@@ -1813,7 +1560,7 @@ column value
 .UNINDENT
 .sp
 If you want to use those all or some libraries, you need to install
-them before installing groonga.
+them before installing Groonga.
 .SS Build from source
 .sp
 Groonga uses GNU build system. So the following is the simplest build
@@ -1823,9 +1570,9 @@ steps:
 .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
@@ -1853,7 +1600,7 @@ installed under \fB${PATH}/\fP directory.
 The default is \fB/usr/local\fP\&. In this case, \fB/reference/executables/groonga\fP is
 installed into \fB/usr/local/bin/groonga\fP\&.
 .sp
-Here is an example that installs groonga into \fB~/local\fP for an user
+Here is an example that installs Groonga into \fB~/local\fP for an user
 use instead of system wide use:
 .INDENT 0.0
 .INDENT 3.5
@@ -2022,12 +1769,12 @@ Here is an example that uses MessagePack built with
 .UNINDENT
 .SS \fB\-\-with\-munin\-plugins\fP
 .sp
-Installs Munin plugins for groonga. They are installed into
+Installs Munin plugins for Groonga. They are installed into
 \fB${PREFIX}/share/groonga/munin/plugins/\fP\&.
 .sp
 Those plugins are not installed by default.
 .sp
-Here is an example that installs Munin plugins for groonga:
+Here is an example that installs Munin plugins for Groonga:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -2093,7 +1840,7 @@ If you get some errors by \fBmake\fP, please report them to us:
 \fB/contribution/report\fP
 .SS \fBmake install\fP
 .sp
-Now, you can install built groonga!:
+Now, you can install built Groonga!:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -2203,7 +1950,7 @@ DB_PATH specifies the path of a target database. This command fails if the speci
 .sp
 If COMMAND is specified, Groonga executes COMMAND and returns the result. Otherwise, Groonga starts in interactive mode that reads commands from the standard input and executes them one by one. This tutorial focuses on the interactive mode.
 .sp
-Let\(aqs see the status of a groonga process by using a \fB/reference/commands/status\fP command.
+Let\(aqs see the status of a Groonga process by using a \fB/reference/commands/status\fP command.
 .sp
 Execution example:
 .INDENT 0.0
@@ -9085,6 +8832,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 GEOLOCATION SEARCH
 .sp
 Groonga supports geolocation search. It uses index for
@@ -10606,7 +10375,7 @@ out_gqtp コマンドファイル 出力ファイル名
 .UNINDENT
 .SS コマンドファイル
 .sp
-コマンドファイルは、groonga組み込みコマンドを1行に1つずつ記述したテキストファイルです。拡張子に制限はありません。groonga組み込みコマンドに関しては \fB/reference/commands\fP を参照してください。
+コマンドファイルは、groonga組み込みコマンドを1行に1つずつ記述したテキストファイルです。拡張子に制限はありません。groonga組み込みコマンドに関しては \fB/reference/command\fP を参照してください。
 .SS サンプル
 .sp
 スクリプトファイルのサンプルです。:
@@ -11613,14 +11382,70 @@ groonga\-suggest\-httpd [options] database_path
 .SS Set up
 .sp
 First you need to set up database for suggestion.
+.sp
+Execution example:
+.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
+Execution example:
+.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
@@ -11631,6 +11456,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
@@ -11662,13 +11489,13 @@ 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 Command line parameters
 .sp
 There is one required parameter \- \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 parameters
 .sp
 groonga\-suggest\-httpd accepts following GET parameters.
 .sp
@@ -11696,7 +11523,7 @@ _
 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}
 _
@@ -11719,7 +11546,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{
@@ -11733,9 +11560,9 @@ _
 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
@@ -11779,7 +11606,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
@@ -11814,7 +11641,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.
+One of \fBcomplete\fP, \fBcorrect\fP and \fBsuggest\fP\&.
 .UNINDENT
 .UNINDENT
 .sp
@@ -11825,52 +11652,96 @@ The string of candidate (UTF\-8).
 .UNINDENT
 .UNINDENT
 .sp
-\fBSCORE_N\fP
+\fBSCORE_N\fP
+.INDENT 0.0
+.INDENT 3.5
+The score.
+.UNINDENT
+.UNINDENT
+.SS groonga\-suggest\-learner
+.SS Summary
+.sp
+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 Synopsis
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+groonga\-suggest\-learner [options] database_path
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS Usage
+.sp
+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
-The number of score.
+.sp
+.nf
+.ft C
+groonga\-suggest\-learner testdb/db
+.ft P
+.fi
 .UNINDENT
 .UNINDENT
-.SS groonga\-suggest\-learner
-.SS Summary
+.SS Learning data from log files
 .sp
-TODO
-.SS Synopsis
+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 [options] database_path
+groonga\-suggest\-learner \-l logs testdb/db
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
-.SS Usage
-.sp
-TODO
 .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 Parameters
 .sp
 There is one required parameter \- \fBdatabase_path\fP\&.
 .SS \fBdatabase_path\fP
 .sp
 Specifies the path to a groonga database.
+.SS Related tables
+.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 Output
 .sp
 Groonga supports the following output format types:
@@ -13231,11 +13102,13 @@ See \fB/reference/command/output_format\fP about \fBHEADER\fP\&.
 If command is succeeded, it returns true on success, false otherwise.
 .UNINDENT
 .UNINDENT
-.SS column_list
-.SS 名前
+.SS \fBcolumn_list\fP
+.SS Summary
 .sp
-column_list \- テーブルに定義されているカラムのリスト表示
-.SS 書式
+\fBcolumn_list\fP command lists columns in a table.
+.SS Syntax
+.sp
+\fBcolumn_list\fP command takes one required parameter:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -13246,140 +13119,383 @@ column_list table
 .fi
 .UNINDENT
 .UNINDENT
-.SS 説明
+.SS Usage
 .sp
-Groonga組込コマンドの一つであるcolumn_listについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Here is a simple example of \fBcolumn_list\fP command.
 .sp
-column_listはテーブルに定義されているカラムをリスト表示します。
-.SS 引数
+Execution example:
 .INDENT 0.0
-.TP
-.B \fBtable\fP
-カラム情報を出力するテーブルの名前を指定します。
+.INDENT 3.5
+.sp
+.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
-.SS 返値
-.SS json形式
+.UNINDENT
+.SS Parameters
+.sp
+This section describes parameters of \fBcolumn_list\fP\&.
+.SS Required parameters
+.sp
+All parameters are required.
+.SS \fBtable\fP
+.sp
+It specifies the name of table to be listed columns.
+.SS Return value
 .sp
-カラム名一覧を以下の形式で返却します。:
+\fBcolumn_list\fP returns the list of column information in the table:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-[[[カラム情報名1,カラム情報型1],...], カラム情報1,...]
+[
+  HEADER,
+  [
+    COLUMN_LIST_HEADER,
+    COLUMN_INFORMATION1,
+    COLUMN_INFORMATION2,
+    ...
+  ]
+]
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-\fBカラム情報名n\fP
+\fBHEADER\fP
 .INDENT 0.0
 .INDENT 3.5
-\fBカラム情報n\fP には複数の情報が含まれますが、そこに入る情報がどんな内容かを示す名前を出力します。
-情報名は以下の通りです。
+See \fB/reference/command/output_format\fP about \fBHEADER\fP\&.
+.UNINDENT
+.UNINDENT
 .sp
-\fBid\fP
+\fBCOLUMN_LIST_HEADER\fP
 .INDENT 0.0
 .INDENT 3.5
-カラムオブジェクトに割り当てられたID
-.UNINDENT
-.UNINDENT
+\fBCOLUMN_LIST_HEADER\fP describes about content of each
+\fBCOLUMN_INFORMATION\fP\&.
 .sp
-\fBname\fP
+\fBCOLUMN_LIST_HEADER\fP is the following format:
 .INDENT 0.0
 .INDENT 3.5
-カラム名
+.sp
+.nf
+.ft C
+[
+  ["id",     "UInt32"],
+  ["name",   "ShortText"],
+  ["path",   "ShortText"],
+  ["type",   "ShortText"],
+  ["flags",  "ShortText"],
+  ["domain", "ShortText"],
+  ["range",  "ShortText"],
+  ["source", "ShortText"]
+]
+.ft P
+.fi
 .UNINDENT
 .UNINDENT
 .sp
-\fBpath\fP
+It means the following:
 .INDENT 0.0
 .INDENT 3.5
-カラム値を格納するファイル名
+.INDENT 0.0
+.IP \(bu 2
+The first content in \fBCOLUMN_INFORMATION\fP is \fBid\fP value and
+the value type is \fBUInt32\fP\&.
+.IP \(bu 2
+The second content in \fBCOLUMN_INFORMATION\fP is \fBname\fP value and
+the value type is \fBShortText\fP\&.
+.IP \(bu 2
+The third content ....
+.UNINDENT
 .UNINDENT
 .UNINDENT
 .sp
-\fBtype\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
+.sp
+.nf
+.ft C
+[
+  ID,
+  NAME,
+  PATH,
+  TYPE,
+  FLAGS,
+  DOMAIN,
+  RANGE,
+  SOURCES
+]
+.ft P
+.fi
 .UNINDENT
 .UNINDENT
 .sp
-\fBflags\fP
+\fBID\fP
 .INDENT 0.0
 .INDENT 3.5
-カラムのflags属性
+The column ID in the Groonga database. Normally, you don\(aqt care
+about it.
 .UNINDENT
 .UNINDENT
 .sp
-\fBdomain\fP
+\fBNAME\fP
 .INDENT 0.0
 .INDENT 3.5
-カラムの値の属する型
+The column name.
 .UNINDENT
 .UNINDENT
 .sp
-\fBrange\fP
+\fBPATH\fP
 .INDENT 0.0
 .INDENT 3.5
-テーブルのkeyの型
+The path for storing column data.
 .UNINDENT
 .UNINDENT
 .sp
-\fBsource\fP
+\fBTYPE\fP
 .INDENT 0.0
 .INDENT 3.5
-インデックスカラムのとき、インデックス対象カラム名の配列
+The type of the column. It is one of the followings:
+.TS
+center;
+|l|l|.
+_
+T{
+Value
+T}	T{
+Description
+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{
+The column is an index column.
+T}
+_
+.TE
 .UNINDENT
 .UNINDENT
+.sp
+\fBFLAGS\fP
+.INDENT 0.0
+.INDENT 3.5
+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
+Here is the available flags:
+.TS
+center;
+|l|l|.
+_
+T{
+Flag
+T}	T{
+Description
+T}
+_
+T{
+\fBCOLUMN_SCALAR\fP
+T}	T{
+The column is a scalar column.
+T}
+_
+T{
+\fBCOLUMN_VECTOR\fP
+T}	T{
+The column is a vector column.
+T}
+_
+T{
+\fBCOLUMN_INDEX\fP
+T}	T{
+The column is an index column.
+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
+Multiple column index has it.
+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
+Full text search index must has it.
+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
-\fBカラム情報型n\fP
+\fBDOMAIN\fP
 .INDENT 0.0
 .INDENT 3.5
-カラム情報の型を出力します。
+The name of table that has the column.
 .UNINDENT
 .UNINDENT
 .sp
-\fBカラム情報n\fP
+\fBRANGE\fP
 .INDENT 0.0
 .INDENT 3.5
-\fBカラム情報名n\fP で示された情報の配列を出力します。
-情報の順序は \fBカラム情報名n\fP の順序と同じです。
+The value type name of the column. It is a type name or a table
+name.
 .UNINDENT
 .UNINDENT
-.SS 例
+.sp
+\fBSOURCES\fP
 .INDENT 0.0
 .INDENT 3.5
+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
-.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
+It is always an empty array for \fBCOLUMN_SCALAR\fP and
+\fBCOLUMN_VECTOR\fP\&.
+.UNINDENT
 .UNINDENT
 .UNINDENT
-.sp
-注: 実際は改行が入りません。
+.UNINDENT
+.SS See also
+.INDENT 0.0
+.IP \(bu 2
+\fB/reference/commands/column_create\fP
+.IP \(bu 2
+\fB/reference/column\fP
+.UNINDENT
 .SS column_remove
 .SS 名前
 .sp
@@ -14823,6 +14939,108 @@ _
 .IP \(bu 2
 \fB/reference/normalizers\fP
 .UNINDENT
+.SS \fBnormalizer_list\fP
+.SS Summary
+.sp
+\fBnormalizer_list\fP command lists normalizers in a database.
+.SS Syntax
+.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 Usage
+.sp
+Here is a simple example.
+.sp
+Execution example:
+.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 Return value
+.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
+See \fB/reference/command/output_format\fP about \fBHEADER\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{
+Name
+T}	T{
+Description
+T}
+_
+T{
+\fBname\fP
+T}	T{
+Normalizer name.
+T}
+_
+.TE
+.UNINDENT
+.UNINDENT
+.SS See also
+.INDENT 0.0
+.IP \(bu 2
+\fB/reference/normalizers\fP
+.IP \(bu 2
+\fB/reference/commands/normalize\fP
+.UNINDENT
 .SS quit
 .SS 名前
 .sp
@@ -15120,7 +15338,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]
@@ -16991,7 +17209,7 @@ The \fBselect\fP command just outputs \fB_id\fP and \fB_key\fP column
 values.
 .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
 Here is a \fB*\fP usage example.
 .sp
@@ -17671,6 +17889,74 @@ You can omit \fBFACTOR\fP\&. If you omit \fBFACTOR\fP, it is treated as 1.
 .sp
 Here is a sample \fBadjuster\fP usage example that omits \fBFACTOR\fP:
 .sp
+Execution example:
+.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
 The \fBadjuster\fP in the \fBselect\fP command doesn\(aqt have \fBFACTOR\fP\&. So
 the factor is treated as 1. There is only one record that has
 \fB"groonga"\fP in \fBEntries.content\fP column. So the record that its
@@ -19838,21 +20124,142 @@ Description
 T}
 _
 T{
-\fBNONE\fP
+\fBNONE\fP
+T}	T{
+Just ignored.
+T}
+_
+T{
+\fBENABLE_TOKENIZED_DELIMITER\fP
+T}	T{
+Enables tokenized delimiter. See \fB/reference/tokenizers\fP about
+tokenized delimiter details.
+T}
+_
+.TE
+.sp
+Here is an example that uses \fBENABLE_TOKENIZED_DELIMITER\fP\&.
+.sp
+Execution example:
+.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 tokenizer is one of tokenized delimiter supported
+tokenizer. \fBENABLE_TOKENIZED_DELIMITER\fP enables tokenized delimiter.
+Tokenized delimiter is special character that indicates token
+border. It is \fBU+FFFE\fP\&. The character is not assigned any
+character. It means that the character is not appeared in normal
+string. So the character is good character for this puropose. If
+\fBENABLE_TOKENIZED_DELIMITER\fP is enabled, the target string is
+treated as already tokenized string. Tokenizer just tokenizes by
+tokenized delimiter.
+.SS Return value
+.sp
+\fBtokenize\fP command returns tokenized tokens. Each token has some
+attributes except token itself. The attributes will be increased in
+the feature:
+.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
+See \fB/reference/command/output_format\fP about \fBHEADER\fP\&.
+.UNINDENT
+.UNINDENT
+.sp
+\fBtokens\fP
+.INDENT 0.0
+.INDENT 3.5
+\fBtokens\fP is an array of token. Token is an object that has the following
+attributes.
+.TS
+center;
+|l|l|.
+_
+T{
+Name
+T}	T{
+Description
+T}
+_
+T{
+\fBvalue\fP
 T}	T{
-Just ignored.
+Token itself.
 T}
 _
 T{
-\fBENABLE_TOKENIZED_DELIMITER\fP
+\fBposition\fP
 T}	T{
-Enables tokenized delimiter. See \fB/reference/tokenizers\fP about
-tokenized delimiter details.
+The N\-th token.
 T}
 _
 .TE
+.UNINDENT
+.UNINDENT
+.SS See also
+.INDENT 0.0
+.IP \(bu 2
+\fB/reference/tokenizers\fP
+.UNINDENT
+.SS \fBtokenizer_list\fP
+.SS Summary
 .sp
-Here is an example that uses \fBENABLE_TOKENIZED_DELIMITER\fP\&.
+\fBtokenizer_list\fP command lists tokenizers in a database.
+.SS Syntax
+.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 Usage
+.sp
+Here is a simple example.
 .sp
 Execution example:
 .INDENT 0.0
@@ -19860,25 +20267,52 @@ Execution example:
 .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"
 #     }
 #   ]
 # ]
@@ -19887,26 +20321,17 @@ tokenize TokenDelimit "Full
 .UNINDENT
 .UNINDENT
 .sp
-\fBTokenDelimit\fP tokenizer is one of tokenized delimiter supported
-tokenizer. \fBENABLE_TOKENIZED_DELIMITER\fP enables tokenized delimiter.
-Tokenized delimiter is special character that indicates token
-border. It is \fBU+FFFE\fP\&. The character is not assigned any
-character. It means that the character is not appeared in normal
-string. So the character is good character for this puropose. If
-\fBENABLE_TOKENIZED_DELIMITER\fP is enabled, the target string is
-treated as already tokenized string. Tokenizer just tokenizes by
-tokenized delimiter.
+It returns tokenizers in a database.
 .SS Return value
 .sp
-\fBtokenize\fP command returns tokenized tokens. Each token has some
-attributes except token itself. The attributes will be increased in
-the feature:
+\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
@@ -19919,10 +20344,10 @@ See \fB/reference/command/output_format\fP about \fBHEADER\fP\&.
 .UNINDENT
 .UNINDENT
 .sp
-\fBtokens\fP
+\fBtokenizer\fP
 .INDENT 0.0
 .INDENT 3.5
-\fBtokens\fP is an array of token. Token is an object that has the following
+\fBtokenizer\fP is an array of tokenizer. Tokenizer is an object that has the following
 attributes.
 .TS
 center;
@@ -19935,15 +20360,9 @@ Description
 T}
 _
 T{
-\fBvalue\fP
-T}	T{
-Token itself.
-T}
-_
-T{
-\fBposition\fP
+\fBname\fP
 T}	T{
-The N\-th token.
+Tokenizer name.
 T}
 _
 .TE
@@ -19953,6 +20372,8 @@ _
 .INDENT 0.0
 .IP \(bu 2
 \fB/reference/tokenizers\fP
+.IP \(bu 2
+\fB/reference/commands/tokenize\fP
 .UNINDENT
 .SS \fBtruncate\fP
 .SS Summary
@@ -20547,6 +20968,8 @@ Here are data store columns:
 \fBcolumns/scalar\fP
 .IP \(bu 2
 \fBcolumns/vector\fP
+.IP \(bu 2
+\fBcolumns/pseudo\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -21087,52 +21510,6 @@ loaded only at the plugin load time.
 .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 is an object that searches records with specified conditions
@@ -21285,11 +21662,14 @@ in ASCII and \fB[backslash]\fP with \fB\e\e\fP\&.)
 .UNINDENT
 .UNINDENT
 .sp
-You can use quote instead of escape. Quote syntax is \fB"..."\fP or
-\fB\(aq...\(aq\fP\&. You need escape \fB"\fP as \fB\e"\fP in \fB"..."\fP quote syntax.
-You need escape \fB\(aq\fP as \fB\e\(aq\fP in \fB\(aq...\(aq\fP quote syntax. For
-example, \fBAlice\(aqs brother (Bob)\fP can be quoted \fB"Alice\(aqs brother
-(Bob)"\fP or \fB\(aqAlice\e\(aqs brother (Bob)\(aq\fP\&.
+You can use quote instead of escape special characters except \fB\e\fP
+(backslash). You need to use backslash for escaping backslash like
+\fB\e\e\fP in quote.
+.sp
+Quote syntax is \fB"..."\fP or \fB\(aq...\(aq\fP\&. You need escape \fB"\fP as
+\fB\e"\fP in \fB"..."\fP quote syntax.  You need escape \fB\(aq\fP as \fB\e\(aq\fP in
+\fB\(aq...\(aq\fP quote syntax. For example, \fBAlice\(aqs brother (Bob)\fP can be
+quoted \fB"Alice\(aqs brother (Bob)"\fP or \fB\(aqAlice\e\(aqs brother (Bob)\(aq\fP\&.
 .sp
 \fBNOTE:\fP
 .INDENT 0.0
@@ -28423,7 +28803,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:
@@ -28451,7 +28831,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:
@@ -28479,7 +28859,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:
@@ -28507,7 +28887,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:
@@ -28535,7 +28915,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:
@@ -29737,7 +30117,7 @@ objのIDに対応するレコードの値を更新します。対応するレコ
 .IP \(bu 2
 \fBflags\fP \-\- 
 .sp
-以下のいずれかの形式が使用できます。
+以下の値を指定できます。
 .INDENT 2.0
 .INDENT 2.0
 .IP \(bu 2
@@ -30789,6 +31169,25 @@ objectに登録できるユーザデータへのポインタを返します。ta
 .UNINDENT
 .UNINDENT
 .UNINDENT
+.SS Plugin
+.SS Summary
+.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 Reference
+.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 SPECIFICATION
 .SS GQTP
 .sp
@@ -31689,7 +32088,7 @@ Add the following \fBbefore_install\fP configuration to \fB\&.travis.yml\fP:
 .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
@@ -31778,13 +32177,111 @@ Please send a mail that describes a bug.
 .SS How to contribute in documentation topics
 .sp
 We use \fI\%Sphinx\fP for documentation tool.
-.SS C API
+.SS Introduction
 .sp
-We still have C API documentation in include/groonga.h. But
-we want to move them into doc/source/c\-api/*.txt. We welcome
-to you help us by moving C API documentation.
+This documentation describes about how to write, generate and manage
+Groonga documentation.
+.SS Install depended softwares
 .sp
-We will use \fI\%the C domain markup\fP of Sphinx.
+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 Generate 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 I18N
 .sp
 We only had documentation in Japanese.  We start to support
@@ -32057,7 +32554,14 @@ as \(aqja\(aq.
 \fI\%Codes for the Representation of Names of Languages\fP\&.
 .UNINDENT
 .UNINDENT
-.SS groonga開発者向け情報
+.SS C API
+.sp
+We still have C API documentation in include/groonga.h. But
+we want to move them into doc/source/c\-api/*.txt. We welcome
+to you help us by moving C API documentation.
+.sp
+We will use \fI\%the C domain markup\fP of Sphinx.
+.SS Groonga開発者向け情報
 .SS Repository
 .sp
 There is \fI\%the repository of groonga on GitHub\fP\&. If you want to check\-out groonga, type the below command:
@@ -32173,66 +32677,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
-This document is also ditributed in forms of release source archive and updated time to time.
-If you want to refer latest documentation in source form, you can view such files via GitHub repository browser (\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は複数の手段を用意しています。