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

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

@@ -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.
 .\" 
 .