RubyGems - rroonga - Versions diffs - 3.1.0-x64-mingw32 → 3.1.1-x64-mingw32 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (525) hide show

data/vendor/local/share/doc/groonga/ja/html/tutorial/patricia_trie.html CHANGED Viewed

@@ -7,7 +7,7 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>4.8. パトリシア木による前方一致検索 &mdash; Groonga v3.1.0ドキュメント</title>
+    <title>4.8. パトリシア木による前方一致検索 &mdash; Groonga v3.1.1ドキュメント</title>
     <link rel="stylesheet" href="../_static/groonga.css" type="text/css" />
     <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
@@ -15,7 +15,7 @@
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '../',
-        VERSION:     '3.1.0',
+        VERSION:     '3.1.1',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
@@ -26,7 +26,7 @@
     <script type="text/javascript" src="../_static/doctools.js"></script>
     <script type="text/javascript" src="../_static/translations.js"></script>
     <link rel="shortcut icon" href="../_static/favicon.ico"/>
-    <link rel="top" title="Groonga v3.1.0ドキュメント" href="../index.html" />
+    <link rel="top" title="Groonga v3.1.1ドキュメント" href="../index.html" />
     <link rel="up" title="4. チュートリアル" href="../tutorial.html" />
     <link rel="next" title="4.9. 全文検索の語彙表に対する追加情報" href="lexicon.html" />
     <link rel="prev" title="4.7. match_columnsパラメータ" href="match_columns.html" />
@@ -61,7 +61,7 @@
         <li class="right" >
           <a href="match_columns.html" title="4.7. match_columnsパラメータ"
              accesskey="P">前へ</a> |</li>
-        <li><a href="../index.html">Groonga v3.1.0ドキュメント</a> &raquo;</li>
+        <li><a href="../index.html">Groonga v3.1.1ドキュメント</a> &raquo;</li>
           <li><a href="../tutorial.html" accesskey="U">4. チュートリアル</a> &raquo;</li>
       </ul>
     </div>
@@ -73,7 +73,7 @@
   <div class="section" id="id1">
 <h1>4.8. パトリシア木による前方一致検索<a class="headerlink" href="#id1" title="このヘッドラインへのパーマリンク">¶</a></h1>
-<p>groongaのテーブルは、テーブル作成時にパトリシア木オプションを指定すると、前方一致検索を行うことができます。また、追加のオプションを指定することにより、主キーの後方一致検索をも行うことができます。</p>
+<p>Groongaのテーブルは、テーブル作成時にパトリシア木オプションを指定すると、前方一致検索を行うことができます。また、追加のオプションを指定することにより、主キーの後方一致検索をも行うことができます。</p>
 <div class="section" id="id2">
 <h2>4.8.1. 主キーによる前方一致検索<a class="headerlink" href="#id2" title="このヘッドラインへのパーマリンク">¶</a></h2>
 <p>table_createコマンドのflagsオプションにTABLE_PAT_KEYを指定することで、主キーによる前方一致検索ができるようになります。</p>
@@ -290,7 +290,7 @@ select --table PatSuffix --filter &#39;_key @$ &quot;ゆき&quot; &amp;&amp; ori
         <li class="right" >
           <a href="match_columns.html" title="4.7. match_columnsパラメータ"
              >前へ</a> |</li>
-        <li><a href="../index.html">Groonga v3.1.0ドキュメント</a> &raquo;</li>
+        <li><a href="../index.html">Groonga v3.1.1ドキュメント</a> &raquo;</li>
           <li><a href="../tutorial.html" >4. チュートリアル</a> &raquo;</li>
       </ul>
     </div>

data/vendor/local/share/doc/groonga/ja/html/tutorial/query_expansion.html CHANGED Viewed

@@ -7,7 +7,7 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>4.11. クエリ拡張 &mdash; Groonga v3.1.0ドキュメント</title>
+    <title>4.11. クエリ拡張 &mdash; Groonga v3.1.1ドキュメント</title>
     <link rel="stylesheet" href="../_static/groonga.css" type="text/css" />
     <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
@@ -15,7 +15,7 @@
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '../',
-        VERSION:     '3.1.0',
+        VERSION:     '3.1.1',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
@@ -26,7 +26,7 @@
     <script type="text/javascript" src="../_static/doctools.js"></script>
     <script type="text/javascript" src="../_static/translations.js"></script>
     <link rel="shortcut icon" href="../_static/favicon.ico"/>
-    <link rel="top" title="Groonga v3.1.0ドキュメント" href="../index.html" />
+    <link rel="top" title="Groonga v3.1.1ドキュメント" href="../index.html" />
     <link rel="up" title="4. チュートリアル" href="../tutorial.html" />
     <link rel="next" title="5. サジェスト" href="../suggest.html" />
     <link rel="prev" title="4.10. マイクロブログ検索システムの作成" href="micro_blog.html" />
@@ -61,7 +61,7 @@
         <li class="right" >
           <a href="micro_blog.html" title="4.10. マイクロブログ検索システムの作成"
              accesskey="P">前へ</a> |</li>
-        <li><a href="../index.html">Groonga v3.1.0ドキュメント</a> &raquo;</li>
+        <li><a href="../index.html">Groonga v3.1.1ドキュメント</a> &raquo;</li>
           <li><a href="../tutorial.html" accesskey="U">4. チュートリアル</a> &raquo;</li>
       </ul>
     </div>
@@ -73,7 +73,7 @@
   <div class="section" id="id1">
 <h1>4.11. クエリ拡張<a class="headerlink" href="#id1" title="このヘッドラインへのパーマリンク">¶</a></h1>
-<p>groongaでは、 <a class="reference internal" href="../reference/commands/select.html"><em>select</em></a> コマンドにquery_expanderパラメータを指定することによって、ユーザが指定した検索文字列を適宜拡張することが可能です。</p>
+<p>Groongaでは、 <a class="reference internal" href="../reference/commands/select.html"><em>select</em></a> コマンドにquery_expanderパラメータを指定することによって、ユーザが指定した検索文字列を適宜拡張することが可能です。</p>
 <p>たとえば、ユーザが'シークヮーサー'という文字列で検索した場合に、'シークヮーサー OR シークァーサー'で検索した場合と同一の結果を返すことによって、本来ユーザが必要とする結果をよりもれなく検索できるようになります。</p>
 <div class="section" id="id2">
 <h2>4.11.1. 準備<a class="headerlink" href="#id2" title="このヘッドラインへのパーマリンク">¶</a></h2>
@@ -324,7 +324,7 @@ select Doc --match_columns body --query &quot;シークヮーサー&quot; --quer
         <li class="right" >
           <a href="micro_blog.html" title="4.10. マイクロブログ検索システムの作成"
              >前へ</a> |</li>
-        <li><a href="../index.html">Groonga v3.1.0ドキュメント</a> &raquo;</li>
+        <li><a href="../index.html">Groonga v3.1.1ドキュメント</a> &raquo;</li>
           <li><a href="../tutorial.html" >4. チュートリアル</a> &raquo;</li>
       </ul>
     </div>

data/vendor/local/share/doc/groonga/ja/html/tutorial/search.html CHANGED Viewed

@@ -7,7 +7,7 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>4.4. さまざまな検索条件の指定 &mdash; Groonga v3.1.0ドキュメント</title>
+    <title>4.4. さまざまな検索条件の指定 &mdash; Groonga v3.1.1ドキュメント</title>
     <link rel="stylesheet" href="../_static/groonga.css" type="text/css" />
     <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
@@ -15,7 +15,7 @@
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '../',
-        VERSION:     '3.1.0',
+        VERSION:     '3.1.1',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
@@ -26,7 +26,7 @@
     <script type="text/javascript" src="../_static/doctools.js"></script>
     <script type="text/javascript" src="../_static/translations.js"></script>
     <link rel="shortcut icon" href="../_static/favicon.ico"/>
-    <link rel="top" title="Groonga v3.1.0ドキュメント" href="../index.html" />
+    <link rel="top" title="Groonga v3.1.1ドキュメント" href="../index.html" />
     <link rel="up" title="4. チュートリアル" href="../tutorial.html" />
     <link rel="next" title="4.5. ドリルダウン" href="drilldown.html" />
     <link rel="prev" title="4.3. いろいろなデータの保存" href="data.html" />
@@ -61,7 +61,7 @@
         <li class="right" >
           <a href="data.html" title="4.3. いろいろなデータの保存"
              accesskey="P">前へ</a> |</li>
-        <li><a href="../index.html">Groonga v3.1.0ドキュメント</a> &raquo;</li>
+        <li><a href="../index.html">Groonga v3.1.1ドキュメント</a> &raquo;</li>
           <li><a href="../tutorial.html" accesskey="U">4. チュートリアル</a> &raquo;</li>
       </ul>
     </div>
@@ -73,7 +73,7 @@
   <div class="section" id="id1">
 <h1>4.4. さまざまな検索条件の指定<a class="headerlink" href="#id1" title="このヘッドラインへのパーマリンク">¶</a></h1>
-<p>groongaは、JavaScriptに似た文法での条件絞込や、計算した値を用いたソートを行うことができます。また、位置情報(緯度・経度)を用いた絞込・ソートを行うことができます。</p>
+<p>Groongaは、JavaScriptに似た文法での条件絞込や、計算した値を用いたソートを行うことができます。また、位置情報(緯度・経度)を用いた絞込・ソートを行うことができます。</p>
 <div class="section" id="javascript">
 <h2>4.4.1. JavaScriptに似た文法での絞込・全文検索<a class="headerlink" href="#javascript" title="このヘッドラインへのパーマリンク">¶</a></h2>
 <p>selectコマンドのfilterパラメータは、queryパラメータと同様に、レコードの検索条件を指定します。filterパラメータとqueryパラメータが異なる点は、filterパラメータには、JavaScriptの式に似た文法で条件を指定する点です。</p>
@@ -371,7 +371,7 @@ select --table Site --filter &quot;1&quot; --scorer &quot;_score = rand()&quot;
 </div>
 <div class="section" id="id2">
 <h2>4.4.3. 位置情報を用いた絞込・ソート<a class="headerlink" href="#id2" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<p>groongaでは、位置情報（経緯度）を保存することができます。また、保存した経緯度を用いて絞込やソートができます。</p>
+<p>Groongaでは、位置情報（経緯度）を保存することができます。また、保存した経緯度を用いて絞込やソートができます。</p>
 <p>位置情報を保存するためのカラムの型として、TokyoGeoPoint/WGS84GeoPointの２つの型があります。前者は日本測地系、後者は世界測地系(WGS84相当)の経緯度を保存します。</p>
 <p>経緯度は以下のいずれかの形式の文字列として指定します。</p>
 <ul class="simple">
@@ -608,7 +608,7 @@ select --table Site --query &quot;_id:1 OR _id:2&quot; --output_columns _key,loc
         <li class="right" >
           <a href="data.html" title="4.3. いろいろなデータの保存"
              >前へ</a> |</li>
-        <li><a href="../index.html">Groonga v3.1.0ドキュメント</a> &raquo;</li>
+        <li><a href="../index.html">Groonga v3.1.1ドキュメント</a> &raquo;</li>
           <li><a href="../tutorial.html" >4. チュートリアル</a> &raquo;</li>
       </ul>
     </div>

data/vendor/local/share/groonga/examples/dictionary/edict/edict-import.sh CHANGED Viewed

File without changes

data/vendor/local/share/groonga/examples/dictionary/edict/edict2grn.rb CHANGED Viewed

File without changes

data/vendor/local/share/groonga/examples/dictionary/eijiro/eijiro-import.sh CHANGED Viewed

File without changes

data/vendor/local/share/groonga/examples/dictionary/eijiro/eijiro2grn.rb CHANGED Viewed

File without changes

data/vendor/local/share/groonga/examples/dictionary/gene95/gene-import.sh CHANGED Viewed

File without changes

data/vendor/local/share/groonga/examples/dictionary/gene95/gene2grn.rb CHANGED Viewed

File without changes

data/vendor/local/share/groonga/examples/dictionary/init-db.sh CHANGED Viewed

File without changes

data/vendor/local/share/groonga/examples/dictionary/jmdict/jmdict.rb CHANGED Viewed

File without changes

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

@@ -1,4 +1,4 @@
-.TH "GROONGA" "1" "2013 年 11 月 27 日" "3.1.0" "Groonga"
+.TH "GROONGA" "1" "2013 年 12 月 27 日" "3.1.1" "Groonga"
 .SH NAME
 groonga \- Groonga documentation
 .
@@ -35,54 +35,54 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 \fBnews\fP
 .UNINDENT
 .SH GROONGAの特徴
-.SS groonga の概要
+.SS Groonga の概要
 .sp
-groonga は転置索引を用いた高速・高精度な全文検索エンジンであり、登録された文書をすぐに検索結果に反映できます。また、参照をブロックせずに更新できることから、即時更新の必要なアプリケーションにおいても高い性能を発揮します。
+Groonga は転置索引を用いた高速・高精度な全文検索エンジンであり、登録された文書をすぐに検索結果に反映できます。また、参照をブロックせずに更新できることから、即時更新の必要なアプリケーションにおいても高い性能を発揮します。
 .sp
-全文検索エンジンとして開発された groonga ですが、独自のカラムストアを持つ列指向のデータベースとしての側面も持っています。そのため、MySQL や PostgreSQL など、既存の代表的なデータベースが苦手とする集計クエリを高速に処理できるという特徴があり、組み合わせによって弱点を補うような使い方もできます。
+全文検索エンジンとして開発された Groonga ですが、独自のカラムストアを持つ列指向のデータベースとしての側面も持っています。そのため、MySQL や PostgreSQL など、既存の代表的なデータベースが苦手とする集計クエリを高速に処理できるという特徴があり、組み合わせによって弱点を補うような使い方もできます。
 .sp
-groonga の基本機能は C ライブラリとして提供されていますが、MySQL や PostgreSQL と連携させたり、Ruby から呼び出したりすることもできます。そのため、任意のアプリケーションに組み込むことが可能であり、多様な使い方が考えられます。 興味のある方は \fI\%利用例\fP をご覧ください。
+Groonga の基本機能は C ライブラリとして提供されていますが、MySQL や PostgreSQL と連携させたり、Ruby から呼び出したりすることもできます。そのため、任意のアプリケーションに組み込むことが可能であり、多様な使い方が考えられます。 興味のある方は \fI\%利用例\fP をご覧ください。
 .SS 全文検索と即時更新
 .sp
 一般的なデータベースにおいては、追加・削除などの操作がすぐに反映されます。一方、全文検索においては、転置索引が逐次更新の難しいデータ構造であることから、文書の追加・削除に対応しないエンジンが少なくありません。
 .sp
-これに対し、転置索引を用いた全文検索エンジンでありながら、groonga は文書を短時間で追加・削除することができます。その上、更新しながらでも検索できるという優れた特徴を持っているため、全文検索エンジンとしてはとても柔軟性があります。また、複数の転置索引を統合するような重い処理を必要としないので、安定して高い性能を発揮することが期待できます。
+これに対し、転置索引を用いた全文検索エンジンでありながら、Groonga は文書を短時間で追加・削除することができます。その上、更新しながらでも検索できるという優れた特徴を持っているため、全文検索エンジンとしてはとても柔軟性があります。また、複数の転置索引を統合するような重い処理を必要としないので、安定して高い性能を発揮することが期待できます。
 .SS カラムストアと集計クエリ
 .sp
 現代は、インターネットを情報源とすれば、いくらでも情報を収集できる時代です。しかし、膨大な情報から有益な情報を引き出すのは困難であり、多面的な分析による試行錯誤が必要となります。たとえば、日付や時間帯により絞り込んでみたり、地域により絞り込んでみたり、性別や年齢により絞り込んでみたりすることでしょう。そして、そのようなときに便利な存在が集計クエリです。
 .sp
 集計クエリとは、指定したカラムの値によってレコードをグループ化し、各グループに含まれるレコードの数を求めるクエリです。たとえば、地域の ID を格納しているカラムを指定すれば、地域毎のレコード数が求まります。日付のカラムを指定したときの出力をグラフ化すれば、レコード数の時間変化を視覚化することができます。さらに、地域による絞り込みと日付に対する集計クエリを組み合わせれば、特定の地域におけるレコード数の時間変化を視覚化ことも可能です。このように、尺度を自由に選択して絞り込み・集計できることは、膨大な情報を扱う上でとても重要になります。
 .sp
-groonga が集計クエリを高速に処理できる理由は、データベースの論理構造にカラムストアを採用しているからです。集計クエリが参照するのは指定されたカラムのみであるため、カラム単位でデータを格納する列指向のデータベースでは、必要なカラムのみを無駄なく読み出せることが利点となります。一方、レコード単位でデータを格納する行指向のデータベースでは、隣接するカラムをまとめて読み出してしまうことが欠点となります。
+Groonga が集計クエリを高速に処理できる理由は、データベースの論理構造にカラムストアを採用しているからです。集計クエリが参照するのは指定されたカラムのみであるため、カラム単位でデータを格納する列指向のデータベースでは、必要なカラムのみを無駄なく読み出せることが利点となります。一方、レコード単位でデータを格納する行指向のデータベースでは、隣接するカラムをまとめて読み出してしまうことが欠点となります。
 .SS 転置索引とトークナイザ
 .sp
 転置索引は大規模な全文検索に用いられる伝統的なデータ構造です。転置索引を用いた全文検索エンジンでは、文書を追加するときに索引語を記録しておき、検索するときはクエリを索引語に分割して出現文書を求めます。そのため、文書やクエリから索引語を抜き出す方法が重要になります。
 .sp
 トークナイザは、文字列から索引語を抜き出すモジュールです。日本語を対象とする全文検索においては、形態素を索引語として抜き出す方式と文字 N\-gram を抜き出す方式のいずれか、あるいは両方を用いるのが一般的です。形態素方式は検索時間や索引サイズの面で優れているほか、検索結果に不要な文書が含まれにくいという利点を持っています。一方、N\-gram 方式には検索漏れが発生しにくいという利点があり、状況によって適した方式を選択することが望ましいとされています。
 .sp
