RubyGems - rroonga - Versions diffs - 3.0.8-x86-mingw32 → 3.0.9-x86-mingw32 - Mend

rroonga 3.0.8-x86-mingw32 → 3.0.9-x86-mingw32

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

Files changed (449) hide show

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

@@ -7,7 +7,7 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>4.8. パトリシア木による前方一致検索 &mdash; groonga v3.0.8ドキュメント</title>
+    <title>4.8. パトリシア木による前方一致検索 &mdash; Groonga v3.0.9ドキュメント</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.0.8',
+        VERSION:     '3.0.9',
         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.0.8ドキュメント" href="../index.html" />
+    <link rel="top" title="Groonga v3.0.9ドキュメント" 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.0.8ドキュメント</a> &raquo;</li>
+        <li><a href="../index.html">Groonga v3.0.9ドキュメント</a> &raquo;</li>
           <li><a href="../tutorial.html" accesskey="U">4. チュートリアル</a> &raquo;</li>
       </ul>
     </div>
@@ -259,7 +259,7 @@ select --table PatSuffix --filter &#39;_key @$ &quot;ゆき&quot; &amp;&amp; ori
   <h3>このページ</h3>
   <ul class="this-page-menu">
     <li><a href="../_sources/tutorial/patricia_trie.txt"
-           rel="nofollow">ソースコードを表示(英語)</a></li>
+           rel="nofollow">ソースコードを表示</a></li>
   </ul>
 <div id="searchbox" style="display: none">
   <h3>クイック検索</h3>
@@ -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.0.8ドキュメント</a> &raquo;</li>
+        <li><a href="../index.html">Groonga v3.0.9ドキュメント</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

@@ -7,7 +7,7 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>4.11. クエリ拡張 &mdash; groonga v3.0.8ドキュメント</title>
+    <title>4.11. クエリ拡張 &mdash; Groonga v3.0.9ドキュメント</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.0.8',
+        VERSION:     '3.0.9',
         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.0.8ドキュメント" href="../index.html" />
+    <link rel="top" title="Groonga v3.0.9ドキュメント" 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.0.8ドキュメント</a> &raquo;</li>
+        <li><a href="../index.html">Groonga v3.0.9ドキュメント</a> &raquo;</li>
           <li><a href="../tutorial.html" accesskey="U">4. チュートリアル</a> &raquo;</li>
       </ul>
     </div>
@@ -293,7 +293,7 @@ select Doc --match_columns body --query &quot;シークヮーサー&quot; --quer
   <h3>このページ</h3>
   <ul class="this-page-menu">
     <li><a href="../_sources/tutorial/query_expansion.txt"
-           rel="nofollow">ソースコードを表示(英語)</a></li>
+           rel="nofollow">ソースコードを表示</a></li>
   </ul>
 <div id="searchbox" style="display: none">
   <h3>クイック検索</h3>
@@ -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.0.8ドキュメント</a> &raquo;</li>
+        <li><a href="../index.html">Groonga v3.0.9ドキュメント</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

@@ -7,7 +7,7 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>4.4. さまざまな検索条件の指定 &mdash; groonga v3.0.8ドキュメント</title>
+    <title>4.4. さまざまな検索条件の指定 &mdash; Groonga v3.0.9ドキュメント</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.0.8',
+        VERSION:     '3.0.9',
         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.0.8ドキュメント" href="../index.html" />
+    <link rel="top" title="Groonga v3.0.9ドキュメント" 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.0.8ドキュメント</a> &raquo;</li>
+        <li><a href="../index.html">Groonga v3.0.9ドキュメント</a> &raquo;</li>
           <li><a href="../tutorial.html" accesskey="U">4. チュートリアル</a> &raquo;</li>
       </ul>
     </div>
@@ -577,7 +577,7 @@ select --table Site --query &quot;_id:1 OR _id:2&quot; --output_columns _key,loc
   <h3>このページ</h3>
   <ul class="this-page-menu">
     <li><a href="../_sources/tutorial/search.txt"
-           rel="nofollow">ソースコードを表示(英語)</a></li>
+           rel="nofollow">ソースコードを表示</a></li>
   </ul>
 <div id="searchbox" style="display: none">
   <h3>クイック検索</h3>
@@ -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.0.8ドキュメント</a> &raquo;</li>
+        <li><a href="../index.html">Groonga v3.0.9ドキュメント</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

File without changes

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

File without changes

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

File without changes

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

File without changes

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

File without changes

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

File without changes

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

File without changes

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

File without changes

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

@@ -1,4 +1,4 @@
-.TH "GROONGA" "1" "2013 年 09 月 27 日" "3.0.8" "groonga"
+.TH "GROONGA" "1" "2013 年 10 月 28 日" "3.0.9" "groonga"
 .SH NAME
 groonga \- groongaのドキュメント
 .
