rroonga 4.0.4-x86-mingw32 → 4.0.5-x86-mingw32

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

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "GROONGA" "1" "August 28, 2014" "4.0.5" "Groonga"
+.TH "GROONGA" "1" "September 28, 2014" "4.0.6" "Groonga"
 .SH NAME
 groonga \- Groonga documentation
 .
@@ -110,7 +110,7 @@ packages.groonga.org:
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.5\-x86.exe\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.6\-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.5\-x64.exe\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.6\-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.5\-x86.zip\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.6\-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.5\-x64.zip\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.6\-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.5.zip\fP
+\fI\%http://packages.groonga.org/source/groonga/groonga\-4.0.6.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.5
+> cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-4.0.6
 .ft P
 .fi
 .UNINDENT
@@ -208,7 +208,7 @@ parameter instead:
 .sp
 .nf
 .ft C
-groonga\-4.0.5> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\egroonga
+groonga\-4.0.6> 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.5> cmake \-\-build . \-\-config Release
+groonga\-4.0.6> cmake \-\-build . \-\-config Release
 .ft P
 .fi
 .UNINDENT
@@ -232,7 +232,7 @@ Install:
 .sp
 .nf
 .ft C
-groonga\-4.0.5> cmake \-\-build . \-\-config Release \-\-target Install
+groonga\-4.0.6> cmake \-\-build . \-\-config Release \-\-target Install
 .ft P
 .fi
 .UNINDENT
@@ -293,9 +293,9 @@ Download source:
 .sp
 .nf
 .ft C
-% curl \-O http://packages.groonga.org/source/groonga/groonga\-4.0.5.tar.gz
-% tar xvzf groonga\-4.0.5.tar.gz
-% cd groonga\-4.0.5
+% curl \-O http://packages.groonga.org/source/groonga/groonga\-4.0.6.tar.gz
+% tar xvzf groonga\-4.0.6.tar.gz
+% cd groonga\-4.0.6
 .ft P
 .fi
 .UNINDENT
@@ -444,116 +444,119 @@ Install groonga\-normalizer\-mysql package:
 .fi
 .UNINDENT
 .UNINDENT
-.SS jessie
-.sp
-Add the groonga apt repository.
+.SS Build from source
 .sp
-/etc/apt/sources.list.d/groonga.list:
+Install required packages to build Groonga:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-deb http://packages.groonga.org/debian/ jessie main
-deb\-src http://packages.groonga.org/debian/ jessie main
+% 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
 .UNINDENT
 .sp
-Install:
+Download source:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% sudo apt\-get update
-% sudo apt\-get install \-y \-\-allow\-unauthenticated groonga\-keyring
-% sudo apt\-get update
-% sudo apt\-get install \-y groonga
+% wget http://packages.groonga.org/source/groonga/groonga\-4.0.6.tar.gz
+% tar xvzf groonga\-4.0.6.tar.gz
+% cd groonga\-4.0.6
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-\fBNOTE:\fP
+Configure (see \fIsource\-configure\fP about \fBconfigure\fP options):
 .INDENT 0.0
 .INDENT 3.5
