rroonga 3.1.0-x64-mingw32 → 3.1.1-x64-mingw32

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

@@ -1,4 +1,4 @@
-.TH "GROONGA" "1" "November 27, 2013" "3.1.0" "Groonga"
+.TH "GROONGA" "1" "December 27, 2013" "3.1.1" "Groonga"
 .SH NAME
 groonga \- Groonga documentation
 .
@@ -37,23 +37,23 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .SH CHARACTERISTICS OF GROONGA
 .SS Groonga overview
 .sp
-Groonga is a fast and accurate full text search engine based on inverted index. One of the characteristics of groonga is that a newly registered document instantly appears in search results. Also, groonga allows updates without read locks. These characteristics result in superior performance on real\-time applications.
+Groonga is a fast and accurate full text search engine based on inverted index. One of the characteristics of Groonga is that a newly registered document instantly appears in search results. Also, Groonga allows updates without read locks. These characteristics result in superior performance on real\-time applications.
 .sp
-Groonga is also a column\-oriented database management system (DBMS). Compared with well\-known row\-oriented systems, such as MySQL and PostgreSQL, column\-oriented systems are more suited for aggregate queries. Due to this advantage, groonga can cover weakness of row\-oriented systems.
+Groonga is also a column\-oriented database management system (DBMS). Compared with well\-known row\-oriented systems, such as MySQL and PostgreSQL, column\-oriented systems are more suited for aggregate queries. Due to this advantage, Groonga can cover weakness of row\-oriented systems.
 .sp
-The basic functions of groonga are provided in a C library. Also, libraries for using groonga in other languages, such as Ruby, are provided by related projects. In addition, groonga\-based storage engines are provided for MySQL and PostgreSQL. These libraries and storage engines allow any application to use groonga. See \fI\%usage examples\fP.
+The basic functions of Groonga are provided in a C library. Also, libraries for using Groonga in other languages, such as Ruby, are provided by related projects. In addition, groonga\-based storage engines are provided for MySQL and PostgreSQL. These libraries and storage engines allow any application to use Groonga. See \fI\%usage examples\fP.
 .SS Full text search and Instant update
 .sp
 In widely used DBMSs, updates are immediately processed, for example, a newly registered record appears in the result of the next query. In contrast, some full text search engines do not support instant updates, because it is difficult to dynamically update inverted indexes, the underlying data structure.
 .sp
-Groonga also uses inverted indexes but supports instant updates. In addition, groonga allows you to search documents even when updating the document collection. Due to these superior characteristics, groonga is very flexible as a full text search engine. Also, groonga always shows good performance because it divides a large task, inverted index merging, into smaller tasks.
+Groonga also uses inverted indexes but supports instant updates. In addition, Groonga allows you to search documents even when updating the document collection. Due to these superior characteristics, Groonga is very flexible as a full text search engine. Also, Groonga always shows good performance because it divides a large task, inverted index merging, into smaller tasks.
 .SS Column store and aggregate query
 .sp
 People can collect more than enough data in the Internet era. However, it is difficult to extract informative knowledge from a large database, and such a task requires a many\-sided analysis through trial and error. For example, search refinement by date, time and location may reveal hidden patterns. Aggregate queries are useful to perform this kind of tasks.
 .sp
 An aggregate query groups search results by specified column values and then counts the number of records in each group. For example, an aggregate query in which a location column is specified counts the number of records per location. Making a graph from the result of an aggregate query against a date column is an easy way to visualize changes over time. Also, a combination of refinement by location and an aggregate query against a date column allows visualization of changes over time in specific location. Thus refinement and aggregation are important to perform data mining.
 .sp
-A column\-oriented architecture allows groonga to efficiently process aggregate queries because a column\-oriented database, which stores records by column, allows an aggregate query to access only a specified column. On the other hand, an aggregate query on a row\-oriented database, which stores records by row, has to access neighbor columns, even though those columns are not required.
+A column\-oriented architecture allows Groonga to efficiently process aggregate queries because a column\-oriented database, which stores records by column, allows an aggregate query to access only a specified column. On the other hand, an aggregate query on a row\-oriented database, which stores records by row, has to access neighbor columns, even though those columns are not required.
 .SS Inverted index and tokenizer
 .sp
 An inverted index is a traditional data structure used for large\-scale full text search. A search engine based on inverted index extracts index terms from a document when it is added. Then in retrieval, a query is divided into index terms to find documents containing those index terms. In this way, index terms play an important role in full text search and thus the way of extracting index terms is a key to a better search engine.
@@ -65,21 +65,21 @@ Groonga supports both word and n\-gram tokenizers. The simplest built\-in tokeni
 .sp
 Multi\-core processors are mainstream today and the number of cores per processor is increasing. In order to exploit multiple cores, executing multiple queries in parallel or dividing a query into sub\-queries for parallel processing is becoming more important.
 .sp
-A database of groonga can be shared with multiple threads/processes. Also, multiple threads/processes can execute read queries in parallel even when another thread/process is executing an update query because groonga uses read lock\-free data structures. This feature is suited to a real\-time application that needs to update a database while executing read queries. In addition, groonga allows you to build flexible systems. For example, a database can receive read queries through the built\-in HTTP server of groonga while accepting update queries through MySQL.
+A database of Groonga can be shared with multiple threads/processes. Also, multiple threads/processes can execute read queries in parallel even when another thread/process is executing an update query because Groonga uses read lock\-free data structures. This feature is suited to a real\-time application that needs to update a database while executing read queries. In addition, Groonga allows you to build flexible systems. For example, a database can receive read queries through the built\-in HTTP server of Groonga while accepting update queries through MySQL.
 .SS Geo\-location (latitude and longitude) search
 .sp
 Location services are getting more convenient because of mobile devices with GPS. For example, if you are going to have lunch or dinner at a nearby restaurant, a local search service for restaurants may be very useful, and for such services, fast geo\-location search is becoming more important.
 .sp
-Groonga provides inverted index\-based fast geo\-location search, which supports a query to find points in a rectangle or circle. Groonga gives high priority to points near the center of an area. Also, groonga supports distance measurement and you can sort points by distance from any point.
+Groonga provides inverted index\-based fast geo\-location search, which supports a query to find points in a rectangle or circle. Groonga gives high priority to points near the center of an area. Also, Groonga supports distance measurement and you can sort points by distance from any point.
 .SS Groonga library
 .sp
-The basic functions of groonga are provided in a C library and any application can use groonga as a full text search engine or a column\-oriented database. Also, libraries for languages other than C/C++, such as Ruby, are provided in related projects. See \fI\%related projects\fP for details.
+The basic functions of Groonga are provided in a C library and any application can use Groonga as a full text search engine or a column\-oriented database. Also, libraries for languages other than C/C++, such as Ruby, are provided in related projects. See \fI\%related projects\fP for details.
 .SS Groonga server
 .sp
-Groonga provides a built\-in server command which supports HTTP, the memcached binary protocol and the groonga query transfer protocol (gqtp). Also, a groonga server supports query caching, which significantly reduces response time for repeated read queries. Using this command, groonga is available even on a server that does not allow you to install new libraries.
+Groonga provides a built\-in server command which supports HTTP, the memcached binary protocol and the Groonga Query Transfer Protocol (GQTP). Also, a Groonga server supports query caching, which significantly reduces response time for repeated read queries. Using this command, Groonga is available even on a server that does not allow you to install new libraries.
 .SS Groonga storage engine
 .sp
-Groonga works not only as an independent column\-oriented DBMS but also as storage engines of well\-known DBMSs. For example, \fI\%mroonga\fP is a MySQL pluggable storage engine using groonga. By using mroonga, you can use groonga for column\-oriented storage and full text search. A combination of a built\-in storage engine, MyISAM or InnoDB, and a groonga\-based full text search engine is also available. All the combinations have good and bad points and the best one depends on the application. See \fI\%related projects\fP for details.
+Groonga works not only as an independent column\-oriented DBMS but also as storage engines of well\-known DBMSs. For example, \fI\%mroonga\fP is a MySQL pluggable storage engine using Groonga. By using mroonga, you can use Groonga for column\-oriented storage and full text search. A combination of a built\-in storage engine, MyISAM or InnoDB, and a groonga\-based full text search engine is also available. All the combinations have good and bad points and the best one depends on the application. See \fI\%related projects\fP for details.
 .SH INSTALL
 .sp
 This section describes how to install groonga on each
@@ -110,7 +110,7 @@ packages.groonga.org:
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fI\%http://packages.groonga.org/windows/groonga/groonga\-3.1.0\-x86.exe\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-3.1.1\-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\-3.1.0\-x64.exe\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-3.1.1\-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\-3.1.0\-x86.zip\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-3.1.1\-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\-3.1.0\-x64.zip\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-3.1.1\-x64.zip\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -181,7 +181,7 @@ Download zipped source from packages.groonga.org:
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fI\%http://packages.groonga.org/source/groonga/groonga\-3.1.0.zip\fP
+\fI\%http://packages.groonga.org/source/groonga/groonga\-3.1.1.zip\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -194,7 +194,7 @@ Move to the Groonga\(aqs source folder:
 .sp
 .nf
 .ft C
-> cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-3.1.0
+> cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-3.1.1
 .ft P
 .fi
 .UNINDENT
@@ -208,7 +208,7 @@ parameter instead:
 .sp
 .nf
 .ft C
-groonga\-3.1.0> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\egroonga
+groonga\-3.1.1> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\egroonga
 .ft P
 .fi
 .UNINDENT
@@ -220,7 +220,7 @@ Build:
 .sp
 .nf
 .ft C
-groonga\-3.1.0> cmake \-\-build . \-\-config Release
+groonga\-3.1.1> cmake \-\-build . \-\-config Release
 .ft P
 .fi
 .UNINDENT
@@ -232,7 +232,7 @@ Install:
 .sp
 .nf
 .ft C
-groonga\-3.1.0> cmake \-\-build . \-\-config Release \-\-target Install
+groonga\-3.1.1> cmake \-\-build . \-\-config Release \-\-target Install
 .ft P
 .fi
 .UNINDENT
@@ -286,9 +286,9 @@ Download source:
 .sp
 .nf
 .ft C
-% curl \-O http://packages.groonga.org/source/groonga/groonga\-3.1.0.tar.gz
-% tar xvzf groonga\-3.1.0.tar.gz
-% cd groonga\-3.1.0
+% curl \-O http://packages.groonga.org/source/groonga/groonga\-3.1.1.tar.gz
+% tar xvzf groonga\-3.1.1.tar.gz
+% cd groonga\-3.1.1
 .ft P
 .fi
 .UNINDENT
@@ -360,83 +360,6 @@ groonga\-server\-gqtp (GQTP protocol based server package)
 See \fB/server\fP section about details.
 .UNINDENT
 .UNINDENT
-.SS squeeze
-.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/ squeeze main
-deb\-src http://packages.groonga.org/debian/ squeeze main
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-Install:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo aptitude update
-% sudo aptitude \-V \-D \-y \-\-allow\-untrusted install groonga\-keyring
-% sudo aptitude update
-% sudo aptitude \-V \-D \-y install groonga
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-If you want to use \fI\%MeCab\fP as a
-tokenizer, install groonga\-tokenizer\-mecab package.
-.sp
-Install groonga\-tokenizer\-mecab package:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo aptitude \-V \-D \-y install groonga\-tokenizer\-mecab
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-There is a package that provides \fI\%Munin\fP plugins. If you want to monitor
-groonga status by Munin, install groonga\-munin\-plugins package.
-.sp
-Install groonga\-munin\-plugins package:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo aptitude \-V \-D \-y install groonga\-munin\-plugins
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-There is a package that provides MySQL compatible normalizer as
-groonga plugins.
-If you want to use that one, install groonga\-normalizer\-mysql package.
-.sp
-Install groonga\-normalizer\-mysql package:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo aptitude \-V \-D \-y install groonga\-normalizer\-mysql
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
 .SS wheezy
 .sp
 Add the groonga apt repository.
@@ -688,9 +611,9 @@ Download source:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-3.1.0.tar.gz
-% tar xvzf groonga\-3.1.0.tar.gz
-% cd groonga\-3.1.0
+% wget http://packages.groonga.org/source/groonga/groonga\-3.1.1.tar.gz
+% tar xvzf groonga\-3.1.1.tar.gz
+% cd groonga\-3.1.1
 .ft P
 .fi
 .UNINDENT
@@ -762,101 +685,6 @@ groonga\-server\-gqtp (GQTP protocol based server package)
 See \fB/server\fP section about details.
 .UNINDENT
 .UNINDENT
