RubyGems - rroonga - Versions diffs - 5.0.1-x86-mingw32 → 5.0.2-x86-mingw32 - Mend

rroonga 5.0.1-x86-mingw32 → 5.0.2-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 (731) hide show

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

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "GROONGA" "1" "March 31, 2015" "5.0.2" "Groonga"
+.TH "GROONGA" "1" "April 28, 2015" "5.0.3" "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\-5.0.2\-x86.exe\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-5.0.3\-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\-5.0.2\-x64.exe\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-5.0.3\-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\-5.0.2\-x86.zip\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-5.0.3\-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\-5.0.2\-x64.zip\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-5.0.3\-x64.zip\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -169,7 +169,7 @@ Windows. Here are required tools:
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fI\%Microsoft Visual Studio 2010 Express\fP
+\fI\%Microsoft Visual Studio Express 2013 for Windows Desktop\fP
 .IP \(bu 2
 \fI\%CMake\fP
 .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\-5.0.2.zip\fP
+\fI\%http://packages.groonga.org/source/groonga/groonga\-5.0.3.zip\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -194,21 +194,21 @@ Move to the Groonga\(aqs source folder:
 .sp
 .nf
 .ft C
-> cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-5.0.2
+> cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-5.0.3
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
 Configure by \fBcmake\fP\&. The following commnad line is for 64\-bit
-version. To build 32\-bit version, use \fB\-G "Visual Studio 10"\fP
+version. To build 32\-bit version, use \fB\-G "Visual Studio 12 2013"\fP
 parameter instead:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-groonga\-5.0.2> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\egroonga
+groonga\-5.0.3> cmake . \-G "Visual Studio 12 2013 Win64" \-DCMAKE_INSTALL_PREFIX=C:\eGroonga
 .ft P
 .fi
 .UNINDENT
@@ -220,7 +220,7 @@ Build:
 .sp
 .nf
 .ft C
-groonga\-5.0.2> cmake \-\-build . \-\-config Release
+groonga\-5.0.3> cmake \-\-build . \-\-config Release
 .ft P
 .fi
 .UNINDENT
@@ -232,14 +232,14 @@ Install:
 .sp
 .nf
 .ft C
-groonga\-5.0.2> cmake \-\-build . \-\-config Release \-\-target Install
+groonga\-5.0.3> cmake \-\-build . \-\-config Release \-\-target Install
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-After the above steps, \fB/reference/executables/groonga\fP is found in
-\fBc:\egroonga\ebin\egroonga.exe\fP\&.
+After the above steps, \fB/reference/executables/groonga\fP is found at
+\fBc:\eGroonga\ebin\egroonga.exe\fP\&.
 .SS Mac OS X
 .sp
 This section describes how to install Groonga on Mac OS X. You can
@@ -294,9 +294,9 @@ Download source:
 .sp
 .nf
 .ft C
-% curl \-O http://packages.groonga.org/source/groonga/groonga\-5.0.2.tar.gz
-% tar xvzf groonga\-5.0.2.tar.gz
-% cd groonga\-5.0.2
+% curl \-O http://packages.groonga.org/source/groonga/groonga\-5.0.3.tar.gz
+% tar xvzf groonga\-5.0.3.tar.gz
+% cd groonga\-5.0.3
 .ft P
 .fi
 .UNINDENT
@@ -429,7 +429,7 @@ Install groonga\-token\-filter\-stem package:
 .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:
 .INDENT 0.0
@@ -444,7 +444,121 @@ Install groonga\-munin\-plugins package:
 .UNINDENT
 .sp
 There is a package that provides MySQL compatible normalizer as
-groonga plugins.
+a Groonga plugin.
+If you want to use that one, install groonga\-normalizer\-mysql package.
+.sp
+Install groonga\-normalizer\-mysql package:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% sudo apt\-get install \-y \-V groonga\-normalizer\-mysql
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS jessie
+.sp
+New in version 5.0.3.
+.sp
+Add the Groonga apt repository.
+.sp
+/etc/apt/sources.list.d/groonga.list:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+deb http://packages.groonga.org/debian/ jessie main
+deb\-src http://packages.groonga.org/debian/ jessie main
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Install:
+.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 \-V groonga
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+\fBNOTE:\fP
+.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 two packages for server use.
+.INDENT 0.0
+.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.
+.UNINDENT
+.UNINDENT
+.sp
+If you want to use \fI\%MeCab\fP as a
+tokenizer, install groonga\-tokenizer\-mecab package.
+.sp
+Install groonga\-tokenizer\-mecab package:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% sudo apt\-get install \-y \-V groonga\-tokenizer\-mecab
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+If you want to use \fBTokenFilterStem\fP as a token filter, install
+groonga\-token\-filter\-stem package.
+.sp
+Install groonga\-token\-filter\-stem package:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% sudo apt\-get install \-y \-V groonga\-token\-filter\-stem
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+There is a package that provides \fI\%Munin\fP plugins. If you want to monitor
+Groonga status by Munin, install groonga\-munin\-plugins package.
+.sp
+Install groonga\-munin\-plugins package:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% sudo apt\-get install \-y \-V groonga\-munin\-plugins
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+There is a package that provides MySQL compatible normalizer as
+a Groonga plugin.
 If you want to use that one, install groonga\-normalizer\-mysql package.
 .sp
 Install groonga\-normalizer\-mysql package:
@@ -478,9 +592,9 @@ Download source:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-5.0.2.tar.gz
-% tar xvzf groonga\-5.0.2.tar.gz
-% cd groonga\-5.0.2
+% wget http://packages.groonga.org/source/groonga/groonga\-5.0.3.tar.gz
+% tar xvzf groonga\-5.0.3.tar.gz
+% cd groonga\-5.0.3
 .ft P
 .fi
 .UNINDENT
@@ -546,6 +660,8 @@ Here are supported Ubuntu versions:
 14.04 LTS Trusty Tahr
 .IP \(bu 2
 14.10 Utopic Unicorn
+.IP \(bu 2
+15.04 Vivid Vervet
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -638,7 +754,7 @@ Install groonga\-token\-filter\-stem package:
 .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:
 .INDENT 0.0
@@ -653,7 +769,7 @@ Install groonga\-munin\-plugins package:
 .UNINDENT
 .sp
 There is a package that provides MySQL compatible normalizer as
-Groonga plugins.
+a Groonga plugin.
 If you want to use that one, install groonga\-normalizer\-mysql package.
 .sp
 Install groonga\-normalizer\-mysql package:
@@ -687,9 +803,9 @@ Download source:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-5.0.2.tar.gz
-% tar xvzf groonga\-5.0.2.tar.gz
-% cd groonga\-5.0.2
+% wget http://packages.groonga.org/source/groonga/groonga\-5.0.3.tar.gz
+% tar xvzf groonga\-5.0.3.tar.gz
+% cd groonga\-5.0.3
 .ft P
 .fi
 .UNINDENT
@@ -856,7 +972,7 @@ Install groonga\-munin\-plugins package:
 .UNINDENT
 .sp
 There is a package that provides MySQL compatible normalizer as
-Groonga plugins.
+a Groonga plugin.
 If you want to use that one, install groonga\-normalizer\-mysql package.
 .sp
 Install groonga\-normalizer\-mysql package:
@@ -958,7 +1074,7 @@ Install groonga\-munin\-plugins package:
 .UNINDENT
 .sp
 There is a package that provides MySQL compatible normalizer as
-Groonga plugins.
+a Groonga plugin.
 If you want to use that one, install groonga\-normalizer\-mysql package.
 .sp
 Install groonga\-normalizer\-mysql package:
@@ -1060,7 +1176,7 @@ Install groonga\-munin\-plugins package:
 .UNINDENT
 .sp
 There is a package that provides MySQL compatible normalizer as
-Groonga plugins.
+a Groonga plugin.
 If you want to use that one, install groonga\-normalizer\-mysql package.
 .sp
 Install groonga\-normalizer\-mysql package:
@@ -1094,9 +1210,9 @@ Download source:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-5.0.2.tar.gz
-% tar xvzf groonga\-5.0.2.tar.gz
-% cd groonga\-5.0.2
+% wget http://packages.groonga.org/source/groonga/groonga\-5.0.3.tar.gz
+% tar xvzf groonga\-5.0.3.tar.gz
+% cd groonga\-5.0.3
 .ft P
 .fi
 .UNINDENT
@@ -1263,7 +1379,7 @@ Install groonga\-munin\-plugins package:
 .UNINDENT
 .sp
 There is a package that provides MySQL compatible normalizer as
-Groonga plugins.
+a Groonga plugin.
 If you want to use that one, install groonga\-normalizer\-mysql package.
 .sp
 Install groonga\-normalizer\-mysql package:
@@ -1297,9 +1413,9 @@ Download source:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-5.0.2.tar.gz
-% tar xvzf groonga\-5.0.2.tar.gz
-% cd groonga\-5.0.2
+% wget http://packages.groonga.org/source/groonga/groonga\-5.0.3.tar.gz
+% tar xvzf groonga\-5.0.3.tar.gz
+% cd groonga\-5.0.3
 .ft P
 .fi
 .UNINDENT
@@ -1364,9 +1480,9 @@ Download source:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-5.0.2.tar.gz
-% gtar xvzf groonga\-5.0.2.tar.gz
-% cd groonga\-5.0.2
+% wget http://packages.groonga.org/source/groonga/groonga\-5.0.3.tar.gz
+% gtar xvzf groonga\-5.0.3.tar.gz
+% cd groonga\-5.0.3
 .ft P
 .fi
 .UNINDENT
@@ -1458,7 +1574,7 @@ Here are optional tools:
 detecting libraries
 .IP \(bu 2
 \fI\%sudo\fP for installing built
-groonga
+Groonga
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -1506,9 +1622,9 @@ steps:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-5.0.2.tar.gz
-% tar xvzf groonga\-5.0.2.tar.gz
-% cd groonga\-5.0.2
+% wget http://packages.groonga.org/source/groonga/groonga\-5.0.3.tar.gz
+% tar xvzf groonga\-5.0.3.tar.gz
+% cd groonga\-5.0.3
 % ./configure
 % make
 % sudo make install
@@ -1520,7 +1636,7 @@ steps:
 After the above steps, \fB/reference/executables/groonga\fP is found in
 \fB/usr/local/bin/groonga\fP\&.
 .sp
-The default build will work well but you can customize groonga at
+The default build will work well but you can customize Groonga at
 \fBconfigure\fP step.
 .sp
 The following describes details about each step.
@@ -1668,7 +1784,7 @@ installed with \fB\-\-prefix=/usr\fP, you need to specify this option with
 path that you use for building MessagePack.
 .sp
 If you installed MessagePack with \fB\-\-prefix=$HOME/local\fP option, you
-sholud specify \fB\-\-with\-message\-pack=$HOME/local\fP to groonga\(aqs
+should specify \fB\-\-with\-message\-pack=$HOME/local\fP to Groonga\(aqs
 \fBconfigure\fP\&.
 .sp
 The default is \fB/usr\fP\&.
@@ -1729,7 +1845,7 @@ files:
 Shows all \fBconfigure\fP options.
 .SS \fBmake\fP
 .sp
-\fBconfigure\fP is succeeded, you can build groonga by \fBmake\fP:
+\fBconfigure\fP is succeeded, you can build Groonga by \fBmake\fP:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -5267,17 +5383,21 @@ Execution example:
 .sp
 .nf
 .ft C
+table_create \-\-name GeoSite \-\-flags TABLE_HASH_KEY \-\-key_type ShortText
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create \-\-table GeoSite \-\-name location \-\-type WGS84GeoPoint
+# [[0, 1337566253.89858, 0.000355720520019531], true]
 table_create \-\-name GeoIndex \-\-flags TABLE_PAT_KEY \-\-key_type WGS84GeoPoint
 # [[0, 1337566253.89858, 0.000355720520019531], true]
-column_create \-\-table GeoIndex \-\-name index_point \-\-type Site \-\-flags COLUMN_INDEX \-\-source location
+column_create \-\-table GeoIndex \-\-name index_point \-\-type GeoSite \-\-flags COLUMN_INDEX \-\-source location
 # [[0, 1337566253.89858, 0.000355720520019531], true]
-load \-\-table Site
+load \-\-table GeoSite
 [
  {"_key":"http://example.org/","location":"128452975x503157902"},
  {"_key":"http://example.net/","location":"128487316x502920929"}
 ]
 # [[0, 1337566253.89858, 0.000355720520019531], 2]
-select \-\-table Site \-\-filter \(aqgeo_in_circle(location, "128515259x503187188", 5000)\(aq \-\-output_columns _key,location
+select \-\-table GeoSite \-\-filter \(aqgeo_in_circle(location, "128515259x503187188", 5000)\(aq \-\-output_columns _key,location
 # [
 #   [
 #     0,
@@ -5319,7 +5439,7 @@ Execution example:
 .sp
 .nf
 .ft C
-select \-\-table Site \-\-filter \(aqgeo_in_circle(location, "128515259x503187188", 50000)\(aq \-\-output_columns _key,location,_score \-\-sortby \(aq\-geo_distance(location, "128515259x503187188")\(aq \-\-scorer \(aq_score = geo_distance(location, "128515259x503187188")\(aq
+select \-\-table GeoSite \-\-filter \(aqgeo_in_circle(location, "128515259x503187188", 50000)\(aq \-\-output_columns _key,location,_score \-\-sortby \(aq\-geo_distance(location, "128515259x503187188")\(aq \-\-scorer \(aq_score = geo_distance(location, "128515259x503187188")\(aq
 # [
 #   [
 #     0,
@@ -8420,10 +8540,70 @@ TODO
 .sp
 TODO
 .SS GQTP
+.SS Summary
 .sp
-TODO
+GQTP is the acronym standing for "Groonga Query Transfer Protocol".
+.sp
+GQTP is a protocol designed for Groonga. It\(aqs a stateful
+protocol. You can send multiple commands in one session.
+.sp
+GQTP will be faster rather than \fB/server/http\fP when you send many
+light commands like \fB/reference/commands/status\fP\&. GQTP will be
+almost same performance as HTTP when you send heavy commands like
+\fB/reference/commands/select\fP\&.
+.sp
+We recommend that you use HTTP for many cases. Because there are many
+HTTP client libraries.
+.sp
+If you want to use GQTP, you can use the following libraries:
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.IP \(bu 2
+Ruby: \fI\%groonga\-client\fP
+.IP \(bu 2
+Python: \fI\%poyonga\fP
+.IP \(bu 2
+Go: \fI\%goroo\fP
+.IP \(bu 2
+PHP: \fI\%proonga\fP
+.IP \(bu 2
+C/C++: Groonga (Groonga can be also used as library)
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.sp
+It\(aqs not a library but you can use
+\fB/reference/executables/groonga\fP as a GQTP client.
+.SS How to run
+.sp
+\fB/reference/executables/groonga\fP is a GQTP server implementation.
+You can run a Groonga server by the following command line:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+groonga \-\-protocol gqtp \-s [options] DB_PATH
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
 .sp
-See \fB/reference/executables/groonga\fP\&.
+You can run a Groonga server as a daemon by the following command
+line:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+groonga \-\-protocol gqtp \-d [options] DB_PATH
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+See \fB/reference/executables/groonga\fP for available \fBoptions\fP\&.
 .SS Memcached binary protocol
 .sp
 Groonga supports the memcached binary protocol. The following form shows how to run Groonga as a memcached binary protocol server daemon.
@@ -8640,20 +8820,259 @@ gqtpでリクエストします。gqtpのリクエストをLF区切り形式で
 .fi
 .UNINDENT
 .UNINDENT
-.SS groonga command
+.SS \fBgroonga\fP executable file
 .SS Summary
 .sp
-groonga \- 列指向データベース機能を持つ全文検索エンジンソフトウェア
+\fBgroonga\fP executable file provides the following features:
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.IP \(bu 2
+Fulltext search server
+.IP \(bu 2
+Fulltext search shell
+.IP \(bu 2
+Client for Groonga fulltext search server
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.sp
+Groonga can be used as a library. If you want to use Groonga as a
+library, you need to write a program in C, C++ and so on. Library use
+is useful for embedding fulltext search feature to your application,
+but it\(aqs not easy to use.
+.sp
+You can use \fBgroonga\fP executable file to get fulltext search
+feature.
 .sp
-Groongaは列指向のデータベース機能を持つ高速でスケーラブルな全文検索エンジンです。
-Groongaのデータベースは、groongaコマンドかCライブラリインタフェースを通して操作することができます。このマニュアルページでは、groongaコマンドの使い方について説明します。
+If you want to try Groonga, fulltext search shell usage is useful. You
+don\(aqt need any server and client. You just need one terminal. You can
+try Groonga like the following:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% groonga \-n db
+> status
+[[0,1429687763.70845,0.000115633010864258],{"alloc_count":195,...}]
+> quit
+%
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+If you want to create an application that has fulltext search feature,
+fulltext search server usage is useful. You can use Groonga as a
+server like RDBMS (Relational DataBase Management
+System). Client\-server model is a popular architecture.
+.sp
+Normally, client for Groonga fulltext server usage isn\(aqt used.
 .SS Syntax
+.sp
+\fBgroonga\fP executable file has the following four modes:
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.IP \(bu 2
+Standalone mode
+.IP \(bu 2
+Server mode
+.IP \(bu 2
+Daemon mode
+.IP \(bu 2
+Client mode
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.sp
+There are common options in these modes. These common options is
+described later section.
+.SS Standalone mode
+.sp
+In standalone mode, \fBgroonga\fP executable file runs one or more
+Groonga \fB/reference/command\fP against a local Groonga database.
+.sp
+Here is the syntax to run shell that executes Groonga command against
+temporary database:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+groonga [options]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Here is the syntax to create a new database and run shell that
+executes Groonga command against the new database:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+groonga [options] \-n DB_PATH
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Here is the syntax to run shell that executes Groonga command against
+existing database:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+groonga [options] DB_PATH
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Here is the syntax to run Groonga command against existing database
+and exit:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+groonga [options] DB_PATH COMMAND [command arguments]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS Server mode
+.sp
+In server mode, \fBgroonga\fP executable file runs as a server. The
+server accepts connections from other processes at local machine or
+remote machine and executes received Groonga \fB/reference/command\fP
+against a local Groonga database.
+.sp
+You can choose one protocol from \fB/server/http\fP and
+\fB/server/gqtp\fP\&. Normally, HTTP is suitable but GQTP is the
+default protocol. This section describes only about HTTP protocol
+usage.
+.sp
+In server mode, \fBgroonga\fP executable file runs in the foreground. If
+you want to run Groonga server in the background, see
+\fIgroonga\-executable\-file\-server\-mode\fP\&.
+.sp
+Here is the syntax to run Groonga server with temporary database:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+groonga [options] \-\-protocol http \-s
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Here is the syntax to create a new database and run Groonga server
+with the new database:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+groonga [options] \-\-protocol http \-s \-n DB_PATH
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Here is the syntax to run Groonga server with existing database:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+groonga [options] \-\-protocol http \-s DB_PATH
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS Daemon mode
+.sp
+In daemon mode, \fBgroonga\fP executable file runs as a daemon. Daemon
+is similar to server but it runs in the background. See
+\fI_groonga\-executable\-file\-daemon\-mode\fP about server.
+.sp
+Here is the syntax to run Groonga daemon with temporary database:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+groonga [options] \-\-protocol http \-d
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Here is the syntax to create a new database and run Groonga daemon
+with the new database:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+groonga [options] \-\-protocol http \-d \-n DB_PATH
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Here is the syntax to run Groonga daemon with existing database:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-groonga [options] [dest] [command [args]]
+groonga [options] \-\-protocol http \-d DB_PATH
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+\fI\-\-pid\-file\fP option will be useful for daemon mode.
+.SS Client mode
+.sp
+In client mode, \fBgroonga\fP executable file runs as a client for GQTP
+protocol Groonga server. Its usage is similar to
+\fIgroonga\-executable\-file\-standalone\-mode\fP\&. You can run shell and
+execute one command. You need to specify server address instead of
+local database.
+.sp
+Note that you can use \fBgroonga\fP executable file as a client for HTTP
+protocol Groonga server.
+.sp
+Here is the syntax to run shell that executes Groonga command against
+Groonga server that is running at \fB192.168.0.1:10043\fP:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+groonga [options] \-c \-\-host 192.168.0.1 \-\-port 10043
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Here is the syntax to run Groonga command against Groonga server that
+is running at \fB192.168.0.1:10043\fP and exit:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+groonga [options] \-c \-\-host 192.168.0.1 \-\-port 10043 COMMAND [command arguments]
 .ft P
 .fi
 .UNINDENT
@@ -13197,76 +13616,201 @@ dumpが出力するフォーマットは直接Groongaが解釈できるフォー
 .nf
 .ft C
 dump [tables]
+     [dump_plugins]
+     [dump_schema]
+     [dump_records]
+     [dump_indexes]
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .SS Usage
 .sp
-データベース内のすべてのデータを出力:
+Here is the sample schema and data to check dump behaviour:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+plugin_register token_filters/stop_word
+table_create Bookmarks TABLE_HASH_KEY ShortText
+column_create Bookmarks title COLUMN_SCALAR ShortText
+table_create Lexicon TABLE_PAT_KEY ShortText
+table_create Sites TABLE_NO_KEY
+column_create Sites url COLUMN_SCALAR ShortText
+column_create Lexicon bookmark_title COLUMN_INDEX Bookmarks title
+load \-\-table Bookmarks
+[
+{"_key":"Groonga", "title":"Introduction to Groonga"},
+{"_key":"Mroonga", "title":"Introduction to Mroonga"}
+]
+load \-\-table Sites
+[
+{"_key": 1, "url":"http://groonga.org"},
+{"_key": 2, "url":"http://mroonga.org"}
+]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Dump all data in database:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
 > dump
-table_create LocalNames 48 ShortText
-table_create Entries 48 ShortText
-column_create Entries local_name 0 LocalNames
-column_create LocalNames Entries_local_name 2 Entries local_name
-\&...
-load \-\-table LocalNames
+plugin_register token_filters/stop_word
+table_create Sites TABLE_NO_KEY
+column_create Sites url COLUMN_SCALAR ShortText
+table_create Bookmarks TABLE_HASH_KEY ShortText
+column_create Bookmarks title COLUMN_SCALAR ShortText
+table_create Lexicon TABLE_PAT_KEY ShortText
+load \-\-table Sites
 [
-["_key"],
-["Items"],
-["BLT"],
-\&...
+["_id","url"],
+[1,"http://groonga.org"],
+[2,"http://mroonga.org"]
 ]
-\&...
+load \-\-table Bookmarks
+[
+["_key","title"],
+["Groonga","Introduction to Groonga"],
+["Mroonga","Introduction to Mroonga"]
+]
+create Lexicon bookmark_title COLUMN_INDEX Bookmarks title
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-データベース内のスキーマと特定のテーブルのデータのみ出力:
+Dump schema and specific table data:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-> dump \-\-tables Users,Sites
-table_create Users TABLE_HASH_KEY ShortText
-column_create Users name COLUMN_SCALAR ShortText
-table_create Comments TABLE_PAT_KEY ShortText
-column_create Comments text COLUMN_SCALAR ShortText
+> dump Bookmarks
+plugin_register token_filters/stop_word
 table_create Sites TABLE_NO_KEY
 column_create Sites url COLUMN_SCALAR ShortText
-load \-\-table Users
+table_create Bookmarks TABLE_HASH_KEY ShortText
+column_create Bookmarks title COLUMN_SCALAR ShortText
+table_create Lexicon TABLE_PAT_KEY ShortText
+load \-\-table Bookmarks
 [
-["_key"],
-["mori"],
-["yu"],
-\&...
+["_key","title"],
+["Groonga","Introduction to Groonga"],
+["Mroonga","Introduction to Mroonga"]
 ]
+column_create Lexicon bookmark_title COLUMN_INDEX Bookmarks title
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Dump plugin only:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+> dump \-\-dump_schema no \-\-dump_records no \-\-dump_indexes no
+plugin_register token_filters/stop_word
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Dump records only:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+> dump \-\-dump_schema no \-\-dump_plugins no \-\-dump_indexes no
 load \-\-table Sites
 [
 ["_id","url"],
-[1,"http://groonga.org/"],
-[2,"http://qwik.jp/senna/"],
-\&...
+[1,"http://groonga.org"],
+[2,"http://mroonga.org"]
 ]
+load \-\-table Bookmarks
+[
+["_key","title"],
+["Groonga","Introduction to Groonga"],
+["Mroonga","Introduction to Mroonga"]
+]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Dump schema only:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+> dump \-\-dump_records no \-\-dump_plugins no \-\-dump_indexes no
+table_create Sites TABLE_NO_KEY
+column_create Sites url COLUMN_SCALAR ShortText
+table_create Bookmarks TABLE_HASH_KEY ShortText
+column_create Bookmarks title COLUMN_SCALAR ShortText
+table_create Lexicon TABLE_PAT_KEY ShortText
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .SS Parameters
 .sp
-\fBtables\fP
+There are optional parameters.
+.SS Optional parameters
+.SS \fBtables\fP
 .INDENT 0.0
 .INDENT 3.5
 出力対象のテーブルを「,」（カンマ）区切りで指定します。存在しないテーブルを指定した場合は無視されます。
 .UNINDENT
 .UNINDENT
+.SS \fBdump_plugins\fP
+.sp
+You can customize the output whether it contains registered plugins or not.
+To exclude registered plugins from the output, specify \fBno\fP\&.
+.sp
+The default value is \fByes\fP\&.
+.SS \fBdump_schema\fP
+.sp
+You can customize the output whether it contains database schema or not.
+To exclude database schema from the output, specify \fBno\fP\&.
+.sp
+The default value is \fByes\fP\&.
+.SS \fBdump_records\fP
+.sp
+You can customize the output whether it contains records or not.
+To exclude records from the output, specify \fBno\fP\&.
+.sp
+The default value is \fByes\fP\&.
+.SS \fBdump_indexes\fP
+.sp
+You can customize the output whether it contains indexes or not.
+To exclude indexes from the output, specify \fBno\fP\&.
+.sp
+The default value is \fByes\fP\&.
 .SS Return value
 .sp
 データベースのスキーマとデータをGroongaの組み込みコマンド呼び出し形式で出力します。output_type指定は無視されます。
@@ -14703,7 +15247,7 @@ request may be ignored.
 .sp
 You can send cancel request for the same request ID multiple times. If
 the target request is canceled or finished, \fB"canceled"\fP value is
-changed to \fBfalse\fP from \fBtrue\fP:
+changed to \fBfalse\fP from \fBtrue\fP in return value:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -27411,7 +27955,8 @@ SCORE_FUNCTION(COLUMN, ARGUMENT1, ARGUMENT2, ...) * WEIGHT
 .UNINDENT
 .UNINDENT
 .sp
-You can use different score function for each match column:
+You can use different score function for each
+\fIselect\-match\-columns\fP:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -35830,6 +36375,144 @@ more records are matched, it returns \fBtrue\fP\&. Otherwise, it returns
 .IP \(bu 2
 \fB/reference/grn_expr/script_syntax\fP
 .UNINDENT
+.SS vector_size
+.SS Summary
+.sp
+New in version 5.0.3.
+.sp
+\fBvector_size\fP returns the value of vector column size.
+.sp
+To enable this function, register \fBfunctions/vector\fP plugin by following the command:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+plugin_register functions/vector
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Then, use \fBvector_size\fP function with \fB\-\-command_version 2\fP option.
+.SS Syntax
+.sp
+\fBvector_size\fP requires one argument \- \fBtarget\fP\&.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+vector_size(target)
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS Usage
+.sp
+Here is a schema definition and sample data.
+.sp
+Sample schema:
+.sp
+Execution example:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+table_create Memos TABLE_HASH_KEY ShortText
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Memos tags COLUMN_VECTOR ShortText
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Sample data:
+.sp
+Execution example:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+load \-\-table Memos
+[
+{"_key": "Groonga",          "tags": ["Groonga"]},
+{"_key": "Rroonga",          "tags": ["Groonga", "Ruby"]},
+{"_key": "Nothing"}
+]
+# [[0, 1337566253.89858, 0.000355720520019531], 3]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Here is the simple usage of \fBvector_size\fP function which returns tags and size \- the value of \fBtags\fP column and size of it.
+.sp
+Execution example:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+select Memos \-\-output_columns \(aqtags, vector_size(tags)\(aq \-\-command_version 2
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         3
+#       ],
+#       [
+#         [
+#           "tags",
+#           "ShortText"
+#         ],
+#         [
+#           "vector_size",
+#           "Object"
+#         ]
+#       ],
+#       [
+#         [
+#           "Groonga"
+#         ],
+#         1
+#       ],
+#       [
+#         [
+#           "Groonga",
+#           "Ruby"
+#         ],
+#         2
+#       ],
+#       [
+#         [],
+#         0
+#       ]
+#     ]
+#   ]
+# ]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS Parameters
+.sp
+There is one required parameter, \fBtarget\fP\&.
+.SS \fBtarget\fP
+.sp
+Specifies a vector column of table that is specified by \fBtable\fP parameter in \fBselect\fP\&.
+.SS Return value
+.sp
+\fBvector_size\fP returns the value of target vector column size.
 .SS Operations
 .sp
 Groonga has the multiple search operations. This section describes
@@ -41556,8 +42239,12 @@ Execution example:
 .UNINDENT
 .UNINDENT
 .SS See also
-.sp
-TODO
+.INDENT 0.0
+.IP \(bu 2
+\fB/reference/executables/groonga\fP
+.IP \(bu 2
+\fB/server/gqtp\fP
+.UNINDENT
 .SS 検索
 .sp
 \fB/reference/commands/select\fP コマンドがqueryパラメータを使ってどのように検索するのかを説明します。
@@ -42901,14 +43588,19 @@ CUTTER_SOURCE_PATH=$HOME/work/cutter/cutter
 .UNINDENT
 .UNINDENT
 .sp
-rinseのバージョンが古いとCentOS 5/6パッケージのビルドを行うことができません。
-別途debパッケージを以下のコマンドを実行して最新版をインストールします。:
+Debian系（.deb）やRed Hat系（.rpm）パッケージのビルドには \fI\%Vagrant\fP を使用します。apt\-getでインストールできるのは古いバージョンなので、Webサイトから最新版をダウンロードしてインストールすることをおすすめします。
+.sp
+Vagrantで使用する仮想化ソフトウェア（VirtualBox、VMwareなど）がない場合、合わせてインストールしてください。なお、VirtualBoxはsources.listにcontribセクションを追加すればapt\-getでインストールできます。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% sudo dpkg \-i rinse_1.9.2\-1_all.deb
+% cat /etc/apt/sources.list
+deb http://ftp.jp.debian.org/debian/ sid main contrib
+deb\-src http://ftp.jp.debian.org/debian/ sid main contrib
+% sudo apt\-get update
+% sudo apt\-get install virtualbox
 .ft P
 .fi
 .UNINDENT
@@ -43501,8 +44193,8 @@ Debian系もしくはRed Hat系の場合には本番環境へとアップロー
 .sp
 .nf
 .ft C
-% ruby1.9.1 \-run \-e httpd \-\- packages/yum/repositories (yumの場合)
-% ruby1.9.1 \-run \-e httpd \-\- packages/apt/repositories (aptの場合)
+% ruby \-run \-e httpd \-\- packages/yum/repositories (yumの場合)
+% ruby \-run \-e httpd \-\- packages/apt/repositories (aptの場合)
 .ft P
 .fi
 .UNINDENT
@@ -43715,6 +44407,27 @@ Windows向けのパッケージのアップロードには以下のコマンド
 .UNINDENT
 .sp
 アップロードが正常終了すると、リリース対象のリポジトリデータやパッケージ、アーカイブ等がpackages.groonga.orgへと反映されます。
+.SS Ubuntu用パッケージのアップロード
+.sp
+Ubuntu向けのパッケージのアップロードには以下のコマンドを実行します。:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% cd packages/ubuntu
+% make upload
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+アップロードが正常終了すると、launchpad.net上でビルドが実行され、ビルド結果がメールで通知されます。ビルドに成功すると、リリース対象のパッケージがlaunchpad.netのGroongaチームのPPAへと反映されます。公開されているパッケージは以下のURLで確認できます。
+.INDENT 0.0
+.INDENT 3.5
+\fI\%https://launchpad.net/~groonga/+archive/ubuntu/ppa\fP
+.UNINDENT
+.UNINDENT
 .SS blogroonga(ブログ)の更新
 .sp
 \fI\%http://groonga.org/blog/\fP および \fI\%http://groonga.org/blog/\fP にて公開されているリリース案内を作成します。
@@ -43724,19 +44437,19 @@ Windows向けのパッケージのアップロードには以下のコマンド
 cloneしたWebサイトのソースに対して以下のファイルを新規追加します。
 .INDENT 0.0
 .IP \(bu 2
-groonga.org/en/_post/(リリース日)\-release.textile
+groonga.org/en/_post/(リリース日)\-release.md
 .IP \(bu 2
-groonga.org/ja/_post/(リリース日)\-release.textile
+groonga.org/ja/_post/(リリース日)\-release.md
 .UNINDENT
 .sp
-編集した内容をpushする前に確認したい場合にはjekyllおよびRedClothが必要です。
+編集した内容をpushする前に確認したい場合にはJekyllおよびRedCloth（Textileパーサー）、RDiscount（Markdownパーサー）、JavaScript interpreter（therubyracer、Node.jsなど）が必要です。
 インストールするには以下のコマンドを実行します。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% sudo gem1.9.1 install jekyll RedCloth
+% sudo gem install jekyll RedCloth rdiscount therubyracer
 .ft P
 .fi
 .UNINDENT
@@ -43759,7 +44472,7 @@ jekyllのインストールを行ったら、以下のコマンドでローカ
 \fBNOTE:\fP
 .INDENT 0.0
 .INDENT 3.5
-記事を非公開の状態でアップロードするには.textileファイルのpublished:をfalseに設定します。:
+記事を非公開の状態でアップロードするには.mdファイルのpublished:をfalseに設定します。:
 .INDENT 0.0
 .INDENT 3.5
 .sp