RubyGems - rroonga - Versions diffs - 6.0.0-x86-mingw32 → 6.0.2-x86-mingw32 - Mend

rroonga 6.0.0-x86-mingw32 → 6.0.2-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 (710) hide show

data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-httpd.html CHANGED Viewed

@@ -3,11 +3,11 @@
   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="ja">
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>7.1.8. groonga-suggest-httpd &mdash; Groonga v5.1.2-250-gb1f40beドキュメント</title>
+    <title>7.1.8. groonga-suggest-httpd &mdash; Groonga v6.0.2ドキュメント</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:     '5.1.2-250-gb1f40be',
+        VERSION:     '6.0.2',
         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 v5.1.2-250-gb1f40beドキュメント" href="../../index.html" />
+    <link rel="top" title="Groonga v6.0.2ドキュメント" href="../../index.html" />
     <link rel="up" title="7.1. 実行ファイル" href="../executables.html" />
     <link rel="next" title="7.1.9. groonga-suggest-learner" href="groonga-suggest-learner.html" />
     <link rel="prev" title="7.1.7. groonga-suggest-create-dataset" href="groonga-suggest-create-dataset.html" />
@@ -61,7 +61,7 @@
         <li class="right" >
           <a href="groonga-suggest-create-dataset.html" title="7.1.7. groonga-suggest-create-dataset"
              accesskey="P">前へ</a> |</li>
-        <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v5.1.2-250-gb1f40beドキュメント</a> &raquo;</li>
+        <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v6.0.2ドキュメント</a> &raquo;</li>
           <li class="nav-item nav-item-1"><a href="../../reference.html" >7. リファレンスマニュアル</a> &raquo;</li>
           <li class="nav-item nav-item-2"><a href="../executables.html" accesskey="U">7.1. 実行ファイル</a> &raquo;</li>
       </ul>
@@ -73,124 +73,313 @@
           <div class="body" role="main">
   <div class="section" id="groonga-suggest-httpd">
-<h1>7.1.8. groonga-suggest-httpd<a class="headerlink" href="#groonga-suggest-httpd" title="このヘッドラインへのパーマリンク">¶</a></h1>
+<h1>7.1.8. <code class="docutils literal"><span class="pre">groonga-suggest-httpd</span></code><a class="headerlink" href="#groonga-suggest-httpd" title="このヘッドラインへのパーマリンク">¶</a></h1>
 <div class="section" id="summary">
 <h2>7.1.8.1. 概要<a class="headerlink" href="#summary" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<p>groonga-suggest-httpd is a program to provide interface which accepts HTTP request and returns suggestion dataset, then saves logs for learning.
-groonga-suggest-httpd behaves similar in point of view of suggestion functionality, but the name of parameter is different.</p>
+<p><code class="docutils literal"><span class="pre">groonga-suggest-httpd</span></code> は次の機能に対するHTTPインターフェイスを提供するプログラムです。</p>
+<blockquote>
+<div><ul class="simple">
+<li><p class="first"><a class="reference internal" href="../suggest.html"><span class="doc">サジェスト</span></a> を実行した結果を返す</p>
+</li>
+<li><p class="first">学習用にログを保存する</p>
+</li>
+</ul>
+</div></blockquote>
+<p><code class="docutils literal"><span class="pre">groonga-suggest-httpd</span></code> は <a class="reference internal" href="../commands/suggest.html"><span class="doc">suggest</span></a> コマンドのようなサジェスト機能を提供します。いくつかパラメーター名が異なることに注意してください。</p>
 </div>
-<div class="section" id="synopsis">
-<h2>7.1.8.2. 書式<a class="headerlink" href="#synopsis" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<div class="highlight-none"><div class="highlight"><pre><span></span>groonga-suggest-httpd [options] database_path
+<div class="section" id="syntax">
+<h2>7.1.8.2. 構文<a class="headerlink" href="#syntax" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p><code class="docutils literal"><span class="pre">groonga-suggest-httpd</span></code> にはデータベースのパスを指定します。:</p>
+<div class="highlight-none"><div class="highlight"><pre><span></span>groonga-suggest-httpd [options] DATABASE_PATH
 </pre></div>
 </div>
 </div>
 <div class="section" id="usage">
 <h2>7.1.8.3. 使い方<a class="headerlink" href="#usage" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<div class="section" id="set-up">
