rroonga 4.0.4-x86-mingw32 → 4.0.5-x86-mingw32

data/vendor/local/share/license/onigmo/AUTHORS

@@ -0,0 +1,2 @@
+kentkt AT csc DOT jp (K.Takata)
+sndgk393 AT ybb DOT ne DOT jp (K.Kosako)

data/vendor/local/share/license/onigmo/COPYING

@@ -0,0 +1,87 @@
+Onigmo (Oniguruma-mod) LICENSE
+------------------------------
+
+/*-
+ * Copyright (c) 2002-2009  K.Kosako  <sndgk393 AT ybb DOT ne DOT jp>
+ * Copyright (c) 2011-2014  K.Takata  <kentkt AT csc DOT jp>
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ */
+
+
+
+Oniguruma LICENSE
+-----------------
+
+/*-
+ * Copyright (c) 2002-2009  K.Kosako  <sndgk393 AT ybb DOT ne DOT jp>
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ */
+
+
+
+Ruby BSDL
+---------
+Copyright (C) 1993-2013 Yukihiro Matsumoto. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+1. Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright
+notice, this list of conditions and the following disclaimer in the
+documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGE.

data/vendor/local/share/license/onigmo/README

@@ -0,0 +1,249 @@
+README  2014/07/18
+
+Onigmo (Oniguruma-mod)  --  (C) K.Takata <kentkt AT csc DOT jp>
+
+https://github.com/k-takata/Onigmo
+
+Onigmo is a regular expressions library forked from Oniguruma.
+Some of new features introduced in Perl 5.10+ can be used.
+
+Some patches are merged from Ruby 2.x.
+
+See also the Wiki page:
+https://github.com/k-takata/Onigmo/wiki
+
+
+Main New features:
+  Regular Expressions (depends on the syntax):
+    \K, \R, \X, (?(cond)yes|no)
+    (?adlu), \g{name}, \g{n}, (?&name), (?n), (?R), (?0)
+    (?P<name>...), (?P=name), (?P>name)
+
+  API:
+    onig_search_gpos (for Perl-compatible \G)
+
+  Encoding:
+    CP932
+
+  Syntax:
+    Python
+
+
+New Source Files:
+  enc/cp932.c                   CP932 encoding.
+  enc/jis/props.h               JIS character properties data.
+  enc/jis/props.kwd             JIS character properties data.
+  enc/unicode/casefold.h        Unicode case folding data.
+  enc/unicode/name2ctype.h      Unicode properties data.
+
+  onig.py                       onig.dll/libonig.so loader.
+  testpy.py                     test program.
+
+  tool/download-ucd.sh          downloads Unicode Character Database (UCD).
+  tool/case-folding.rb          generates casefold.h from UCD.
+  tool/convert-jis-props.sh     converts props.kwd to props.h.
+  tool/convert-name2ctype.sh    converts name2ctype.kwd to name2ctypes.h.
+  tool/enc-unicode.rb           generates name2ctype.kwd from UCD.
+
+  win32/Makefile.mingw          Makefile for Win32 (MinGW)
+  win32/makedef.py              creates onig.def.
+  win32/onig.rc                 resource file for onig.dll.
+
+
+ToDo:
+  * Reduce the size of Unicode Character Data.
+  * (?|...)
+  * Improve (?(cond)yes|no). (support look-ahead/behind assertions.)
+
+
+Oniguruma's README follows:
+======================================================================
+README  2007/05/31
+
+Oniguruma  ----   (C) K.Kosako <sndgk393 AT ybb DOT ne DOT jp>
+
+http://www.geocities.jp/kosako3/oniguruma/
+
+Oniguruma is a regular expressions library.
+The characteristics of this library is that different character encoding
+for every regular expression object can be specified.
+
+Supported character encodings:
+
+  ASCII, UTF-8, UTF-16BE, UTF-16LE, UTF-32BE, UTF-32LE,
+  EUC-JP, EUC-TW, EUC-KR, EUC-CN,
+  Shift_JIS, Big5, GB18030, KOI8-R, CP1251,
+  ISO-8859-1, ISO-8859-2, ISO-8859-3, ISO-8859-4, ISO-8859-5,
+  ISO-8859-6, ISO-8859-7, ISO-8859-8, ISO-8859-9, ISO-8859-10,
+  ISO-8859-11, ISO-8859-13, ISO-8859-14, ISO-8859-15, ISO-8859-16
+
+* GB18030: contributed by KUBO Takehiro
+* CP1251:  contributed by Byte
+------------------------------------------------------------
+
+License
+
+   BSD license.
+
+
+Install
+
+ Case 1: Unix and Cygwin platform
+
+   1. ./configure
+   2. make
+   3. make install
+
+   * uninstall
+
+     make uninstall
+
+   * test (ASCII/EUC-JP)
+
+     make atest
+
+   * configuration check
+
+     onig-config --cflags
+     onig-config --libs
+     onig-config --prefix
+     onig-config --exec-prefix
+
+
+
+ Case 2: Win32 platform (VC++)
+
+   1. copy win32\Makefile Makefile
+   2. copy win32\config.h config.h
+   3. nmake
+
+      onig_s.lib:  static link library
+      onig.dll:    dynamic link library
+
+  * test (ASCII/Shift_JIS)
+   4. copy win32\testc.c testc.c
+   5. nmake ctest
+
+
+
+Regular Expressions
+
+  See doc/RE (or doc/RE.ja for Japanese).
+
+
+Usage
+
+  Include oniguruma.h in your program. (Oniguruma API)
+  See doc/API for Oniguruma API.
+
+  If you want to disable UChar type (== unsigned char) definition
+  in oniguruma.h, define ONIG_ESCAPE_UCHAR_COLLISION and then
+  include oniguruma.h.
+
+  If you want to disable regex_t type definition in oniguruma.h,
+  define ONIG_ESCAPE_REGEX_T_COLLISION and then include oniguruma.h.
+
+  Example of the compiling/linking command line in Unix or Cygwin,
+  (prefix == /usr/local case)
+
+    cc sample.c -L/usr/local/lib -lonig
+
+
+  If you want to use static link library(onig_s.lib) in Win32,
+  add option -DONIG_EXTERN=extern to C compiler.
+
+
+
+Sample Programs
+
+  sample/simple.c    example of the minimum (Oniguruma API)
+  sample/names.c     example of the named group callback.
+  sample/encode.c    example of some encodings.
+  sample/listcap.c   example of the capture history.
+  sample/posix.c     POSIX API sample.
+  sample/sql.c       example of the variable meta characters.
+                     (SQL-like pattern matching)
+
+Test Programs
+  sample/syntax.c    Perl, Java and ASIS syntax test.
+  sample/crnl.c      --enable-crnl-as-line-terminator test
+
+
+Source Files
+
+  oniguruma.h        Oniguruma API header file. (public)
+  onig-config.in     configuration check program template.
+
+  regenc.h           character encodings framework header file.
+  regint.h           internal definitions
+  regparse.h         internal definitions for regparse.c and regcomp.c
+  regcomp.c          compiling and optimization functions
+  regenc.c           character encodings framework.
+  regerror.c         error message function
+  regext.c           extended API functions. (deluxe version API)
+  regexec.c          search and match functions
+  regparse.c         parsing functions.
+  regsyntax.c        pattern syntax functions and built-in syntax definitions.
+  regtrav.c          capture history tree data traverse functions.
+  regversion.c       version info function.
+  st.h               hash table functions header file
+  st.c               hash table functions
+
+  oniggnu.h          GNU regex API header file. (public)
+  reggnu.c           GNU regex API functions
+
+  onigposix.h        POSIX API header file. (public)
+  regposerr.c        POSIX error message function.
+  regposix.c         POSIX API functions.
+
+  enc/mktable.c      character type table generator.
+  enc/ascii.c        ASCII encoding.
+  enc/euc_jp.c       EUC-JP encoding.
+  enc/euc_tw.c       EUC-TW encoding.
+  enc/euc_kr.c       EUC-KR, EUC-CN encoding.
+  enc/sjis.c         Shift_JIS encoding.
+  enc/big5.c         Big5      encoding.
+  enc/gb18030.c      GB18030   encoding.
+  enc/koi8.c         KOI8      encoding.
+  enc/koi8_r.c       KOI8-R    encoding.
+  enc/cp1251.c       CP1251    encoding.
+  enc/iso8859_1.c    ISO-8859-1  encoding. (Latin-1)
+  enc/iso8859_2.c    ISO-8859-2  encoding. (Latin-2)
+  enc/iso8859_3.c    ISO-8859-3  encoding. (Latin-3)
+  enc/iso8859_4.c    ISO-8859-4  encoding. (Latin-4)
+  enc/iso8859_5.c    ISO-8859-5  encoding. (Cyrillic)
+  enc/iso8859_6.c    ISO-8859-6  encoding. (Arabic)
+  enc/iso8859_7.c    ISO-8859-7  encoding. (Greek)
+  enc/iso8859_8.c    ISO-8859-8  encoding. (Hebrew)
+  enc/iso8859_9.c    ISO-8859-9  encoding. (Latin-5 or Turkish)
+  enc/iso8859_10.c   ISO-8859-10 encoding. (Latin-6 or Nordic)
+  enc/iso8859_11.c   ISO-8859-11 encoding. (Thai)
+  enc/iso8859_13.c   ISO-8859-13 encoding. (Latin-7 or Baltic Rim)
+  enc/iso8859_14.c   ISO-8859-14 encoding. (Latin-8 or Celtic)
+  enc/iso8859_15.c   ISO-8859-15 encoding. (Latin-9 or West European with Euro)
+  enc/iso8859_16.c   ISO-8859-16 encoding.
+                     (Latin-10 or South-Eastern European with Euro)
+  enc/utf8.c         UTF-8    encoding.
+  enc/utf16_be.c     UTF-16BE encoding.
+  enc/utf16_le.c     UTF-16LE encoding.
+  enc/utf32_be.c     UTF-32BE encoding.
+  enc/utf32_le.c     UTF-32LE encoding.
+  enc/unicode.c      Unicode information data.
+
+  win32/Makefile     Makefile for Win32 (VC++)
+  win32/config.h     config.h for Win32
+
+
+
+ToDo
+
+  ? case fold flag: Katakana <-> Hiragana.
+  ? add ONIG_OPTION_NOTBOS/NOTEOS. (\A, \z, \Z)
+ ?? \X (== \PM\pM*)
+ ?? implement syntax behavior ONIG_SYN_CONTEXT_INDEP_ANCHORS.
+ ?? transmission stopper. (return ONIG_STOP from match_at())
+
+and I'm thankful to Akinori MUSHA.
+
+
+Mail Address: K.Kosako <sndgk393 AT ybb DOT ne DOT jp>

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

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "GROONGA" "1" "2014 年 08 月 28 日" "4.0.5" "Groonga"
+.TH "GROONGA" "1" "2014 年 09 月 28 日" "4.0.6" "Groonga"
 .SH NAME
 groonga \- Groonga documentation
 .
@@ -97,7 +97,7 @@ Groonga は独自のカラムストアを持つ列指向のデータベースと
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.5\-x86.exe\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.6\-x86.exe\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -109,7 +109,7 @@ Groonga は独自のカラムストアを持つ列指向のデータベースと
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.5\-x64.exe\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.6\-x64.exe\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -124,7 +124,7 @@ Groonga は独自のカラムストアを持つ列指向のデータベースと
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.5\-x86.zip\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.6\-x86.zip\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -136,7 +136,7 @@ Groonga は独自のカラムストアを持つ列指向のデータベースと
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.5\-x64.zip\fP
+\fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.6\-x64.zip\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -163,7 +163,7 @@ zipアーカイブをpackages.groonga.orgからダウンロードしてくださ
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-\fI\%http://packages.groonga.org/source/groonga/groonga\-4.0.5.zip\fP
+\fI\%http://packages.groonga.org/source/groonga/groonga\-4.0.6.zip\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -176,7 +176,7 @@ Groongaのソースフォルダへと移動します:
 .sp
 .nf
 .ft C
-> cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-4.0.5
+> cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-4.0.6
 .ft P
 .fi
 .UNINDENT
@@ -188,7 +188,7 @@ Groongaのソースフォルダへと移動します:
 .sp
 .nf
 .ft C