-.SS 10.04 LTS Lucid Lynx
-.sp
-\fBNOTE:\fP
-.INDENT 0.0
-.INDENT 3.5
-Enable the universe repository to install groonga:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo cp /etc/apt/sources.list /etc/apt/sources.list.d/universe.list
-% sudo sed \-i\(aq\(aq \-e \(aqs/main/universe/\(aq /etc/apt/sources.list.d/universe.list
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.UNINDENT
-.UNINDENT
-.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/ubuntu/ lucid universe
-deb\-src http://packages.groonga.org/ubuntu/ lucid universe
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-Install:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo apt\-get update
-% sudo apt\-get \-y \-\-allow\-unauthenticated install groonga\-keyring
-% sudo apt\-get update
-% sudo apt\-get \-y install groonga
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-If you want to use \fI\%MeCab\fP as a
-tokenizer, install groonga\-tokenizer\-mecab package.
-.sp
-Install groonga\-tokenizer\-mecab package:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo apt\-get \-y install groonga\-tokenizer\-mecab
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-There is a package that provides \fI\%Munin\fP plugins. If you want to monitor
-groonga status by Munin, install groonga\-munin\-plugins package.
-.sp
-Install groonga\-munin\-plugins package:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo apt\-get \-y install groonga\-munin\-plugins
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-There is a package that provides MySQL compatible normalizer as
-groonga plugins.
-If you want to use that one, install groonga\-normalizer\-mysql package.
-.sp
-Install groonga\-normalizer\-mysql package:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo apt\-get \-y install groonga\-normalizer\-mysql
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
 .SS 12.04 LTS Precise Pangolin
 .sp
 \fBNOTE:\fP
@@ -1239,9 +1067,9 @@ Download source:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-3.1.0.tar.gz
-% tar xvzf groonga\-3.1.0.tar.gz
-% cd groonga\-3.1.0
+% wget http://packages.groonga.org/source/groonga/groonga\-3.1.1.tar.gz
+% tar xvzf groonga\-3.1.1.tar.gz
+% cd groonga\-3.1.1
 .ft P
 .fi
 .UNINDENT
@@ -1579,9 +1407,9 @@ Download source:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-3.1.0.tar.gz
-% tar xvzf groonga\-3.1.0.tar.gz
-% cd groonga\-3.1.0
+% wget http://packages.groonga.org/source/groonga/groonga\-3.1.1.tar.gz
+% tar xvzf groonga\-3.1.1.tar.gz
+% cd groonga\-3.1.1
 .ft P
 .fi
 .UNINDENT
@@ -1666,7 +1494,7 @@ groonga\-server\-gqtp (GQTP protocol based server package)
 See \fB/server\fP section about details.
 .UNINDENT
 .UNINDENT
-.SS Fedora
+.SS Fedora 20
 .sp
 Install:
 .INDENT 0.0
@@ -1786,9 +1614,9 @@ Download source:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-3.1.0.tar.gz
-% tar xvzf groonga\-3.1.0.tar.gz
-% cd groonga\-3.1.0
+% wget http://packages.groonga.org/source/groonga/groonga\-3.1.1.tar.gz
+% tar xvzf groonga\-3.1.1.tar.gz
+% cd groonga\-3.1.1
 .ft P
 .fi
 .UNINDENT
@@ -1853,9 +1681,9 @@ Download source:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-3.1.0.tar.gz
-% gtar xvzf groonga\-3.1.0.tar.gz
-% cd groonga\-3.1.0
+% wget http://packages.groonga.org/source/groonga/groonga\-3.1.1.tar.gz
+% gtar xvzf groonga\-3.1.1.tar.gz
+% cd groonga\-3.1.1
 .ft P
 .fi
 .UNINDENT
@@ -1995,9 +1823,9 @@ steps:
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-3.1.0.tar.gz
-% tar xvzf groonga\-3.1.0.tar.gz
-% cd groonga\-3.1.0
+% wget http://packages.groonga.org/source/groonga/groonga\-3.1.1.tar.gz
+% tar xvzf groonga\-3.1.1.tar.gz
+% cd groonga\-3.1.1
 % ./configure
 % make
 % sudo make install
@@ -2292,11 +2120,11 @@ install\fP:
 .UNINDENT
 .SH COMMUNITY
 .sp
-There are some places for sharing groonga information.
+There are some places for sharing Groonga information.
 We welcome you to join our community.
 .SS Mailing List
 .sp
-There are mailing lists for discussion about groonga.
+There are mailing lists for discussion about Groonga.
 .INDENT 0.0
 .TP
 .B For English speakers
@@ -2307,24 +2135,24 @@ There are mailing lists for discussion about groonga.
 .UNINDENT
 .SS Twitter
 .sp
-\fI\%@groonga\fP tweets groonga related
+\fI\%@groonga\fP tweets Groonga related
 information.
 .sp
-Please follow the account to get the latest groonga related
+Please follow the account to get the latest Groonga related
 information!
 .SS Facebook
 .sp
-\fI\%groonga page on Facebook\fP shares
-groonga related information.
+\fI\%Groonga page on Facebook\fP shares
+Groonga related information.
 .sp
-Please like the page to get the latest groonga related information!
+Please like the page to get the latest Groonga related information!
 .SH TUTORIAL
 .SS Basic operations
 .sp
-A groonga package provides a C library (libgroonga) and a command line tool (groonga). This tutorial explains how to use the command line tool, with which you can create/operate databases, start a server, establish a connection with a server, etc.
+A Groonga package provides a C library (libgroonga) and a command line tool (groonga). This tutorial explains how to use the command line tool, with which you can create/operate databases, start a server, establish a connection with a server, etc.
 .SS Create a database
 .sp
-The first step to using groonga is to create a new database. The following shows how to do it.
+The first step to using Groonga is to create a new database. The following shows how to do it.
 .sp
 Form:
 .INDENT 0.0
@@ -2340,7 +2168,7 @@ groonga \-n DB_PATH
 .sp
 The \fI\-n\fP option specifies to create a new database and DB_PATH specifies the path of the new database. Actually, a database consists of a series of files and DB_PATH specifies the file which will be the entrance to the new database. DB_PATH also specifies the path prefix for other files. Note that database creation fails if DB_PATH points to an existing file.
 .sp
-This command creates a new database and then enters into interactive mode in which groonga prompts you to enter commands for operating that database. You can terminate this mode with Ctrl\-d.
+This command creates a new database and then enters into interactive mode in which Groonga prompts you to enter commands for operating that database. You can terminate this mode with Ctrl\-d.
 .sp
 Execution example:
 .INDENT 0.0
@@ -2373,7 +2201,7 @@ groonga DB_PATH [COMMAND]
 .sp
 DB_PATH specifies the path of a target database. This command fails if the specified database does not exist.
 .sp
-If COMMAND is specified, groonga executes COMMAND and returns the result. Otherwise, groonga starts in interactive mode that reads commands from the standard input and executes them one by one. This tutorial focuses on the interactive mode.
+If COMMAND is specified, Groonga executes COMMAND and returns the result. Otherwise, Groonga starts in interactive mode that reads commands from the standard input and executes them one by one. This tutorial focuses on the interactive mode.
 .sp
 Let\(aqs see the status of a groonga process by using a \fB/reference/commands/status\fP command.
 .sp
@@ -2396,10 +2224,10 @@ status
 #     "max_command_version": 2,
 #     "n_queries": 0,
 #     "cache_hit_rate": 0.0,
-#     "version": "3.1.0",
-#     "alloc_count": 159,
+#     "version": "3.1.1",
+#     "alloc_count": 160,
 #     "command_version": 1,
-#     "starttime": 1385359899,
+#     "starttime": 1387938935,
 #     "default_command_version": 1
 #   }
 # ]
@@ -2438,7 +2266,7 @@ For details, see also the paragraph of "command" in \fB/reference/executables/gr
 .INDENT 0.0
 .TP
 .B \fB/reference/commands/status\fP
-shows status of a groonga process.
+shows status of a Groonga process.
 .TP
 .B \fB/reference/commands/table_list\fP
 shows a list of tables in a database.
@@ -2526,7 +2354,7 @@ select \-\-table Site
 .sp
 When only a table name is specified with a \fItable\fP parameter, a \fB/reference/commands/select\fP command returns the first (at most) 10 records in the table. [0] in the result shows the number of records in the table. The next array is a list of columns. ["_id","Uint32"] is a column of UInt32, named _id. ["_key","ShortText"] is a column of ShortText, named _key.
 .sp
-The above two columns, _id and _key, are the necessary columns. The _id column stores IDs those are automatically allocated by groonga. The _key column is associated with the primary key. You are not allowed to rename these columns.
+The above two columns, _id and _key, are the necessary columns. The _id column stores IDs those are automatically allocated by Groonga. The _key column is associated with the primary key. You are not allowed to rename these columns.
 .SS Create a column
 .sp
 A \fB/reference/commands/column_create\fP command creates a new column.
@@ -2839,7 +2667,7 @@ The \fItable\fP parameter specifies the index table and the \fIname\fP parameter
 \fBNOTE:\fP
 .INDENT 0.0
 .INDENT 3.5
-You can create a lexicon table and index columns before/during/after loading records. If a target column already has records, groonga creates an inverted index in a static manner. In contrast, if you load records into an already indexed column, groonga updates the inverted index in a dynamic manner.
+You can create a lexicon table and index columns before/during/after loading records. If a target column already has records, Groonga creates an inverted index in a static manner. In contrast, if you load records into an already indexed column, Groonga updates the inverted index in a dynamic manner.
 .UNINDENT
 .UNINDENT
 .SS Full text search
@@ -3447,11 +3275,11 @@ footnote
 Currently, a \fImatch_columns\fP parameter is available iff there exists an inverted index for full text search. A \fImatch_columns\fP parameter for a regular column is not supported.
 .SS Remote access
 .sp
-You can use groonga as a server which allows remote access. Groonga supports the original protocol (gqtp), the memcached binary protocol and HTTP.
-.SS Groonga query transfer protocol (gqtp)
-.SS How to run a gqtp server
+You can use Groonga as a server which allows remote access. Groonga supports the original protocol (GQTP), the memcached binary protocol and HTTP.
+.SS Groonga Query Transfer Protocol (GQTP)
+.SS How to run a GQTP server
 .sp
-Groonga has a special protocol, named groonga query transfer ptorotocl (gqtp), for remote access to a database. The following form shows how to run groonga as a gqtp server.
+Groonga has a special protocol, named Groonga Query Transfer Protocol (GQTP), for remote access to a database. The following form shows how to run Groonga as a GQTP server.
 .sp
 Form:
 .INDENT 0.0
@@ -3465,7 +3293,7 @@ groonga [\-p PORT_NUMBER] \-s DB_PATH
 .UNINDENT
 .UNINDENT
 .sp
-The \fI\-s\fP option specifies to run groonga as a server. DB_PATH specifies the path of the existing database to be hosted. The \fI\-p\fP option and its argument, PORT_NUMBER, specify the port number of the server. The default port number is 10041, which is used when you don\(aqt specify PORT_NUMBER.
+The \fI\-s\fP option specifies to run Groonga as a server. DB_PATH specifies the path of the existing database to be hosted. The \fI\-p\fP option and its argument, PORT_NUMBER, specify the port number of the server. The default port number is 10041, which is used when you don\(aqt specify PORT_NUMBER.
 .sp
 The following command runs a server that listens on the default port number. The server accepts operations to the specified database.
 .sp
@@ -3482,9 +3310,9 @@ Ctrl\-c
 .fi
 .UNINDENT
 .UNINDENT
-.SS How to run a gqtp daemon
+.SS How to run a GQTP daemon
 .sp
-You can also run a gqtp server as a daemon by using the \fI\-d\fP option, instead of the \fI\-s\fP option.
+You can also run a GQTP server as a daemon by using the \fI\-d\fP option, instead of the \fI\-s\fP option.
 .sp
 Form:
 .INDENT 0.0
@@ -3498,7 +3326,7 @@ groonga [\-p PORT_NUMBER] \-d DB_PATH
 .UNINDENT
 .UNINDENT
 .sp
-A groonga daemon prints its process ID as follows. In this example, the process ID is 12345. Then, the daemon opens a specified database and accepts operations to that database.
+A Groonga daemon prints its process ID as follows. In this example, the process ID is 12345. Then, the daemon opens a specified database and accepts operations to that database.
 .sp
 Execution example:
 .INDENT 0.0
@@ -3513,9 +3341,9 @@ Execution example:
 .fi
 .UNINDENT
 .UNINDENT
-.SS How to run a gqtp client
+.SS How to run a GQTP client
 .sp
-You can run groonga as a gqtp client as follows:
+You can run Groonga as a GQTP client as follows:
 .sp
 Form:
 .INDENT 0.0
@@ -3529,7 +3357,7 @@ groonga [\-p PORT_NUMBER] \-c [HOST_NAME_OR_IP_ADDRESS]
 .UNINDENT
 .UNINDENT
 .sp
-This command establishes a connection with a gqtp server and then enters into interactive mode. HOST_NAME_OR_IP_ADDRESS specifies the hostname or the IP address of the server. If not specifed, groonga uses the default hostname "localhost". The \fI\-p\fP option and its argument, PORT_NUMBER, specify the port number of the server. If not specified, groonga uses the default port number 10041.
+This command establishes a connection with a GQTP server and then enters into interactive mode. HOST_NAME_OR_IP_ADDRESS specifies the hostname or the IP address of the server. If not specified, Groonga uses the default hostname "localhost". The \fI\-p\fP option and its argument, PORT_NUMBER, specify the port number of the server. If not specified, Groonga uses the default port number 10041.
 .sp
 Execution example:
 .INDENT 0.0
@@ -3550,10 +3378,10 @@ status
 #     "max_command_version": 2,
 #     "n_queries": 0,
 #     "cache_hit_rate": 0.0,
-#     "version": "3.1.0",
-#     "alloc_count": 138,
+#     "version": "3.1.1",
+#     "alloc_count": 139,
 #     "command_version": 1,
-#     "starttime": 1385359920,
+#     "starttime": 1387938957,
 #     "default_command_version": 1
 #   }
 # ]
@@ -3564,10 +3392,10 @@ status
 .UNINDENT
 .UNINDENT
 .sp
-In interactive mode, groonga reads commands from the standard input and executes them one by one.
-.SS How to terminate a gqtp server
+In interactive mode, Groonga reads commands from the standard input and executes them one by one.
+.SS How to terminate a GQTP server
 .sp
-You can terminate a gqtp server with a \fB/reference/commands/shutdown\fP command.
+You can terminate a GQTP server with a \fB/reference/commands/shutdown\fP command.
 .sp
 Execution example:
 .INDENT 0.0
@@ -3584,7 +3412,7 @@ Execution example:
 .UNINDENT
 .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.
+Groonga supports the memcached binary protocol. The following form shows how to run Groonga as a memcached binary protocol server daemon.
 .sp
 Form:
 .INDENT 0.0
@@ -3602,7 +3430,7 @@ The \fI\-\-protocol\fP option and its argument specify the protocol of the serve
 .SS Hypertext transfer protocol (HTTP)
 .SS How to run an HTTP server
 .sp
-Groonga supports the hypertext transfer protocol (HTTP). The following form shows how to run groonga as an HTTP server daemon.
+Groonga supports the hypertext transfer protocol (HTTP). The following form shows how to run Groonga as an HTTP server daemon.
 .sp
 Form:
 .INDENT 0.0
@@ -3666,14 +3494,13 @@ status
 #     "max_command_version": 2,
 #     "n_queries": 0,
 #     "cache_hit_rate": 0.0,
-#     "version": "3.1.0",
-#     "alloc_count": 139,
+#     "version": "3.1.1",
+#     "alloc_count": 140,
 #     "command_version": 1,
-#     "starttime": 1385359920,
+#     "starttime": 1387939627,
 #     "default_command_version": 1
 #   }
 # ]
-
 http://HOST_NAME_OR_IP_ADDRESS[:PORT_NUMBER]/d/select?table=Site&query=title:@this
 Executed command:
 select \-\-table Site \-\-query title:@this
@@ -3745,18 +3572,18 @@ select \-\-table Site \-\-query title:@this
 .UNINDENT
 .SS Administration tool (HTTP)
 .sp
-An HTTP server of groonga provides a browser based administration tool that makes database management easy. After starting an HTTP server, you can use the administration tool by accessing \fI\%http://HOST_NAME_OR_IP_ADDRESS[:PORT_NUMBER]/\fP. Note that Javascript must be enabled for the tool to work properly.
+An HTTP server of Groonga provides a browser based administration tool that makes database management easy. After starting an HTTP server, you can use the administration tool by accessing \fI\%http://HOST_NAME_OR_IP_ADDRESS[:PORT_NUMBER]/\fP. Note that Javascript must be enabled for the tool to work properly.
 .SS Security issues
 .sp
-Groonga servers don\(aqt support user authentication. Everyone can view and modify databases hosted by groonga servers. You are recommended to restrict IP addresses that can access groonga servers. You can use iptables or similar for this purpose.
+Groonga servers don\(aqt support user authentication. Everyone can view and modify databases hosted by Groonga servers. You are recommended to restrict IP addresses that can access Groonga servers. You can use iptables or similar for this purpose.
 .SS Various data types
 .sp
 Groonga is a full text search engine but also serves as a column\-oriented data store. Groonga supports various data types, such as numeric types, string types, date and time type, longitude and latitude types, etc. This tutorial shows a list of data types and explains how to use them.
 .SS Overview
 .sp
-The basic data types of groonga are roughly divided into 5 groups \-\-\- boolean type, numeric types, string types, date/time type and longitude/latitude types. The numeric types are further divided according to whether integer or floating point number, signed or unsigned and the number of bits allocated to each integer. The string types are further divided according to the maximum length. The longitude/latitude types are further divided according to the geographic coordinate system. For more details, see \fB/reference/types\fP.
+The basic data types of Groonga are roughly divided into 5 groups \-\-\- boolean type, numeric types, string types, date/time type and longitude/latitude types. The numeric types are further divided according to whether integer or floating point number, signed or unsigned and the number of bits allocated to each integer. The string types are further divided according to the maximum length. The longitude/latitude types are further divided according to the geographic coordinate system. For more details, see \fB/reference/types\fP.
 .sp
-In addition, groonga supports reference types and vector types. Reference types are designed for accessing other tables. Vector types are designed for storing a variable number of values in one element.
+In addition, Groonga supports reference types and vector types. Reference types are designed for accessing other tables. Vector types are designed for storing a variable number of values in one element.
 .sp
 First, let\(aqs create a table for this tutorial.
 .sp
@@ -3968,13 +3795,13 @@ select \-\-table ToyBox \-\-output_columns _key,name
 .UNINDENT
 .SS Date and time type
 .sp
-The date and time type of groonga is Time. Actually, a Time column stores a date and time as the number of microseconds since the Epoch, 1970\-01\-01 00:00:00. A Time value can represent a date and time before the Epoch because the actual data type is a signed integer. Note that \fB/reference/commands/load\fP and \fB/reference/commands/select\fP commands use a decimal number to represent a data and time in seconds. The default value is 0.0, which means the Epoch.
+The date and time type of Groonga is Time. Actually, a Time column stores a date and time as the number of microseconds since the Epoch, 1970\-01\-01 00:00:00. A Time value can represent a date and time before the Epoch because the actual data type is a signed integer. Note that \fB/reference/commands/load\fP and \fB/reference/commands/select\fP commands use a decimal number to represent a data and time in seconds. The default value is 0.0, which means the Epoch.
 .sp
 \fBNOTE:\fP
 .INDENT 0.0
 .INDENT 3.5
 Groonga internally holds the value of Epoch as pair of integer. The first integer represents the value of seconds, on the other hand, the second integer represents the value of micro seconds.
-So, groonga shows the value of Epoch as floating point. Integral part means the value of seconds, fraction part means the value of micro seconds.
+So, Groonga shows the value of Epoch as floating point. Integral part means the value of seconds, fraction part means the value of micro seconds.
 .UNINDENT
 .UNINDENT
 .sp
@@ -4037,7 +3864,7 @@ select \-\-table ToyBox \-\-output_columns _key,time
 .UNINDENT
 .SS Longitude and latitude types
 .sp
-The longitude and latitude types are divided according to the geographic coordinate system. For more details, see \fB/reference/types\fP. To represent a longitude and latitude, groonga uses a string formatted as follows:
+The longitude and latitude types are divided according to the geographic coordinate system. For more details, see \fB/reference/types\fP. To represent a longitude and latitude, Groonga uses a string formatted as follows:
 .INDENT 0.0
 .IP \(bu 2
 "longitude x latitude" in milliseconds (e.g.: "128452975x503157902")
@@ -4240,7 +4067,7 @@ select \-\-table Site \-\-output_columns _key,title,links._key,links.title \-\-q
 The only difference at the first step is the \fIflags\fP parameter that specifies to create a vector column. The \fItype\fP parameter of the \fB/reference/commands/column_create\fP command is the same as in the previous example. Then, the \fB/reference/commands/load\fP command registers three links from "\fI\%http://example.org/\fP" to "\fI\%http://example.net/\fP", "\fI\%http://example.org/\fP" and "\fI\%http://example.com/\fP". After that, the links are confirmed by the \fB/reference/commands/select\fP command. In this case, the primary keys and the titles are output as arrays because links._key and links.title are specified to the \fIoutput_columns\fP parameter.
 .SS さまざまな検索条件の指定
 .sp
-groongaは、JavaScriptに似た文法での条件絞込や、計算した値を用いたソートを行うことができます。また、位置情報(緯度・経度)を用いた絞込・ソートを行うことができます。
+Groongaは、JavaScriptに似た文法での条件絞込や、計算した値を用いたソートを行うことができます。また、位置情報(緯度・経度)を用いた絞込・ソートを行うことができます。
 .SS JavaScriptに似た文法での絞込・全文検索
 .sp
 selectコマンドのfilterパラメータは、queryパラメータと同様に、レコードの検索条件を指定します。filterパラメータとqueryパラメータが異なる点は、filterパラメータには、JavaScriptの式に似た文法で条件を指定する点です。
@@ -4580,7 +4407,7 @@ _score
 よって、上記のクエリは実行されるたびに検索結果の並び順がランダムに変わります。
 .SS 位置情報を用いた絞込・ソート
 .sp
-groongaでは、位置情報（経緯度）を保存することができます。また、保存した経緯度を用いて絞込やソートができます。
+Groongaでは、位置情報（経緯度）を保存することができます。また、保存した経緯度を用いて絞込やソートができます。
 .sp
 位置情報を保存するためのカラムの型として、TokyoGeoPoint/WGS84GeoPointの２つの型があります。前者は日本測地系、後者は世界測地系(WGS84相当)の経緯度を保存します。
 .sp
@@ -4805,11 +4632,24 @@ select \-\-table Site \-\-output_columns _key,location \-\-filter \(aqgeo_in_cir
 .UNINDENT
 .sp
 また、経緯度が指定の矩形領域内であるかどうかを判定する \fB/reference/functions/geo_in_rectangle\fP 関数も存在します。
-.SS ドリルダウン
+.SS Drilldown
+.sp
+You learned how to filter search results and sort ones in the previous sections.
+Now that you can search as you likes, but how do you summarize the number of records which has specific value in the column?
+.sp
+As you know, there is a naive solution to execute query by every the value of column, then you can get the number of records as a result. It is a simple way, but it is not reasonable to many records.
+.sp
+If you are familiar with SQL, you will doubt with "Is there a similar SQL functionality to \fBGROUP BY\fP in Groonga?".
+.sp
+Of course, Groonga provides such a functionality. It\(aqs called as \fBdrilldown\fP.
+.sp
+\fBdrilldown\fP enables you to get the number of records which belongs to specific the value of column at once.
+.sp
+To illustrate this feature, imagine the case that classification by domain and grouping by country that domain belongs to.
 .sp
-groongaでは、特定のカラム値で検索結果をグループ化することができます。これをドリルダウンと呼びます。
+Here is the concrete examples how to use this feature.
 .sp
-Siteテーブルに２つのカラムを追加します。TLDドメイン名を格納するdomainカラムと、国名を格納するcountryカラムです。これらのカラムの型は、それぞれドメイン名を主キーとするSiteDomainテーブルと、国名を主キーとするSiteCountryテーブルとします。
+In this example, we add two columns to \fBSite\fP table. \fBdomain\fP column is used for TLD (top level domain). \fBcountry\fP column is used for country name. The type of these columns are \fBSiteDomain\fP table which uses domain name as a primary key and \fBSiteCountry\fP table which uses country name as a primary key.
 .sp
 Execution example:
 .INDENT 0.0
@@ -4843,7 +4683,7 @@ load \-\-table Site
 .UNINDENT
 .UNINDENT
 .sp
-domainカラムとcountryカラムでドリルダウンを行う例を以下に示します。
+Here is a example of drilldown with \fBdomain\fP column. Three kind of values are used in \fBdomain\fP column \- ".org", ".net" and ".com".
 .sp
 Execution example:
 .INDENT 0.0
@@ -4932,7 +4772,73 @@ select \-\-table Site \-\-limit 0 \-\-drilldown domain
 .UNINDENT
 .UNINDENT
 .sp
-テーブル型を持つカラムに対してドリルダウンを行った場合、参照先のテーブルに存在するカラム値を取得することもできます。ドリルダウンを行ったテーブルには、_nsubrecsという仮想的なカラムが追加されます。このカラムには、グループ化されたレコード数が入ります。
+Here is a summary of above query.
+.SS Drilldown by \fBdomain\fP column
+.TS
+center;
+|l|l|l|.
+_
+T{
+Group by
+T}	T{
+The number of group records
+T}	T{
+Group records means following records
+T}
+_
+T{
+.org
+T}	T{
+3
+T}	T{
+.INDENT 0.0
+.IP \(bu 2
+\fI\%http://example.org/\fP
+.IP \(bu 2
+\fI\%http://example.org/aba\fP
+.IP \(bu 2
+\fI\%http://example.org/gat\fP
+.UNINDENT
+T}
+_
+T{
+.net
+T}	T{
+3
+T}	T{
+.INDENT 0.0
+.IP \(bu 2
+\fI\%http://example.net/\fP
+.IP \(bu 2
+\fI\%http://example.net/afr\fP
+.IP \(bu 2
+\fI\%http://example.net/atv\fP
+.UNINDENT
+T}
+_
+T{
+.com
+T}	T{
+3
+T}	T{
+.INDENT 0.0
+.IP \(bu 2
+\fI\%http://example.com/\fP
+.IP \(bu 2
+\fI\%http://example.com/rab\fP
+.IP \(bu 2
+\fI\%http://example.com/vdw\fP
+.UNINDENT
+T}
+_
+.TE
+.sp
+The value of drilldown are returned as the value of \fB_nsubrecs\fP column. In this case, \fBSite\fP table is grouped by ".org", ".net", ".com" domain. \fB_nsubrecs\fP shows that each three domain has three records.
+.sp
+If you execute drildown to the column which has table as a type, you can get the value of column which is stored in referenced table.
+\fB_nsubrecs\fP pseudo column is added to the table which is used for drilldown. this pseudo column stores the number of records which is grouped by.
+.sp
+Then, investigate referenced table in detail. As \fBSite\fP table use \fBSiteDomain\fP table as column type of \fBdomain\fP, you can use \fB\-\-drilldown_output_columns\fP to know detail of referenced column.
 .sp
 Execution example:
 .INDENT 0.0
@@ -5028,7 +4934,7 @@ select \-\-table Site \-\-limit 0 \-\-drilldown domain \-\-drilldown_output_colu
 .UNINDENT
 .UNINDENT
 .sp
-複数のカラムに対してドリルダウンを行うことができます。複数のカラムに対してドリルダウンを行う場合には、drilldownパラメータにカラム名をカンマ区切りで与えます。
+Now, you can see detail of each grouped domain, drilldown by \fBcountry\fP column which has ".org" as column value.
 .sp
 Execution example:
 .INDENT 0.0
@@ -5036,7 +4942,7 @@ Execution example:
 .sp
 .nf
 .ft C
-select \-\-table Site \-\-limit 0 \-\-drilldown domain,country
+select \-\-table Site \-\-limit 0 \-\-filter "domain._id == 1" \-\-drilldown country
 # [
 #   [
 #     0,
@@ -5046,7 +4952,7 @@ select \-\-table Site \-\-limit 0 \-\-drilldown domain,country
 #   [
 #     [
 #       [
-#         9
+#         3
 #       ],
 #       [
 #         [
@@ -5098,38 +5004,129 @@ select \-\-table Site \-\-limit 0 \-\-drilldown domain,country
 #         ]
 #       ],
 #       [
-#         ".org",
-#         3
-#       ],
-#       [
-#         ".net",
-#         3
-#       ],
-#       [
-#         ".com",
-#         3
-#       ]
-#     ],
-#     [
-#       [
-#         5
-#       ],
-#       [
-#         [
-#           "_key",
-#           "ShortText"
-#         ],
-#         [
-#           "_nsubrecs",
-#           "Int32"
-#         ]
-#       ],
-#       [
 #         "japan",
-#         3
+#         1
 #       ],
 #       [
-#         "brazil",
+#         "korea",
+#         1
+#       ],
+#       [
+#         "usa",
+#         1
+#       ]
+#     ]
+#   ]
+# ]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS Drilldown with multiple column
+.sp
+Drilldown feature supports multiple column. Use comma separated multiple column names as \fBdrildown\fP parameter.
+You can get the each result of drilldown at once.
+.sp
+Execution example:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+select \-\-table Site \-\-limit 0 \-\-drilldown domain,country
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         9
+#       ],
+#       [
+#         [
+#           "_id",
+#           "UInt32"
+#         ],
+#         [
+#           "_key",
+#           "ShortText"
+#         ],
+#         [
+#           "country",
+#           "SiteCountry"
+#         ],
+#         [
+#           "domain",
+#           "SiteDomain"
+#         ],
+#         [
+#           "link",
+#           "Site"
+#         ],
+#         [
+#           "links",
+#           "Site"
+#         ],
+#         [
+#           "location",
+#           "WGS84GeoPoint"
+#         ],
+#         [
+#           "title",
+#           "ShortText"
+#         ]
+#       ]
+#     ],
+#     [
+#       [
+#         3
+#       ],
+#       [
+#         [
+#           "_key",
+#           "ShortText"
+#         ],
+#         [
+#           "_nsubrecs",
+#           "Int32"
+#         ]
+#       ],
+#       [
+#         ".org",
+#         3
+#       ],
+#       [
+#         ".net",
+#         3
+#       ],
+#       [
+#         ".com",
+#         3
+#       ]
+#     ],
+#     [
+#       [
+#         5
+#       ],
+#       [
+#         [
+#           "_key",
+#           "ShortText"
+#         ],
+#         [
+#           "_nsubrecs",
+#           "Int32"
+#         ]
+#       ],
+#       [
+#         "japan",
+#         3
+#       ],
+#       [
+#         "brazil",
 #         1
 #       ],
 #       [
@@ -5151,8 +5148,9 @@ select \-\-table Site \-\-limit 0 \-\-drilldown domain,country
 .fi
 .UNINDENT
 .UNINDENT
+.SS Sorting drildown results
 .sp
-ドリルダウン結果を並びかえることができます。例えば、_nsubrecsパラメータの降順で並び替えることができます。
+Use \fB\-\-drilldown_sortby\fP if you want to sort the result of drilldown. For example, specify \fB_nsubrecs\fP as ascending order.
 .sp
 Execution example:
 .INDENT 0.0
@@ -5248,8 +5246,9 @@ select \-\-table Site \-\-limit 0 \-\-drilldown country \-\-drilldown_sortby _ns
 .fi
 .UNINDENT
 .UNINDENT
+.SS limits drildown results
 .sp
-ドリルダウン結果は、デフォルトでは10件のみ表示されます。drilldown_offsetパラメータと、drilldown_limitパラメータによって、offsetとlimitを指定することができます。
+The number of drilldown results is limited to 10 as a default. Use \fBdrilldown_limits\fP and \fBdrilldown_offset\fP parameter to customize orilldown results.
 .sp
 Execution example:
 .INDENT 0.0
@@ -5337,9 +5336,9 @@ select \-\-table Site \-\-limit 0 \-\-drilldown country \-\-drilldown_sortby _ns
 文字列型のカラムに対するドリルダウンは、他の型でのドリルダウンに比べて低速です。文字列でのドリルダウンを行いたい場合には、このチュートリアルのように、文字列型を主キーとするテーブルを別途作成し、そのテーブルを型とするカラムを作成します。
 .SS タグ検索・参照関係の逆引き
 .sp
-本チュートリアルで、groongaはカラム値として他のテーブルへの参照の配列を持つことができることを紹介いたしました。実は、テーブルへの参照の配列データを用いることによって、いわゆるタグ検索を行うことが可能となります。
+本チュートリアルで、Groongaはカラム値として他のテーブルへの参照の配列を持つことができることを紹介いたしました。実は、テーブルへの参照の配列データを用いることによって、いわゆるタグ検索を行うことが可能となります。
 .sp
-タグ検索はgroongaの転置インデックスというデータ構造を用いて高速に行われます。
+タグ検索はGroongaの転置インデックスというデータ構造を用いて高速に行われます。
 .SS タグ検索
 .sp
 動画共有サイトの検索エンジンを作ることを想定します。1つの動画には、その動画の特徴を表す、複数の語句が付与されています。「ある語句が付与されている動画の一覧を取得する」検索を行いたいとします。
@@ -5503,7 +5502,7 @@ select \-\-table Video \-\-query tags:@Animation \-\-output_columns _key,title
 このように、「Variety」、「Sports」、「Animation」のようなタグで検索を行うことができました。
 .SS 参照関係の逆引き
 .sp
-groongaはテーブル間の参照関係の逆引きを高速に行うためのインデックスを付与することができます。タグ検索は、その1例にすぎません。
+Groongaはテーブル間の参照関係の逆引きを高速に行うためのインデックスを付与することができます。タグ検索は、その1例にすぎません。
 .sp
 例えば、ソーシャルネットワーキングサイトにおける友人関係を逆引き検索することができます。
 .sp
@@ -5831,9 +5830,9 @@ select \-\-table Site \-\-filter \(aqgeo_in_circle(location, "128515259x50318718
 .SS match_columnsパラメータ
 .SS 複数のカラムを対象とした全文検索
 .sp
-groongaでは、複数のカラムを対象とした全文検索を行うことができます。例えば、ブログのテーブルで、タイトルと内容とがそれぞれ別のカラムに入ったものがあるとしましょう。「タイトルもしくは内容に特定の単語を含む」検索を行いたいとします。
+Groongaでは、複数のカラムを対象とした全文検索を行うことができます。例えば、ブログのテーブルで、タイトルと内容とがそれぞれ別のカラムに入ったものがあるとしましょう。「タイトルもしくは内容に特定の単語を含む」検索を行いたいとします。
 .sp
-この場合、2つのインデックス作成方式があります。1つは、それぞれのカラムに1つずつインデックスを付与する方式です。もう1つは、複数のカラムに対して1つのインデックスを付与する方式です。groongaでは、どちらの形式のインデックスが存在している場合でも、同一の記法で全文検索を行うことができます。
+この場合、2つのインデックス作成方式があります。1つは、それぞれのカラムに1つずつインデックスを付与する方式です。もう1つは、複数のカラムに対して1つのインデックスを付与する方式です。Groongaでは、どちらの形式のインデックスが存在している場合でも、同一の記法で全文検索を行うことができます。
 .SS カラムごとにインデックスを付与する場合
 .sp
 Blog1テーブルを作り、タイトル文字列のtitleカラム、本文のmessageカラムを追加しています。
@@ -6557,7 +6556,7 @@ On the other hand, the second one matches one article only because of Replies2 t
 執筆中です。
 .SS パトリシア木による前方一致検索
 .sp
-groongaのテーブルは、テーブル作成時にパトリシア木オプションを指定すると、前方一致検索を行うことができます。また、追加のオプションを指定することにより、主キーの後方一致検索をも行うことができます。
+Groongaのテーブルは、テーブル作成時にパトリシア木オプションを指定すると、前方一致検索を行うことができます。また、追加のオプションを指定することにより、主キーの後方一致検索をも行うことができます。
 .SS 主キーによる前方一致検索
 .sp
 table_createコマンドのflagsオプションにTABLE_PAT_KEYを指定することで、主キーによる前方一致検索ができるようになります。
@@ -6735,12 +6734,12 @@ select \-\-table PatSuffix \-\-filter \(aq_key @$ "ゆき" && original == true\(
 .UNINDENT
 .SS 全文検索の語彙表に対する追加情報
 .sp
-groongaでは、全文検索に用いるための語意表がテーブルとして扱えます。よって、語彙ごとに複数の情報を保持することができます。例えば、語彙の出現数や検索ストップワードのフラグ、単語の重要度などを保持することができます。
+Groongaでは、全文検索に用いるための語意表がテーブルとして扱えます。よって、語彙ごとに複数の情報を保持することができます。例えば、語彙の出現数や検索ストップワードのフラグ、単語の重要度などを保持することができます。
 .sp
 この項目については、現在執筆中です。
 .SS マイクロブログ検索システムの作成
 .sp
-これまで学んだgroongaの機能を用いて、マイクロブログの検索システムを作成してみましょう。マイクロブログとは、Twitterのような短いメッセージを投稿するブログです。
+これまで学んだGroongaの機能を用いて、マイクロブログの検索システムを作成してみましょう。マイクロブログとは、Twitterのような短いメッセージを投稿するブログです。
 .SS テーブルの作成
 .sp
 まずは、テーブルを作成します。
@@ -7725,7 +7724,7 @@ select Comments \-\-filter \(aqlast_modified<=1268802000\(aq \-\-output_columns
 2010/03/17 14:00:00以前に書かれたコメント5件がヒットしました。また、ドリルダウンの結果も返ってきており、「hsiomaneki」が2件、「グニャラくん」が3件ヒットしていることがわかります。
 .SS クエリ拡張
 .sp
-groongaでは、 \fB/reference/commands/select\fP コマンドにquery_expansionパラメータを指定することによって、ユーザが指定した検索文字列を適宜拡張することが可能です。
+Groongaでは、 \fB/reference/commands/select\fP コマンドにquery_expanderパラメータを指定することによって、ユーザが指定した検索文字列を適宜拡張することが可能です。
 .sp
 たとえば、ユーザが\(aqシークヮーサー\(aqという文字列で検索した場合に、\(aqシークヮーサー OR シークァーサー\(aqで検索した場合と同一の結果を返すことによって、本来ユーザが必要とする結果をよりもれなく検索できるようになります。
 .SS 準備
@@ -10857,14 +10856,14 @@ Execution example:
     0.000355720520019531
   ],
   {
-    "uptime": 1,
+    "uptime": 0,
     "max_command_version": 2,
     "n_queries": 0,
     "cache_hit_rate": 0.0,
-    "version": "3.1.0",
-    "alloc_count": 159,
+    "version": "3.1.1",
+    "alloc_count": 160,
     "command_version": 1,
-    "starttime": 1385359876,
+    "starttime": 1387938911,
     "default_command_version": 1
   }
 ]
@@ -11899,15 +11898,15 @@ This section describes about command and built\-in commands.
 .SS コマンドバージョン
 .SS 概要
 .sp
-groonga1.1からコマンドバージョンという概念が導入されます。コマンドバージョンは、selectやloadなどのgroongaのコマンドの仕様の互換性を表します。groongaパッケージのバージョンが新しくなったとしても、同一のコマンドバージョンが使用可能であるなら、すべてのコマンドについて互換性が保証されます。コマンドバージョンが異なれば、同じ名前のコマンドであっても、動作に互換性がない可能性があります。
+Groonga1.1からコマンドバージョンという概念が導入されます。コマンドバージョンは、selectやloadなどのGroongaのコマンドの仕様の互換性を表します。Groongaパッケージのバージョンが新しくなったとしても、同一のコマンドバージョンが使用可能であるなら、すべてのコマンドについて互換性が保証されます。コマンドバージョンが異なれば、同じ名前のコマンドであっても、動作に互換性がない可能性があります。
 .sp
-あるバージョンのgroongaは、二つのコマンドバージョンを同時にサポートするようになります。
+あるバージョンのGroongaは、二つのコマンドバージョンを同時にサポートするようになります。
 使用するコマンドバージョンは、groongaを起動する際のコマンドラインオプションないしコンフィグファイルにdefault\-commnad\-versionパラメータを与えることによって指定できます。また、個々のコマンドを実行する際に、command_versionパラメータを与えることによっても指定することができます。
 .sp
-コマンドバージョンは1からはじまり、更新されるたびに1ずつ大きくなります。現状のgroongaのコマンドの仕様はcommand\-version 1という扱いになります。次回提供するgroongaは、command\-version 1とcommand\-version 2の二つをサポートすることになります。
+コマンドバージョンは1からはじまり、更新されるたびに1ずつ大きくなります。現状のGroongaのコマンドの仕様はcommand\-version 1という扱いになります。次回提供するGroongaは、command\-version 1とcommand\-version 2の二つをサポートすることになります。
 .SS バージョンの位置づけ
 .sp
-あるバージョンのgroongaにおいてサポートされるコマンドバージョンは、develop, stable,deprecatedのいずれかの位置づけとなります。
+あるバージョンのGroongaにおいてサポートされるコマンドバージョンは、develop, stable,deprecatedのいずれかの位置づけとなります。
 .INDENT 0.0
 .TP
 .B develop
@@ -11920,9 +11919,9 @@ groonga1.1からコマンドバージョンという概念が導入されます
 使用可能であり仕様も安定していますが、廃止予定であり使用が推奨されません。
 .UNINDENT
 .sp
-あるバージョンのgroongaがサポートする二つのコマンドバージョンのうち、いずれか一つが必ずstableの位置づけとなります。残りの一つは、developないしdeprecatedとなります。
+あるバージョンのGroongaがサポートする二つのコマンドバージョンのうち、いずれか一つが必ずstableの位置づけとなります。残りの一つは、developないしdeprecatedとなります。
 .sp
-たとえば下記のようにgroongaのサポートするコマンドバージョンは推移します。:
+たとえば下記のようにGroongaのサポートするコマンドバージョンは推移します。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -12559,7 +12558,7 @@ check obj
 .UNINDENT
 .SS 説明
 .sp
-groonga組込コマンドの一つであるcheckについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるcheckについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 checkコマンドは、groongaプロセス内の指定したオブジェクトの状態を表示します。主にデータベースが壊れた場合など異常時の問題解決のために使用することを想定しています。デバッグ用のため、返値のフォーマットが安定しているということは保証されません。（フォーマットが変更される可能性が高い）
 .SS 引数
@@ -12798,7 +12797,7 @@ clearlock objname
 .UNINDENT
 .SS 説明
 .sp
-groonga組込コマンドの一つであるclearlockについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるclearlockについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 clearlockは、対象となるオブジェクト(データベース,テーブル,インデックス等)を指定し、オブジェクトにかけられたロックを再帰的に解除します。
 .SS 引数
@@ -12863,7 +12862,7 @@ clearlock Entry.body
 .sp
 column_create \- カラムの追加
 .sp
-groonga組込コマンドの一つであるcolumn_createについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるcolumn_createについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 column_createは、使用しているデータベースのテーブルに対してカラムを追加します。
 .SS Syntax
@@ -12967,7 +12966,7 @@ Reserved. Compress the value of column by using lzo. This flag is disabled featu
 \fBtype\fP
 .INDENT 0.0
 .INDENT 3.5
-値の型を指定します。groongaの組込型か、同一データベースに定義済みのユーザ定義型、定義済みのテーブルを指定することができます。
+値の型を指定します。Groongaの組込型か、同一データベースに定義済みのユーザ定義型、定義済みのテーブルを指定することができます。
 .UNINDENT
 .UNINDENT
 .sp
@@ -13020,7 +13019,7 @@ column_list table
 .UNINDENT
 .SS 説明
 .sp
-groonga組込コマンドの一つであるcolumn_listについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるcolumn_listについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 column_listはテーブルに定義されているカラムをリスト表示します。
 .SS 引数
@@ -13169,7 +13168,7 @@ column_remove table name
 .UNINDENT
 .SS 説明
 .sp
-groonga組込コマンドの一つであるcolumn_removeについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるcolumn_removeについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 column_removeはテーブルに定義されているカラムを削除します。
 また、付随するインデックスも削除されます。[1]
@@ -13428,7 +13427,7 @@ define_selector name table [match_columns [query [filter [scorer [sortby
 .UNINDENT
 .SS 説明
 .sp
-groonga組込コマンドの一つであるdefine_selectorについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるdefine_selectorについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 define_selectorは、検索条件をカスタマイズした新たな検索コマンドを定義します。
 .SS 引数
@@ -13590,7 +13589,7 @@ defrag objname threshold
 .UNINDENT
 .SS 説明
 .sp
-groonga組込コマンドの一つであるdefragについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるdefragについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 defragは、対象となるオブジェクト(データベースか可変長サイズカラム)を指定し、オブジェクトのフラグメンテーションを解消します。
 .SS 引数
@@ -13923,11 +13922,11 @@ dump [tables]
 .UNINDENT
 .SS 説明
 .sp
-groonga組込コマンドの一つであるdumpについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるdumpについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 dumpはデータベースのスキーマとデータを後から読み込めるフォーマットで出力します。dumpの結果は大きくなるため、主にコマンドラインから使うことを想定しています。データベースのバックアップが主な利用方法です。
 .sp
-dumpが出力するフォーマットは直接groongaが解釈できるフォーマットです。そのため、以下のようにしてデータベースをコピーすることができます。:
+dumpが出力するフォーマットは直接Groongaが解釈できるフォーマットです。そのため、以下のようにしてデータベースをコピーすることができます。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -13950,7 +13949,7 @@ dumpが出力するフォーマットは直接groongaが解釈できるフォー
 .UNINDENT
 .SS 返値
 .sp
-データベースのスキーマとデータをgroongaの組み込みコマンド呼び出し形式で出力します。output_type指定は無視されます。
+データベースのスキーマとデータをGroongaの組み込みコマンド呼び出し形式で出力します。output_type指定は無視されます。
 .SS 例
 .sp
 データベース内のすべてのデータを出力:
@@ -14154,7 +14153,7 @@ log_level level
 .UNINDENT
 .SS 説明
 .sp
-groonga組込コマンドの一つであるlog_levelについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるlog_levelについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 log_levelは、ログ出力レベルを設定します。
 .SS 引数
@@ -14311,7 +14310,7 @@ log_reopen
 .UNINDENT
 .SS 説明
 .sp
-groonga組込コマンドの一つであるlog_reopenについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるlog_reopenについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 log_reopenは、ログファイルを再読み込みします。
 .sp
@@ -14380,7 +14379,7 @@ This command may be changed in the future.
 \fBnormalize\fP command normalizes text by the specified normalizer.
 .sp
 There is no need to create table to use \fBnormalize\fP command.
-It is usefull for you to check the results of normalizer.
+It is useful for you to check the results of normalizer.
 .SS Syntax
 .sp
 \fBnormalize\fP commands has two required parameters. They are
@@ -14588,7 +14587,7 @@ quit
 .UNINDENT
 .SS 説明
 .sp
-groonga組込コマンドの一つであるquitについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるquitについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 quitは、groongaプロセスとのセッションを終了します。クライアントプロセスならばgroongaプロセスとの接続を切ります。
 .SS 引数
@@ -16451,7 +16450,7 @@ load \-\-table Thesaurus
 \fBThesaurus\fP substitution table has two synonyms, \fB"mroonga"\fP and
 \fB"groonga"\fP. If an user searches with \fB"mroonga"\fP, groonga
 searches with \fB"((mroonga) OR (tritonn) OR (groonga mysql))"\fP. If an
-user searches with \fB"groonga"\fP, groonga searchs with \fB"((groonga)
+user searches with \fB"groonga"\fP, groonga searches with \fB"((groonga)
 OR (senna))"\fP. Nomrally, it\(aqs good idea that substitution table has
 \fBKEY_NORMALIZE\fP flag. If the flag is used, substitute target word is
 matched in case insensitive manner.
@@ -17439,7 +17438,7 @@ shutdown
 .UNINDENT
 .SS 説明
 .sp
-groonga組込コマンドの一つであるshutdownについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるshutdownについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 shutdownは、接続しているgroongaサーバプロセスを停止します。
 .SS 引数
@@ -17476,7 +17475,7 @@ status
 .UNINDENT
 .SS 説明
 .sp
-groonga組込コマンドの一つであるstatusについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるstatusについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 statusコマンドは、groongaプロセスの状態を表示します。主にgroongaサーバプロセスに対して使用することを想定しています。
 .SS 引数
@@ -17498,7 +17497,7 @@ statusコマンドは、groongaプロセスの状態を表示します。主にg
 \fBalloc_count\fP
 .INDENT 0.0
 .INDENT 3.5
-groongaプロセスの内部でアロケートされ、まだ解放されてないメモリブロックの数を示します。groongaをbuildする際に、configureオプションで \-\-enable\-exact\-alloc\-countが指定されていたならば、正確な値を返します。それ以外の場合は不正確な値を返す場合があります。
+groongaプロセスの内部でアロケートされ、まだ解放されてないメモリブロックの数を示します。Groongaをbuildする際に、configureオプションで \-\-enable\-exact\-alloc\-countが指定されていたならば、正確な値を返します。それ以外の場合は不正確な値を返す場合があります。
 .UNINDENT
 .UNINDENT
 .sp
@@ -17531,14 +17530,14 @@ status
 #     0.000355720520019531
 #   ],
 #   {
-#     "uptime": 0,
+#     "uptime": 1,
 #     "max_command_version": 2,
 #     "n_queries": 0,
 #     "cache_hit_rate": 0.0,
-#     "version": "3.1.0",
-#     "alloc_count": 290,
+#     "version": "3.1.1",
+#     "alloc_count": 291,
 #     "command_version": 1,
-#     "starttime": 1385359891,
+#     "starttime": 1387938926,
 #     "default_command_version": 1
 #   }
 # ]
@@ -18172,7 +18171,7 @@ and is \fBTABLE_NO_KEY\fP type.
 .sp
 If your records aren\(aqt searched by key, \fBTABLE_NO_KEY\fP type table is
 suitable. Because \fBTABLE_NO_KEY\fP doesn\(aqt support key but it is fast
-and small table. Storing logs into groonga database is the case.
+and small table. Storing logs into Groonga database is the case.
 .sp
 If your records are searched by key or referenced by one or more
 columns, \fBTABLE_NO_KEY\fP type isn\(aqt suitable. Lexicon for fulltext
@@ -18323,7 +18322,7 @@ character.)
 .UNINDENT
 .sp
 You need to create a name with one or more the above chracters. Note
-that you cannot use \fB_\fP as the first charcter such as
+that you cannot use \fB_\fP as the first character such as
 \fB_name\fP.
 .SS \fBflags\fP
 .sp
@@ -18376,7 +18375,7 @@ _
 \fBNOTE:\fP
 .INDENT 0.0
 .INDENT 3.5
-Since groonga 2.1.0 \fBKEY_NORMALIZE\fP flag is deprecated. Use
+Since Groonga 2.1.0 \fBKEY_NORMALIZE\fP flag is deprecated. Use
 \fBnormalizer\fP option with \fBNormalizerAuto\fP instead.
 .UNINDENT
 .UNINDENT
@@ -18483,7 +18482,7 @@ table_list
 .UNINDENT
 .SS 説明
 .sp
-groonga組込コマンドの一つであるtable_listについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるtable_listについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 table_listは、DBに定義されているテーブルのリストを表示します。
 .SS 引数
@@ -19615,14 +19614,14 @@ If command succeeded, it returns true, otherwise it returns false on error.
 .SS データ型
 .SS 名前
 .sp
-groonga データ型
+Groonga データ型
 .SS 説明
 .sp
-groonga は、格納するデータの型を区別します。
+Groonga は、格納するデータの型を区別します。
 .sp
-groongaのデータベースでは、テーブルの主キーや、カラムの値はいずれも何らかの型に属します。また通常は、一つのテーブルの中の全てのレコードについて、カラムの値は共通となります。
+Groongaのデータベースでは、テーブルの主キーや、カラムの値はいずれも何らかの型に属します。また通常は、一つのテーブルの中の全てのレコードについて、カラムの値は共通となります。
 .sp
-主キーの型とカラムの型には、groongaで予め定義済みの型か、ユーザが定義する型、またはユーザが定義したテーブルを指定することができます。
+主キーの型とカラムの型には、Groongaで予め定義済みの型か、ユーザが定義する型、またはユーザが定義したテーブルを指定することができます。
 .sp
 主キーの型に他のテーブルを指定する場合は、そのテーブルは、主キーの型となるテーブルのサブセットとなります。
 .sp
@@ -19768,7 +19767,7 @@ IEEE 754形式の詳細については、 \fI\%IEEE 754 \- Wikipedia\fP や \fI\
 Text型とLongText型については、テーブルの主キーに指定することはできません。
 .SS ベクターとして格納できない型
 .sp
-groongaのカラムは、ある型のベクターを保存することができます。しかし、ShortText, Text, LongTextの３つの型についてはベクターとして保存したり出力したりすることはできますが、検索条件やドリルダウン条件に指定することができません。
+Groongaのカラムは、ある型のベクターを保存することができます。しかし、ShortText, Text, LongTextの３つの型についてはベクターとして保存したり出力したりすることはできますが、検索条件やドリルダウン条件に指定することができません。
 .sp
 テーブル型は、ベクターとして格納することができます。よって、ShortTextのベクターを検索条件やドリルダウン条件に使用したい場合には、主キーがShortText型のテーブルを別途作成し、そのテーブルを型として利用します。
 脚注
@@ -20053,7 +20052,7 @@ 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.
+normalization by registering your normalizer plugins to Groonga.
 .sp
 A normalizer module is attached to a table. A table can have zero or
 one normalizer module. You can attach a normalizer module to a table
@@ -20082,12 +20081,12 @@ table_create Dictionary TABLE_HASH_KEY ShortText \-\-normalizer NormalizerAuto
 Groonga 2.0.9 or earlier doesn\(aqt have \fB\-\-normalizer\fP option in
 \fBtable_create\fP. \fBKEY_NORMALIZE\fP flag was used instead.
 .sp
-You can open an old database by groonga 2.1.0 or later. An old
-database means that the database is created by groonga 2.0.9 or
-earlier. But you cannot open the opened old database by groonga
-2.0.9 or earlier. Once you open the old database by groonga 2.1.0
+You can open an old database by Groonga 2.1.0 or later. An old
+database means that the database is created by Groonga 2.0.9 or
+earlier. But you cannot open the opened old database by Groonga
+2.0.9 or earlier. Once you open the old database by Groonga 2.1.0
 or later, \fBKEY_NORMALIZE\fP flag information in the old database is
-converted to normalizer information. So groogna 2.0.9 or earlier
+converted to normalizer information. So Groonga 2.0.9 or earlier
 cannot find \fBKEY_NORMALIZE\fP flag information in the opened old
 database.
 .UNINDENT
@@ -20174,10 +20173,10 @@ Here is a list of built\-in normalizers:
 .SS \fBNormalizerAuto\fP
 .sp
 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
+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_create\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
@@ -20244,8 +20243,8 @@ Here is a list of additional normalizers provided by \fBgroonga\-normalizer\-mys
 .UNINDENT
 .UNINDENT
 .sp
-\fBgroonga\-normalizer\-mysql\fP is a groonga plugin.
-It provides MySQL compatible normalizers to groonga.
+\fBgroonga\-normalizer\-mysql\fP is a Groonga plugin.
+It provides MySQL compatible normalizers to Groonga.
 \fBNormalizerMySQLGeneralCI\fP corresponds to \fButf8mb4_general_ci\fP.
 .sp
 You need to register \fBnormalizers/mysql\fP plugin in advance.
@@ -24817,7 +24816,7 @@ registered as keys of the table of \fB_key\fP.
 .sp
 Note that the table must be patricia trie (\fBTABLE_PAT_KEY\fP) or
 double array trie (\fBTABLE_DAT_KEY\fP). You can\(aqt use hash table
-(\fBTABLE_HASH_KEY\fP) and array (\fBTABLE_NO_KEY\fP) becuase they don\(aqt
+(\fBTABLE_HASH_KEY\fP) and array (\fBTABLE_NO_KEY\fP) because they don\(aqt
 support longest common prefix search. Longest common prefix search is
 used to implement the operator.
 .sp
@@ -24894,163 +24893,51 @@ options of \fBcommands/select\fP.
 This section describes about function and built\-in functions.
 .sp
 TODO: Add documentations about function.
-.SS edit_distance
-.SS 名前
-.sp
-edit_distance \- 指定した2つの文字列の編集距離を計算する
-.SS 書式
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-edit_distance(string1, string2)
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.SS 説明
-.sp
-groonga組込関数の一つであるedit_distanceについて説明します。組込関数は、script形式のgrn_expr中で呼び出すことができます。
-.sp
-edit_distance() 関数は、string1に指定した文字列とstring2に指定した文字列の間の編集距離を求めます。
-.SS 引数
-.sp
-\fBstring1\fP
-.INDENT 0.0
-.INDENT 3.5
-文字列を指定します
-.UNINDENT
-.UNINDENT
-.sp
-\fBstring2\fP
-.INDENT 0.0
-.INDENT 3.5
-もうひとつの文字列を指定します
-.UNINDENT
-.UNINDENT
-.SS 返値
-.sp
-指定した2つ文字列の編集距離をUint32型の値として返します。
-.SS 例
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-edit_distance(title, "hoge")
-1
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.SS geo_distance
+.SS between
 .SS Summary
 .sp
-\fBgeo_distance\fP calculates the value of distance between specified two points.
+\fBbetween\fP is used for checking the specified value exists in the specific range.
+It is often used for combination with \fIselect\-filter\fP option in \fB/reference/commands/select\fP.
 .SS Syntax
 .sp
-\fBgeo_distance\fP requires two point.
-The parameter \fBapproximate_type\fP is optional:
+\fBbetween\fP has five parameters:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-geo_distance(point1, point2)
-geo_distance(point1, point2, approximate_type)
+between(column_or_value, min, min_border, max, max_border)
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
-.sp
-The default value of \fBapproximate_type\fP is \fB"rectangle"\fP.
-If you omit \fBapproximate_type\fP, \fBgeo_distance\fP calculates the value of
-distance as if \fB"rectangle"\fP was specified.
 .SS Usage
 .sp
-\fBgeo_distance\fP is one of the groonga builtin functions.
-.sp
-You can call a builtin function in \fB/reference/grn_expr\fP
-.sp
-\fBgeo_distance\fP function calculates the value of distance (approximate value)
-between the coordinate of \fBpoint1\fP and the coordinate of \fBpoint2\fP.
-.sp
-\fBNOTE:\fP
-.INDENT 0.0
-.INDENT 3.5
-groonga provides three built in functions for calculating the value of distance.
-There are \fBgeo_distance()\fP, \fBgeo_distance2()\fP and \fBgeo_distance3()\fP.
-The difference of them is the algorithm of calculating distance.
-\fBgeo_distance2()\fP and \fBgeo_distance3()\fP were deprecated since version 1.2.9.
-Use \fBgeo_distance(point1, point2, "sphere")\fP instead of \fBgeo_distance2(point1, point2)\fP.
-Use \fBgeo_distance(point1, point2, "ellipsoid")\fP instead of \fBgeo_distance3(point1, point2)\fP.
-.UNINDENT
-.UNINDENT
-.sp
-Lets\(aqs learn about \fBgeo_distance\fP usage with examples.
-This section shows simple usages.
-.sp
-Here are two schema definition and sample data to show the difference according to the usage.
-Those samples show how to calculate the value of distance between New York City and London.
-.INDENT 0.0
-.IP 1. 3
-Using the column value of location for calculating the distance (\fBCities\fP table)
-.IP 2. 3
-Using the explicitly specified coordinates for calculating the distance (\fBGeo\fP table)
-.UNINDENT
-.SS Using the column value of location
-.sp
-Here are a schema definition of \fBCities\fP table and sample data to show usage.
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-table_create Cities TABLE_HASH_KEY ShortText
-column_create Cities location COLUMN_SCALAR WGS84GeoPoint
-load \-\-table Cities
-[
-  {
-    "_key", "location"
-  },
-  {
-    "New York City", "146566000x\-266422000",
-  },
-]
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-Execution example:
+Here are a schema definition and sample data to show usage.:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-table_create Cities TABLE_HASH_KEY ShortText
-# [[0, 1337566253.89858, 0.000355720520019531], true]
-column_create Cities location COLUMN_SCALAR WGS84GeoPoint
-# [[0, 1337566253.89858, 0.000355720520019531], true]
-load \-\-table Cities
+table_create Users TABLE_HASH_KEY ShortText
+column_create Users age COLUMN_SCALAR Int32
+table_create Ages TABLE_HASH_KEY Int32
+column_create Ages user_age COLUMN_INDEX Users age
+load \-\-table Users
 [
-  {
-     "_key", "location"
-  },
-  {
-     "New York City", "146566000x\-266422000",
-  },
+{"_key": "Alice",  "age": 12},
+{"_key": "Bob",    "age": 13},
+{"_key": "Calros", "age": 15},
+{"_key": "Dave",   "age": 16},
+{"_key": "Eric",   "age": 20}
+{"_key": "Frank",  "age": 21}
 ]
-# [[0, 1337566253.89858, 0.000355720520019531], 1]
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-This execution example creates a table named \fBCities\fP which has one column named \fBlocation\fP.
-\fBlocation\fP column stores the value of coordinate.
-The coordinate of Tokyo is stored as sample data.
+Here is the query to show the persons to match PG\-13 rating (MPAA).
 .sp
 Execution example:
 .INDENT 0.0
@@ -25058,7 +24945,7 @@ Execution example:
 .sp
 .nf
 .ft C
-select Cities \-\-output_columns _score \-\-filter 1 \-\-scorer \(aq_score = geo_distance(location, "185428000x\-461000", "rectangle")\(aq
+select Users \-\-filter \(aqbetween(age, 13, "include", 16, "include")\(aq
 # [
 #   [
 #     0,
@@ -25068,16 +24955,36 @@ select Cities \-\-output_columns _score \-\-filter 1 \-\-scorer \(aq_score = geo
 #   [
 #     [
 #       [
-#         1
+#         3
 #       ],
 #       [
 #         [
-#           "_score",
-#           "Int32"
-#         ]
-#       ],
-#       [
-#         5715104
+#           "_id",
+#           "UInt32"
+#         ],
+#         [
+#           "_key",
+#           "ShortText"
+#         ],
+#         [
+#           "age",
+#           "Int32"
+#         ]
+#       ],
+#       [
+#         2,
+#         "Bob",
+#         13
+#       ],
+#       [
+#         3,
+#         "Calros",
+#         15
+#       ],
+#       [
+#         4,
+#         "Dave",
+#         16
 #       ]
 #     ]
 #   ]
@@ -25087,56 +24994,13 @@ select Cities \-\-output_columns _score \-\-filter 1 \-\-scorer \(aq_score = geo
 .UNINDENT
 .UNINDENT
 .sp
-This sample shows that \fBgeo_distance\fP use the value of \fBlocation\fP column
-and the value of coordinate to calculate distance.
-.sp
-The value ("185428000x\-461000") passed to \fBgeo_distance\fP as the second argument is
-the coordinate of London.
-.SS Using the explicitly specified value of location
-.sp
-Here are a schema definition of \fBGeo\fP table and sample data to show usage.
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-table_create Geo TABLE_HASH_KEY ShortText
-column_create Geo distance COLUMN_SCALAR Int32
-load \-\-table Geo
-[
-  {
-    "_key": "the record for geo_distance() result"
-  }
-]
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
+It returns 13, 14, 15 and 16 years old users.
 .sp
-Execution example:
-.INDENT 0.0
-.INDENT 3.5
+\fBbetween\fP function accepts not only a column of table, but also the value.
 .sp
-.nf
-.ft C
-table_create Geo TABLE_HASH_KEY ShortText
-# [[0, 1337566253.89858, 0.000355720520019531], true]
-column_create Geo distance COLUMN_SCALAR Int32
-# [[0, 1337566253.89858, 0.000355720520019531], true]
-load \-\-table Geo
-[
-  {
-    "_key": "the record for geo_distance() result"
-  }
-]
-# [[0, 1337566253.89858, 0.000355720520019531], 1]
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
+If you specify the value as 1st parameter, it is checked whether the value is included or not. if it matches to the specified range, it returns the all records because \fBbetween\fP function returns true.
 .sp
-This execution example creates a table named \fBGeo\fP which has one column named \fBdistance\fP.
-\fBdistance\fP column stores the value of distance.
+If it doesn\(aqt match to the specified range, it returns no records because \fBbetween\fP function returns false.
 .sp
 Execution example:
 .INDENT 0.0
@@ -25144,7 +25008,7 @@ Execution example:
 .sp
 .nf
 .ft C
-select Geo \-\-output_columns distance \-\-scorer \(aqdistance = geo_distance("146566000x\-266422000", "185428000x\-461000", "rectangle")\(aq
+select Users \-\-filter \(aqbetween(14, 13, "include", 16, "include")\(aq
 # [
 #   [
 #     0,
@@ -25154,16 +25018,51 @@ select Geo \-\-output_columns distance \-\-scorer \(aqdistance = geo_distance("1
 #   [
 #     [
 #       [
-#         1
+#         6
 #       ],
 #       [
 #         [
-#           "distance",
+#           "_id",
+#           "UInt32"
+#         ],
+#         [
+#           "_key",
+#           "ShortText"
+#         ],
+#         [
+#           "age",
 #           "Int32"
 #         ]
 #       ],
 #       [
-#         5807750
+#         1,
+#         "Alice",
+#         12
+#       ],
+#       [
+#         2,
+#         "Bob",
+#         13
+#       ],
+#       [
+#         3,
+#         "Calros",
+#         15
+#       ],
+#       [
+#         4,
+#         "Dave",
+#         16
+#       ],
+#       [
+#         5,
+#         "Eric",
+#         20
+#       ],
+#       [
+#         6,
+#         "Frank",
+#         21
 #       ]
 #     ]
 #   ]
@@ -25173,186 +25072,190 @@ select Geo \-\-output_columns distance \-\-scorer \(aqdistance = geo_distance("1
 .UNINDENT
 .UNINDENT
 .sp
-This sample shows that \fBgeo_distance\fP use the coordinate of London
-and the coordinate of New York to calculate distance.
+In the above case, it returns all the records, because 14 exists in between 13 and 16.
+This behavior is used for checking the specified value exists or not in the table.
 .SS Parameters
-.SS Required parameter
 .sp
-There are two required parameter, \fBpoint1\fP and \fBpoint2\fP.
-.SS \fBpoint1\fP
+There are five required parameters, \fBcolumn_or_value\fP, and \fBmin\fP, \fBmin_border\fP, \fBmax\fP and \fBmax_border\fP.
+.SS \fBcolumn_or_value\fP
 .sp
-It specifies the start point that
-you want to calculate the value of distance between two points.
+It specifies a column of the table or the value.
+.SS \fBmin\fP
 .sp
-You can specify the value of GeoPoint type. [1]
+It specifies the minimal border value of the range.
+You can control the behavior that the value of \fBmax\fP is included or excluded by \fBmax_border\fP parameter.
+.SS \fBmin_border\fP
 .sp
-See \fB/reference/types\fP about GeoPoint.
-.SS \fBpoint2\fP
+It specifies whether the specified range contains the value of \fBmin\fP or not.
+The value of \fBmin_border\fP are either "include" or "exclude". If it is "include", \fBmin\fP value is included. If it is "exclude", \fBmin\fP value is not included.
+.SS \fBmax\fP
 .sp
-It specifies the end point that
-you want to calculate the value of distance between two points.
+It specifies the maximum border value of the range.
+You can control the behavior that the value of \fBmax\fP is included or excluded by \fBmax_border\fP parameter.
+.SS \fBmax_border\fP
 .sp
-You can specify the value of GeoPoint type or
-the string indicating the coordinate.
+It specifies whether the specified range contains the value of \fBmax\fP or not.
+The value of \fBmax_border\fP are either "include" or "exclude". If it is "include", \fBmax\fP value is included. If it is "exclude", \fBmax\fP value is not included.
+.SS Return value
 .sp
-See \fB/reference/types\fP about GeoPoint and the coordinate.
-.SS Optional parameter
+\fBbetween\fP returns whether the value of column exists in specified the value of range or not. If record is matched to specified the value of range, it returns true. Otherwise, it returns false.
+.SS edit_distance
+.SS 名前
 .sp
-There is a optional parameter, \fBapproximate_type\fP.
-.SS \fBapproximate_type\fP
+edit_distance \- 指定した2つの文字列の編集距離を計算する
+.SS 書式
+.INDENT 0.0
+.INDENT 3.5
 .sp
-It specifies how to approximate the geographical features for calculating
-the value of distance.
+.nf
+.ft C
+edit_distance(string1, string2)
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS 説明
 .sp
-You can specify the value of \fBapproximate_type\fP by one of the followings.
+groonga組込関数の一つであるedit_distanceについて説明します。組込関数は、script形式のgrn_expr中で呼び出すことができます。
+.sp
+edit_distance() 関数は、string1に指定した文字列とstring2に指定した文字列の間の編集距離を求めます。
+.SS 引数
+.sp
+\fBstring1\fP
 .INDENT 0.0
 .INDENT 3.5
-.INDENT 0.0
-.IP \(bu 2
-\fBrectangle\fP
-.IP \(bu 2
-\fBsphere\fP
-.IP \(bu 2
-\fBellipsoid\fP
-.UNINDENT
+文字列を指定します
 .UNINDENT
 .UNINDENT
 .sp
-\fBNOTE:\fP
+\fBstring2\fP
 .INDENT 0.0
 .INDENT 3.5
-There is a limitation about \fBgeo_distance\fP. \fBgeo_distance\fP can not
-calculate the value of distance between two points across meridian,
-equator or the date line if you use \fBsphere\fP or \fBellipsoid\fP as
-approximate type. There is not such a limitation for \fBrectangle\fP.
-This is temporary limitation according to the implementation of groonga,
-but it will be fixed in the future release.
+もうひとつの文字列を指定します
 .UNINDENT
 .UNINDENT
-.SS \fBrectangle\fP
-.sp
-This parameter require to approximate the geographical features
-by square approximation for calculating the distance.
-.sp
-Since the value of distance is calculated by simple formula,
-you can calculate the value of distance fast.
-But, the error of distance increases as it approaches the pole.
-.sp
-You can also specify \fBrect\fP as abbrev expression.
-.sp
-Here is a sample about calculating the value of distance with column value.
+.SS 返値
 .sp
-Execution example:
+指定した2つ文字列の編集距離をUint32型の値として返します。
+.SS 例
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-select Cities \-\-output_columns _score \-\-filter 1 \-\-scorer \(aq_score = geo_distance(location, "185428000x\-461000", "rectangle")\(aq
-# [
-#   [
-#     0,
-#     1337566253.89858,
-#     0.000355720520019531
-#   ],
-#   [
-#     [
-#       [
-#         1
-#       ],
-#       [
-#         [
-#           "_score",
-#           "Int32"
-#         ]
-#       ],
-#       [
-#         5715104
-#       ]
-#     ]
-#   ]
-# ]
+edit_distance(title, "hoge")
+1
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
+.SS geo_distance
+.SS Summary
 .sp
-Here is a sample about calculating the value of distance with explicitly specified point.
+\fBgeo_distance\fP calculates the value of distance between specified two points.
+.SS Syntax
 .sp
-Execution example:
+\fBgeo_distance\fP requires two point.
+The parameter \fBapproximate_type\fP is optional:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-select Geo \-\-output_columns distance \-\-scorer \(aqdistance = geo_distance("146566000x\-266422000", "185428000x\-461000", "rectangle")\(aq
-# [
-#   [
-#     0,
-#     1337566253.89858,
-#     0.000355720520019531
-#   ],
-#   [
-#     [
-#       [
-#         1
-#       ],
-#       [
-#         [
-#           "distance",
-#           "Int32"
-#         ]
-#       ],
-#       [
-#         5807750
-#       ]
-#     ]
-#   ]
-# ]
+geo_distance(point1, point2)
+geo_distance(point1, point2, approximate_type)
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-Here are samples about calculating the value of distance with explicitly specified point across meridian, equator, the date line.
+The default value of \fBapproximate_type\fP is \fB"rectangle"\fP.
+If you omit \fBapproximate_type\fP, \fBgeo_distance\fP calculates the value of
+distance as if \fB"rectangle"\fP was specified.
+.SS Usage
 .sp
-Execution example:
-.INDENT 0.0
-.INDENT 3.5
+\fBgeo_distance\fP is one of the groonga builtin functions.
 .sp
-.nf
-.ft C
-select Geo \-\-output_columns distance \-\-scorer \(aqdistance = geo_distance("175904000x8464000", "145508000x\-13291000", "rectangle")\(aq
-# [
-#   [
-#     0,
-#     1337566253.89858,
-#     0.000355720520019531
-#   ],
-#   [
-#     [
-#       [
-#         1
-#       ],
-#       [
-#         [
-#           "distance",
-#           "Int32"
-#         ]
-#       ],
-#       [
-#         1051293
-#       ]
-#     ]
-#   ]
-# ]
+You can call a builtin function in \fB/reference/grn_expr\fP
+.sp
+\fBgeo_distance\fP function calculates the value of distance (approximate value)
+between the coordinate of \fBpoint1\fP and the coordinate of \fBpoint2\fP.
+.sp
+\fBNOTE:\fP
+.INDENT 0.0
+.INDENT 3.5
+groonga provides three built in functions for calculating the value of distance.
+There are \fBgeo_distance()\fP, \fBgeo_distance2()\fP and \fBgeo_distance3()\fP.
+The difference of them is the algorithm of calculating distance.
+\fBgeo_distance2()\fP and \fBgeo_distance3()\fP were deprecated since version 1.2.9.
+Use \fBgeo_distance(point1, point2, "sphere")\fP instead of \fBgeo_distance2(point1, point2)\fP.
+Use \fBgeo_distance(point1, point2, "ellipsoid")\fP instead of \fBgeo_distance3(point1, point2)\fP.
+.UNINDENT
+.UNINDENT
+.sp
+Lets\(aqs learn about \fBgeo_distance\fP usage with examples.
+This section shows simple usages.
+.sp
+Here are two schema definition and sample data to show the difference according to the usage.
+Those samples show how to calculate the value of distance between New York City and London.
+.INDENT 0.0
+.IP 1. 3
+Using the column value of location for calculating the distance (\fBCities\fP table)
+.IP 2. 3
+Using the explicitly specified coordinates for calculating the distance (\fBGeo\fP table)
+.UNINDENT
+.SS Using the column value of location
+.sp
+Here are a schema definition of \fBCities\fP table and sample data to show usage.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+table_create Cities TABLE_HASH_KEY ShortText
+column_create Cities location COLUMN_SCALAR WGS84GeoPoint
+load \-\-table Cities
+[
+  {
+    "_key", "location"
+  },
+  {
+    "New York City", "146566000x\-266422000",
+  },
+]
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-This sample shows the value of distance across meridian.
-The return value of \fBgeo_distance("175904000x8464000", "145508000x\-13291000", "rectangle")\fP is the value of distance from Paris, Flance to Madrid, Spain.
+Execution example:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+table_create Cities TABLE_HASH_KEY ShortText
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Cities location COLUMN_SCALAR WGS84GeoPoint
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+load \-\-table Cities
+[
+  {
+     "_key", "location"
+  },
+  {
+     "New York City", "146566000x\-266422000",
+  },
+]
+# [[0, 1337566253.89858, 0.000355720520019531], 1]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+This execution example creates a table named \fBCities\fP which has one column named \fBlocation\fP.
+\fBlocation\fP column stores the value of coordinate.
+The coordinate of Tokyo is stored as sample data.
 .sp
 Execution example:
 .INDENT 0.0
@@ -25360,7 +25263,7 @@ Execution example:
 .sp
 .nf
 .ft C
-select Geo \-\-output_columns distance \-\-scorer \(aqdistance = geo_distance("146566000x\-266422000", "\-56880000x\-172310000", "rectangle")\(aq
+select Cities \-\-output_columns _score \-\-filter 1 \-\-scorer \(aq_score = geo_distance(location, "185428000x\-461000", "rectangle")\(aq
 # [
 #   [
 #     0,
@@ -25374,12 +25277,12 @@ select Geo \-\-output_columns distance \-\-scorer \(aqdistance = geo_distance("1
 #       ],
 #       [
 #         [
-#           "distance",
+#           "_score",
 #           "Int32"
 #         ]
 #       ],
 #       [
-#         6880439
+#         5715104
 #       ]
 #     ]
 #   ]
@@ -25389,8 +25292,31 @@ select Geo \-\-output_columns distance \-\-scorer \(aqdistance = geo_distance("1
 .UNINDENT
 .UNINDENT
 .sp
-This sample shows the value of distance across equator.
-The return value of \fBgeo_distance("146566000x\-266422000", "\-56880000x\-172310000", "rectangle")\fP is the value of distance from New York, The United Status to Brasillia, Brasil.
+This sample shows that \fBgeo_distance\fP use the value of \fBlocation\fP column
+and the value of coordinate to calculate distance.
+.sp
+The value ("185428000x\-461000") passed to \fBgeo_distance\fP as the second argument is
+the coordinate of London.
+.SS Using the explicitly specified value of location
+.sp
+Here are a schema definition of \fBGeo\fP table and sample data to show usage.
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+table_create Geo TABLE_HASH_KEY ShortText
+column_create Geo distance COLUMN_SCALAR Int32
+load \-\-table Geo
+[
+  {
+    "_key": "the record for geo_distance() result"
+  }
+]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
 .sp
 Execution example:
 .INDENT 0.0
@@ -25398,7 +25324,32 @@ Execution example:
 .sp
 .nf
 .ft C
-select Geo \-\-output_columns distance \-\-scorer \(aqdistance = geo_distance("143660000x419009000", "135960000x\-440760000", "rectangle")\(aq
+table_create Geo TABLE_HASH_KEY ShortText
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+column_create Geo distance COLUMN_SCALAR Int32
+# [[0, 1337566253.89858, 0.000355720520019531], true]
+load \-\-table Geo
+[
+  {
+    "_key": "the record for geo_distance() result"
+  }
+]
+# [[0, 1337566253.89858, 0.000355720520019531], 1]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+This execution example creates a table named \fBGeo\fP which has one column named \fBdistance\fP.
+\fBdistance\fP column stores the value of distance.
+.sp
+Execution example:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+select Geo \-\-output_columns distance \-\-scorer \(aqdistance = geo_distance("146566000x\-266422000", "185428000x\-461000", "rectangle")\(aq
 # [
 #   [
 #     0,
@@ -25417,7 +25368,7 @@ select Geo \-\-output_columns distance \-\-scorer \(aqdistance = geo_distance("1
 #         ]
 #       ],
 #       [
-#         10475205
+#         5807750
 #       ]
 #     ]
 #   ]
@@ -25427,36 +25378,72 @@ select Geo \-\-output_columns distance \-\-scorer \(aqdistance = geo_distance("1
 .UNINDENT
 .UNINDENT
 .sp
-This sample shows the value of distance across the date line.
-The return value of \fBgeo_distance("143660000x419009000", "135960000x\-440760000", "rectangle")\fP is the value of distance from Beijin, China to San Francisco, The United States.
+This sample shows that \fBgeo_distance\fP use the coordinate of London
+and the coordinate of New York to calculate distance.
+.SS Parameters
+.SS Required parameter
 .sp
-\fBNOTE:\fP
+There are two required parameter, \fBpoint1\fP and \fBpoint2\fP.
+.SS \fBpoint1\fP
+.sp
+It specifies the start point that
+you want to calculate the value of distance between two points.
+.sp
+You can specify the value of GeoPoint type. [1]
+.sp
+See \fB/reference/types\fP about GeoPoint.
+.SS \fBpoint2\fP
+.sp
+It specifies the end point that
+you want to calculate the value of distance between two points.
+.sp
+You can specify the value of GeoPoint type or
+the string indicating the coordinate.
+.sp
+See \fB/reference/types\fP about GeoPoint and the coordinate.
+.SS Optional parameter
+.sp
+There is a optional parameter, \fBapproximate_type\fP.
+.SS \fBapproximate_type\fP
+.sp
+It specifies how to approximate the geographical features for calculating
+the value of distance.
+.sp
+You can specify the value of \fBapproximate_type\fP by one of the followings.
 .INDENT 0.0
 .INDENT 3.5
-\fBgeo_distance\fP uses square approximation as default. If you omit \fBapproximate_type\fP, \fBgeo_distance\fP behaves like \fBrectangle\fP was specified.
+.INDENT 0.0
+.IP \(bu 2
+\fBrectangle\fP
+.IP \(bu 2
+\fBsphere\fP
+.IP \(bu 2
+\fBellipsoid\fP
+.UNINDENT
 .UNINDENT
 .UNINDENT
 .sp
 \fBNOTE:\fP
 .INDENT 0.0
 .INDENT 3.5
-\fBgeo_distance\fP accepts the string indicating the coordinate as
-the value of \fBpoint1\fP when the value of \fBapproximate_type\fP is
-\fB"rectangle"\fP.
-If you specified the string indicating the coordinate as the value
-of \fBpoint1\fP with \fBsphere\fP or \fBellipsoid\fP, \fBgeo_distance\fP
-returns 0 as the value of distance.
+There is a limitation about \fBgeo_distance\fP. \fBgeo_distance\fP can not
+calculate the value of distance between two points across meridian,
+equator or the date line if you use \fBsphere\fP or \fBellipsoid\fP as
+approximate type. There is not such a limitation for \fBrectangle\fP.
+This is temporary limitation according to the implementation of groonga,
+but it will be fixed in the future release.
 .UNINDENT
 .UNINDENT
-.SS \fBsphere\fP
+.SS \fBrectangle\fP
 .sp
 This parameter require to approximate the geographical features
-by spherical approximation for calculating the distance.
+by square approximation for calculating the distance.
 .sp
-It is slower than \fBrectangle\fP, but the error of distance becomes
-smaller than \fBrectangle\fP.
+Since the value of distance is calculated by simple formula,
+you can calculate the value of distance fast.
+But, the error of distance increases as it approaches the pole.
 .sp
-You can also specify \fBsphr\fP as abbrev expression.
+You can also specify \fBrect\fP as abbrev expression.
 .sp
 Here is a sample about calculating the value of distance with column value.
 .sp
@@ -25466,7 +25453,7 @@ Execution example:
 .sp
 .nf
 .ft C
-select Cities \-\-output_columns _score \-\-filter 1 \-\-scorer \(aq_score = geo_distance(location, "185428000x\-461000", "sphere")\(aq
+select Cities \-\-output_columns _score \-\-filter 1 \-\-scorer \(aq_score = geo_distance(location, "185428000x\-461000", "rectangle")\(aq
 # [
 #   [
 #     0,
@@ -25485,7 +25472,7 @@ select Cities \-\-output_columns _score \-\-filter 1 \-\-scorer \(aq_score = geo
 #         ]
 #       ],
 #       [
-#         5715102
+#         5715104
 #       ]
 #     ]
 #   ]
@@ -25494,18 +25481,8 @@ select Cities \-\-output_columns _score \-\-filter 1 \-\-scorer \(aq_score = geo
 .fi
 .UNINDENT
 .UNINDENT
-.SS \fBellipsoid\fP
-.sp
-This parameter require to approximate the geographical features
-by ellipsoid approximation for calculating the distance.
-.sp
-It uses the calculation of distance by the formula of Hubeny.
-It is slower than \fBsphere\fP, but the error of distance becomes
-smaller than \fBsphere\fP.
-.sp
-You can also specify \fBellip\fP as abbrev expression.
 .sp
-Here is a sample about calculating the value of distance with column value.
+Here is a sample about calculating the value of distance with explicitly specified point.
 .sp
 Execution example:
 .INDENT 0.0
@@ -25513,7 +25490,7 @@ Execution example:
 .sp
 .nf
 .ft C
-select Cities \-\-output_columns _score \-\-filter 1 \-\-scorer \(aq_score = geo_distance(location, "185428000x\-461000", "ellipsoid")\(aq
+select Geo \-\-output_columns distance \-\-scorer \(aqdistance = geo_distance("146566000x\-266422000", "185428000x\-461000", "rectangle")\(aq
 # [
 #   [
 #     0,
@@ -25527,12 +25504,12 @@ select Cities \-\-output_columns _score \-\-filter 1 \-\-scorer \(aq_score = geo
 #       ],
 #       [
 #         [
-#           "_score",
+#           "distance",
 #           "Int32"
 #         ]
 #       ],
 #       [
-#         5706263
+#         5807750
 #       ]
 #     ]
 #   ]
@@ -25541,14 +25518,242 @@ select Cities \-\-output_columns _score \-\-filter 1 \-\-scorer \(aq_score = geo
 .fi
 .UNINDENT
 .UNINDENT
-.SS Return value
 .sp
-\fBgeo_distance\fP returns the value of distance in float type.
-The unit of return value is meter.
-Footnote
-.IP [1] 5
-You can specify whether TokyoGeoPoint or WGS84GeoPoint.
-.SS geo_in_circle
+Here are samples about calculating the value of distance with explicitly specified point across meridian, equator, the date line.
+.sp
+Execution example:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+select Geo \-\-output_columns distance \-\-scorer \(aqdistance = geo_distance("175904000x8464000", "145508000x\-13291000", "rectangle")\(aq
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         1
+#       ],
+#       [
+#         [
+#           "distance",
+#           "Int32"
+#         ]
+#       ],
+#       [
+#         1051293
+#       ]
+#     ]
+#   ]
+# ]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+This sample shows the value of distance across meridian.
+The return value of \fBgeo_distance("175904000x8464000", "145508000x\-13291000", "rectangle")\fP is the value of distance from Paris, Flance to Madrid, Spain.
+.sp
+Execution example:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+select Geo \-\-output_columns distance \-\-scorer \(aqdistance = geo_distance("146566000x\-266422000", "\-56880000x\-172310000", "rectangle")\(aq
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         1
+#       ],
+#       [
+#         [
+#           "distance",
+#           "Int32"
+#         ]
+#       ],
+#       [
+#         6880439
+#       ]
+#     ]
+#   ]
+# ]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+This sample shows the value of distance across equator.
+The return value of \fBgeo_distance("146566000x\-266422000", "\-56880000x\-172310000", "rectangle")\fP is the value of distance from New York, The United Status to Brasillia, Brasil.
+.sp
+Execution example:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+select Geo \-\-output_columns distance \-\-scorer \(aqdistance = geo_distance("143660000x419009000", "135960000x\-440760000", "rectangle")\(aq
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         1
+#       ],
+#       [
+#         [
+#           "distance",
+#           "Int32"
+#         ]
+#       ],
+#       [
+#         10475205
+#       ]
+#     ]
+#   ]
+# ]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+This sample shows the value of distance across the date line.
+The return value of \fBgeo_distance("143660000x419009000", "135960000x\-440760000", "rectangle")\fP is the value of distance from Beijin, China to San Francisco, The United States.
+.sp
+\fBNOTE:\fP
+.INDENT 0.0
+.INDENT 3.5
+\fBgeo_distance\fP uses square approximation as default. If you omit \fBapproximate_type\fP, \fBgeo_distance\fP behaves like \fBrectangle\fP was specified.
+.UNINDENT
+.UNINDENT
+.sp
+\fBNOTE:\fP
+.INDENT 0.0
+.INDENT 3.5
+\fBgeo_distance\fP accepts the string indicating the coordinate as
+the value of \fBpoint1\fP when the value of \fBapproximate_type\fP is
+\fB"rectangle"\fP.
+If you specified the string indicating the coordinate as the value
+of \fBpoint1\fP with \fBsphere\fP or \fBellipsoid\fP, \fBgeo_distance\fP
+returns 0 as the value of distance.
+.UNINDENT
+.UNINDENT
+.SS \fBsphere\fP
+.sp
+This parameter require to approximate the geographical features
+by spherical approximation for calculating the distance.
+.sp
+It is slower than \fBrectangle\fP, but the error of distance becomes
+smaller than \fBrectangle\fP.
+.sp
+You can also specify \fBsphr\fP as abbrev expression.
+.sp
+Here is a sample about calculating the value of distance with column value.
+.sp
+Execution example:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+select Cities \-\-output_columns _score \-\-filter 1 \-\-scorer \(aq_score = geo_distance(location, "185428000x\-461000", "sphere")\(aq
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         1
+#       ],
+#       [
+#         [
+#           "_score",
+#           "Int32"
+#         ]
+#       ],
+#       [
+#         5715102
+#       ]
+#     ]
+#   ]
+# ]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS \fBellipsoid\fP
+.sp
+This parameter require to approximate the geographical features
+by ellipsoid approximation for calculating the distance.
+.sp
+It uses the calculation of distance by the formula of Hubeny.
+It is slower than \fBsphere\fP, but the error of distance becomes
+smaller than \fBsphere\fP.
+.sp
+You can also specify \fBellip\fP as abbrev expression.
+.sp
+Here is a sample about calculating the value of distance with column value.
+.sp
+Execution example:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+select Cities \-\-output_columns _score \-\-filter 1 \-\-scorer \(aq_score = geo_distance(location, "185428000x\-461000", "ellipsoid")\(aq
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         1
+#       ],
+#       [
+#         [
+#           "_score",
+#           "Int32"
+#         ]
+#       ],
+#       [
+#         5706263
+#       ]
+#     ]
+#   ]
+# ]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS Return value
+.sp
+\fBgeo_distance\fP returns the value of distance in float type.
+The unit of return value is meter.
+Footnote
+.IP [1] 5
+You can specify whether TokyoGeoPoint or WGS84GeoPoint.
+.SS geo_in_circle
 .SS 名前
 .sp
 geo_in_circle \- 座標が円の範囲内に存在するかどうかを調べます。
@@ -27370,7 +27575,7 @@ can always map database files onto memory. It is no problem until
 groonga touch mapped database files that their size is larger than
 memory and swap. Groonga recommends the configuration.
 .sp
-See \fI\%Linux kernel documentaion about overcommit\fP
+See \fI\%Linux kernel documentation about overcommit\fP
 about \fBvm.overcommit_memory\fP parameter details.
 .sp
 You can set the configuration by putting a configuration file
@@ -27640,13 +27845,153 @@ TODO...
 .SS Reference
 .INDENT 0.0
 .TP
-.B grn_obj *grn_column_create(grn_ctx\fI\ *ctx\fP, grn_obj\fI\ *table\fP, const char\fI\ *name\fP, unsigned int\fI\ name_size\fP, const char\fI\ *path\fP, grn_obj_flags\fI\ flags\fP, grn_obj\fI\ *type\fP)
-tableに新たなカラムを定義します。nameは省略できません。一つのtableに同一のnameのcolumnを複数定義することはできません。
+.B GRN_COLUMN_NAME_ID
+It returns the name of \fB/reference/pseudo_column\fP \fB_id\fP.
+.sp
+It is useful to use with \fBGRN_COLUMN_NAME_ID_LEN\fP like
+the following:
 .INDENT 7.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+grn_obj *id_column;
+id_column = grn_ctx_get(ctx, GRN_COLUMN_NAME_ID, GRN_COLUMN_NAME_ID_LEN);
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Since 3.1.1.
+.UNINDENT
+.INDENT 0.0
 .TP
-.B Parameters
+.B GRN_COLUMN_NAME_ID_LEN
+It returns the byte size of \fBGRN_COLUMN_NAME_ID\fP.
+.sp
+Since 3.1.1.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B GRN_COLUMN_NAME_KEY
+It returns the name of \fB/reference/pseudo_column\fP \fB_key\fP.
+.sp
+It is useful to use with \fBGRN_COLUMN_NAME_KEY_LEN\fP like
+the following:
 .INDENT 7.0
-.IP \(bu 2
+.INDENT 3.5
+.sp
+.nf
+.ft C
+grn_obj *key_column;
+key_column = grn_ctx_get(ctx, GRN_COLUMN_NAME_KEY, GRN_COLUMN_NAME_KEY_LEN);
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Since 3.1.1.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B GRN_COLUMN_NAME_KEY_LEN
+It returns the byte size of \fBGRN_COLUMN_NAME_KEY\fP.
+.sp
+Since 3.1.1.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B GRN_COLUMN_NAME_VALUE
+It returns the name of \fB/reference/pseudo_column\fP \fB_value\fP.
+.sp
+It is useful to use with \fBGRN_COLUMN_NAME_VALUE_LEN\fP like
+the following:
+.INDENT 7.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+grn_obj *value_column;
+value_column = grn_ctx_get(ctx, GRN_COLUMN_NAME_VALUE, GRN_COLUMN_NAME_VALUE_LEN);
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Since 3.1.1.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B GRN_COLUMN_NAME_VALUE_LEN
+It returns the byte size of \fBGRN_COLUMN_NAME_VALUE\fP.
+.sp
+Since 3.1.1.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B GRN_COLUMN_NAME_SCORE
+It returns the name of \fB/reference/pseudo_column\fP \fB_score\fP.
+.sp
+It is useful to use with \fBGRN_COLUMN_NAME_SCORE_LEN\fP like
+the following:
+.INDENT 7.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+grn_obj *score_column;
+score_column = grn_ctx_get(ctx, GRN_COLUMN_NAME_SCORE, GRN_COLUMN_NAME_SCORE_LEN);
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Since 3.1.1.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B GRN_COLUMN_NAME_SCORE_LEN
+It returns the byte size of \fBGRN_COLUMN_NAME_SCORE\fP.
+.sp
+Since 3.1.1.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B GRN_COLUMN_NAME_NSUBRECS
+It returns the name of \fB/reference/pseudo_column\fP \fB_nsubrecs\fP.
+.sp
+It is useful to use with \fBGRN_COLUMN_NAME_NSUBRECS_LEN\fP like
+the following:
+.INDENT 7.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+grn_obj *nsubrecs_column;
+nsubrecs_column = grn_ctx_get(ctx, GRN_COLUMN_NAME_NSUBRECS, GRN_COLUMN_NAME_NSUBRECS_LEN);
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Since 3.1.1.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B GRN_COLUMN_NAME_NSUBRECS_LEN
+It returns the byte size of \fBGRN_COLUMN_NAME_NSUBRECS\fP.
+.sp
+Since 3.1.1.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B grn_obj *grn_column_create(grn_ctx\fI\ *ctx\fP, grn_obj\fI\ *table\fP, const char\fI\ *name\fP, unsigned int\fI\ name_size\fP, const char\fI\ *path\fP, grn_obj_flags\fI\ flags\fP, grn_obj\fI\ *type\fP)
+tableに新たなカラムを定義します。nameは省略できません。一つのtableに同一のnameのcolumnを複数定義することはできません。
+.INDENT 7.0
+.TP
+.B Parameters
+.INDENT 7.0
+.IP \(bu 2
 \fBtable\fP \-\- 対象tableを指定します。
 .IP \(bu 2
 \fBname\fP \-\- カラム名を指定します。
@@ -27893,7 +28238,7 @@ If \fBctx\fP is initialized by \fBgrn_ctx_open()\fP not \fBgrn_ctx_init()\fP. Yo
 .B grn_ctx *grn_ctx_open(int\fI\ flags\fP)
 初期化された \fBgrn_ctx\fP オブジェクトを返します。
 .sp
-\fBgrn_ctx_init()\fP で初期化された \fBgrn_ctx\fP オブジェクトは構造体の実体をAPIの呼び元で確保するのに対して、 \fBgrn_ctx_open()\fP ではgroongaライブラリの内部で、実体を確保します。
+\fBgrn_ctx_init()\fP で初期化された \fBgrn_ctx\fP オブジェクトは構造体の実体をAPIの呼び元で確保するのに対して、 \fBgrn_ctx_open()\fP ではGroongaライブラリの内部で、実体を確保します。
 どちらで初期化された \fBgrn_ctx\fP も、 \fBgrn_ctx_fin()\fP で解放できます。
 \fBgrn_ctx_open()\fP で確保した \fBgrn_ctx\fP 構造体に関しては、\fBgrn_ctx_fin()\fP で解放した後に、その \fBgrn_ctx\fP で作成した \fBgrn_obj\fP を \fBgrn_obj_close()\fP によって解放しても問題ありません。
 .INDENT 7.0
@@ -28740,7 +29085,7 @@ nameはアクセサ文字列の場合、それに対応するaccessorを返し
 .INDENT 0.0
 .TP
 .B grn_bool grn_obj_is_builtin(grn_ctx\fI\ *ctx\fP, grn_obj\fI\ *obj\fP)
-Check whether groonga built\-in object.
+Check whether Groonga built\-in object.
 .INDENT 7.0
 .TP
 .B Parameters
@@ -30565,294 +30910,576 @@ groongaは基本的に完全一致検索のみを行います。上記の例で
 .UNINDENT
 .UNINDENT
 .sp
-とトークナイズされるため、完全一致しません。
-.sp
-groongaは完全一致検索した結果のヒット件数が所定の閾値を超えない場合に限り、非わかち書き検索を行い、それでもヒット件数が閾値を超えない場合は部分一致検索を行います（閾値は1がデフォルト値となっています）。このケースのデータは部分一致検索ではヒットするので、「東京都」クエリのみを指定するとヒットします。
-.sp
-しかし、以下のように全文検索前にすでに閾値が越えている場合（「updated_at < 1285858800」で1件ヒットし、閾値を越える）は、たとえ完全一致検索で1件もヒットしない場合でも部分一致検索などを行いません。:
+とトークナイズされるため、完全一致しません。
+.sp
+groongaは完全一致検索した結果のヒット件数が所定の閾値を超えない場合に限り、非わかち書き検索を行い、それでもヒット件数が閾値を超えない場合は部分一致検索を行います（閾値は1がデフォルト値となっています）。このケースのデータは部分一致検索ではヒットするので、「東京都」クエリのみを指定するとヒットします。
+.sp
+しかし、以下のように全文検索前にすでに閾値が越えている場合（「updated_at < 1285858800」で1件ヒットし、閾値を越える）は、たとえ完全一致検索で1件もヒットしない場合でも部分一致検索などを行いません。:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+select Blogs \-\-filter \(aqupdated_at < 1285858800 && body @ "東京都"\(aq
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+そのため、条件の順序を変えると検索結果が変わるという状況が発生します。以下で、この情報を回避する方法を2種類紹介しますが、それぞれトレードオフとなる条件があるので採用するかどうかを十分検討してください。
+.SS 対策方法1: トークナイザーを変更する
+.sp
+TokenMecabトークナイザーは事前に準備した辞書を用いてトークナイズするため、再現率よりも適合率を重視したトークナイザーと言えます。一方、TokenBigramなど、N\-gram系のトークナイザーは適合率を重視したトークナイザーと言えます。例えば、TokenMecabの場合「東京都」で「京都」に完全一致することはありませんが、TokenBigramでは完全一致します。一方、TokenMecabでは「東京都民」に完全一致しませんが、TokenBigramでは完全一致します。
+.sp
+このようにN\-gram系のトークナイザーを指定することにより再現率をあげることができますが、適合率が下がり検索ノイズが含まれる可能性が高くなります。この度合いを調整するためには \fB/reference/commands/select\fP のmatch_columnsで使用する索引毎に重み付けを指定します。
+.sp
+ここでも、前述の例を使って具体例を示します。まず、TokenBigramを用いた索引を追加します。:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+table_create Bigram TABLE_PAT_KEY|KEY_NORMALIZE ShortText \-\-default_tokenizer TokenBigram
+column_create Bigram blog_body COLUMN_INDEX|WITH_POSITION Blogs body
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+この状態でも以前はマッチしなかったレコードがヒットするようになります。:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+> select Blogs \-\-filter \(aqupdated_at < 1285858800 && body @ "東京都"\(aq
+[[0,7163.448064902,0.000418127],[[[1],[["_id","UInt32"],["updated_at","Time"],["body","ShortText"]],[1,1285031914.0,"東京都民に深刻なダメージを与えました。"]]]]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+しかし、N\-gram系のトークナイザーの方がTokenMecabトークナイザーよりも語のヒット数が多いため、N\-gram系のヒットスコアの方が重く扱われてしまいます。N\-gram系のトークナイザーの方がTokenMecabトークナイザーよりも適合率の低い場合が多いので、このままでは検索ノイズが上位に表示される可能性が高くなります。
+.sp
+そこで、TokenMecabトークナイザーを使って作った索引の方をTokenBigramトークナイザーを使って作った索引よりも重視するように重み付けを指定します。これは、match_columnsオプションで指定できます。:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+> select Blogs \-\-match_columns \(aqTerms.blog_body * 10 || Bigram.blog_body * 3\(aq \-\-query \(aq東京都\(aq \-\-output_columns \(aq_score, body\(aq
+[[0,8167.364602632,0.000647003],[[[1],[["_score","Int32"],["body","ShortText"]],[13,"東京都民に深刻なダメージを与えました。"]]]]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+この場合はスコアが11になっています。内訳は、Terms.blog_body索引（TokenMecabトークナイザーを使用）でマッチしたので10、Bigram.blog_body索引（TokenBigramトークナイザーを使用）でマッチしたので3、これらを合計して13になっています。このようにTokenMecabトークナイザーの重みを高くすることにより、検索ノイズが上位にくることを抑えつつ再現率を上げることができます。
+.sp
+この例は日本語だったのでTokenBigramトークナイザーでよかったのですが、アルファベットの場合はTokenBigramSplitSymbolAlphaトークナイザーなども利用する必要があります。例えば、「楽しいbilliard」はTokenBigramトークナイザーでは
+.INDENT 0.0
+.INDENT 3.5
+楽し / しい / billiard
+.UNINDENT
+.UNINDENT
+.sp
+となり、「bill」では完全一致しません。一方、TokenBigramSplitSymbolAlphaトークナイザーを使うと
+.INDENT 0.0
+.INDENT 3.5
+楽し / しい / いb / bi / il / ll / li / ia / ar / rd / d
+.UNINDENT
+.UNINDENT
+.sp
+となり、「bill」でも完全一致します。
+.sp
+TokenBigramSplitSymbolAlphaトークナイザーを使う場合も重み付けを考慮する必要があることはかわりありません。
+.sp
+利用できるバイグラム系のトークナイザーの一覧は以下の通りです。
+.INDENT 0.0
+.IP \(bu 2
+TokenBigram: バイグラムでトークナイズする。連続する記号・アルファベット・数字は一語として扱う。
+.IP \(bu 2
+TokenBigramSplitSymbol: 記号もバイグラムでトークナイズする。連続するアルファベット・数字は一語として扱う。
+.IP \(bu 2
+TokenBigramSplitSymbolAlpha: 記号とアルファベットもバイグラムでトークナイズする。連続する数字は一語として扱う。
+.IP \(bu 2
+TokenBigramSplitSymbolAlphaDigit: 記号・アルファベット・数字もバイグラムでトークナイズする。
+.IP \(bu 2
+TokenBigramIgnoreBlank: バイグラムでトークナイズする。連続する記号・アルファベット・数字は一語として扱う。空白は無視する。
+.IP \(bu 2
+TokenBigramIgnoreBlankSplitSymbol: 記号もバイグラムでトークナイズする。連続するアルファベット・数字は一語として扱う。空白は無視する。
+.IP \(bu 2
+TokenBigramIgnoreBlankSplitSymbolAlpha: 記号とアルファベットもバイグラムでトークナイズする。連続する数字は一語として扱う。空白は無視する。
+.IP \(bu 2
+TokenBigramIgnoreBlankSplitSymbolAlphaDigit: 記号・アルファベット・数字もバイグラムでトークナイズする。空白は無視する。
+.UNINDENT
+.SS 対策方法2: 閾値をあげる
+.sp
+非わかち書き検索・部分一致検索を利用するかどうかの閾値は\-\-with\-match\-escalation\-threshold configureオプションで変更することができます。以下のように指定すると、100件以下のヒット数であれば、たとえ完全一致検索でヒットしても、非わかち書き検索・部分一致検索を行います。:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% ./configure \-\-with\-match\-escalation\-threashold=100
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+この場合も対策方法1同様、検索ノイズが上位に現れる可能性が高くなることに注意してください。検索ノイズが多くなった場合は指定する値を低くする必要があります。
+.SS How to avoid mmap Cannot allocate memory error
+.SS Example
+.sp
+There is a case following mmap error in log file:
+.INDENT 0.0
+.INDENT 3.5
+2013\-06\-04 08:19:34.835218|A|4e86e700|mmap(4194304,551,432017408)=Cannot allocate memory <13036498944>
+.UNINDENT
+.UNINDENT
+.sp
+Note that <13036498944> means total size of mmap (almost 12GB) in this case.
+.SS Solution
+.sp
+So you need to confirm following point of views.
+.INDENT 0.0
+.IP \(bu 2
+Are there enough free memory?
+.IP \(bu 2
+Are maximum number of mappings exceeded?
+.UNINDENT
+.sp
+To check there are enough free memory, you can use vmstat command.
+.sp
+To check whether maximum number of mappings are exceeded, you can investigate the value of vm.max_map_count.
+.sp
+If this issue is fixed by modifying the value of vm.max_map_count, it\(aqs exactly the reason.
+.sp
+As groonga allocates memory chunks each 256KB, you can estimate the size of database you can handle by following formula:
+.INDENT 0.0
+.INDENT 3.5
+(database size) = vm.max_map_count * (memory chunks)
+.UNINDENT
+.UNINDENT
+.sp
+If you want to handle over 16GB groonga database, you must specify at least 65536 as the value of vm.max_map_count:
+.INDENT 0.0
+.INDENT 3.5
+database size (16GB) = vm.max_map_count (65536) * memory chunks (256KB)
+.UNINDENT
+.UNINDENT
+.sp
+You can modify vm.max_map_count temporary by sudo sysctl \-w vm.max_map_count=65536.
+.sp
+Then save the configuration value to /etc/sysctl.conf or /etc/sysctl.d/
+.nf
+*
+.fi
+.conf.
+.sp
+See \fB/reference/tuning\fP documentation about tuning related parameters.
+.SH DEVELOPMENT
+.sp
+This section describes about developing with groonga. You may develop
+an application that uses groonga as its database, a library that uses
+libgroonga, language bindings of libgroonga and so on.
+.SS Travis CI
+.sp
+This section describes about using groonga on \fI\%Travis CI\fP. Travis CI is a hosted continuous
+integration service for the open source community.
+.sp
+You can use Travis CI for your open source software. This section only
+describes about groonga related configuration. See \fI\%Travis CI:
+Documentation\fP about general
+Travis CI.
+.SS Configuration
+.sp
+Travis CI is running on 64\-bit Ubuntu 12.04 LTS Server Edition. (See \fI\%Travis CI: About
+Travis CI Environment\fP.)  You can
+use apt\-line for Ubuntu 12.04 LTS provided by groonga project to install
+groonga on Travis CI.
+.sp
+You can custom build lifecycle by \fB.travis.yml\fP. (See \fI\%Travis CI:
+Conifugration your Travis CI build with .travis.yml\fP.) You
+can use \fBbefore_install\fP hook or \fBinstall\fP hook. You should use
+\fBbefore_install\fP if your software uses a language that is supported
+by Travis CI such as Ruby. You should use \fBinstall\fP otherwise.
+.sp
+Add the following \fBbefore_install\fP configuration to \fB.travis.yml\fP:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+before_install:
+  \- curl https://raw.github.com/groonga/groonga/master/data/travis/setup.sh | sh
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+If you need to use \fBinstall\fP hook instead of \fBbefore_install\fP, you
+just substitute \fBbefore_install:\fP with \fBinstall:\fP.
+.sp
+With the above configuration, you can use groonga for your build.
+.SS Examples
+.sp
+Here are open source softwares that use groonga on Travis CI:
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.IP \(bu 2
+\fI\%rroonga\fP (Ruby bindings)
+.INDENT 2.0
+.IP \(bu 2
+\fI\%rroonga on Travis CI\fP
+.IP \(bu 2
+\fI\%.travis.yml for rroonga\fP
+.UNINDENT
+.IP \(bu 2
+\fI\%nroonga\fP (node.js bindings)
+.INDENT 2.0
+.IP \(bu 2
+\fI\%nroonga on Travis CI\fP
+.IP \(bu 2
+\fI\%.travis.yml for nroonga\fP
+.UNINDENT
+.IP \(bu 2
+\fI\%logaling\-command\fP (A glossary management command line tool)
+.INDENT 2.0
+.IP \(bu 2
+\fI\%logaling\-command on Travis CI\fP
+.IP \(bu 2
+\fI\%.travis.yml for logaling\-command\fP
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.SH HOW TO CONTRIBUTE TO GROONGA
+.sp
+We welcome your contributions to the groonga project. There are many ways
+to contribute, such as using groonga, introduction to others, etc.
+For example, if you find a bug when using groonga, you are welcome to
+report the bug. Coding and documentation are also welcome for groonga and
+its related projects.
+.INDENT 0.0
+.TP
+.B As a user:
+If you are interested in groonga, please read this document and try it.
+.TP
+.B As a spokesman:
+Please introduce groonga to your friends and colleagues.
+.TP
+.B As a developer: Bug report, development and documentation
+This section describes the details.
+.UNINDENT
+.SS How to report a bug
+.sp
+There are two ways to report a bug:
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.IP \(bu 2
+Submit a bug to the issue tracker
+.IP \(bu 2
+Report a bug to the mailing list
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.sp
+You can use either way It makes no difference to us.
+.SS Submit a bug to the issue tracker
+.sp
+Groonga project has two issue tracking systems, \fI\%Redmine\fP and \fI\%GitHub
+issue tracker\fP.  Redmine
+is for Japanese and GitHub issue tracker is for English. You can use
+one of them to report a bug.
+.SS Report a bug to the mailing list
+.sp
+Groonga project has \fB/community\fP for discussing about groonga.
+Please send a mail that describes a bug.
+.SS How to contribute in documentation topics
+.sp
+We use \fI\%Sphinx\fP for documentation tool.
+.SS C API
+.sp
+We still have C API documentation in include/groonga.h. But
+we want to move them into doc/source/c\-api/*.txt. We welcome
+to you help us by moving C API documentation.
+.sp
+We will use \fI\%the C domain markup\fP of Sphinx.
+.SS I18N
+.sp
+We only had documentation in Japanese.  We start to support
+I18N documentation by gettext based \fI\%Sphinx I18N feature\fP.
+We\(aqll use English as base language and translate
+English into other languages such as Japanese. We\(aqll put
+all documentations into doc/source/ and process them by
+Sphinx.
+.sp
+But we still use Japanese in doc/source/ for now. We need to
+translate Japanese documentation in doc/source/ into
+English. We welcome to you help us by translating
+documentation.
+.SS Translation flow
+.sp
+After doc/source/*.txt are updated, we can start translation.
+.sp
+Here is a translation flow:
+.INDENT 0.0
+.IP 1. 3
+Clone groonga repository.
+.IP 2. 3
+Update .po files.
+.IP 3. 3
+Edit .po files.
+.IP 4. 3
+Generate HTML files.
+.IP 5. 3
+Confirm HTML output.
+.IP 6. 3
+Repeat 2.\-4. until you get good result.
+.IP 7. 3
+Send your works to us!
+.UNINDENT
+.sp
+Here are command lines to do the above flow. Following
+sections describes details.
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-select Blogs \-\-filter \(aqupdated_at < 1285858800 && body @ "東京都"\(aq
+# Please fork https://github.com/groonga/groonga on GitHub
+% git clone https://github.com/${YOUR_GITHUB_ACCOUNT}/groonga.git
+% ./autogen.sh
+% ./configure
+% cd doc/locale/${LANGUAGE}/LC_MESSAGES # ${LANGUAGE} is language code such as \(aqja\(aq.
+% make update # *.po are updated
+% editor *.po # translate *.po # you can use your favorite editor
+% cd ..
+% make html
+% browser html/index.html # confirm translation
+% git add LC_MESSAGES/*.po
+% git commit
+% git push
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
+.SS How to clone groonga repository
 .sp
-そのため、条件の順序を変えると検索結果が変わるという状況が発生します。以下で、この情報を回避する方法を2種類紹介しますが、それぞれトレードオフとなる条件があるので採用するかどうかを十分検討してください。
-.SS 対策方法1: トークナイザーを変更する
-.sp
-TokenMecabトークナイザーは事前に準備した辞書を用いてトークナイズするため、再現率よりも適合率を重視したトークナイザーと言えます。一方、TokenBigramなど、N\-gram系のトークナイザーは適合率を重視したトークナイザーと言えます。例えば、TokenMecabの場合「東京都」で「京都」に完全一致することはありませんが、TokenBigramでは完全一致します。一方、TokenMecabでは「東京都民」に完全一致しませんが、TokenBigramでは完全一致します。
-.sp
-このようにN\-gram系のトークナイザーを指定することにより再現率をあげることができますが、適合率が下がり検索ノイズが含まれる可能性が高くなります。この度合いを調整するためには \fB/reference/commands/select\fP のmatch_columnsで使用する索引毎に重み付けを指定します。
-.sp
-ここでも、前述の例を使って具体例を示します。まず、TokenBigramを用いた索引を追加します。:
+First, please fork groonga repository on GitHub. You
+just access \fI\%https://github.com/groonga/groonga\fP and press
+\fIFork\fP button. Now you can clone your groonga repository:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-table_create Bigram TABLE_PAT_KEY|KEY_NORMALIZE ShortText \-\-default_tokenizer TokenBigram
-column_create Bigram blog_body COLUMN_INDEX|WITH_POSITION Blogs body
+% git clone https://github.com/${YOUR_GITHUB_ACCOUNT}/groonga.git
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-この状態でも以前はマッチしなかったレコードがヒットするようになります。:
+Then you need to configure your cloned repository:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-> select Blogs \-\-filter \(aqupdated_at < 1285858800 && body @ "東京都"\(aq
-[[0,7163.448064902,0.000418127],[[[1],[["_id","UInt32"],["updated_at","Time"],["body","ShortText"]],[1,1285031914.0,"東京都民に深刻なダメージを与えました。"]]]]
+% cd groonga
+% ./autogen.sh
+% ./configure
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-しかし、N\-gram系のトークナイザーの方がTokenMecabトークナイザーよりも語のヒット数が多いため、N\-gram系のヒットスコアの方が重く扱われてしまいます。N\-gram系のトークナイザーの方がTokenMecabトークナイザーよりも適合率の低い場合が多いので、このままでは検索ノイズが上位に表示される可能性が高くなります。
+The above steps are just needed at the first setup.
 .sp
-そこで、TokenMecabトークナイザーを使って作った索引の方をTokenBigramトークナイザーを使って作った索引よりも重視するように重み付けを指定します。これは、match_columnsオプションで指定できます。:
+If you have troubles on the above steps, you can use source
+files available on \fI\%http://packages.groonga.org/source/groonga/\fP .
+.SS How to update .po files
+.sp
+You can update .po files by running \fImake update\fP on
+doc/locale/${LANGUAGE}/LC_MESSAGES. (Please substitute
+\fI${LANGUAGE}\fP with your language code such as \(aqja\(aq.):
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-> select Blogs \-\-match_columns \(aqTerms.blog_body * 10 || Bigram.blog_body * 3\(aq \-\-query \(aq東京都\(aq \-\-output_columns \(aq_score, body\(aq
-[[0,8167.364602632,0.000647003],[[[1],[["_score","Int32"],["body","ShortText"]],[13,"東京都民に深刻なダメージを与えました。"]]]]
+% cd doc/locale/ja/LC_MESSAGES
+% make update
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
+.SS How to edit .po
 .sp
-この場合はスコアが11になっています。内訳は、Terms.blog_body索引（TokenMecabトークナイザーを使用）でマッチしたので10、Bigram.blog_body索引（TokenBigramトークナイザーを使用）でマッチしたので3、これらを合計して13になっています。このようにTokenMecabトークナイザーの重みを高くすることにより、検索ノイズが上位にくることを抑えつつ再現率を上げることができます。
-.sp
-この例は日本語だったのでTokenBigramトークナイザーでよかったのですが、アルファベットの場合はTokenBigramSplitSymbolAlphaトークナイザーなども利用する必要があります。例えば、「楽しいbilliard」はTokenBigramトークナイザーでは
-.INDENT 0.0
-.INDENT 3.5
-楽し / しい / billiard
-.UNINDENT
-.UNINDENT
-.sp
-となり、「bill」では完全一致しません。一方、TokenBigramSplitSymbolAlphaトークナイザーを使うと
-.INDENT 0.0
-.INDENT 3.5
-楽し / しい / いb / bi / il / ll / li / ia / ar / rd / d
-.UNINDENT
-.UNINDENT
-.sp
-となり、「bill」でも完全一致します。
-.sp
-TokenBigramSplitSymbolAlphaトークナイザーを使う場合も重み付けを考慮する必要があることはかわりありません。
-.sp
-利用できるバイグラム系のトークナイザーの一覧は以下の通りです。
+There are some tools to edit .po files. .po files are just
+text. So you can use your favorite editor. Here is a
+specialized editor for .po file edit list.
 .INDENT 0.0
-.IP \(bu 2
-TokenBigram: バイグラムでトークナイズする。連続する記号・アルファベット・数字は一語として扱う。
-.IP \(bu 2
-TokenBigramSplitSymbol: 記号もバイグラムでトークナイズする。連続するアルファベット・数字は一語として扱う。
-.IP \(bu 2
-TokenBigramSplitSymbolAlpha: 記号とアルファベットもバイグラムでトークナイズする。連続する数字は一語として扱う。
-.IP \(bu 2
-TokenBigramSplitSymbolAlphaDigit: 記号・アルファベット・数字もバイグラムでトークナイズする。
-.IP \(bu 2
-TokenBigramIgnoreBlank: バイグラムでトークナイズする。連続する記号・アルファベット・数字は一語として扱う。空白は無視する。
-.IP \(bu 2
-TokenBigramIgnoreBlankSplitSymbol: 記号もバイグラムでトークナイズする。連続するアルファベット・数字は一語として扱う。空白は無視する。
-.IP \(bu 2
-TokenBigramIgnoreBlankSplitSymbolAlpha: 記号とアルファベットもバイグラムでトークナイズする。連続する数字は一語として扱う。空白は無視する。
-.IP \(bu 2
-TokenBigramIgnoreBlankSplitSymbolAlphaDigit: 記号・アルファベット・数字もバイグラムでトークナイズする。空白は無視する。
+.TP
+.B Emacs\(aqs \fI\%po\-mode\fP
+It is bundled in gettext.
+.TP
+.B \fI\%Poedit\fP
+It is a .po editor and works on many platform.
+.TP
+.B gted
+It is also a .po editor and is implemented as Eclipse plugin.
 .UNINDENT
-.SS 対策方法2: 閾値をあげる
+.SS How to generate HTML files
 .sp
-非わかち書き検索・部分一致検索を利用するかどうかの閾値は\-\-with\-match\-escalation\-threshold configureオプションで変更することができます。以下のように指定すると、100件以下のヒット数であれば、たとえ完全一致検索でヒットしても、非わかち書き検索・部分一致検索を行います。:
+You can generate HTML files with updated .po files by
+running \fImake html\fP on doc/locale/${LANGUAGE}. (Please
+substitute \fI${LANGUAGE}\fP with your language code such as
+\(aqja\(aq.):
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% ./configure \-\-with\-match\-escalation\-threashold=100
+% cd doc/locale/ja/
+% make html
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-この場合も対策方法1同様、検索ノイズが上位に現れる可能性が高くなることに注意してください。検索ノイズが多くなった場合は指定する値を低くする必要があります。
-.SS How to avoid mmap Cannot allocate memory error
-.SS Example
-.sp
-There is a case following mmap error in log file:
+You can also generate HTML files for all languages by
+running \fImake html\fP on doc/locale:
 .INDENT 0.0
 .INDENT 3.5
-2013\-06\-04 08:19:34.835218|A|4e86e700|mmap(4194304,551,432017408)=Cannot allocate memory <13036498944>
-.UNINDENT
-.UNINDENT
-.sp
-Note that <13036498944> means total size of mmap (almost 12GB) in this case.
-.SS Solution
 .sp
-So you need to confirm following point of views.
-.INDENT 0.0
-.IP \(bu 2
-Are there enough free memory?
-.IP \(bu 2
-Are maximum number of mappings exceeded?
+.nf
+.ft C
+% cd doc/locale
+% make html
+.ft P
+.fi
+.UNINDENT
 .UNINDENT
 .sp
-To check there are enough free memory, you can use vmstat command.
-.sp
-To check whether maximum number of mappings are exceeded, you can investigate the value of vm.max_map_count.
-.sp
-If this issue is fixed by modifying the value of vm.max_map_count, it\(aqs exactly the reason.
-.sp
-As groonga allocates memory chunks each 256KB, you can estimate the size of database you can handle by following formula:
+\fBNOTE:\fP
 .INDENT 0.0
 .INDENT 3.5
-(database size) = vm.max_map_count * (memory chunks)
+.mo files are updated automatically by \fImake html\fP. So
+you don\(aqt care about .mo files.
 .UNINDENT
 .UNINDENT
+.SS How to confirm HTML output
 .sp
-If you want to handle over 16GB groonga database, you must specify at least 65536 as the value of vm.max_map_count:
+HTML files are generated in
+doc/locale/${LANGUAGE}/html/. (Please substitute
+\fI${LANGUAGE}\fP with your language code such as \(aqja\(aq.) You can
+confirm HTML output by your favorite browser:
 .INDENT 0.0
 .INDENT 3.5
-database size (16GB) = vm.max_map_count (65536) * memory chunks (256KB)
-.UNINDENT
-.UNINDENT
-.sp
-You can modify vm.max_map_count temporary by sudo sysctl \-w vm.max_map_count=65536.
 .sp
-Then save the configuration value to /etc/sysctl.conf or /etc/sysctl.d/
 .nf
-*
+.ft C
+% firefox doc/locale/ja/html/index.html
+.ft P
 .fi
-.conf.
-.sp
-See \fB/reference/tuning\fP documentation about tuning related parameters.
-.SH DEVELOPMENT
-.sp
-This section describes about developing with groonga. You may develop
-an application that uses groonga as its detabase, a library that uses
-libgroonga, language bindings of libgroonga and so on.
-.SS Travis CI
-.sp
-This section describes about using groonga on \fI\%Travis CI\fP. Travis CI is a hosted continuous
-integration service for the open source community.
-.sp
-You can use Travis CI for your open source software. This section only
-describes about groonga related configuration. See \fI\%Travis CI:
-Documentation\fP about general
-Travis CI.
-.SS Configuration
-.sp
-Travis CI is running on 32\-bit Ubuntu 11.10. (See \fI\%Travis CI: About
-Travis CI Environment\fP.)  You can
-use apt\-line for Ubuntu 11.10 provided by groonga project to install
-groonga on Travis CI.
+.UNINDENT
+.UNINDENT
+.SS How to send your works
 .sp
-You can custom build lifecycle by \fB.travis.yml\fP. (See \fI\%Travis CI:
-Conifugration your Travis CI build with .travis.yml\fP.) You
-can use \fBbefore_install\fP hook or \fBinstall\fP hook. You should use
-\fBbefore_install\fP if your software uses a language that is supported
-by Travis CI such as Ruby. You should use \fBinstall\fP otherwise.
+We can receive your works via pull request on GitHub or
+E\-mail attachment patch or .po files themselves.
+.SS How to send pull request
 .sp
-Add the following \fBbefore_install\fP configuration to \fB.travis.yml\fP:
+Here are command lines to send pull request:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-before_install:
-  \- curl https://raw.github.com/groonga/groonga/master/data/travis/setup.sh | sh
+% git add doc/locale/ja/LC_MESSAGES/*.po
+% git commit
+% git push
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-If you need to use \fBinstall\fP hook instead of \fBbefore_install\fP, you
-just substitute \fBbefore_install:\fP with \fBinstall:\fP.
-.sp
-With the above configuration, you can use groonga for your build.
-.SS Examples
+Now you can send pull request on GitHub. You just access
+your repository page on GitHub and press \fIPull Request\fP
+button.
 .sp
-Here are open source softwares that use groonga on Travis CI:
+\fBSEE ALSO:\fP
 .INDENT 0.0
 .INDENT 3.5
-.INDENT 0.0
-.IP \(bu 2
-\fI\%rroonga\fP (Ruby bindings)
-.INDENT 2.0
-.IP \(bu 2
-\fI\%rroonga on Travis CI\fP
-.IP \(bu 2
-\fI\%.travis.yml for rroonga\fP
+\fI\%Help.GitHub \- Sending pull requests\fP.
 .UNINDENT
-.IP \(bu 2
-\fI\%nroonga\fP (node.js bindings)
-.INDENT 2.0
-.IP \(bu 2
-\fI\%nroonga on Travis CI\fP
-.IP \(bu 2
-\fI\%.travis.yml for nroonga\fP
 .UNINDENT
-.IP \(bu 2
-\fI\%logaling\-command\fP (A glossary management command line tool)
-.INDENT 2.0
-.IP \(bu 2
-\fI\%logaling\-command on Travis CI\fP
-.IP \(bu 2
-\fI\%.travis.yml for logaling\-command\fP
+.SS How to send patch
+.sp
+Here are command lines to create patch:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% git add doc/locale/ja/LC_MESSAGES/*.po
+% git commit
+% git format\-patch origin/master
+.ft P
+.fi
 .UNINDENT
 .UNINDENT
+.sp
+You can find 000X\-YYY.patch files in the current
+directory. Please send those files to us!
+.sp
+\fBSEE ALSO:\fP
+.INDENT 0.0
+.INDENT 3.5
+\fB/community\fP describes our contact information.
 .UNINDENT
 .UNINDENT
-.SH HOW TO CONTRIBUTE TO GROONGA
+.SS How to send .po files
 .sp
-We welcome your contributions to the groonga project. There are many ways
-to contribute, such as using groonga, introduction to others, etc.
-For example, if you find a bug when using groonga, you are welcome to
-report the bug. Coding and documentation are also welcome for groonga and
-its related projects.
+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.
+.sp
+\fBSEE ALSO:\fP
 .INDENT 0.0
-.TP
-.B As a user:
-If you are interested in groonga, please read this document and try it.
-.TP
-.B As a spokesman:
-Please introduce groonga to your friends and colleagues.
-.TP
-.B As a developer: Bug report, development and documentation
-This section describes the details.
+.INDENT 3.5
+\fB/community\fP describes our contact information.
 .UNINDENT
-.SS How to report a bug
+.UNINDENT
+.SS How to add new language
 .sp
-There are two ways to report a bug:
+Here are command lines to add new translation language:
 .INDENT 0.0
 .INDENT 3.5
-.INDENT 0.0
-.IP \(bu 2
-Submit a bug to the issue tracker
-.IP \(bu 2
-Report a bug to the mailing list
-.UNINDENT
+.sp
+.nf
+.ft C
+% cd doc/locale
+% make add LOCALE=${LANGUAGE} # specify your language code such as \(aqde\(aq.
+.ft P
+.fi
 .UNINDENT
 .UNINDENT
 .sp
-You can use either way It makes no difference to us.
-.SS Submit a bug to the issue tracker
-.sp
-Groonga project has two issue tracking systems, \fI\%Redmine\fP and \fI\%GitHub
-issue tracker\fP.  Redmine
-is for Japanese and GitHub issue tracker is for English. You can use
-one of them to report a bug.
-.SS Report a bug to the mailing list
+Please substitute \fI${LANGUAGE}\fP with your language code such
+as \(aqja\(aq.
 .sp
-Groonga project has \fB/community\fP for discussing about groonga.
-Please send a mail that describes a bug.
+\fBSEE ALSO:\fP
+.INDENT 0.0
+.INDENT 3.5
+\fI\%Codes for the Representation of Names of Languages\fP.
+.UNINDENT
+.UNINDENT
 .SS groonga開発者向け情報
 .SS Repository
 .sp
@@ -30869,8 +31496,8 @@ There is \fI\%the repository of groonga on GitHub\fP. If you want to check\-out
 .UNINDENT
 .sp
 There is \fI\%the list of related projects of groonga\fP (grntest, fluent\-plugin\-groonga and so on).
-.SS groonga 通信アーキテクチャ
-.SS gqtpでのアーキテクチャ
+.SS Groonga 通信アーキテクチャ
+.SS GQTPでのアーキテクチャ
 .INDENT 0.0
 .IP \(bu 2
 comが外部からの接続を受け付ける。
@@ -30896,20 +31523,20 @@ edgeがworkerに結びついていないときは、同時に、ctx_newという
 .UNINDENT
 .SS ユーザーと協力して開発をうまく進めていくための指針
 .sp
-groongaを使ってくれているユーザーと協力して
+Groongaを使ってくれているユーザーと協力して
 開発をうまく進めていくためにこうするといい、という事柄をまとめました。
 まとめておくと、新しく開発に加わる人とも共有することができます。
 .SS twitter編
 .sp
-groongaを使ってもらえるようにtwitterのアカウントgroongaを取得して
+Groongaを使ってもらえるようにtwitterのアカウントGroongaを取得して
 日々、リリースの案内をしたり、ユーザーサポートをしたりしています。
 .sp
 リリースの案内に利用する場合には、やりとりを考えなくて良いですが、
-複数人によるサポートをgroongaで行う場合に、どうサポートするのが
+複数人によるサポートをGroongaで行う場合に、どうサポートするのが
 良いのか/どうしてそうするのかという共通認識を持っていないと一貫性のないサポートとなってしま
 います。
 .sp
-twitterでサポートされている安心感からgroongaユーザーの拡大に繋げる
+twitterでサポートされている安心感からGroongaユーザーの拡大に繋げる
 ことができるようにサポートの際に気をつけることをまとめます。
 .SS 過去のツイートはおさらいしておく
 .SS 理由
@@ -30964,7 +31591,7 @@ twitterは気軽につぶやけることが重要なので、気軽にできな
 .UNINDENT
 .UNINDENT
 .sp
-groonga関連で気軽につぶやけないとなると開発者は困っている人を見つけられないし、利用者は困ったままとなるので、双方にとって嬉しくない状態になっ
+Groonga関連で気軽につぶやけないとなると開発者は困っている人を見つけられないし、利用者は困ったままとなるので、双方にとって嬉しくない状態になっ
 てしまいます。
 .SS 対応
 .sp
@@ -30972,7 +31599,7 @@ twitterでやりとりを完結できるようにします。
 .SS ドキュメント作成
 .SS Sphinxのインストール
 .sp
-groongaのドキュメントは、Sphinxというツールを用いて作成されています。Sphinxは以下のように導入します。:
+Groongaのドキュメントは、Sphinxというツールを用いて作成されています。Sphinxは以下のように導入します。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -31002,7 +31629,7 @@ This document is also ditributed in forms of release source archive and updated
 If you want to refer latest documentation in source form, you can view such files via GitHub repository browser (\fI\%https://github.com/groonga/groonga/tree/master/doc/source\fP).
 .SS pdfの作成
 .sp
-groongaのドキュメントは、pdf出力することもできます。rst2pdfと、IPAフォント(IPA Gothic/IPAexGothic)が必要となります。
+Groongaのドキュメントは、pdf出力することもできます。rst2pdfと、IPAフォント(IPA Gothic/IPAexGothic)が必要となります。
 .SS rst2pdfのインストール
 .sp
 以下のようにしてインストールできます。:
@@ -31031,21 +31658,21 @@ groongaのドキュメントは、pdf出力することもできます。rst2pdf
 .UNINDENT
 .SS クエリの実現
 .sp
-groongaのデータベースには大量のデータを格納し、その中から必要な部分を高速に取り出すことができます。必要な部分をgroongaのデータベースに問い合わせるためのクエリの表現と実行に関して、groongaは複数の手段を用意しています。
+Groongaのデータベースには大量のデータを格納し、その中から必要な部分を高速に取り出すことができます。必要な部分をGroongaのデータベースに問い合わせるためのクエリの表現と実行に関して、Groongaは複数の手段を用意しています。
 .SS クエリ実行のためのインタフェース
 .sp
-groongaは低機能で単純なライブラリインタフェースから、高機能で複雑なコマンドインタフェースまでいくつかの階層的なインタフェースをユーザプログラムに提供しています。
+Groongaは低機能で単純なライブラリインタフェースから、高機能で複雑なコマンドインタフェースまでいくつかの階層的なインタフェースをユーザプログラムに提供しています。
 .sp
 クエリ実行のためのインタフェースも階層的なインタフェースのそれぞれに対応する形で用意されています。以下に低レイヤなインタフェースから順に説明します。
 .SS DB_API
 .sp
-DB_APIは、groongaデータベースを操作するための一群のC言語向けAPI関数を提供します。DB_APIはデータベースを構成する個々の部分に対する単純な操作関数を提供します。DB_APIの機能を組み合わせることによって複雑なクエリを実行することができます。後述のすべてのクエリインタフェースはDB_APIの機能を組み合わせることによって実現されています。
+DB_APIは、Groongaデータベースを操作するための一群のC言語向けAPI関数を提供します。DB_APIはデータベースを構成する個々の部分に対する単純な操作関数を提供します。DB_APIの機能を組み合わせることによって複雑なクエリを実行することができます。後述のすべてのクエリインタフェースはDB_APIの機能を組み合わせることによって実現されています。
 .SS grn_expr
 .sp
-grn_exprは、groongaデータベースに対する検索処理や更新処理のための条件を表現するためのデータ構造で、複数の条件を再帰的に組み合わせてより複雑な条件を表現することができます。grn_exprによって表現されたクエリを実行するためには、grn_table_select()関数を使用します。
-.SS groonga実行ファイル
+grn_exprは、Groongaデータベースに対する検索処理や更新処理のための条件を表現するためのデータ構造で、複数の条件を再帰的に組み合わせてより複雑な条件を表現することができます。grn_exprによって表現されたクエリを実行するためには、grn_table_select()関数を使用します。
+.SS Groonga実行ファイル
 .sp
-groongaデータベースを操作するためのコマンドインタープリタです。渡されたコマンドを解釈し、実行結果を返します。コマンドの実処理はC言語で記述されます。ユーザがC言語で定義した関数を新たなコマンドとしてgroonga実行ファイルに組み込むことができます。各コマンドはいくつかの文字列引数を受け取り、これをクエリとして解釈して実行します。引数をgrn_exprとして解釈するか、別の形式として解釈してDB_APIを使ってデータベースを操作するかはコマンド毎に自由に決めることができます。
+Groongaデータベースを操作するためのコマンドインタープリタです。渡されたコマンドを解釈し、実行結果を返します。コマンドの実処理はC言語で記述されます。ユーザがC言語で定義した関数を新たなコマンドとしてGroonga実行ファイルに組み込むことができます。各コマンドはいくつかの文字列引数を受け取り、これをクエリとして解釈して実行します。引数をgrn_exprとして解釈するか、別の形式として解釈してDB_APIを使ってデータベースを操作するかはコマンド毎に自由に決めることができます。
 .SS grn_exprで表現できるクエリ
 .sp
 grn_exprは代入や関数呼び出しのような様々な操作を表現できますが、この中で検索クエリを表現するgrn_exprのことを特に条件式とよびます。条件式を構成する個々の要素を関係式と呼びます。条件式は一個以上の関係式か、あるいは条件式を論理演算子で結合したものです。
@@ -31283,7 +31910,7 @@ CUTTER_SOURCE_PATH=$HOME/work/cutter/cutter
 .UNINDENT
 .SS ビルド環境の準備
 .sp
-以下にgroongaのリリース作業を行うために事前にインストール
+以下にGroongaのリリース作業を行うために事前にインストール
 しておくべきパッケージを示します。
 .sp
 なお、ビルド環境としては Ubuntu 12.04 LTS(Precise Pangolin)を前提として説明しているため、その他の環境では適宜読み替えて下さい。:
@@ -31328,7 +31955,7 @@ rinseのバージョンが古いとCentOS 5/6パッケージのビルドを行
 リリース作業ではRPMパッケージに対する署名を行います。
 その際、パッケージ署名用の鍵が必要です。
 .sp
-groongaプロジェクトでは署名用の鍵をリリース担当者の公開鍵で暗号化してリポジトリのpackages/ディレクトリ以下へと登録しています。
+Groongaプロジェクトでは署名用の鍵をリリース担当者の公開鍵で暗号化してリポジトリのpackages/ディレクトリ以下へと登録しています。
 .sp
 リリース担当者はリポジトリに登録された秘密鍵を復号した後に鍵のインポートを以下のコマンドにて行います。:
 .INDENT 0.0
@@ -31345,7 +31972,7 @@ groongaプロジェクトでは署名用の鍵をリリース担当者の公開
 .UNINDENT
 .UNINDENT
 .sp
-鍵のインポートが正常終了すると gpg \-\-list\-keys でgroongaの署名用の鍵を確認することができます。:
+鍵のインポートが正常終了すると gpg \-\-list\-keys でGroongaの署名用の鍵を確認することができます。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -31381,7 +32008,7 @@ gpg> quit
 この作業は、新規にリリースを行うことになった担当者やパッケージに署名する鍵に変更があった場合などに行います。
 .SS リリース作業用ディレクトリの作成
 .sp
-groongaのリリース作業ではリリース専用の環境下(コンパイルフラグ)でビルドする必要があります。
+Groongaのリリース作業ではリリース専用の環境下(コンパイルフラグ)でビルドする必要があります。
 .sp
 リリース時と開発時でディレクトリを分けずに作業することもできますが、誤ったコンパイルフラグでリリースしてしまう危険があります。
 .sp
@@ -31432,13 +32059,13 @@ groongaのリリース作業ではリリース専用の環境下(コンパイル
 .IP \(bu 2
 内部的な変更(変数名の変更やらリファクタリング)
 .UNINDENT
-.SS groongaのウェブサイトの取得
+.SS Groongaのウェブサイトの取得
 .sp
-groongaのウェブサイトのソースはgroonga同様にgithubにリポジトリを置いています。
+GroongaのウェブサイトのソースはGroonga同様にgithubにリポジトリを置いています。
 .sp
 リリース作業では後述するコマンド(make update\-latest\-release)にてトップページのバージョンを置き換えることができるようになっています。
 .sp
-groongaのウェブサイトのソースコードを$GROONGA_GITHUB_COM_PATHとして取得するためには、$GROONGA_DIRにて以下のコマンドを実行します。:
+Groongaのウェブサイトのソースコードを$GROONGA_GITHUB_COM_PATHとして取得するためには、$GROONGA_DIRにて以下のコマンドを実行します。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -31453,7 +32080,7 @@ groongaのウェブサイトのソースコードを$GROONGA_GITHUB_COM_PATHと
 これで、$GROONGA_GITHUB_COM_PATHにgroonga.github.comのソースを取得できます。
 .SS cutterのソースコード取得
 .sp
-groongaのリリース作業では、cutterに含まれるスクリプトを使用しています。
+Groongaのリリース作業では、cutterに含まれるスクリプトを使用しています。
 .sp
 そこであらかじめ用意しておいた$HOME/work/cutterディレクトリにてcutterのソースコードを以下のコマンドにて取得します。:
 .INDENT 0.0
@@ -31470,7 +32097,7 @@ groongaのリリース作業では、cutterに含まれるスクリプトを使
 これで、$CUTTER_SOURCE_PATHディレクトリにcutterのソースを取得できます。
 .SS configureスクリプトの生成
 .sp
-groongaのソースコードをcloneした時点ではconfigureスクリプトが含まれておらず、そのままmakeコマンドにてビルドすることができません。
+Groongaのソースコードをcloneした時点ではconfigureスクリプトが含まれておらず、そのままmakeコマンドにてビルドすることができません。
 .sp
 $GROONGA_CLONE_DIRにてautogen.shを以下のように実行します。:
 .INDENT 0.0
@@ -31501,11 +32128,11 @@ Makefileを生成するためにconfigureスクリプトを実行します。
 .UNINDENT
 .UNINDENT
 .sp
-configureオプションである\-\-with\-groonga\-github\-com\-pathにはgroongaのウェブサイトのリポジトリをcloneした場所を指定します。
+configureオプションである\-\-with\-groonga\-github\-com\-pathにはGroongaのウェブサイトのリポジトリをcloneした場所を指定します。
 .sp
 configureオプションである\-\-with\-cutter\-source\-pathにはcutterのソースをcloneした場所を指定します。
 .sp
-以下のようにgroongaのソースコードをcloneした先からの相対パスを指定することもできます。:
+以下のようにGroongaのソースコードをcloneした先からの相対パスを指定することもできます。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -31546,7 +32173,7 @@ make update\-latest\-releaseコマンドでは、OLD_RELEASE_DATEに前回のリ
 .UNINDENT
 .UNINDENT
 .sp
-これにより、clone済みのgroongaのWebサイトのトップページのソース(index.html,ja/index.html)やRPMパッケージのspecファイルのバージョン表記などが更新されます。
+これにより、clone済みのGroongaのWebサイトのトップページのソース(index.html,ja/index.html)やRPMパッケージのspecファイルのバージョン表記などが更新されます。
 .SS make update\-filesの実行
 .sp
 ロケールメッセージの更新や変更されたファイルのリスト等を更新するために以下のコマンドを実行します。:
@@ -31679,7 +32306,7 @@ rpmパッケージのビルドに必要なパッケージをダウンロード
 .UNINDENT
 .UNINDENT
 .sp
-これにより、groongaやMySQLのRPM/SRPMパッケージなどがカレントディレクトリ以下へとダウンロードされます。
+これにより、GroongaやMySQLのRPM/SRPMパッケージなどがカレントディレクトリ以下へとダウンロードされます。
 .sp
 windowsパッケージのビルドに必要なパッケージをダウンロードするには以下のコマンドを実行します。:
 .INDENT 0.0
@@ -31694,7 +32321,7 @@ windowsパッケージのビルドに必要なパッケージをダウンロー
 .UNINDENT
 .UNINDENT
 .sp
-これにより、groongaのインストーラやzipアーカイブがカレントディレクトリ以下へとダウンロードされます。
+これにより、Groongaのインストーラやzipアーカイブがカレントディレクトリ以下へとダウンロードされます。
 .sp
 sourceパッケージに必要なものをダウンロードするには以下のコマンドを実行します。:
 .INDENT 0.0
@@ -31713,7 +32340,7 @@ sourceパッケージに必要なものをダウンロードするには以下
 packages/source/filesディレクトリ以下へとダウンロードされます。
 .SS Debian系パッケージのビルド
 .sp
-groongaのpackages/aptサブディレクトリに移動して、以下のコマンドを実行します。:
+Groongaのpackages/aptサブディレクトリに移動して、以下のコマンドを実行します。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -31790,7 +32417,7 @@ make build ではまとめてビルドできないこともあります。
 .UNINDENT
 .SS Red Hat系パッケージのビルド
 .sp
-groongaのpackages/yumサブディレクトリに移動して、以下のコマンドを実行します。:
+Groongaのpackages/yumサブディレクトリに移動して、以下のコマンドを実行します。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -31899,9 +32526,9 @@ Debian系もしくはRed Hat系の場合には本番環境へとアップロー
 .UNINDENT
 .SS grntestの準備
 .sp
-grntestを実行するためにはgroongaのテストデータとgrntestのソースが必要です。
+grntestを実行するためにはGroongaのテストデータとgrntestのソースが必要です。
 .sp
-まずgroongaのソースを任意のディレクトリへと展開します。:
+まずGroongaのソースを任意のディレクトリへと展開します。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -31913,7 +32540,7 @@ grntestを実行するためにはgroongaのテストデータとgrntestのソ
 .UNINDENT
 .UNINDENT
 .sp
-次にgroongaのtest/functionディレクトリ以下にgrntestのソースを展開します。
+次にGroongaのtest/functionディレクトリ以下にgrntestのソースを展開します。
 つまりtest/function/grntestという名前でgrntestのソースを配置します。:
 .INDENT 0.0
 .INDENT 3.5
@@ -31928,7 +32555,7 @@ README.md  binlib  license  test
 .UNINDENT
 .SS grntestの実行方法
 .sp
-grntestではgroongaコマンドを明示的にしていすることができます。
+grntestではGroongaコマンドを明示的にしていすることができます。
 後述のパッケージごとのgrntestによる動作確認では以下のようにして実行します。:
 .INDENT 0.0
 .INDENT 3.5
@@ -32005,7 +32632,7 @@ grntestの正常終了を確認する
 zipアーカイブも同様にしてgrntestを実行し動作確認を行います。
 .SS リリースアナウンスの作成
 .sp
-リリースの際にはリリースアナウンスを流して、groongaを広く通知します。
+リリースの際にはリリースアナウンスを流して、Groongaを広く通知します。
 .sp
 news.txtに変更点をまとめましたが、それを元にリリースアナウンスを作成します。
 .sp
@@ -32021,14 +32648,14 @@ news.txtに変更点をまとめましたが、それを元にリリースアナ
 リリース変更点(news.txtの内容)
 .UNINDENT
 .sp
-リリースのトピック紹介では、これからgroongaを使う人へアピールする点や既存のバージョンを利用している人がアップグレードする際に必要な情報を提供します。
+リリースのトピック紹介では、これからGroongaを使う人へアピールする点や既存のバージョンを利用している人がアップグレードする際に必要な情報を提供します。
 .sp
 非互換な変更が含まれるのであれば、回避方法等の案内を載せることも重要です。
 .sp
 参考までに過去のリリースアナウンスへのリンクを以下に示します。
 .INDENT 0.0
 .IP \(bu 2
-[Groonga\-talk] [ANN] groonga 2.0.2
+[Groonga\-talk] [ANN] Groonga 2.0.2
 .INDENT 2.0
 .INDENT 3.5
 .INDENT 0.0
@@ -32038,7 +32665,7 @@ news.txtに変更点をまとめましたが、それを元にリリースアナ
 .UNINDENT
 .UNINDENT
 .IP \(bu 2
-[groonga\-dev,00794] [ANN] groonga 2.0.2
+[groonga\-dev,00794] [ANN] Groonga 2.0.2
 .INDENT 2.0
 .INDENT 3.5
 .INDENT 0.0
@@ -32189,16 +32816,16 @@ doc/source以下のドキュメントを更新、翻訳まで完了している
 .sp
 OS Xでのパッケージ管理方法として \fI\%Homebrew\fP があります。
 .sp
-groongaを簡単にインストールできるようにするために、Homebrewへpull requestを送ります。
+Groongaを簡単にインストールできるようにするために、Homebrewへpull requestを送ります。
 .INDENT 0.0
 .INDENT 3.5
 \fI\%https://github.com/mxcl/homebrew\fP
 .UNINDENT
 .UNINDENT
 .sp
-すでにgroongaのFormulaは取り込まれているので、リリースのたびにFormulaの内容を更新する作業を実施します。
+すでにGroongaのFormulaは取り込まれているので、リリースのたびにFormulaの内容を更新する作業を実施します。
 .sp
-groonga 3.0.6のときは以下のように更新してpull requestを送りました。
+Groonga 3.0.6のときは以下のように更新してpull requestを送りました。
 .INDENT 0.0
 .INDENT 3.5
 \fI\%https://github.com/mxcl/homebrew/pull/21456/files\fP
@@ -32217,7 +32844,7 @@ Groonga\-talk \fI\%groonga\-talk@lists.sourceforge.net\fP
 .UNINDENT
 .SS freecode.comへリリース情報を登録
 .sp
-groongaプロジェクトではfreecode.comでもリリース情報を発信しています。
+Groongaプロジェクトではfreecode.comでもリリース情報を発信しています。
 .sp
 freecode.comのプロジェクトページは以下の通りです。
 .INDENT 0.0
@@ -32255,14 +32882,14 @@ blogroongaのリリースエントリには「リンクをあなたのフォロ
 リリースアナウンスを流し終えたら、次期バージョンの開発が始まります。
 .INDENT 0.0
 .IP \(bu 2
-groonga プロジェクトの新規バージョン追加
+Groonga プロジェクトの新規バージョン追加
 .IP \(bu 2
-groonga のbase_versionの更新
+Groonga のbase_versionの更新
 .UNINDENT
-.SS groonga プロジェクトの新規バージョン追加
+.SS Groonga プロジェクトの新規バージョン追加
 .sp
-\fI\%groonga プロジェクトの設定ページ\fP にて新規バージョンを追加します。(例: release\-2.0.6)
-.SS groonga バージョン更新
+\fI\%Groonga プロジェクトの設定ページ\fP にて新規バージョンを追加します。(例: release\-2.0.6)
+.SS Groonga バージョン更新
 .sp
 $GROONGA_CLONE_DIRにて以下のコマンドを実行します。:
 .INDENT 0.0
@@ -32285,508 +32912,226 @@ base_versionはtar.gzなどのリリース用のファイル名で使用しま
 .UNINDENT
 .UNINDENT
 .SS ビルド時のTIPS
-.SS ビルドを並列化したい
-.sp
-make build PALALLES=yesを指定するとchroot環境で並列にビルドを
-実行できます。
-.SS 特定の環境向けのみビルドしたい
-.sp
-Debian系の場合、CODES,ARCHITECTURESオプションを明示的に指定することで、特定のリリース、アーキテクチャのみビルドすることができます。
-.sp
-squeezeのi386のみビルドしたい場合には以下のコマンドを実行します。:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% make build ARCHITECTURES=i386 CODES=squeeze
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-buildコマンド以外でも build\-package\-deb build\-repository\-debなどのサブタスクでもARCHITECTURES,CODES指定は有効です。
-.sp
-Red Hat系の場合、ARCHITECTURES,DISTRIBUTIONSオプションを明示的に指定することで、特定のリリース、アーキテクチャのみビルドすることができます。
-.sp
-fedoraのi386のみビルドしたい場合には以下のコマンドを実行します。:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% make build ARCHITECTURES=i386 DISTRIBUTIONS=fedora
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-buildコマンド以外でも build\-in\-chroot build\-repository\-rpmなどのサブタスクでもARCHITECTURES,DISTRIBUTIONSの指定は有効です。
-.sp
-centosの場合、CENTOS_VERSIONSを指定することで特定のバージョンのみビルドすることができます。
-.SS パッケージの署名用のパスフレーズを知りたい
-.sp
-パッケージの署名に必要な秘密鍵のパスフレーズについては
-リリース担当者向けの秘密鍵を復号したテキストの1行目に記載してあります。
-.SS バージョンを明示的に指定してドキュメントを生成したい
-.sp
-リリース後にドキュメントの一部を差し替えたい場合、特に何も指定しないと生成したHTMLに埋め込まれるバージョンが「v3.0.1\-xxxxxドキュメント」となってしまうことがあります。gitでのコミット時ハッシュの一部が使われるためです。
-.sp
-これを回避するには、以下のようにDOCUMENT_VERSIONやDOCUMENT_VERSION_FULLを明示的に指定します。:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% make update\-document DOCUMENT_VERSION=3.0.1 DOCUMENT_VERSION_FULL=3.0.1
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.SS テスト方法
-.SS テスト環境の構築
-.SS Cutterのインストール
-.sp
-groongaは、テストのフレームワークとして \fI\%Cutter\fP を用いています。
-.sp
-Cutterのインストール方法は \fI\%プラットフォーム毎のCutterのインストール方法\fP をご覧下さい。
-.SS lcovのインストール
-.sp
-カバレッジ情報を計測するためには、lcov 1.6以上が必要です。DebianやUbuntuでは以下のようにしてインストールできます。:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo aptitude install \-y lcov
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.SS clangのインストール
-.sp
-ソースコードの静的解析を行うためには、clang(scan\-build)をインストールする必要があります。DebianやUbuntuでは以下のようにしてインストールできます。:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo aptitude install \-y clang
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.SS libmemcachedのインストール
-.sp
-memcachedのバイナリプロトコルのテストを動作させるためには、libmemcachedの導入が必要です。squeeze以降のDebianやKarmic以降のUubntuでは以下の用にしてインストールできます。:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo aptitude install \-y libmemcached\-dev
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.SS テストの動作
-.sp
-groongaのトップディレクトリで、以下のコマンドを実行します。:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-make check
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.SS カバレッジ情報
-.sp
-groongaのトップディレクトリで、以下のコマンドを実行します。:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-make coverage
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-すると、coverageディレクトリ以下に、カバレッジ情報が入ったhtmlが出力されます。
-.sp
-カバレッジには、Lines/Functions/Branchesの3つの対象があります。それぞれ、行／関数／分岐に対応します。Functionsがもっとも重要な対象です。すべての関数がテストされるようになっていることを心がけてください。
-.sp
-テストがカバーしていない部分の編集は慎重に行ってください。また、テストがカバーしている部分を増やすことも重要です。
-.SS 様々なテスト
-.sp
-テストは、test/unitディレクトリにおいて、./run\-test.shを実行することによっても行えます。run\-test.shはいくつかのオプションをとります。詳細は、./run\-test.sh \-\-helpを実行しヘルプをご覧ください。
-.SS 特定のテスト関数のみテストする
-.sp
-特定のテスト関数(Cutterではテストと呼ぶ)のみをテストすることができます。
-.sp
-実行例:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% ./run\-test.sh \-n test_text_otoj
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.SS 特定のテストファイルのみテストする
-.sp
-特定のテストファイル(Cutterではテストケースと呼ぶ)のみテストすることができます。
-.sp
-実行例:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% ./run\-test.sh \-t test_string
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.SS 不正メモリアクセス・メモリリーク検出
-.sp
-環境変数CUTTER_CHECK_LEAKをyesと設定すると、valgrindを用いて不正メモリアクセスやメモリリークを検出しつつ、テストを動作させることができます。
-.sp
-run\-test.shのみならず、make checkでも利用可能です。
-.sp
-実行例:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% CUTTER_CHECK_LEAK=yes make check
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.SS デバッガ上でのテスト実行
+.SS ビルドを並列化したい
 .sp
-環境変数CUTTER_DEBUGをyesと設定すると、テストが実行できる環境が整ったgdbが実行されます。gdb上でrunを行うと、テストの実行が開始されます。
+make build PALALLES=yesを指定するとchroot環境で並列にビルドを
+実行できます。
+.SS 特定の環境向けのみビルドしたい
 .sp
-run\-test.shのみならず、make checkでも利用可能です。
+Debian系の場合、CODES,ARCHITECTURESオプションを明示的に指定することで、特定のリリース、アーキテクチャのみビルドすることができます。
 .sp
-実行例:
+squeezeのi386のみビルドしたい場合には以下のコマンドを実行します。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% CUTTER_DEBUG=yes make check
+% make build ARCHITECTURES=i386 CODES=squeeze
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
-.SS 静的解析
 .sp
-scan\-buildを用いて、ソースコードの静的解析を行うことができます。scan_buildというディレクトリに解析結果のhtmlが出力されます。:
+buildコマンド以外でも build\-package\-deb build\-repository\-debなどのサブタスクでもARCHITECTURES,CODES指定は有効です。
+.sp
+Red Hat系の場合、ARCHITECTURES,DISTRIBUTIONSオプションを明示的に指定することで、特定のリリース、アーキテクチャのみビルドすることができます。
+.sp
+fedoraのi386のみビルドしたい場合には以下のコマンドを実行します。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% scan\-build ./configure \-\-prefix=/usr
-% make clean
-% scan\-build \-o ./scan_build make \-j4
+% make build ARCHITECTURES=i386 DISTRIBUTIONS=fedora
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-configureは１度のみ実行する必要があります。
-.SS How to contribute in documentation topics
-.sp
-We use \fI\%Sphinx\fP for documentation tool.
-.SS C API
-.sp
-We still have C API documentation in include/groonga.h. But
-we want to move them into doc/source/c\-api/*.txt. We welcome
-to you help us by moving C API documentation.
-.sp
-We will use \fI\%the C domain markup\fP of Sphinx.
-.SS I18N
-.sp
-We only had documentation in Japanese.  We start to support
-I18N documentation by gettext based \fI\%Sphinx I18N feature\fP.
-We\(aqll use English as base language and translate
-English into other languages such as Japanese. We\(aqll put
-all documentations into doc/source/ and process them by
-Sphinx.
+buildコマンド以外でも build\-in\-chroot build\-repository\-rpmなどのサブタスクでもARCHITECTURES,DISTRIBUTIONSの指定は有効です。
 .sp
-But we still use Japanese in doc/source/ for now. We need to
-translate Japanese documentation in doc/source/ into
-English. We welcome to you help us by translating
-documentation.
-.SS Translation flow
+centosの場合、CENTOS_VERSIONSを指定することで特定のバージョンのみビルドすることができます。
+.SS パッケージの署名用のパスフレーズを知りたい
 .sp
-After doc/source/*.txt are updated, we can start translation.
+パッケージの署名に必要な秘密鍵のパスフレーズについては
+リリース担当者向けの秘密鍵を復号したテキストの1行目に記載してあります。
+.SS バージョンを明示的に指定してドキュメントを生成したい
 .sp
-Here is a translation flow:
-.INDENT 0.0
-.IP 1. 3
-Clone groonga repository.
-.IP 2. 3
-Update .po files.
-.IP 3. 3
-Edit .po files.
-.IP 4. 3
-Generate HTML files.
-.IP 5. 3
-Confirm HTML output.
-.IP 6. 3
-Repeat 2.\-4. until you get good result.
-.IP 7. 3
-Send your works to us!
-.UNINDENT
+リリース後にドキュメントの一部を差し替えたい場合、特に何も指定しないと生成したHTMLに埋め込まれるバージョンが「v3.0.1\-xxxxxドキュメント」となってしまうことがあります。gitでのコミット時ハッシュの一部が使われるためです。
 .sp
-Here are command lines to do the above flow. Following
-sections describes details.
+これを回避するには、以下のようにDOCUMENT_VERSIONやDOCUMENT_VERSION_FULLを明示的に指定します。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-# Please fork https://github.com/groonga/groonga on GitHub
-% git clone https://github.com/${YOUR_GITHUB_ACCOUNT}/groonga.git
-% ./autogen.sh
-% ./configure
-% cd doc/locale/${LANGUAGE}/LC_MESSAGES # ${LANGUAGE} is language code such as \(aqja\(aq.
-% make update # *.po are updated
-% editor *.po # translate *.po # you can use your favorite editor
-% cd ..
-% make html
-% browser html/index.html # confirm translation
-% git add LC_MESSAGES/*.po
-% git commit
-% git push
+% make update\-document DOCUMENT_VERSION=3.0.1 DOCUMENT_VERSION_FULL=3.0.1
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
-.SS How to clone groonga repository
+.SS テスト方法
+.SS テスト環境の構築
+.SS Cutterのインストール
 .sp
-First, please fork groonga repository on GitHub. You
-just access \fI\%https://github.com/groonga/groonga\fP and press
-\fIFork\fP button. Now you can clone your groonga repository:
+Groongaは、テストのフレームワークとして \fI\%Cutter\fP を用いています。
+.sp
+Cutterのインストール方法は \fI\%プラットフォーム毎のCutterのインストール方法\fP をご覧下さい。
+.SS lcovのインストール
+.sp
+カバレッジ情報を計測するためには、lcov 1.6以上が必要です。DebianやUbuntuでは以下のようにしてインストールできます。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% git clone https://github.com/${YOUR_GITHUB_ACCOUNT}/groonga.git
+% sudo aptitude install \-y lcov
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
+.SS clangのインストール
 .sp
-Then you need to configure your cloned repository:
+ソースコードの静的解析を行うためには、clang(scan\-build)をインストールする必要があります。DebianやUbuntuでは以下のようにしてインストールできます。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% cd groonga
-% ./autogen.sh
-% ./configure
+% sudo aptitude install \-y clang
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
+.SS libmemcachedのインストール
 .sp
-The above steps are just needed at the first setup.
-.sp
-If you have troubles on the above steps, you can use source
-files available on \fI\%http://packages.groonga.org/source/groonga/\fP .
-.SS How to update .po files
-.sp
-You can update .po files by running \fImake update\fP on
-doc/locale/${LANGUAGE}/LC_MESSAGES. (Please substitute
-\fI${LANGUAGE}\fP with your language code such as \(aqja\(aq.):
+memcachedのバイナリプロトコルのテストを動作させるためには、libmemcachedの導入が必要です。squeeze以降のDebianやKarmic以降のUubntuでは以下の用にしてインストールできます。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% cd doc/locale/ja/LC_MESSAGES
-% make update
+% sudo aptitude install \-y libmemcached\-dev
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
-.SS How to edit .po
-.sp
-There are some tools to edit .po files. .po files are just
-text. So you can use your favorite editor. Here is a
-specialized editor for .po file edit list.
-.INDENT 0.0
-.TP
-.B Emacs\(aqs \fI\%po\-mode\fP
-It is bundled in gettext.
-.TP
-.B \fI\%Poedit\fP
-It is a .po editor and works on many platform.
-.TP
-.B gted
-It is also a .po editor and is implemented as Eclipse plugin.
-.UNINDENT
-.SS How to generate HTML files
+.SS テストの動作
 .sp
-You can generate HTML files with updated .po files by
-running \fImake html\fP on doc/locale/${LANGUAGE}. (Please
-substitute \fI${LANGUAGE}\fP with your language code such as
-\(aqja\(aq.):
+Groongaのトップディレクトリで、以下のコマンドを実行します。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% cd doc/locale/ja/
-% make html
+make check
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
+.SS カバレッジ情報
 .sp
-You can also generate HTML files for all languages by
-running \fImake html\fP on doc/locale:
+Groongaのトップディレクトリで、以下のコマンドを実行します。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% cd doc/locale
-% make html
+make coverage
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-\fBNOTE:\fP
-.INDENT 0.0
-.INDENT 3.5
-.mo files are updated automatically by \fImake html\fP. So
-you don\(aqt care about .mo files.
-.UNINDENT
-.UNINDENT
-.SS How to confirm HTML output
+すると、coverageディレクトリ以下に、カバレッジ情報が入ったhtmlが出力されます。
 .sp
-HTML files are generated in
-doc/locale/${LANGUAGE}/html/. (Please substitute
-\fI${LANGUAGE}\fP with your language code such as \(aqja\(aq.) You can
-confirm HTML output by your favorite browser:
+カバレッジには、Lines/Functions/Branchesの3つの対象があります。それぞれ、行／関数／分岐に対応します。Functionsがもっとも重要な対象です。すべての関数がテストされるようになっていることを心がけてください。
+.sp
+テストがカバーしていない部分の編集は慎重に行ってください。また、テストがカバーしている部分を増やすことも重要です。
+.SS 様々なテスト
+.sp
+テストは、test/unitディレクトリにおいて、./run\-test.shを実行することによっても行えます。run\-test.shはいくつかのオプションをとります。詳細は、./run\-test.sh \-\-helpを実行しヘルプをご覧ください。
+.SS 特定のテスト関数のみテストする
+.sp
+特定のテスト関数(Cutterではテストと呼ぶ)のみをテストすることができます。
+.sp
+実行例:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% firefox doc/locale/ja/html/index.html
+% ./run\-test.sh \-n test_text_otoj
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
-.SS How to send your works
+.SS 特定のテストファイルのみテストする
 .sp
-We can receive your works via pull request on GitHub or
-E\-mail attachment patch or .po files themselves.
-.SS How to send pull request
+特定のテストファイル(Cutterではテストケースと呼ぶ)のみテストすることができます。
 .sp
-Here are command lines to send pull request:
+実行例:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% git add doc/locale/ja/LC_MESSAGES/*.po
-% git commit
-% git push
+% ./run\-test.sh \-t test_string
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
+.SS 不正メモリアクセス・メモリリーク検出
 .sp
-Now you can send pull request on GitHub. You just access
-your repository page on GitHub and press \fIPull Request\fP
-button.
+環境変数CUTTER_CHECK_LEAKをyesと設定すると、valgrindを用いて不正メモリアクセスやメモリリークを検出しつつ、テストを動作させることができます。
 .sp
-\fBSEE ALSO:\fP
-.INDENT 0.0
-.INDENT 3.5
-\fI\%Help.GitHub \- Sending pull requests\fP.
-.UNINDENT
-.UNINDENT
-.SS How to send patch
+run\-test.shのみならず、make checkでも利用可能です。
 .sp
-Here are command lines to create patch:
+実行例:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% git add doc/locale/ja/LC_MESSAGES/*.po
-% git commit
-% git format\-patch origin/master
+% CUTTER_CHECK_LEAK=yes make check
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
+.SS デバッガ上でのテスト実行
 .sp
-You can find 000X\-YYY.patch files in the current
-directory. Please send those files to us!
-.sp
-\fBSEE ALSO:\fP
-.INDENT 0.0
-.INDENT 3.5
-\fB/community\fP describes our contact information.
-.UNINDENT
-.UNINDENT
-.SS How to send .po files
+環境変数CUTTER_DEBUGをyesと設定すると、テストが実行できる環境が整ったgdbが実行されます。gdb上でrunを行うと、テストの実行が開始されます。
 .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.
+run\-test.shのみならず、make checkでも利用可能です。
 .sp
-\fBSEE ALSO:\fP
+実行例:
 .INDENT 0.0
 .INDENT 3.5
-\fB/community\fP describes our contact information.
+.sp
+.nf
+.ft C
+% CUTTER_DEBUG=yes make check
+.ft P
+.fi
 .UNINDENT
 .UNINDENT
-.SS How to add new language
+.SS 静的解析
 .sp
-Here are command lines to add new translation language:
+scan\-buildを用いて、ソースコードの静的解析を行うことができます。scan_buildというディレクトリに解析結果のhtmlが出力されます。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% cd doc/locale
-% make add LOCALE=${LANGUAGE} # specify your language code such as \(aqde\(aq.
+% scan\-build ./configure \-\-prefix=/usr
+% make clean
+% scan\-build \-o ./scan_build make \-j4
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-Please substitute \fI${LANGUAGE}\fP with your language code such
-as \(aqja\(aq.
-.sp
-\fBSEE ALSO:\fP
-.INDENT 0.0
-.INDENT 3.5
-\fI\%Codes for the Representation of Names of Languages\fP.
-.UNINDENT
-.UNINDENT
+configureは１度のみ実行する必要があります。
 .INDENT 0.0
 .IP \(bu 2
 \fIgenindex\fP