-<h3>7.1.8.3.1. 設定をする<a class="headerlink" href="#set-up" title="このヘッドラインへのパーマリンク">¶</a></h3>
-<p>最初に提案用のデータベースをセットアップする必要があります。</p>
+<p><code class="docutils literal"><span class="pre">groonga-suggest-httpd</span></code> を使う場合は1つ以上のデータセットを作る必要があります。データセットはテーブルとカラムの集まりです。これらのテーブル・カラムは <a class="reference internal" href="groonga-suggest-create-dataset.html"><span class="doc">groonga-suggest-create-dataset</span></a> で作成できます。</p>
+<p>ユーザーの入力からサジェスト用データを学習するには <a class="reference internal" href="groonga-suggest-learner.html"><span class="doc">groonga-suggest-learner</span></a> を使う必要があります。手動でサジェスト用データを作成する場合は <a class="reference internal" href="groonga-suggest-learner.html"><span class="doc">groonga-suggest-learner</span></a> を使う必要はありません。手動でサジェスト用データを作る方法については <a class="reference internal" href="../suggest.html"><span class="doc">サジェスト</span></a> とその関連ドキュメントを参照してください。</p>
+<p>1つ以上のデータセットを作ったらHTTP経由で <code class="docutils literal"><span class="pre">groonga-suggest-httpd</span></code> を使えます。</p>
+<p>つづくセクションでは次のことについて説明します。</p>
+<blockquote>
+<div><ul class="simple">
+<li><p class="first">データセットのセットアップ方法</p>
+</li>
+<li><p class="first"><a class="reference internal" href="groonga-suggest-learner.html"><span class="doc">groonga-suggest-learner</span></a> と一緒に <code class="docutils literal"><span class="pre">groonga-suggest-httpd</span></code> を使う方法</p>
+</li>
+<li><p class="first">サジェスト結果を取得するために <code class="docutils literal"><span class="pre">groonga-suggest-httpd</span></code> を使う方法</p>
+</li>
+</ul>
+</div></blockquote>
+<div class="section" id="setup">
+<h3>7.1.8.3.1. セットアップ<a class="headerlink" href="#setup" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p><a class="reference internal" href="groonga-suggest-create-dataset.html"><span class="doc">groonga-suggest-create-dataset</span></a> でデータセットを作ります。</p>
+<p>以下は <code class="docutils literal"><span class="pre">query</span></code> データセットを作る例です。</p>
+<p>実行例:</p>
+<div class="highlight-none"><div class="highlight"><pre><span></span>% groonga-suggest-create-dataset ${DB_PATH} query
+&gt; register suggest/suggest
+true
+&gt; table_create event_type TABLE_HASH_KEY ShortText
+true
+&gt; table_create bigram TABLE_PAT_KEY ShortText --default_tokenizer TokenBigram --normalizer NormalizerAuto
+true
+&gt; table_create kana TABLE_PAT_KEY ShortText --normalizer NormalizerAuto
+true
+&gt; table_create item_query TABLE_PAT_KEY ShortText --default_tokenizer TokenDelimit --normalizer NormalizerAuto
+true
+&gt; column_create bigram item_query_key COLUMN_INDEX|WITH_POSITION item_query _key
+true
+&gt; column_create item_query kana COLUMN_VECTOR kana
+true
+&gt; column_create kana item_query_kana COLUMN_INDEX item_query kana
+true
+&gt; column_create item_query freq COLUMN_SCALAR Int32
+true
+&gt; column_create item_query last COLUMN_SCALAR Time
+true
+&gt; column_create item_query boost COLUMN_SCALAR Int32
+true
+&gt; column_create item_query freq2 COLUMN_SCALAR Int32
+true
+&gt; column_create item_query buzz COLUMN_SCALAR Int32
+true
+&gt; table_create pair_query TABLE_HASH_KEY UInt64
+true
+&gt; column_create pair_query pre COLUMN_SCALAR item_query
+true
+&gt; column_create pair_query post COLUMN_SCALAR item_query
+true
+&gt; column_create pair_query freq0 COLUMN_SCALAR Int32
+true
+&gt; column_create pair_query freq1 COLUMN_SCALAR Int32
+true
+&gt; column_create pair_query freq2 COLUMN_SCALAR Int32
+true
+&gt; column_create item_query co COLUMN_INDEX pair_query pre
+true
+&gt; table_create sequence_query TABLE_HASH_KEY ShortText
+true
+&gt; table_create event_query TABLE_NO_KEY
+true
+&gt; column_create sequence_query events COLUMN_VECTOR|RING_BUFFER event_query
+true
+&gt; column_create event_query type COLUMN_SCALAR event_type
+true
+&gt; column_create event_query time COLUMN_SCALAR Time
+true
+&gt; column_create event_query item COLUMN_SCALAR item_query
+true
+&gt; column_create event_query sequence COLUMN_SCALAR sequence_query
+true
+&gt; table_create configuration TABLE_HASH_KEY ShortText
+true
+&gt; column_create configuration weight COLUMN_SCALAR UInt32
+true
+&gt; load --table configuration
+&gt; [
+&gt; {&quot;_key&quot;: &quot;query&quot;, &quot;weight&quot;: 1}
+&gt; ]
+1
+</pre></div>
+</div>
+<p><a class="reference internal" href="groonga-suggest-create-dataset.html"><span class="doc">groonga-suggest-create-dataset</span></a> は実行したコマンドを出力します。新しいデータセット用にどんなテーブル・カラムを作ったかを確認できます。</p>
+</div>
+<div class="section" id="launch-groonga-suggest-learner">
+<h3>7.1.8.3.2. <code class="docutils literal"><span class="pre">groonga-suggest-learner</span></code> を起動<a class="headerlink" href="#launch-groonga-suggest-learner" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p>学習したサジェストデータをすぐに使うかどうかを選択できます。</p>
+<p>学習したサジェストデータをすぐに使う方法は2つあります。</p>
+<blockquote>
+<div><ul class="simple">
+<li><p class="first"><code class="docutils literal"><span class="pre">groonga-suggest-httpd</span></code> と <a class="reference internal" href="groonga-suggest-learner.html"><span class="doc">groonga-suggest-learner</span></a> のどちらも同じデータベースを使う</p>
+</li>
+<li><p class="first"><code class="docutils literal"><span class="pre">groonga-suggest-httpd</span></code> が <a class="reference internal" href="groonga-suggest-learner.html"><span class="doc">groonga-suggest-learner</span></a> から学習したサジェストデータを受け取る</p>
+</li>
+</ul>
+</div></blockquote>
+<p>前者のケースでは、 <code class="docutils literal"><span class="pre">groonga-suggest-httpd</span></code> と <a class="reference internal" href="groonga-suggest-learner.html"><span class="doc">groonga-suggest-learner</span></a> を同じホスト上で実行しなければいけません。</p>
+<p>後者のケースでは、 <code class="docutils literal"><span class="pre">groonga-suggest-httpd</span></code> と <a class="reference internal" href="groonga-suggest-learner.html"><span class="doc">groonga-suggest-learner</span></a> を違うホストで動かせます。</p>
+<p>学習したサジェストデータをすぐに使う必要がないとき、 <a class="reference internal" href="groonga-suggest-learner.html"><span class="doc">groonga-suggest-learner</span></a> が使っているデータベースから <code class="docutils literal"><span class="pre">groonga-suggest-httpd</span></code> が使っているデータベースに学習したサジェストデータを主導で反映する必要があります。通常、こちらの使い方を推奨します。なぜなら学習したサジェストデータには悪意のあるユーザーが入力由来のゴミデータが含まれているかもしれないからです。</p>
+<p>このドキュメントでは <a class="reference internal" href="groonga-suggest-learner.html"><span class="doc">groonga-suggest-learner</span></a> から学習したサジェストデータを受け取り、学習したサジェストデータをすぐに使います。 <code class="docutils literal"><span class="pre">groonga-suggest-httpd</span></code> と <a class="reference internal" href="groonga-suggest-learner.html"><span class="doc">groonga-suggest-learner</span></a> はどちらも同じホストで動かします。これは説明しやすいからです。</p>
+<p>以下は <a class="reference internal" href="groonga-suggest-learner.html"><span class="doc">groonga-suggest-learner</span></a> を起動する例です。 <code class="docutils literal"><span class="pre">query</span></code> データセットがあるデータベースを指定します。このドキュメントでは <code class="docutils literal"><span class="pre">query</span></code> データセットを作る手順は省略します。</p>
 <p>実行例:</p>
-<div class="highlight-none"><div class="highlight"><pre><span></span>% groonga-suggest-create-dataset /tmp/groonga-databases/groonga-suggest-httpd query
+<div class="highlight-none"><div class="highlight"><pre><span></span>% groonga-suggest-learner --daemon ${DB_PATH}
 </pre></div>
 </div>