-groonga\-4.0.5> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\egroonga
+groonga\-4.0.6> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\egroonga
 .ft P
 .fi
 .UNINDENT
@@ -200,7 +200,7 @@ groonga\-4.0.5> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\
 .sp
 .nf
 .ft C
-groonga\-4.0.5> cmake \-\-build . \-\-config Release
+groonga\-4.0.6> cmake \-\-build . \-\-config Release
 .ft P
 .fi
 .UNINDENT
@@ -212,7 +212,7 @@ groonga\-4.0.5> cmake \-\-build . \-\-config Release
 .sp
 .nf
 .ft C
-groonga\-4.0.5> cmake \-\-build . \-\-config Release \-\-target Install
+groonga\-4.0.6> cmake \-\-build . \-\-config Release \-\-target Install
 .ft P
 .fi
 .UNINDENT
@@ -270,9 +270,9 @@ groonga\-4.0.5> cmake \-\-build . \-\-config Release \-\-target Install
 .sp
 .nf
 .ft C
-% curl \-O http://packages.groonga.org/source/groonga/groonga\-4.0.5.tar.gz
-% tar xvzf groonga\-4.0.5.tar.gz
-% cd groonga\-4.0.5
+% curl \-O http://packages.groonga.org/source/groonga/groonga\-4.0.6.tar.gz
+% tar xvzf groonga\-4.0.6.tar.gz
+% cd groonga\-4.0.6
 .ft P
 .fi
 .UNINDENT
@@ -410,110 +410,113 @@ groonga\-normalizer\-mysqlパッケージのインストール:
 .fi
 .UNINDENT
 .UNINDENT
-.SS jessie
-.sp
-Groongaのaptリポジトリを追加します。
+.SS ソースからビルド
 .sp
-/etc/apt/sources.list.d/groonga.list:
+Groongaをビルドするために必要なパッケージをインストールします:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-deb http://packages.groonga.org/debian/ jessie main
-deb\-src http://packages.groonga.org/debian/ jessie main
+% sudo apt\-get install \-y \-V  wget tar build\-essential zlib1g\-dev liblzo2\-dev libmsgpack\-dev libzmq\-dev libevent\-dev libmecab\-dev
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-インストール:
+ソースをダウンロードします:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% sudo apt\-get update
-% sudo apt\-get install \-y \-\-allow\-unauthenticated groonga\-keyring
-% sudo apt\-get update
-% sudo apt\-get install \-y groonga
+% wget http://packages.groonga.org/source/groonga/groonga\-4.0.6.tar.gz
+% tar xvzf groonga\-4.0.6.tar.gz
+% cd groonga\-4.0.6
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-\fBノート:\fP
+configureを実行します（ \fBconfigure\fP のオプションについては \fIsource\-configure\fP を参照してください）:
 .INDENT 0.0
 .INDENT 3.5