@@ -34,13 +34,6 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .IP \(bu 2
 \fBnews\fP
 .UNINDENT
-.sp
-\fBノート:\fP
-.INDENT 0.0
-.INDENT 3.5
-このドキュメントはソースアーカイブの形式で配布され、随時更新しています。最新のドキュメントをソース形式で参照したいなら、GitHubのリポジトリブラウザ経由で閲覧できます。(\fI\%https://github.com/groonga/groonga/tree/master/doc/source\fP)
-.UNINDENT
-.UNINDENT
 .SH GROONGAの特徴
 .SS groonga の概要
 .sp
@@ -109,7 +102,7 @@ groonga は独自のカラムストアを持つ列指向のデータベースと
 .sp
 .nf
 .ft C
-> "c:\e\eProgram Files\e\eInternet Explorer\e\eiexplore.exe" http://packages.groonga.org/windows/groonga/groonga\-3.0.8\-x86.exe
+> "c:\e\eProgram Files\e\eInternet Explorer\e\eiexplore.exe" http://packages.groonga.org/windows/groonga/groonga\-3.0.9\-x86.exe
 .ft P
 .fi
 .UNINDENT
@@ -125,7 +118,7 @@ groonga は独自のカラムストアを持つ列指向のデータベースと
 .sp
 .nf
 .ft C
-> "c:\e\eProgram Files\e\eInternet Explorer\e\eiexplore.exe" http://packages.groonga.org/windows/groonga/groonga\-3.0.8\-x64.exe
+> "c:\e\eProgram Files\e\eInternet Explorer\e\eiexplore.exe" http://packages.groonga.org/windows/groonga/groonga\-3.0.9\-x64.exe
 .ft P
 .fi
 .UNINDENT
@@ -146,7 +139,7 @@ groonga は独自のカラムストアを持つ列指向のデータベースと
 .sp
 .nf
 .ft C
-> "c:\e\eProgram Files\e\eInternet Explorer\e\eiexplore.exe" http://packages.groonga.org/windows/groonga/groonga\-3.0.8\-x86.zip
+> "c:\e\eProgram Files\e\eInternet Explorer\e\eiexplore.exe" http://packages.groonga.org/windows/groonga/groonga\-3.0.9\-x86.zip
 .ft P
 .fi
 .UNINDENT
@@ -162,7 +155,7 @@ groonga は独自のカラムストアを持つ列指向のデータベースと
 .sp
 .nf
 .ft C
-> "c:\e\eProgram Files\e\eInternet Explorer\e\eiexplore.exe" http://packages.groonga.org/windows/groonga/groonga\-3.0.8\-x64.zip
+> "c:\e\eProgram Files\e\eInternet Explorer\e\eiexplore.exe" http://packages.groonga.org/windows/groonga/groonga\-3.0.9\-x64.zip
 .ft P
 .fi
 .UNINDENT
@@ -196,7 +189,7 @@ Microsoft Visual Studio 2010 Expressがインストールする \fBVisual Studio
 .nf
 .ft C
 > cd c:\eUsers\e%USERNAME%\eDownloads
-> "c:\e\eProgram Files\e\eInternet Explorer\e\eiexplore.exe" http://packages.groonga.org/source/groonga/groonga\-3.0.8.zip
+> "c:\e\eProgram Files\e\eInternet Explorer\e\eiexplore.exe" http://packages.groonga.org/source/groonga/groonga\-3.0.9.zip
 .ft P
 .fi
 .UNINDENT
@@ -210,7 +203,7 @@ groongaのソースフォルダへと移動します:
 .sp
 .nf
 .ft C
-> cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-3.0.8
+> cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-3.0.9
 .ft P
 .fi
 .UNINDENT
@@ -222,7 +215,7 @@ groongaのソースフォルダへと移動します:
 .sp
 .nf
 .ft C
-groonga\-3.0.8> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\egroonga
+groonga\-3.0.9> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\egroonga
 .ft P
 .fi
 .UNINDENT
@@ -234,7 +227,7 @@ groonga\-3.0.8> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\
 .sp
 .nf
 .ft C
-groonga\-3.0.8> cmake \-\-build . \-\-config Release
+groonga\-3.0.9> cmake \-\-build . \-\-config Release
 .ft P
 .fi
 .UNINDENT
@@ -246,7 +239,7 @@ groonga\-3.0.8> cmake \-\-build . \-\-config Release
 .sp
 .nf
 .ft C
-groonga\-3.0.8> cmake \-\-build . \-\-config Release \-\-target Install
+groonga\-3.0.9> cmake \-\-build . \-\-config Release \-\-target Install
 .ft P
 .fi
 .UNINDENT
@@ -294,9 +287,9 @@ groonga\-3.0.8> cmake \-\-build . \-\-config Release \-\-target Install
 .sp
 .nf
 .ft C
-% curl \-O http://packages.groonga.org/source/groonga/groonga\-3.0.8.tar.gz
-% tar xvzf groonga\-3.0.8.tar.gz
-% cd groonga\-3.0.8
+% curl \-O http://packages.groonga.org/source/groonga/groonga\-3.0.9.tar.gz
+% tar xvzf groonga\-3.0.9.tar.gz
+% cd groonga\-3.0.9
 .ft P
 .fi
 .UNINDENT
@@ -673,9 +666,9 @@ groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-3.0.8.tar.gz
-% tar xvzf groonga\-3.0.8.tar.gz
-% cd groonga\-3.0.8
+% wget http://packages.groonga.org/source/groonga/groonga\-3.0.9.tar.gz
+% tar xvzf groonga\-3.0.9.tar.gz
+% cd groonga\-3.0.9
 .ft P
 .fi
 .UNINDENT
@@ -1104,6 +1097,79 @@ groonga\-normalizer\-mysqlパッケージのインストール:
 .fi
 .UNINDENT
 .UNINDENT
+.SS 13.10 Saucy Salamander
+.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/ saucy universe
+deb\-src http://packages.groonga.org/ubuntu/ saucy 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 ソースからビルド
 .sp
 groongaをビルドするために必要なパッケージをインストールします:
@@ -1124,9 +1190,9 @@ groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-3.0.8.tar.gz
-% tar xvzf groonga\-3.0.8.tar.gz
-% cd groonga\-3.0.8
+% wget http://packages.groonga.org/source/groonga/groonga\-3.0.9.tar.gz
+% tar xvzf groonga\-3.0.9.tar.gz
+% cd groonga\-3.0.9
 .ft P
 .fi
 .UNINDENT
@@ -1442,9 +1508,9 @@ groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-3.0.8.tar.gz
-% tar xvzf groonga\-3.0.8.tar.gz
-% cd groonga\-3.0.8
+% wget http://packages.groonga.org/source/groonga/groonga\-3.0.9.tar.gz
+% tar xvzf groonga\-3.0.9.tar.gz
+% cd groonga\-3.0.9
 .ft P
 .fi
 .UNINDENT
@@ -1630,9 +1696,9 @@ groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-3.0.8.tar.gz
-% tar xvzf groonga\-3.0.8.tar.gz
-% cd groonga\-3.0.8
+% wget http://packages.groonga.org/source/groonga/groonga\-3.0.9.tar.gz
+% tar xvzf groonga\-3.0.9.tar.gz
+% cd groonga\-3.0.9
 .ft P
 .fi
 .UNINDENT
@@ -1696,9 +1762,9 @@ groongaをビルドするために必要なパッケージをインストール
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-3.0.8.tar.gz
-% gtar xvzf groonga\-3.0.8.tar.gz
-% cd groonga\-3.0.8
+% wget http://packages.groonga.org/source/groonga/groonga\-3.0.9.tar.gz
+% gtar xvzf groonga\-3.0.9.tar.gz
+% cd groonga\-3.0.9
 .ft P
 .fi
 .UNINDENT
@@ -1819,9 +1885,9 @@ groongaはGNUビルドシステムを使っています。以下は一番簡単
 .sp
 .nf
 .ft C
-% wget http://packages.groonga.org/source/groonga/groonga\-3.0.8.tar.gz
-% tar xvzf groonga\-3.0.8.tar.gz
-% cd groonga\-3.0.8
+% wget http://packages.groonga.org/source/groonga/groonga\-3.0.9.tar.gz
+% tar xvzf groonga\-3.0.9.tar.gz
+% cd groonga\-3.0.9
 % ./configure
 % make
 % sudo make install
@@ -1940,6 +2006,13 @@ zlibを使ってカラム値を圧縮する機能を有効にします。
 .fi
 .UNINDENT
 .UNINDENT
+.sp
+\fBノート:\fP
+.INDENT 0.0
+.INDENT 3.5
+無効となっている理由は、カラムの値を参照するときにメモリリークするためです。これは既知の問題 \fI\%GitHub#6\fP です。この問題はカラムの更新とは関係ありません。
+.UNINDENT
+.UNINDENT
 .SS \fB\-\-with\-lzo\fP
 .sp
 LZOを使ってカラム値を圧縮する機能を有効にします。
@@ -1957,6 +2030,13 @@ LZOを使ってカラム値を圧縮する機能を有効にします。
 .fi
 .UNINDENT
 .UNINDENT
+.sp
+\fBノート:\fP
+.INDENT 0.0
+.INDENT 3.5
+無効となっている理由は、カラムの値を参照するときにメモリリークするためです。これは既知の問題 \fI\%GitHub#6\fP です。この問題はカラムの更新とは関係ありません。
+.UNINDENT
+.UNINDENT
 .SS \fB\-\-with\-message\-pack=MESSAGE_PACK_INSTALL_PREFIX\fP
 .sp
 MessagePackがどこにインストールされているかを指定します。MessagePackを \fB\-\-prefix=/usr\fP という \fBconfigure\fP オプションでインストールしていない場合は、MessagePackをビルドするときに指定したパスをこのオプションで指定してください。
@@ -7857,6 +7937,8 @@ TODO...
 RKはローマ字（Romaji）とカタカナ（Katakana）を意味しています。前方一致RK検索は登録されている語をユーザの入力から前方一致検索します。このとき、ユーザの入力はローマ字でもカタカナでもひらがなでも構いません。この機能は日本語を検索するときに便利です。
 .sp
 例えば、"日本"という語が登録されているとします。そして、その読みとして"ニホン"（カタカナにしないといけません）が登録されているとします。このとき、ユーザの入力が"ni"でも"二"でも"に"でも"日本"を見つけることができます。
+.sp
+If you create dataset which is named as example by \fB/reference/executables/groonga\-suggest\-create\-dataset\fP command, you can update pairs of registered word and its reading by loading data to \(aq_key\(aq and \(aqkana\(aq column of item_example table explicitly for prefix RK search.
 .SS 共起検索
 .sp
 共起検索は入力途中のユーザのクエリから登録されている語を見つけます。共起検索では検索データベースとしてユーザの入力シーケンスを使います。これはクエリログやアクセスログなどから学習します。
@@ -8143,93 +8225,93 @@ load \-\-table event_query \-\-each \(aqsuggest_preparer(_id, type, item, sequen
 .fi
 .UNINDENT
 .UNINDENT
-.SS 補正
+.SS How to update RK reading data
 .sp
-このセクションでは以下の補正機能について説明します。:
-.INDENT 0.0
-.IP \(bu 2
-どのように動作するか
-.IP \(bu 2
-使い方
-.IP \(bu 2
-学習方法
-.UNINDENT
-.SS どのように動作するか
+Groonga requires registered word and its reading for RK search, so load such data in the advance.
 .sp
-補正機能は補正した語を計算するために3種類の検索を使います。:
+Here is the example to register "日本" which means Japanese in english.
+.sp
+実行例:
 .INDENT 0.0
 .INDENT 3.5
-.INDENT 0.0
-.IP 1. 3
-学習したデータを共起検索。
-.IP 2. 3
-登録されている語を類似検索。（実行しないこともある）
-.UNINDENT
+.sp
+.nf
+.ft C
+load \-\-table event_query \-\-each \(aqsuggest_preparer(_id, type, item, sequence, time, pair_query)\(aq
+[
+{"sequence": "1", "time": 1312950805.86058, "item": "日本", "type": "submit"}
+]
+# [[0, 1337566253.89858, 0.000355720520019531], 1]
+.ft P
+.fi
 .UNINDENT
 .UNINDENT
-.SS 共起検索
-.sp
-共起検索はユーザの間違って入力した文字列から登録済みの語を検索します。共起検索ではユーザがどのように検索を実行したかを使います。ユーザがどのように検索したかはクエリログやアクセスログから学習します。
 .sp
-例えば、ユーザが以下のように検索を実行したとします。:
-.TS
-center;
-|l|l|.
-_
-T{
-クエリ
-T}	T{
-時刻
-T}
-_
-T{
-serach （入力ミス！）
-T}	T{
-2011\-08\-10T22:20:50+09:00
-T}
-_
-T{
-search （修正！）
-T}	T{
-2011\-08\-10T22:20:52+09:00
-T}
-_
-.TE
+Here is the example to update RK data to complete "日本".
 .sp
-上記の検索実行ログから以下のような補正ペアを作ります。
-.TS
-center;
-|l|l|.
-_
-T{
-入力
-T}	T{
-補正された語
-T}
-_
-T{
-serach
-T}	T{
-search
-T}
-_
-.TE
+実行例:
+.INDENT 0.0
+.INDENT 3.5
 .sp
-1分以内の連続して実行された検索をユーザが入力を補正したものとみなします。検索を実行した間の入力途中の入力シーケンスは、補正用の学習データとしては利用しません。
+.nf
+.ft C
+load \-\-table item_query
+[
+{"_key":"日本", "kana":["ニホン", "ニッポン"]}
+]
+# [[0, 1337566253.89858, 0.000355720520019531], 1]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
 .sp
-ユーザが"serach"と入力した場合、共起検索は"saerch"を返します。なぜなら、"serach"が「入力」カラムにあり、対応する「補正される語」カラムの値が"search"だからです。
-.SS 類似検索
+Then you can complete registered word "日本" by RK input \- "nihon".
 .sp
-類似検索はユーザの入力をトークナイズし、同じトークンを含んだ登録済みの語を検索します。トークナイズにはTokenBigramトークナイザーを使います。これは \fB/reference/executables/groonga\-suggest\-create\-dataset\fP が作るサジェストデータセットスキーマではデフォルトトークナイザーとしてTokenBigramトークナイザーを使っているからです。
+実行例:
+.INDENT 0.0
+.INDENT 3.5
 .sp
-例えば、"search engine"という語が登録されているとします。ユーザが"web search service"や"sound engine"などで検索すると"search engine"が補正候補になります。なぜなら、"search engine"と"web search engine"は"search"という同じトークンを持つからです。また、"search engine"と"sound engine"は"engine"という同じトークンを持っています。
+.nf
+.ft C
+suggest \-\-table item_query \-\-column kana \-\-types complete \-\-frequency_threshold 1 \-\-query nihon
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   {
+#     "complete": [
+#       [
+#         1
+#       ],
+#       [
+#         [
+#           "_key",
+#           "ShortText"
+#         ],
+#         [
+#           "_score",
+#           "Int32"
+#         ]
+#       ],
+#       [
+#         "日本",
+#         2
+#       ]
+#     ]
+#   }
+# ]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
 .sp
-"search engine"は"search"トークンと"engine"トークンにトークナイズされます。（groongaのTokenBigramトークナイザーは連続するアルファベットと数字を2文字にトークナイズしません。これは検索ノイズを減らす為です。確実に2文字でトークナイズするためにはTokenBigramSplitSymbolAlphaDigitを使います。）"web search service"は"web"トークンと"search"トークンと"service"トークンにトークナイズされます。"sound engine"は"sound"トークンと"engine"トークンにトークナイズされます。
-.SS 使い方
+Without loading above RK data, you can\(aqt complete registered word "日本" by query \- "nihon".
 .sp
-groongaは補正機能を使うために \fB/reference/commands/suggest\fP コマンドを用意しています。 \fI\-\-type correct\fP オプションを使うと補正機能を利用できます。
+As the column type of item_query table is VECTOR_COLUMN, you can register multiple readings for registered word.
 .sp
-例えば、"saerch"と入力した時の補正結果取得するコマンドは以下のようになります。:
+This is the reason that you can also complete the registered word "日本" by query \- "nippon".
 .sp
 実行例:
 .INDENT 0.0
@@ -8237,7 +8319,7 @@ groongaは補正機能を使うために \fB/reference/commands/suggest\fP コ
 .sp
 .nf
 .ft C
-suggest \-\-table item_query \-\-column kana \-\-types correction \-\-frequency_threshold 1 \-\-query saerch
+suggest \-\-table item_query \-\-column kana \-\-types complete \-\-frequency_threshold 1 \-\-query nippon
 # [
 #   [
 #     0,
@@ -8245,7 +8327,7 @@ suggest \-\-table item_query \-\-column kana \-\-types correction \-\-frequency_
 #     0.000355720520019531
 #   ],
 #   {
-#     "correct": [
+#     "complete": [
 #       [
 #         1
 #       ],
@@ -8260,8 +8342,8 @@ suggest \-\-table item_query \-\-column kana \-\-types correction \-\-frequency_
 #         ]
 #       ],
 #       [
-#         "search",
-#         1
+#         "日本",
+#         2
 #       ]
 #     ]
 #   }
@@ -8270,35 +8352,14 @@ suggest \-\-table item_query \-\-column kana \-\-types correction \-\-frequency_
 .fi
 .UNINDENT
 .UNINDENT
-.SS 学習方法
 .sp
-共起検索は学習データを使います。学習データはクエリログやアクセスログから作ります。学習データを作るためにはユーザが検索を実行したときの検索クエリとタイムスタンプが必要です。
+This feature is very convenient because you can search registered word even though Japanese IM is disabled.
 .sp
-例えば、ユーザが"search"で検索したかったとします。しかし、ユーザは正しい"search"というクエリで検索を実行する前に間違って"saerch"で検索してしまいました。このユーザの入力シーケンスは以下のようになります。:
-.INDENT 0.0
-.INDENT 3.5
-.INDENT 0.0
-.IP 1. 3
-2011\-08\-10T13:33:23+09:00: s
-.IP 2. 3
-2011\-08\-10T13:33:23+09:00: sa
-.IP 3. 3
-2011\-08\-10T13:33:24+09:00: sae
-.IP 4. 3
-2011\-08\-10T13:33:24+09:00: saer
-.IP 5. 3
-2011\-08\-10T13:33:24+09:00: saerc
-.IP 6. 3
-2011\-08\-10T13:33:25+09:00: saerch （検索実行！）
-.IP 7. 3
-2011\-08\-10T13:33:29+09:00: serch （修正中…）
-.IP 8. 3
-2011\-08\-10T13:33:30+09:00: search （検索実行！）
-.UNINDENT
-.UNINDENT
-.UNINDENT
+If there are multiple candidates as completed result, you can customize priority to set the value of "boost" column in item_query table.
 .sp
-以下のコマンドでこの入力シーケンスから学習できます。:
+Here is the example to customize priority for RK search.
+.sp
+実行例:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -8306,10 +8367,266 @@ suggest \-\-table item_query \-\-column kana \-\-types correction \-\-frequency_
 .ft C
 load \-\-table event_query \-\-each \(aqsuggest_preparer(_id, type, item, sequence, time, pair_query)\(aq
 [
-{"sequence": "1", "time": 1312950803.86057, "item": "s"},
-{"sequence": "1", "time": 1312950803.96857, "item": "sa"},
-{"sequence": "1", "time": 1312950804.26057, "item": "sae"},
-{"sequence": "1", "time": 1312950804.56057, "item": "saer"},
+{"sequence": "1", "time": 1312950805.86059, "item": "日本語", "type": "submit"}
+{"sequence": "1", "time": 1312950805.86060, "item": "日本人", "type": "submit"}
+]
+# [[0, 1337566253.89858, 0.000355720520019531], 2]
+load \-\-table item_query
+[
+{"_key":"日本語", "kana":"ニホンゴ"}
+{"_key":"日本人", "kana":"ニホンジン"}
+]
+# [[0, 1337566253.89858, 0.000355720520019531], 2]
+suggest \-\-table item_query \-\-column kana \-\-types complete \-\-frequency_threshold 1 \-\-query nihon
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   {
+#     "complete": [
+#       [
+#         3
+#       ],
+#       [
+#         [
+#           "_key",
+#           "ShortText"
+#         ],
+#         [
+#           "_score",
+#           "Int32"
+#         ]
+#       ],
+#       [
+#         "日本",
+#         2
+#       ],
+#       [
+#         "日本人",
+#         2
+#       ],
+#       [
+#         "日本語",
+#         2
+#       ]
+#     ]
+#   }
+# ]
+load \-\-table item_query
+[
+{"_key":"日本人", "boost": 100},
+]
+# [[0, 1337566253.89858, 0.000355720520019531], 1]
+suggest \-\-table item_query \-\-column kana \-\-types complete \-\-frequency_threshold 1 \-\-query nihon
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   {
+#     "complete": [
+#       [
+#         3
+#       ],
+#       [
+#         [
+#           "_key",
+#           "ShortText"
+#         ],
+#         [
+#           "_score",
+#           "Int32"
+#         ]
+#       ],
+#       [
+#         "日本人",
+#         102
+#       ],
+#       [
+#         "日本",
+#         2
+#       ],
+#       [
+#         "日本語",
+#         2
+#       ]
+#     ]
+#   }
+# ]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS 補正
+.sp
+このセクションでは以下の補正機能について説明します。:
+.INDENT 0.0
+.IP \(bu 2
+どのように動作するか
+.IP \(bu 2
+使い方
+.IP \(bu 2
+学習方法
+.UNINDENT
+.SS どのように動作するか
+.sp
+補正機能は補正した語を計算するために3種類の検索を使います。:
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.IP 1. 3
+学習したデータを共起検索。
+.IP 2. 3
+登録されている語を類似検索。（実行しないこともある）
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.SS 共起検索
+.sp
+共起検索はユーザの間違って入力した文字列から登録済みの語を検索します。共起検索ではユーザがどのように検索を実行したかを使います。ユーザがどのように検索したかはクエリログやアクセスログから学習します。
+.sp
+例えば、ユーザが以下のように検索を実行したとします。:
+.TS
+center;
+|l|l|.
+_
+T{
+クエリ
+T}	T{
+時刻
+T}
+_
+T{
+serach （入力ミス！）
+T}	T{
+2011\-08\-10T22:20:50+09:00
+T}
+_
+T{
+search （修正！）
+T}	T{
+2011\-08\-10T22:20:52+09:00
+T}
+_
+.TE
+.sp
+上記の検索実行ログから以下のような補正ペアを作ります。
+.TS
+center;
+|l|l|.
+_
+T{
+入力
+T}	T{
+補正された語
+T}
+_
+T{
+serach
+T}	T{
+search
+T}
+_
+.TE
+.sp
+1分以内の連続して実行された検索をユーザが入力を補正したものとみなします。検索を実行した間の入力途中の入力シーケンスは、補正用の学習データとしては利用しません。
+.sp
+ユーザが"serach"と入力した場合、共起検索は"saerch"を返します。なぜなら、"serach"が「入力」カラムにあり、対応する「補正される語」カラムの値が"search"だからです。
+.SS 類似検索
+.sp
+類似検索はユーザの入力をトークナイズし、同じトークンを含んだ登録済みの語を検索します。トークナイズにはTokenBigramトークナイザーを使います。これは \fB/reference/executables/groonga\-suggest\-create\-dataset\fP が作るサジェストデータセットスキーマではデフォルトトークナイザーとしてTokenBigramトークナイザーを使っているからです。
+.sp
+例えば、"search engine"という語が登録されているとします。ユーザが"web search service"や"sound engine"などで検索すると"search engine"が補正候補になります。なぜなら、"search engine"と"web search engine"は"search"という同じトークンを持つからです。また、"search engine"と"sound engine"は"engine"という同じトークンを持っています。
+.sp
+"search engine"は"search"トークンと"engine"トークンにトークナイズされます。（groongaのTokenBigramトークナイザーは連続するアルファベットと数字を2文字にトークナイズしません。これは検索ノイズを減らす為です。確実に2文字でトークナイズするためにはTokenBigramSplitSymbolAlphaDigitを使います。）"web search service"は"web"トークンと"search"トークンと"service"トークンにトークナイズされます。"sound engine"は"sound"トークンと"engine"トークンにトークナイズされます。
+.SS 使い方
+.sp
+groongaは補正機能を使うために \fB/reference/commands/suggest\fP コマンドを用意しています。 \fI\-\-type correct\fP オプションを使うと補正機能を利用できます。
+.sp
+例えば、"saerch"と入力した時の補正結果取得するコマンドは以下のようになります。:
+.sp
+実行例:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+suggest \-\-table item_query \-\-column kana \-\-types correction \-\-frequency_threshold 1 \-\-query saerch
+# [
+#   [
+#     0,
+#     1337566253.89858,
+#     0.000355720520019531
+#   ],
+#   {
+#     "correct": [
+#       [
+#         1
+#       ],
+#       [
+#         [
+#           "_key",
+#           "ShortText"
+#         ],
+#         [
+#           "_score",
+#           "Int32"
+#         ]
+#       ],
+#       [
+#         "search",
+#         1
+#       ]
+#     ]
+#   }
+# ]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS 学習方法
+.sp
+共起検索は学習データを使います。学習データはクエリログやアクセスログから作ります。学習データを作るためにはユーザが検索を実行したときの検索クエリとタイムスタンプが必要です。
+.sp
+例えば、ユーザが"search"で検索したかったとします。しかし、ユーザは正しい"search"というクエリで検索を実行する前に間違って"saerch"で検索してしまいました。このユーザの入力シーケンスは以下のようになります。:
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.IP 1. 3
+2011\-08\-10T13:33:23+09:00: s
+.IP 2. 3
+2011\-08\-10T13:33:23+09:00: sa
+.IP 3. 3
+2011\-08\-10T13:33:24+09:00: sae
+.IP 4. 3
+2011\-08\-10T13:33:24+09:00: saer
+.IP 5. 3
+2011\-08\-10T13:33:24+09:00: saerc
+.IP 6. 3
+2011\-08\-10T13:33:25+09:00: saerch （検索実行！）
+.IP 7. 3
+2011\-08\-10T13:33:29+09:00: serch （修正中…）
+.IP 8. 3
+2011\-08\-10T13:33:30+09:00: search （検索実行！）
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.sp
+以下のコマンドでこの入力シーケンスから学習できます。:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+load \-\-table event_query \-\-each \(aqsuggest_preparer(_id, type, item, sequence, time, pair_query)\(aq
+[
+{"sequence": "1", "time": 1312950803.86057, "item": "s"},
+{"sequence": "1", "time": 1312950803.96857, "item": "sa"},
+{"sequence": "1", "time": 1312950804.26057, "item": "sae"},
+{"sequence": "1", "time": 1312950804.56057, "item": "saer"},
 {"sequence": "1", "time": 1312950804.76057, "item": "saerc"},
 {"sequence": "1", "time": 1312950805.76057, "item": "saerch", "type": "submit"},
 {"sequence": "1", "time": 1312950809.76057, "item": "serch"},
@@ -10018,9 +10335,6 @@ DBに定義されているテーブルを削除します。
 .B \fBcolumn_remove\fP
 テーブルに定義されているカラムを削除します。
 .TP
-.B \fBview_add\fP
-VIEW型のテーブルに要素となるテーブルを定義します。
-.TP
 .B \fBload\fP
 テーブルにレコードを挿入します。
 .TP
@@ -10278,7 +10592,30 @@ location /d/ {
 .sp
 .nf
 .ft C
-groonga_database /path/to/groonga/database;
+groonga_database /path/to/groonga/database;
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B Default
+\fBgroonga_database /usr/local/var/lib/groonga/db/db;\fP
+.TP
+.B Context
+\fBhttp\fP, \fBserver\fP, \fBlocation\fP
+.UNINDENT
+.sp
+groongaデータベースのパスを指定します。このディレクティブは必須です。
+.SS \fBgroonga_database_auto_create\fP
+.sp
+書式:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+groonga_database_auto_create on | off;
 .ft P
 .fi
 .UNINDENT
@@ -10286,16 +10623,17 @@ groonga_database /path/to/groonga/database;
 .INDENT 0.0
 .TP
 .B Default
-\fBgroonga_database /usr/local/var/lib/groonga/db/db;\fP
+\fBgroonga_database_auto_create on;\fP
 .TP
 .B Context
 \fBhttp\fP, \fBserver\fP, \fBlocation\fP
 .UNINDENT
 .sp
-groongaデータベースのパスを指定します。このディレクティブは必須です。
-.SS \fBgroonga_database_auto_create\fP
+groongaのデータベースを自動で作成するかどうかを指定します。もし、この値が \fBon\fP で \fIgroonga\-database\fP に指定したgroongaのデータベースが存在しない場合は自動でgroongaのデータベースを作成します。groongaのデータベースが存在している場合は何もしません。
 .sp
-TODO
+もし、親ディレクトリが存在しな場合は再帰的に親ディレクトリも作成します。
+.sp
+デフォルト値は \fBon\fP です。通常、この値を変更する必要はありません。
 .SS \fBgroonga_base_path\fP
 .sp
 書式:
@@ -10493,6 +10831,47 @@ location /d/ {
 このディレクティブはgroonga\-httpdのディレクティブではなく、nginxのディレクティブです。詳細は、 \fI\%http://wiki.nginx.org/CoreModule#worker_processes\fP を参照してください。
 .sp
 デフォルトで、このディレクティブには1が設定されています。
+.SS \fBgroonga_cache_limit\fP
+.sp
+This directive is introduced to customize cache limit for each worker process.
+.sp
+書式:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+groonga_cache_limit CACHE_LIMIT;
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B Default
+100
+.TP
+.B Context
+\fBhttp\fP, \fBserver\fP, \fBlocation\fP
+.UNINDENT
+.sp
+Groongaのクエリキャッシュの制限を \fBhttp\fP 、 \fBserver\fP もしくは \fBlocation\fP ブロックで指定します。デフォルトは \fB100\fP です。 \fB0\fP を指定することで \fBgroonga_cache_limit\fP を明示的に無効にできます。
+.sp
+例:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+location /d/ {
+  groonga on;
+  # You can customize query cache limit for groonga.
+  groonga_cache_limit 100;
+}
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
 .SS \fBproxy_cache\fP
 .sp
 まとめると、groonga組み込みのクエリーキャッシュ機能の代わりにnginxのリバースプロ機とキャッシュの仕組みを使うこともできます。
@@ -10502,13 +10881,9 @@ groongaは \fB/reference/commands/select\fP コマンド用にクエリーキャ
 .sp
 クエリーキャッシュ機能は \fB/reference/commands/cache_limit\fP コマンドを使っていないあるいはワーカー数が1だけの場合はgroonga\-httpd上でもきちんと動作します。通常、 \fB/reference/commands/cache_limit\fP コマンドは使わないので、多くの場合は問題がありません。
 .sp
-2ワーカー以上で:doc:\fI/reference/commands/cache_limit\fP コマンドを使ったときの問題点を説明します。
+2ワーカー以上で \fB/reference/commands/cache_limit\fP コマンドを使ったときの問題点を説明します。
 .sp
-groongaのクエリーキャッシュは同じプロセス内で有効です。これは、同じキャッシュを複数のワーカー間で共有できないということです。キャッシュサイズを変更しないならこれは大きな問題ではありません。もし、 :doc:
-.nf
-\(ga
-.fi
-/reference/commands/cache_limit\(gaコマンドでキャッシュサイズを変更したいなら問題になります。
+groongaのクエリーキャッシュは同じプロセス内で有効です。これは、同じキャッシュを複数のワーカー間で共有できないということです。キャッシュサイズを変更しないならこれは大きな問題ではありません。もし、 \fB/reference/commands/cache_limit\fP コマンドでキャッシュサイズを変更したいなら問題になります。
 .sp
 すべてのワーカーのキャッシュサイズを変更する汎用的な方法がないのです。
 .sp
@@ -10728,6 +11103,28 @@ groonga\-suggest\-create\-dataset [options] DATABASE DATASET
 .SS DESCTIPION
 .sp
 groonga\-suggest\-create\-dataset creates a dataset for \fB/suggest\fP. A database has many datasets. This command just defines schema for a suggestion dataset.
+.sp
+This command generates some tables and columns for \fB/suggest\fP.
+.sp
+Here is the list of such tables. If you specify \(aqquery\(aq as dataset name, following \(aq_DATASET\(aq suffix are replaced. Thus, \(aqitem_query\(aq, \(aqpair_query\(aq, \(aqsequence_query\(aq, \(aqevent_query\(aq tables are generated.
+.INDENT 0.0
+.IP \(bu 2
+event_type
+.IP \(bu 2
+bigram
+.IP \(bu 2
+kana
+.IP \(bu 2
+item_DATASET
+.IP \(bu 2
+pair_DATASET
+.IP \(bu 2
+sequence_DATASET
+.IP \(bu 2
+event_DATASET
+.IP \(bu 2
+設定ディレクティブ
+.UNINDENT
 .SS オプション
 .sp
 None.
@@ -10743,8 +11140,100 @@ TODO
 .SS 参考
 .sp
 \fB/suggest\fP
-.. : doc:\fIgroonga\-suggest\-httpd\fP
-.. : doc:\fIgroonga\-suggest\-learner\fP
+\fBgroonga\-suggest\-httpd\fP
+\fBgroonga\-suggest\-learner\fP
+.SS groonga\-suggest\-httpd
+.SS 概要
+.sp
+TODO
+.SS 書式
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+groonga\-suggest\-httpd [options] database_path
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS 使い方
+.sp
+TODO
+.SS Options
+.INDENT 0.0
+.TP
+.B \-p, \-\-port
+Specify http server port number. The default value is 8080.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-t, \-\-n\-threads
+Specify number of threads. The default value is 8.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-s, \-\-send\-endpoint
+Specify endpoint for sender.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-r, \-\-receive\-endpoint
+Specify endpoint for receiver.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-l, \-\-log\-base\-path
+Specify path prefix of log.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-n\-lines\-per\-log\-file
+Specify the number of lines in a log file. The default value is 1,000,000.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-d, \-\-daemon
+Specify this option to daemonize.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \-\-disable\-max\-fd\-check
+Specify this option to disable checking max fd on start.
+.UNINDENT
+.SS 引数
+.sp
+\fBdatabase_path\fP だけが必須の引数です。
+.SS \fBdatabase_path\fP
+.sp
+groongaデータベースのパスを指定します。
+.SS groonga\-suggest\-learner
+.SS 概要
+.sp
+TODO
+.SS 書式
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+groonga\-suggest\-learner [options] database_path
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS 使い方
+.sp
+TODO
+.SS Options
+.sp
+TODO
+.SS 引数
+.sp
+\fBdatabase_path\fP だけが必須の引数です。
+.SS \fBdatabase_path\fP
+.sp
+groongaデータベースのパスを指定します。
 .SS 出力
 .sp
 groongaは以下の出力形式をサポートしています。
@@ -11556,7 +12045,7 @@ cache_limit
 .sp
 .nf
 .ft C
-[[HEADER, n_entries]]
+[[HEADER, N_ENTRIES]]
 .ft P
 .fi
 .UNINDENT
@@ -11569,10 +12058,10 @@ cache_limit
 .UNINDENT
 .UNINDENT
 .sp
-\fBn_entries\fP
+\fBN_ENTRIES\fP
 .INDENT 0.0
 .INDENT 3.5
-\fBn_entries\fP は現在の最大クエリーキャッシュエントリー数です。これは数値です。
+\fBN_ENTRIES\fP は現在の最大クエリーキャッシュエントリー数です。これは数値です。
 .UNINDENT
 .UNINDENT
 .SS 参考
@@ -11896,11 +12385,15 @@ clearlock Entry.body
 .SS 関連項目
 .sp
 \fBload\fP
-.SS column_create
-.SS 名前
+.SS \fBcolumn_create\fP
+.SS 概要
 .sp
 column_create \- カラムの追加
-.SS 書式
+.sp
+groonga組込コマンドの一つであるcolumn_createについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+.sp
+column_createは、使用しているデータベースのテーブルに対してカラムを追加します。
+.SS 構文
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -11911,11 +12404,33 @@ column_create table name flags type [source]
 .fi
 .UNINDENT
 .UNINDENT
-.SS 説明
+.SS 使い方
 .sp
-groonga組込コマンドの一つであるcolumn_createについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+テーブルEntryに、ShortText型の値を格納するカラム、bodyを作成します。:
+.INDENT 0.0
+.INDENT 3.5
 .sp
-column_createは、使用しているデータベースのテーブルに対してカラムを追加します。
+.nf
+.ft C
+column_create Entry body \-\-type ShortText
+[true]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+テーブルTermに、Entryテーブルのbodyカラムの値を対象とする完全転置インデックス型カラム、entry_bodyを作成します。:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+column_create Term entry_body COLUMN_INDEX|WITH_POSITION Entry body
+[true]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
 .SS 引数
 .sp
 \fBtable\fP
@@ -11950,6 +12465,16 @@ column_createは、使用しているデータベースのテーブルに対し
 インデックス型のカラムを作成します。
 .UNINDENT
 .sp
+カラムの値を圧縮するためのフラグが2つあります。ただしそれらのフラグを指定することは今のところできません。これはカラムの値を参照するときにメモリリークする問題 \fI\%GitHub#6\fP があるためです。 この問題はzlib、lzoいずれでも発生します。
+.INDENT 0.0
+.TP
+.B 16, \fBCOMPRESS_ZLIB\fP
+予約済み。zlibを使ってカラムの値を圧縮します。このフラグはgroongaを \fB\-\-with\-zlib\fP つきでビルドしても使えません。
+.TP
+.B 32, \fBCOMPRESS_LZO\fP
+予約済み。lzoを使ってカラムの値を圧縮します。このフラグはgroongaを \fB\-\-with\-lzo\fP つきでビルドしても使えません。
+.UNINDENT
+.sp
 インデックス型のカラムについては、flagsの値に以下の値を加えることによって、追加の属
 性を指定することができます。
 .INDENT 0.0
@@ -11979,50 +12504,29 @@ column_createは、使用しているデータベースのテーブルに対し
 インデックス型のカラムを作成した場合は、インデックス対象となるカラムをsource引数に指定します。
 .UNINDENT
 .UNINDENT
-.SS 返値
-.SS json形式
+.SS 戻り値
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-[成功かどうかのフラグ]
+[HEADER, SUCCEEDED]
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .sp
-\fB成功かどうかのフラグ\fP
-.INDENT 0.0
-.INDENT 3.5
-エラーが生じなかった場合にはtrue、エラーが生じた場合にはfalseを返す。
-.UNINDENT
-.UNINDENT
-.SS 例
-.sp
-テーブルEntryに、ShortText型の値を格納するカラム、bodyを作成します。:
+\fBHEADER\fP
 .INDENT 0.0
 .INDENT 3.5
-.sp
-.nf
-.ft C
-column_create Entry body \-\-type ShortText
-[true]
-.ft P
-.fi
+HEADERのフォーマットは  [0, UNIX_TIME_WHEN_COMMAND_IS_STARTED, ELAPSED_TIME] です。HEADERについては \fB/reference/command/output_format\fP を参照してください。
 .UNINDENT
 .UNINDENT
 .sp
-テーブルTermに、Entryテーブルのbodyカラムの値を対象とする完全転置インデックス型カラム、entry_bodyを作成します。:
+\fBSUCCEEDED\fP
 .INDENT 0.0
 .INDENT 3.5
-.sp
-.nf
-.ft C
-column_create Term entry_body COLUMN_INDEX|WITH_POSITION Entry body
-[true]
-.ft P
-.fi
+コマンドの実行が成功するとtrueを返します。失敗するとエラーとしてfalseを返します。
 .UNINDENT
 .UNINDENT
 .SS column_list
@@ -13399,7 +13903,9 @@ log_reopenコマンドを実行する。
 .sp
 .nf
 .ft C
-normalize normalizer string
+normalize normalizer
+          string
+          [flags=NONE]
 .ft P
 .fi
 .UNINDENT
@@ -13435,20 +13941,95 @@ normalize NormalizerAuto "aBcDe 123"
 このセクションでは \fBnormalizer\fP の引数について説明します。
 .SS 必須引数
 .sp
-必須引数は二つあります。 \fBnormalizer\fP と \fBstring\fP です。
-.SS \fBnormalizer\fP
+必須引数は二つあります。 \fBnormalizer\fP と \fBstring\fP です。
+.SS \fBnormalizer\fP
+.sp
+ノーマライザー名を指定します。 \fBnormalize\fP コマンドは \fBnormalizer\fP で指定された名前のノーマライザーを使います。
+.sp
+組み込みのノーマライザーの一覧は \fB/reference/normalizers\fP にあります。
+.sp
+以下は \fBNormalizerAuto\fP ノーマライザーを使う例です。
+.sp
+TODO
+.sp
+他のノーマライザーを使いたい場合は、 \fBregister\fP コマンドでノーマライザープラグインを登録する必要があります。例えば、 \fI\%groonga\-normalizer\-mysql\fP を登録することでMySQL互換の正規化方法を使うことができます。
+.SS \fBstring\fP
+.sp
+正規化したい文字列を指定します。
+.sp
+\fBstring\fP の中に文字列を含める場合は、シングルクォート（ \fB\(aq\fP ）またはダブルクォート（ \fB"\fP ）で \fBstring\fP をクォートする必要があります。
+.sp
+\fBstring\fP の中で空白を使う例です。
+.sp
+TODO
+.SS 省略可能引数
+.sp
+いくつか省略可能な引数があります。
+.SS \fBflags\fP
+.sp
+ノーマライズ処理をカスタマイズするオプションを指定します。「 \fB|\fP 」で区切って複数のオプションを指定することができます。例えば、 \fBREMOVE_BLANK|WITH_TYPES\fP というように指定できます。
+.sp
+指定可能なフラグは以下の通りです。
+.TS
+center;
+|l|l|.
+_
+T{
+フラグ
+T}	T{
+説明
+T}
+_
+T{
+\fBNONE\fP
+T}	T{
+無視されます。
+T}
+_
+T{
+\fBREMOVE_BLANK\fP
+T}	T{
+TODO
+T}
+_
+T{
+\fBWITH_TYPES\fP
+T}	T{
+TODO
+T}
+_
+T{
+\fBWITH_CHECKS\fP
+T}	T{
+TODO
+T}
+_
+T{
+\fBREMOVE_TOKENIZED_DELIMITER\fP
+T}	T{
+TODO
+T}
+_
+.TE
+.sp
+以下は \fBREMOVE_BLANK\fP を使った例です。
+.sp
+TODO
+.sp
+以下は \fBWITH_TYPES\fP を使った例です。
+.sp
+TODO
 .sp
-ノーマライザーの名前を指定します。今のところ \fBnormalize\fP コマンドは \fBNormalizerAuto\fP もしくは \fBNormalizerNFKC51\fP を組み込みノーマライザーとして受けつけます。もし他のノーマライザーを使いたい場合には、追加したいノーマライザーを \fB/reference/commands/register\fP コマンドで登録する必要があります。
-.SS \fBstring\fP
+以下は \fBREMOVE_TOKENIZED_DELIMITER\fP を使った例です。
 .sp
-正規化したい文字列を指定します。
+TODO
 .SS 戻り値
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-[HEADER, normalized]
+[HEADER, normalized_text]
 .ft P
 .fi
 .UNINDENT
@@ -13461,10 +14042,34 @@ HEADERのフォーマットは  [0, UNIX_TIME_WHEN_COMMAND_IS_STARTED, ELAPSED_T
 .UNINDENT
 .UNINDENT
 .sp
-\fBnormalized\fP
+\fBnormalized_text\fP
 .INDENT 0.0
 .INDENT 3.5
-normalizedは指定したノーマライザーによる正規化されたテキストです。
+\fBnormalized_text\fP はオブジェクトです。このオブジェクトは以下の属性を持っています。
+.TS
+center;
+|l|l|.
+_
+T{
+名前
+T}	T{
+説明
+T}
+_
+T{
+\fBnormalized\fP
+T}	T{
+正規化されたテキスト。
+T}
+_
+T{
+\fBtypes\fP
+T}	T{
+An array of types of the normalized text. The N\-th \fBtypes\fP shows
+the type of the N\-th character in \fBnormalized\fP.
+T}
+_
+.TE
 .UNINDENT
 .UNINDENT
 .SS 参考
@@ -13575,7 +14180,7 @@ register query_expanders/tsv
 .SS \fBruby_eval\fP
 .SS 概要
 .sp
-\fBruby_eval\fP command evaluates ruby script and returns the result.
+\fBruby_eval\fP コマンドはRubyスクリプトを評価して評価結果を返します。
 .SS 構文
 .sp
 \fBruby_eval\fP には必須な引数が1つあります:
@@ -13584,16 +14189,16 @@ register query_expanders/tsv
 .sp
 .nf
 .ft C
-ruby_eval ruby_script
+ruby_eval script
 .ft P
 .fi
 .UNINDENT
 .UNINDENT
 .SS 使い方
 .sp
-You can execute any scripts which mruby supports by calling \fBruby_eval\fP.
+\fBruby_eval\fP を使うと、mrubyがサポートしているスクリプトを実行できます。
 .sp
-プラグインで \fB1 + 2\fP を計算するだけの例です。
+Ruby \fB1 + 2\fP という計算するだけの例です。
 .sp
 実行例:
 .INDENT 0.0
@@ -13616,18 +14221,18 @@ ruby_eval "1 + 2"
 .SS 引数
 .sp
 このセクションではすべての引数について説明します。
-.SS \fBruby_script\fP
+.SS \fBscript\fP
 .sp
-評価したいrubyスクリプトの文字列を指定します。
+評価したいrubyスクリプトを指定します。
 .SS 戻り値
 .sp
-\fBruby_eval\fP returns the evaluated result which key is "value" as json format:
+\fBruby_eval\fP は例外情報などのメタデータつきで評価結果を返します（メタデータはまだ実装されていないので今のところ含まれません）:
 .INDENT 0.0
 .INDENT 3.5
 .sp
 .nf
 .ft C
-[[HEADER, EVALUATED]]
+[HEADER, {"value": EVALUATED_VALUE}]
 .ft P
 .fi
 .UNINDENT
@@ -13640,36 +14245,79 @@ ruby_eval "1 + 2"
 .UNINDENT
 .UNINDENT
 .sp
-\fBEVALUATED\fP
+\fBEVALUATED_VALUE\fP
 .INDENT 0.0
 .INDENT 3.5
-\fBEVALUATED\fP consists of pair of key and value in forms of {key:value}.
-.TS
-center;
-|l|l|.
-_
-T{
-名前
-T}	T{
-説明
-T}
-_
-T{
-\fBkey\fP
-T}	T{
-reserved word \(aqvalue\(aq.
-T}
-_
-T{
-\fBvalue\fP
-T}	T{
-the value of evaluated script. It must be a number.
-T}
-_
-.TE
+\fBEVALUATED_VALUE\fP は \fBruby_script\fP を評価した値です。
+.sp
+今のところ、 \fBruby_eval\fP は評価された値として数値だけサポートしています。サポートしている型は今後増えていく予定です。
+.UNINDENT
+.UNINDENT
+.SS 参考
+.SS \fBruby_load\fP
+.SS 概要
+.sp
+\fBruby_load\fP コマンドは指定したRubyスクリプトを読み込みます。
+.SS 構文
+.sp
+\fBruby_load\fP には必須な引数が1つあります:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+ruby_load path
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS 使い方
+.sp
+\fBruby_load\fP を使ってmrubyがサポートしているスクリプトを読み込むことができます。
+.sp
+Rubyスクリプトとして \fBexpression.rb\fP を単に読むこむ例です。
+.sp
+\fBruby_load\fP コマンドを使うには事前に \fBruby/load\fP プラグインを登録します。
+.sp
+\fBruby_load\fP コマンドは実験的なプラグインです。このコマンドは将来的に変更されるかも知れません。
+.SS 引数
+.sp
+このセクションではすべての引数について説明します。
+.SS \fBpath\fP
+.sp
+読み込みたいrubyスクリプトを指定します。
+.SS 戻り値
+.sp
+\fBruby_load\fP は例外情報などのメタデータつきで読み込んだ結果を返します（メタデータはまだ実装されていないので今のところ含まれません）:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+[HEADER, {"value": LOADED_VALUE}]
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+\fBHEADER\fP
+.INDENT 0.0
+.INDENT 3.5
+\fBHEADER\fP については \fB/reference/command/output_format\fP を参照してください。
+.UNINDENT
+.UNINDENT
+.sp
+\fBLOADED_VALUE\fP
+.INDENT 0.0
+.INDENT 3.5
+\fBLOADED_VALUE\fP はrubyスクリプトを読み込んだ結果です。
+.sp
+\fBruby_load\fP は \fBLOADED_VALUE\fP としていまのところは単に \fBnull\fP を返します。将来的には \fBLOADED_VALUE\fP がサポートされる予定です。
 .UNINDENT
 .UNINDENT
 .SS 参考
+.sp
+\fB/reference/commands/ruby_eval\fP
 .SS \fBselect\fP
 .SS 概要
 .sp
@@ -17386,7 +18034,7 @@ tokenize TokenBigram "Fulltext Search"
 .sp
 組み込みのトークナイザーについては \fB/reference/tokenizers\fP を参照してください。
 .sp
-以下は \fBTokenTrigram\fP トークナイザーを使う例です。
+以下は組み込みの \fBTokenTrigram\fP トークナイザーを使う例です。
 .sp
 実行例:
 .INDENT 0.0
@@ -17469,10 +18117,12 @@ tokenize TokenTrigram "Fulltext Search"
 .UNINDENT
 .UNINDENT
 .sp
-他のトークナイザーを使いたい場合は、 \fBregister\fP コマンドでトークナイザープラグインを登録する必要があります。例えば、 \fI\%groonga\-normalizer\-mysql\fP を登録することでMySQL互換の正規化方法を使うことができます。
+他のトークナイザーを使いたい場合は、 \fBregister\fP コマンドでトークナイザープラグインを登録する必要があります。例えば、 \fI\%KyTea\fP ベースのトークナイザーを \fBtokenizers/kytea\fP を登録することで使えます。
 .SS \fBstring\fP
 .sp
-トークナイズしたい文字列を指定します。 \fBstring\fP の中に文字列を含める場合は、シングルクォート（ \fB\(aq\fP ）またはダブルクォート（ \fB"\fP ）で \fBstring\fP をクォートする必要があります。
+トークナイズしたい文字列を指定します。
+.sp
+\fBstring\fP の中に文字列を含める場合は、シングルクォート（ \fB\(aq\fP ）またはダブルクォート（ \fB"\fP ）で \fBstring\fP をクォートする必要があります。
 .sp
 \fBstring\fP の中で空白を使う例です。
 .sp
@@ -25146,6 +25796,219 @@ rc=0
 .fi
 .UNINDENT
 .UNINDENT
+.SS Tuning
+.SS 概要
+.sp
+There are some tuning parameters for improving groonga performance or
+handling a large database.
+.SS 引数
+.sp
+このセクションではすべての引数について説明します。
+.SS The max number of open files per process
+.sp
+This parameter is for handling a large database.
+.sp
+Groonga creates one or more files per table and colum. If your
+database has many tables and columns, groonga process needs to open
+many files.
+.sp
+System limits the max number of open files per process. So you need to
+relax the limitation.
+.sp
+Here is an expression that compute how many files are opened by
+groonga:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+3 (for DB) +
+  N tables +
+  N columns (except index clumns) +
+  (N index columns * 2) +
+  X (the number of plugins etc.)
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+以下はスキーマの例です。
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+table_create Entries TABLE_HASH_KEY ShortText
+column_create Entries content COLUMN_SCALAR Text
+column_create Entries n_likes COLUMN_SCALAR UInt32
+table_create Terms TABLE_PAT_KEY|KEY_NORMALIZE ShortText \-\-default_tokenizer TokenBigram
+column_create Terms entries_key_index COLUMN_INDEX|WITH_POSITION Entries _key
+column_create Terms entries_content_index COLUMN_INDEX|WITH_POSITION Entries content
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+This example opens at least 11 files:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+3 +
+  2 (Entries and Terms) +
+  2 (Entries.content and Entries.n_likes) +
+  4 (Terms.entries_key_index and Terms.entries_content_index) +
+  X = 11 + X
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS メモリ使用量
+.sp
+This parameter is for handling a large database.
+.sp
+Groonga maps database files onto memory and accesses to them. Groonga
+doesn\(aqt maps unnecessary files onto memory until they are nneded.
+.sp
+If you access to all data in database, all database files are mapped
+onto memory.  If total size of your database files is 6GiB, your
+groonga process uses 6GiB memory.
+.sp
+Normally, your all database files aren\(aqt mapped onto memry. But is may
+be occurred. It is an example case that you dump your database.
+.sp
+You must have memory and swap that is larger than database.
+.SS Linux
+.sp
+このセクションではLinux上で引数をカスタマイズする方法について説明します。
+.SS nofile
+.sp
+You can relax the \fItuning\-max\-n\-open\-files\fP parameter by creating
+a configuration file \fB/etc/security/limits.d/groonga.conf\fP that has
+the following content:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+${USER} soft nofile ${MAX_VALUE}
+${USER} hard nofile ${MAX_VALUE}
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+If you run \fBgroonga\fP process by \fBgroonga\fP user and your groonga
+process needs to open less than 10000 files, use the following
+configuration:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+groonga soft nofile 10000
+groonga hard nofile 10000
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+The configuration is applied after your groonga service is restarted
+or re\-login as your groonga user.
+.SS vm.overcommit_memory
+.sp
+This is \fItuning\-memory\-usage\fP related parameter. You can handle a
+database that is larger than your memory and swap by setting
+\fBvm.overcommit_memory\fP kernel parameter to 1. 1 means that groonga
+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
+about \fBvm.overcommit_memory\fP parameter details.
+.sp
+You can set the configuration by putting a configuration file
+\fB/etc/sysctl.d/groonga.conf\fP that has the following content:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+vm.overcommit_memory = 1
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+設定した内容はシステムを再起動するか、次のコマンドを実行することで反映されます。:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% sudo sysctl \-p
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS vm.max_map_count
+.sp
+This is \fItuning\-memory\-usage\fP related parameter. You can handle a
+16GiB or more larger size database by increasing \fBvm.max_map_count\fP
+kernel parameter. The parameter limits the max number of memory maps.
+.sp
+The default value of the kernel parameter may be 65530 or 65536.
+Groonga maps 256KiB memory chunk at one time. If a database is larger
+than 16GiB, groonga reaches the limitation. (\fB256KiB * 65536 = 16GiB\fP)
+.sp
+You needs to increase the value of the kernel parameter to handle
+16GiB or more larger size database. For example, you can handle almost
+32GiB size database by \fB65536 * 2 = 131072\fP. You can set the
+configuration by putting a configuration file
+\fB/etc/sysctl.d/groonga.conf\fP that has the following content:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+vm.max_map_count = 131072
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Note that your real confiugration file will be the following because
+you already have \fBvm.overcommit_memory\fP configuration:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+vm.overcommit_memory = 1
+vm.max_map_count = 131072
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+設定した内容はシステムを再起動するか、次のコマンドを実行することで反映されます。:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+% sudo sysctl \-p
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.SS FreeBSD
+.sp
+このセクションではFreeBSD上で引数をカスタマイズする方法を説明します。
+.SS kern.maxfileperproc
+.sp
+TODO
 .SS API
 .sp
 groongaを全文検索ライブラリとして使うことができます。この節ではgroongaが提供しているAPIを示します。
@@ -28353,6 +29216,52 @@ TokenBigramIgnoreBlankSplitSymbolAlphaDigit: 記号・アルファベット・
 .UNINDENT
 .sp
 この場合も対策方法1同様、検索ノイズが上位に現れる可能性が高くなることに注意してください。検索ノイズが多くなった場合は指定する値を低くする必要があります。
+.SS mmap Cannot allocate memoryエラーを回避するには
+.SS 例
+.sp
+ログファイルに以下のようなmmapエラーが存在する場合があります。:
+.INDENT 0.0
+.INDENT 3.5
+2013\-06\-04 08:19:34.835218|A|4e86e700|mmap(4194304,551,432017408)=Cannot allocate memory <13036498944>
+.UNINDENT
+.UNINDENT
+.sp
+<13036498944> はこの場合mmapの合計サイズ(約12GB)です。
+.SS 対策方法
+.sp
+以下の観点を確認する必要があります。
+.INDENT 0.0
+.IP \(bu 2
+十分なメモリの空きが存在するか？
+.IP \(bu 2
+マッピング最大数を超過していないか？
+.UNINDENT
+.sp
+十分な空きメモリがあるかを調べるために、vmstat コマンドを使うことができます。
+.sp
+最大マッピング数を超過しているかどうかを確認するために、 vm.max_map_count の値を調べることができます。
+.sp
+もしこの問題が vm.max_map_count の値を調整することで解決するなら、これが原因です。
+.sp
+groongaはメモリを256KBごとに確保するので、扱えるデータベースのサイズを以下の式で見積ることができます:
+.INDENT 0.0
+.INDENT 3.5
+(database size) = vm.max_map_count * (memory chunks)
+.UNINDENT
+.UNINDENT
+.sp
+16GBを超えるデータベースを扱うには、少くとも65536を vm.max_map_count の値として設定しないといけません。
+.INDENT 0.0
+.INDENT 3.5
+database size (16GB) = vm.max_map_count (65536) * memory chunks (256KB)
+.UNINDENT
+.UNINDENT
+.sp
+sudo sysctl \-w vm.max_map_count=65536 で一時的に vm.max_map_count を調整することができます。
+.sp
+その後、設定値を /etc/sysctl.conf もしくは \fI/etc/sysctl.d/*.conf\fP へと保存します。
+.sp
+チューニング関連のパラメータについては、 \fB/reference/tuning\fP のドキュメントを参照してください。
 .SH 開発
 .sp
 このセクションではgroongaを使った開発について説明します。例えば、groongaをデータベースとして使ったアプリケーション、libgroongaを使ったライブラリ、libgroongaの言語バインディングなどを開発することがあるでしょう。
@@ -28595,6 +29504,8 @@ groongaのドキュメントは、Sphinxというツールを用いて作成さ
 .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)が必要となります。