+<p><code class="docutils literal"><span class="pre">groonga-suggest-learner</span></code> プロセスは2つのエンドポイントを提供します。それぞれ <code class="docutils literal"><span class="pre">1234</span></code> 番ポートと <code class="docutils literal"><span class="pre">1235</span></code> 番ポートを使います。</p>
+<blockquote>
+<div><ul class="simple">
+<li><p class="first"><code class="docutils literal"><span class="pre">1234</span></code> 番ポート： <code class="docutils literal"><span class="pre">groogna-suggest-httpd</span></code> からユーザーの入力を受け付けるエンドポイント</p>
+</li>
+<li><p class="first"><code class="docutils literal"><span class="pre">1235</span></code> 番ポート： <code class="docutils literal"><span class="pre">groogna-suggest-httpd</span></code> に学習したサジェストデータを送信するエンドポイント</p>
+</li>
+</ul>
+</div></blockquote>
 </div>
 <div class="section" id="launch-groonga-suggest-httpd">
-<h3>7.1.8.3.2. Launch groonga-suggest-httpd<a class="headerlink" href="#launch-groonga-suggest-httpd" title="このヘッドラインへのパーマリンク">¶</a></h3>
-<p>Execute groonga-suggest-httpd command:</p>
+<h3>7.1.8.3.3. <code class="docutils literal"><span class="pre">groonga-suggest-httpd</span></code> を起動<a class="headerlink" href="#launch-groonga-suggest-httpd" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p>次の目的のため、 <code class="docutils literal"><span class="pre">groonga-suggest-httpd</span></code> を起動します。</p>
+<blockquote>
+<div><ul class="simple">
+<li><p class="first">ユーザーの入力からサジェストデータを学習するため</p>
+</li>
+<li><p class="first">サジェスト結果をクライアントに提供するため</p>
+</li>
+</ul>
+</div></blockquote>
+<p>以下は <a class="reference internal" href="groonga-suggest-learner.html"><span class="doc">groonga-suggest-learner</span></a> と通信する <code class="docutils literal"><span class="pre">groonga-suggest-httpd</span></code> を起動する例です。</p>
 <p>実行例:</p>
-<div class="highlight-none"><div class="highlight"><pre><span></span>% groonga-suggest-httpd /tmp/groonga-databases/groonga-suggest-httpd
+<div class="highlight-none"><div class="highlight"><pre><span></span>% groonga-suggest-httpd --send-endpoint &#39;tcp://127.0.0.1:1234&#39; --receive-endpoint &#39;tcp://127.0.0.1:1235&#39; --daemon ${DB_PATH}
+</pre></div>
+</div>
+<p><code class="docutils literal"><span class="pre">groonga-suggest-httpd</span></code> プロセスは <code class="docutils literal"><span class="pre">8080</span></code> 番ポートでHTTPリクエストを受け付けます。</p>
+<p>リクエストをログファイルに保存したい場合は <a class="reference internal" href="groonga-suggest-learner.html#cmdoption--log-base-path"><code class="xref std std-option docutils literal"><span class="pre">--log-base-path</span></code></a> オプションを指定してください。</p>
+<p>以下は各ログファイルに <code class="docutils literal"><span class="pre">log</span></code> というプレフィックスをつけて <code class="docutils literal"><span class="pre">logs</span></code> ディレクトリーに保存する例です。:</p>
+<div class="highlight-none"><div class="highlight"><pre><span></span>% groonga-suggest-httpd --log-base-path logs/log ${DB_PATH}
+</pre></div>
+</div>
+<p><code class="docutils literal"><span class="pre">groonga-suggest-httpd</span></code> は <code class="docutils literal"><span class="pre">logYYYYmmddHHMMSS-00</span></code> という名前のログファイルを作成し、 <code class="docutils literal"><span class="pre">logs</span></code> ディレクトリー以下に保存します。</p>
+</div>
+<div class="section" id="learn-from-user-inputs">
+<h3>7.1.8.3.4. ユーザーの入力から学習<a class="headerlink" href="#learn-from-user-inputs" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p>ユーザーの入力からサジェストデータを学習できます。</p>
+<p>サジェストデータを学習するには次のパラメーターを指定する必要があります。</p>
+<blockquote>
+<div><ul class="simple">
+<li><code class="docutils literal"><span class="pre">i</span></code>: The ID of the user (You may use IP address of client)</li>
+<li><p class="first"><code class="docutils literal"><span class="pre">l</span></code> ：データセット名</p>
+</li>
+<li><p class="first"><code class="docutils literal"><span class="pre">s</span></code> ：入力のタイムスタンプ。単位は秒。</p>
+</li>
+<li><p class="first"><code class="docutils literal"><span class="pre">t</span></code> ：クエリーの種類。（省略可能。ユーザーの入力がサブミットされたときだけ <code class="docutils literal"><span class="pre">submit</span></code> を指定します。）</p>
+</li>
+<li><p class="first"><code class="docutils literal"><span class="pre">q</span></code> ：ユーザーの入力</p>
+</li>
+</ul>
+</div></blockquote>
+<p>以下は``query`` データセットで「Groonga」というユーザーの入力を学習するリクエスト例です。</p>
+<div class="highlight-none"><div class="highlight"><pre><span></span>.. groonga-command
+.. include:: ../../example/reference/executables/groonga-suggest-httpd/learn.log
+.. % curl &#39;http://localhost:8080/?i=127.0.0.1&amp;l=query&amp;s=92619&amp;q=G&#39;
+.. % curl &#39;http://localhost:8080/?i=127.0.0.1&amp;l=query&amp;s=93850&amp;q=Gr&#39;
+.. % curl &#39;http://localhost:8080/?i=127.0.0.1&amp;l=query&amp;s=94293&amp;q=Gro&#39;
+.. % curl &#39;http://localhost:8080/?i=127.0.0.1&amp;l=query&amp;s=94734&amp;q=Groo&#39;
+.. % curl &#39;http://localhost:8080/?i=127.0.0.1&amp;l=query&amp;s=95147&amp;q=Grooon&#39;
+.. % curl &#39;http://localhost:8080/?i=127.0.0.1&amp;l=query&amp;s=95553&amp;q=Groonga&#39;
+.. % curl &#39;http://localhost:8080/?i=127.0.0.1&amp;l=query&amp;s=95959&amp;t=submit&amp;q=Groonga&#39;
 </pre></div>
 </div>