-groonga は形態素方式と N\-gram 方式の両方に対応しています。初期状態で利用できるトークナイザは空白を区切り文字として用いる方式と N\-gram 方式のみですが、形態素解析器 MeCab を組み込んだときは MeCab による分かち書きの結果を用いる形態素方式が有効になります。トークナイザはプラグインとして追加できるため、特徴的なキーワードのみを索引語として採用するなど、独自のトークナイザを開発することが可能です。
+Groonga は形態素方式と N\-gram 方式の両方に対応しています。初期状態で利用できるトークナイザは空白を区切り文字として用いる方式と N\-gram 方式のみですが、形態素解析器 MeCab を組み込んだときは MeCab による分かち書きの結果を用いる形態素方式が有効になります。トークナイザはプラグインとして追加できるため、特徴的なキーワードのみを索引語として採用するなど、独自のトークナイザを開発することが可能です。
 .SS 共有可能なストレージと参照ロックフリー
 .sp
 CPU のマルチコア化が進んでいるため、同時に複数のクエリを実行したり、一つのクエリを複数のスレッドで実行したりすることの重要性はますます高まっています。
 .sp
-groonga のストレージは、複数のスレッド・プロセスで共有することができます。また、参照ロックフリーなデータ構造を採用しているため、更新クエリを実行している状況でも参照クエリを実行することができます。参照クエリを実行できる状態を維持しながら更新クエリを実行できるので、リアルタイムなシステムに適しています。さらには、MySQL を介して更新クエリを実行している最中に groonga の HTTP サーバを介して参照クエリを実行するなど、多彩な運用が可能となっています。
+Groonga のストレージは、複数のスレッド・プロセスで共有することができます。また、参照ロックフリーなデータ構造を採用しているため、更新クエリを実行している状況でも参照クエリを実行することができます。参照クエリを実行できる状態を維持しながら更新クエリを実行できるので、リアルタイムなシステムに適しています。さらには、MySQL を介して更新クエリを実行している最中に Groonga の HTTP サーバを介して参照クエリを実行するなど、多彩な運用が可能となっています。
 .SS 位置情報（緯度・経度）検索
 .sp
 GPS に代表される測位システムを搭載した高機能な携帯端末の普及などによって、位置情報を扱うサービスはますます便利になっています。たとえば、近くにあるレストランを探しているときは、現在地からの距離を基準として検索をおこない、検索結果を地図上に表示してくれるようなサービスが便利です。そのため、位置情報検索を高速に実現できることが重要になっています。
 .sp
-groonga では転置索引を応用して高速な位置情報検索を実現しています。矩形・円による範囲検索に対応しているほか、基準点の近くを優先的に探索させることができます。また、距離計算をサポートしているので、位置情報検索の結果を基準点からの距離によって整列することも可能です。
-.SS groonga ライブラリ
+Groonga では転置索引を応用して高速な位置情報検索を実現しています。矩形・円による範囲検索に対応しているほか、基準点の近くを優先的に探索させることができます。また、距離計算をサポートしているので、位置情報検索の結果を基準点からの距離によって整列することも可能です。
+.SS Groonga ライブラリ
 .sp
-Groonga の基本機能は C ライブラリとして提供されているので、任意のアプリケーションに組み込んで利用することができます。C/C++ 以外については、Ruby から groonga を利用するライブラリなどが関連プロジェクトにおいて提供されています。詳しくは \fI\%関連プロジェクト\fP を参照してください。
-.SS groonga サーバ
+Groonga の基本機能は C ライブラリとして提供されているので、任意のアプリケーションに組み込んで利用することができます。C/C++ 以外については、Ruby から Groonga を利用するライブラリなどが関連プロジェクトにおいて提供されています。詳しくは \fI\%関連プロジェクト\fP を参照してください。
+.SS Groonga サーバ
 .sp
-groonga にはサーバ機能があるため、レンタルサーバなどの新しいライブラリをインストールできない環境においても利用できます。対応しているのは HTTP, memcached binary プロトコル、およびに groonga の独自プロトコルである gqtp です。サーバとして利用するときはクエリのキャッシュ機能が有効になるため、同じクエリを受け取ったときは応答時間が短くなるという特徴があります。
-.SS groonga ストレージエンジン
+Groonga にはサーバ機能があるため、レンタルサーバなどの新しいライブラリをインストールできない環境においても利用できます。対応しているのは HTTP, memcached binary プロトコル、およびに Groonga の独自プロトコルである GQTP（Groonga Query Transfer Protocol） です。サーバとして利用するときはクエリのキャッシュ機能が有効になるため、同じクエリを受け取ったときは応答時間が短くなるという特徴があります。
+.SS Groonga ストレージエンジン
 .sp
-groonga は独自のカラムストアを持つ列指向のデータベースとしての側面を持っていますが、既存の RDBMS のストレージエンジンとして利用することもできます。たとえば、groonga をベースとする MySQL のストレージエンジンとして \fI\%mroonga\fP が開発されています。mroonga は MySQL のプラグインとして動的にロードすることが可能であり、groonga のカラムストアをストレージとして利用したり、全文検索エンジンとして groonga を MyISAM や InnoDB と連携させたりすることができます。groonga 単体での利用、およびに MyISAM, InnoDB との連携には一長一短があるので、用途に応じて適切な組み合わせを選ぶことが大切です。詳しくは \fI\%関連プロジェクト\fP を参照してください。
+Groonga は独自のカラムストアを持つ列指向のデータベースとしての側面を持っていますが、既存の RDBMS のストレージエンジンとして利用することもできます。たとえば、Groonga をベースとする MySQL のストレージエンジンとして \fI\%mroonga\fP が開発されています。mroonga は MySQL のプラグインとして動的にロードすることが可能であり、Groonga のカラムストアをストレージとして利用したり、全文検索エンジンとして Groonga を MyISAM や InnoDB と連携させたりすることができます。Groonga 単体での利用、およびに MyISAM, InnoDB との連携には一長一短があるので、用途に応じて適切な組み合わせを選ぶことが大切です。詳しくは \fI\%関連プロジェクト\fP を参照してください。
 .SH インストール
 .sp
-このセクションではgroongaのインストール方法を環境毎に説明します。主要なプラットフォームにはパッケージがあります。自分でgroongaをビルドするよりもパッケージを使うことを推奨します。しかし、心配しないでください。ソースからgroongaをビルドするためのドキュメントもあります。
+このセクションではGroongaのインストール方法を環境毎に説明します。主要なプラットフォームにはパッケージがあります。自分でGroongaをビルドするよりもパッケージを使うことを推奨します。しかし、心配しないでください。ソースからGroongaをビルドするためのドキュメントもあります。
 .sp
 32\-bit用と64\-bit用のパッケージを配布していますが、サーバ用途には64\-bitパッケージを利用することをオススメします。32\-bit用パッケージはテスト用か開発用にだけ使って下さい。32\-bit用パッケージを使った場合は、中程度のサイズのデータでもメモリ不足エラーになることがあります。
 .SS Windows
@@ -97,7 +97,7 @@ groonga は独自のカラムストアを持つ列指向のデータベースと
 .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
@@ -109,7 +109,7 @@ groonga は独自のカラムストアを持つ列指向のデータベースと
 .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
@@ -124,7 +124,7 @@ groonga は独自のカラムストアを持つ列指向のデータベースと
 .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
@@ -136,7 +136,7 @@ groonga は独自のカラムストアを持つ列指向のデータベースと
 .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
@@ -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\-3.1.0.zip\fP
+\fI\%http://packages.groonga.org/source/groonga/groonga\-3.1.1.zip\fP
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -176,19 +176,19 @@ Groongaのソースフォルダへと移動します:
 .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
 .UNINDENT
 .sp
-\fBcmake\fP でビルドオプションを設定します。以下のコマンドラインは64\-bit用のgroongaをビルドするためのものです。32\-bit用のgroongaをビルドする場合は代わりに \fB\-G "Visual Studio 10"\fP パラメーターを指定してください:
+\fBcmake\fP でビルドオプションを設定します。以下のコマンドラインは64\-bit用のGroongaをビルドするためのものです。32\-bit用のGroongaをビルドする場合は代わりに \fB\-G "Visual Studio 10"\fP パラメーターを指定してください:
 .INDENT 0.0
 .INDENT 3.5
 .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
@@ -200,7 +200,7 @@ groonga\-3.1.0> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\
 .sp
 .nf
 .ft C
-groonga\-3.1.0> cmake \-\-build . \-\-config Release
+groonga\-3.1.1> cmake \-\-build . \-\-config Release
 .ft P
 .fi
 .UNINDENT
@@ -212,7 +212,7 @@ groonga\-3.1.0> cmake \-\-build . \-\-config Release
 .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
@@ -221,7 +221,7 @@ groonga\-3.1.0> cmake \-\-build . \-\-config Release \-\-target Install
 以上の手順で \fB/reference/executables/groonga\fP が \fBc:\egroonga\ebin\egroonga.exe\fP にインストールされます。
 .SS Mac OS X
 .sp
-このセクションではMac OS X上でgroongaをインストールする方法を説明します。 \fI\%MacPorts\fP か \fI\%Homebrew\fP を使ってインストールできます。
+このセクションではMac OS X上でGroongaをインストールする方法を説明します。 \fI\%MacPorts\fP か \fI\%Homebrew\fP を使ってインストールできます。
 .sp
 32\-bit用と64\-bit用のパッケージを配布していますが、サーバ用途には64\-bitパッケージを利用することをオススメします。32\-bit用パッケージはテスト用か開発用にだけ使って下さい。32\-bit用パッケージを使った場合は、中程度のサイズのデータでもメモリ不足エラーになることがあります。
 .SS MacPorts
@@ -260,9 +260,9 @@ groonga\-3.1.0> cmake \-\-build . \-\-config Release \-\-target Install
 .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
@@ -305,14 +305,14 @@ configureを実行します（ \fBconfigure\fP のオプションについては
 .UNINDENT
 .SS Debian GNU/Linux
 .sp
-このセクションではDebian GNU/Linux上でgroonga関連のdebパッケージをインストールする方法を説明します。これらのパッケージは \fBapt\fP でインストールできます。
+このセクションではDebian GNU/Linux上でGroonga関連のdebパッケージをインストールする方法を説明します。これらのパッケージは \fBapt\fP でインストールできます。
 .sp
 32\-bit用と64\-bit用のパッケージを配布していますが、サーバ用途には64\-bitパッケージを利用することをオススメします。32\-bit用パッケージはテスト用か開発用にだけ使って下さい。32\-bit用パッケージを使った場合は、中程度のサイズのデータでもメモリ不足エラーになることがあります。
 .sp
 \fBノート:\fP
 .INDENT 0.0
 .INDENT 3.5
