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

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>