-<p>After executing above command, groonga-suggest-httpd accepts HTTP request on 8080 port.</p>
-<p>If you just want to save requests into log file, use <code class="docutils literal"><span class="pre">-l</span></code> option.</p>
-<p>Here is the example to save log files under <code class="docutils literal"><span class="pre">logs</span></code> directory with <code class="docutils literal"><span class="pre">log</span></code> prefix for each file.:</p>
-<div class="highlight-none"><div class="highlight"><pre><span></span>% groonga-suggest-httpd -l logs/log /tmp/groonga-databases/groonga-suggest-httpd
+<p>入力中のデータに <code class="docutils literal"><span class="pre">t=submit</span></code> パラメーターをつけてはいけません。上の例では、ユーザーの入力を学習しているだけですが、ユーザーの入力を学習しながら同時に補完候補を取得することもできます。これは次のセクションで説明します。</p>
+<p>サブミットされたデータには <code class="docutils literal"><span class="pre">t=submit</span></code> パラメーターをつけます。</p>
+</div>
+<div class="section" id="use-suggested-response">
+<h3>7.1.8.3.5. サジェスト結果を使う<a class="headerlink" href="#use-suggested-response" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p><code class="docutils literal"><span class="pre">groonga-suggest-httpd</span></code> からのサジェスト結果を使えます。</p>
+<p>サジェスト結果を取得するには次のパラメーターを指定します。</p>
+<blockquote>
+<div><ul class="simple">
+<li><p class="first"><code class="docutils literal"><span class="pre">n</span></code> ：データセット名</p>
+</li>
+<li><p class="first"><code class="docutils literal"><span class="pre">t</span></code> ：クエリーの種類（ <code class="docutils literal"><span class="pre">complete</span></code> 、 <code class="docutils literal"><span class="pre">correct</span></code> 、 <code class="docutils literal"><span class="pre">suggest</span></code> のどれか。複数指定も可。）</p>
+</li>
+<li><p class="first"><code class="docutils literal"><span class="pre">q</span></code> ：ユーザーの入力</p>
+</li>
+</ul>
+</div></blockquote>
+<p><a class="reference internal" href="../commands/suggest.html"><span class="doc">suggest</span></a> のパラメーターを指定することもできます。</p>
+<p>以下は <a class="reference internal" href="../suggest/completion.html"><span class="doc">補完</span></a> 結果を取得する例です。この結果は前のセクションで学習したデータを使って計算しています。 <code class="docutils literal"><span class="pre">frequency_threshold=1</span></code> パラメーターを使っているのはこれが例だからです。このパラメーターは1回以上出現した入力データも有効なデータとします。通常、プロダクション環境ではこのパラメーターを指定するべきではありません。ノイズが増える可能性が高いからです。</p>
+<p>実行例:</p>
+<div class="highlight-none"><div class="highlight"><pre><span></span>% curl &#39;http://localhost:8080/?n=query&amp;t=complete&amp;q=G&amp;frequency_threshold=1&#39;
+{&quot;complete&quot;:[[6],[[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;_score&quot;,&quot;Int32&quot;]],[&quot;groonga&quot;,3],[&quot;g&quot;,2],[&quot;grooon&quot;,2],[&quot;gro&quot;,2],[&quot;groo&quot;,2],[&quot;gr&quot;,2]]}
 </pre></div>
 </div>
-<p>Under <code class="docutils literal"><span class="pre">logs</span></code> directory, log files such as <code class="docutils literal"><span class="pre">logYYYYmmddHHMMSS-00</span></code> are created.</p>
-</div>
-<div class="section" id="request-to-groonga-suggest-httpd">
-<h3>7.1.8.3.3. Request to groonga-suggest-httpd<a class="headerlink" href="#request-to-groonga-suggest-httpd" title="このヘッドラインへのパーマリンク">¶</a></h3>
-<p>Here is the sample requests to learn <code class="docutils literal"><span class="pre">groonga</span></code> for <code class="docutils literal"><span class="pre">query</span></code> dataset:</p>
-<div class="highlight-none"><div class="highlight"><pre><span></span>% curl &#39;http://localhost:8080/?i=127.0.0.1&amp;l=query&amp;s=92619&amp;t=complete&amp;q=g&#39;
-% curl &#39;http://localhost:8080/?i=127.0.0.1&amp;l=query&amp;s=93850&amp;t=complete&amp;q=gr&#39;
-% curl &#39;http://localhost:8080/?i=127.0.0.1&amp;l=query&amp;s=94293&amp;t=complete&amp;q=gro&#39;
-% curl &#39;http://localhost:8080/?i=127.0.0.1&amp;l=query&amp;s=94734&amp;t=complete&amp;q=groo&#39;
-% curl &#39;http://localhost:8080/?i=127.0.0.1&amp;l=query&amp;s=95147&amp;t=complete&amp;q=grooon&#39;
-% curl &#39;http://localhost:8080/?i=127.0.0.1&amp;l=query&amp;s=95553&amp;t=complete&amp;q=groonga&#39;
-% curl &#39;http://localhost:8080/?i=127.0.0.1&amp;l=query&amp;s=95959&amp;t=submit&amp;q=groonga
+<p>補完用と学習用のどちらのパラメーターも指定することで補完と学習を組み合わせることができます。</p>
+<p>実行例:</p>
+<div class="highlight-none"><div class="highlight"><pre><span></span>% curl &#39;http://localhost:8080/?i=127.0.0.1&amp;l=query&amp;s=93000&amp;q=G&amp;n=query&amp;t=complete&amp;frequency_threshold=1&#39;
+{&quot;complete&quot;:[[6],[[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;_score&quot;,&quot;Int32&quot;]],[&quot;groonga&quot;,3],[&quot;g&quot;,2],[&quot;grooon&quot;,2],[&quot;gro&quot;,2],[&quot;groo&quot;,2],[&quot;gr&quot;,2]]}
 </pre></div>
 </div>
 </div>
 </div>
-<div class="section" id="options">
-<h2>7.1.8.4. Options<a class="headerlink" href="#options" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<dl class="cmdoption">
+<div class="section" id="command-line-parameters">
+<h2>7.1.8.4. コマンドライン引数<a class="headerlink" href="#command-line-parameters" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<div class="section" id="required-parameters">
+<h3>7.1.8.4.1. 必須引数<a class="headerlink" href="#required-parameters" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p>必須の引数が1つあります。</p>
+<div class="section" id="database-path">
+<h4>7.1.8.4.1.1. <code class="docutils literal"><span class="pre">DATABASE_PATH</span></code><a class="headerlink" href="#database-path" title="このヘッドラインへのパーマリンク">¶</a></h4>
+<p>Groongaのデータベースのパスを指定します。このデータベースには1つ以上のデータセットを作っておいてください。各データセットは <a class="reference internal" href="groonga-suggest-create-dataset.html"><span class="doc">groonga-suggest-create-dataset</span></a> で作ります。</p>
+</div>
+</div>
+<div class="section" id="optional-parameters">
+<h3>7.1.8.4.2. 省略可能引数<a class="headerlink" href="#optional-parameters" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<dl class="option">
 <dt id="cmdoption-p">
 <span id="cmdoption--port"></span><code class="descname">-p</code><code class="descclassname"></code><code class="descclassname">, </code><code class="descname">--port</code><code class="descclassname"></code><a class="headerlink" href="#cmdoption-p" title="この定義へのパーマリンク">¶</a></dt>
-<dd><p>Specify http server port number. The default value is 8080.</p>
+<dd><p>HTTPサーバーのポート番号を指定します。</p>
+<p>デフォルトのポート番号は <code class="docutils literal"><span class="pre">8080</span></code> です。</p>
 </dd></dl>