-\(aqgroonga\(aqパッケージは全文検索のための最小構成パッケージです。groongaをサーバー用途で使うなら、設定済みの追加パッケージをインストールすることができます。
+\(aqgroonga\(aqパッケージは全文検索のための最小構成パッケージです。Groongaをサーバー用途で使うなら、設定済みの追加パッケージをインストールすることができます。
 .sp
 サーバー用途のための3つのパッケージがあります。
 .INDENT 0.0
@@ -327,82 +327,9 @@ groonga\-server\-gqtp (GQTPサーバー)
 詳細は \fB/server\fP を参照してください。
 .UNINDENT
 .UNINDENT
-.SS squeeze
-.sp
-groongaのaptリポジトリを追加します。
-.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
-インストール:
-.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
-\fI\%MeCab\fP をトークナイザーとして使いたいときは、groonga\-tokenizer\-mecabパッケージをインストールしてください。
-.sp
-groonga\-tokenizer\-mecabパッケージのインストール:
-.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
-\fI\%Munin\fP プラグインを提供するパッケージもあります。Muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
-.sp
-groonga\-munin\-pluginsパッケージのインストール:
-.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
-MySQL互換のノーマライザーをgroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
-.sp
-groonga\-normalizer\-mysqlパッケージのインストール:
-.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
-groongaのaptリポジトリを追加します。
+Groongaのaptリポジトリを追加します。
 .sp
 /etc/apt/sources.list.d/groonga.list:
 .INDENT 0.0
@@ -446,7 +373,7 @@ groonga\-tokenizer\-mecabパッケージのインストール:
 .UNINDENT
 .UNINDENT
 .sp
-\fI\%Munin\fP プラグインを提供するパッケージもあります。Muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
+\fI\%Munin\fP プラグインを提供するパッケージもあります。MuninでGroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
 .sp
 groonga\-munin\-pluginsパッケージのインストール:
 .INDENT 0.0
@@ -460,7 +387,7 @@ groonga\-munin\-pluginsパッケージのインストール:
 .UNINDENT
 .UNINDENT
 .sp
-MySQL互換のノーマライザーをgroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
+MySQL互換のノーマライザーをGroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
 .sp
 groonga\-normalizer\-mysqlパッケージのインストール:
 .INDENT 0.0
@@ -475,7 +402,7 @@ groonga\-normalizer\-mysqlパッケージのインストール:
 .UNINDENT
 .SS jessie
 .sp
-groongaのaptリポジトリを追加します。
+Groongaのaptリポジトリを追加します。
 .sp
 /etc/apt/sources.list.d/groonga.list:
 .INDENT 0.0
@@ -519,7 +446,7 @@ groonga\-tokenizer\-mecabパッケージのインストール:
 .UNINDENT
 .UNINDENT
 .sp
-\fI\%Munin\fP プラグインを提供するパッケージもあります。Muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
+\fI\%Munin\fP プラグインを提供するパッケージもあります。MuninでGroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
 .sp
 groonga\-munin\-pluginsパッケージのインストール:
 .INDENT 0.0
@@ -533,7 +460,7 @@ groonga\-munin\-pluginsパッケージのインストール:
 .UNINDENT
 .UNINDENT
 .sp
-MySQL互換のノーマライザーをgroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
+MySQL互換のノーマライザーをGroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
 .sp
 groonga\-normalizer\-mysqlパッケージのインストール:
 .INDENT 0.0
@@ -548,7 +475,7 @@ groonga\-normalizer\-mysqlパッケージのインストール:
 .UNINDENT
 .SS sid
 .sp
-groongaのaptリポジトリを追加します。
+Groongaのaptリポジトリを追加します。
 .sp
 /etc/apt/sources.list.d/groonga.list:
 .INDENT 0.0
@@ -592,7 +519,7 @@ groonga\-tokenizer\-mecabパッケージのインストール:
 .UNINDENT
 .UNINDENT
 .sp
-\fI\%Munin\fP プラグインを提供するパッケージもあります。Muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
+\fI\%Munin\fP プラグインを提供するパッケージもあります。MuninでGroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
 .sp
 groonga\-munin\-pluginsパッケージのインストール:
 .INDENT 0.0
@@ -606,7 +533,7 @@ groonga\-munin\-pluginsパッケージのインストール:
 .UNINDENT
 .UNINDENT
 .sp
-MySQL互換のノーマライザーをgroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
+MySQL互換のノーマライザーをGroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
 .sp
 groonga\-normalizer\-mysqlパッケージのインストール:
 .INDENT 0.0
@@ -621,7 +548,7 @@ groonga\-normalizer\-mysqlパッケージのインストール:
 .UNINDENT
 .SS ソースからビルド
 .sp
-groongaをビルドするために必要なパッケージをインストールします:
+Groongaをビルドするために必要なパッケージをインストールします:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -639,9 +566,9 @@ groongaをビルドするために必要なパッケージをインストール
 .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
@@ -684,14 +611,14 @@ configureを実行します（ \fBconfigure\fP のオプションについては
 .UNINDENT
 .SS Ubuntu
 .sp
-このセクションではUbuntu上でgroonga関連のdebパッケージをインストールする方法を説明します。これらのパッケージは \fBapt\fP でインストールできます。
+このセクションではUbuntu上でGroonga関連のdebパッケージをインストールする方法を説明します。これらのパッケージは \fBapt\fP でインストールできます。
 .sp
 32\-bit用と64\-bit用のパッケージを配布していますが、サーバ用途には64\-bitパッケージを利用することをオススメします。32\-bit用パッケージはテスト用か開発用にだけ使って下さい。32\-bit用パッケージを使った場合は、中程度のサイズのデータでもメモリ不足エラーになることがあります。
 .sp
 \fBノート:\fP
 .INDENT 0.0
 .INDENT 3.5
-\(aqgroonga\(aqパッケージは全文検索のための最小構成パッケージです。groongaをサーバー用途で使うなら、設定済みの追加パッケージをインストールすることができます。
+\(aqgroonga\(aqパッケージは全文検索のための最小構成パッケージです。Groongaをサーバー用途で使うなら、設定済みの追加パッケージをインストールすることができます。
 .sp
 サーバー用途のための3つのパッケージがあります。
 .INDENT 0.0
@@ -706,103 +633,12 @@ groonga\-server\-gqtp (GQTPサーバー)
 詳細は \fB/server\fP を参照してください。
 .UNINDENT
 .UNINDENT
-.SS 10.04 LTS Lucid Lynx
-.sp
-\fBノート:\fP
-.INDENT 0.0
-.INDENT 3.5
-groongaをインストールするためにuniverseリポジトリを有効にしてください:
-.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
-groongaのaptリポジトリを追加します。
-.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
-インストール:
-.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
-\fI\%MeCab\fP をトークナイザーとして使いたいときは、groonga\-tokenizer\-mecabパッケージをインストールしてください。
-.sp
-groonga\-tokenizer\-mecabパッケージのインストール:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% sudo apt\-get \-y install groonga\-tokenizer\-mecab
-.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 \-y install 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 apt\-get \-y install groonga\-normalizer\-mysql
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
 .SS 12.04 LTS Precise Pangolin
 .sp
 \fBノート:\fP
 .INDENT 0.0
 .INDENT 3.5
-groongaをインストールするためにuniverseリポジトリを有効にしてください:
+Groongaをインストールするためにuniverseリポジトリを有効にしてください:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -817,7 +653,7 @@ groongaをインストールするためにuniverseリポジトリを有効に
 .UNINDENT
 .UNINDENT
 .sp
-groongaのaptリポジトリを追加します。
+Groongaのaptリポジトリを追加します。
 .sp
 /etc/apt/sources.list.d/groonga.list:
 .INDENT 0.0
@@ -861,7 +697,7 @@ groonga\-tokenizer\-mecabパッケージのインストール:
 .UNINDENT
 .UNINDENT
 .sp
-\fI\%Munin\fP プラグインを提供するパッケージもあります。Muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
+\fI\%Munin\fP プラグインを提供するパッケージもあります。MuninでGroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
 .sp
 groonga\-munin\-pluginsパッケージのインストール:
 .INDENT 0.0
@@ -875,7 +711,7 @@ groonga\-munin\-pluginsパッケージのインストール:
 .UNINDENT
 .UNINDENT
 .sp
-MySQL互換のノーマライザーをgroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
+MySQL互換のノーマライザーをGroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
 .sp
 groonga\-normalizer\-mysqlパッケージのインストール:
 .INDENT 0.0
@@ -893,7 +729,7 @@ groonga\-normalizer\-mysqlパッケージのインストール:
 \fBノート:\fP
 .INDENT 0.0
 .INDENT 3.5
-groongaをインストールするためにuniverseリポジトリを有効にしてください:
+Groongaをインストールするためにuniverseリポジトリを有効にしてください:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -908,7 +744,7 @@ groongaをインストールするためにuniverseリポジトリを有効に
 .UNINDENT
 .UNINDENT
 .sp
-groongaのaptリポジトリを追加します。
+Groongaのaptリポジトリを追加します。
 .sp
 /etc/apt/sources.list.d/groonga.list:
 .INDENT 0.0
@@ -952,7 +788,7 @@ groonga\-tokenizer\-mecabパッケージのインストール:
 .UNINDENT
 .UNINDENT
 .sp
-\fI\%Munin\fP プラグインを提供するパッケージもあります。Muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
+\fI\%Munin\fP プラグインを提供するパッケージもあります。MuninでGroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
 .sp
 groonga\-munin\-pluginsパッケージのインストール:
 .INDENT 0.0
@@ -966,7 +802,7 @@ groonga\-munin\-pluginsパッケージのインストール:
 .UNINDENT
 .UNINDENT
 .sp
-MySQL互換のノーマライザーをgroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
+MySQL互換のノーマライザーをGroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
 .sp
 groonga\-normalizer\-mysqlパッケージのインストール:
 .INDENT 0.0
@@ -984,7 +820,7 @@ groonga\-normalizer\-mysqlパッケージのインストール:
 \fBノート:\fP
 .INDENT 0.0
 .INDENT 3.5
-groongaをインストールするためにuniverseリポジトリを有効にしてください:
+Groongaをインストールするためにuniverseリポジトリを有効にしてください:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -999,7 +835,7 @@ groongaをインストールするためにuniverseリポジトリを有効に
 .UNINDENT
 .UNINDENT
 .sp
-groongaのaptリポジトリを追加します。
+Groongaのaptリポジトリを追加します。
 .sp
 /etc/apt/sources.list.d/groonga.list:
 .INDENT 0.0
@@ -1043,7 +879,7 @@ groonga\-tokenizer\-mecabパッケージのインストール:
 .UNINDENT
 .UNINDENT
 .sp
-\fI\%Munin\fP プラグインを提供するパッケージもあります。Muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
+\fI\%Munin\fP プラグインを提供するパッケージもあります。MuninでGroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
 .sp
 groonga\-munin\-pluginsパッケージのインストール:
 .INDENT 0.0
@@ -1057,7 +893,7 @@ groonga\-munin\-pluginsパッケージのインストール:
 .UNINDENT
 .UNINDENT
 .sp
-MySQL互換のノーマライザーをgroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
+MySQL互換のノーマライザーをGroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
 .sp
 groonga\-normalizer\-mysqlパッケージのインストール:
 .INDENT 0.0
@@ -1145,7 +981,7 @@ groonga\-normalizer\-mysqlパッケージのインストール:
 .UNINDENT
 .SS ソースからビルド
 .sp
-groongaをビルドするために必要なパッケージをインストールします:
+Groongaをビルドするために必要なパッケージをインストールします:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -1163,9 +999,9 @@ groongaをビルドするために必要なパッケージをインストール
 .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
@@ -1208,14 +1044,14 @@ configureを実行します（ \fBconfigure\fP のオプションについては
 .UNINDENT
 .SS CentOS
 .sp
-このセクションではCentOS上でgroonga関連のPRMパッケージをインストールする方法を説明します。これらのパッケージは \fByum\fP でインストールできます。
+このセクションではCentOS上でGroonga関連のPRMパッケージをインストールする方法を説明します。これらのパッケージは \fByum\fP でインストールできます。
 .sp
 32\-bit用と64\-bit用のパッケージを配布していますが、サーバ用途には64\-bitパッケージを利用することをオススメします。32\-bit用パッケージはテスト用か開発用にだけ使って下さい。32\-bit用パッケージを使った場合は、中程度のサイズのデータでもメモリ不足エラーになることがあります。
 .sp
 \fBノート:\fP
 .INDENT 0.0
 .INDENT 3.5
-\(aqgroonga\(aqパッケージは全文検索のための最小構成パッケージです。groongaをサーバー用途で使うなら、設定済みの追加パッケージをインストールすることができます。
+\(aqgroonga\(aqパッケージは全文検索のための最小構成パッケージです。Groongaをサーバー用途で使うなら、設定済みの追加パッケージをインストールすることができます。
 .sp
 サーバー用途のための3つのパッケージがあります。
 .INDENT 0.0
@@ -1286,7 +1122,7 @@ IPA辞書をインストールします:
 .UNINDENT
 .UNINDENT
 .sp
-\fI\%Munin\fP プラグインを提供するパッケージもあります。Muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
+\fI\%Munin\fP プラグインを提供するパッケージもあります。MuninでGroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
 .sp
 \fBノート:\fP
 .INDENT 0.0
@@ -1346,7 +1182,7 @@ groonga\-munin\-pluginsパッケージのインストール:
 .UNINDENT
 .UNINDENT
 .sp
-MySQL互換のノーマライザーをgroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
+MySQL互換のノーマライザーをGroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
 .sp
 groonga\-normalizer\-mysqlパッケージのインストール:
 .INDENT 0.0
@@ -1415,7 +1251,7 @@ IPA辞書をインストールします:
 .UNINDENT
 .UNINDENT
 .sp
-\fI\%Munin\fP プラグインを提供するパッケージもあります。Muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
+\fI\%Munin\fP プラグインを提供するパッケージもあります。MuninでGroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
 .sp
 \fBノート:\fP
 .INDENT 0.0
@@ -1448,7 +1284,7 @@ groonga\-munin\-pluginsパッケージのインストール:
 .UNINDENT
 .UNINDENT
 .sp
-MySQL互換のノーマライザーをgroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
+MySQL互換のノーマライザーをGroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
 .sp
 groonga\-normalizer\-mysqlパッケージのインストール:
 .INDENT 0.0
@@ -1463,7 +1299,7 @@ groonga\-normalizer\-mysqlパッケージのインストール:
 .UNINDENT
 .SS ソースからビルド
 .sp
-groongaをビルドするために必要なパッケージをインストールします:
+Groongaをビルドするために必要なパッケージをインストールします:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -1481,9 +1317,9 @@ groongaをビルドするために必要なパッケージをインストール
 .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
@@ -1526,12 +1362,12 @@ configureを実行します（ \fBconfigure\fP のオプションについては
 .UNINDENT
 .SS Fedora
 .sp
-このセクションではFedora上でgroonga関連のRPMパッケージをインストールする方法を説明します。これらのパッケージは \fByum\fP でインストールできます。
+このセクションではFedora上でGroonga関連のRPMパッケージをインストールする方法を説明します。これらのパッケージは \fByum\fP でインストールできます。
 .sp
 \fBノート:\fP
 .INDENT 0.0
 .INDENT 3.5
-3.0.2のリリースから、groonga関連のRPMパッケージはFedoraの公式yumリポジトリでリリースしています。groongaのyumリポジトリのかわりにFedoraの公式リポジトリを使います。ただ、いくつか例外があって、 \fBgroonga\-normalizer\-mysql\fP や MeCabの辞書 ( \fBmecab\-ipadic\fP や \fBmecab\-jumandic\fP )パッケージを使うにはgroongaのyumリポジトリを使います。将来的には \fBgroonga\-normalizer\-mysql\fP もFedora公式のyumリポジトリで提供することを計画しています。
+3.0.2のリリースから、Groonga関連のRPMパッケージはFedoraの公式yumリポジトリでリリースしています。GroongaのyumリポジトリのかわりにFedoraの公式リポジトリを使います。ただ、いくつか例外があって、 \fBgroonga\-normalizer\-mysql\fP や MeCabの辞書 ( \fBmecab\-ipadic\fP や \fBmecab\-jumandic\fP )パッケージを使うにはGroongaのyumリポジトリを使います。将来的には \fBgroonga\-normalizer\-mysql\fP もFedora公式のyumリポジトリで提供することを計画しています。
 .UNINDENT
 .UNINDENT
 .sp
@@ -1540,7 +1376,7 @@ configureを実行します（ \fBconfigure\fP のオプションについては
 \fBノート:\fP
 .INDENT 0.0
 .INDENT 3.5
-\(aqgroonga\(aqパッケージは全文検索のための最小構成パッケージです。groongaをサーバー用途で使うなら、設定済みの追加パッケージをインストールすることができます。
+\(aqgroonga\(aqパッケージは全文検索のための最小構成パッケージです。Groongaをサーバー用途で使うなら、設定済みの追加パッケージをインストールすることができます。
 .sp
 サーバー用途のための3つのパッケージがあります。
 .INDENT 0.0
@@ -1555,7 +1391,7 @@ groonga\-server\-gqtp (GQTPサーバー)
 詳細は \fB/server\fP を参照してください。
 .UNINDENT
 .UNINDENT
-.SS Fedora 19
+.SS Fedora 20
 .sp
 インストール:
 .INDENT 0.0
@@ -1569,7 +1405,7 @@ groonga\-server\-gqtp (GQTPサーバー)
 .UNINDENT
 .UNINDENT
 .sp
-\fBgroonga\-normalizer\-mysql\fP や \fBmecab\-ipadic\fP 、 \fBmecab\-jumandic\fP といったパッケージを使うには groongaのyumリポジトリを提供する \fBgroonga\-release\fP パッケージをあらかじめインストールします。
+\fBgroonga\-normalizer\-mysql\fP や \fBmecab\-ipadic\fP 、 \fBmecab\-jumandic\fP といったパッケージを使うには Groongaのyumリポジトリを提供する \fBgroonga\-release\fP パッケージをあらかじめインストールします。
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -1622,7 +1458,7 @@ IPA辞書をインストールします:
 .UNINDENT
 .UNINDENT
 .sp
-\fI\%Munin\fP プラグインを提供するパッケージもあります。Muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
+\fI\%Munin\fP プラグインを提供するパッケージもあります。MuninでGroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
 .sp
 groonga\-munin\-pluginsパッケージのインストール:
 .INDENT 0.0
@@ -1636,7 +1472,7 @@ groonga\-munin\-pluginsパッケージのインストール:
 .UNINDENT
 .UNINDENT
 .sp
-MySQL互換のノーマライザーをgroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
+MySQL互換のノーマライザーをGroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
 .sp
 groonga\-normalizer\-mysqlパッケージのインストール:
 .INDENT 0.0
@@ -1651,7 +1487,7 @@ groonga\-normalizer\-mysqlパッケージのインストール:
 .UNINDENT
 .SS ソースからビルド
 .sp
-groongaをビルドするために必要なパッケージをインストールします:
+Groongaをビルドするために必要なパッケージをインストールします:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -1669,9 +1505,9 @@ groongaをビルドするために必要なパッケージをインストール
 .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
@@ -1714,10 +1550,10 @@ configureを実行します（ \fBconfigure\fP のオプションについては
 .UNINDENT
 .SS Oracle Solaris
 .sp
-このセクションではOracle Solaris上でgroongaをソースコードからインストールする方法を説明します。
+このセクションではOracle Solaris上でGroongaをソースコードからインストールする方法を説明します。
 .SS Oracle Solaris 11
 .sp
-groongaをビルドするために必要なパッケージをインストールします:
+Groongaをビルドするために必要なパッケージをインストールします:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -1735,9 +1571,9 @@ groongaをビルドするために必要なパッケージをインストール
 .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
@@ -1780,12 +1616,12 @@ groongaをビルドするために必要なパッケージをインストール
 .UNINDENT
 .SS その他
 .sp
-このセクションではUNIX系の環境でgroongaをソースコードからインストールする方法を説明します。
+このセクションではUNIX系の環境でGroongaをソースコードからインストールする方法を説明します。
 .sp
 \fB/install\fP にある特定環境用のドキュメントに、その環境向けのより詳細な情報があります。特定環境用のドキュメントがある場合は、まずそちらを参照してください。
 .SS 依存関係
 .sp
-groongaは特別なライブラリを必要としませんが、いくつかビルドに必要なツールがあります。
+Groongaは特別なライブラリを必要としませんが、いくつかビルドに必要なツールがあります。
 .SS ツール
 .sp
 以下が必要なツールです:
@@ -1817,7 +1653,7 @@ CコンパイラーとC++コンパイラー （ \fBgcc\fP と \fBg++\fP がサ
 .IP \(bu 2
 \fI\%pkg\-config\fP （ライブラリを検出するため）
 .IP \(bu 2
-\fI\%sudo\fP （ビルドしたgroongaをインストールするため）
+\fI\%sudo\fP （ビルドしたGroongaをインストールするため）
 .UNINDENT
 .UNINDENT
 .UNINDENT
@@ -1849,18 +1685,18 @@ CコンパイラーとC++コンパイラー （ \fBgcc\fP と \fBg++\fP がサ
 .UNINDENT
 .UNINDENT
 .sp
-これらのライブラリを使いたい場合は、groongaをインストールする前にライブラリをインストールしてください。
+これらのライブラリを使いたい場合は、Groongaをインストールする前にライブラリをインストールしてください。
 .SS ソースからビルド
 .sp
-groongaはGNUビルドシステムを使っています。以下は一番簡単なビルド手順です:
+GroongaはGNUビルドシステムを使っています。以下は一番簡単なビルド手順です:
 .INDENT 0.0
 .INDENT 3.5
 .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
@@ -1871,7 +1707,7 @@ groongaはGNUビルドシステムを使っています。以下は一番簡単
 .sp
 上記の手順を実行すると \fB/usr/local/bin/groonga\fP に \fB/reference/executables/groonga\fP がインストールされます。
 .sp
-デフォルトのビルドでもうまく動くでしょうが、 \fBconfigure\fP のときにgroongaをカスタマイズすることができます。
+デフォルトのビルドでもうまく動くでしょうが、 \fBconfigure\fP のときにGroongaをカスタマイズすることができます。
 .sp
 以下、それぞれの手順の詳細を説明します。
 .SS \fBconfigure\fP
@@ -1879,11 +1715,11 @@ groongaはGNUビルドシステムを使っています。以下は一番簡単
 まず \fBconfigure\fP を実行します。重要な \fBconfigure\fP のオプションは以下の通りです:
 .SS \fB\-\-prefix=PATH\fP
 .sp
-インストール先となるディレクトリを指定します。groonga関連のファイルは  \fB${PATH}/\fP ディレクトリ以下にインストールされます。
+インストール先となるディレクトリを指定します。Groonga関連のファイルは  \fB${PATH}/\fP ディレクトリ以下にインストールされます。
 .sp
 デフォルトは \fB/usr/local\fP 。デフォルトの場合は \fB/reference/executables/groonga\fP は \fB/usr/local/bin/groonga\fP にインストールされます。
 .sp
-以下はシステム全体にgroongaをインストールするのではなく、ユーザーが個人で使う目的で \fB~/local\fP にインストールする例です:
+以下はシステム全体にGroongaをインストールするのではなく、ユーザーが個人で使う目的で \fB~/local\fP にインストールする例です:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -2014,7 +1850,7 @@ LZOを使ってカラム値を圧縮する機能を有効にします。
 .sp
 MessagePackがどこにインストールされているかを指定します。MessagePackを \fB\-\-prefix=/usr\fP という \fBconfigure\fP オプションでインストールしていない場合は、MessagePackをビルドするときに指定したパスをこのオプションで指定してください。
 .sp
-もし、MessagePackを \fB\-\-prefix=$HOME/local\fP という \fBconfigure\fP オプションでインストールした場合は、groongaの \fBconfigure\fP では \fB\-\-with\-message\-pack=$HOME/local\fP と指定してください。
+もし、MessagePackを \fB\-\-prefix=$HOME/local\fP という \fBconfigure\fP オプションでインストールした場合は、Groongaの \fBconfigure\fP では \fB\-\-with\-message\-pack=$HOME/local\fP と指定してください。
 .sp
 デフォルトは \fB/usr\fP です。
 .sp
@@ -2031,11 +1867,11 @@ MessagePackがどこにインストールされているかを指定します。
 .UNINDENT
 .SS \fB\-\-with\-munin\-plugins\fP
 .sp
-groonga用のMuninプラグインをインストールします。プラグインは \fB${PREFIX}/share/groonga/munin/plugins/\fP 以下にインストールされます。
+Groonga用のMuninプラグインをインストールします。プラグインは \fB${PREFIX}/share/groonga/munin/plugins/\fP 以下にインストールされます。
 .sp
 デフォルトではプラグインはインストールされません。
 .sp
-以下はgroonga用のMuninプラグインをインストールする例です:
+以下はGroonga用のMuninプラグインをインストールする例です:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -2068,7 +1904,7 @@ initスクリプトなどプラットフォーム依存のシステム管理フ
 すべての \fBconfigure\fP オプションを表示します。
 .SS \fBmake\fP
 .sp
-\fBconfigure\fP が成功したら \fBmake\fP でgroongaをビルドします:
+\fBconfigure\fP が成功したら \fBmake\fP でGroongaをビルドします:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -2095,7 +1931,7 @@ initスクリプトなどプラットフォーム依存のシステム管理フ
 \fBmake\fP で何かエラーが発生した場合は、そのエラーをレポートしてください: \fB/contribution/report\fP
 .SS \fBmake install\fP
 .sp
-これでビルドしたgroongaをインストールできます！:
+これでビルドしたGroongaをインストールできます！:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -2120,10 +1956,10 @@ initスクリプトなどプラットフォーム依存のシステム管理フ
 .UNINDENT
 .SH コミュニティ
 .sp
-groongaに関する情報を共有するための場所がいくつかあります。あなたの参加をお待ちしています！
+Groongaに関する情報を共有するための場所がいくつかあります。あなたの参加をお待ちしています！
 .SS メーリングリスト
 .sp
-groongaに関する話題を扱うメーリングリストがあります。
+Groongaに関する話題を扱うメーリングリストがあります。
 .INDENT 0.0
 .TP
 .B For English speakers
@@ -2134,21 +1970,21 @@ groongaに関する話題を扱うメーリングリストがあります。
 .UNINDENT
 .SS Twitter
 .sp
-\fI\%@groonga\fP がgroonga関連情報をツイートしています。
+\fI\%@groonga\fP がGroonga関連情報をツイートしています。
 .sp
-このアカウントをフォローして最新のgroonga関連情報をゲットしてください！
+このアカウントをフォローして最新のGroonga関連情報をゲットしてください！
 .SS Facebook
 .sp
-\fI\%Facebookのgroongaページ\fP ではgroonga関連情報をシェアしています。
+\fI\%FacebookのGroongaページ\fP ではGroonga関連情報をシェアしています。
 .sp
-このページをいいね！して最新のgroonga関連情報をゲットしてください！
+このページをいいね！して最新のGroonga関連情報をゲットしてください！
 .SH チュートリアル
 .SS 基本的な操作
 .sp
-groongaには、Cのライブラリとして使用する方法と、groonga実行ファイルを通して使用する方法があります。本チュートリアルでは、groonga実行ファイルを使用する方法について説明します。groonga実行ファイルを使って、データベースの作成・操作・サーバの起動・サーバへの接続などの操作が行えます。
+Groongaには、Cのライブラリとして使用する方法と、groonga実行ファイルを通して使用する方法があります。本チュートリアルでは、groonga実行ファイルを使用する方法について説明します。groonga実行ファイルを使って、データベースの作成・操作・サーバの起動・サーバへの接続などの操作が行えます。
 .SS データベースの作成
 .sp
-groongaユーザへの第一歩はデータベースの作成です。まずは以下の書式をご覧ください。
+Groongaユーザへの第一歩はデータベースの作成です。まずは以下の書式をご覧ください。
 .sp
 書式:
 .INDENT 0.0
@@ -2199,7 +2035,7 @@ DB_PATHには操作対象のデータベースを指定します。指定した
 .sp
 COMMAND が指定された場合、COMMAND を実行した後、実行結果を返します。指定されなかった場合には、対話モードに入ります。対話モードでは、標準入力からコマンドを読み込み、順次実行します。本チュートリアルでは、対話モードを主に使用します。
 .sp
-それでは、 \fB/reference/commands/status\fP コマンドを実行して、groongaの実行状態を確認してみましょう。
+それでは、 \fB/reference/commands/status\fP コマンドを実行して、Groongaの実行状態を確認してみましょう。
 .sp
 実行例:
 .INDENT 0.0
@@ -2220,10 +2056,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
 #   }
 # ]
@@ -2262,7 +2098,7 @@ Form_2: COMMAND \-\-NAME_1 VALUE_1 \-\-NAME_2 VALUE_2 ..
 .INDENT 0.0
 .TP
 .B \fB/reference/commands/status\fP
-groongaプロセスの状態を表示します。
+Groongaプロセスの状態を表示します。
 .TP
 .B \fB/reference/commands/table_list\fP
 データベースに定義されているテーブルのリストを表示します。
@@ -2288,7 +2124,7 @@ groongaプロセスの状態を表示します。
 .sp
 \fB/reference/commands/table_create\fP コマンドを使用してテーブルを作成します。
 .sp
-groongaのテーブルには基本的に主キーが必要であり、テーブルを作成する際には型と格納方法も併せて指定する必要があります。
+Groongaのテーブルには基本的に主キーが必要であり、テーブルを作成する際には型と格納方法も併せて指定する必要があります。
 .sp
 型には数値や文字列などがあります。ここではデータの種類を表しているものという程度に考えてください。詳細は \fB/reference/types\fP に記述されています。主キーの格納方法は、主キーを条件とする検索にかかる時間や、前方一致検索の可否などを左右します。こちらも後で説明します。
 .sp
@@ -2350,7 +2186,7 @@ select \-\-table Site
 .sp
 \fB/reference/commands/select\fP にテーブル名のみを指定すると、指定したテーブルの中身を10件まで表示します。実行結果の[0]はテーブルに含まれるレコードの数を示しています。今回は何も登録されていないため0件です。レコード数の次に表示されている配列はテーブルの構成を示しています。["_id","Uint32"]はUInt32型の値を持つ_idという名前のカラム、["_key","ShortText"]はShortText型の値を持つ_keyという名前のカラムをそれぞれ表しています。
 .sp
-上記の_idカラムと_keyカラムの2つのカラムは必須のカラムです。_idカラムはgroongaが自動的に割り当てるIDを格納します。_keyカラムは主キーを格納します。これらのカラム名を変更することはできません。
+上記の_idカラムと_keyカラムの2つのカラムは必須のカラムです。_idカラムはGroongaが自動的に割り当てるIDを格納します。_keyカラムは主キーを格納します。これらのカラム名を変更することはできません。
 .SS カラムの作成
 .sp
 \fB/reference/commands/column_create\fP コマンドを用いて、カラムを作成することができます。
@@ -2619,7 +2455,7 @@ select \-\-table Site \-\-query \(aq_key:"http://example.org/"\(aq
 .sp
 そろそろ全文検索の使い方について見ていきましょう。
 .sp
-groongaでは転置インデックスを使って高速な全文検索を実現しています。そのため、まずは転置インデックスとして用いるテーブルを作成する必要があります。テーブルの内容は、文書に含まれる単語やN\-gramなどの索引語を主キーとして、各カラムに索引語の位置情報を格納するという構成になります。結果として、主キーのカラムは全文検索における語彙表の役割を果たします。
+Groongaでは転置インデックスを使って高速な全文検索を実現しています。そのため、まずは転置インデックスとして用いるテーブルを作成する必要があります。テーブルの内容は、文書に含まれる単語やN\-gramなどの索引語を主キーとして、各カラムに索引語の位置情報を格納するという構成になります。結果として、主キーのカラムは全文検索における語彙表の役割を果たします。
 .sp
 以下の例では、Termsという名前のテーブルを転置インデックスの語彙表として作成しています。索引語を格納するため、主キーの型はShortTextです。
 .sp
@@ -3271,11 +3107,11 @@ select \-\-table Site \-\-query title:@test \-\-output_columns _id,_score,title
 現在のバージョンでは、全文検索インデックスが存在する場合にのみ、 \fImatch_columns\fP 引数を利用することができます。通常のカラムでの絞り込みには利用できません。
 .SS リモートアクセス
 .sp
-groongaをサーバとして起動することにより、ネットワークを介してデータベースにアクセスできるようになります。groongaがサポートしているプロトコルは、groongaの専用プロトコルであるgqtp、memcachedバイナリプロトコル、HTTPの三種類です。
-.SS groonga専用プロトコル（gqtp）
-.SS gqtpサーバの起動
+Groongaをサーバとして起動することにより、ネットワークを介してデータベースにアクセスできるようになります。groongaがサポートしているプロトコルは、Groongaの専用プロトコルであるGQTP、memcachedバイナリプロトコル、HTTPの三種類です。
+.SS Groonga専用プロトコル（GQTP）
+.SS GQTPサーバの起動
 .sp
-groongaには、専用のプロトコルであるgqtpが存在します。gqtpを用いることにより、データベースへとリモートアクセスすることができます。以下の書式はgqtpサーバの起動方法を示しています。
+Groongaには、専用のプロトコルであるGQTPが存在します。GQTPを用いることにより、データベースへとリモートアクセスすることができます。以下の書式はGQTPサーバの起動方法を示しています。
 .sp
 書式:
 .INDENT 0.0
@@ -3289,7 +3125,7 @@ groonga [\-p PORT_NUMBER] \-s DB_PATH
 .UNINDENT
 .UNINDENT
 .sp
-\fI\-s\fP オプションはgroongaをサーバとして起動するためのオプションです。DB_PATHには既存のデータベースのパスを指定します。 \fI\-p\fP オプションとその引数により、サーバのポート番号を指定することができます。ポート番号を省略した場合は10041が使用されます。
+\fI\-s\fP オプションはGroongaをサーバとして起動するためのオプションです。DB_PATHには既存のデータベースのパスを指定します。 \fI\-p\fP オプションとその引数により、サーバのポート番号を指定することができます。ポート番号を省略した場合は10041が使用されます。
 .sp
 以下のコマンドにより、デフォルトのポート番号で待ち受けるサーバを起動することができます。サーバは指定されたデータベースへの操作を受け付けます。
 .sp
@@ -3306,9 +3142,9 @@ Ctrl\-c
 .fi
 .UNINDENT
 .UNINDENT
-.SS gqtpデーモンの起動
+.SS GQTPデーモンの起動
 .sp
-gqtpサーバはデーモンとして起動することができます。オプションとして、 \fI\-s\fP の代わりに \fI\-d\fP を与えてください。
+GQTPサーバはデーモンとして起動することができます。オプションとして、 \fI\-s\fP の代わりに \fI\-d\fP を与えてください。
 .sp
 書式:
 .INDENT 0.0
@@ -3322,7 +3158,7 @@ groonga [\-p PORT_NUMBER] \-d DB_PATH
 .UNINDENT
 .UNINDENT
 .sp
-groongaをデーモンとして起動したときは、デーモンのプロセスIDが表示されます。以下の例では、12345というプロセスIDが表示されています。サーバとして起動した場合と同様に、指定されたデータベースへの操作を受け付けます。
+Groongaをデーモンとして起動したときは、デーモンのプロセスIDが表示されます。以下の例では、12345というプロセスIDが表示されています。サーバとして起動した場合と同様に、指定されたデータベースへの操作を受け付けます。
 .sp
 実行例:
 .INDENT 0.0
@@ -3337,9 +3173,9 @@ groongaをデーモンとして起動したときは、デーモンのプロセ
 .fi
 .UNINDENT
 .UNINDENT
-.SS gqtpサーバへの接続
+.SS GQTPサーバへの接続
 .sp
-gqtpサーバに接続するクライアントは、以下のように起動します。
+GQTPサーバに接続するクライアントは、以下のように起動します。
 .sp
 書式:
 .INDENT 0.0
@@ -3374,10 +3210,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
 #   }
 # ]
@@ -3389,9 +3225,9 @@ status
 .UNINDENT
 .sp
 対話モードでは、標準入力からコマンドを読み込んで順次実行します。
-.SS gqtpサーバの終了
+.SS GQTPサーバの終了
 .sp
-gqtpサーバを終了する安全は方法は、クライアントを起動して \fB/reference/commands/shutdown\fP を発行することです。
+GQTPサーバを終了する安全は方法は、クライアントを起動して \fB/reference/commands/shutdown\fP を発行することです。
 .sp
 実行例:
 .INDENT 0.0
@@ -3408,7 +3244,7 @@ gqtpサーバを終了する安全は方法は、クライアントを起動し
 .UNINDENT
 .SS memcachedバイナリプロトコル
 .sp
-groongaはmemcachedバイナリプロトコルをサポートしています。以下の書式はmemcachedバイナリプロトコルのサーバをデーモンとして起動する方法を示しています。
+Groongaはmemcachedバイナリプロトコルをサポートしています。以下の書式はmemcachedバイナリプロトコルのサーバをデーモンとして起動する方法を示しています。
 .sp
 書式:
 .INDENT 0.0
@@ -3426,7 +3262,7 @@ groonga [\-p PORT_NUMBER] \-d \-\-protocol memcached DB_PATH
 .SS HTTP
 .SS HTTPサーバの起動
 .sp
-groongaはHTTPをサポートしています。以下の書式はHTTPサーバをデーモンとして起動する方法を示しています。
+GroongaはHTTPをサポートしています。以下の書式はHTTPサーバをデーモンとして起動する方法を示しています。
 .sp
 書式:
 .INDENT 0.0
@@ -3465,7 +3301,7 @@ groonga [\-p PORT_NUMBER] \-d \-\-protocol http DB_PATH
 .UNINDENT
 .SS HTTPサーバへのコマンド送信
 .sp
-groongaがHTTPサーバとして起動されているときは、/d/COMMAND_NAME というURLにアクセスすることにより、コマンドを実行することができます。コマンドの引数は、HTTPのGETパラメータとして渡します。引数の書式は "?NAME_1=VALUE_1&NAME_2=VALUE_2&..." となります。
+GroongaがHTTPサーバとして起動されているときは、/d/COMMAND_NAME というURLにアクセスすることにより、コマンドを実行することができます。コマンドの引数は、HTTPのGETパラメータとして渡します。引数の書式は "?NAME_1=VALUE_1&NAME_2=VALUE_2&..." となります。
 .sp
 以下の例は、HTTPサーバに対するコマンドの送り方を示しています。
 .sp
@@ -3489,14 +3325,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
@@ -3568,16 +3403,16 @@ select \-\-table Site \-\-query title:@this
 .UNINDENT
 .SS ブラウザベースの管理ツール
 .sp
-groongaをHTTPサーバとして起動しているときは、ブラウザベースの管理ツールを使うことにより、データベースを簡単に管理することができます。管理ツールを使いたいときは、ブラウザを使って \fI\%http://HOST_NAME_OR_IP_ADDRESS[:PORT_NUMBER]/\fP へとアクセスしてください。管理ツールの使用には、JavaScriptの実行が有効になっている必要があります。
+GroongaをHTTPサーバとして起動しているときは、ブラウザベースの管理ツールを使うことにより、データベースを簡単に管理することができます。管理ツールを使いたいときは、ブラウザを使って \fI\%http://HOST_NAME_OR_IP_ADDRESS[:PORT_NUMBER]/\fP へとアクセスしてください。管理ツールの使用には、JavaScriptの実行が有効になっている必要があります。
 .SS セキュリティ
 .sp
-groongaのサーバには認証機能がありません。誰でもデータベースの内容を閲覧・修正することができます。iptablesなどを用いてアクセス元IPアドレスを制限することを推奨します。
+Groongaのサーバには認証機能がありません。誰でもデータベースの内容を閲覧・修正することができます。iptablesなどを用いてアクセス元IPアドレスを制限することを推奨します。
 .SS いろいろなデータの保存
 .sp
-groongaは全文検索エンジンを起源として独自のカラムストアを持つに至るわけですが、索引語や文書を保存するだけでなく、数値や文字列、日時や経緯度など、いろいろなデータを保存することができます。本チュートリアルでは、groongaで保存できるデータの種類、およびに保存の方法を説明します。
+Groongaは全文検索エンジンを起源として独自のカラムストアを持つに至るわけですが、索引語や文書を保存するだけでなく、数値や文字列、日時や経緯度など、いろいろなデータを保存することができます。本チュートリアルでは、Groongaで保存できるデータの種類、およびに保存の方法を説明します。
 .SS データの種類
 .sp
-groongaにおいて利用できる基本型は、真偽値、数値、文字列、日時、経緯度の5種類に大別できます。基本型において、数値は整数・浮動小数点数の違い、符号の有無と割り当てるビット数によって細分化できるほか、文字列は長さの上限によって細分化できます。また、経緯度には測地系による分類があります。詳しくは \fB/reference/types\fP を参照してください。
+Groongaにおいて利用できる基本型は、真偽値、数値、文字列、日時、経緯度の5種類に大別できます。基本型において、数値は整数・浮動小数点数の違い、符号の有無と割り当てるビット数によって細分化できるほか、文字列は長さの上限によって細分化できます。また、経緯度には測地系による分類があります。詳しくは \fB/reference/types\fP を参照してください。
 .sp
 拡張型としては、別テーブルを参照するための情報であるテーブル参照を保存することができます。また、基本型もしくはテーブル参照を複数まとめて保存できるように、ベクターカラムをサポートしています。
 .sp
@@ -3796,7 +3631,7 @@ select \-\-table ToyBox \-\-output_columns _key,name
 \fBノート:\fP
 .INDENT 0.0
 .INDENT 3.5
-groonga内部では経過秒数を整数のペアで保持しています。最初の整数で秒を表現し、もう一方でマイクロ秒を表現します。それゆえgroongaでは小数で経過秒数を表示します。整数部が秒数で、小数部はマイクロ秒の値です。
+Groonga内部では経過秒数を整数のペアで保持しています。最初の整数で秒を表現し、もう一方でマイクロ秒を表現します。それゆえGroongaでは小数で経過秒数を表示します。整数部が秒数で、小数部はマイクロ秒の値です。
 .UNINDENT
 .UNINDENT
 .sp
@@ -3928,7 +3763,7 @@ select \-\-table ToyBox \-\-output_columns _key,location
 .UNINDENT
 .SS テーブル参照
 .sp
-groongaでは、テーブル参照のカラム、すなわち関連付けたテーブルを参照するカラムを作成できます。より正確には、カラム作成時に参照先となるテーブルとの関連付けをおこない、参照先テーブルにおけるレコードIDを格納しておくことにより、参照先のレコードにアクセスできるようにします。
+Groongaでは、テーブル参照のカラム、すなわち関連付けたテーブルを参照するカラムを作成できます。より正確には、カラム作成時に参照先となるテーブルとの関連付けをおこない、参照先テーブルにおけるレコードIDを格納しておくことにより、参照先のレコードにアクセスできるようにします。
 .sp
 テーブル参照のカラムがあるときは、 \fBreference/commands/select\fP コマンドの \fIoutput_columns\fP 引数に "参照元カラム.参照先カラム" と指定することにより、参照先カラムの値を取り出すことができます。参照元カラムのみを指定したときは、 "参照元カラム名._key" と同様の扱いとなり、参照先レコードの主キーが取り出されます。テーブル参照が有効なレコードを指していないときは、参照先カラムのデフォルト値が取り出されるようになっています。
 .sp
@@ -4062,7 +3897,7 @@ select \-\-table Site \-\-output_columns _key,title,links._key,links.title \-\-q
 新たなカラムにはSiteテーブルに対する参照の配列を格納するので、 \fItype\fP 引数にSiteを指定するとともに、 \fIflags\fP 引数にCOLUMN_VECTORフラグを指定しています。次に、 \fB/reference/commands/load\fP による更新では、 "\fI\%http://example.org/\fP" から "\fI\%http://example.net/\fP" へのリンクに加えて、 "\fI\%http://example.org/\fP" と "\fI\%http://example.com/\fP" へのリンクも登録しています。そして、最後にリンクの内容を確認しています。この例では、 \fIoutput_columns\fP 引数に links._key と links.title を指定しているので、参照先の主キーとタイトルをそれぞれ配列にしたものが表示されています。
 .SS さまざまな検索条件の指定
 .sp
-groongaは、JavaScriptに似た文法での条件絞込や、計算した値を用いたソートを行うことができます。また、位置情報(緯度・経度)を用いた絞込・ソートを行うことができます。
+Groongaは、JavaScriptに似た文法での条件絞込や、計算した値を用いたソートを行うことができます。また、位置情報(緯度・経度)を用いた絞込・ソートを行うことができます。
 .SS JavaScriptに似た文法での絞込・全文検索
 .sp
 selectコマンドのfilterパラメータは、queryパラメータと同様に、レコードの検索条件を指定します。filterパラメータとqueryパラメータが異なる点は、filterパラメータには、JavaScriptの式に似た文法で条件を指定する点です。
@@ -4402,7 +4237,7 @@ _score
 よって、上記のクエリは実行されるたびに検索結果の並び順がランダムに変わります。
 .SS 位置情報を用いた絞込・ソート
 .sp
-groongaでは、位置情報（経緯度）を保存することができます。また、保存した経緯度を用いて絞込やソートができます。
+Groongaでは、位置情報（経緯度）を保存することができます。また、保存した経緯度を用いて絞込やソートができます。
 .sp
 位置情報を保存するためのカラムの型として、TokyoGeoPoint/WGS84GeoPointの２つの型があります。前者は日本測地系、後者は世界測地系(WGS84相当)の経緯度を保存します。
 .sp
@@ -4629,9 +4464,22 @@ select \-\-table Site \-\-output_columns _key,location \-\-filter \(aqgeo_in_cir
 また、経緯度が指定の矩形領域内であるかどうかを判定する \fB/reference/functions/geo_in_rectangle\fP 関数も存在します。
 .SS ドリルダウン
 .sp
-groongaでは、特定のカラム値で検索結果をグループ化することができます。これをドリルダウンと呼びます。
+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
-Siteテーブルに２つのカラムを追加します。TLDドメイン名を格納するdomainカラムと、国名を格納するcountryカラムです。これらのカラムの型は、それぞれドメイン名を主キーとするSiteDomainテーブルと、国名を主キーとするSiteCountryテーブルとします。
+この機能を使った具体的な例を示します。
+.sp
+この例では、 \fBSite\fP テーブルに2つのカラムを追加しています。 \fBdomain\fP カラムはTLD(トップレベルドメイン)に使います。 \fBcountry\fP カラムは国名に使います。これらのカラムの型はドメイン名を主キーとする \fBSiteDomain\fP テーブルと国名を主キーとする \fBSiteCountry\fP テーブルです。
 .sp
 実行例:
 .INDENT 0.0
@@ -4665,7 +4513,7 @@ load \-\-table Site
 .UNINDENT
 .UNINDENT
 .sp
-domainカラムとcountryカラムでドリルダウンを行う例を以下に示します。
+\fBdomain\fP カラムでドリルダウンする例を示します。 3つの値が \fBdomain\fP カラムでは使われています。".org"、".net"そして".com"です。
 .sp
 実行例:
 .INDENT 0.0
@@ -4754,7 +4602,72 @@ select \-\-table Site \-\-limit 0 \-\-drilldown domain
 .UNINDENT
 .UNINDENT
 .sp
-テーブル型を持つカラムに対してドリルダウンを行った場合、参照先のテーブルに存在するカラム値を取得することもできます。ドリルダウンを行ったテーブルには、_nsubrecsという仮想的なカラムが追加されます。このカラムには、グループ化されたレコード数が入ります。
+上記のクエリの集計結果です。
+.SS \fBdomain\fP カラムによるドリルダウン
+.TS
+center;
+|l|l|l|.
+_
+T{
+グループ化するカラムの値
+T}	T{
+グループ化されたレコード数
+T}	T{
+グループ化されたレコードは次のとおり
+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
+ドリルダウン結果は \fB_nsubrecs\fP カラムの値として返ります。この場合は、\fBSite\fP テーブルは ".org"、".net"、".com"ドメインでグループ化されています。 \fB_nsubrecs\fP はグループ化されたドメインが3つのレコードをそれぞれもつことを意味します。
+.sp
+テーブル型を持つカラムに対してドリルダウンを行った場合、参照先のテーブルに存在するカラム値を取得することもできます。ドリルダウンを行ったテーブルには、 \fB_nsubrecs\fP という仮想的なカラムが追加されます。このカラムには、グループ化されたレコード数が入ります。
+.sp
+では、参照されているテーブルの詳細を調べてみましょう。 \fBSite\fP テーブルは \fBSiteDomain\fP テーブルを \fBdomain\fP カラムの型として使っています。 \fB\-\-drilldown_output_columns\fP を参照されているカラムの詳細を知るのに使えます。
 .sp
 実行例:
 .INDENT 0.0
@@ -4850,7 +4763,7 @@ select \-\-table Site \-\-limit 0 \-\-drilldown domain \-\-drilldown_output_colu
 .UNINDENT
 .UNINDENT
 .sp
-複数のカラムに対してドリルダウンを行うことができます。複数のカラムに対してドリルダウンを行う場合には、drilldownパラメータにカラム名をカンマ区切りで与えます。
+これでグループ化されたドメインの詳細がわかります。 \fBdomain\fP の値が".org"であるレコードに対して \fBcountry\fP カラムを使ってドリルダウンしてみましょう。
 .sp
 実行例:
 .INDENT 0.0
@@ -4858,7 +4771,7 @@ select \-\-table Site \-\-limit 0 \-\-drilldown domain \-\-drilldown_output_colu
 .sp
 .nf
 .ft C
-select \-\-table Site \-\-limit 0 \-\-drilldown domain,country
+select \-\-table Site \-\-limit 0 \-\-filter "domain._id == 1" \-\-drilldown country
 # [
 #   [
 #     0,
@@ -4868,7 +4781,7 @@ select \-\-table Site \-\-limit 0 \-\-drilldown domain,country
 #   [
 #     [
 #       [
-#         9
+#         3
 #       ],
 #       [
 #         [
@@ -4920,27 +4833,117 @@ select \-\-table Site \-\-limit 0 \-\-drilldown domain,country
 #         ]
 #       ],
 #       [
-#         ".org",
-#         3
+#         "japan",
+#         1
 #       ],
 #       [
-#         ".net",
-#         3
+#         "korea",
+#         1
 #       ],
 #       [
-#         ".com",
-#         3
+#         "usa",
+#         1
 #       ]
-#     ],
-#     [
-#       [
-#         5
-#       ],
-#       [
-#         [
-#           "_key",
-#           "ShortText"
-#         ],
+#     ]
+#   ]
+# ]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS 複数のカラムでドリルダウン
+.sp
+ドリルダウンでは複数のカラムをサポートしています。 \fBdrilldown\fP パラメータの引数にカンマ区切りの値を指定します。すると一度にまとめてドリルダウン結果を取得できます。
+.sp
+実行例:
+.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"
@@ -4973,8 +4976,9 @@ select \-\-table Site \-\-limit 0 \-\-drilldown domain,country
 .fi
 .UNINDENT
 .UNINDENT
+.SS ドリルダウン結果をソートする
 .sp
-ドリルダウン結果を並びかえることができます。例えば、_nsubrecsパラメータの降順で並び替えることができます。
+ドリルダウン結果をソートしたい場合には \fB\-\-drilldown_sortby\fP を使います。指定した \fB_nsubrecs\fP カラムを昇順でソートします。
 .sp
 実行例:
 .INDENT 0.0
@@ -5070,8 +5074,9 @@ select \-\-table Site \-\-limit 0 \-\-drilldown country \-\-drilldown_sortby _ns
 .fi
 .UNINDENT
 .UNINDENT
+.SS ドリルダウン結果の制限
 .sp
-ドリルダウン結果は、デフォルトでは10件のみ表示されます。drilldown_offsetパラメータと、drilldown_limitパラメータによって、offsetとlimitを指定することができます。
+ドリルダウン結果はデフォルト10件に制限されています。 \fBdrilldown_limits\fP と \fBdrilldown_offset\fP パラメータをドリルダウン結果をカスタマイズするのに使います。
 .sp
 実行例:
 .INDENT 0.0
@@ -5159,9 +5164,9 @@ select \-\-table Site \-\-limit 0 \-\-drilldown country \-\-drilldown_sortby _ns
 文字列型のカラムに対するドリルダウンは、他の型でのドリルダウンに比べて低速です。文字列でのドリルダウンを行いたい場合には、このチュートリアルのように、文字列型を主キーとするテーブルを別途作成し、そのテーブルを型とするカラムを作成します。
 .SS タグ検索・参照関係の逆引き
 .sp
-本チュートリアルで、groongaはカラム値として他のテーブルへの参照の配列を持つことができることを紹介いたしました。実は、テーブルへの参照の配列データを用いることによって、いわゆるタグ検索を行うことが可能となります。
+本チュートリアルで、Groongaはカラム値として他のテーブルへの参照の配列を持つことができることを紹介いたしました。実は、テーブルへの参照の配列データを用いることによって、いわゆるタグ検索を行うことが可能となります。
 .sp
-タグ検索はgroongaの転置インデックスというデータ構造を用いて高速に行われます。
+タグ検索はGroongaの転置インデックスというデータ構造を用いて高速に行われます。
 .SS タグ検索
 .sp
 動画共有サイトの検索エンジンを作ることを想定します。1つの動画には、その動画の特徴を表す、複数の語句が付与されています。「ある語句が付与されている動画の一覧を取得する」検索を行いたいとします。
@@ -5325,7 +5330,7 @@ select \-\-table Video \-\-query tags:@Animation \-\-output_columns _key,title
 このように、「Variety」、「Sports」、「Animation」のようなタグで検索を行うことができました。
 .SS 参照関係の逆引き
 .sp
-groongaはテーブル間の参照関係の逆引きを高速に行うためのインデックスを付与することができます。タグ検索は、その1例にすぎません。
+Groongaはテーブル間の参照関係の逆引きを高速に行うためのインデックスを付与することができます。タグ検索は、その1例にすぎません。
 .sp
 例えば、ソーシャルネットワーキングサイトにおける友人関係を逆引き検索することができます。
 .sp
@@ -5653,9 +5658,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カラムを追加しています。
@@ -6372,7 +6377,7 @@ select Articles2 \-\-match_columns comment.comment.content \-\-query mroonga \-\
 執筆中です。
 .SS パトリシア木による前方一致検索
 .sp
-groongaのテーブルは、テーブル作成時にパトリシア木オプションを指定すると、前方一致検索を行うことができます。また、追加のオプションを指定することにより、主キーの後方一致検索をも行うことができます。
+Groongaのテーブルは、テーブル作成時にパトリシア木オプションを指定すると、前方一致検索を行うことができます。また、追加のオプションを指定することにより、主キーの後方一致検索をも行うことができます。
 .SS 主キーによる前方一致検索
 .sp
 table_createコマンドのflagsオプションにTABLE_PAT_KEYを指定することで、主キーによる前方一致検索ができるようになります。
@@ -6550,12 +6555,12 @@ select \-\-table PatSuffix \-\-filter \(aq_key @$ "ゆき" && original == true\(
 .UNINDENT
 .SS 全文検索の語彙表に対する追加情報
 .sp
-groongaでは、全文検索に用いるための語意表がテーブルとして扱えます。よって、語彙ごとに複数の情報を保持することができます。例えば、語彙の出現数や検索ストップワードのフラグ、単語の重要度などを保持することができます。
+Groongaでは、全文検索に用いるための語意表がテーブルとして扱えます。よって、語彙ごとに複数の情報を保持することができます。例えば、語彙の出現数や検索ストップワードのフラグ、単語の重要度などを保持することができます。
 .sp
 この項目については、現在執筆中です。
 .SS マイクロブログ検索システムの作成
 .sp
-これまで学んだgroongaの機能を用いて、マイクロブログの検索システムを作成してみましょう。マイクロブログとは、Twitterのような短いメッセージを投稿するブログです。
+これまで学んだGroongaの機能を用いて、マイクロブログの検索システムを作成してみましょう。マイクロブログとは、Twitterのような短いメッセージを投稿するブログです。
 .SS テーブルの作成
 .sp
 まずは、テーブルを作成します。
@@ -7540,7 +7545,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_expanderパラメータを指定することによって、ユーザが指定した検索文字列を適宜拡張することが可能です。
+Groongaでは、 \fB/reference/commands/select\fP コマンドにquery_expanderパラメータを指定することによって、ユーザが指定した検索文字列を適宜拡張することが可能です。
 .sp
 たとえば、ユーザが\(aqシークヮーサー\(aqという文字列で検索した場合に、\(aqシークヮーサー OR シークァーサー\(aqで検索した場合と同一の結果を返すことによって、本来ユーザが必要とする結果をよりもれなく検索できるようになります。
 .SS 準備
@@ -8802,10 +8807,10 @@ load \-\-table event_query \-\-each \(aqsuggest_preparer(_id, type, item, sequen
 .UNINDENT
 .SH 位置情報検索
 .sp
-groongaは位置情報検索をサポートしています。検索にはインデックスを使うので全文検索と同様に位置情報も高速に検索できます。
+Groongaは位置情報検索をサポートしています。検索にはインデックスを使うので全文検索と同様に位置情報も高速に検索できます。
 .SS 対応している機能
 .sp
-groongaは位置情報データのうち座標データのみサポートしています。線や面などはサポートしています。よってgroongaができることは以下の通りです。
+Groongaは位置情報データのうち座標データのみサポートしています。線や面などはサポートしています。よってGroongaができることは以下の通りです。
 .INDENT 0.0
 .IP 1. 3
 カラムに座標データを保存できる。
@@ -8819,7 +8824,7 @@ groongaは位置情報データのうち座標データのみサポートして
 指定した座標からの距離が近い順にレコードをソートできる。
 .UNINDENT
 .sp
-以下はgroongaの位置情報検索を利用例です。
+以下はGroongaの位置情報検索を利用例です。
 .INDENT 0.0
 .IP \(bu 2
 駅の近くにあるマクドナルドをリストする。
@@ -8827,15 +8832,15 @@ groongaは位置情報データのうち座標データのみサポートして
 現在地から近い順にケンタッキーをソートし、現在地からの距離付きでリストする。
 .UNINDENT
 .sp
-以下はgroongaではできないことです。
+以下はGroongaではできないことです。
 .INDENT 0.0
 .IP \(bu 2
-市内にあるマクドナルドを検索する。（groongaは四角形と円以外の形状の位置情報検索をサポートしていません。）
+市内にあるマクドナルドを検索する。（Groongaは四角形と円以外の形状の位置情報検索をサポートしていません。）
 .IP \(bu 2
 湖を表すレコードに位置情報として座標ではなく範囲を格納する。（カラムには座標データ以外を格納できません。）
 .UNINDENT
 .sp
-以下の図はgroongaの位置情報検索機能を示しています。
+以下の図はGroongaの位置情報検索機能を示しています。
 .sp
 以下の図はレコードのみがある図です。黒い点がレコードを表しています。以降の図ではレコードがどのように扱われるかを示します。
 [画像: only records]
@@ -10487,14 +10492,14 @@ http {
     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
   }
 ]
@@ -11451,21 +11456,21 @@ MessagePack形式の出力にする場合は \fBmsgpack\fP 拡張子を指定し
 .UNINDENT
 .SS コマンド
 .sp
-コマンドはクエリーAPIでもっとも重要な処理単位です。コマンドでgroongaに処理をリクエストします。
+コマンドはクエリーAPIでもっとも重要な処理単位です。コマンドでGroongaに処理をリクエストします。
 .sp
 このセクションではコマンドについての説明と組み込みのコマンドについて説明します。
 .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
@@ -11478,9 +11483,9 @@ groonga1.1からコマンドバージョンという概念が導入されます
 使用可能であり仕様も安定していますが、廃止予定であり使用が推奨されません。
 .UNINDENT
 .sp
-あるバージョンのgroongaがサポートする二つのコマンドバージョンのうち、いずれか一つが必ずstableの位置づけとなります。残りの一つは、developないしdeprecatedとなります。
+あるバージョンのGroongaがサポートする二つのコマンドバージョンのうち、いずれか一つが必ずstableの位置づけとなります。残りの一つは、developないしdeprecatedとなります。
 .sp
-たとえば下記のようにgroongaのサポートするコマンドバージョンは推移します。:
+たとえば下記のようにGroongaのサポートするコマンドバージョンは推移します。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -11733,7 +11738,7 @@ JSON形式、MessagePack形式のときは以下のような構造になりま
 .UNINDENT
 .UNINDENT
 .sp
-\fBLOCATION_IN_GROONGA\fP はgroonga内でエラーが発生したソースコードの場所です。この情報はgroonga開発者には役に立ちますが、ユーザーの役には立ちません。 \fBLOCATION_IN_GROONGA\fP は配列です。 \fBLOCATION_IN_GROONGA\fP には3個の要素があります:
+\fBLOCATION_IN_GROONGA\fP はGroonga内でエラーが発生したソースコードの場所です。この情報はGroonga開発者には役に立ちますが、ユーザーの役には立ちません。 \fBLOCATION_IN_GROONGA\fP は配列です。 \fBLOCATION_IN_GROONGA\fP には3個の要素があります:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -11751,7 +11756,7 @@ JSON形式、MessagePack形式のときは以下のような構造になりま
 .sp
 \fBFUNCTION_NAME\fP はエラーが発生した関数の名前です。
 .sp
-\fBSOURCE_FILE_NAME\fP はエラーが発生した箇所を含んだgroongaのソースコードのファイル名です。
+\fBSOURCE_FILE_NAME\fP はエラーが発生した箇所を含んだGroongaのソースコードのファイル名です。
 .sp
 \fBLINE_NUMBER\fP はエラーが発生した箇所の \fBSOURCE_FILE_NAME\fP での行番号です。
 .sp
@@ -12069,7 +12074,7 @@ check obj
 .UNINDENT
 .SS 説明
 .sp
-groonga組込コマンドの一つであるcheckについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるcheckについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 checkコマンドは、groongaプロセス内の指定したオブジェクトの状態を表示します。主にデータベースが壊れた場合など異常時の問題解決のために使用することを想定しています。デバッグ用のため、返値のフォーマットが安定しているということは保証されません。（フォーマットが変更される可能性が高い）
 .SS 引数
@@ -12308,7 +12313,7 @@ clearlock objname
 .UNINDENT
 .SS 説明
 .sp
-groonga組込コマンドの一つであるclearlockについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるclearlockについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 clearlockは、対象となるオブジェクト(データベース,テーブル,インデックス等)を指定し、オブジェクトにかけられたロックを再帰的に解除します。
 .SS 引数
@@ -12373,7 +12378,7 @@ clearlock Entry.body
 .sp
 column_create \- カラムの追加
 .sp
-groonga組込コマンドの一つであるcolumn_createについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるcolumn_createについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 column_createは、使用しているデータベースのテーブルに対してカラムを追加します。
 .SS 構文
@@ -12452,10 +12457,10 @@ column_create Term entry_body COLUMN_INDEX|WITH_POSITION Entry body
 .INDENT 0.0
 .TP
 .B 16, \fBCOMPRESS_ZLIB\fP
-予約済み。zlibを使ってカラムの値を圧縮します。このフラグはgroongaを \fB\-\-with\-zlib\fP つきでビルドしても使えません。
+予約済み。zlibを使ってカラムの値を圧縮します。このフラグはGroongaを \fB\-\-with\-zlib\fP つきでビルドしても使えません。
 .TP
 .B 32, \fBCOMPRESS_LZO\fP
-予約済み。lzoを使ってカラムの値を圧縮します。このフラグはgroongaを \fB\-\-with\-lzo\fP つきでビルドしても使えません。
+予約済み。lzoを使ってカラムの値を圧縮します。このフラグはGroongaを \fB\-\-with\-lzo\fP つきでビルドしても使えません。
 .UNINDENT
 .sp
 インデックス型のカラムについては、flagsの値に以下の値を加えることによって、追加の属
@@ -12477,7 +12482,7 @@ column_create Term entry_body COLUMN_INDEX|WITH_POSITION Entry body
 \fBtype\fP
 .INDENT 0.0
 .INDENT 3.5
-値の型を指定します。groongaの組込型か、同一データベースに定義済みのユーザ定義型、定義済みのテーブルを指定することができます。
+値の型を指定します。Groongaの組込型か、同一データベースに定義済みのユーザ定義型、定義済みのテーブルを指定することができます。
 .UNINDENT
 .UNINDENT
 .sp
@@ -12529,7 +12534,7 @@ column_list table
 .UNINDENT
 .SS 説明
 .sp
-groonga組込コマンドの一つであるcolumn_listについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるcolumn_listについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 column_listはテーブルに定義されているカラムをリスト表示します。
 .SS 引数
@@ -12678,7 +12683,7 @@ column_remove table name
 .UNINDENT
 .SS 説明
 .sp
-groonga組込コマンドの一つであるcolumn_removeについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるcolumn_removeについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 column_removeはテーブルに定義されているカラムを削除します。
 また、付随するインデックスも削除されます。[1]
@@ -12936,7 +12941,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 引数
@@ -13098,7 +13103,7 @@ defrag objname threshold
 .UNINDENT
 .SS 説明
 .sp
-groonga組込コマンドの一つであるdefragについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるdefragについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 defragは、対象となるオブジェクト(データベースか可変長サイズカラム)を指定し、オブジェクトのフラグメンテーションを解消します。
 .SS 引数
@@ -13428,11 +13433,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
@@ -13455,7 +13460,7 @@ dumpが出力するフォーマットは直接groongaが解釈できるフォー
 .UNINDENT
 .SS 返値
 .sp
-データベースのスキーマとデータをgroongaの組み込みコマンド呼び出し形式で出力します。output_type指定は無視されます。
+データベースのスキーマとデータをGroongaの組み込みコマンド呼び出し形式で出力します。output_type指定は無視されます。
 .SS 例
 .sp
 データベース内のすべてのデータを出力:
@@ -13653,7 +13658,7 @@ log_level level
 .UNINDENT
 .SS 説明
 .sp
-groonga組込コマンドの一つであるlog_levelについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるlog_levelについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 log_levelは、ログ出力レベルを設定します。
 .SS 引数
@@ -13810,7 +13815,7 @@ log_reopen
 .UNINDENT
 .SS 説明
 .sp
-groonga組込コマンドの一つであるlog_reopenについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるlog_reopenについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 log_reopenは、ログファイルを再読み込みします。
 .sp
@@ -14077,7 +14082,7 @@ quit
 .UNINDENT
 .SS 説明
 .sp
-groonga組込コマンドの一つであるquitについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるquitについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 quitは、groongaプロセスとのセッションを終了します。クライアントプロセスならばgroongaプロセスとの接続を切ります。
 .SS 引数
@@ -16708,7 +16713,7 @@ shutdown
 .UNINDENT
 .SS 説明
 .sp
-groonga組込コマンドの一つであるshutdownについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるshutdownについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 shutdownは、接続しているgroongaサーバプロセスを停止します。
 .SS 引数
@@ -16745,7 +16750,7 @@ status
 .UNINDENT
 .SS 説明
 .sp
-groonga組込コマンドの一つであるstatusについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるstatusについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 statusコマンドは、groongaプロセスの状態を表示します。主にgroongaサーバプロセスに対して使用することを想定しています。
 .SS 引数
@@ -16767,7 +16772,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
@@ -16800,14 +16805,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
 #   }
 # ]
@@ -17411,7 +17416,7 @@ table_create Logs TABLE_NO_KEY
 .sp
 この \fBtable_create\fP コマンドは \fBLogs\fP という名前で \fBTABLE_NO_KEY\fP 型のテーブルを作成します。
 .sp
-キーでレコードを検索しないのであれば、 \fBTABLE_NO_KEY\fP 型のテーブルが適切です。なぜなら、 \fBTABLE_NO_KEY\fP はキーをサポートしていませんが、速くて小さいサイズのテーブルだからです。ログをgroongaのデータベースに保存するという使い方はこのケースです。
+キーでレコードを検索しないのであれば、 \fBTABLE_NO_KEY\fP 型のテーブルが適切です。なぜなら、 \fBTABLE_NO_KEY\fP はキーをサポートしていませんが、速くて小さいサイズのテーブルだからです。ログをGroongaのデータベースに保存するという使い方はこのケースです。
 .sp
 キーでレコードを検索したり、カラムからレコードを参照したりする場合は、 \fBTABLE_NO_KEY\fP 型は適していません。全文検索用の語彙表として使うケースはこのケースです。
 .SS 語彙表テーブルの作成
@@ -17582,7 +17587,7 @@ _
 \fBノート:\fP
 .INDENT 0.0
 .INDENT 3.5
-groonga 2.1.0から \fBKEY_NORMALIZE\fP フラグは非推奨になりました。代わりに、 \fBnormalizer\fP オプションに \fBNormalizerAuto\fP を指定してください。
+Groonga 2.1.0から \fBKEY_NORMALIZE\fP フラグは非推奨になりました。代わりに、 \fBnormalizer\fP オプションに \fBNormalizerAuto\fP を指定してください。
 .UNINDENT
 .UNINDENT
 .sp
@@ -17676,7 +17681,7 @@ table_list
 .UNINDENT
 .SS 説明
 .sp
-groonga組込コマンドの一つであるtable_listについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるtable_listについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 .sp
 table_listは、DBに定義されているテーブルのリストを表示します。
 .SS 引数
@@ -18774,14 +18779,14 @@ HEADERのフォーマットは  [0, UNIX_TIME_WHEN_COMMAND_IS_STARTED, ELAPSED_T
 .SS データ型
 .SS 名前
 .sp
-groonga データ型
+Groonga データ型
 .SS 説明
 .sp
-groonga は、格納するデータの型を区別します。
+Groonga は、格納するデータの型を区別します。
 .sp
-groongaのデータベースでは、テーブルの主キーや、カラムの値はいずれも何らかの型に属します。また通常は、一つのテーブルの中の全てのレコードについて、カラムの値は共通となります。
+Groongaのデータベースでは、テーブルの主キーや、カラムの値はいずれも何らかの型に属します。また通常は、一つのテーブルの中の全てのレコードについて、カラムの値は共通となります。
 .sp
-主キーの型とカラムの型には、groongaで予め定義済みの型か、ユーザが定義する型、またはユーザが定義したテーブルを指定することができます。
+主キーの型とカラムの型には、Groongaで予め定義済みの型か、ユーザが定義する型、またはユーザが定義したテーブルを指定することができます。
 .sp
 主キーの型に他のテーブルを指定する場合は、そのテーブルは、主キーの型となるテーブルのサブセットとなります。
 .sp
@@ -18927,7 +18932,7 @@ IEEE 754形式の詳細については、 \fI\%IEEE 754 \- Wikipedia\fP や \fI\
 Text型とLongText型については、テーブルの主キーに指定することはできません。
 .SS ベクターとして格納できない型
 .sp
-groongaのカラムは、ある型のベクターを保存することができます。しかし、ShortText, Text, LongTextの３つの型についてはベクターとして保存したり出力したりすることはできますが、検索条件やドリルダウン条件に指定することができません。
+Groongaのカラムは、ある型のベクターを保存することができます。しかし、ShortText, Text, LongTextの３つの型についてはベクターとして保存したり出力したりすることはできますが、検索条件やドリルダウン条件に指定することができません。
 .sp
 テーブル型は、ベクターとして格納することができます。よって、ShortTextのベクターを検索条件やドリルダウン条件に使用したい場合には、主キーがShortText型のテーブルを別途作成し、そのテーブルを型として利用します。
 脚注
@@ -19161,9 +19166,9 @@ _
 .SS ノーマライザー
 .SS 概要
 .sp
-groongaには正規化をするノーマライザーモジュールがあります。これはテキストをトークナイズするときとテーブルのキーを保存するときに使われます。例えば、正規化をした後は \fBA\fP と \fBa\fP は同じ文字として扱われます。
+Groongaには正規化をするノーマライザーモジュールがあります。これはテキストをトークナイズするときとテーブルのキーを保存するときに使われます。例えば、正規化をした後は \fBA\fP と \fBa\fP は同じ文字として扱われます。
 .sp
-ノーマライザーモジュールはプラグインとして追加できます。ノーマライザープラグインをgroongaに追加することでテキストの正規化方法をカスタマイズできます。
+ノーマライザーモジュールはプラグインとして追加できます。ノーマライザープラグインをGroongaに追加することでテキストの正規化方法をカスタマイズできます。
 .sp
 ノーマライザーモジュールはテーブルに関連付いています。テーブルは0個か1個のノーマライザーモジュールを持つことができます。 \fB/reference/commands/table_create\fP の \fItable\-create\-normalizer\fP オプションでテーブルにノーマライザーオプションを関連付けることができます。
 .sp
@@ -19185,9 +19190,9 @@ table_create Dictionary TABLE_HASH_KEY ShortText \-\-normalizer NormalizerAuto
 \fBノート:\fP
 .INDENT 0.0
 .INDENT 3.5
-groonga 2.0.9以前には \fBtable_create\fP に \fB\-\-normalizer\fP オプションはありません。代わりに \fBKEY_NORMALIZE\fP フラグを使っていました。
+Groonga 2.0.9以前には \fBtable_create\fP に \fB\-\-normalizer\fP オプションはありません。代わりに \fBKEY_NORMALIZE\fP フラグを使っていました。
 .sp
-groonga 2.1.0以降で古いデータベースを開くことができます。ここでいう古いデータベースとはgroonga 2.0.9以前で作ったデータベースということです。しかし、一度新しいgroongaで開いたデータベースを2.0.9以前のgroongaで開くことはできません。一度 groonga 2.1.0以降のgroongaでデータベースを開くと、 \fBKEY_NORMALIZE\fP フラグ情報がノーマライザー情報に変換されます。そのため、2.0.9以前のgroongaは、一度groonga 2.1.0以降で開いたデータベース内から \fBKEY_NROMALIZE\fP フラグの情報を見つけることができません。
+Groonga 2.1.0以降で古いデータベースを開くことができます。ここでいう古いデータベースとはGroonga 2.0.9以前で作ったデータベースということです。しかし、一度新しいGroongaで開いたデータベースを2.0.9以前のGroongaで開くことはできません。一度 Groonga 2.1.0以降のGroongaでデータベースを開くと、 \fBKEY_NORMALIZE\fP フラグ情報がノーマライザー情報に変換されます。そのため、2.0.9以前のGroongaは、一度Groonga 2.1.0以降で開いたデータベース内から \fBKEY_NROMALIZE\fP フラグの情報を見つけることができません。
 .UNINDENT
 .UNINDENT
 .sp
@@ -19266,7 +19271,7 @@ select Dictionary
 .UNINDENT
 .SS \fBNormalizerAuto\fP
 .sp
-通常は \fBNormalizerAuto\fP ノーマライザーを使うべきです。 \fBNormalizerAuto\fP はgroonga 2.0.9以前で使っていたノーマライザーと同じものです。2.0.9以前のgroongaの \fBtable_create\fP の \fBKEY_NORMALIZE\fP フラグは、2.1.0以降のgroongaの \fBtable_create\fP の \fB\-\-normalizer NormalizerAuto\fP と同じです。
+通常は \fBNormalizerAuto\fP ノーマライザーを使うべきです。 \fBNormalizerAuto\fP はGroonga 2.0.9以前で使っていたノーマライザーと同じものです。2.0.9以前のGroongaの \fBtable_create\fP の \fBKEY_NORMALIZE\fP フラグは、2.1.0以降のGroongaの \fBtable_create\fP の \fB\-\-normalizer NormalizerAuto\fP と同じです。
 .sp
 \fBNormalizerAuto\fP はすべてのエンコーディングに対応しています。UTF\-8でエンコードされたテキストにはUnicodeのNFKC（Normalization Form Compatibility Composition）を使います。他のエンコーディング用にはエンコーディング毎に独自の正規化をします。これらの独自の正規化の結果はNFKCでの結果と似たものになります。
 .sp
@@ -19322,7 +19327,7 @@ table_create NFKC51Lexicon TABLE_HASH_KEY ShortText \-\-normalizer NormalizerNFK
 .UNINDENT
 .UNINDENT
 .sp
-\fBgroonga\-normalizer\-mysql\fP はgroongaのプラグインです。MySQL互換のノーマライザーを提供します。ノーマライザー \fBNormalizerMySQLGeneralCI\fP に対応するのは \fButf8mb4_general_ci\fP です。
+\fBgroonga\-normalizer\-mysql\fP はGroongaのプラグインです。MySQL互換のノーマライザーを提供します。ノーマライザー \fBNormalizerMySQLGeneralCI\fP に対応するのは \fButf8mb4_general_ci\fP です。
 .sp
 事前に \fBnormalizers/mysql\fP プラグインを登録する必要があります。
 .sp
@@ -23567,6 +23572,209 @@ select Words \-\-filter \(aq_key *T "Groonga is the successor project to Senna."
 このセクションでは関数についての説明と組み込みの関数について説明します。
 .sp
 TODO: Add documentations about function.
+.SS between
+.SS 概要
+.sp
+\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 構文
+.sp
+\fBbetween\fP には引数が5つあります。
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+between(column_or_value, min, min_border, max, max_border)
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS 使い方
+.sp
+Here are a schema definition and sample data to show usage.:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+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": "Alice",  "age": 12},
+{"_key": "Bob",    "age": 13},
+{"_key": "Calros", "age": 15},
+{"_key": "Dave",   "age": 16},
+{"_key": "Eric",   "age": 20}
+{"_key": "Frank",  "age": 21}
+]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+これはPG\-13 (MPAA)のレーティングに該当する人を示すクエリです。
+.sp
+実行例:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+select Users \-\-filter \(aqbetween(age, 13, "include", 16, "include")\(aq
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         3
+#       ],
+#       [
+#         [
+#           "_id",
+#           "UInt32"
+#         ],
+#         [
+#           "_key",
+#           "ShortText"
+#         ],
+#         [
+#           "age",
+#           "Int32"
+#         ]
+#       ],
+#       [
+#         2,
+#         "Bob",
+#         13
+#       ],
+#       [
+#         3,
+#         "Calros",
+#         15
+#       ],
+#       [
+#         4,
+#         "Dave",
+#         16
+#       ]
+#     ]
+#   ]
+# ]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+13から16歳までのユーザーを返します。
+.sp
+\fBbetween\fP 関数はテーブルのカラムだけでなく、値も受け付けます。
+.sp
+最初の引数に値を指定した場合、その値が含まれているか否かをチェックします。もし、指定した範囲にマッチしたら、( \fBbetween\fP 関数がtrueを返すので)すべてのレコードを返します。
+.sp
+もし、指定した範囲にマッチしなかった場合、( \fBbetween\fP 関数がfalseを返すので)1件もレコードを返しません。
+.sp
+実行例:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+select Users \-\-filter \(aqbetween(14, 13, "include", 16, "include")\(aq
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   [
+#     [
+#       [
+#         6
+#       ],
+#       [
+#         [
+#           "_id",
+#           "UInt32"
+#         ],
+#         [
+#           "_key",
+#           "ShortText"
+#         ],
+#         [
+#           "age",
+#           "Int32"
+#         ]
+#       ],
+#       [
+#         1,
+#         "Alice",
+#         12
+#       ],
+#       [
+#         2,
+#         "Bob",
+#         13
+#       ],
+#       [
+#         3,
+#         "Calros",
+#         15
+#       ],
+#       [
+#         4,
+#         "Dave",
+#         16
+#       ],
+#       [
+#         5,
+#         "Eric",
+#         20
+#       ],
+#       [
+#         6,
+#         "Frank",
+#         21
+#       ]
+#     ]
+#   ]
+# ]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+上記の例では、すべてのレコードを返します。これは、14は指定した範囲である13から16の間にあるからです。この振舞いは指定した値がテーブルに存在するかどうかの確認に使えます。
+.SS 引数
+.sp
+引数は5つあります。 \fBcolumn_or_value\fP と \fBmin\fP と \fBmin_border\fP と \fBmax\fP と \fBmax_border\fP です。
+.SS \fBcolumn_or_value\fP
+.sp
+テーブルのカラムもしくは値を指定します。
+.SS \fBmin\fP
+.sp
+範囲のうち最小値を指定します。値 \fBmin\fP が含まれるかどうかは \fBmin_border\fP 引数で制御することができます。
+.SS \fBmin_border\fP
+.sp
+\fBmin\fP の値を含めた範囲となるかどうかを指定します。 \fBmin_border\fP に指定できるのは "include" または "exclude" のどちらかです。
+"include" を指定すれば、\fBmin\fP が含まれます。 "exclude" を指定すれば \fBmin\fP は含まれません。
+.SS \fBmax\fP
+.sp
+範囲のうち最大値を指定します。値 \fBmax\fP が含まれるかどうかは \fBmax_border\fP 引数で制御することができます。
+.SS \fBmax_border\fP
+.sp
+\fBman\fP の値を含めた範囲となるかどうかを指定します。 \fBmax_border\fP に指定できるのは "include" または "exclude" のどちらかです。
+"include" を指定すれば、\fBmax\fP が含まれます。 "exclude" を指定すれば \fBmax\fP は含まれません。
+.SS 戻り値
+.sp
+\fBbetween\fP は指定した範囲にカラムの値が含まれるかを返します。もし該当するレコードがあれば、 \fBtrue\fP を返します。そうでなければ \fBfalse\fP を返します。
 .SS edit_distance
 .SS 名前
 .sp
@@ -25923,7 +26131,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
@@ -26009,7 +26217,7 @@ vm.max_map_count = 131072
 TODO
 .SS API
 .sp
-groongaを全文検索ライブラリとして使うことができます。この節ではgroongaが提供しているAPIを示します。
+Groongaを全文検索ライブラリとして使うことができます。この節ではGroongaが提供しているAPIを示します。
 .SS \fBgrn_cache\fP
 .SS 概要
 .sp
@@ -26186,6 +26394,146 @@ TODO...
 .SS リファレンス
 .INDENT 0.0
 .TP
+.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 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
+.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
@@ -26435,7 +26783,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
@@ -27280,7 +27628,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 パラメタ
@@ -28954,7 +29302,7 @@ select Shops \-\-filter \(aq"point > 3 && description @ \e"スープカレー\e"
 そのため、descriptionに「スープカレーライス」が含まれていても、「スープカレーライス」は「スープカレー」に完全一致しないのでヒットしません。
 .SH 制限事項
 .sp
-groongaにはいくつか制限事項があります。
+Groongaにはいくつか制限事項があります。
 .SS テーブルの制限
 .sp
 テーブルには以下の制限があります。
@@ -29262,15 +29610,15 @@ sudo sysctl \-w vm.max_map_count=65536 で一時的に vm.max_map_count を調
 チューニング関連のパラメータについては、 \fB/reference/tuning\fP のドキュメントを参照してください。
 .SH 開発
 .sp
-このセクションではgroongaを使った開発について説明します。例えば、groongaをデータベースとして使ったアプリケーション、libgroongaを使ったライブラリ、libgroongaの言語バインディングなどを開発することがあるでしょう。
+このセクションではGroongaを使った開発について説明します。例えば、Groongaをデータベースとして使ったアプリケーション、libgroongaを使ったライブラリ、libgroongaの言語バインディングなどを開発することがあるでしょう。
 .SS Travis CI
 .sp
-このセクションでは \fI\%Travis CI\fP 上でgroongaを使う方法について説明します。Travis CIはオープンソースコミュニティ用の継続的インテグレーション（CI）サービスです。
+このセクションでは \fI\%Travis CI\fP 上でGroongaを使う方法について説明します。Travis CIはオープンソースコミュニティ用の継続的インテグレーション（CI）サービスです。
 .sp
-オープンソースソフトウェアを開発しているならTravis CIを使えます。このセクションではgroonga関連の設定のみ説明します。Travis CI一般については \fI\%Travis CI: Documentation\fP を読んでください。
+オープンソースソフトウェアを開発しているならTravis CIを使えます。このセクションではGroonga関連の設定のみ説明します。Travis CI一般については \fI\%Travis CI: Documentation\fP を読んでください。
 .SS 設定
 .sp
-Travis CIは32\-bit版のUbuntu 11.10を使っています。（ \fI\%Travis CI: About Travis CI Environment\fP 参照。）Travis CIにgroongaをインストールするために、groongaプロジェクトが提供しているUbuntu 11.10用のapt\-lineを使えます。
+Travis CIは64\-bit版のUbuntu 12.04 LTS サーバ版を使っています。（ \fI\%Travis CI: About Travis CI Environment\fP 参照。）Travis CIにGroongaをインストールするために、Groongaプロジェクトが提供しているUbuntu 12.04 LTS用のapt\-lineを使えます。
 .sp
 \fB.travis.yml\fP でビルド方法を変更することができます。（ \fI\%Travis CI: Conifugration your Travis CI build with .travis.yml\fP 参照。） \fBbefore_install\fP フックまたは \fBinstall\fP フックを使います。もし、Travis CIがサポートしている言語（例えばRuby）を使ったソフトウェアの場合は \fBbefore_install\fP を使います。そうでない場合は \fBinstall\fP を使います。
 .sp
@@ -29289,10 +29637,10 @@ before_install:
 .sp
 \fBbefore_install\fP フックではなく \fBinstall\fP フックを使わなければいけない場合は、単に \fBbefore_install:\fP を \fBinstall:\fP に書き換えてください。
 .sp
-上記の設定でビルド中にgroongaを使えるようになります。
+上記の設定でビルド中にGroongaを使えるようになります。
 .SS 例
 .sp
-Travis CI上でgroongaを使っているオープンソースソフトウェアは以下の通りです
+Travis CI上でGroongaを使っているオープンソースソフトウェアは以下の通りです
 .INDENT 0.0
 .INDENT 3.5
 .INDENT 0.0
@@ -29325,14 +29673,14 @@ Travis CI上でgroongaを使っているオープンソースソフトウェア
 .UNINDENT
 .SH GROONGAへのコントリビュート方法
 .sp
-groongaプロジェクトではみなさんからのコントリビュートを歓迎します！コントリビュートの方法はいくつもあります。groongaを使ったり誰かに紹介することもコントリビュートですし、バグレポートを送ったり、groonga本体やgroonga関連の開発に参加することもコントリビュートです。プログラムではなく、ドキュメントでのコントリビュートも歓迎します！
+Groongaプロジェクトではみなさんからのコントリビュートを歓迎します！コントリビュートの方法はいくつもあります。Groongaを使ったり誰かに紹介することもコントリビュートですし、バグレポートを送ったり、Groonga本体やGroonga関連の開発に参加することもコントリビュートです。プログラムではなく、ドキュメントでのコントリビュートも歓迎します！
 .INDENT 0.0
 .TP
 .B ユーザーの立場で:
 このドキュメントを読んでください。
 .TP
 .B 布教する立場で:
-groongaについてまわりの人に話してください。
+Groongaについてまわりの人に話してください。
 .TP
 .B 開発者の立場で: 不具合報告や開発、ドキュメント
 これらについてはこのセクションで説明します。
@@ -29354,202 +29702,450 @@ groongaについてまわりの人に話してください。
 どちらのやり方でも大丈夫です。
 .SS 課題追跡システムへ登録する
 .sp
-groonga用の課題追跡システム（ITS, Issue Tracking System）が2つあります。1つは \fI\%Redmine\fP でもう1つは \fI\%GitHub issue tracker\fP です。Redmineは日本語で、GitHub issue trackerは英語を使っています。どちらにバグレポートをしても大丈夫です。
+Groonga用の課題追跡システム（ITS, Issue Tracking System）が2つあります。1つは \fI\%Redmine\fP でもう1つは \fI\%GitHub issue tracker\fP です。Redmineは日本語で、GitHub issue trackerは英語を使っています。どちらにバグレポートをしても大丈夫です。
 .SS メーリングリストへ報告する
 .sp
-groongaプロジェクトではgroongaについて議論するための \fB/community\fP があります。バグを説明したメールを送ってください。
-.SS groonga開発者向け情報
-.SS リポジトリ
-.sp
-groongaのリポジトリは \fI\%GitHub\fP 上にあります。次のコマンドでcloneできます。
-.INDENT 0.0
-.INDENT 3.5
+GroongaプロジェクトではGroongaについて議論するための \fB/community\fP があります。バグを説明したメールを送ってください。
+.SS ドキュメント関連のコントリビュート方法
 .sp
-.nf
-.ft C
-% git clone git://github.com/groonga/groonga.git
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
+ドキュメントツールとして \fI\%Sphinx\fP を使います。
+.SS C API
 .sp
-\fI\%groonga関係のプロジェクト（grntest, fluent\-plugin\-groongaなど）\fP のリストはリンク先をごらんください。
-.SS groonga 通信アーキテクチャ
-.SS gqtpでのアーキテクチャ
-.INDENT 0.0
-.IP \(bu 2
-comが外部からの接続を受け付ける。
-.IP \(bu 2
-comは1スレッド。
-.IP \(bu 2
-comがedgeを作る。
-.IP \(bu 2
-edgeは接続と１対１対応。
-.IP \(bu 2
-edgeはctxを含む。
-.IP \(bu 2
-workerはthreadと１対１対応。
-.IP \(bu 2
-workerは上限が個定数。
-.IP \(bu 2
-workerは、１つのedgeと結びつくことができる。
-.IP \(bu 2
-edgeごとにqueueを持つ。
-.IP \(bu 2
-msgはcomによって、edgeのqueueにenqueueされる。
-edgeがworkerに結びついていないときは、同時に、ctx_newというqueueに、msgをenqueueした対象のedgeをenqueueする。
-.UNINDENT
-.SS ユーザーと協力して開発をうまく進めていくための指針
+今のところ、C APIのドキュメントはinclude/groonga.hにありますが、これをdoc/source/c\-api/*.txtに移動したいと思っています。C APIのドキュメントを移動して、パッチを送ってくれるととても喜びます。
 .sp
-groongaを使ってくれているユーザーと協力して
-開発をうまく進めていくためにこうするといい、という事柄をまとめました。
-まとめておくと、新しく開発に加わる人とも共有することができます。
-.SS twitter編
+Sphinxの \fI\%the C domain markup\fP を使う予定です。
+.SS 国際化
 .sp
-groongaを使ってもらえるようにtwitterのアカウントgroongaを取得して
-日々、リリースの案内をしたり、ユーザーサポートをしたりしています。
+今のところ、Groongaには日本語でのドキュメントしかありません。1.2.2からgettextベースの \fI\%Sphinx I18N feature\fP を使ってドキュメントの国際化対応を始めました。この仕組みではベースの言語として英語を使い、日本語などの他の言語には英語からその言語に翻訳します。すべてのドキュメントはdoc/source/以下において、それをSphinxで処理します。
 .sp
-リリースの案内に利用する場合には、やりとりを考えなくて良いですが、
-複数人によるサポートをgroongaで行う場合に、どうサポートするのが
-良いのか/どうしてそうするのかという共通認識を持っていないと一貫性のないサポートとなってしま
-います。
+しかし、今のところ、doc/source/では日本語を使っています。そのため、まずは、doc/source/以下にある日本語のドキュメントを英語に翻訳する必要があります。ドキュメントを翻訳して、パッチを送ってくれるととても喜びます。
+.SS 翻訳の流れ
 .sp
-twitterでサポートされている安心感からgroongaユーザーの拡大に繋げる
-ことができるようにサポートの際に気をつけることをまとめます。
-.SS 過去のツイートはおさらいしておく
-.SS 理由
+doc/source/*.txtを更新したら、翻訳を始めます。
 .sp
-自分がツイートした内容を把握していない返信をされたら普通いい気はしません。
-.SS 対応
+これが翻訳の流れです:
+.INDENT 0.0
+.IP 1. 3
+Groongaのリポジトリをcloneします。
+.IP 2. 3
+.poファイルを更新します。
+.IP 3. 3
+.poファイルを編集します。
+.IP 4. 3
+HTMLファイルを生成します。
+.IP 5. 3
+HTMLの出力を確認します。
+.IP 6. 3
+翻訳が完了するまで、2.\-4.を繰り返します。
+.IP 7. 3
+翻訳作業の成果をGroongaプロジェクトに送ってください！
+.UNINDENT
 .sp
-過去のツイートをおさらいし、こうすれば良いという提案をできるのが望ましいです。:
+上記の流れを実行するコマンドラインです。詳細は以降のセクションで説明します。
 .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
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
-.SS こちらから情報を提供する
-.SS 理由
-.sp
-困っているユーザーが複数回ツイートして限られたなかで情報を提供してくれていることがあります。
-その限られたツイートから解決方法が見つかればユーザーにとって余計な手間が少なくて済みます。
-あれこれ情報提供を要求すると、ユーザーはそのぶん確認する作業が必要になります。
-.SS 対応
+.SS Groongaリポジトリのcloneの仕方
 .sp
-最初に声をかけるときに解決策を1つか2つ提案できると望ましいです。ユーザーにあまり負担を感じさせないようにすると良いです。:
+はじめに、GitHub上のGroongaリポジトリをforkしてください。 \fI\%https://github.com/groonga/groonga\fP にアクセスして \fIFork\fP ボタンを押すだけです。これで自分のGroongaリポジトリをcloneすることができます。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-良い例: ○○の場合は□□の可能性があるので、××を試してもらえますか？
+% git clone https://github.com/${YOUR_GITHUB_ACCOUNT}/groonga.git
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
-.SS twitterでのやりとりはできるだけ他の場所(例えばredmine)へと誘導しない
-.SS 理由
-.sp
-twitterは気軽につぶやけることが重要なので、気軽にできないことを相手に要求すると萎縮されてしまう可能性があります。
 .sp
-いきなりredmineでバグ報告をお願いすると、しりごみしてしまうかも知れません。:
+cloneした後はconfigureする必要があります。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-駄目な例: 再現手順をMLかredmineに報告してもらえますか?
+% cd groonga
+% ./autogen.sh
+% ./configure
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-groonga関連で気軽につぶやけないとなると開発者は困っている人を見つけられないし、利用者は困ったままとなるので、双方にとって嬉しくない状態になっ
-てしまいます。
-.SS 対応
+この作業は初回セットアップ時のみだけの作業です。
 .sp
-twitterでやりとりを完結できるようにします。
-.SS ドキュメント作成
-.SS Sphinxのインストール
+以上の作業で問題があった場合は、 \fI\%http://packages.groonga.org/source/groonga/\fP にあるソースファイルを利用してもよいです。
+.SS .poファイルの更新の仕方
 .sp
-groongaのドキュメントは、Sphinxというツールを用いて作成されています。Sphinxは以下のように導入します。:
+doc/locale/${LANGUAGE}/LC_MESSAGESディレクトリで \fImake update\fP を実行すると.poファイルを更新できます。（\fI${LANGUAGE}\fP は\(aqja\(aqなど自分の言語の言語コードに置き換えてください。）:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-# aptitude install python\-setuptools
-# easy_install \-U sphinx
+% cd doc/locale/ja/LC_MESSAGES
+% make update
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
-.SS htmlの作成
+.SS .poの編集の仕方
 .sp
-以下のコマンドでhtmlが作成されます。:
+.poファイルを編集するためのツールがあります。.poファイルは単なるテキストなので好きなエディタで編集できます。以下は.poファイルの編集に特化したエディタのリストです。
+.INDENT 0.0
+.TP
+.B Emacs\(aqs \fI\%po\-mode\fP
+gettextに同梱されています。
+.TP
+.B \fI\%Poedit\fP
+.po専用エディタです。たくさんのプラットフォームで動作します。
+.TP
+.B gted
+これも.po専用エディタです。Eclipseプラグインとして実装されています。
+.UNINDENT
+.SS HTMLファイルの生成方法
+.sp
+doc/locale/${LANGUAGE}ディレクトリで \fImake html\fP を実行すると更新した.poファイルを使ってHTMLファイルを生成できます。（\fI${LANGUAGE}\fP は\(aqja\(aqなど自分の言語の言語コードに置き換えてください。）:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
+% cd doc/locale/ja/
 % make html
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-このドキュメントはソースアーカイブの形式で配布され、随時更新しています。最新のドキュメントをソース形式で参照したいなら、GitHubのリポジトリブラウザ経由で閲覧できます。(\fI\%https://github.com/groonga/groonga/tree/master/doc/source\fP)
-.SS pdfの作成
-.sp
-groongaのドキュメントは、pdf出力することもできます。rst2pdfと、IPAフォント(IPA Gothic/IPAexGothic)が必要となります。
-.SS rst2pdfのインストール
-.sp
-以下のようにしてインストールできます。:
+全ての言語のHTMLファイルを生成するにはdoc/locale/ディレクトリで \fImake html\fP を実行します。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-# easy_install rst2pdf
+% cd doc/locale
+% make html
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
-.SS pdfの作成
 .sp
-以下のコマンドでpdfが作成されます。:
+\fBノート:\fP
+.INDENT 0.0
+.INDENT 3.5
+.moファイルは \fImake html\fP で自動的に更新されるので、.moファイルのことを気にする必要はありません。
+.UNINDENT
+.UNINDENT
+.SS HTML出力の確認の仕方
+.sp
+HTMLファイルはdoc/locale/${LANGUAGE}/html/以下に出力されます。（\fI${LANGUAGE}\fP は\(aqja\(aqなど自分の言語の言語コードに置き換えてください。）好きなブラウザで出力されたHTMLを確認してください。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-% make pdf
+% firefox doc/locale/ja/html/index.html
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
-.SS クエリの実現
+.SS 翻訳の成果の送り方
 .sp
-groongaのデータベースには大量のデータを格納し、その中から必要な部分を高速に取り出すことができます。必要な部分をgroongaのデータベースに問い合わせるためのクエリの表現と実行に関して、groongaは複数の手段を用意しています。
-.SS クエリ実行のためのインタフェース
+翻訳の成果はGitHubのpull requestかメールで送ってください。メールで送る場合はパッチでも.poファイルそのものでも構いません。
+.SS pull requestの送り方
+.sp
+pull requestを送るためのコマンドライン:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% git add doc/locale/ja/LC_MESSAGES/*.po
+% git commit
+% git push
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+これでGitHub上でpull requestを送る準備ができました。あとは、GitHub上の自分のリポジトリのページへアクセスして \fIPull Request\fP ボタンを押すだけです。
+.sp
+\fB参考:\fP
+.INDENT 0.0
+.INDENT 3.5
+pull requestの送り方
+.UNINDENT
+.UNINDENT
+.SS パッチの送り方
+.sp
+パッチを作るためのコマンドライン
+.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
+カレントディレクトリに000X\-YYY.patchという名前のファイルができていると思います。これをGroongaプロジェクトに送ってください！
+.sp
+\fB参考:\fP
+.INDENT 0.0
+.INDENT 3.5
+\fB/community\fP に連絡先の情報があります。
+.UNINDENT
+.UNINDENT
+.SS .poファイルの送り方
+.sp
+doc/locale/${LANGUAGE}/LC_MESSAGES/以下を.tar.gzや.zipなどでアーカイブにしてGroongaプロジェクトに送ってください！（\fI${LANGUAGE}\fP は\(aqja\(aqなど自分の言語の言語コードに置き換えてください。）こちらでアーカイブの中の内容をマージします。
+.sp
+\fB参考:\fP
+.INDENT 0.0
+.INDENT 3.5
+\fB/community\fP に連絡先の情報があります。
+.UNINDENT
+.UNINDENT
+.SS 新しい言語の追加方法
+.sp
+新しい翻訳対象の言語を追加するコマンドライン:
+.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.
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+\fI${LANGUAGE}\fP は\(aqja\(aqなどの自分の言語の言語コードに置き換えてください。
+.sp
+\fB参考:\fP
+.INDENT 0.0
+.INDENT 3.5
+言語名を表記するためのコード
+.UNINDENT
+.UNINDENT
+.SS groonga開発者向け情報
+.SS リポジトリ
+.sp
+Groongaのリポジトリは \fI\%GitHub\fP 上にあります。次のコマンドでcloneできます。
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% git clone git://github.com/groonga/groonga.git
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+\fI\%Groonga関係のプロジェクト（grntest, fluent\-plugin\-groongaなど）\fP のリストはリンク先をごらんください。
+.SS Groonga 通信アーキテクチャ
+.SS GQTPでのアーキテクチャ
+.INDENT 0.0
+.IP \(bu 2
+comが外部からの接続を受け付ける。
+.IP \(bu 2
+comは1スレッド。
+.IP \(bu 2
+comがedgeを作る。
+.IP \(bu 2
+edgeは接続と１対１対応。
+.IP \(bu 2
+edgeはctxを含む。
+.IP \(bu 2
+workerはthreadと１対１対応。
+.IP \(bu 2
+workerは上限が個定数。
+.IP \(bu 2
+workerは、１つのedgeと結びつくことができる。
+.IP \(bu 2
+edgeごとにqueueを持つ。
+.IP \(bu 2
+msgはcomによって、edgeのqueueにenqueueされる。
+edgeがworkerに結びついていないときは、同時に、ctx_newというqueueに、msgをenqueueした対象のedgeをenqueueする。
+.UNINDENT
+.SS ユーザーと協力して開発をうまく進めていくための指針
+.sp
+Groongaを使ってくれているユーザーと協力して
+開発をうまく進めていくためにこうするといい、という事柄をまとめました。
+まとめておくと、新しく開発に加わる人とも共有することができます。
+.SS twitter編
+.sp
+Groongaを使ってもらえるようにtwitterのアカウントGroongaを取得して
+日々、リリースの案内をしたり、ユーザーサポートをしたりしています。
+.sp
+リリースの案内に利用する場合には、やりとりを考えなくて良いですが、
+複数人によるサポートをGroongaで行う場合に、どうサポートするのが
+良いのか/どうしてそうするのかという共通認識を持っていないと一貫性のないサポートとなってしま
+います。
+.sp
+twitterでサポートされている安心感からGroongaユーザーの拡大に繋げる
+ことができるようにサポートの際に気をつけることをまとめます。
+.SS 過去のツイートはおさらいしておく
+.SS 理由
+.sp
+自分がツイートした内容を把握していない返信をされたら普通いい気はしません。
+.SS 対応
+.sp
+過去のツイートをおさらいし、こうすれば良いという提案をできるのが望ましいです。:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+良い例: ○○だと原因は□□ですね。××すると大丈夫です。
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS こちらから情報を提供する
+.SS 理由
+.sp
+困っているユーザーが複数回ツイートして限られたなかで情報を提供してくれていることがあります。
+その限られたツイートから解決方法が見つかればユーザーにとって余計な手間が少なくて済みます。
+あれこれ情報提供を要求すると、ユーザーはそのぶん確認する作業が必要になります。
+.SS 対応
+.sp
+最初に声をかけるときに解決策を1つか2つ提案できると望ましいです。ユーザーにあまり負担を感じさせないようにすると良いです。:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+良い例: ○○の場合は□□の可能性があるので、××を試してもらえますか？
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS twitterでのやりとりはできるだけ他の場所(例えばredmine)へと誘導しない
+.SS 理由
+.sp
+twitterは気軽につぶやけることが重要なので、気軽にできないことを相手に要求すると萎縮されてしまう可能性があります。
+.sp
+いきなりredmineでバグ報告をお願いすると、しりごみしてしまうかも知れません。:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+駄目な例: 再現手順をMLかredmineに報告してもらえますか?
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Groonga関連で気軽につぶやけないとなると開発者は困っている人を見つけられないし、利用者は困ったままとなるので、双方にとって嬉しくない状態になっ
+てしまいます。
+.SS 対応
+.sp
+twitterでやりとりを完結できるようにします。
+.SS ドキュメント作成
+.SS Sphinxのインストール
+.sp
+Groongaのドキュメントは、Sphinxというツールを用いて作成されています。Sphinxは以下のように導入します。:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+# aptitude install python\-setuptools
+# easy_install \-U sphinx
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS htmlの作成
+.sp
+以下のコマンドでhtmlが作成されます。:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% make html
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+このドキュメントはソースアーカイブの形式で配布され、随時更新しています。最新のドキュメントをソース形式で参照したいなら、GitHubのリポジトリブラウザ経由で閲覧できます。(\fI\%https://github.com/groonga/groonga/tree/master/doc/source\fP)
+.SS pdfの作成
+.sp
+Groongaのドキュメントは、pdf出力することもできます。rst2pdfと、IPAフォント(IPA Gothic/IPAexGothic)が必要となります。
+.SS rst2pdfのインストール
+.sp
+以下のようにしてインストールできます。:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+# easy_install rst2pdf
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS pdfの作成
+.sp
+以下のコマンドでpdfが作成されます。:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% make pdf
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS クエリの実現
+.sp
+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のことを特に条件式とよびます。条件式を構成する個々の要素を関係式と呼びます。条件式は一個以上の関係式か、あるいは条件式を論理演算子で結合したものです。
@@ -29787,7 +30383,7 @@ CUTTER_SOURCE_PATH=$HOME/work/cutter/cutter
 .UNINDENT
 .SS ビルド環境の準備
 .sp
-以下にgroongaのリリース作業を行うために事前にインストール
+以下にGroongaのリリース作業を行うために事前にインストール
 しておくべきパッケージを示します。
 .sp
 なお、ビルド環境としては Ubuntu 12.04 LTS(Precise Pangolin)を前提として説明しているため、その他の環境では適宜読み替えて下さい。:
@@ -29832,7 +30428,7 @@ rinseのバージョンが古いとCentOS 5/6パッケージのビルドを行
 リリース作業ではRPMパッケージに対する署名を行います。
 その際、パッケージ署名用の鍵が必要です。
 .sp
-groongaプロジェクトでは署名用の鍵をリリース担当者の公開鍵で暗号化してリポジトリのpackages/ディレクトリ以下へと登録しています。
+Groongaプロジェクトでは署名用の鍵をリリース担当者の公開鍵で暗号化してリポジトリのpackages/ディレクトリ以下へと登録しています。
 .sp
 リリース担当者はリポジトリに登録された秘密鍵を復号した後に鍵のインポートを以下のコマンドにて行います。:
 .INDENT 0.0
@@ -29849,7 +30445,7 @@ groongaプロジェクトでは署名用の鍵をリリース担当者の公開
 .UNINDENT
 .UNINDENT
 .sp
-鍵のインポートが正常終了すると gpg \-\-list\-keys でgroongaの署名用の鍵を確認することができます。:
+鍵のインポートが正常終了すると gpg \-\-list\-keys でGroongaの署名用の鍵を確認することができます。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -29885,7 +30481,7 @@ gpg> quit
 この作業は、新規にリリースを行うことになった担当者やパッケージに署名する鍵に変更があった場合などに行います。
 .SS リリース作業用ディレクトリの作成
 .sp
-groongaのリリース作業ではリリース専用の環境下(コンパイルフラグ)でビルドする必要があります。
+Groongaのリリース作業ではリリース専用の環境下(コンパイルフラグ)でビルドする必要があります。
 .sp
 リリース時と開発時でディレクトリを分けずに作業することもできますが、誤ったコンパイルフラグでリリースしてしまう危険があります。
 .sp
@@ -29936,13 +30532,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
@@ -29957,7 +30553,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
@@ -29974,7 +30570,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
@@ -30005,11 +30601,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
@@ -30050,7 +30646,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
 ロケールメッセージの更新や変更されたファイルのリスト等を更新するために以下のコマンドを実行します。:
@@ -30183,7 +30779,7 @@ rpmパッケージのビルドに必要なパッケージをダウンロード
 .UNINDENT
 .UNINDENT
 .sp
-これにより、groongaやMySQLのRPM/SRPMパッケージなどがカレントディレクトリ以下へとダウンロードされます。
+これにより、GroongaやMySQLのRPM/SRPMパッケージなどがカレントディレクトリ以下へとダウンロードされます。
 .sp
 windowsパッケージのビルドに必要なパッケージをダウンロードするには以下のコマンドを実行します。:
 .INDENT 0.0
@@ -30198,7 +30794,7 @@ windowsパッケージのビルドに必要なパッケージをダウンロー
 .UNINDENT
 .UNINDENT
 .sp
-これにより、groongaのインストーラやzipアーカイブがカレントディレクトリ以下へとダウンロードされます。
+これにより、Groongaのインストーラやzipアーカイブがカレントディレクトリ以下へとダウンロードされます。
 .sp
 sourceパッケージに必要なものをダウンロードするには以下のコマンドを実行します。:
 .INDENT 0.0
@@ -30217,7 +30813,7 @@ sourceパッケージに必要なものをダウンロードするには以下
 packages/source/filesディレクトリ以下へとダウンロードされます。
 .SS Debian系パッケージのビルド
 .sp
-groongaのpackages/aptサブディレクトリに移動して、以下のコマンドを実行します。:
+Groongaのpackages/aptサブディレクトリに移動して、以下のコマンドを実行します。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -30294,7 +30890,7 @@ make build ではまとめてビルドできないこともあります。
 .UNINDENT
 .SS Red Hat系パッケージのビルド
 .sp
-groongaのpackages/yumサブディレクトリに移動して、以下のコマンドを実行します。:
+Groongaのpackages/yumサブディレクトリに移動して、以下のコマンドを実行します。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -30403,9 +30999,9 @@ Debian系もしくはRed Hat系の場合には本番環境へとアップロー
 .UNINDENT
 .SS grntestの準備
 .sp
-grntestを実行するためにはgroongaのテストデータとgrntestのソースが必要です。
+grntestを実行するためにはGroongaのテストデータとgrntestのソースが必要です。
 .sp
-まずgroongaのソースを任意のディレクトリへと展開します。:
+まずGroongaのソースを任意のディレクトリへと展開します。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -30417,7 +31013,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
@@ -30432,7 +31028,7 @@ README.md  binlib  license  test
 .UNINDENT
 .SS grntestの実行方法
 .sp
-grntestではgroongaコマンドを明示的にしていすることができます。
+grntestではGroongaコマンドを明示的にしていすることができます。
 後述のパッケージごとのgrntestによる動作確認では以下のようにして実行します。:
 .INDENT 0.0
 .INDENT 3.5
@@ -30509,7 +31105,7 @@ grntestの正常終了を確認する
 zipアーカイブも同様にしてgrntestを実行し動作確認を行います。
 .SS リリースアナウンスの作成
 .sp
-リリースの際にはリリースアナウンスを流して、groongaを広く通知します。
+リリースの際にはリリースアナウンスを流して、Groongaを広く通知します。
 .sp
 news.txtに変更点をまとめましたが、それを元にリリースアナウンスを作成します。
 .sp
@@ -30525,14 +31121,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
@@ -30542,7 +31138,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
@@ -30693,16 +31289,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
@@ -30721,7 +31317,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
@@ -30759,14 +31355,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
@@ -30851,7 +31447,7 @@ centosの場合、CENTOS_VERSIONSを指定することで特定のバージョ
 .SS テスト環境の構築
 .SS Cutterのインストール
 .sp
-groongaは、テストのフレームワークとして \fI\%Cutter\fP を用いています。
+Groongaは、テストのフレームワークとして \fI\%Cutter\fP を用いています。
 .sp
 Cutterのインストール方法は \fI\%プラットフォーム毎のCutterのインストール方法\fP をご覧下さい。
 .SS lcovのインストール
@@ -30895,7 +31491,7 @@ memcachedのバイナリプロトコルのテストを動作させるために
 .UNINDENT
 .SS テストの動作
 .sp
-groongaのトップディレクトリで、以下のコマンドを実行します。:
+Groongaのトップディレクトリで、以下のコマンドを実行します。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -30908,7 +31504,7 @@ make check
 .UNINDENT
 .SS カバレッジ情報
 .sp
-groongaのトップディレクトリで、以下のコマンドを実行します。:
+Groongaのトップディレクトリで、以下のコマンドを実行します。:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -31009,254 +31605,6 @@ scan\-buildを用いて、ソースコードの静的解析を行うことがで
 .UNINDENT
 .sp
 configureは１度のみ実行する必要があります。
-.SS ドキュメント関連のコントリビュート方法
-.sp
-ドキュメントツールとして \fI\%Sphinx\fP を使います。
-.SS C API
-.sp
-今のところ、C APIのドキュメントはinclude/groonga.hにありますが、これをdoc/source/c\-api/*.txtに移動したいと思っています。C APIのドキュメントを移動して、パッチを送ってくれるととても喜びます。
-.sp
-Sphinxの \fI\%the C domain markup\fP を使う予定です。
-.SS 国際化
-.sp
-今のところ、groongaには日本語でのドキュメントしかありません。1.2.2からgettextベースの \fI\%Sphinx I18N feature\fP を使ってドキュメントの国際化対応を始めました。この仕組みではベースの言語として英語を使い、日本語などの他の言語には英語からその言語に翻訳します。すべてのドキュメントはdoc/source/以下において、それをSphinxで処理します。
-.sp
-しかし、今のところ、doc/source/では日本語を使っています。そのため、まずは、doc/source/以下にある日本語のドキュメントを英語に翻訳する必要があります。ドキュメントを翻訳して、パッチを送ってくれるととても喜びます。
-.SS 翻訳の流れ
-.sp
-doc/source/*.txtを更新したら、翻訳を始めます。
-.sp
-これが翻訳の流れです:
-.INDENT 0.0
-.IP 1. 3
-groongaのリポジトリをcloneします。
-.IP 2. 3
-.poファイルを更新します。
-.IP 3. 3
-.poファイルを編集します。
-.IP 4. 3
-HTMLファイルを生成します。
-.IP 5. 3
-HTMLの出力を確認します。
-.IP 6. 3
-翻訳が完了するまで、2.\-4.を繰り返します。
-.IP 7. 3
-翻訳作業の成果をgroongaプロジェクトに送ってください！
-.UNINDENT
-.sp
-上記の流れを実行するコマンドラインです。詳細は以降のセクションで説明します。
-.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
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.SS groongaリポジトリのcloneの仕方
-.sp
-はじめに、GitHub上のgroongaリポジトリをforkしてください。 \fI\%https://github.com/groonga/groonga\fP にアクセスして \fIFork\fP ボタンを押すだけです。これで自分のgroongaリポジトリをcloneすることができます。:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% git clone https://github.com/${YOUR_GITHUB_ACCOUNT}/groonga.git
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-cloneした後はconfigureする必要があります。:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% cd groonga
-% ./autogen.sh
-% ./configure
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-この作業は初回セットアップ時のみだけの作業です。
-.sp
-以上の作業で問題があった場合は、 \fI\%http://packages.groonga.org/source/groonga/\fP にあるソースファイルを利用してもよいです。
-.SS .poファイルの更新の仕方
-.sp
-doc/locale/${LANGUAGE}/LC_MESSAGESディレクトリで \fImake update\fP を実行すると.poファイルを更新できます。（\fI${LANGUAGE}\fP は\(aqja\(aqなど自分の言語の言語コードに置き換えてください。）:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% cd doc/locale/ja/LC_MESSAGES
-% make update
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.SS .poの編集の仕方
-.sp
-.poファイルを編集するためのツールがあります。.poファイルは単なるテキストなので好きなエディタで編集できます。以下は.poファイルの編集に特化したエディタのリストです。
-.INDENT 0.0
-.TP
-.B Emacs\(aqs \fI\%po\-mode\fP
-gettextに同梱されています。
-.TP
-.B \fI\%Poedit\fP
-.po専用エディタです。たくさんのプラットフォームで動作します。
-.TP
-.B gted
-これも.po専用エディタです。Eclipseプラグインとして実装されています。
-.UNINDENT
-.SS HTMLファイルの生成方法
-.sp
-doc/locale/${LANGUAGE}ディレクトリで \fImake html\fP を実行すると更新した.poファイルを使ってHTMLファイルを生成できます。（\fI${LANGUAGE}\fP は\(aqja\(aqなど自分の言語の言語コードに置き換えてください。）:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% cd doc/locale/ja/
-% make html
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-全ての言語のHTMLファイルを生成するにはdoc/locale/ディレクトリで \fImake html\fP を実行します。:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% cd doc/locale
-% make html
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-\fBノート:\fP
-.INDENT 0.0
-.INDENT 3.5
-.moファイルは \fImake html\fP で自動的に更新されるので、.moファイルのことを気にする必要はありません。
-.UNINDENT
-.UNINDENT
-.SS HTML出力の確認の仕方
-.sp
-HTMLファイルはdoc/locale/${LANGUAGE}/html/以下に出力されます。（\fI${LANGUAGE}\fP は\(aqja\(aqなど自分の言語の言語コードに置き換えてください。）好きなブラウザで出力されたHTMLを確認してください。:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% firefox doc/locale/ja/html/index.html
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.SS 翻訳の成果の送り方
-.sp
-翻訳の成果はGitHubのpull requestかメールで送ってください。メールで送る場合はパッチでも.poファイルそのものでも構いません。
-.SS pull requestの送り方
-.sp
-pull requestを送るためのコマンドライン:
-.INDENT 0.0
-.INDENT 3.5
-.sp
-.nf
-.ft C
-% git add doc/locale/ja/LC_MESSAGES/*.po
-% git commit
-% git push
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-これでGitHub上でpull requestを送る準備ができました。あとは、GitHub上の自分のリポジトリのページへアクセスして \fIPull Request\fP ボタンを押すだけです。
-.sp
-\fB参考:\fP
-.INDENT 0.0
-.INDENT 3.5
-pull requestの送り方
-.UNINDENT
-.UNINDENT
-.SS パッチの送り方
-.sp
-パッチを作るためのコマンドライン
-.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
-カレントディレクトリに000X\-YYY.patchという名前のファイルができていると思います。これをgroongaプロジェクトに送ってください！
-.sp
-\fB参考:\fP
-.INDENT 0.0
-.INDENT 3.5
-\fB/community\fP に連絡先の情報があります。
-.UNINDENT
-.UNINDENT
-.SS .poファイルの送り方
-.sp
-doc/locale/${LANGUAGE}/LC_MESSAGES/以下を.tar.gzや.zipなどでアーカイブにしてgroongaプロジェクトに送ってください！（\fI${LANGUAGE}\fP は\(aqja\(aqなど自分の言語の言語コードに置き換えてください。）こちらでアーカイブの中の内容をマージします。
-.sp
-\fB参考:\fP
-.INDENT 0.0
-.INDENT 3.5
-\fB/community\fP に連絡先の情報があります。
-.UNINDENT
-.UNINDENT
-.SS 新しい言語の追加方法
-.sp
-新しい翻訳対象の言語を追加するコマンドライン:
-.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.
-.ft P
-.fi
-.UNINDENT
-.UNINDENT
-.sp
-\fI${LANGUAGE}\fP は\(aqja\(aqなどの自分の言語の言語コードに置き換えてください。
-.sp
-\fB参考:\fP
-.INDENT 0.0
-.INDENT 3.5
-言語名を表記するためのコード
-.UNINDENT
-.UNINDENT
 .INDENT 0.0
 .IP \(bu 2
 \fIgenindex\fP