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

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