-<dl class="cmdoption">
+<dl class="option">
 <dt id="cmdoption-t">
 <span id="cmdoption--n-threads"></span><code class="descname">-t</code><code class="descclassname"></code><code class="descclassname">, </code><code class="descname">--n-threads</code><code class="descclassname"></code><a class="headerlink" href="#cmdoption-t" title="この定義へのパーマリンク">¶</a></dt>
-<dd><p>Specify number of threads. The default value is 8.
-This option accepts 128 as the max value, but use the number of CPU cores for
-performance.</p>
+<dd><p>最大スレッド数を指定します。</p>
+<p>最大で128を指定できますが、パフォーマンスを出すためには最大でもCPUコア数を指定する方がよいです。</p>
+<p>デフォルトはコア数です。</p>
 </dd></dl>
-<dl class="cmdoption">
+<dl class="option">
 <dt id="cmdoption-s">
 <span id="cmdoption--send-endpoint"></span><code class="descname">-s</code><code class="descclassname"></code><code class="descclassname">, </code><code class="descname">--send-endpoint</code><code class="descclassname"></code><a class="headerlink" href="#cmdoption-s" title="この定義へのパーマリンク">¶</a></dt>
-<dd><p>Specify endpoint for sender.</p>
+<dd><p>ユーザーの入力送信先になる <a class="reference internal" href="groonga-suggest-learner.html"><span class="doc">groonga-suggest-learner</span></a> のエンドポイントURIを指定します。</p>
+<p>フォーマットは <code class="docutils literal"><span class="pre">tcp://${HOST}:${PORT}</span></code> です。たとえば、 <code class="docutils literal"><span class="pre">tcp://192.168.0.1:2929</span></code> のように指定します。</p>
+<p>デフォルト値はありません。</p>
 </dd></dl>
-<dl class="cmdoption">
+<dl class="option">
 <dt id="cmdoption-r">
 <span id="cmdoption--receive-endpoint"></span><code class="descname">-r</code><code class="descclassname"></code><code class="descclassname">, </code><code class="descname">--receive-endpoint</code><code class="descclassname"></code><a class="headerlink" href="#cmdoption-r" title="この定義へのパーマリンク">¶</a></dt>
-<dd><p>Specify endpoint for receiver.</p>
+<dd><p>ログ受信時に使用するアドレスを指定します。</p>
+<p>フォーマットは <code class="docutils literal"><span class="pre">tcp://${HOST}:${PORT}</span></code> です。たとえば、 <code class="docutils literal"><span class="pre">tcp://192.168.0.1:2929</span></code> のように指定します。</p>
+<p>デフォルト値はありません。</p>
 </dd></dl>
-<dl class="cmdoption">
+<dl class="option">
 <dt id="cmdoption-l">
 <span id="cmdoption--log-base-path"></span><code class="descname">-l</code><code class="descclassname"></code><code class="descclassname">, </code><code class="descname">--log-base-path</code><code class="descclassname"></code><a class="headerlink" href="#cmdoption-l" title="この定義へのパーマリンク">¶</a></dt>
-<dd><p>Specify path prefix of log.</p>
+<dd><p>ログのパス名のプレフィックスを指定します。</p>
+<p>デフォルト値はありません。</p>
 </dd></dl>
-<dl class="cmdoption">
+<dl class="option">
 <dt id="cmdoption--n-lines-per-log-file">
 <code class="descname">--n-lines-per-log-file</code><code class="descclassname"></code><a class="headerlink" href="#cmdoption--n-lines-per-log-file" title="この定義へのパーマリンク">¶</a></dt>
-<dd><p>Specify the number of lines in a log file. The default value is 1,000,000.</p>
+<dd><p>1つのログファイルの最大行数を指定します。</p>
+<p>デフォルトは <code class="docutils literal"><span class="pre">1000000</span></code> （100万行）です。</p>
 </dd></dl>
-<dl class="cmdoption">
+<dl class="option">
 <dt id="cmdoption-d">
 <span id="cmdoption--daemon"></span><code class="descname">-d</code><code class="descclassname"></code><code class="descclassname">, </code><code class="descname">--daemon</code><code class="descclassname"></code><a class="headerlink" href="#cmdoption-d" title="この定義へのパーマリンク">¶</a></dt>
-<dd><p>Specify this option to daemonize.</p>
+<dd><p>デーモン化する場合に指定します。</p>
+<p>デフォルトではデーモン化しません。</p>
 </dd></dl>
-<dl class="cmdoption">
+<dl class="option">
 <dt id="cmdoption--disable-max-fd-check">
 <code class="descname">--disable-max-fd-check</code><code class="descclassname"></code><a class="headerlink" href="#cmdoption--disable-max-fd-check" title="この定義へのパーマリンク">¶</a></dt>
-<dd><p>Specify this option to disable checking max fd on start.</p>
+<dd><p>起動時の最大ファイルディスクリプター数のチェックを無効化する場合に指定します。</p>
+<p>デフォルトはチェックします。</p>
 </dd></dl>
-</div>
-<div class="section" id="command-line-parameters">
-<h2>7.1.8.5. コマンドライン引数<a class="headerlink" href="#command-line-parameters" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<p><code class="docutils literal"><span class="pre">database_path</span></code> だけが必須の引数です。</p>
-<div class="section" id="database-path">
-<h3>7.1.8.5.1. <code class="docutils literal"><span class="pre">database_path</span></code><a class="headerlink" href="#database-path" title="このヘッドラインへのパーマリンク">¶</a></h3>
-<p>Specifies the path to a Groonga database. This database must be created by <a class="reference internal" href="groonga-suggest-create-dataset.html"><em>groonga-suggest-create-dataset</em></a> command because it executes required initialization for suggestion.</p>
 </div>
 </div>
 <div class="section" id="get-parameters">
-<h2>7.1.8.6. GETの引数<a class="headerlink" href="#get-parameters" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<p>groonga-suggest-httpd accepts following GET parameters.</p>
+<h2>7.1.8.5. GETの引数<a class="headerlink" href="#get-parameters" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p><code class="docutils literal"><span class="pre">groonga-suggest-httpd</span></code> GETパラメーターを受け付けます。</p>
 <p>必須の引数があります。どれが必須かはクエリーの種類に依存します。</p>
