RubyGems - rroonga - Versions diffs - 2.1.2-x86-mingw32 → 2.1.3-x86-mingw32 - Mend

rroonga 2.1.2-x86-mingw32 → 2.1.3-x86-mingw32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (788) hide show

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

@@ -1,4 +1,4 @@
-.TH "GROONGA" "1" "December 29, 2012" "2.1.1" "groonga"
+.TH "GROONGA" "1" "January 28, 2013" "2.1.2" "groonga"
 .SH NAME
 groonga \- groonga documentation
 .
@@ -104,20 +104,60 @@ memory error with a 32\-bit package even if you just process medium
 size data.
 .SS Installer
 .sp
-For 32\-bit environment, download \fI\%groonga-2.1.0-x86.exe\fP
-and run it.
+For 32\-bit environment, download x86 executable binary from packages.groonga.org.
 .sp
-For 64\-bit environment, download \fI\%groonga-2.1.0-x64.exe\fP
-and run it.
+You can download such a binary by command line operation.
+.sp
+Start command prompt \fBcmd.exe\fP and download x86 executable binary by default browser:
+.sp
+.nf
+.ft C
+> "c:\e\eProgram Files\e\eInternet Explorer\e\eiexplore.exe" http://packages.groonga.org/windows/groonga/groonga\-2.1.2\-x86.exe
+.ft P
+.fi
+.sp
+Then run it.
+.sp
+For 64\-bit environment, download x64 executable binary from packages.groonga.org.
+.sp
+Start command prompt \fBcmd.exe\fP and download x64 executable binary by default browser:
+.sp
+.nf
+.ft C
+> "c:\e\eProgram Files\e\eInternet Explorer\e\eiexplore.exe" http://packages.groonga.org/windows/groonga/groonga\-2.1.2\-x64.exe
+.ft P
+.fi
+.sp
+Then run it.
 .sp
 Use command prompt for \fB/reference/executables/groonga\fP installed in start menu.
 .SS zip
 .sp
-For 32\-bit environment, download \fI\%groonga-2.1.0-x86.zip\fP
-and extract it.
+For 32\-bit environment, download x86 zip archive from packages.groonga.org.
+.sp
+You can download such a binary by command line operation.
+.sp
+Start command prompt \fBcmd.exe\fP and download x86 zip archive by default browser:
+.sp
+.nf
+.ft C
+> "c:\e\eProgram Files\e\eInternet Explorer\e\eiexplore.exe" http://packages.groonga.org/windows/groonga/groonga\-2.1.2\-x86.zip
+.ft P
+.fi
+.sp
+Then extract it.
+.sp
+For 64\-bit environment, download x64 zip archive from packages.groonga.org.
 .sp
-For 64\-bit environment, download \fI\%groonga-2.1.0-x64.zip\fP
-and extract it.
+Start command prompt \fBcmd.exe\fP and download x64 zip archive by default browser:
+.sp
+.nf
+.ft C
+> "c:\e\eProgram Files\e\eInternet Explorer\e\eiexplore.exe" http://packages.groonga.org/windows/groonga/groonga\-2.1.2\-x64.zip
+.ft P
+.fi
+.sp
+Then extract it.
 .sp
 \fB/reference/executables/groonga\fP is in \fBbin\fP folder.
 .SS Build from source
@@ -135,15 +175,27 @@ Windows. Here are required tools:
 .UNINDENT
 .UNINDENT
 .sp
-Download zipped source \fI\%groonga-2.1.0.zip\fP
-and extract it.
+Download zipped source from packages.groonga.org.
+.sp
+You can download such a zipped source file by command line operation.
 .sp
 Start \fBVisual Studio Command Prompt (2010)\fP installed by Microsoft