-\fBgroonga\fP package is the minimum set of fulltext search engine.
-If you want to use Groonga for server use, you can install
-additional preconfigured packages.
-.sp
-There are three packages for server use.
-.INDENT 0.0
-.IP \(bu 2
-groonga\-server\-http (simple HTTP protocol based server package)
-.IP \(bu 2
-groonga\-httpd (nginx and HTTP protocol based server package)
-.IP \(bu 2
-groonga\-server\-gqtp (GQTP protocol based server package)
-.UNINDENT
 .sp
-See \fB/server\fP section about details.
+.nf
+.ft C
+% ./configure
+.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:
+Build:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% sudo apt\-get install \-y \-V groonga\-tokenizer\-mecab
+% make \-j$(grep \(aq^processor\(aq /proc/cpuinfo | wc \-l)
 .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:
+Install:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% sudo apt\-get install \-y \-V groonga\-munin\-plugins
+% sudo make install
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
+.SS Ubuntu
 .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.
+This section describes how to install Groonga related deb packages on
+Ubuntu. You can install them by \fBapt\fP\&.
 .sp
-Install groonga\-normalizer\-mysql package:
+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.
+.SS PPA (Personal Package Archive)
+.sp
+The Groonga APT repository for Ubuntu uses PPA (Personal Package
+Archive) on Launchpad. You can install Groonga by APT from the PPA.
+.sp
+Here are supported Ubuntu versions:
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.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
+Enable the universe repository to install Groonga:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% sudo apt\-get install \-y \-V groonga\-normalizer\-mysql
+% sudo apt\-get \-y install software\-properties\-common
+% sudo add\-apt\-repository \-y universe
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
-.SS sid
-.sp
-Add the groonga apt repository.
 .sp
-/etc/apt/sources.list.d/groonga.list:
+Add the \fBppa:groonga/ppa\fP PPA to your system:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-deb http://packages.groonga.org/debian/ unstable main
-deb\-src http://packages.groonga.org/debian/ unstable main
+% sudo add\-apt\-repository \-y ppa:groonga/ppa
+% sudo apt\-get update
 .ft P
 .fi
 .UNINDENT
@@ -565,10 +568,7 @@ Install:
 .sp
 .nf
 .ft C
-% sudo apt\-get update
-% sudo apt\-get install \-y \-\-allow\-unauthenticated groonga\-keyring
-% sudo apt\-get update
-% sudo apt\-get install \-y \-V groonga
+% sudo apt\-get \-y install groonga
 .ft P
 .fi
 .UNINDENT
@@ -604,7 +604,7 @@ Install groonga\-tokenizer\-mecab package:
 .sp
 .nf
 .ft C
-% sudo apt\-get install \-y \-V groonga\-tokenizer\-mecab
+% sudo apt\-get \-y install groonga\-tokenizer\-mecab
 .ft P
 .fi
 .UNINDENT
@@ -619,14 +619,14 @@ Install groonga\-munin\-plugins package:
 .sp
 .nf
 .ft C
-% sudo apt\-get install \-y \-V groonga\-munin\-plugins
+% 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.
+Groonga plugins.
 If you want to use that one, install groonga\-normalizer\-mysql package.
 .sp
 Install groonga\-normalizer\-mysql package:
@@ -635,7 +635,7 @@ Install groonga\-normalizer\-mysql package:
 .sp
 .nf
 .ft C
-% sudo apt\-get install \-y \-V groonga\-normalizer\-mysql
+% sudo apt\-get \-y install groonga\-normalizer\-mysql
 .ft P
 .fi
 .UNINDENT
@@ -648,7 +648,7 @@ Install required packages to build Groonga:
 .sp
 .nf
 .ft C
-% sudo apt\-get install \-y \-V  wget tar build\-essential zlib1g\-dev liblzo2\-dev libmsgpack\-dev libzmq\-dev libevent\-dev libmecab\-dev
+% sudo apt\-get \-V \-y install wget tar build\-essential zlib1g\-dev liblzo2\-dev libmsgpack\-dev libzmq\-dev libevent\-dev libmecab\-dev
 .ft P
 .fi
 .UNINDENT
@@ -660,9 +660,9 @@ Download source:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-4.0.5.tar.gz
-% tar xvzf groonga\-4.0.5.tar.gz
-% cd groonga\-4.0.5
+% wget http://packages.groonga.org/source/groonga/groonga\-4.0.6.tar.gz
+% tar xvzf groonga\-4.0.6.tar.gz
+% cd groonga\-4.0.6
 .ft P
 .fi
 .UNINDENT
@@ -703,60 +703,17 @@ Install:
 .fi
 .UNINDENT
 .UNINDENT
-.SS Ubuntu
+.SS CentOS
 .sp
-This section describes how to install Groonga related deb packages on
-Ubuntu. You can install them by \fBapt\fP\&.
+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
 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.
-.SS PPA (Personal Package Archive)
-.sp
-The Groonga APT repository for Ubuntu uses PPA (Personal Package
-Archive) on Launchpad. You can install Groonga by APT from the PPA.
-.sp
-Here are supported Ubuntu versions:
-.INDENT 0.0
-.INDENT 3.5
-.INDENT 0.0
-.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
-Enable the universe repository to install Groonga:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo apt\-get \-y install software\-properties\-common
-% sudo add\-apt\-repository \-y universe
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-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
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
+.SS CentOS 5
 .sp
 Install:
 .INDENT 0.0
@@ -764,7 +721,9 @@ Install:
 .sp
 .nf
 .ft C
-% sudo apt\-get \-y install groonga
+% sudo rpm \-ivh http://packages.groonga.org/centos/groonga\-release\-1.1.0\-1.noarch.rpm
+% sudo yum makecache
+% sudo yum install \-y groonga
 .ft P
 .fi
 .UNINDENT
@@ -800,116 +759,93 @@ Install groonga\-tokenizer\-mecab package:
 .sp
 .nf
 .ft C
-% sudo apt\-get \-y install groonga\-tokenizer\-mecab
+% sudo yum install \-y 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.
+Groonga status by Munin, install groonga\-munin\-plugins package.
 .sp
-Install groonga\-munin\-plugins package:
+\fBNOTE:\fP
 .INDENT 0.0
 .INDENT 3.5
+Groonga\-munin\-plugins package requires munin\-node package that
+isn\(aqt included in the official CentOS repository. You need to
+enable \fI\%Repoforge (RPMforge)\fP repository
+or \fI\%EPEL\fP repository to
+install it by \fByum\fP\&.
 .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:
+Enable Repoforge (RPMforge) repository on i386 environment:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% sudo apt\-get \-y install groonga\-normalizer\-mysql
+% wget http://pkgs.repoforge.org/rpmforge\-release/rpmforge\-release\-0.5.3\-1.el5.rf.i386.rpm
+% sudo rpm \-ivh rpmforge\-release\-0.5.2\-2.el5.rf.i386.rpm
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
-.SS Build from source
 .sp
-Install required packages to build Groonga:
+Enable Repoforge (RPMforge) repository on x86_64 environment:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% sudo apt\-get \-V \-y install wget tar build\-essential zlib1g\-dev liblzo2\-dev libmsgpack\-dev libzmq\-dev libevent\-dev libmecab\-dev
+% wget http://pkgs.repoforge.org/rpmforge\-release/rpmforge\-release\-0.5.3\-1.el5.rf.x86_64.rpm
+% sudo rpm \-ivh rpmforge\-release\-0.5.2\-2.el5.rf.x86_64.rpm
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-Download source:
+Enable EPEL repository on any environment:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-4.0.5.tar.gz
-% tar xvzf groonga\-4.0.5.tar.gz
-% cd groonga\-4.0.5
+% wget http://download.fedoraproject.org/pub/epel/5/i386/epel\-release\-5\-4.noarch.rpm
+% sudo rpm \-ivh epel\-release\-5\-4.noarch.rpm
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
-.sp
-Configure (see \fIsource\-configure\fP about \fBconfigure\fP options):
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% ./configure
-.ft P
-.fi
 .UNINDENT
 .UNINDENT
 .sp
-Build:
+Install groonga\-munin\-plugins package:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% make \-j$(grep \(aq^processor\(aq /proc/cpuinfo | wc \-l)
+% sudo yum install \-y groonga\-munin\-plugins
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-Install:
+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 make install
+% sudo yum install \-y groonga\-normalizer\-mysql
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
-.SS CentOS
-.sp
-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
-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.
-.SS CentOS 5
+.SS CentOS 6
 .sp
 Install:
 .INDENT 0.0
@@ -969,44 +905,16 @@ Groonga status by Munin, install groonga\-munin\-plugins package.
 .INDENT 3.5
 Groonga\-munin\-plugins package requires munin\-node package that
 isn\(aqt included in the official CentOS repository. You need to
-enable \fI\%Repoforge (RPMforge)\fP repository
-or \fI\%EPEL\fP repository to
+enable \fI\%EPEL\fP repository to
 install it by \fByum\fP\&.
 .sp
-Enable Repoforge (RPMforge) repository on i386 environment:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% wget http://pkgs.repoforge.org/rpmforge\-release/rpmforge\-release\-0.5.3\-1.el5.rf.i386.rpm
-% sudo rpm \-ivh rpmforge\-release\-0.5.2\-2.el5.rf.i386.rpm
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-Enable Repoforge (RPMforge) repository on x86_64 environment:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% wget http://pkgs.repoforge.org/rpmforge\-release/rpmforge\-release\-0.5.3\-1.el5.rf.x86_64.rpm
-% sudo rpm \-ivh rpmforge\-release\-0.5.2\-2.el5.rf.x86_64.rpm
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
 Enable EPEL repository on any environment:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% wget http://download.fedoraproject.org/pub/epel/5/i386/epel\-release\-5\-4.noarch.rpm
-% sudo rpm \-ivh epel\-release\-5\-4.noarch.rpm
+% sudo rpm \-ivh http://download.fedoraproject.org/pub/epel/6/i386/epel\-release\-6\-8.noarch.rpm
 .ft P
 .fi
 .UNINDENT
@@ -1041,7 +949,7 @@ Install groonga\-normalizer\-mysql package:
 .fi
 .UNINDENT
 .UNINDENT
-.SS CentOS 6
+.SS CentOS 7
 .sp
 Install:
 .INDENT 0.0
@@ -1104,13 +1012,13 @@ isn\(aqt included in the official CentOS repository. You need to
 enable \fI\%EPEL\fP repository to
 install it by \fByum\fP\&.
 .sp
-Enable EPEL repository on any environment:
+Enable EPEL repository:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% sudo rpm \-ivh http://download.fedoraproject.org/pub/epel/6/i386/epel\-release\-6\-8.noarch.rpm
+% sudo yum install \-y epel\-release
 .ft P
 .fi
 .UNINDENT
@@ -1165,9 +1073,9 @@ Download source:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-4.0.5.tar.gz
-% tar xvzf groonga\-4.0.5.tar.gz
-% cd groonga\-4.0.5
+% wget http://packages.groonga.org/source/groonga/groonga\-4.0.6.tar.gz
+% tar xvzf groonga\-4.0.6.tar.gz
+% cd groonga\-4.0.6
 .ft P
 .fi
 .UNINDENT
@@ -1370,9 +1278,9 @@ Download source:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-4.0.5.tar.gz
-% tar xvzf groonga\-4.0.5.tar.gz
-% cd groonga\-4.0.5
+% wget http://packages.groonga.org/source/groonga/groonga\-4.0.6.tar.gz
+% tar xvzf groonga\-4.0.6.tar.gz
+% cd groonga\-4.0.6
 .ft P
 .fi
 .UNINDENT
@@ -1437,9 +1345,9 @@ Download source:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-4.0.5.tar.gz
-% gtar xvzf groonga\-4.0.5.tar.gz
-% cd groonga\-4.0.5
+% wget http://packages.groonga.org/source/groonga/groonga\-4.0.6.tar.gz
+% gtar xvzf groonga\-4.0.6.tar.gz
+% cd groonga\-4.0.6
 .ft P
 .fi
 .UNINDENT
@@ -1579,9 +1487,9 @@ steps:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-4.0.5.tar.gz
-% tar xvzf groonga\-4.0.5.tar.gz
-% cd groonga\-4.0.5
+% wget http://packages.groonga.org/source/groonga/groonga\-4.0.6.tar.gz
+% tar xvzf groonga\-4.0.6.tar.gz
+% cd groonga\-4.0.6
 % ./configure
 % make
 % sudo make install
@@ -3991,7 +3899,7 @@ Execution example:
 .sp
 .nf
 .ft C
-select \-\-table Site \-\-filter "1" \-\-scorer "_score = rand()" \-\-output_columns _id,_key,_score \-\-sortby _score
+select \-\-table Site \-\-filter "true" \-\-scorer "_score = rand()" \-\-output_columns _id,_key,_score \-\-sortby _score
 # [
 #   [
 #     0,
@@ -4065,7 +3973,7 @@ select \-\-table Site \-\-filter "1" \-\-scorer "_score = rand()" \-\-output_col
 #     ]
 #   ]
 # ]
-select \-\-table Site \-\-filter "1" \-\-scorer "_score = rand()" \-\-output_columns _id,_key,_score \-\-sortby _score
+select \-\-table Site \-\-filter "true" \-\-scorer "_score = rand()" \-\-output_columns _id,_key,_score \-\-sortby _score
 # [
 #   [
 #     0,
@@ -5021,7 +4929,7 @@ select \-\-table Site \-\-limit 0 \-\-drilldown country \-\-drilldown_sortby _ns
 .UNINDENT
 .SS limits drildown results
 .sp
-The number of drilldown results is limited to 10 as a default. Use \fBdrilldown_limits\fP and \fBdrilldown_offset\fP parameter to customize orilldown results.
+The number of drilldown results is limited to 10 as a default. Use \fBdrilldown_limit\fP and \fBdrilldown_offset\fP parameter to customize orilldown results.
 .sp
 Execution example:
 .INDENT 0.0
@@ -6520,17 +6428,19 @@ select \-\-table PatSuffix \-\-filter \(aq_key @$ "ゆき" && original == true\(
 .fi
 .UNINDENT
 .UNINDENT
-.SS 全文検索の語彙表に対する追加情報
+.SS Additional information about lexicon for full text search
 .sp
-Groongaでは、全文検索に用いるための語意表がテーブルとして扱えます。よって、語彙ごとに複数の情報を保持することができます。例えば、語彙の出現数や検索ストップワードのフラグ、単語の重要度などを保持することができます。
+Groonga uses lexicon for full text search as a table. Thus, Groonga can hold multiple information each lexicon.
+For example, Groonga holds frequency of word, flags for stop word, importance of word and so on.
 .sp
-この項目については、現在執筆中です。
-.SS マイクロブログ検索システムの作成
+TODO: Write document.
+.SS Let\(aqs create micro\-blog
 .sp
-これまで学んだGroongaの機能を用いて、マイクロブログの検索システムを作成してみましょう。マイクロブログとは、Twitterのような短いメッセージを投稿するブログです。
-.SS テーブルの作成
+Let\(aqs create micro\-blog with full text search by Groonga.
+Micro\-blog is one of the broadcast medium in the forms of blog. It is mainly used to post small messages like a Twitter.
+.SS Create a table
 .sp
-まずは、テーブルを作成します。
+Let\(aqs create table.
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -6570,95 +6480,97 @@ column_create \-\-table GeoIndex \-\-name comments_location \-\-type Comments \-
 .fi
 .UNINDENT
 .UNINDENT
-.SS Usersテーブル
+.SS Users table
 .sp
-ユーザーの名前や自己紹介文、フォローしているユーザー一覧など、ユーザー情報を格納するためのテーブルです。
+This is the table which stores user information.
+It stores name of user, profile, list of follower and so on.
 .INDENT 0.0
 .TP
 .B \fB_key\fP
-ユーザーID
+User ID
 .TP
 .B \fBname\fP
-ユーザー名
+User name
 .TP
 .B \fBfollower\fP
-フォローしているユーザーの一覧
+List of following users
 .TP
 .B \fBfavorites\fP
-お気に入りのコメント一覧
+List of favorite comments
 .TP
 .B \fBlocation\fP
-ユーザーの現在地（緯度経度座標）
+Current location of user (geolocation)
 .TP
 .B \fBlocation_str\fP
-ユーザーの現在地（文字列）
+Current location of user (string)
 .TP
 .B \fBdescription\fP
-ユーザーの自己紹介
+User profile
 .TP
 .B \fBfollowee\fP
-Usersテーブルのfollowerカラムに対するインデックス。
-このインデックスを作ることで、あるユーザーをフォローしているユーザーを検索できるようになります。
+Indexes for \fBfollower\fP column in \fBUsers\fP table.
+With this indexes, you can search users who follows the person.
 .UNINDENT
-.SS Commentsテーブル
+.SS Comments table
 .sp
-コメント内容や投稿日時、返信先情報など、コメントに関する内容を格納するテーブルです。
+This is the table which stores comments and its metadata.
+It stores content of comment, posted date, comment which reply to, and so on.
 .INDENT 0.0
 .TP
 .B \fB_key\fP
-コメントID
+Comment ID
 .TP
 .B \fBcomment\fP
-コメント内容
+Content of comment
 .TP
 .B \fBlast_modified\fP
-投稿日時
+Posted date
 .TP
 .B \fBreplied_to\fP
-返信元のコメント内容
+Comment which you reply to someone
 .TP
 .B \fBreplied_users\fP
-返信先のユーザーの一覧
+List of users who you reply to
 .TP
 .B \fBhash_tags\fP
-コメントのハッシュタグの一覧
+List of hash tags about comment
 .TP
 .B \fBlocation\fP
-投稿場所(緯度経度座標のため)
+Posted place (for geolocation)
 .TP
 .B \fBposted_by\fP
-コメントを書いたユーザー
+Person who write comment
 .TP
 .B \fBfavorited_by\fP
-Usersテーブルのfavoritesカラムに対するインデックス。
-このインデックスを作ることで、指定したコメントを誰がお気に入りに入れているのかを検索できるようになります。
+Indexes for \fBfavorites\fP column in \fBUsers\fP table.
+With this indexes, you can search the person who mark comment as favorite one.
 .UNINDENT
-.SS HashTagsテーブル
+.SS HashTags table
 .sp
-コメントのハッシュタグを一覧で保存するためのテーブルです。
+This is the table which stores hash tags for comments.
 .INDENT 0.0
 .TP
 .B \fB_key\fP
-ハッシュタグ
+Hash tag
 .TP
 .B \fBhash_index\fP
-「Comments.hash_tags」のインデックス。
-このインデックスを作ることで、指定したハッシュタグのついているコメントの一覧を出すことが出来るようになります。
+Indexes for \fBComments.hash_tags\fP\&.
+With this indexes, you can search list of comments with specified hash tags.
 .UNINDENT
-.SS Bigramテーブル
+.SS Bigram table
 .sp
-ユーザー情報・コメントで全文検索が出来るようにするためのインデックスを格納するテーブルです。
+This is the table which stores indexes for full text search by user information or comments.
 .INDENT 0.0
 .TP
 .B \fB_key\fP
-単語
+Word
 .TP
 .B \fBusers_index\fP
-ユーザー情報のインデックス。
-このカラムは、ユーザー名「Users.name」、現在地「Users.location_str」、自己紹介文「Users.description」のインデックスになっています。
+Indexes of user information.
+This column contains indexes of user name (\fBUsers.name\fP), current location (\fBUsers.location_str\fP), profile (\fBUsers.description\fP).
 .TP
 .B \fBcomment_index\fP
-コメント内容「Comments.comment」のインデックス
+Indexes about content of comments (\fBComments.comment\fP).
 .UNINDENT
 .SS GeoIndex table
 .sp
@@ -6671,9 +6583,9 @@ Indexes of location column for Users table
 .B \fBcomments_location\fP
 Indexes of location column for Comments table
 .UNINDENT
-.SS データのロード
+.SS Loading data
 .sp
-つづいて、テスト用データをロードします。
+Then, load example data.
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -6682,94 +6594,94 @@ Indexes of location column for Comments table
 load \-\-table Users
 [
   {
-    "_key": "daijiro",
-    "name": "hsiomaneki",
-    "follower": ["tasukuchan"],
+    "_key": "alice",
+    "name": "Alice",
+    "follower": ["bob"],
     "favorites": [],
-    "location": "127678039x502643091",
-    "location_str": "神奈川県",
-    "description": "groonga developer"
+    "location": "152489000x\-255829000",
+    "location_str": "Boston, Massachusetts",
+    "description": "Groonga developer"
   },
   {
-    "_key": "tasukuchan",
-    "name": "グニャラくん",
-    "follower": ["daijiro","OffGao"],
-    "favorites": ["daijiro:1","OffGao:1"],
-    "location": "128423343x502929252",
-    "location_str": "東京都渋谷区",
-    "description": "エロいおっさん"
+    "_key": "bob",
+    "name": "Bob",
+    "follower": ["alice","charlie"],
+    "favorites": ["alice:1","charlie:1"],
+    "location": "146249000x\-266228000",
+    "location_str": "Brooklyn, New York City",
+    "description": ""
   },
   {
-    "_key": "OffGao",
-    "name": "OffGao",
-    "follower": ["tasukuchan","daijiro"],
-    "favorites": ["tasukuchan:1","daijiro:1"],
-    "location": "128544408x502801502",
-    "location_str": "東京都中野区",
-    "description": "がおがお"
+    "_key": "charlie",
+    "name": "Charlie",
+    "follower": ["alice","bob"],
+    "favorites": ["alice:1","bob:1"],
+    "location": "146607190x\-267021260",
+    "location_str": "Newark, New Jersey",
+    "description": "Hmm,Hmm"
   }
 ]
 
 load \-\-table Comments
 [
   {
-    "_key": "daijiro:1",
-    "comment": "マイクロブログ作ってみました（甘栗むいちゃいました的な感じで）。",
+    "_key": "alice:1",
+    "comment": "I\(aqve created micro\-blog!",
     "last_modified": "2010/03/17 12:05:00",
-    "posted_by": "daijiro",
+    "posted_by": "alice",
   },
   {
-    "_key": "tasukuchan:1",
-    "comment": "初の書き込み。テストテスト。",
+    "_key": "bob:1",
+    "comment": "First post. test,test...",
     "last_modified": "2010/03/17 12:00:00",
-    "posted_by": "tasukuchan",
+    "posted_by": "bob",
   },
   {
-    "_key": "daijiro:2",
-    "comment": "@tasukuchan ようこそ!!!",
+    "_key": "alice:2",
+    "comment": "@bob Welcome!!!",
     "last_modified": "2010/03/17 12:05:00",
-    "replied_to": "tasukuchan:1",
-    "replied_users": ["tasukuchan"],
-    "posted_by": "daijiro",
+    "replied_to": "bob:1",
+    "replied_users": ["bob"],
+    "posted_by": "alice",
   },
   {
-    "_key": "tasukuchan:2",
-    "comment": "@daijiro ありがとう！",
+    "_key": "bob:2",
+    "comment": "@alice Thanks!",
     "last_modified": "2010/03/17 13:00:00",
-    "replied_to": "daijiro:2",
-    "replied_users": ["daijiro"],
-    "posted_by": "tasukuchan",
+    "replied_to": "alice:2",
+    "replied_users": ["alice"],
+    "posted_by": "bob",
   },
   {
-    "_key": "tasukuchan:3",
-    "comment": "groongaなう #groonga",
+    "_key": "bob:3",
+    "comment": "I\(aqve just used \(aqTry\-Groonga\(aq now! #groonga",
     "last_modified": "2010/03/17 14:00:00",
     "hash_tags": ["groonga"],
-    "location": "127972422x503117107",
-    "posted_by": "tasukuchan",
+    "location": "146566000x\-266422000",
+    "posted_by": "bob",
   },
   {
-    "_key": "tasukuchan:4",
-    "comment": "groonga開発合宿のため羽田空港に来ました！ #groonga #travel",
+    "_key": "bob:4",
+    "comment": "I\(aqm come at city of New York for development camp! #groonga #travel",
     "last_modified": "2010/03/17 14:05:00",
     "hash_tags": ["groonga", "travel"],
-    "location": "127975798x502919856",
-    "posted_by": "tasukuchan",
+    "location": "146566000x\-266422000",
+    "posted_by": "bob",
   },
   {
-    "_key": "OffGao:1",
-    "comment": "@daijiro @tasukuchan 登録してみましたよー！",
+    "_key": "charlie:1",
+    "comment": "@alice @bob I\(aqve tried to register!",
     "last_modified": "2010/03/17 15:00:00",
-    "replied_users": ["daijiro", "tasukuchan"],
-    "location": "128551935x502796433",
-    "posted_by": "OffGao",
+    "replied_users": ["alice", "bob"],
+    "location": "146607190x\-267021260",
+    "posted_by": "charlie",
   }
   {
-    "_key": "OffGao:2",
-    "comment": "中野ブロードウェイなうなう",
+    "_key": "charlie:2",
+    "comment": "I\(aqm at the Museum of Modern Art in NY now!",
     "last_modified": "2010/03/17 15:05:00",
-    "location": "128551935x502796434",
-    "posted_by": "OffGao",
+    "location": "146741340x\-266319590",
+    "posted_by": "charlie",
   }
 ]
 .ft P
@@ -6777,20 +6689,26 @@ load \-\-table Comments
 .UNINDENT
 .UNINDENT
 .sp
-Usersテーブルのfollowerカラムとfavoritesカラム、そしてCommentsテーブルのreplied_usersカラムは、ベクターカラムです。そのため、これらのカラムは配列で値を指定します。
+\fBfollower\fP column and \fBfavorites\fP column in \fBUsers\fP table and \fBreplied_users\fP column in \fBComments\fP table are vector column, so specify the value as an array.
 .sp
-Usersテーブルのlocationカラムと、Commentsテーブルのlocationカラムは、GeoPoint型です。この型での値の指定は、"[緯度]x[経度]"と記述して指定します。
+\fBlocation\fP column in \fBUsers\fP table, \fBlocation\fP column in \fBComments\fP table use GeoPoint type. This type accepts "[latitude]x[longitude]".
 .sp
-Commentsテーブルのlast_modifiedカラムは、Time型です。この型での値を指定する方法は2つあります。
-1つ目の方法は、1970年1月1日0時0分0秒からの経過秒数の値を直接指定する方法です。このとき、小数部分を指定することでマイクロ秒数での指定が可能です。指定した値は、データのロードの際にマイクロ秒を単位とする整数値に変換後、格納されます。
-2つ目の方法は、文字列で日時と時刻を指定する方法です。"年/月/日 時:分:秒"というフォーマットで記述することで、データロードの際に文字列からキャストされ、マイクロ秒数の値が格納されます。
-.SS 検索
+\fBlast_modified\fP column in \fBComments\fP table use Time type.
+.sp
+There are two way to specify the value.
+First, specify epoch (seconds since Jan, 1, 1970 AM 00:00:00) directly. In this case, you can specify micro seconds as fractional part.
+The value is converted from factional part to the time which is micro seconds based one when data is loaded.
+The second, specify the timestamp as string in following format: "(YEAR)/(MONTH)/(DAY) (HOUR):(MINUTE):(SECOND)". In this way, the string is casted to proper micro seconds
+when data is loaded.
+.SS Search
 .sp
-それでは、実際に検索をしてみましょう。
-.SS キーワードでユーザー検索
+Let\(aqs search micro\-blog.
+.SS Search users by keyword
 .sp
-ここでは、 \fBmatch_columns\fP で扱った、複数カラムを対象とした検索を行います。
-指定された文字列で、ユーザー名・現在地・自己紹介文を対象に検索をします。
+In this section, we search micro\-blog against multiple column by keyword.
+See \fBmatch_columns\fP to search multiple column at once.
+.sp
+Let\(aqs search user from micro\-blog\(aqs user name, location, description entries.
 .sp
 Execution example:
 .INDENT 0.0
@@ -6798,7 +6716,7 @@ Execution example:
 .sp
 .nf
 .ft C
-select \-\-table Users \-\-match_columns name,location_str,description \-\-query 東京 \-\-output_columns _key,name
+select \-\-table Users \-\-match_columns name,location_str,description \-\-query "New York" \-\-output_columns _key,name
 # [[0, 1337566253.89858, 0.000355720520019531], true]
 # [[0, 1337566253.89858, 0.000355720520019531], true]
 # [[0, 1337566253.89858, 0.000355720520019531], true]
@@ -6835,7 +6753,7 @@ select \-\-table Users \-\-match_columns name,location_str,description \-\-query
 #   [
 #     [
 #       [
-#         2
+#         1
 #       ],
 #       [
 #         [
@@ -6848,12 +6766,8 @@ select \-\-table Users \-\-match_columns name,location_str,description \-\-query
 #         ]
 #       ],
 #       [
-#         "tasukuchan",
-#         "グニャラくん"
-#       ],
-#       [
-#         "OffGao",
-#         "OffGao"
+#         "bob",
+#         "Bob"
 #       ]
 #     ]
 #   ]
@@ -6863,11 +6777,13 @@ select \-\-table Users \-\-match_columns name,location_str,description \-\-query
 .UNINDENT
 .UNINDENT
 .sp
-「東京」をキーワードにユーザー検索した結果、東京都に住んでいる「グニャラくん」と「OffGao」がヒットしました。
-.SS GeoPointでユーザー検索
+By using "New York" as searching keyword for user, "Bob" who lives in "New York" is listed in search result.
+.SS Search users by geolocation data (GeoPoint)
+.sp
+In this section, we search users by column data which use type of GeoPoint.
+See \fBsearch\fP about GeoPoint column.
 .sp
-ここでは、 \fBsearch\fP で扱った、GeoPoint型のカラムで検索をします。
-以下の例では、指定された位置から5000m以内にいるユーザーを検索しています。
+Following example searches users who live in within 20km from specified location.
 .sp
 Execution example:
 .INDENT 0.0
@@ -6875,7 +6791,7 @@ Execution example:
 .sp
 .nf
 .ft C
-select \-\-table Users \-\-filter \(aqgeo_in_circle(location,"128484216x502919856",5000)\(aq \-\-output_columns _key,name
+select \-\-table Users \-\-filter \(aqgeo_in_circle(location,"146710080x\-266315480",20000)\(aq \-\-output_columns _key,name
 # [
 #   [
 #     0,
@@ -6898,12 +6814,12 @@ select \-\-table Users \-\-filter \(aqgeo_in_circle(location,"128484216x50291985
 #         ]
 #       ],
 #       [
-#         "tasukuchan",
-#         "グニャラくん"
+#         "charlie",
+#         "Charlie"
 #       ],
 #       [
-#         "OffGao",
-#         "OffGao"
+#         "bob",
+#         "Bob"
 #       ]
 #     ]
 #   ]
@@ -6913,11 +6829,12 @@ select \-\-table Users \-\-filter \(aqgeo_in_circle(location,"128484216x50291985
 .UNINDENT
 .UNINDENT
 .sp
-新宿駅から5km以内にすんでいるユーザーを検索したところ、「グニャラくん」と「OffGao」がヒットしました。
-.SS あるユーザーをフォローしているユーザーの検索
+It shows that "Bob" and "Charlie" lives in within 20 km from station of "Grand Central Terminal".
+.SS Search users who follows specific user
 .sp
-ここでは、 \fBindex\fP で扱った、参照関係の逆引きをします。
-以下の例では、Usersテーブルのfollowerカラムにあるフォローリストを逆引きします。
+In this section, we do reverse resolution of reference relationships which is described at \fBindex\fP\&.
+.sp
+Following examples shows reverse resolution about \fBfollower\fP column of \fBUsers\fP table.
 .sp
 Execution example:
 .INDENT 0.0
@@ -6925,7 +6842,7 @@ Execution example:
 .sp
 .nf
 .ft C
-select \-\-table Users \-\-query follower:@tasukuchan \-\-output_columns _key,name
+select \-\-table Users \-\-query follower:@bob \-\-output_columns _key,name
 # [
 #   [
 #     0,
@@ -6948,12 +6865,12 @@ select \-\-table Users \-\-query follower:@tasukuchan \-\-output_columns _key,na
 #         ]
 #       ],
 #       [
-#         "daijiro",
-#         "hsiomaneki"
+#         "alice",
+#         "Alice"
 #       ],
 #       [
-#         "OffGao",
-#         "OffGao"
+#         "charlie",
+#         "Charlie"
 #       ]
 #     ]
 #   ]
@@ -6963,11 +6880,14 @@ select \-\-table Users \-\-query follower:@tasukuchan \-\-output_columns _key,na
 .UNINDENT
 .UNINDENT
 .sp
-「グニャラくん」をフォローしている「hsiomaneki」と「OffGao」がヒットしました。
-.SS GeoPointでコメント検索
+It shows that "Alice" and "Charlie" follows "Bob".
+.SS Search comments by using the value of GeoPoint type
 .sp
-ある範囲内で書かれたコメントを検索します。
-また、 \fBdrilldown\fP で扱ったドリルダウンも行います。検索結果をハッシュタグとユーザーでドリルダウンし、ユーザー別・ハッシュタグ別のカウントを出します。
+In this section, we search comments which are written within specific location.
+.sp
+Then, we also use drill down which is described at \fBdrilldown\fP\&.
+Following example shows how to drill down against search results.
+As a result, we get the value of count which is grouped by user, and hash tags respectively.
 .sp
 Execution example:
 .INDENT 0.0
@@ -6975,7 +6895,7 @@ Execution example:
 .sp
 .nf
 .ft C
-select \-\-table Comments \-\-filter \(aqgeo_in_circle(location,"127975798x502919856",20000)\(aq \-\-output_columns posted_by.name,comment \-\-drilldown hash_tags,posted_by
+select \-\-table Comments \-\-filter \(aqgeo_in_circle(location,"146867000x\-266280000",20000)\(aq \-\-output_columns posted_by.name,comment \-\-drilldown hash_tags,posted_by
 # [
 #   [
 #     0,
@@ -6998,20 +6918,20 @@ select \-\-table Comments \-\-filter \(aqgeo_in_circle(location,"127975798x50291
 #         ]
 #       ],
 #       [
-#         "グニャラくん",
-#         "groonga開発合宿のため羽田空港に来ました！ #groonga #travel"
+#         "Charlie",
+#         "I\(aqm at the Museum of Modern Art in NY now!"
 #       ],
 #       [
-#         "グニャラくん",
-#         "groongaなう #groonga"
+#         "Bob",
+#         "I\(aqve just used \(aqTry\-Groonga\(aq now! #groonga"
 #       ],
 #       [
-#         "OffGao",
-#         "@daijiro @tasukuchan 登録してみましたよー！"
+#         "Bob",
+#         "I\(aqm come at city of New York for development camp! #groonga #travel"
 #       ],
 #       [
-#         "OffGao",
-#         "中野ブロードウェイなうなう"
+#         "Charlie",
+#         "@alice @bob I\(aqve tried to register!"
 #       ]
 #     ],
 #     [
@@ -7052,11 +6972,11 @@ select \-\-table Comments \-\-filter \(aqgeo_in_circle(location,"127975798x50291
 #         ]
 #       ],
 #       [
-#         "tasukuchan",
+#         "charlie",
 #         2
 #       ],
 #       [
-#         "OffGao",
+#         "bob",
 #         2
 #       ]
 #     ]
@@ -7067,11 +6987,14 @@ select \-\-table Comments \-\-filter \(aqgeo_in_circle(location,"127975798x50291
 .UNINDENT
 .UNINDENT
 .sp
-範囲を広く指定したため、位置情報のあるすべてのコメントがヒットしました。そして、ヒットしたコメントからドリルダウンされた結果も返ってきており、ハッシュタグは「#groonga」が2つに「#travel」が1つ、投稿者は「グニャラくん」「OffGao」がそれぞれ2件ずつであることがわかります。
-.SS キーワードでコメント検索
+Above query searches comments which are posted within 20 km from Central Park in city of New York.
 .sp
-あるキーワードを含むコメントを検索します。
-さらに、 \fBsearch\fP で扱った、スコア値_scoreも出してみましょう。
+As specified range is 20 km, all comments with location are collected.
+You know that search results contain 2 #groonga hash tags and one #travel hash tag, and bob and charlie posted 2 comments.
+.SS Search comments by keyword
+.sp
+In this section, we search comments which contains specific keyword.
+And more, Let\(aqs calculate the value of \fI_score\fP which is described at \fBsearch\fP\&.
 .sp
 Execution example:
 .INDENT 0.0
@@ -7079,7 +7002,7 @@ Execution example:
 .sp
 .nf
 .ft C
-select \-\-table Comments \-\-query comment:@なう \-\-output_columns comment,_score
+select \-\-table Comments \-\-query comment:@Now \-\-output_columns comment,_score
 # [
 #   [
 #     0,
@@ -7102,12 +7025,12 @@ select \-\-table Comments \-\-query comment:@なう \-\-output_columns comment,_
 #         ]
 #       ],
 #       [
-#         "groongaなう #groonga",
+#         "I\(aqve just used \(aqTry\-Groonga\(aq now! #groonga",
 #         1
 #       ],
 #       [
-#         "中野ブロードウェイなうなう",
-#         2
+#         "I\(aqm at the Museum of Modern Art in NY now!",
+#         1
 #       ]
 #     ]
 #   ]
@@ -7117,10 +7040,11 @@ select \-\-table Comments \-\-query comment:@なう \-\-output_columns comment,_
 .UNINDENT
 .UNINDENT
 .sp
-「なう」をキーワードにコメント検索した結果、2件のコメントがヒットしました。また、_scoreの値も返ってきており、「なう」の数が出力されていることが確認できます。
-.SS GeoPointとキーワードでコメント検索
+By using \(aqNow\(aq as a keyword, above query returns 2 comments. It also contains count of \(aqNow\(aq as the value of \fI_score\fP\&.
+.SS Search comments by keyword and geolocation
 .sp
-今度は、キーワードとGeoPointの両方を条件に検索をしてみます。\-\-queryと\-\-filterの両方を使用した場合、両方の条件に一致するレコードがヒットします。
+In this section, we search comments by specific keyword and geolocation.
+By using \fI\-\-query\fP and \fI\-\-filter\fP option, following query returns records which are matched to both conditions.
 .sp
 Execution example:
 .INDENT 0.0
@@ -7128,7 +7052,7 @@ Execution example:
 .sp
 .nf
 .ft C
-select \-\-table Comments \-\-query comment:@羽田 \-\-filter \(aqgeo_in_circle(location,"127975798x502919856",20000)\(aq \-\-output_columns posted_by.name,comment \-\-drilldown hash_tags,posted_by
+select \-\-table Comments \-\-query comment:@New \-\-filter \(aqgeo_in_circle(location,"146867000x\-266280000",20000)\(aq \-\-output_columns posted_by.name,comment \-\-drilldown hash_tags,posted_by
 # [
 #   [
 #     0,
@@ -7151,8 +7075,8 @@ select \-\-table Comments \-\-query comment:@羽田 \-\-filter \(aqgeo_in_circle
 #         ]
 #       ],
 #       [
-#         "グニャラくん",
-#         "groonga開発合宿のため羽田空港に来ました！ #groonga #travel"
+#         "Bob",
+#         "I\(aqm come at city of New York for development camp! #groonga #travel"
 #       ]
 #     ],
 #     [
@@ -7193,7 +7117,7 @@ select \-\-table Comments \-\-query comment:@羽田 \-\-filter \(aqgeo_in_circle
 #         ]
 #       ],
 #       [
-#         "tasukuchan",
+#         "bob",
 #         1
 #       ]
 #     ]
@@ -7204,11 +7128,12 @@ select \-\-table Comments \-\-query comment:@羽田 \-\-filter \(aqgeo_in_circle
 .UNINDENT
 .UNINDENT
 .sp
-両方の条件を満たすコメントが1件ヒットしました。また、ドリルダウンの結果も返ってきており、「グニャラくん」のコメント1件であることがわかります。
-.SS ハッシュタグでコメント検索
+It returns 1 comment which meets both condition.
+It also returns result of drilldown. There is 1 comment which is commented by Bob.
+.SS Search comments by hash tags
 .sp
-あるハッシュタグのついているコメントを検索します。
-これも、 \fBindex\fP で扱った、参照関係の逆引きを使います。
+In this section, we search comments which contains specific hash tags.
+Let\(aqs use reverse resolution of reference relationships.
 .sp
 Execution example:
 .INDENT 0.0
@@ -7239,12 +7164,12 @@ select \-\-table Comments \-\-query hash_tags:@groonga \-\-output_columns posted
 #         ]
 #       ],
 #       [
-#         "グニャラくん",
-#         "groongaなう #groonga"
+#         "Bob",
+#         "I\(aqve just used \(aqTry\-Groonga\(aq now! #groonga"
 #       ],
 #       [
-#         "グニャラくん",
-#         "groonga開発合宿のため羽田空港に来ました！ #groonga #travel"
+#         "Bob",
+#         "I\(aqm come at city of New York for development camp! #groonga #travel"
 #       ]
 #     ],
 #     [
@@ -7262,7 +7187,7 @@ select \-\-table Comments \-\-query hash_tags:@groonga \-\-output_columns posted
 #         ]
 #       ],
 #       [
-#         "tasukuchan",
+#         "bob",
 #         2
 #       ]
 #     ]
@@ -7273,10 +7198,11 @@ select \-\-table Comments \-\-query hash_tags:@groonga \-\-output_columns posted
 .UNINDENT
 .UNINDENT
 .sp
-#groongaタグの付いている2件のコメントがヒットしました。また、投稿者のドリルダウンも返ってきており、2件とも「グニャラくん」のものであることがわかります。
-.SS ユーザーIDでコメント検索
+Above query returns 2 comments which contains #groonga hash tag.
+It also returns result of drilldown grouped by person who posted it. It shows that there are 2 comments. Bob commented it.
+.SS Search comments by user id
 .sp
-あるユーザーが投稿したコメントを検索します。
+In this section, we search comments which are posted by specific user.
 .sp
 Execution example:
 .INDENT 0.0
@@ -7284,7 +7210,7 @@ Execution example:
 .sp
 .nf
 .ft C
-select \-\-table Comments \-\-query posted_by:tasukuchan \-\-output_columns comment \-\-drilldown hash_tags
+select \-\-table Comments \-\-query posted_by:bob \-\-output_columns comment \-\-drilldown hash_tags
 # [
 #   [
 #     0,
@@ -7303,16 +7229,16 @@ select \-\-table Comments \-\-query posted_by:tasukuchan \-\-output_columns comm
 #         ]
 #       ],
 #       [
-#         "初の書き込み。テストテスト。"
+#         "First post. test,test..."
 #       ],
 #       [
-#         "@daijiro ありがとう！"
+#         "@alice Thanks!"
 #       ],
 #       [
-#         "groongaなう #groonga"
+#         "I\(aqve just used \(aqTry\-Groonga\(aq now! #groonga"
 #       ],
 #       [
-#         "groonga開発合宿のため羽田空港に来ました！ #groonga #travel"
+#         "I\(aqm come at city of New York for development camp! #groonga #travel"
 #       ]
 #     ],
 #     [
@@ -7345,10 +7271,11 @@ select \-\-table Comments \-\-query posted_by:tasukuchan \-\-output_columns comm
 .UNINDENT
 .UNINDENT
 .sp
-「グニャラくん」が書き込んだ4件のコメントがヒットしました。また、ハッシュタグでドリルダウンした結果も返ってきており、ハッシュタグは「#groonga」が2つに「#travel」が1つあることがわかります。
-.SS ユーザーのお気に入りコメントを検索
+Above query returns 4 comments which are posted by Bob.
+It also returns result of drilldown by hash tags. There are 2 comments which contains #groonga, and 1 comment which contains #travel as hash tag.
+.SS Search user\(aqs favorite comments
 .sp
-あるユーザーがお気に入りに入れているコメントを検索します。
+In this section, we search user\(aqs favorite comments.
 .sp
 Execution example:
 .INDENT 0.0
@@ -7356,7 +7283,7 @@ Execution example:
 .sp
 .nf
 .ft C
-select \-\-table Users \-\-query _key:tasukuchan \-\-output_columns favorites.posted_by,favorites.comment
+select \-\-table Users \-\-query _key:bob \-\-output_columns favorites.posted_by,favorites.comment
 # [
 #   [
 #     0,
@@ -7380,12 +7307,12 @@ select \-\-table Users \-\-query _key:tasukuchan \-\-output_columns favorites.po
 #       ],
 #       [
 #         [
-#           "daijiro",
-#           "OffGao"
+#           "alice",
+#           "charlie"
 #         ],
 #         [
-#           "マイクロブログ作ってみました（甘栗むいちゃいました的な感じで）。",
-#           "@daijiro @tasukuchan 登録してみましたよー！"
+#           "I\(aqve created micro\-blog!",
+#           "@alice @bob I\(aqve tried to register!"
 #         ]
 #       ]
 #     ]
@@ -7396,11 +7323,13 @@ select \-\-table Users \-\-query _key:tasukuchan \-\-output_columns favorites.po
 .UNINDENT
 .UNINDENT
 .sp
-「グニャラくん」がお気に入りに入れている2件のコメントがヒットしました。
-.SS 投稿時間でコメント検索
+Above query returns Bob\(aqs favorite comments.
+.SS Search comments by posted time
+.sp
+In this section, we search comments by posted time.
+See type of \fITime\fP in \fBdata\fP\&.
 .sp
-コメントの投稿時間で検索をします。Time型については \fBdata\fP で扱っています。
-この例では、指定した時間よりも前に投稿されているコメントを検索します。
+Let\(aqs search comments that posted time are older than specified time.
 .sp
 Execution example:
 .INDENT 0.0
@@ -7435,28 +7364,28 @@ select Comments \-\-filter \(aqlast_modified<=1268802000\(aq \-\-output_columns
 #         ]
 #       ],
 #       [
-#         "hsiomaneki",
-#         "マイクロブログ作ってみました（甘栗むいちゃいました的な感じで）。",
+#         "Alice",
+#         "I\(aqve created micro\-blog!",
 #         1268795100.0
 #       ],
 #       [
-#         "グニャラくん",
-#         "初の書き込み。テストテスト。",
+#         "Bob",
+#         "First post. test,test...",
 #         1268794800.0
 #       ],
 #       [
-#         "hsiomaneki",
-#         "@tasukuchan ようこそ!!!",
+#         "Alice",
+#         "@bob Welcome!!!",
 #         1268795100.0
 #       ],
 #       [
-#         "グニャラくん",
-#         "@daijiro ありがとう！",
+#         "Bob",
+#         "@alice Thanks!",
 #         1268798400.0
 #       ],
 #       [
-#         "グニャラくん",
-#         "groongaなう #groonga",
+#         "Bob",
+#         "I\(aqve just used \(aqTry\-Groonga\(aq now! #groonga",
 #         1268802000.0
 #       ]
 #     ],
@@ -7494,11 +7423,11 @@ select Comments \-\-filter \(aqlast_modified<=1268802000\(aq \-\-output_columns
 #         ]
 #       ],
 #       [
-#         "daijiro",
+#         "alice",
 #         2
 #       ],
 #       [
-#         "tasukuchan",
+#         "bob",
 #         3
 #       ]
 #     ]
@@ -7509,19 +7438,22 @@ select Comments \-\-filter \(aqlast_modified<=1268802000\(aq \-\-output_columns
 .UNINDENT
 .UNINDENT
 .sp
-2010/03/17 14:00:00以前に書かれたコメント5件がヒットしました。また、ドリルダウンの結果も返ってきており、「hsiomaneki」が2件、「グニャラくん」が3件ヒットしていることがわかります。
-.SS クエリ拡張
+Above query returns 5 comments which are older than 2010/03/17 14:00:00.
+It also returns result of drilldown by posted person. There are 2 comments by Alice, 3 comments by Bob.
+.SS Query expansion
 .sp
-Groongaでは、 \fB/reference/commands/select\fP コマンドにquery_expanderパラメータを指定することによって、ユーザが指定した検索文字列を適宜拡張することが可能です。
+Groonga accepts \fBquery_expander\fP parameter for \fB/reference/commands/select\fP command.
+It enables you to extend your query string.
 .sp
-たとえば、ユーザが\(aqシークヮーサー\(aqという文字列で検索した場合に、\(aqシークヮーサー OR シークァーサー\(aqで検索した場合と同一の結果を返すことによって、本来ユーザが必要とする結果をよりもれなく検索できるようになります。
-.SS 準備
+For example, if user searches "theatre" instead of "theater",
+query expansion enables to return search results of "theatre OR theater".
+This kind of way reduces search leakages. This is what really user wants.
+.SS Preparation
 .sp
-クエリ拡張機能を使用するためには、検索対象となる文書を格納するテーブル(ここでは文書テーブルと呼びます)以外に、ユーザの指定した検索文字列を置換するためのテーブル(ここでは置換テーブルと呼びます)を準備します。置換テーブルでは、その主キーが置換前の文字列となり、文字列型(ShortText)のカラムの値が置換後の文字列となります。
+To use query expansion, you need to create table which stores documents, synonym table which stores query string and replacement string.
+In synonym table, primary key represents original string, the column of ShortText represents modified string.
 .sp
-TODO: 文字列型のベクターカラムでも可能であり、その場合は各要素をORでつなげたものに置換されるということを記述する。
-.sp
-実際に文書テーブルと置換テーブルを作成してみましょう。
+Let\(aqs create document table and synonym table.
 .sp
 Execution example:
 .INDENT 0.0
@@ -7543,14 +7475,14 @@ column_create Synonym body COLUMN_SCALAR ShortText
 # [[0, 1337566253.89858, 0.000355720520019531], true]
 load \-\-table Doc
 [
-{"_key": "001", "body": "すっぱいブドウと甘いシークァーサー"},
-{"_key": "002", "body": "シークヮーサージュースとゴーヤチャンプル"},
+{"_key": "001", "body": "Play all night in this theater."},
+{"_key": "002", "body": "theatre is British spelling."},
 ]
 # [[0, 1337566253.89858, 0.000355720520019531], 2]
 load \-\-table Synonym
 [
-{"_key": "シークァーサー", "body": "(シークァーサー OR シークヮーサー)"},
-{"_key": "シークヮーサー", "body": "(シークァーサー OR シークヮーサー)"},
+{"_key": "theater", "body": "(theater OR theatre)"},
+{"_key": "theatre", "body": "(theater OR theatre)"},
 ]
 # [[0, 1337566253.89858, 0.000355720520019531], 2]
 .ft P
@@ -7558,10 +7490,11 @@ load \-\-table Synonym
 .UNINDENT
 .UNINDENT
 .sp
-この例では、ユーザが"シークァーサー"と入力しても、"シークヮーサー"と入力しても、それぞれの異なる表記の文書をもれなく検索するための置換テーブルを作成しています。
-.SS 検索
+In this case, it doesn\(aqt occur search leakage because it creates synonym table which accepts "theatre" and "theater" as query string.
+.SS Search
 .sp
-それでは実際に、準備した置換テーブルを使ってみましょう。まずは、query_expanderパラメータを指定せずにselectコマンドを使って検索してみます。
+Then, let\(aqs use prepared synonym table.
+First, use select command without \fBquery_expander\fP parameter.
 .sp
 Execution example:
 .INDENT 0.0
@@ -7569,7 +7502,7 @@ Execution example:
 .sp
 .nf
 .ft C
-select Doc \-\-match_columns body \-\-query "シークァーサー"
+select Doc \-\-match_columns body \-\-query "theater"
 # [
 #   [
 #     0,
@@ -7598,12 +7531,12 @@ select Doc \-\-match_columns body \-\-query "シークァーサー"
 #       [
 #         1,
 #         "001",
-#         "すっぱいブドウと甘いシークァーサー"
+#         "Play all night in this theater."
 #       ]
 #     ]
 #   ]
 # ]
-select Doc \-\-match_columns body \-\-query "シークヮーサー"
+select Doc \-\-match_columns body \-\-query "theatre"
 # [
 #   [
 #     0,
@@ -7632,7 +7565,7 @@ select Doc \-\-match_columns body \-\-query "シークヮーサー"
 #       [
 #         2,
 #         "002",
-#         "シークヮーサージュースとゴーヤチャンプル"
+#         "theatre is British spelling."
 #       ]
 #     ]
 #   ]
@@ -7642,7 +7575,9 @@ select Doc \-\-match_columns body \-\-query "シークヮーサー"
 .UNINDENT
 .UNINDENT
 .sp
-指定された文字列に完全に一致するレコードのみがそれぞれヒットします。次に、query_expanderパラメータに、準備したSynonymテーブルのbodyカラムを指定してみましょう。
+Above query returns the record which completely equal to query string.
+.sp
+Then, use \fBquery_expander\fP parameter against \fBbody\fP column of \fBSynonym\fP table.
 .sp
 Execution example:
 .INDENT 0.0
@@ -7650,7 +7585,7 @@ Execution example:
 .sp
 .nf
 .ft C
-select Doc \-\-match_columns body \-\-query "シークァーサー" \-\-query_expander Synonym.body
+select Doc \-\-match_columns body \-\-query "theater" \-\-query_expander Synonym.body
 # [
 #   [
 #     0,
@@ -7679,17 +7614,17 @@ select Doc \-\-match_columns body \-\-query "シークァーサー" \-\-query_ex
 #       [
 #         1,
 #         "001",
-#         "すっぱいブドウと甘いシークァーサー"
+#         "Play all night in this theater."
 #       ],
 #       [
 #         2,
 #         "002",
-#         "シークヮーサージュースとゴーヤチャンプル"
+#         "theatre is British spelling."
 #       ]
 #     ]
 #   ]
 # ]
-select Doc \-\-match_columns body \-\-query "シークヮーサー" \-\-query_expander Synonym.body
+select Doc \-\-match_columns body \-\-query "theatre" \-\-query_expander Synonym.body
 # [
 #   [
 #     0,
@@ -7718,12 +7653,12 @@ select Doc \-\-match_columns body \-\-query "シークヮーサー" \-\-query_ex
 #       [
 #         1,
 #         "001",
-#         "すっぱいブドウと甘いシークァーサー"
+#         "Play all night in this theater."
 #       ],
 #       [
 #         2,
 #         "002",
-#         "シークヮーサージュースとゴーヤチャンプル"
+#         "theatre is British spelling."
 #       ]
 #     ]
 #   ]
@@ -7733,7 +7668,7 @@ select Doc \-\-match_columns body \-\-query "シークヮーサー" \-\-query_ex
 .UNINDENT
 .UNINDENT
 .sp
-どちらのクエリ文字列も、"(シークァーサー OR シークヮーサー)"という文字列に置換されてから検索されるため、表記の揺れを吸収して検索できるようになりました。
+In which cases, query string is replaced to "(theater OR theatre)", thus synonym is considered for full text search.
 .SH SUGGEST
 .sp
 Groonga has the suggest feature. This section describes how to use it and how it works.
@@ -9853,9 +9788,9 @@ TODO
 .sp
 TODO
 .SH REFERENCE MANUAL
-.SS 実行ファイル
+.SS Executables
 .sp
-groongaパッケージが提供する実行ファイルについて説明します。
+This section describes executable files provided by groonga package.
 .SS grnslap
 .SS 名前
 .sp
@@ -32934,10 +32869,10 @@ Report a bug to the mailing list
 You can use either way It makes no difference to us.
 .SS Submit a bug to the issue tracker
 .sp
-Groonga project has two issue tracking systems, \fI\%Redmine\fP and \fI\%GitHub
-issue tracker\fP\&.  Redmine
-is for Japanese and GitHub issue tracker is for English. You can use
-one of them to report a bug.
+Groonga project uses \fI\%GitHub
+issue tracker\fP\&.
+.sp
+You can use English or Japanese to report a bug.
 .SS Report a bug to the mailing list
 .sp
 Groonga project has \fB/community\fP for discussing about groonga.