-<div class="section" id="required-parameters">
-<h3>7.1.8.6.1. 必須引数<a class="headerlink" href="#required-parameters" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p>クエリーの種類が <code class="docutils literal"><span class="pre">complete</span></code> 、 <code class="docutils literal"><span class="pre">correct</span></code> 、 <code class="docutils literal"><span class="pre">suggest</span></code> のどれかのときは、道のパラメーターは <a class="reference internal" href="../commands/suggest.html"><span class="doc">suggest</span></a> にそのまま渡します。つまり、 <a class="reference internal" href="../commands/suggest.html"><span class="doc">suggest</span></a> のパラメーターを使うことができます。</p>
+<div class="section" id="groonga-suggest-httpd-required-parameters">
+<span id="id1"></span><h3>7.1.8.5.1. 必須引数<a class="headerlink" href="#groonga-suggest-httpd-required-parameters" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p>次のパラメーターを指定する必要があります。</p>
 <table border="1" class="docutils">
 <colgroup>
 <col width="33%" />
@@ -202,23 +391,22 @@ performance.</p>
 </th>
 <th class="head"><p class="first last">説明</p>
 </th>
-<th class="head">Note</th>
+<th class="head"><p class="first last">備考</p>
+</th>
 </tr>
 </thead>
 <tbody valign="top">
-<tr class="row-even"><td>q</td>
-<td>UTF-8 encoded string which user fills in form</td>
-<td>&nbsp;</td>
-</tr>
-<tr class="row-odd"><td>t</td>
-<td>The type of query. The value of type must be complete, correct, suggest or submit. It also accepts multiple type of query which is concatinated by <code class="docutils literal"><span class="pre">|</span></code>. Note that <code class="docutils literal"><span class="pre">submit</span></code> is invalid value when you specify multiple type of query.</td>
+<tr class="row-even"><td><code class="docutils literal"><span class="pre">q</span></code></td>
+<td><p class="first last">ユーザーの入力。UTF-8でエンコードされた文字列です。</p>
+</td>
 <td>&nbsp;</td>
 </tr>
 </tbody>
 </table>
 </div>
 <div class="section" id="required-parameters-for-learning">
-<h3>7.1.8.6.2. 学習時に必須の引数<a class="headerlink" href="#required-parameters-for-learning" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<span id="groonga-suggest-httpd-required-parameters-learning"></span><h3>7.1.8.5.2. 学習時に必須の引数<a class="headerlink" href="#required-parameters-for-learning" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p><a class="reference internal" href="groonga-suggest-learner.html#cmdoption--send-endpoint"><code class="xref std std-option docutils literal"><span class="pre">--send-endpoint</span></code></a> を指定したときは次のパラメーターを指定しなければいけません。</p>
 <table border="1" class="docutils">
 <colgroup>
 <col width="33%" />
@@ -230,27 +418,70 @@ performance.</p>
 </th>
 <th class="head"><p class="first last">説明</p>
 </th>
-<th class="head">Note</th>
+<th class="head"><p class="first last">備考</p>
+</th>
 </tr>
 </thead>
 <tbody valign="top">
-<tr class="row-even"><td>s</td>
-<td>Elapsed time from 0:00 January 1, 1970</td>
-<td>Note that you need specify the value of <code class="docutils literal"><span class="pre">s</span></code> in milliseconds</td>
+<tr class="row-even"><td><code class="docutils literal"><span class="pre">s</span></code></td>
+<td><p class="first last"><code class="docutils literal"><span class="pre">1970-01-01T00:00:00Z</span></code> から経過時間。</p>
+</td>
+<td><p class="first last">単位はミリ秒。</p>
+</td>
 </tr>
-<tr class="row-odd"><td>i</td>
-<td>Unique ID to distinct user</td>
-<td>Use session ID or IP address for example</td>
+<tr class="row-odd"><td><code class="docutils literal"><span class="pre">i</span></code></td>
+<td><p class="first last">各ユーザーを識別するユニークなID。</p>
+</td>
+<td><p class="first last">セッションID、IPアドレスなどを使うことができるでしょう。</p>
+</td>
 </tr>
-<tr class="row-even"><td>l</td>
-<td>Specify the name of dataset for learning. It also accepts multiple dataset name which is concatinated by <code class="docutils literal"><span class="pre">|</span></code></td>
-<td>Note that dataset name must be matched to following regular expression <code class="docutils literal"><span class="pre">[A-Za-z</span> <span class="pre">][A-Za-z0-9</span> <span class="pre">]{0,15}</span></code></td>
+<tr class="row-even"><td><code class="docutils literal"><span class="pre">l</span></code></td>
+<td><p class="first last">1つ以上の学習対象のデータセット名。複数のデータセットを指定する場合は <code class="docutils literal"><span class="pre">dataset1|dataset2|dataset3</span></code> のように区切り文字として <code class="docutils literal"><span class="pre">|</span></code> を使います。</p>
+</td>
+<td><p class="first last">データセット名は <a class="reference internal" href="groonga-suggest-create-dataset.html"><span class="doc">groonga-suggest-create-dataset</span></a> で指定した名前です。</p>
+</td>
 </tr>
 </tbody>
 </table>
 </div>
 <div class="section" id="required-parameters-for-suggestion">
-<h3>7.1.8.6.3. 提案時に必須の引数<a class="headerlink" href="#required-parameters-for-suggestion" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<span id="groonga-suggest-httpd-required-parameters-suggestion"></span><h3>7.1.8.5.3. サジェスト時に必須の引数<a class="headerlink" href="#required-parameters-for-suggestion" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p><code class="docutils literal"><span class="pre">t</span></code> パラメータに <code class="docutils literal"><span class="pre">complete</span></code> 、 <code class="docutils literal"><span class="pre">correct</span></code> 、 <code class="docutils literal"><span class="pre">suggest</span></code> のどれかを指定したときは次のパラメーターを指定する必要があります。</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="33%" />
+<col width="33%" />
+<col width="33%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head"><p class="first last">キー</p>
+</th>
+<th class="head"><p class="first last">説明</p>
+</th>
+<th class="head"><p class="first last">備考</p>
+</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td><code class="docutils literal"><span class="pre">n</span></code></td>
+<td><p class="first last">サジェスト結果を計算するときに使うデータセット名。</p>
+</td>
+<td><p class="first last">データセット名は <a class="reference internal" href="groonga-suggest-create-dataset.html"><span class="doc">groonga-suggest-create-dataset</span></a> で指定した名前です。</p>
+</td>
+</tr>
+<tr class="row-odd"><td><code class="docutils literal"><span class="pre">t</span></code></td>
+<td><p class="first">クエリーの種類。</p>
+<p class="last"><code class="docutils literal"><span class="pre">complete</span></code> 、 <code class="docutils literal"><span class="pre">correct</span></code> 、 <code class="docutils literal"><span class="pre">suggest</span></code> のどれか。</p>
+</td>
+<td><p class="first last">複数の種類を指定することもできます。複数指定するときは <code class="docutils literal"><span class="pre">complete|correct</span></code> のように <code class="docutils literal"><span class="pre">|</span></code> で区切ってください。</p>
+</td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="section" id="groonga-suggest-httpd-optional-parameters">
+<span id="id2"></span><h3>7.1.8.5.4. 省略可能引数<a class="headerlink" href="#groonga-suggest-httpd-optional-parameters" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p>いくつか省略可能な引数があります。</p>
 <table border="1" class="docutils">
 <colgroup>
 <col width="33%" />