-\fBgroonga\fP パッケージは全文検索のための最小構成パッケージです。Groongaをサーバー用途で使うなら、設定済みの追加パッケージをインストールすることができます。
-.sp
-サーバー用途のための3つのパッケージがあります。
-.INDENT 0.0
-.IP \(bu 2
-groonga\-server\-http (簡易HTTPサーバー)
-.IP \(bu 2
-groonga\-httpd (nginxを元にしたHTTPサーバー)
-.IP \(bu 2
-groonga\-server\-gqtp (GQTPサーバー)
-.UNINDENT
 .sp
-詳細は \fB/server\fP を参照してください。
+.nf
+.ft C
+% ./configure
+.ft P
+.fi
 .UNINDENT
 .UNINDENT
 .sp
-\fI\%MeCab\fP をトークナイザーとして使いたいときは、groonga\-tokenizer\-mecabパッケージをインストールしてください。
-.sp
-groonga\-tokenizer\-mecabパッケージのインストール:
+ビルド:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% sudo apt\-get install \-y \-V groonga\-tokenizer\-mecab
+% make \-j$(grep \(aq^processor\(aq /proc/cpuinfo | wc \-l)
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-\fI\%Munin\fP プラグインを提供するパッケージもあります。MuninでGroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
-.sp
-groonga\-munin\-pluginsパッケージのインストール:
+インストール:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% sudo apt\-get install \-y \-V groonga\-munin\-plugins
+% sudo make install
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
+.SS Ubuntu
 .sp
-MySQL互換のノーマライザーをGroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
+このセクションではUbuntu上でGroonga関連のdebパッケージをインストールする方法を説明します。これらのパッケージは \fBapt\fP でインストールできます。
 .sp
-groonga\-normalizer\-mysqlパッケージのインストール:
+32\-bit用と64\-bit用のパッケージを配布していますが、サーバ用途には64\-bitパッケージを利用することをオススメします。32\-bit用パッケージはテスト用か開発用にだけ使って下さい。32\-bit用パッケージを使った場合は、中程度のサイズのデータでもメモリ不足エラーになることがあります。
+.SS PPA（Personal Package Archive）
+.sp
+Ubuntu用のGroongaのAPTリポジトリーはLaunchpad上のPPA（Personal Package Archive）を使っています。このPPAからAPTでGroongaをインストールできます。
+.sp
+サポートしているUbuntuのバージョンは次の通りです。
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.IP \(bu 2
+12.04 LTS Precise Pangolin
+.IP \(bu 2
+13.10 Saucy Salamander
+.IP \(bu 2
+14.04 LTS Trusty Tahr
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.sp
+Groongaをインストールするためにuniverseリポジトリを有効にしてください:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% sudo apt\-get install \-y \-V groonga\-normalizer\-mysql
+% sudo apt\-get \-y install software\-properties\-common
+% sudo add\-apt\-repository \-y universe
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
-.SS sid
-.sp
-Groongaのaptリポジトリを追加します。
 .sp
-/etc/apt/sources.list.d/groonga.list:
+\fBppa:groonga/ppa\fP PPAをシステムに登録します:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-deb http://packages.groonga.org/debian/ unstable main
-deb\-src http://packages.groonga.org/debian/ unstable main
+% sudo add\-apt\-repository \-y ppa:groonga/ppa
+% sudo apt\-get update
 .ft P
 .fi
 .UNINDENT
@@ -525,10 +528,7 @@ deb\-src http://packages.groonga.org/debian/ unstable main
 .sp
 .nf
 .ft C
-% sudo apt\-get update
-% sudo apt\-get install \-y \-\-allow\-unauthenticated groonga\-keyring
-% sudo apt\-get update
-% sudo apt\-get install \-y \-V groonga
+% sudo apt\-get \-y install groonga
 .ft P
 .fi
 .UNINDENT
@@ -561,7 +561,7 @@ groonga\-tokenizer\-mecabパッケージのインストール:
 .sp
 .nf
 .ft C
-% sudo apt\-get install \-y \-V groonga\-tokenizer\-mecab
+% sudo apt\-get \-y install groonga\-tokenizer\-mecab
 .ft P
 .fi
 .UNINDENT
@@ -575,7 +575,7 @@ groonga\-munin\-pluginsパッケージのインストール:
 .sp
 .nf
 .ft C
-% sudo apt\-get install \-y \-V groonga\-munin\-plugins
+% sudo apt\-get \-y install groonga\-munin\-plugins
 .ft P
 .fi
 .UNINDENT
@@ -589,7 +589,7 @@ groonga\-normalizer\-mysqlパッケージのインストール:
 .sp
 .nf
 .ft C
-% sudo apt\-get install \-y \-V groonga\-normalizer\-mysql
+% sudo apt\-get \-y install groonga\-normalizer\-mysql
 .ft P
 .fi
 .UNINDENT
@@ -602,7 +602,7 @@ Groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% sudo apt\-get install \-y \-V  wget tar build\-essential zlib1g\-dev liblzo2\-dev libmsgpack\-dev libzmq\-dev libevent\-dev libmecab\-dev
+% sudo apt\-get \-V \-y install wget tar build\-essential zlib1g\-dev liblzo2\-dev libmsgpack\-dev libzmq\-dev libevent\-dev libmecab\-dev
 .ft P
 .fi
 .UNINDENT
@@ -614,9 +614,9 @@ Groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-4.0.5.tar.gz
-% tar xvzf groonga\-4.0.5.tar.gz
-% cd groonga\-4.0.5
+% wget http://packages.groonga.org/source/groonga/groonga\-4.0.6.tar.gz
+% tar xvzf groonga\-4.0.6.tar.gz
+% cd groonga\-4.0.6
 .ft P
 .fi
 .UNINDENT
@@ -657,54 +657,12 @@ configureを実行します（ \fBconfigure\fP のオプションについては
 .fi
 .UNINDENT
 .UNINDENT
-.SS Ubuntu
+.SS CentOS
 .sp
-このセクションではUbuntu上でGroonga関連のdebパッケージをインストールする方法を説明します。これらのパッケージは \fBapt\fP でインストールできます。
+このセクションではCentOS上でGroonga関連のRPMパッケージをインストールする方法を説明します。これらのパッケージは \fByum\fP でインストールできます。
 .sp
 32\-bit用と64\-bit用のパッケージを配布していますが、サーバ用途には64\-bitパッケージを利用することをオススメします。32\-bit用パッケージはテスト用か開発用にだけ使って下さい。32\-bit用パッケージを使った場合は、中程度のサイズのデータでもメモリ不足エラーになることがあります。
-.SS PPA（Personal Package Archive）
-.sp
-Ubuntu用のGroongaのAPTリポジトリーはLaunchpad上のPPA（Personal Package Archive）を使っています。このPPAからAPTでGroongaをインストールできます。
-.sp
-サポートしているUbuntuのバージョンは次の通りです。
-.INDENT 0.0
-.INDENT 3.5
-.INDENT 0.0
-.IP \(bu 2
-12.04 LTS Precise Pangolin
-.IP \(bu 2
-13.10 Saucy Salamander
-.IP \(bu 2
-14.04 LTS Trusty Tahr
-.UNINDENT
-.UNINDENT
-.UNINDENT
-.sp
-Groongaをインストールするためにuniverseリポジトリを有効にしてください:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo apt\-get \-y install software\-properties\-common
-% sudo add\-apt\-repository \-y universe
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-\fBppa:groonga/ppa\fP PPAをシステムに登録します:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo add\-apt\-repository \-y ppa:groonga/ppa
-% sudo apt\-get update
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
+.SS CentOS 5
 .sp
 インストール:
 .INDENT 0.0
@@ -712,7 +670,9 @@ Groongaをインストールするためにuniverseリポジトリを有効に
 .sp
 .nf
 .ft C
-% sudo apt\-get \-y install groonga
+% sudo rpm \-ivh http://packages.groonga.org/centos/groonga\-release\-1.1.0\-1.noarch.rpm
+% sudo yum makecache
+% sudo yum install \-y groonga
 .ft P
 .fi
 .UNINDENT
@@ -745,7 +705,7 @@ groonga\-tokenizer\-mecabパッケージのインストール:
 .sp
 .nf
 .ft C
-% sudo apt\-get \-y install groonga\-tokenizer\-mecab
+% sudo yum install \-y groonga\-tokenizer\-mecab
 .ft P
 .fi
 .UNINDENT
@@ -753,100 +713,78 @@ groonga\-tokenizer\-mecabパッケージのインストール:
 .sp
 \fI\%Munin\fP プラグインを提供するパッケージもあります。MuninでGroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
 .sp
-groonga\-munin\-pluginsパッケージのインストール:
+\fBノート:\fP
 .INDENT 0.0
 .INDENT 3.5
+groonga\-munin\-pluginsパッケージはmunin\-nodeパッケージを必要としますが、munin\-nodeパッケージはCentOSの公式リポジトリには含まれていません。munin\-nodeパッケージを \fByum\fP でインストールするために \fI\%Repoforge (RPMforge)\fP リポジトリか \fI\%EPEL\fP リポジトリを有効にする必要があります。
 .sp
-.nf
-.ft C
-% sudo apt\-get \-y install groonga\-munin\-plugins
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-MySQL互換のノーマライザーをGroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
-.sp
-groonga\-normalizer\-mysqlパッケージのインストール:
+i386環境でRepoforge (RPMforge)リポジトリを有効にする:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% sudo apt\-get \-y install groonga\-normalizer\-mysql
+% wget http://pkgs.repoforge.org/rpmforge\-release/rpmforge\-release\-0.5.3\-1.el5.rf.i386.rpm
+% sudo rpm \-ivh rpmforge\-release\-0.5.2\-2.el5.rf.i386.rpm
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
-.SS ソースからビルド
 .sp
-Groongaをビルドするために必要なパッケージをインストールします:
+x86_64環境でRepoforge (RPMforge)リポジトリを有効にする:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% sudo apt\-get \-V \-y install wget tar build\-essential zlib1g\-dev liblzo2\-dev libmsgpack\-dev libzmq\-dev libevent\-dev libmecab\-dev
+% wget http://pkgs.repoforge.org/rpmforge\-release/rpmforge\-release\-0.5.3\-1.el5.rf.x86_64.rpm
+% sudo rpm \-ivh rpmforge\-release\-0.5.2\-2.el5.rf.x86_64.rpm
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-ソースをダウンロードします:
+EPELリポジトリを有効にする（環境非依存）:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-4.0.5.tar.gz
-% tar xvzf groonga\-4.0.5.tar.gz
-% cd groonga\-4.0.5
+% wget http://download.fedoraproject.org/pub/epel/5/i386/epel\-release\-5\-4.noarch.rpm
+% sudo rpm \-ivh epel\-release\-5\-4.noarch.rpm
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
-.sp
-configureを実行します（ \fBconfigure\fP のオプションについては \fIsource\-configure\fP を参照してください）:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% ./configure
-.ft P
-.fi
 .UNINDENT
 .UNINDENT
 .sp
-ビルド:
+groonga\-munin\-pluginsパッケージのインストール:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% make \-j$(grep \(aq^processor\(aq /proc/cpuinfo | wc \-l)
+% sudo yum install \-y groonga\-munin\-plugins
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-インストール:
+MySQL互換のノーマライザーをGroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
+.sp
+groonga\-normalizer\-mysqlパッケージのインストール:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% sudo make install
+% sudo yum install \-y groonga\-normalizer\-mysql
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
-.SS CentOS
-.sp
-このセクションではCentOS上でGroonga関連のRPMパッケージをインストールする方法を説明します。これらのパッケージは \fByum\fP でインストールできます。
-.sp
-32\-bit用と64\-bit用のパッケージを配布していますが、サーバ用途には64\-bitパッケージを利用することをオススメします。32\-bit用パッケージはテスト用か開発用にだけ使って下さい。32\-bit用パッケージを使った場合は、中程度のサイズのデータでもメモリ不足エラーになることがあります。
-.SS CentOS 5
+.SS CentOS 6
 .sp
 インストール:
 .INDENT 0.0
@@ -900,33 +838,7 @@ groonga\-tokenizer\-mecabパッケージのインストール:
 \fBノート:\fP
 .INDENT 0.0
 .INDENT 3.5
-groonga\-munin\-pluginsパッケージはmunin\-nodeパッケージを必要としますが、munin\-nodeパッケージはCentOSの公式リポジトリには含まれていません。munin\-nodeパッケージを \fByum\fP でインストールするために \fI\%Repoforge (RPMforge)\fP リポジトリか \fI\%EPEL\fP リポジトリを有効にする必要があります。
-.sp
-i386環境でRepoforge (RPMforge)リポジトリを有効にする:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% wget http://pkgs.repoforge.org/rpmforge\-release/rpmforge\-release\-0.5.3\-1.el5.rf.i386.rpm
-% sudo rpm \-ivh rpmforge\-release\-0.5.2\-2.el5.rf.i386.rpm
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-x86_64環境でRepoforge (RPMforge)リポジトリを有効にする:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% wget http://pkgs.repoforge.org/rpmforge\-release/rpmforge\-release\-0.5.3\-1.el5.rf.x86_64.rpm
-% sudo rpm \-ivh rpmforge\-release\-0.5.2\-2.el5.rf.x86_64.rpm
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
+groonga\-munin\-pluginsパッケージはmunin\-nodeパッケージを必要としますが、munin\-nodeパッケージはCentOSの公式リポジトリには含まれていません。munin\-nodeパッケージを \fByum\fP でインストールするために \fI\%EPEL\fP リポジトリを有効にする必要があります。
 .sp
 EPELリポジトリを有効にする（環境非依存）:
 .INDENT 0.0
@@ -934,8 +846,7 @@ EPELリポジトリを有効にする（環境非依存）:
 .sp
 .nf
 .ft C
-% wget http://download.fedoraproject.org/pub/epel/5/i386/epel\-release\-5\-4.noarch.rpm
-% sudo rpm \-ivh epel\-release\-5\-4.noarch.rpm
+% sudo rpm \-ivh http://download.fedoraproject.org/pub/epel/6/i386/epel\-release\-6\-8.noarch.rpm
 .ft P
 .fi
 .UNINDENT
@@ -968,7 +879,7 @@ groonga\-normalizer\-mysqlパッケージのインストール:
 .fi
 .UNINDENT
 .UNINDENT
-.SS CentOS 6
+.SS CentOS 7
 .sp
 インストール:
 .INDENT 0.0
@@ -1024,13 +935,13 @@ groonga\-tokenizer\-mecabパッケージのインストール:
 .INDENT 3.5
 groonga\-munin\-pluginsパッケージはmunin\-nodeパッケージを必要としますが、munin\-nodeパッケージはCentOSの公式リポジトリには含まれていません。munin\-nodeパッケージを \fByum\fP でインストールするために \fI\%EPEL\fP リポジトリを有効にする必要があります。
 .sp
-EPELリポジトリを有効にする（環境非依存）:
+EPELリポジトリを有効にする:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% sudo rpm \-ivh http://download.fedoraproject.org/pub/epel/6/i386/epel\-release\-6\-8.noarch.rpm
+% sudo yum install \-y epel\-release
 .ft P
 .fi
 .UNINDENT
@@ -1083,9 +994,9 @@ Groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-4.0.5.tar.gz
-% tar xvzf groonga\-4.0.5.tar.gz
-% cd groonga\-4.0.5
+% wget http://packages.groonga.org/source/groonga/groonga\-4.0.6.tar.gz
+% tar xvzf groonga\-4.0.6.tar.gz
+% cd groonga\-4.0.6
 .ft P
 .fi
 .UNINDENT
@@ -1271,9 +1182,9 @@ Groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-4.0.5.tar.gz
-% tar xvzf groonga\-4.0.5.tar.gz
-% cd groonga\-4.0.5
+% wget http://packages.groonga.org/source/groonga/groonga\-4.0.6.tar.gz
+% tar xvzf groonga\-4.0.6.tar.gz
+% cd groonga\-4.0.6
 .ft P
 .fi
 .UNINDENT
@@ -1337,9 +1248,9 @@ Groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-4.0.5.tar.gz
-% gtar xvzf groonga\-4.0.5.tar.gz
-% cd groonga\-4.0.5
+% wget http://packages.groonga.org/source/groonga/groonga\-4.0.6.tar.gz
+% gtar xvzf groonga\-4.0.6.tar.gz
+% cd groonga\-4.0.6
 .ft P
 .fi
 .UNINDENT
@@ -1460,9 +1371,9 @@ GroongaはGNUビルドシステムを使っています。以下は一番簡単
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-4.0.5.tar.gz
-% tar xvzf groonga\-4.0.5.tar.gz
-% cd groonga\-4.0.5
+% wget http://packages.groonga.org/source/groonga/groonga\-4.0.6.tar.gz
+% tar xvzf groonga\-4.0.6.tar.gz
+% cd groonga\-4.0.6
 % ./configure
 % make
 % sudo make install
@@ -3830,7 +3741,7 @@ select \-\-table Site \-\-filter "_id <= 2 || _id >= 7" \-\-output_columns _id,_
 .sp
 .nf
 .ft C
-select \-\-table Site \-\-filter "1" \-\-scorer "_score = rand()" \-\-output_columns _id,_key,_score \-\-sortby _score
+select \-\-table Site \-\-filter "true" \-\-scorer "_score = rand()" \-\-output_columns _id,_key,_score \-\-sortby _score
 # [
 #   [
 #     0,
@@ -3904,7 +3815,7 @@ select \-\-table Site \-\-filter "1" \-\-scorer "_score = rand()" \-\-output_col
 #     ]
 #   ]
 # ]
-select \-\-table Site \-\-filter "1" \-\-scorer "_score = rand()" \-\-output_columns _id,_key,_score \-\-sortby _score
+select \-\-table Site \-\-filter "true" \-\-scorer "_score = rand()" \-\-output_columns _id,_key,_score \-\-sortby _score
 # [
 #   [
 #     0,
@@ -4856,7 +4767,7 @@ select \-\-table Site \-\-limit 0 \-\-drilldown country \-\-drilldown_sortby _ns
 .UNINDENT
 .SS ドリルダウン結果の制限
 .sp
-ドリルダウン結果はデフォルト10件に制限されています。 \fBdrilldown_limits\fP と \fBdrilldown_offset\fP パラメータをドリルダウン結果をカスタマイズするのに使います。
+ドリルダウン結果はデフォルト10件に制限されています。 \fBdrilldown_limit\fP と \fBdrilldown_offset\fP パラメータをドリルダウン結果をカスタマイズするのに使います。
 .sp
 実行例:
 .INDENT 0.0
@@ -6343,11 +6254,11 @@ select \-\-table PatSuffix \-\-filter \(aq_key @$ "ゆき" && original == true\(
 .fi
 .UNINDENT
 .UNINDENT
-.SS 全文検索の語彙表に対する追加情報
+.SS 全文検索用の語彙表の作成
 .sp
-Groongaでは、全文検索に用いるための語意表がテーブルとして扱えます。よって、語彙ごとに複数の情報を保持することができます。例えば、語彙の出現数や検索ストップワードのフラグ、単語の重要度などを保持することができます。
+Groongaでは、全文検索に用いるための語彙表がテーブルとして扱えます。よって、語彙ごとに複数の情報を保持することができます。例えば、語彙の出現数や検索ストップワードのフラグ、単語の重要度などを保持することができます。
 .sp
-この項目については、現在執筆中です。
+TODO: この項目については、現在執筆中です。
 .SS マイクロブログ検索システムの作成
 .sp
 これまで学んだGroongaの機能を用いて、マイクロブログの検索システムを作成してみましょう。マイクロブログとは、Twitterのような短いメッセージを投稿するブログです。
@@ -6420,8 +6331,7 @@ column_create \-\-table GeoIndex \-\-name comments_location \-\-type Comments \-
 ユーザーの自己紹介
 .TP
 .B \fBfollowee\fP
-Usersテーブルのfollowerカラムに対するインデックス。
-このインデックスを作ることで、あるユーザーをフォローしているユーザーを検索できるようになります。
+\fBUsers\fP テーブルの \fBfollower\fP カラムに対するインデックス。 このインデックスを作ることで、あるユーザーをフォローしているユーザーを検索できるようになります。
 .UNINDENT
 .SS Commentsテーブル
 .sp
@@ -6453,8 +6363,7 @@ Usersテーブルのfollowerカラムに対するインデックス。
 コメントを書いたユーザー
 .TP
 .B \fBfavorited_by\fP
-Usersテーブルのfavoritesカラムに対するインデックス。
-このインデックスを作ることで、指定したコメントを誰がお気に入りに入れているのかを検索できるようになります。
+\fBUsers\fP テーブルの \fBfavorites\fP カラムに対するインデックス。 このインデックスを作ることで、指定したコメントを誰がお気に入りに入れているのかを検索できるようになります。
 .UNINDENT
 .SS HashTagsテーブル
 .sp
@@ -6465,8 +6374,7 @@ Usersテーブルのfavoritesカラムに対するインデックス。
 ハッシュタグ
 .TP
 .B \fBhash_index\fP
-「Comments.hash_tags」のインデックス。
-このインデックスを作ることで、指定したハッシュタグのついているコメントの一覧を出すことが出来るようになります。
+「Comments.hash_tags」のインデックス。 このインデックスを作ることで、指定したハッシュタグのついているコメントの一覧を出すことが出来るようになります。
 .UNINDENT
 .SS Bigramテーブル
 .sp
@@ -6477,8 +6385,7 @@ Usersテーブルのfavoritesカラムに対するインデックス。
 単語
 .TP
 .B \fBusers_index\fP
-ユーザー情報のインデックス。
-このカラムは、ユーザー名「Users.name」、現在地「Users.location_str」、自己紹介文「Users.description」のインデックスになっています。
+ユーザー情報のインデックス。 このカラムは、ユーザー名「Users.name」、現在地「Users.location_str」、自己紹介文「Users.description」のインデックスになっています。
 .TP
 .B \fBcomment_index\fP
 コメント内容「Comments.comment」のインデックス
@@ -6505,94 +6412,94 @@ Commentsテーブルのlocationカラムに対するインデックス
 load \-\-table Users
 [
   {
-    "_key": "daijiro",
-    "name": "hsiomaneki",
-    "follower": ["tasukuchan"],
+    "_key": "alice",
+    "name": "Alice",
+    "follower": ["bob"],
     "favorites": [],
-    "location": "127678039x502643091",
-    "location_str": "神奈川県",
-    "description": "groonga developer"
+    "location": "152489000x\-255829000",
+    "location_str": "Boston, Massachusetts",
+    "description": "Groonga developer"
   },
   {
-    "_key": "tasukuchan",
-    "name": "グニャラくん",
-    "follower": ["daijiro","OffGao"],
-    "favorites": ["daijiro:1","OffGao:1"],
-    "location": "128423343x502929252",
-    "location_str": "東京都渋谷区",
-    "description": "エロいおっさん"
+    "_key": "bob",
+    "name": "Bob",
+    "follower": ["alice","charlie"],
+    "favorites": ["alice:1","charlie:1"],
+    "location": "146249000x\-266228000",
+    "location_str": "Brooklyn, New York City",
+    "description": ""
   },
   {
-    "_key": "OffGao",
-    "name": "OffGao",
-    "follower": ["tasukuchan","daijiro"],
-    "favorites": ["tasukuchan:1","daijiro:1"],
-    "location": "128544408x502801502",
-    "location_str": "東京都中野区",
-    "description": "がおがお"
+    "_key": "charlie",
+    "name": "Charlie",
+    "follower": ["alice","bob"],
+    "favorites": ["alice:1","bob:1"],
+    "location": "146607190x\-267021260",
+    "location_str": "Newark, New Jersey",
+    "description": "Hmm,Hmm"
   }
 ]
 
 load \-\-table Comments
 [
   {
-    "_key": "daijiro:1",
-    "comment": "マイクロブログ作ってみました（甘栗むいちゃいました的な感じで）。",
+    "_key": "alice:1",
+    "comment": "I\(aqve created micro\-blog!",
     "last_modified": "2010/03/17 12:05:00",
-    "posted_by": "daijiro",
+    "posted_by": "alice",
   },
   {
-    "_key": "tasukuchan:1",
-    "comment": "初の書き込み。テストテスト。",
+    "_key": "bob:1",
+    "comment": "First post. test,test...",
     "last_modified": "2010/03/17 12:00:00",
-    "posted_by": "tasukuchan",
+    "posted_by": "bob",
   },
   {
-    "_key": "daijiro:2",
-    "comment": "@tasukuchan ようこそ!!!",
+    "_key": "alice:2",
+    "comment": "@bob Welcome!!!",
     "last_modified": "2010/03/17 12:05:00",
-    "replied_to": "tasukuchan:1",
-    "replied_users": ["tasukuchan"],
-    "posted_by": "daijiro",
+    "replied_to": "bob:1",
+    "replied_users": ["bob"],
+    "posted_by": "alice",
   },
   {
-    "_key": "tasukuchan:2",
-    "comment": "@daijiro ありがとう！",
+    "_key": "bob:2",
+    "comment": "@alice Thanks!",
     "last_modified": "2010/03/17 13:00:00",
-    "replied_to": "daijiro:2",
-    "replied_users": ["daijiro"],
-    "posted_by": "tasukuchan",
+    "replied_to": "alice:2",
+    "replied_users": ["alice"],
+    "posted_by": "bob",
   },
   {
-    "_key": "tasukuchan:3",
-    "comment": "groongaなう #groonga",
+    "_key": "bob:3",
+    "comment": "I\(aqve just used \(aqTry\-Groonga\(aq now! #groonga",
     "last_modified": "2010/03/17 14:00:00",
     "hash_tags": ["groonga"],
-    "location": "127972422x503117107",
-    "posted_by": "tasukuchan",
+    "location": "146566000x\-266422000",
+    "posted_by": "bob",
   },
   {
-    "_key": "tasukuchan:4",
-    "comment": "groonga開発合宿のため羽田空港に来ました！ #groonga #travel",
+    "_key": "bob:4",
+    "comment": "I\(aqm come at city of New York for development camp! #groonga #travel",
     "last_modified": "2010/03/17 14:05:00",
     "hash_tags": ["groonga", "travel"],
-    "location": "127975798x502919856",
-    "posted_by": "tasukuchan",
+    "location": "146566000x\-266422000",
+    "posted_by": "bob",
   },
   {
-    "_key": "OffGao:1",
-    "comment": "@daijiro @tasukuchan 登録してみましたよー！",
+    "_key": "charlie:1",
+    "comment": "@alice @bob I\(aqve tried to register!",
     "last_modified": "2010/03/17 15:00:00",
-    "replied_users": ["daijiro", "tasukuchan"],
-    "location": "128551935x502796433",
-    "posted_by": "OffGao",
+    "replied_users": ["alice", "bob"],
+    "location": "146607190x\-267021260",
+    "posted_by": "charlie",
   }
   {
-    "_key": "OffGao:2",
-    "comment": "中野ブロードウェイなうなう",
+    "_key": "charlie:2",
+    "comment": "I\(aqm at the Museum of Modern Art in NY now!",
     "last_modified": "2010/03/17 15:05:00",
-    "location": "128551935x502796434",
-    "posted_by": "OffGao",
+    "location": "146741340x\-266319590",
+    "posted_by": "charlie",
   }
 ]
 .ft P
@@ -6600,19 +6507,20 @@ load \-\-table Comments
 .UNINDENT
 .UNINDENT
 .sp
-Usersテーブルのfollowerカラムとfavoritesカラム、そしてCommentsテーブルのreplied_usersカラムは、ベクターカラムです。そのため、これらのカラムは配列で値を指定します。
+\fBUsers\fP テーブルの \fBfollower\fP カラムと \fBfavorites\fP カラム、そして \fBComments\fP テーブルの \fBreplied_users\fP カラムは、ベクターカラムです。そのため、これらのカラムは配列で値を指定します。
 .sp
-Usersテーブルのlocationカラムと、Commentsテーブルのlocationカラムは、GeoPoint型です。この型での値の指定は、"[緯度]x[経度]"と記述して指定します。
+\fBUsers\fP テーブルの \fBlocation\fP カラムと、\fBComments\fP テーブルの \fBlocation\fP カラムは、 \fBGeoPoint\fP 型です。この型での値の指定は、"[緯度]x[経度]"と記述して指定します。
 .sp
-Commentsテーブルのlast_modifiedカラムは、Time型です。この型での値を指定する方法は2つあります。
-1つ目の方法は、1970年1月1日0時0分0秒からの経過秒数の値を直接指定する方法です。このとき、小数部分を指定することでマイクロ秒数での指定が可能です。指定した値は、データのロードの際にマイクロ秒を単位とする整数値に変換後、格納されます。
-2つ目の方法は、文字列で日時と時刻を指定する方法です。"年/月/日 時:分:秒"というフォーマットで記述することで、データロードの際に文字列からキャストされ、マイクロ秒数の値が格納されます。
+\fBComments\fP テーブルの \fBlast_modified\fP カラムは、Time型です。
+.sp
+この型での値を指定する方法は2つあります。1つ目の方法は、1970年1月1日0時0分0秒からの経過秒数の値を直接指定する方法です。このとき、小数部分を指定することでマイクロ秒数での指定が可能です。指定した値は、データのロードの際にマイクロ秒を単位とする整数値に変換後、格納されます。 2つ目の方法は、文字列で日時と時刻を指定する方法です。"年/月/日 時:分:秒"というフォーマットで記述することで、データロードの際に文字列からキャストされ、マイクロ秒数の値が格納されます。
 .SS 検索
 .sp
-それでは、実際に検索をしてみましょう。
+マイクロブログを検索してみましょう。
 .SS キーワードでユーザー検索
 .sp
 ここでは、 \fBmatch_columns\fP で扱った、複数カラムを対象とした検索を行います。
+.sp
 指定された文字列で、ユーザー名・現在地・自己紹介文を対象に検索をします。
 .sp
 実行例:
@@ -6621,7 +6529,7 @@ Commentsテーブルのlast_modifiedカラムは、Time型です。この型で
 .sp
 .nf
 .ft C
-select \-\-table Users \-\-match_columns name,location_str,description \-\-query 東京 \-\-output_columns _key,name
+select \-\-table Users \-\-match_columns name,location_str,description \-\-query "New York" \-\-output_columns _key,name
 # [[0, 1337566253.89858, 0.000355720520019531], true]
 # [[0, 1337566253.89858, 0.000355720520019531], true]
 # [[0, 1337566253.89858, 0.000355720520019531], true]
@@ -6658,7 +6566,7 @@ select \-\-table Users \-\-match_columns name,location_str,description \-\-query
 #   [
 #     [
 #       [
-#         2
+#         1
 #       ],
 #       [
 #         [
@@ -6671,12 +6579,8 @@ select \-\-table Users \-\-match_columns name,location_str,description \-\-query
 #         ]
 #       ],
 #       [
-#         "tasukuchan",
-#         "グニャラくん"
-#       ],
-#       [
-#         "OffGao",
-#         "OffGao"
+#         "bob",
+#         "Bob"
 #       ]
 #     ]
 #   ]
@@ -6686,11 +6590,12 @@ select \-\-table Users \-\-match_columns name,location_str,description \-\-query
 .UNINDENT
 .UNINDENT
 .sp
-「東京」をキーワードにユーザー検索した結果、東京都に住んでいる「グニャラくん」と「OffGao」がヒットしました。
-.SS GeoPointでユーザー検索
+「New York」をキーワードにユーザー検索した結果、New Yorkに住んでいる「Bob」がヒットしました。
+.SS 位置情報(GeoPoint)でユーザー検索
+.sp
+ここでは、GeoPoint型のカラムで検索をします。GeoPoint型については \fBsearch\fP を参照してください。
 .sp
-ここでは、 \fBsearch\fP で扱った、GeoPoint型のカラムで検索をします。
-以下の例では、指定された位置から5000m以内にいるユーザーを検索しています。
+次の例では、特定の場所から20km以内に住んでいる人を検索します。
 .sp
 実行例:
 .INDENT 0.0
@@ -6698,7 +6603,7 @@ select \-\-table Users \-\-match_columns name,location_str,description \-\-query
 .sp
 .nf
 .ft C
-select \-\-table Users \-\-filter \(aqgeo_in_circle(location,"128484216x502919856",5000)\(aq \-\-output_columns _key,name
+select \-\-table Users \-\-filter \(aqgeo_in_circle(location,"146710080x\-266315480",20000)\(aq \-\-output_columns _key,name
 # [
 #   [
 #     0,
@@ -6721,12 +6626,12 @@ select \-\-table Users \-\-filter \(aqgeo_in_circle(location,"128484216x50291985
 #         ]
 #       ],
 #       [
-#         "tasukuchan",
-#         "グニャラくん"
+#         "charlie",
+#         "Charlie"
 #       ],
 #       [
-#         "OffGao",
-#         "OffGao"
+#         "bob",
+#         "Bob"
 #       ]
 #     ]
 #   ]
@@ -6736,11 +6641,12 @@ select \-\-table Users \-\-filter \(aqgeo_in_circle(location,"128484216x50291985
 .UNINDENT
 .UNINDENT
 .sp
-新宿駅から5km以内にすんでいるユーザーを検索したところ、「グニャラくん」と「OffGao」がヒットしました。
-.SS あるユーザーをフォローしているユーザーの検索
+「Bob」と「Charlie」が「Grand Central Terminal」から20km以内に住んでいることがわかります。
+.SS あるユーザーをフォローしてるユーザーの検索
+.sp
+ここでは、 \fBindex\fP の参照関係の逆引きをします。
 .sp
-ここでは、 \fBindex\fP で扱った、参照関係の逆引きをします。
-以下の例では、Usersテーブルのfollowerカラムにあるフォローリストを逆引きします。
+次の例は、 \fBUsers\fP テーブルの \fBfollower\fP カラムにあるフォローリストを逆引きします。
 .sp
 実行例:
 .INDENT 0.0
@@ -6748,7 +6654,7 @@ select \-\-table Users \-\-filter \(aqgeo_in_circle(location,"128484216x50291985
 .sp
 .nf
 .ft C
-select \-\-table Users \-\-query follower:@tasukuchan \-\-output_columns _key,name
+select \-\-table Users \-\-query follower:@bob \-\-output_columns _key,name
 # [
 #   [
 #     0,
@@ -6771,12 +6677,12 @@ select \-\-table Users \-\-query follower:@tasukuchan \-\-output_columns _key,na
 #         ]
 #       ],
 #       [
-#         "daijiro",
-#         "hsiomaneki"
+#         "alice",
+#         "Alice"
 #       ],
 #       [
-#         "OffGao",
-#         "OffGao"
+#         "charlie",
+#         "Charlie"
 #       ]
 #     ]
 #   ]
@@ -6786,11 +6692,12 @@ select \-\-table Users \-\-query follower:@tasukuchan \-\-output_columns _key,na
 .UNINDENT
 .UNINDENT
 .sp
-「グニャラくん」をフォローしている「hsiomaneki」と「OffGao」がヒットしました。
+「Alice」と「Charlie」が「Bob」をフォローしていることがわかります。
 .SS GeoPointでコメント検索
 .sp
 ある範囲内で書かれたコメントを検索します。
-また、 \fBdrilldown\fP で扱ったドリルダウンも行います。検索結果をハッシュタグとユーザーでドリルダウンし、ユーザー別・ハッシュタグ別のカウントを出します。
+.sp
+また、 \fBdrilldown\fP をおこないます。検索結果をハッシュタグとユーザーでドリルダウンし、ユーザー別・ハッシュタグ別のカウントを出します。
 .sp
 実行例:
 .INDENT 0.0
@@ -6798,7 +6705,7 @@ select \-\-table Users \-\-query follower:@tasukuchan \-\-output_columns _key,na
 .sp
 .nf
 .ft C
-select \-\-table Comments \-\-filter \(aqgeo_in_circle(location,"127975798x502919856",20000)\(aq \-\-output_columns posted_by.name,comment \-\-drilldown hash_tags,posted_by
+select \-\-table Comments \-\-filter \(aqgeo_in_circle(location,"146867000x\-266280000",20000)\(aq \-\-output_columns posted_by.name,comment \-\-drilldown hash_tags,posted_by
 # [
 #   [
 #     0,
@@ -6821,20 +6728,20 @@ select \-\-table Comments \-\-filter \(aqgeo_in_circle(location,"127975798x50291
 #         ]
 #       ],
 #       [
-#         "グニャラくん",
-#         "groonga開発合宿のため羽田空港に来ました！ #groonga #travel"
+#         "Charlie",
+#         "I\(aqm at the Museum of Modern Art in NY now!"
 #       ],
 #       [
-#         "グニャラくん",
-#         "groongaなう #groonga"
+#         "Bob",
+#         "I\(aqve just used \(aqTry\-Groonga\(aq now! #groonga"
 #       ],
 #       [
-#         "OffGao",
-#         "@daijiro @tasukuchan 登録してみましたよー！"
+#         "Bob",
+#         "I\(aqm come at city of New York for development camp! #groonga #travel"
 #       ],
 #       [
-#         "OffGao",
-#         "中野ブロードウェイなうなう"
+#         "Charlie",
+#         "@alice @bob I\(aqve tried to register!"
 #       ]
 #     ],
 #     [
@@ -6875,11 +6782,11 @@ select \-\-table Comments \-\-filter \(aqgeo_in_circle(location,"127975798x50291
 #         ]
 #       ],
 #       [
-#         "tasukuchan",
+#         "charlie",
 #         2
 #       ],
 #       [
-#         "OffGao",
+#         "bob",
 #         2
 #       ]
 #     ]
@@ -6890,11 +6797,12 @@ select \-\-table Comments \-\-filter \(aqgeo_in_circle(location,"127975798x50291
 .UNINDENT
 .UNINDENT
 .sp
-範囲を広く指定したため、位置情報のあるすべてのコメントがヒットしました。そして、ヒットしたコメントからドリルダウンされた結果も返ってきており、ハッシュタグは「#groonga」が2つに「#travel」が1つ、投稿者は「グニャラくん」「OffGao」がそれぞれ2件ずつであることがわかります。
+このクエリは、ニューヨークのセントラルパークから20km圏内で投稿されたコメントを検索します。
+.sp
+指定した範囲が20kmなので、位置情報を含むすべてのコメントが検索されました。#groongaというハッシュタグが2件、#travelというハッシュタグが1件で、BobとCharlieがコメントしているのは2件あります。
 .SS キーワードでコメント検索
 .sp
-あるキーワードを含むコメントを検索します。
-さらに、 \fBsearch\fP で扱った、スコア値_scoreも出してみましょう。
+あるキーワードを含むコメントを検索します。そして、 \fBsearch\fP で言及している \fI_score\fP を出してみます。
 .sp
 実行例:
 .INDENT 0.0
@@ -6902,7 +6810,7 @@ select \-\-table Comments \-\-filter \(aqgeo_in_circle(location,"127975798x50291
 .sp
 .nf
 .ft C
-select \-\-table Comments \-\-query comment:@なう \-\-output_columns comment,_score
+select \-\-table Comments \-\-query comment:@Now \-\-output_columns comment,_score
 # [
 #   [
 #     0,
@@ -6925,12 +6833,12 @@ select \-\-table Comments \-\-query comment:@なう \-\-output_columns comment,_
 #         ]
 #       ],
 #       [
-#         "groongaなう #groonga",
+#         "I\(aqve just used \(aqTry\-Groonga\(aq now! #groonga",
 #         1
 #       ],
 #       [
-#         "中野ブロードウェイなうなう",
-#         2
+#         "I\(aqm at the Museum of Modern Art in NY now!",
+#         1
 #       ]
 #     ]
 #   ]
@@ -6940,10 +6848,10 @@ select \-\-table Comments \-\-query comment:@なう \-\-output_columns comment,_
 .UNINDENT
 .UNINDENT
 .sp
-「なう」をキーワードにコメント検索した結果、2件のコメントがヒットしました。また、_scoreの値も返ってきており、「なう」の数が出力されていることが確認できます。
-.SS GeoPointとキーワードでコメント検索
+\(aqNow\(aqをキーワードに使っているので、このクエリは2件のコメントを返します。 \fI_score\fP の値として \(aqNow\(aqのカウントを含んでいます。
+.SS キーワードと位置情報で検索
 .sp
-今度は、キーワードとGeoPointの両方を条件に検索をしてみます。\-\-queryと\-\-filterの両方を使用した場合、両方の条件に一致するレコードがヒットします。
+あるキーワードと位置情報の両方でコメントを検索します。 \fI\-\-query\fP と \fI\-\-filter\fP オプションの両方を使用した場合、両方の条件に一致するレコードを返します。
 .sp
 実行例:
 .INDENT 0.0
@@ -6951,7 +6859,7 @@ select \-\-table Comments \-\-query comment:@なう \-\-output_columns comment,_
 .sp
 .nf
 .ft C
-select \-\-table Comments \-\-query comment:@羽田 \-\-filter \(aqgeo_in_circle(location,"127975798x502919856",20000)\(aq \-\-output_columns posted_by.name,comment \-\-drilldown hash_tags,posted_by
+select \-\-table Comments \-\-query comment:@New \-\-filter \(aqgeo_in_circle(location,"146867000x\-266280000",20000)\(aq \-\-output_columns posted_by.name,comment \-\-drilldown hash_tags,posted_by
 # [
 #   [
 #     0,
@@ -6974,8 +6882,8 @@ select \-\-table Comments \-\-query comment:@羽田 \-\-filter \(aqgeo_in_circle
 #         ]
 #       ],
 #       [
-#         "グニャラくん",
-#         "groonga開発合宿のため羽田空港に来ました！ #groonga #travel"
+#         "Bob",
+#         "I\(aqm come at city of New York for development camp! #groonga #travel"
 #       ]
 #     ],
 #     [
@@ -7016,7 +6924,7 @@ select \-\-table Comments \-\-query comment:@羽田 \-\-filter \(aqgeo_in_circle
 #         ]
 #       ],
 #       [
-#         "tasukuchan",
+#         "bob",
 #         1
 #       ]
 #     ]
@@ -7027,11 +6935,10 @@ select \-\-table Comments \-\-query comment:@羽田 \-\-filter \(aqgeo_in_circle
 .UNINDENT
 .UNINDENT
 .sp
-両方の条件を満たすコメントが1件ヒットしました。また、ドリルダウンの結果も返ってきており、「グニャラくん」のコメント1件であることがわかります。
-.SS ハッシュタグでコメント検索
+両方の条件をみたすコメントが1件あります。ドリルダウンの結果も含まれ、Bobによるコメントであることがわかります。
+.SS ハッシュタグでコメントを検索
 .sp
-あるハッシュタグのついているコメントを検索します。
-これも、 \fBindex\fP で扱った、参照関係の逆引きを使います。
+あるハッシュタグのついているコメントを検索します。テーブルの参照関係を逆にたどってみましょう。
 .sp
 実行例:
 .INDENT 0.0
@@ -7062,12 +6969,12 @@ select \-\-table Comments \-\-query hash_tags:@groonga \-\-output_columns posted
 #         ]
 #       ],
 #       [
-#         "グニャラくん",
-#         "groongaなう #groonga"
+#         "Bob",
+#         "I\(aqve just used \(aqTry\-Groonga\(aq now! #groonga"
 #       ],
 #       [
-#         "グニャラくん",
-#         "groonga開発合宿のため羽田空港に来ました！ #groonga #travel"
+#         "Bob",
+#         "I\(aqm come at city of New York for development camp! #groonga #travel"
 #       ]
 #     ],
 #     [
@@ -7085,7 +6992,7 @@ select \-\-table Comments \-\-query hash_tags:@groonga \-\-output_columns posted
 #         ]
 #       ],
 #       [
-#         "tasukuchan",
+#         "bob",
 #         2
 #       ]
 #     ]
@@ -7096,8 +7003,8 @@ select \-\-table Comments \-\-query hash_tags:@groonga \-\-output_columns posted
 .UNINDENT
 .UNINDENT
 .sp
-#groongaタグの付いている2件のコメントがヒットしました。また、投稿者のドリルダウンも返ってきており、2件とも「グニャラくん」のものであることがわかります。
-.SS ユーザーIDでコメント検索
+このクエリは#groongaハッシュタグを含む2件のコメントを返します。投稿者のドリルダウン結果を2件含んでいて、Bobが投稿したことがわかります。
+.SS ユーザーIDでコメントを検索
 .sp
 あるユーザーが投稿したコメントを検索します。
 .sp
@@ -7107,7 +7014,7 @@ select \-\-table Comments \-\-query hash_tags:@groonga \-\-output_columns posted
 .sp
 .nf
 .ft C
-select \-\-table Comments \-\-query posted_by:tasukuchan \-\-output_columns comment \-\-drilldown hash_tags
+select \-\-table Comments \-\-query posted_by:bob \-\-output_columns comment \-\-drilldown hash_tags
 # [
 #   [
 #     0,
@@ -7126,16 +7033,16 @@ select \-\-table Comments \-\-query posted_by:tasukuchan \-\-output_columns comm
 #         ]
 #       ],
 #       [
-#         "初の書き込み。テストテスト。"
+#         "First post. test,test..."
 #       ],
 #       [
-#         "@daijiro ありがとう！"
+#         "@alice Thanks!"
 #       ],
 #       [
-#         "groongaなう #groonga"
+#         "I\(aqve just used \(aqTry\-Groonga\(aq now! #groonga"
 #       ],
 #       [
-#         "groonga開発合宿のため羽田空港に来ました！ #groonga #travel"
+#         "I\(aqm come at city of New York for development camp! #groonga #travel"
 #       ]
 #     ],
 #     [
@@ -7168,10 +7075,10 @@ select \-\-table Comments \-\-query posted_by:tasukuchan \-\-output_columns comm
 .UNINDENT
 .UNINDENT
 .sp
-「グニャラくん」が書き込んだ4件のコメントがヒットしました。また、ハッシュタグでドリルダウンした結果も返ってきており、ハッシュタグは「#groonga」が2つに「#travel」が1つあることがわかります。
-.SS ユーザーのお気に入りコメントを検索
+このクエリはBobによる4件のコメントを返します。ハッシュタグによるドリルダウン結果も含まれ、#groongaが2件、#travelが1件であることがわかります。
+.SS ユーザーのお気に入りのコメント一覧
 .sp
-あるユーザーがお気に入りに入れているコメントを検索します。
+あるユーザーのお気に入りコメントを検索します。
 .sp
 実行例:
 .INDENT 0.0
@@ -7179,7 +7086,7 @@ select \-\-table Comments \-\-query posted_by:tasukuchan \-\-output_columns comm
 .sp
 .nf
 .ft C
-select \-\-table Users \-\-query _key:tasukuchan \-\-output_columns favorites.posted_by,favorites.comment
+select \-\-table Users \-\-query _key:bob \-\-output_columns favorites.posted_by,favorites.comment
 # [
 #   [
 #     0,
@@ -7203,12 +7110,12 @@ select \-\-table Users \-\-query _key:tasukuchan \-\-output_columns favorites.po
 #       ],
 #       [
 #         [
-#           "daijiro",
-#           "OffGao"
+#           "alice",
+#           "charlie"
 #         ],
 #         [
-#           "マイクロブログ作ってみました（甘栗むいちゃいました的な感じで）。",
-#           "@daijiro @tasukuchan 登録してみましたよー！"
+#           "I\(aqve created micro\-blog!",
+#           "@alice @bob I\(aqve tried to register!"
 #         ]
 #       ]
 #     ]
@@ -7219,11 +7126,12 @@ select \-\-table Users \-\-query _key:tasukuchan \-\-output_columns favorites.po
 .UNINDENT
 .UNINDENT
 .sp
-「グニャラくん」がお気に入りに入れている2件のコメントがヒットしました。
-.SS 投稿時間でコメント検索
+このクエリはBobのお気に入りのコメント一覧を返します。
+.SS 投稿時間でコメントを検索
 .sp
-コメントの投稿時間で検索をします。Time型については \fBdata\fP で扱っています。
-この例では、指定した時間よりも前に投稿されているコメントを検索します。
+コメントの投稿時間で検索をします。\fITime\fP 型については \fBdata\fP を参照してください。
+.sp
+ある時刻よりも古いコメントを検索します。
 .sp
 実行例:
 .INDENT 0.0
@@ -7258,28 +7166,28 @@ select Comments \-\-filter \(aqlast_modified<=1268802000\(aq \-\-output_columns
 #         ]
 #       ],
 #       [
-#         "hsiomaneki",
-#         "マイクロブログ作ってみました（甘栗むいちゃいました的な感じで）。",
+#         "Alice",
+#         "I\(aqve created micro\-blog!",
 #         1268795100.0
 #       ],
 #       [
-#         "グニャラくん",
-#         "初の書き込み。テストテスト。",
+#         "Bob",
+#         "First post. test,test...",
 #         1268794800.0
 #       ],
 #       [
-#         "hsiomaneki",
-#         "@tasukuchan ようこそ!!!",
+#         "Alice",
+#         "@bob Welcome!!!",
 #         1268795100.0
 #       ],
 #       [
-#         "グニャラくん",
-#         "@daijiro ありがとう！",
+#         "Bob",
+#         "@alice Thanks!",
 #         1268798400.0
 #       ],
 #       [
-#         "グニャラくん",
-#         "groongaなう #groonga",
+#         "Bob",
+#         "I\(aqve just used \(aqTry\-Groonga\(aq now! #groonga",
 #         1268802000.0
 #       ]
 #     ],
@@ -7317,11 +7225,11 @@ select Comments \-\-filter \(aqlast_modified<=1268802000\(aq \-\-output_columns
 #         ]
 #       ],
 #       [
-#         "daijiro",
+#         "alice",
 #         2
 #       ],
 #       [
-#         "tasukuchan",
+#         "bob",
 #         3
 #       ]
 #     ]
@@ -7332,19 +7240,17 @@ select Comments \-\-filter \(aqlast_modified<=1268802000\(aq \-\-output_columns
 .UNINDENT
 .UNINDENT
 .sp
-2010/03/17 14:00:00以前に書かれたコメント5件がヒットしました。また、ドリルダウンの結果も返ってきており、「hsiomaneki」が2件、「グニャラくん」が3件ヒットしていることがわかります。
+このクエリは2010/03/17 14:00:00以前の5件のコメントを返します。投稿者によるドリルダウン結果も含まれ、Aliceが2件、Bobが3件であることがわかります。
 .SS クエリ拡張
 .sp
-Groongaでは、 \fB/reference/commands/select\fP コマンドにquery_expanderパラメータを指定することによって、ユーザが指定した検索文字列を適宜拡張することが可能です。
+Groongaの \fB/reference/commands/select\fP コマンドは \fBquery_expander\fP 引数を受付ます。これを使うとクエリ文字列を拡張することができます。
 .sp
-たとえば、ユーザが\(aqシークヮーサー\(aqという文字列で検索した場合に、\(aqシークヮーサー OR シークァーサー\(aqで検索した場合と同一の結果を返すことによって、本来ユーザが必要とする結果をよりもれなく検索できるようになります。
+例えば、"theater"ではなく"theatre"で検索したとしましょう。クエリ拡張では"theater OR theatre"の結果を返します。このようなやりかたで検索漏れを減らせます。これはユーザーが本当にやりたかったことです。
 .SS 準備
 .sp
-クエリ拡張機能を使用するためには、検索対象となる文書を格納するテーブル(ここでは文書テーブルと呼びます)以外に、ユーザの指定した検索文字列を置換するためのテーブル(ここでは置換テーブルと呼びます)を準備します。置換テーブルでは、その主キーが置換前の文字列となり、文字列型(ShortText)のカラムの値が置換後の文字列となります。
-.sp
-TODO: 文字列型のベクターカラムでも可能であり、その場合は各要素をORでつなげたものに置換されるということを記述する。
+クエリ拡張を使うには、文書を格納するテーブルと検索文字列と置換文字列のペアを格納する置換テーブルを作る必要があります。置換テーブルでは主キーが元の文字列、ShortText型のカラムが置換後の文字列をあらわします。
 .sp
-実際に文書テーブルと置換テーブルを作成してみましょう。
+それでは文書テーブルと置換テーブルを作成しましょう。
 .sp
 実行例:
 .INDENT 0.0
@@ -7366,14 +7272,14 @@ column_create Synonym body COLUMN_SCALAR ShortText
 # [[0, 1337566253.89858, 0.000355720520019531], true]
 load \-\-table Doc
 [
-{"_key": "001", "body": "すっぱいブドウと甘いシークァーサー"},
-{"_key": "002", "body": "シークヮーサージュースとゴーヤチャンプル"},
+{"_key": "001", "body": "Play all night in this theater."},
+{"_key": "002", "body": "theatre is British spelling."},
 ]
 # [[0, 1337566253.89858, 0.000355720520019531], 2]
 load \-\-table Synonym
 [
-{"_key": "シークァーサー", "body": "(シークァーサー OR シークヮーサー)"},
-{"_key": "シークヮーサー", "body": "(シークァーサー OR シークヮーサー)"},
+{"_key": "theater", "body": "(theater OR theatre)"},
+{"_key": "theatre", "body": "(theater OR theatre)"},
 ]
 # [[0, 1337566253.89858, 0.000355720520019531], 2]
 .ft P
@@ -7381,10 +7287,10 @@ load \-\-table Synonym
 .UNINDENT
 .UNINDENT
 .sp
-この例では、ユーザが"シークァーサー"と入力しても、"シークヮーサー"と入力しても、それぞれの異なる表記の文書をもれなく検索するための置換テーブルを作成しています。
+このようにすると、検索漏れは起こりません。これは置換テーブルがクエリ文字列として"theater"も"theatre"のいずれも受け付けるからです。
 .SS 検索
 .sp
-それでは実際に、準備した置換テーブルを使ってみましょう。まずは、query_expanderパラメータを指定せずにselectコマンドを使って検索してみます。
+では、準備した置換テーブルを使ってみます。まずは \fBquery_expander\fP を使わずに \fBselect\fP コマンドを実行してみましょう。
 .sp
 実行例:
 .INDENT 0.0
@@ -7392,7 +7298,7 @@ load \-\-table Synonym
 .sp
 .nf
 .ft C
-select Doc \-\-match_columns body \-\-query "シークァーサー"
+select Doc \-\-match_columns body \-\-query "theater"
 # [
 #   [
 #     0,
@@ -7421,12 +7327,12 @@ select Doc \-\-match_columns body \-\-query "シークァーサー"
 #       [
 #         1,
 #         "001",
-#         "すっぱいブドウと甘いシークァーサー"
+#         "Play all night in this theater."
 #       ]
 #     ]
 #   ]
 # ]
-select Doc \-\-match_columns body \-\-query "シークヮーサー"
+select Doc \-\-match_columns body \-\-query "theatre"
 # [
 #   [
 #     0,
@@ -7455,7 +7361,7 @@ select Doc \-\-match_columns body \-\-query "シークヮーサー"
 #       [
 #         2,
 #         "002",
-#         "シークヮーサージュースとゴーヤチャンプル"
+#         "theatre is British spelling."
 #       ]
 #     ]
 #   ]
@@ -7465,7 +7371,9 @@ select Doc \-\-match_columns body \-\-query "シークヮーサー"
 .UNINDENT
 .UNINDENT
 .sp
-指定された文字列に完全に一致するレコードのみがそれぞれヒットします。次に、query_expanderパラメータに、準備したSynonymテーブルのbodyカラムを指定してみましょう。
+このクエリではクエリ文字列に完全に一致するレコードを返します。
+.sp
+では、 \fBquery_expander\fP を \fBSynonym\fP テーブルの \fBbody\fP カラムに対して使ってみましょう。
 .sp
 実行例:
 .INDENT 0.0
@@ -7473,7 +7381,7 @@ select Doc \-\-match_columns body \-\-query "シークヮーサー"
 .sp
 .nf
 .ft C
-select Doc \-\-match_columns body \-\-query "シークァーサー" \-\-query_expander Synonym.body
+select Doc \-\-match_columns body \-\-query "theater" \-\-query_expander Synonym.body
 # [
 #   [
 #     0,
@@ -7502,17 +7410,17 @@ select Doc \-\-match_columns body \-\-query "シークァーサー" \-\-query_ex
 #       [
 #         1,
 #         "001",
-#         "すっぱいブドウと甘いシークァーサー"
+#         "Play all night in this theater."
 #       ],
 #       [
 #         2,
 #         "002",
-#         "シークヮーサージュースとゴーヤチャンプル"
+#         "theatre is British spelling."
 #       ]
 #     ]
 #   ]
 # ]
-select Doc \-\-match_columns body \-\-query "シークヮーサー" \-\-query_expander Synonym.body
+select Doc \-\-match_columns body \-\-query "theatre" \-\-query_expander Synonym.body
 # [
 #   [
 #     0,
@@ -7541,12 +7449,12 @@ select Doc \-\-match_columns body \-\-query "シークヮーサー" \-\-query_ex
 #       [
 #         1,
 #         "001",
-#         "すっぱいブドウと甘いシークァーサー"
+#         "Play all night in this theater."
 #       ],
 #       [
 #         2,
 #         "002",
-#         "シークヮーサージュースとゴーヤチャンプル"
+#         "theatre is British spelling."
 #       ]
 #     ]
 #   ]
@@ -7556,7 +7464,7 @@ select Doc \-\-match_columns body \-\-query "シークヮーサー" \-\-query_ex
 .UNINDENT
 .UNINDENT
 .sp
-どちらのクエリ文字列も、"(シークァーサー OR シークヮーサー)"という文字列に置換されてから検索されるため、表記の揺れを吸収して検索できるようになりました。
+この場合、クエリ文字列は "theater OR theatre" へと置き換えられます。つまり、検索時に表記揺れを考慮して検索できます。
 .SH サジェスト
 .sp
 Groongaにはサジェスト機能があります。このセクションではこの機能の使い方とどのように動作しているかを説明します。
@@ -27614,7 +27522,7 @@ Groongaを全文検索ライブラリとして使うことができます。こ
 .SS 全体設定
 .SS 概要
 .sp
-Groonga has the global configurations. You can access them by API.
+Groongaにはグローバルな設定があります。それらにアクセスするにはAPIを使います。
 .SS リファレンス
 .INDENT 0.0
 .TP
@@ -27643,7 +27551,7 @@ lock until \fBtimeout\fP times, the tries are failed.
 .sp
 ロックタイムアウトについては、 \fBgrn_get_lock_timeout()\fP を参照してください。
 .sp
-\fBtimeout\fP にはいくつか特別扱いする値があります。
+\fBtimeout\fP にはいくつか特別な値があります。
 .INDENT 7.0
 .INDENT 3.5
 .INDENT 0.0
@@ -27659,11 +27567,11 @@ lock until \fBtimeout\fP times, the tries are failed.
 .B パラメタ
 .INDENT 7.0
 .IP \(bu 2
-\fBtimeuot\fP \-\- The new lock timeout.
+\fBtimeuot\fP \-\- 新しいロックのタイムアウト。
 .UNINDENT
 .TP
 .B 戻り値
-\fBGRN_SUCCESS\fP\&. It doesn\(aqt fail.
+\fBGRN_SUCCESS\fP 。この関数は失敗しません。
 .UNINDENT
 .UNINDENT
 .SS \fBgrn_cache\fP
@@ -27676,24 +27584,13 @@ lock until \fBtimeout\fP times, the tries are failed.
 .UNINDENT
 .UNINDENT
 .sp
-\fBgrn_cache\fP is a data store that keeps responses of
-\fB/reference/commands/select\fP command. It is not general use cache
-object. It is only for \fB/reference/commands/select\fP command.
+\fBgrn_cache\fP は \fB/reference/commands/select\fP コマンドのレスポンスを保持するためのデータストアです。一般的なオブジェクトのキャッシュとして使うものではありません。あくまで \fB/reference/commands/select\fP コマンドのためのものです。
 .sp
-You can just change the current cache object by
-\fBgrn_cache_current_set()\fP\&. \fB/reference/commands/select\fP
-command response cache is done internally.
+\fBgrn_cache_current_set()\fP を使うことで現在のキャッシュオブジェクトを変更することができます。 \fB/reference/commands/select\fP コマンドのレスポンスが内部的に用いられます。
 .sp
-\fB/reference/commands/select\fP command uses one global cache
-object. If you open multiple databases, the one cache is shared. It is
-an important problem.
+\fB/reference/commands/select\fP コマンドは、一つのグローバルキャッシュオブジェクトを利用します。もし複数のデータベースをオープンしていた場合、そのキャッシュオブジェクトは共有されます。これは重要な問題です。
 .sp
-If you open multiple databases and use
-\fB/reference/commands/select\fP command, you need to use
-\fBgrn_cache\fP object. It is \fB/reference/executables/groonga\-httpd\fP
-case. If you open only one database or don\(aqt use
-\fB/reference/commands/select\fP command, you don\(aqt need to use
-\fBgrn_cache\fP object. It is \fI\%rroonga\fP case.
+もし複数のデータベースを開き、 \fB/reference/commands/select\fP コマンドを使用するのであれば、 \fBgrn_cache\fP オブジェクトを使う必要があります。 \fB/reference/executables/groonga\-httpd\fP のようなケースが該当します。もし一つのデータベースのみを開く場合や、 \fB/reference/commands/select\fP コマンドを使わない場合は、 \fBgrn_cache\fP オブジェクトを使う必要はありません。 \fIRroonga <http://ranguba.org/ja/#about\-rroonga>\fP のようなケースです。
 .SS 実行例:
 .sp
 以下はキャッシュを変更する例です。
@@ -27717,17 +27614,22 @@ grn_cache_current_set(ctx, cache_previous);
 .INDENT 0.0
 .TP
 .B grn_cache
-It is an opaque cache object. You can create a \fBgrn_cache\fP by
-\fBgrn_cache_open()\fP and free the created object by
-\fBgrn_cache_close()\fP\&.
+抽象的なオブジェクトである\(ga\(gagrn_cache\(ga\(gaは、 :c:func:
+.nf
+\(ga
+.fi
+grn_cache_open()\(gaによって作成され、:c:func:
+.nf
+\(ga
+.fi
+grn_cache_close()\(gaによって解放される。
 .UNINDENT
 .INDENT 0.0
 .TP
 .B grn_cache *grn_cache_open(grn_ctx\fI\ *ctx\fP)
 新規にキャッシュオブジェクトを作成します。
 .sp
-If memory allocation for the new cache object is failed, \fBNULL\fP
-is returned. Error information is stored into the \fBctx\fP\&.
+新しいキャッシュオブジェクト作成のためのメモリ割り当てに失敗した場合、 \fBNULL\fP を返します。エラー情報は \fBctx\fP に格納されます。
 .INDENT 7.0
 .TP
 .B パラメタ
@@ -27737,15 +27639,13 @@ is returned. Error information is stored into the \fBctx\fP\&.
 .UNINDENT
 .TP
 .B 戻り値
-A newly allocated cache object on success, \fBNULL\fP
-otherwise. The returned cache object must be freed by
-\fBgrn_cache_close()\fP\&.
+新しいキャッシュオブジェクトの作成に成功した場合は \fBNULL\fP 以外の値を返します。このキャッシュオブジェクトは \fBgrn_cache_close()\fP で解放されなければなりません。
 .UNINDENT
 .UNINDENT
 .INDENT 0.0
 .TP
 .B grn_rc grn_cache_close(grn_ctx\fI\ *ctx\fP, grn_cache\fI\ *cache\fP)
-Frees resourses of the \fBcache\fP\&.
+\fBcache\fP のリソースを解放。
 .INDENT 7.0
 .TP
 .B パラメタ
@@ -27753,7 +27653,7 @@ Frees resourses of the \fBcache\fP\&.
 .IP \(bu 2
 \fBctx\fP \-\- その時点のコンテキスト。
 .IP \(bu 2
-\fBcache\fP \-\- The cache object to be freed.
+\fBcache\fP \-\- キャッシュオブジェクトを解放する。
 .UNINDENT
 .TP
 .B 戻り値
@@ -27807,7 +27707,7 @@ Frees resourses of the \fBcache\fP\&.
 .IP \(bu 2
 \fBcache\fP \-\- 変更するキャッシュオブジェクト。
 .IP \(bu 2
-\fBn\fP \-\- The new max number of entries of the cache object.
+\fBn\fP \-\- キャッシュオブジェクトの新しい最大エントリ数。
 .UNINDENT
 .TP
 .B 戻り値
@@ -27825,11 +27725,11 @@ Frees resourses of the \fBcache\fP\&.
 .IP \(bu 2
 \fBctx\fP \-\- その時点のコンテキスト。
 .IP \(bu 2
-\fBcache\fP \-\- The target cache object.
+\fBcache\fP \-\- ターゲットキャッシュオブジェクト。
 .UNINDENT
 .TP
 .B 戻り値
-The max number of entries of the cache object.
+キャッシュオブジェクトの最大エントリ数。
 .UNINDENT
 .UNINDENT
 .SS \fBgrn_column\fP
@@ -27843,10 +27743,17 @@ TODO...
 .INDENT 0.0
 .TP
 .B GRN_COLUMN_NAME_ID
-It returns the name of \fB/reference/columns/pseudo\fP \fB_id\fP\&.
+\fB/reference/columns/pseudo\fP 
+.nf
+\(ga\(ga
+.fi
+_id\(ga\(gaの名前を返す。
 .sp
-It is useful to use with \fBGRN_COLUMN_NAME_ID_LEN\fP like
-the following:
+:c:macro:
+.nf
+\(ga
+.fi
+GRN_COLUMN_NAME_ID_LEN\(gaは以下のような場合に利用できる:
 .INDENT 7.0
 .INDENT 3.5
 .sp
@@ -27859,14 +27766,14 @@ id_column = grn_ctx_get(ctx, GRN_COLUMN_NAME_ID, GRN_COLUMN_NAME_ID_LEN);
 .UNINDENT
 .UNINDENT
 .sp
-Since 3.1.1.
+3.1.1から。
 .UNINDENT
 .INDENT 0.0
 .TP
 .B GRN_COLUMN_NAME_ID_LEN
 It returns the byte size of \fBGRN_COLUMN_NAME_ID\fP\&.
 .sp
-Since 3.1.1.
+3.1.1から。
 .UNINDENT
 .INDENT 0.0
 .TP
@@ -27887,14 +27794,14 @@ key_column = grn_ctx_get(ctx, GRN_COLUMN_NAME_KEY, GRN_COLUMN_NAME_KEY_LEN);
 .UNINDENT
 .UNINDENT
 .sp
-Since 3.1.1.
+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.
+3.1.1から。
 .UNINDENT
 .INDENT 0.0
 .TP
@@ -27915,22 +27822,29 @@ value_column = grn_ctx_get(ctx, GRN_COLUMN_NAME_VALUE, GRN_COLUMN_NAME_VALUE_LEN
 .UNINDENT
 .UNINDENT
 .sp
-Since 3.1.1.
+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.
+3.1.1から。
 .UNINDENT
 .INDENT 0.0
 .TP
 .B GRN_COLUMN_NAME_SCORE
-It returns the name of \fB/reference/columns/pseudo\fP \fB_score\fP\&.
+\fB/reference/columns/pseudo\fP 
+.nf
+\(ga\(ga
+.fi
+_score\(ga\(gaの名前を返す。
 .sp
-It is useful to use with \fBGRN_COLUMN_NAME_SCORE_LEN\fP like
-the following:
+:c:macro:
+.nf
+\(ga
+.fi
+GRN_COLUMN_NAME_SCORE_LEN\(gaは以下のような場合に利用できる:
 .INDENT 7.0
 .INDENT 3.5
 .sp
@@ -27943,22 +27857,29 @@ score_column = grn_ctx_get(ctx, GRN_COLUMN_NAME_SCORE, GRN_COLUMN_NAME_SCORE_LEN
 .UNINDENT
 .UNINDENT
 .sp
-Since 3.1.1.
+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\&.
+:c:macro:
+.nf
+\(ga
+.fi
+GRN_COLUMN_NAME_SCORE\(gaのサイズをバイト数で返す。
 .sp
-Since 3.1.1.
+3.1.1から。
 .UNINDENT
 .INDENT 0.0
 .TP
 .B GRN_COLUMN_NAME_NSUBRECS
-It returns the name of \fB/reference/columns/pseudo\fP \fB_nsubrecs\fP\&.
+\fB/reference/columns/pseudo\fP \fB_nsubrecs\fP の名前を返す。
 .sp
-It is useful to use with \fBGRN_COLUMN_NAME_NSUBRECS_LEN\fP like
-the following:
+:c:macro:
+.nf
+\(ga
+.fi
+GRN_COLUMN_NAME_NSUBRECS_LEN\(gaは以下のような場合に利用できる:
 .INDENT 7.0
 .INDENT 3.5
 .sp
@@ -27971,14 +27892,14 @@ nsubrecs_column = grn_ctx_get(ctx, GRN_COLUMN_NAME_NSUBRECS, GRN_COLUMN_NAME_NSU
 .UNINDENT
 .UNINDENT
 .sp
-Since 3.1.1.
+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\&.
+\fBGRN_COLUMN_NAME_NSUBRECS\fP のサイズをバイト数で返す。
 .sp
-Since 3.1.1.
+3.1.1から。
 .UNINDENT
 .INDENT 0.0
 .TP
@@ -28213,7 +28134,23 @@ ctxを初期化します。
 .B grn_rc grn_ctx_fin(grn_ctx\fI\ *ctx\fP)
 ctxの管理するメモリを解放し、使用を終了します。
 .sp
-If \fBctx\fP is initialized by \fBgrn_ctx_open()\fP not \fBgrn_ctx_init()\fP\&. You need also to call \fBgrn_ctx_close()\fP\&.
+
+.nf
+\(ga\(ga
+.fi
+ctx\(ga\(gaを:c:func:
+.nf
+\(ga
+.fi
+grn_ctx_init()\(gaではなく:c:func:
+.nf
+\(ga
+.fi
+grn_ctx_open()\(gaで初期化した場合、:c:func:
+.nf
+\(ga
+.fi
+grn_ctx_close()\(gaを呼び出さなければならない。
 .INDENT 7.0
 .TP
 .B パラメタ
@@ -28249,13 +28186,25 @@ If \fBctx\fP is initialized by \fBgrn_ctx_open()\fP not \fBgrn_ctx_init()\fP\&.
 .INDENT 0.0
 .TP
 .B grn_rc grn_ctx_close(grn_ctx\fI\ *ctx\fP)
-It calls \fBgrn_ctx_fin()\fP and frees allocated memory for \fBctx\fP by \fBgrn_ctx_open()\fP\&.
+:c:func:
+.nf
+\(ga
+.fi
+grn_ctx_fin()\(gaを呼び出し、:c:func:
+.nf
+\(ga
+.fi
+grn_ctx_open()\(gaによって割り当てられた\(ga\(gactx\(ga\(gaへのメモリを開放する。
 .INDENT 7.0
 .TP
 .B パラメタ
 .INDENT 7.0
 .IP \(bu 2
-\fBctx\fP \-\- no longer needed \fBgrn_ctx\fP\&.
+\fBctx\fP \-\- :c:type:
+.nf
+\(ga
+.fi
+grn_ctx\(gaは不要となる。
 .UNINDENT
 .TP
 .B 戻り値
@@ -28303,7 +28252,15 @@ command_versionを変更します。
 .B grn_rc grn_ctx_use(grn_ctx\fI\ *ctx\fP, grn_obj\fI\ *db\fP)
 ctxが操作対象とするdbを指定します。NULLを指定した場合は、dbを操作しない状態(init直後の状態)になります。
 .sp
-Don\(aqt use it with \fBgrn_ctx\fP that has \fBGRN_CTX_PER_DB\fP flag.
+
+.nf
+\(ga\(ga
+.fi
+GRN_CTX_PER_DB\(ga\(gaフラグと同時に:c:type:
+.nf
+\(ga
+.fi
+grn_ctx\(gaを使ってはならない。
 .INDENT 7.0
 .TP
 .B パラメタ
@@ -28329,7 +28286,7 @@ ctxが使用するdbからnameに対応するオブジェクトを検索して
 .IP \(bu 2
 \fBname\fP \-\- 検索しようとするオブジェクトの名前。
 .IP \(bu 2
-\fBname_size\fP \-\- The number of bytes of name. If negative value is specified, name is assumed that NULL\-terminated string.
+\fBname_size\fP \-\- 名前のバイト数。負の値が指定された場合は、終端をNULL文字とした文字列として扱われる。
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -28364,7 +28321,11 @@ TODO...
 .INDENT 0.0
 .TP
 .B grn_db_create_optarg
-It is used for specifying options for \fBgrn_db_create()\fP\&.
+:c:func:
+.nf
+\(ga
+.fi
+grn_db_create\(gaのオプションを指定するのに利用されます。
 .UNINDENT
 .INDENT 0.0
 .TP
@@ -28476,9 +28437,9 @@ TODO...
 .INDENT 0.0
 .TP
 .B const char *grn_encoding_to_string(grn_encoding\fI\ encoding\fP)
-Returns string representation for the encoding. For example, \(aqgrn_encoding_to_string(\fBGRN_ENC_UTF8\fP)\(aq returns \(aq"utf8"\(aq.
+エンコーディングの形式を文字列で返します。たとえば\(aqgrn_encoding_to_string(\fBGRN_ENC_UTF8\fP)\(aq は"utf8"を返します。
 .sp
-"unknown" is returned for invalid encoding.
+無効なエンコーディングの場合は"unknown"を返します。
 .INDENT 7.0
 .TP
 .B パラメタ
@@ -28491,37 +28452,49 @@ Returns string representation for the encoding. For example, \(aqgrn_encoding_to
 .INDENT 0.0
 .TP
 .B grn_encoding grn_encoding_parse(const char\fI\ *name\fP)
-Parses encoding name and returns grn_encoding. For example, \(aqgrn_encoding_parse("UTF8")\(aq returns \(aq\fBGRN_ENC_UTF8\fP\(aq.
+エンコーディング名をパースし、grn_encodingを返します。たとえば、\(aqgrn_encoding_parse("UTF8")\(aq は\(aq\fBGRN_ENC_UTF8\fP\(aqを返します。
 .sp
-\fBGRN_ENC_UTF8\fP is returned for invalid encoding name.
+\fBGRN_ENC_UTF8\fP は無効なエンコーディング名が与えた時に返されます。
 .INDENT 7.0
 .TP
 .B パラメタ
 .INDENT 7.0
 .IP \(bu 2
-\fBname\fP \-\- その時点のエンコーディング。
+\fBname\fP \-\- エンコーディング名。
 .UNINDENT
 .UNINDENT
 .UNINDENT
 .SS grn_expr
 .sp
-\fIgrn_expr\fP is an \fBgrn_obj\fP that represents an expression. Here
-is a list of what expression can do:
+
+.nf
+\(ga
+.fi
+grn_expr\(gaは:c:type:
+.nf
+\(ga
+.fi
+grn_obj\(gaを式として表現したものです。以下はどのような表現があるかのリストです。
 .INDENT 0.0
 .INDENT 3.5
 .INDENT 0.0
 .IP \(bu 2
-Expression can apply some operations to a record by
-\fBgrn_expr_exec()\fP\&.
+式は:c:func:
+.nf
+\(ga
+.fi
+grn_expr_exec\(gaによって登録されたものが適用される。
 .IP \(bu 2
-Expression can represents search condition. \fBgrn_table_select()\fP
-can select records that match against the search condition represented
-by expression.
+検索条件を式として表現することができます。:c:func:
+.nf
+\(ga
+.fi
+grn_table_select\(gaは検索条件文にマッチしたレコードの選択ができます。
 .UNINDENT
 .UNINDENT
 .UNINDENT
 .sp
-There are two string representations of expression:
+文字列を式で表現する手段は2種類あります。
 .INDENT 0.0
 .INDENT 3.5
 .INDENT 0.0
@@ -28533,8 +28506,11 @@ There are two string representations of expression:
 .UNINDENT
 .UNINDENT
 .sp
-\fBgrn_expr_parse()\fP parses string represented expression and
-appends the parsed expression to another expression.
+:c:func:
+.nf
+\(ga
+.fi
+grn_expr_parse\(gaは式の記述された文字列をパースし、その結果を別の式に追加します。
 .SS 実行例:
 .sp
 TODO...
@@ -28578,32 +28554,39 @@ TODO...
 .INDENT 0.0
 .TP
 .B grn_rc grn_expr_syntax_escape(grn_ctx\fI\ *ctx\fP, const char\fI\ *string\fP, int\fI\ string_size\fP, const char\fI\ *target_characters\fP, char\fI\ escape_character\fP, grn_obj\fI\ *escaped_string\fP)
-Escapes \fBtarget_characters\fP in \fBstring\fP by \fBescape_character\fP\&.
+
+.nf
+\(ga\(ga
+.fi
+string\(ga\(ga中の\(ga\(gatarget_characters\(ga\(gaは\(ga\(gaescape_character\(ga\(gaによってエスケープされます。
 .INDENT 7.0
 .TP
 .B パラメタ
 .INDENT 7.0
 .IP \(bu 2
-\fBctx\fP \-\- Its encoding must be the same encoding of \fBstring\fP\&.
-It is used for allocating buffer for \fBescaped_string\fP\&.
+\fBctx\fP \-\- エンコーディングは\(ga\(gastring\(ga\(gaと同じでなければいけません。
+.nf
+\(ga\(ga
+.fi
+escaped_string\(ga\(gaのバッファ確保のために利用されます。
 .IP \(bu 2
-\fBstring\fP \-\- String expression representation.
+\fBstring\fP \-\- 文字列式表現
 .IP \(bu 2
-\fBstring_size\fP \-\- The byte size of \fBstring\fP\&. \fB\-1\fP means \fBstring\fP
-is NULL terminated string.
+\fBstring_size\fP \-\- \fBstring\(ga\(gaのバイトサイズが\fP\-1\(ga\(gaの場合は\(ga\(gastring\(ga\(gaがNULL終端文字列であることを意味しています。
 .IP \(bu 2
-\fBtarget_characters\fP \-\- NULL terminated escape target characters.
-For example, \fB"+\-><~*()\e"\e\e:"\fP is
-\fBtarget_characters\fP for
-\fB/reference/grn_expr/query_syntax\fP\&.
+\fBtarget_characters\fP \-\- NULL終端されたエスケープ対象文字。たとえば、
+.nf
+\(ga\(ga
+.fi
+"+\-><~*()"\e:"\fIは\(ga\(gatarget_characters\(ga\(gaと:doc:\fP/reference/grn_expr/query_syntax\(gaで説明されています。
 .IP \(bu 2
-\fBescape_character\fP \-\- The character to use escape a character in
-\fBtarget_characters\fP\&. For example, \fB\e\e\fP
-(backslash) is \fBescaped_character\fP for
-\fB/reference/grn_expr/query_syntax\fP\&.
+\fBescape_character\fP \-\- エスケープ用の文字として\(ga\(gatarget_characters\(ga\(gaに指定するもの。たとえば、\fB\e\e\fP が\(ga\(gaescaped_character\(ga\(gaとして:doc:
+.nf
+\(ga
+.fi
+/reference/grn_expr/query_syntax\(gaに説明されています。
 .IP \(bu 2
-\fBescaped_string\fP \-\- The output of escaped \fBstring\fP\&. It should be
-text typed bulk.
+\fBescaped_string\fP \-\- エスケープされた\(ga\(gastring\(ga\(gaの出力。テキスト型用のbulkに使用されます。
 .UNINDENT
 .TP
 .B 戻り値
@@ -28619,16 +28602,17 @@ text typed bulk.
 .B パラメタ
 .INDENT 7.0
 .IP \(bu 2
-\fBctx\fP \-\- Its encoding must be the same encoding of \fBquery\fP\&.
-It is used for allocating buffer for \fBescaped_query\fP\&.
+\fBctx\fP \-\- このエンコーディングは\(ga\(gaquery\(ga\(gaのエンコーディングと同じでなければなりません。
+.nf
+\(ga\(ga
+.fi
+escaped_query\(ga\(gaのバッファ確保に使われます。
 .IP \(bu 2
 \fBquery\fP \-\- \fB/reference/grn_expr/query_syntax\fP にある文字列式の表現。
 .IP \(bu 2
-\fBquery_size\fP \-\- The byte size of \fBquery\fP\&. \fB\-1\fP means \fBquery\fP
-is NULL terminated string.
+\fBquery_size\fP \-\- \fBquery\(ga\(gaのバイトサイズ。\fP\-1\(ga\(gaは\(ga\(gaquery\(ga\(gaがNULL終端文字列であることを意味します。
 .IP \(bu 2
-\fBescaped_query\fP \-\- The output of escaped \fBquery\fP\&. It should be
-text typed bulk.
+\fBescaped_query\fP \-\- エスケープされた\(ga\(gaquery\(ga\(gaの出力。テキスト型用のbulkを返す。
 .UNINDENT
 .TP
 .B 戻り値
@@ -30374,7 +30358,7 @@ It initializes a \fIgrn_expr_var\fP\&.
 .UNINDENT
 .TP
 .B 戻り値
-\fBGRN_SUCCESS\fP\&. It doesn\(aqt fail.
+\fBGRN_SUCCESS\fP 。この関数は失敗しません。
 .UNINDENT
 .UNINDENT
 .INDENT 0.0
@@ -31349,7 +31333,9 @@ Groongaについてまわりの人に話してください。
 どちらのやり方でも大丈夫です。
 .SS 課題追跡システムへ登録する
 .sp
-Groonga用の課題追跡システム（ITS, Issue Tracking System）が2つあります。1つは \fI\%Redmine\fP でもう1つは \fI\%GitHub issue tracker\fP です。Redmineは日本語を使っていて、GitHub issue trackerは英語または日本語（できれば英語、苦手なら日本語でも可）を使っています。どちらにバグレポートをしても大丈夫です。
+Groongaプロジェクトは \fI\%Github issue tracker\fP を使っています。
+.sp
+GitHub issue tracker へのバグレポートは英語または日本語で大丈夫です。
 .SS メーリングリストへ報告する
 .sp
 GroongaプロジェクトではGroongaについて議論するための \fB/community\fP があります。バグを説明したメールを送ってください。