-Visual Studio 2010 Express and move to the groonga\(aqs source folder:
+Visual Studio 2010 Express and download it by default browser:
+.sp
+.nf
+.ft C
+> cd c:\eUsers\e%USERNAME%\eDownloads
+> "c:\e\eProgram Files\e\eInternet Explorer\e\eiexplore.exe" http://packages.groonga.org/source/groonga/groonga\-2.1.2.zip
+.ft P
+.fi
+.sp
+Then extract it.
+.sp
+Move to the groonga\(aqs source folder:
 .sp
 .nf
 .ft C
-> cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-2.1.0
+> cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-2.1.2
 .ft P
 .fi
 .sp
@@ -153,7 +205,7 @@ parameter instead:
 .sp
 .nf
 .ft C
-groonga\-2.1.0> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\egroonga
+groonga\-2.1.2> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\egroonga
 .ft P
 .fi
 .sp
@@ -161,7 +213,7 @@ Build by Visual C++ 2010 Express:
 .sp
 .nf
 .ft C
-groonga\-2.1.0> msbuild groonga.sln /p:Configuration=Release
+groonga\-2.1.2> msbuild groonga.sln /p:Configuration=Release
 .ft P
 .fi
 .sp
@@ -169,7 +221,7 @@ Install by Visual C++ 2010 Express:
 .sp
 .nf
 .ft C
-groonga\-2.1.0> msbuild groonga.sln /p:Configuration=Release /t:Install
+groonga\-2.1.2> msbuild groonga.sln /p:Configuration=Release /t:Install
 .ft P
 .fi
 .sp
@@ -179,7 +231,7 @@ Build by Visual Studio 2010:
 .sp
 .nf
 .ft C
-groonga\-2.1.0> devenv groonga.sln /Build Release
+groonga\-2.1.2> devenv groonga.sln /Build Release
 .ft P
 .fi
 .sp
@@ -187,7 +239,7 @@ Install by Visual Studio 2010:
 .sp
 .nf
 .ft C
-groonga\-2.1.0> devenv groonga.sln /Build Release /Project Install
+groonga\-2.1.2> devenv groonga.sln /Build Release /Project Install
 .ft P
 .fi
 .sp
@@ -229,9 +281,9 @@ Download source:
 .sp
 .nf
 .ft C
-% curl \-O http://packages.groonga.org/source/groonga/groonga\-2.1.0.tar.gz
-% tar xvzf groonga\-2.1.0.tar.gz
-% cd groonga\-2.1.0
+% curl \-O http://packages.groonga.org/source/groonga/groonga\-2.1.2.tar.gz
+% tar xvzf groonga\-2.1.2.tar.gz
+% cd groonga\-2.1.2
 .ft P
 .fi
 .sp
@@ -268,6 +320,23 @@ 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.
+.IP Note
+The package \(aqgroonga\(aq is the mininum 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.
+.RE
 .SS squeeze
 .sp
 Add the groonga apt repository.
@@ -417,9 +486,9 @@ Download source:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-2.1.0.tar.gz
-% tar xvzf groonga\-2.1.0.tar.gz
-% cd groonga\-2.1.0
+% wget http://packages.groonga.org/source/groonga/groonga\-2.1.2.tar.gz
+% tar xvzf groonga\-2.1.2.tar.gz
+% cd groonga\-2.1.2
 .ft P
 .fi
 .sp
@@ -456,6 +525,23 @@ 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.
+.IP Note
+The package \(aqgroonga\(aq is the mininum 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.
+.RE
 .SS 10.04 LTS Lucid Lynx
 .IP Note
 Enable the universe repository to install groonga:
@@ -690,9 +776,9 @@ Download source:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-2.1.0.tar.gz
-% tar xvzf groonga\-2.1.0.tar.gz
-% cd groonga\-2.1.0
+% wget http://packages.groonga.org/source/groonga/groonga\-2.1.2.tar.gz
+% tar xvzf groonga\-2.1.2.tar.gz
+% cd groonga\-2.1.2
 .ft P
 .fi
 .sp
@@ -729,6 +815,23 @@ 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.
+.IP Note
+The package \(aqgroonga\(aq is the mininum 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.
+.RE
 .SS CentOS 5
 .sp
 Install:
@@ -893,9 +996,9 @@ Download source:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-2.1.0.tar.gz
-% tar xvzf groonga\-2.1.0.tar.gz
-% cd groonga\-2.1.0
+% wget http://packages.groonga.org/source/groonga/groonga\-2.1.2.tar.gz
+% tar xvzf groonga\-2.1.2.tar.gz
+% cd groonga\-2.1.2
 .ft P
 .fi
 .sp
@@ -940,7 +1043,24 @@ 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 Fedora 17
+.IP Note
+The package \(aqgroonga\(aq is the mininum 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.
+.RE
+.SS Fedora 18
 .sp
 Install:
 .sp
@@ -1005,9 +1125,9 @@ Download source:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-2.1.0.tar.gz
-% tar xvzf groonga\-2.1.0.tar.gz
-% cd groonga\-2.1.0
+% wget http://packages.groonga.org/source/groonga/groonga\-2.1.2.tar.gz
+% tar xvzf groonga\-2.1.2.tar.gz
+% cd groonga\-2.1.2
 .ft P
 .fi
 .sp
@@ -1052,9 +1172,9 @@ Download source:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-2.1.0.tar.gz
-% gtar xvzf groonga\-2.1.0.tar.gz
-% cd groonga\-2.1.0
+% wget http://packages.groonga.org/source/groonga/groonga\-2.1.2.tar.gz
+% gtar xvzf groonga\-2.1.2.tar.gz
+% cd groonga\-2.1.2
 .ft P
 .fi
 .sp
@@ -1178,9 +1298,9 @@ steps:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-2.1.0.tar.gz
-% tar xvzf groonga\-2.1.0.tar.gz
-% cd groonga\-2.1.0
+% wget http://packages.groonga.org/source/groonga/groonga\-2.1.2.tar.gz
+% tar xvzf groonga\-2.1.2.tar.gz
+% cd groonga\-2.1.2
 % ./configure
 % make
 % sudo make install
@@ -7569,6 +7689,334 @@ are treated.
 .sp
 Coming soon...
 .SH SERVER
+.SS Server packages
+.sp
+The package \fBgroonga\fP is the mininum 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
+\fBgroonga\-httpd\fP (nginx and HTTP protocol based server package)
+.IP \(bu 2
+\fBgroonga\-server\-http\fP (simple HTTP protocol based server package)
+.IP \(bu 2
+\fBgroonga\-server\-gqtp\fP (GQTP protocol based server package)
+.UNINDENT
+.sp
+Note that there is a conflict between \fBgroonga\-httpd\fP and \fBgroonga\-server\-http\fP
+package because of port number.
+See \fB/server/http/comparison\fP if you want to know which package meets your demands.
+.SS groonga\-httpd
+.sp
+\fBgroonga\-httpd\fP is a nginx and HTTP protocol based server package.
+.sp
+Preconfigured setting:
+.TS
+center;
+|l|l|.
+_
+T{
+Item
+T}	T{
+Default value
+T}
+_
+T{
+Port number
+T}	T{
+10041
+T}
+_
+T{
+Access log path
+T}	T{
+/var/log/groonga/httpd/acccess.log
+T}
+_
+T{
+Error log path
+T}	T{
+/var/log/groonga/http\-query.log
+T}
+_
+T{
+Database
+T}	T{
+/var/lib/groonga/db/*
+T}
+_
+T{
+Configuration file
+T}	T{
+/etc/groonga/httpd/groonga\-httpd.conf
+T}
+_
+.TE
+.SS Start HTTP server
+.sp
+Starting groonga HTTP server(Debian/Ubuntu/CentOS):
+.sp
+.nf
+.ft C
+% sudo service groonga\-httpd start
+.ft P
+.fi
+.sp
+Starting groonga HTTP server(Fedora):
+.sp
+.nf
+.ft C
+% sudo systemctl start groonga\-httpd
+.ft P
+.fi
+.SS Stop HTTP server
+.sp
+Stopping groonga HTTP server(Debian/Ubuntu/CentOS):
+.sp
+.nf
+.ft C
+% sudo service groonga\-httpd stop
+.ft P
+.fi
+.sp
+Starting groonga HTTP server(Fedora):
+.sp
+.nf
+.ft C
+% sudo systemctl stop groonga\-httpd
+.ft P
+.fi
+.SS Restart HTTP server
+.sp
+Restarting groonga HTTP server(Debian/Ubuntu/CentOS):
+.sp
+.nf
+.ft C
+% sudo service groonga\-httpd restart
+.ft P
+.fi
+.sp
+Restarting groonga HTTP server(Fedora):
+.sp
+.nf
+.ft C
+% sudo systemctl restart groonga\-httpd
+.ft P
+.fi
+.SS groonga\-server\-http
+.sp
+\fBgroonga\-server\-http\fP is a simple HTTP protocol based server package.
+.sp
+Preconfigured setting:
+.TS
+center;
+|l|l|.
+_
+T{
+Item
+T}	T{
+Default value
+T}
+_
+T{
+Port number
+T}	T{
+10041
+T}
+_
+T{
+\fIprocess\-log\fP
+T}	T{
+/var/log/groonga/groonga\-http.log
+T}
+_
+T{
+\fIquery\-log\fP
+T}	T{
+/var/log/groonga/http\-query.log
+T}
+_
+T{
+Database
+T}	T{
+/var/lib/groonga/db/*
+T}
+_
+.TE
+.sp
+Configuration file for server setting (Debian/Ubuntu):
+.sp
+.nf
+.ft C
+/etc/default/groonga/groonga\-server\-http
+.ft P
+.fi
+.sp
+Configuration file for server setting (CentOS):
+.sp
+.nf
+.ft C
+/etc/sysconfig/groonga\-server\-http
+.ft P
+.fi
+.SS Start HTTP server
+.sp
+Starting groonga HTTP server(Debian/Ubuntu/CentOS):
+.sp
+.nf
+.ft C
+% sudo service groonga\-server\-http start
+.ft P
+.fi
+.sp
+Starting groonga HTTP server(Fedora):
+.sp
+.nf
+.ft C
+% sudo systemctl start groonga\-server\-http
+.ft P
+.fi
+.SS Stop HTTP server
+.sp
+Stopping groonga HTTP server(Debian/Ubuntu/CentOS):
+.sp
+.nf
+.ft C
+% sudo service groonga\-server\-http stop
+.ft P
+.fi
+.sp
+Stopping groonga HTTP server(Fedora):
+.sp
+.nf
+.ft C
+% sudo systemctl stop groonga\-server\-http
+.ft P
+.fi
+.SS Restart HTTP server
+.sp
+Restarting groonga HTTP server(Debian/Ubuntu/CentOS):
+.sp
+.nf
+.ft C
+% sudo service groonga\-server\-http restart
+.ft P
+.fi
+.sp
+Restarting groonga HTTP server(Fedora):
+.sp
+.nf
+.ft C
+% sudo systemctl restart groonga\-server\-http
+.ft P
+.fi
+.SS groonga\-server\-gqtp
+.sp
+\fBgroonga\-server\-gqtp\fP is a GQTP protocol based server package.
+.TS
+center;
+|l|l|.
+_
+T{
+Item
+T}	T{
+Default value
+T}
+_
+T{
+Port number
+T}	T{
+10043
+T}
+_
+T{
+\fIprocess\-log\fP
+T}	T{
+/var/log/groonga/groonga\-gqtp.log
+T}
+_
+T{
+\fIquery\-log\fP
+T}	T{
+/var/log/groonga/gqtp\-query.log
+T}
+_
+T{
+Database
+T}	T{
+/var/lib/groonga/db/*
+T}
+_
+.TE
+.sp
+Configuration file for server setting (Debian/Ubuntu):
+.sp
+.nf
+.ft C
+/etc/default/groonga/groonga\-server\-gqtp
+.ft P
+.fi
+.sp
+Configuration file for server setting (CentOS):
+.sp
+.nf
+.ft C
+/etc/sysconfig/groonga\-server\-gqtp
+.ft P
+.fi
+.SS Start GQTP server
+.sp
+Starting groonga GQTP server(Debian/Ubuntu/CentOS):
+.sp
+.nf
+.ft C
+% sudo service groonga\-server\-gqtp start
+.ft P
+.fi
+.sp
+Starting groonga GQTP server(Fedora):
+.sp
+.nf
+.ft C
+% sudo systemctl start groonga\-server\-gqtp
+.ft P
+.fi
+.SS Stop GQTP server
+.sp
+Stopping groonga GQTP server(Debian/Ubuntu/CentOS):
+.sp
+.nf
+.ft C
+% sudo service groonga\-server\-http stop
+.ft P
+.fi
+.sp
+Stopping groonga GQTP server(Fedora):
+.sp
+.nf
+.ft C
+% sudo systemctl stop groonga\-server\-gqtp
+.ft P
+.fi
+.SS Restart GQTP server
+.sp
+Restarting groonga HTTP server(Debian/Ubuntu/CentOS):
+.sp
+.nf
+.ft C
+% sudo service groonga\-server\-gqtp restart
+.ft P
+.fi
+.sp
+Restarting groonga HTTP server(Fedora):
+.sp
+.nf
+.ft C
+% sudo systemctl restart groonga\-server\-gqtp
+.ft P
+.fi
 .SS GQTP
 .sp
 TODO
@@ -9899,9 +10347,7 @@ clearlockは、対象となるオブジェクト(データベース,テーブル
 対象となるオブジェクト名を指定します。空の場合、開いているdbオブジェクトが対象となります。
 .UNINDENT
 .UNINDENT
-.sp
-返値
-\-\-\-
+.SS 返値
 .SS json形式
 .sp
 .nf
@@ -14538,63 +14984,11 @@ table_remove name
 groonga組込コマンドの一つであるtable_removeについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 table_removeはテーブルと定義されているカラムを削除します。カラムに付随するインデックスも再帰的に削除されます。
-.SS 引数
-.INDENT 0.0
-.TP
-.B \fBname\fP
-削除対象のカラムが定義されているテーブルの名前を指定します。
-.UNINDENT
-.SS 返値
-.SS json形式
-.sp
-.nf
-.ft C
-[成功かどうかのフラグ]
-\(ga\(ga成功かどうかのフラグ\(ga\(ga
-  エラーが生じなかった場合にはtrue、エラーが生じた場合にはfalseを返す。
-.ft P
-.fi
-.SS 例
-.sp
-.nf
-.ft C
-table_remove Entry
-[true]
-.ft P
-.fi
-.SS view_add
-.SS 名前
-.sp
-view_add \- view型のテーブルに要素となるテーブルを追加
-.SS 書式
-.sp
-.nf
-.ft C
-view_add view table
-.ft P
-.fi
-.SS 説明
-.sp
-groonga組込コマンドの一つであるview_addについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
-.sp
-view_addは、view型のテーブルに要素となるテーブルを定義します。
-.SS 引数
-.sp
-\fBview\fP
-.INDENT 0.0
-.INDENT 3.5
-テーブルを追加するview型のテーブルの名前を指定します。
-.UNINDENT
-.UNINDENT
-.sp
-\fBtable\fP
+.SS 引数
 .INDENT 0.0
-.INDENT 3.5
-view型のテーブルに追加されるテーブルの名前を指定します。
-.UNINDENT
+.TP
+.B \fBname\fP
+削除対象のカラムが定義されているテーブルの名前を指定します。
 .UNINDENT
 .SS 返値
 .SS json形式
@@ -14609,12 +15003,14 @@ view型のテーブルに追加されるテーブルの名前を指定します
 .ft P
 .fi
 .SS 例
-.INDENT 0.0
-.TP
-.B ::
-view_add Ventry Entry
+.sp
+.nf
+.ft C
+table_remove Entry
 [true]
-.UNINDENT
+.ft P
+.fi
 .SS データ型
 .SS 名前
 .sp
@@ -14784,7 +15180,7 @@ Table in groonga manages relation between ID and key. Groonga provides
 four table types. They are \fBTABLE_NO_KEY\fP, \fBTABLE_HASH_KEY\fP,
 \fBTABLE_PAT_KEY\fP and \fBTABLE_DAT_KEY\fP.
 .sp
-All table except \fBTABLE_NO_KEY\fP provides both fast ID search by key
+All tables except \fBTABLE_NO_KEY\fP provides both fast ID search by key
 and fast key search by ID. \fBTABLE_NO_KEY\fP doesn\(aqt support
 key. \fBTABLE_NO_KEY\fP only manages ID. So \fBTABLE_NO_KEY\fP doesn\(aqt
 provides ID search and key search.
@@ -14865,13 +15261,15 @@ _
 T{
 Key \-> ID
 speed
-(o \-> fast)
-(x \-> slow)
-T}	T{
 .INDENT 0.0
 .IP \(bu 2
+o: fast
+.IP \(bu 2
+x: slow
 .UNINDENT
 T}	T{
+\-
+T}	T{
 oo
 T}	T{
 x
@@ -14880,10 +15278,13 @@ o
 T}
 _
 T{
-Update
-speed
-(o \-> fast)
-(x \-> slow)
+Update speed
+.INDENT 0.0
+.IP \(bu 2
+o: fast
+.IP \(bu 2
+x: slow
+.UNINDENT
 T}	T{
 ooo
 T}	T{
@@ -14896,8 +15297,12 @@ T}
 _
 T{
 Size
-(o \-> small)
-(x \-> large)
+.INDENT 0.0
+.IP \(bu 2
+o: small
+.IP \(bu 2
+x: large
+.UNINDENT
 T}	T{
 ooo
 T}	T{
@@ -14912,9 +15317,7 @@ T{
 Key
 update
 T}	T{
-.INDENT 0.0
-.IP \(bu 2
-.UNINDENT
+\-
 T}	T{
 x
 T}	T{
@@ -14928,9 +15331,7 @@ Common
 prefix
 search
 T}	T{
-.INDENT 0.0
-.IP \(bu 2
-.UNINDENT
+\-
 T}	T{
 x
 T}	T{
@@ -14943,9 +15344,7 @@ T{
 Predictive
 search
 T}	T{
-.INDENT 0.0
-.IP \(bu 2
-.UNINDENT
+\-
 T}	T{
 x
 T}	T{
@@ -14958,9 +15357,7 @@ T{
 Range
 search
 T}	T{
-.INDENT 0.0
-.IP \(bu 2
-.UNINDENT
+\-
 T}	T{
 x
 T}	T{
@@ -15050,9 +15447,9 @@ more larger total key size.
 .SS Normalizers
 .SS Summary
 .sp
-Groonga has normalizer module. It is used when tokenizing text and
-storing table key. For example, \fBA\fP and \fBa\fP are processed as the
-same character after normalization.
+Groonga has normalizer module that normalizes text. It is used when
+tokenizing text and storing table key. For example, \fBA\fP and \fBa\fP
+are processed as the same character after normalization.
 .sp
 Normalizer module can be added as a plugin. You can customize text
 normalization by registering your normalizer plugins to groonga.
@@ -15150,7 +15547,7 @@ normalized. Because tokens are stored as table keys. Table keys are
 normalized as described above.
 .SS Built\-in normalizers
 .sp
-Here is a list of built\-in\-normalizers:
+Here is a list of built\-in normalizers:
 .INDENT 0.0
 .INDENT 3.5
 .INDENT 0.0
@@ -15167,7 +15564,7 @@ Normally you should use \fBNormalizerAuto\fP
 normalizer. \fBNormalizerAuto\fP was the normalizer for groonga 2.0.9 or
 earlier. \fBKEY_NORMALIZE\fP flag in \fBtable_create\fP on groonga 2.0.9
 or earlier equals to \fB\-\-normalizer NormalizerAuto\fP option in
-\fBtable\fP on groonga 2.1.0 or later.
+\fBtable_create\fP on groonga 2.1.0 or later.
 .sp
 \fBNormalizerAuto\fP supports all encoding. It uses Unicode NFKC
 (Normalization Form Compatibility Composition) for UTF\-8 encoding
@@ -19578,6 +19975,291 @@ now()
 1256791194.55541
 .ft P
 .fi
+.SS query
+.SS Summary
+.sp
+\fBquery\fP enables you to specify \fB\-\-match_columns\fP and \fB\-\-query\fP parameters as
+function arguments.
+.sp
+\fBquery\fP is one of the groonga builtin functions, so you can specify
+multiple \fBquery\fP function as parameters of \fB\-\-filter\fP option.
+.sp
+Because of such flexibility, you can control full text search behavior
+by combination of multiple \fBquery\fP function.
+.sp
+\fBquery\fP can be used in only \fB\-\-filter\fP in \fB/reference/commands/select\fP.
+.SS Syntax
+.sp
+\fBquery\fP requires two arguments \- \fBmatch_column\fP and \fBquery_string\fP.
+.sp
+.nf
+.ft C
+query(match_column, query_string)
+.ft P
+.fi
+.SS Usage
+.sp
+Here are a schema definition and sample data to show usage.
+.sp
+Sample schema:
+.sp
+Execution example:
+.sp
+.nf
+.ft C
+table_create Documents TABLE_NO_KEY
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Documents content COLUMN_SCALAR Text
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+table_create Terms TABLE_PAT_KEY|KEY_NORMALIZE ShortText \-\-default_tokenizer TokenBigram
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Terms documents_content_index COLUMN_INDEX|WITH_POSITION Documents content
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+table_create Users TABLE_NO_KEY
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Users name COLUMN_SCALAR ShortText
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Users memo COLUMN_SCALAR ShortText
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+table_create Lexicon TABLE_HASH_KEY ShortText \e
+  \-\-default_tokenizer TokenBigramSplitSymbolAlphaDigit \e
+  \-\-normalizer NormalizerAuto
+column_create Lexicon users_name COLUMN_INDEX|WITH_POSITION Users name
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Lexicon users_memo COLUMN_INDEX|WITH_POSITION Users memo
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+.ft P
+.fi
+.sp
+Sample data:
+.sp
+Execution example:
+.sp
+.nf
+.ft C
+load \-\-table Users
+[
+{"name": "Alice", "memo": "groonga user"},
+{"name": "Alisa", "memo": "mroonga user"},
+{"name": "Bob",   "memo": "rroonga user"},
+{"name": "Tom",   "memo": "nroonga user"},
+{"name": "Tobby", "memo": "groonga and mroonga user. mroonga is ..."},
+]
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+# [[0, 1337566253.89858, 0.000355720520019531], 5]
+.ft P
+.fi
+.sp
+Here is the simple usage of \fBquery\fP function which execute full text
+search by keyword \(aqalice\(aq without using \fB\-\-match_column\fP and
+\fB\-\-query\fP arguments in \fB\-\-filter\fP.
+.sp
+Execution example:
+.sp
+.nf
+.ft C
+select Users \-\-output_columns name,_score \-\-filter \(aqquery("name * 10", "alice")\(aq
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         1
+#       ],
+#       [
+#         [
+#           "name",
+#           "ShortText"
+#         ],
+#         [
+#           "_score",
+#           "Int32"
+#         ]
+#       ],
+#       [
+#         "Alice",
+#         10
+#       ]
+#     ]
+#   ]
+# ]
+.ft P
+.fi
+.sp
+When executing above query, the keyword \(aqalice\(aq is weighted to the value \-
+\(aq10\(aq.
+.sp
+Here are the contrasting examples with/without \fBquery\fP.
+.sp
+Execution example:
+.sp
+.nf
+.ft C
+select Users \-\-output_columns name,memo,_score \-\-match_columns "memo * 10" \-\-query "memo:@groonga OR memo:@mroonga OR memo:@user" \-\-sortby \-_score
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         5
+#       ],
+#       [
+#         [
+#           "name",
+#           "ShortText"
+#         ],
+#         [
+#           "memo",
+#           "ShortText"
+#         ],
+#         [
+#           "_score",
+#           "Int32"
+#         ]
+#       ],
+#       [
+#         "Tobby",
+#         "groonga and mroonga user. mroonga is ...",
+#         4
+#       ],
+#       [
+#         "Alice",
+#         "groonga user",
+#         2
+#       ],
+#       [
+#         "Alisa",
+#         "mroonga user",
+#         2
+#       ],
+#       [
+#         "Bob",
+#         "rroonga user",
+#         1
+#       ],
+#       [
+#         "Tom",
+#         "nroonga user",
+#         1
+#       ]
+#     ]
+#   ]
+# ]
+.ft P
+.fi
+.sp
+In this case, the keywords \(aqgroonga\(aq and \(aqmroonga\(aq and \(aquser\(aq are
+given same weight value.
+You can\(aqt pass different weight value to each keyword in this way.
+.sp
+Execution example:
+.sp
+.nf
+.ft C
+select Users \-\-output_columns name,memo,_score \-\-filter \(aqquery("memo * 10", "groonga") || query("memo * 20", "mroonga") || query("memo * 1", "user")\(aq \-\-sortby \-_score
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         5
+#       ],
+#       [
+#         [
+#           "name",
+#           "ShortText"
+#         ],
+#         [
+#           "memo",
+#           "ShortText"
+#         ],
+#         [
+#           "_score",
+#           "Int32"
+#         ]
+#       ],
+#       [
+#         "Tobby",
+#         "groonga and mroonga user. mroonga is ...",
+#         51
+#       ],
+#       [
+#         "Alisa",
+#         "mroonga user",
+#         21
+#       ],
+#       [
+#         "Alice",
+#         "groonga user",
+#         11
+#       ],
+#       [
+#         "Tom",
+#         "nroonga user",
+#         1
+#       ],
+#       [
+#         "Bob",
+#         "rroonga user",
+#         1
+#       ]
+#     ]
+#   ]
+# ]
+.ft P
+.fi
+.sp
+On the other hand, by specifying multiple \fBquery\fP, the keywords
+\(aqgroonga\(aq and \(aqmroonga\(aq and \(aquser\(aq are given different value of weight.
+.sp
+As a result, you can control full text search result by giving different weight to the
+keywords on your purpose.
+.SS Parameters
+.sp
+There are two required parameter, \fBmatch_column\fP and \fBquery_string\fP.
+.SS \fBmatch_column\fP
+.INDENT 0.0
+.INDENT 3.5
+It specifies \fBmatch_column\fP equivalent parameter.
+.UNINDENT
+.UNINDENT
+.sp
+See \fIselect\-match\-columns\fP about match_column.
+.SS \fBquery_string\fP
+.INDENT 0.0
+.INDENT 3.5
+It specifies \fBquery\fP equivalent parameter.
+.UNINDENT
+.UNINDENT
+.sp
+See \fIselect\-query\fP about query string.
+.SS Return value
+.sp
+\fBquery\fP returns a value of boolean (true or false).
+.SS TODO
+.INDENT 0.0
+.IP \(bu 2
+Support query_expansion
+.IP \(bu 2
+Support query_flags
+.UNINDENT
+.SS See also
+.INDENT 0.0
+.IP \(bu 2
+\fB/reference/commands/select\fP
+.UNINDENT
 .SS rand
 .SS 名前
 .sp
@@ -22574,8 +23256,6 @@ Here are command lines to send pull request:
 Now you can send pull request on GitHub. You just access
 your repository page on GitHub and press \fIPull Request\fP
 button.
-.IP "See also"
-.sp
 \fI\%Help.GitHub - Sending pull requests\fP.
 .RE
 .SS How to send patch
@@ -22592,20 +23272,12 @@ Here are command lines to create patch:
 .sp
 You can find 000X\-YYY.patch files in the current
 directory. Please send those files to us!
-.IP "See also"
-.sp
-\fB/community\fP describes our contact information.
-.RE
 .SS How to send .po files
 .sp
 Please archive doc/locale/${LANGUAGE}/LC_MESSAGES/ (Please
 substitute \fI${LANGUAGE}\fP with your language code such as
 \(aqja\(aq.) and send it to us! We extract and merge them to the
 groonga repository.
-.IP "See also"
-.sp
-\fB/community\fP describes our contact information.
-.RE
 .SS How to add new language
 .sp
 Here are command lines to add new translation language:
@@ -22619,8 +23291,6 @@ Here are command lines to add new translation language:
 .sp
 Please substitute \fI${LANGUAGE}\fP with your language code such
 as \(aqja\(aq.
-.IP "See also"
-.sp
 \fI\%Codes for the Representation of Names of Languages\fP.
 .RE
 .INDENT 0.0
@@ -22634,7 +23304,7 @@ as \(aqja\(aq.
 .SH AUTHOR
 groonga project
 .SH COPYRIGHT
-2009-2012, Brazil, Inc
+2009-2013, Brazil, Inc
 .\" Generated by docutils manpage writer.
 .\"
 .