@@ -262,20 +493,22 @@ performance.</p>
 </th>
 <th class="head"><p class="first last">説明</p>
 </th>
-<th class="head">Note</th>
+<th class="head"><p class="first last">備考</p>
+</th>
 </tr>
 </thead>
 <tbody valign="top">
-<tr class="row-even"><td>n</td>
-<td><p class="first last">提案用のデータベース名を指定します。</p>
+<tr class="row-even"><td><code class="docutils literal"><span class="pre">callback</span></code></td>
+<td><p class="first last">JSONPの関数名</p>
 </td>
-<td>This dataset name is used to calculate suggestion results</td>
+<td>&nbsp;</td>
 </tr>
 </tbody>
 </table>
 </div>
-<div class="section" id="optional-parameter">
-<h3>7.1.8.6.4. 省略可能引数<a class="headerlink" href="#optional-parameter" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<div class="section" id="optional-parameters-for-learning">
+<span id="groonga-suggest-httpd-optional-parameters-learning"></span><h3>7.1.8.5.5. 学習時に指定可能な引数<a class="headerlink" href="#optional-parameters-for-learning" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p><a class="reference internal" href="groonga-suggest-learner.html#cmdoption--send-endpoint"><code class="xref std std-option docutils literal"><span class="pre">--send-endpoint</span></code></a> オプションを指定したときに指定可能なパラメーターは次の通りです。</p>
 <table border="1" class="docutils">
 <colgroup>
 <col width="33%" />
@@ -287,39 +520,67 @@ performance.</p>
 </th>
 <th class="head"><p class="first last">説明</p>
 </th>
-<th class="head">Note</th>
+<th class="head"><p class="first last">備考</p>
+</th>
 </tr>
 </thead>
 <tbody valign="top">
-<tr class="row-even"><td>callback</td>
-<td>Specify the name of function if you prefer JSONP as response format</td>
-<td>The name of function must be matched to reqular expression <code class="docutils literal"><span class="pre">[A-Za-z</span> <span class="pre">][A-Za-z0-9</span> <span class="pre">]{0,15}</span></code></td>
+<tr class="row-even"><td><code class="docutils literal"><span class="pre">t</span></code></td>
+<td><p class="first">クエリーの種類。</p>
+<p class="last">指定可能な値は <code class="docutils literal"><span class="pre">submit</span></code> だけです。</p>
+</td>
+<td><p class="first">ユーザーが <code class="docutils literal"><span class="pre">q</span></code> で指定した入力をサブミットしたときは <code class="docutils literal"><span class="pre">submit</span></code> を指定してください。</p>
+<p class="last">まだサブミットされていないユーザーの入力を指定するときは <code class="docutils literal"><span class="pre">submit</span></code> を指定しないでください。 <code class="docutils literal"><span class="pre">submit</span></code> を指定していないときに <code class="docutils literal"><span class="pre">t</span></code> に <code class="docutils literal"><span class="pre">complete</span></code> 、 <code class="docutils literal"><span class="pre">correct</span></code> 、 <code class="docutils literal"><span class="pre">suggest</span></code> のうち1つ以上を指定するとサジェスト結果を使えます。これらの <code class="docutils literal"><span class="pre">t</span></code> に指定する値については <a class="reference internal" href="#groonga-suggest-httpd-required-parameters-suggestion"><span class="std std-ref">サジェスト時に必須の引数</span></a> を参照してください。</p>
+</td>
 </tr>
 </tbody>
 </table>
 </div>
 </div>
 <div class="section" id="return-value">
-<h2>7.1.8.7. 戻り値<a class="headerlink" href="#return-value" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<p><code class="docutils literal"><span class="pre">groonga-suggest-httpd</span></code> command returns following response in JSON or JSONP format.</p>
-<p>JSON形式:</p>
-<div class="highlight-none"><div class="highlight"><pre><span></span>{TYPE: [[CANDIDATE_1, SCORE_1], [CANDIDATE_2, SCORE_2], ... [CANDIDATE_N, SCORE_N]]}
+<h2>7.1.8.6. 戻り値<a class="headerlink" href="#return-value" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p><code class="docutils literal"><span class="pre">groonga-suggest-httpd</span></code> のレスポンスは次のフォーマットになります。 <a class="reference internal" href="../commands/suggest.html"><span class="doc">suggest</span></a> のボディ部分と同じです。:</p>
+<div class="highlight-none"><div class="highlight"><pre><span></span>{
+  TYPE1: [
+    [CANDIDATE_1, SCORE_1],
+    [CANDIDATE_2, SCORE_2],
+    ...,
+    [CANDIDATE_N, SCORE_N]
+  ],
+  TYPE2: [
+    [CANDIDATE_1, SCORE_1],
+    [CANDIDATE_2, SCORE_2],
+    ...,
+    [CANDIDATE_N, SCORE_N]
+  ],
+  ...
+}
 </pre></div>
 </div>
-<p>JSONP形式:</p>
-<div class="highlight-none"><div class="highlight"><pre><span></span>FUNCTION({TYPE: [[CANDIDATE_1, SCORE_1], [CANDIDATE_2, SCORE_2], ... [CANDIDATE_N, SCORE_N]]})
+<p><code class="docutils literal"><span class="pre">t</span></code> に <code class="docutils literal"><span class="pre">submit</span></code> を指定したときのレスポンスは次の通りです。:</p>
+<div class="highlight-none"><div class="highlight"><pre><span></span>{}
 </pre></div>
 </div>
-<p><code class="docutils literal"><span class="pre">TYPE</span></code></p>
-<blockquote>
-<div><p><code class="docutils literal"><span class="pre">complete</span></code> 、 <code class="docutils literal"><span class="pre">correct</span></code> 、 <code class="docutils literal"><span class="pre">suggest</span></code> のどれか。</p>
-</div></blockquote>
-<p><code class="docutils literal"><span class="pre">CANDIDATE_N</span></code></p>
-<blockquote>
-<div>The string of candidate (UTF-8).</div></blockquote>
-<p><code class="docutils literal"><span class="pre">SCORE_N</span></code></p>
+<div class="section" id="type">
+<h3>7.1.8.6.1. <code class="docutils literal"><span class="pre">TYPE</span></code><a class="headerlink" href="#type" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p><code class="docutils literal"><span class="pre">complete</span></code> 、 <code class="docutils literal"><span class="pre">correct</span></code> 、 <code class="docutils literal"><span class="pre">suggest</span></code> のどれか。</p>
+</div>
+<div class="section" id="candidate-n">
+<h3>7.1.8.6.2. <code class="docutils literal"><span class="pre">CANDIDATE_N</span></code><a class="headerlink" href="#candidate-n" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p>UTF-8でエンコードされた候補文字列。</p>
+</div>
+<div class="section" id="score-n">
+<h3>7.1.8.6.3. <code class="docutils literal"><span class="pre">SCORE_N</span></code><a class="headerlink" href="#score-n" title="このヘッドラインへのパーマリンク">¶</a></h3>
+<p>候補のスコアー。</p>
+<p>スコアーの降順でソートされた候補リスト。</p>
+</div>
+</div>
+<div class="section" id="see-also">
+<h2>7.1.8.7. 参考<a class="headerlink" href="#see-also" title="このヘッドラインへのパーマリンク">¶</a></h2>
 <blockquote>
-<div><p>スコア。</p>
+<div><ul class="simple">
+<li><a class="reference internal" href="../commands/suggest.html"><span class="doc">suggest</span></a></li>
+</ul>
 </div></blockquote>
 </div>
 </div>
@@ -332,28 +593,40 @@ performance.</p>
         <div class="sphinxsidebarwrapper">
   <h3><a href="../../index.html">目次</a></h3>
   <ul>
-<li><a class="reference internal" href="#">7.1.8. groonga-suggest-httpd</a><ul>
+<li><a class="reference internal" href="#">7.1.8. <code class="docutils literal"><span class="pre">groonga-suggest-httpd</span></code></a><ul>
 <li><a class="reference internal" href="#summary">7.1.8.1. 概要</a></li>
-<li><a class="reference internal" href="#synopsis">7.1.8.2. 書式</a></li>
+<li><a class="reference internal" href="#syntax">7.1.8.2. 構文</a></li>
 <li><a class="reference internal" href="#usage">7.1.8.3. 使い方</a><ul>
-<li><a class="reference internal" href="#set-up">7.1.8.3.1. 設定をする</a></li>
-<li><a class="reference internal" href="#launch-groonga-suggest-httpd">7.1.8.3.2. Launch groonga-suggest-httpd</a></li>
-<li><a class="reference internal" href="#request-to-groonga-suggest-httpd">7.1.8.3.3. Request to groonga-suggest-httpd</a></li>
+<li><a class="reference internal" href="#setup">7.1.8.3.1. セットアップ</a></li>
+<li><a class="reference internal" href="#launch-groonga-suggest-learner">7.1.8.3.2. <code class="docutils literal"><span class="pre">groonga-suggest-learner</span></code> を起動</a></li>
+<li><a class="reference internal" href="#launch-groonga-suggest-httpd">7.1.8.3.3. <code class="docutils literal"><span class="pre">groonga-suggest-httpd</span></code> を起動</a></li>
+<li><a class="reference internal" href="#learn-from-user-inputs">7.1.8.3.4. ユーザーの入力から学習</a></li>
+<li><a class="reference internal" href="#use-suggested-response">7.1.8.3.5. サジェスト結果を使う</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#command-line-parameters">7.1.8.4. コマンドライン引数</a><ul>
+<li><a class="reference internal" href="#required-parameters">7.1.8.4.1. 必須引数</a><ul>
+<li><a class="reference internal" href="#database-path">7.1.8.4.1.1. <code class="docutils literal"><span class="pre">DATABASE_PATH</span></code></a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#optional-parameters">7.1.8.4.2. 省略可能引数</a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#options">7.1.8.4. Options</a></li>
-<li><a class="reference internal" href="#command-line-parameters">7.1.8.5. コマンドライン引数</a><ul>
-<li><a class="reference internal" href="#database-path">7.1.8.5.1. <code class="docutils literal"><span class="pre">database_path</span></code></a></li>
+<li><a class="reference internal" href="#get-parameters">7.1.8.5. GETの引数</a><ul>
+<li><a class="reference internal" href="#groonga-suggest-httpd-required-parameters">7.1.8.5.1. 必須引数</a></li>
+<li><a class="reference internal" href="#required-parameters-for-learning">7.1.8.5.2. 学習時に必須の引数</a></li>
+<li><a class="reference internal" href="#required-parameters-for-suggestion">7.1.8.5.3. サジェスト時に必須の引数</a></li>
+<li><a class="reference internal" href="#groonga-suggest-httpd-optional-parameters">7.1.8.5.4. 省略可能引数</a></li>
+<li><a class="reference internal" href="#optional-parameters-for-learning">7.1.8.5.5. 学習時に指定可能な引数</a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#get-parameters">7.1.8.6. GETの引数</a><ul>
-<li><a class="reference internal" href="#required-parameters">7.1.8.6.1. 必須引数</a></li>
-<li><a class="reference internal" href="#required-parameters-for-learning">7.1.8.6.2. 学習時に必須の引数</a></li>
-<li><a class="reference internal" href="#required-parameters-for-suggestion">7.1.8.6.3. 提案時に必須の引数</a></li>
-<li><a class="reference internal" href="#optional-parameter">7.1.8.6.4. 省略可能引数</a></li>
+<li><a class="reference internal" href="#return-value">7.1.8.6. 戻り値</a><ul>
+<li><a class="reference internal" href="#type">7.1.8.6.1. <code class="docutils literal"><span class="pre">TYPE</span></code></a></li>
+<li><a class="reference internal" href="#candidate-n">7.1.8.6.2. <code class="docutils literal"><span class="pre">CANDIDATE_N</span></code></a></li>
+<li><a class="reference internal" href="#score-n">7.1.8.6.3. <code class="docutils literal"><span class="pre">SCORE_N</span></code></a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#return-value">7.1.8.7. 戻り値</a></li>
+<li><a class="reference internal" href="#see-also">7.1.8.7. 参考</a></li>
 </ul>
 </li>
 </ul>
@@ -379,9 +652,6 @@ performance.</p>
       <input type="hidden" name="check_keywords" value="yes" />
       <input type="hidden" name="area" value="default" />
     </form>
-    <p class="searchtip" style="font-size: 90%">
-    モジュール、クラス、または関数名を入力してください
-    </p>
 </div>
 <script type="text/javascript">$('#searchbox').show(0);</script>
         </div>
@@ -400,7 +670,7 @@ performance.</p>
         <li class="right" >
           <a href="groonga-suggest-create-dataset.html" title="7.1.7. groonga-suggest-create-dataset"
              >前へ</a> |</li>
-        <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v5.1.2-250-gb1f40beドキュメント</a> &raquo;</li>
+        <li class="nav-item nav-item-0"><a href="../../index.html">Groonga v6.0.2ドキュメント</a> &raquo;</li>
           <li class="nav-item nav-item-1"><a href="../../reference.html" >7. リファレンスマニュアル</a> &raquo;</li>
           <li class="nav-item nav-item-2"><a href="../executables.html" >7.1. 実行ファイル</a> &raquo;</li>
       </ul>