RubyGems - rroonga - Versions diffs - 1.2.5-x86-mingw32 → 1.2.7-x86-mingw32 - Mend

rroonga 1.2.5-x86-mingw32 → 1.2.7-x86-mingw32

Files changed (300) hide show

data/vendor/local/share/doc/groonga/en/html/spec/search.html CHANGED Viewed

@@ -9,7 +9,7 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>6.1. 検索 &mdash; groonga v1.2.4 documentation</title>
+    <title>7.1. 検索 &mdash; groonga v1.2.5 documentation</title>
     <link rel="stylesheet" href="../_static/groonga.css" type="text/css" />
     <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
@@ -17,7 +17,7 @@
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '../',
-        VERSION:     '1.2.4',
+        VERSION:     '1.2.5',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
@@ -27,10 +27,10 @@
     <script type="text/javascript" src="../_static/underscore.js"></script>
     <script type="text/javascript" src="../_static/doctools.js"></script>
     <link rel="shortcut icon" href="../_static/favicon.ico"/>
-    <link rel="top" title="groonga v1.2.4 documentation" href="../index.html" />
-    <link rel="up" title="6. 仕様" href="../spec.html" />
-    <link rel="next" title="7. 制限事項" href="../limitations.html" />
-    <link rel="prev" title="6. 仕様" href="../spec.html" />
+    <link rel="top" title="groonga v1.2.5 documentation" href="../index.html" />
+    <link rel="up" title="7. 仕様" href="../spec.html" />
+    <link rel="next" title="8. 制限事項" href="../limitations.html" />
+    <link rel="prev" title="7. 仕様" href="../spec.html" />
   </head>
   <body>
 <div class="header">
@@ -57,13 +57,13 @@
           <a href="../genindex.html" title="General Index"
              accesskey="I">index</a></li>
         <li class="right" >
-          <a href="../limitations.html" title="7. 制限事項"
+          <a href="../limitations.html" title="8. 制限事項"
              accesskey="N">next</a> |</li>
         <li class="right" >
-          <a href="../spec.html" title="6. 仕様"
+          <a href="../spec.html" title="7. 仕様"
              accesskey="P">previous</a> |</li>
-        <li><a href="../index.html">groonga v1.2.4 documentation</a> &raquo;</li>
-          <li><a href="../spec.html" accesskey="U">6. 仕様</a> &raquo;</li>
+        <li><a href="../index.html">groonga v1.2.5 documentation</a> &raquo;</li>
+          <li><a href="../spec.html" accesskey="U">7. 仕様</a> &raquo;</li>
       </ul>
     </div>
@@ -73,10 +73,10 @@
           <div class="body">
   <div class="section" id="id1">
-<h1>6.1. 検索<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h1>
+<h1>7.1. 検索<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h1>
 <p><a class="reference internal" href="../commands/select.html"><em>select</em></a> コマンドがqueryパラメータを使ってどのように検索するのかを説明します。</p>
 <div class="section" id="id2">
-<h2>6.1.1. 検索の挙動<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2>
+<h2>7.1.1. 検索の挙動<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h2>
 <p>検索の挙動には以下の3種類あり、検索結果によって動的に使い分けています。</p>
 <ol class="arabic simple">
 <li>完全一致検索</li>
@@ -85,7 +85,7 @@
 </ol>
 <p>どのように検索の挙動を使い分けているかを説明する前に、まず、それぞれの検索の挙動を説明します。</p>
 <div class="section" id="id3">
-<h3>6.1.1.1. 完全一致検索<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h3>
+<h3>7.1.1.1. 完全一致検索<a class="headerlink" href="#id3" title="Permalink to this headline">¶</a></h3>
 <p>検索対象文書は複数の語彙にトークナイズ(分割)され、それぞれを単位とした語彙表に索引を管理します。
 検索キーワードも同一の方法でトークナイズされます。</p>
 <p>このとき、検索キーワードをトークナイズした結果得られる語彙の配列と同一の配列を含む文書を検索する処理を完全一致検索と呼んでいます。</p>
@@ -119,7 +119,7 @@
 <p>という三つの語彙として処理されます。この語彙の並びは「楽し / しい / いb / bi / il / ll / li / ia / ar / rd / d」という語彙の並びに含まれるので、完全一致でヒットします。</p>
 </div>
 <div class="section" id="id4">
-<h3>6.1.1.2. 非わかち書き検索<a class="headerlink" href="#id4" title="Permalink to this headline">¶</a></h3>
+<h3>7.1.1.2. 非わかち書き検索<a class="headerlink" href="#id4" title="Permalink to this headline">¶</a></h3>
 <p>非わかち書き検索はパトリシア木で語彙表を構築している場合のみ利用可能です。</p>
 <p>非わかち書き検索の挙動はTokenBigramなどN-gram系のトークナイザーを利用している場合とTokenMecabトークナイザーを利用している場合で挙動が変わります。</p>
 <p>N-gram系のトークナイザーを利用している場合はキーワードで前方一致検索をします。</p>
@@ -128,7 +128,7 @@
 <p>例えば、「スープカレー」というキーワードで検索した場合、「スープカレーバー」（1単語扱い）にヒットしますが、「スープカレー」（&quot;スープ&quot;と&quot;カレー&quot;の2単語扱い）や「スープカレーライス」（&quot;スープ&quot;と&quot;カレーライス&quot;の2単語扱い）にはヒットしません。</p>
 </div>
 <div class="section" id="id5">
-<h3>6.1.1.3. 部分一致検索<a class="headerlink" href="#id5" title="Permalink to this headline">¶</a></h3>
+<h3>7.1.1.3. 部分一致検索<a class="headerlink" href="#id5" title="Permalink to this headline">¶</a></h3>
 <p>部分一致検索はパトリシア木で語彙表を構築していて、かつ、KEY_WITH_SISオプションを指定している場合のみ利用可能です。KEY_WITH_SISオプションが指定されていない場合は非わかち書き検索と同等です。</p>
 <p>部分一致検索の挙動はTokenBigramなどN-gram系のトークナイザーを利用している場合とTokenMecabトークナイザーを利用している場合で挙動が変わります。</p>
 <p>Bigramの場合は前方一致検索と中間一致検索と後方一致検索を行います。</p>
@@ -138,7 +138,7 @@
 </div>
 </div>
 <div class="section" id="id6">
-<h2>6.1.2. 検索の使い分け<a class="headerlink" href="#id6" title="Permalink to this headline">¶</a></h2>
+<h2>7.1.2. 検索の使い分け<a class="headerlink" href="#id6" title="Permalink to this headline">¶</a></h2>
 <p>groongaは基本的に完全一致検索のみを行います。完全一致検索でのヒット件数が所定の閾値を超えない場合に限り、非わかち書き検索を行い、それでもヒット件数が閾値を超えない場合は部分一致検索を行います。(閾値は1がデフォルト値となっています)</p>
 <p>ただし、すでに検索結果セットが存在する場合はたとえヒット件数が閾値に満たなくても完全一致検索のみを行います。</p>
 <p>例えば、以下のようなクエリの場合は、それぞれの検索でヒット件数が閾値に満たない場合は完全一致検索、非わかち書き検索、部分一致検索を順に行います。:</p>
@@ -161,24 +161,24 @@
         <div class="sphinxsidebarwrapper">
   <h3><a href="../index.html">Table Of Contents</a></h3>
   <ul>
-<li><a class="reference internal" href="#">6.1. 検索</a><ul>
-<li><a class="reference internal" href="#id2">6.1.1. 検索の挙動</a><ul>
-<li><a class="reference internal" href="#id3">6.1.1.1. 完全一致検索</a></li>
-<li><a class="reference internal" href="#id4">6.1.1.2. 非わかち書き検索</a></li>
-<li><a class="reference internal" href="#id5">6.1.1.3. 部分一致検索</a></li>
+<li><a class="reference internal" href="#">7.1. 検索</a><ul>
+<li><a class="reference internal" href="#id2">7.1.1. 検索の挙動</a><ul>
+<li><a class="reference internal" href="#id3">7.1.1.1. 完全一致検索</a></li>
+<li><a class="reference internal" href="#id4">7.1.1.2. 非わかち書き検索</a></li>
+<li><a class="reference internal" href="#id5">7.1.1.3. 部分一致検索</a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#id6">6.1.2. 検索の使い分け</a></li>
+<li><a class="reference internal" href="#id6">7.1.2. 検索の使い分け</a></li>
 </ul>
 </li>
 </ul>
   <h4>Previous topic</h4>
   <p class="topless"><a href="../spec.html"
-                        title="previous chapter">6. 仕様</a></p>
+                        title="previous chapter">7. 仕様</a></p>
   <h4>Next topic</h4>
   <p class="topless"><a href="../limitations.html"
-                        title="next chapter">7. 制限事項</a></p>
+                        title="next chapter">8. 制限事項</a></p>
   <h3>This Page</h3>
   <ul class="this-page-menu">
     <li><a href="../_sources/spec/search.txt"
@@ -208,13 +208,13 @@
           <a href="../genindex.html" title="General Index"
              >index</a></li>
         <li class="right" >
-          <a href="../limitations.html" title="7. 制限事項"
+          <a href="../limitations.html" title="8. 制限事項"
              >next</a> |</li>
         <li class="right" >
-          <a href="../spec.html" title="6. 仕様"
+          <a href="../spec.html" title="7. 仕様"
              >previous</a> |</li>
-        <li><a href="../index.html">groonga v1.2.4 documentation</a> &raquo;</li>
-          <li><a href="../spec.html" >6. 仕様</a> &raquo;</li>
+        <li><a href="../index.html">groonga v1.2.5 documentation</a> &raquo;</li>
+          <li><a href="../spec.html" >7. 仕様</a> &raquo;</li>
       </ul>
     </div>
     <div class="footer">

data/vendor/local/share/doc/groonga/en/html/spec.html CHANGED Viewed

@@ -9,7 +9,7 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>6. 仕様 &mdash; groonga v1.2.4 documentation</title>
+    <title>7. 仕様 &mdash; groonga v1.2.5 documentation</title>
     <link rel="stylesheet" href="_static/groonga.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
@@ -17,7 +17,7 @@
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '',
-        VERSION:     '1.2.4',
+        VERSION:     '1.2.5',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
@@ -27,9 +27,9 @@
     <script type="text/javascript" src="_static/underscore.js"></script>
     <script type="text/javascript" src="_static/doctools.js"></script>
     <link rel="shortcut icon" href="_static/favicon.ico"/>
-    <link rel="top" title="groonga v1.2.4 documentation" href="index.html" />
-    <link rel="next" title="6.1. 検索" href="spec/search.html" />
-    <link rel="prev" title="5.7. Log" href="log.html" />
+    <link rel="top" title="groonga v1.2.5 documentation" href="index.html" />
+    <link rel="next" title="7.1. 検索" href="spec/search.html" />
+    <link rel="prev" title="6.7. Log" href="log.html" />
   </head>
   <body>
 <div class="header">
@@ -56,12 +56,12 @@
           <a href="genindex.html" title="General Index"
              accesskey="I">index</a></li>
         <li class="right" >
-          <a href="spec/search.html" title="6.1. 検索"
+          <a href="spec/search.html" title="7.1. 検索"
              accesskey="N">next</a> |</li>
         <li class="right" >
-          <a href="log.html" title="5.7. Log"
+          <a href="log.html" title="6.7. Log"
              accesskey="P">previous</a> |</li>
-        <li><a href="index.html">groonga v1.2.4 documentation</a> &raquo;</li>
+        <li><a href="index.html">groonga v1.2.5 documentation</a> &raquo;</li>
       </ul>
     </div>
@@ -71,10 +71,10 @@
           <div class="body">
   <div class="section" id="id1">
-<h1>6. 仕様<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h1>
+<h1>7. 仕様<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h1>
 <div class="toctree-wrapper compound">
 <ul>
-<li class="toctree-l1"><a class="reference internal" href="spec/search.html">6.1. 検索</a></li>
+<li class="toctree-l1"><a class="reference internal" href="spec/search.html">7.1. 検索</a></li>
 </ul>
 </div>
 </div>
@@ -87,10 +87,10 @@
         <div class="sphinxsidebarwrapper">
   <h4>Previous topic</h4>
   <p class="topless"><a href="log.html"
-                        title="previous chapter">5.7. Log</a></p>
+                        title="previous chapter">6.7. Log</a></p>
   <h4>Next topic</h4>
   <p class="topless"><a href="spec/search.html"
-                        title="next chapter">6.1. 検索</a></p>
+                        title="next chapter">7.1. 検索</a></p>
   <h3>This Page</h3>
   <ul class="this-page-menu">
     <li><a href="_sources/spec.txt"
@@ -120,12 +120,12 @@
           <a href="genindex.html" title="General Index"
              >index</a></li>
         <li class="right" >
-          <a href="spec/search.html" title="6.1. 検索"
+          <a href="spec/search.html" title="7.1. 検索"
              >next</a> |</li>
         <li class="right" >
-          <a href="log.html" title="5.7. Log"
+          <a href="log.html" title="6.7. Log"
              >previous</a> |</li>
-        <li><a href="index.html">groonga v1.2.4 documentation</a> &raquo;</li>
+        <li><a href="index.html">groonga v1.2.5 documentation</a> &raquo;</li>
       </ul>
     </div>
     <div class="footer">

data/vendor/local/share/doc/groonga/en/html/suggest/completion.html ADDED Viewed

@@ -0,0 +1,357 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+    <title>5.3. Completion &mdash; groonga v1.2.5 documentation</title>
+    <link rel="stylesheet" href="../_static/groonga.css" type="text/css" />
+    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
+    <script type="text/javascript">
+      var DOCUMENTATION_OPTIONS = {
+        URL_ROOT:    '../',
+        VERSION:     '1.2.5',
+        COLLAPSE_INDEX: false,
+        FILE_SUFFIX: '.html',
+        HAS_SOURCE:  true
+      };
+    </script>
+    <script type="text/javascript" src="../_static/jquery.js"></script>
+    <script type="text/javascript" src="../_static/underscore.js"></script>
+    <script type="text/javascript" src="../_static/doctools.js"></script>
+    <link rel="shortcut icon" href="../_static/favicon.ico"/>
+    <link rel="top" title="groonga v1.2.5 documentation" href="../index.html" />
+    <link rel="up" title="5. Suggest" href="../suggest.html" />
+    <link rel="next" title="5.4. Correction" href="correction.html" />
+    <link rel="prev" title="5.2. Tutorial" href="tutorial.html" />
+  </head>
+  <body>
+<div class="header">
+  <h1 class="title">
+    <a id="top-link" href="../index.html">
+      <span class="project">groonga</span>
+      <span class="separator">-</span>
+      <span class="description">An open-source fulltext search engine and column store.</span>
+    </a>
+  </h1>
+  <div class="other-language-links">
+    <ul>
+      <li><a href="../../../ja/html/suggest/completion.html"><img src="../_static/jp.png" alt="日本語"></a></li>
+    </ul>
+  </div>
+</div>
+    <div class="related">
+      <h3>Navigation</h3>
+      <ul>
+        <li class="right" style="margin-right: 10px">
+          <a href="../genindex.html" title="General Index"
+             accesskey="I">index</a></li>
+        <li class="right" >
+          <a href="correction.html" title="5.4. Correction"
+             accesskey="N">next</a> |</li>
+        <li class="right" >
+          <a href="tutorial.html" title="5.2. Tutorial"
+             accesskey="P">previous</a> |</li>
+        <li><a href="../index.html">groonga v1.2.5 documentation</a> &raquo;</li>
+          <li><a href="../suggest.html" accesskey="U">5. Suggest</a> &raquo;</li>
+      </ul>
+    </div>
+    <div class="document">
+      <div class="documentwrapper">
+        <div class="bodywrapper">
+          <div class="body">
+  <div class="section" id="completion">
+<h1>5.3. Completion<a class="headerlink" href="#completion" title="Permalink to this headline">¶</a></h1>
+<p>This section describes about the following completion
+features:</p>
+<ul class="simple">
+<li>How it works</li>
+<li>How to use</li>
+<li>How to learn</li>
+</ul>
+<div class="section" id="how-it-works">
+<h2>5.3.1. How it works<a class="headerlink" href="#how-it-works" title="Permalink to this headline">¶</a></h2>
+<p>The completion feature uses three searches to compute
+completed words:</p>
+<blockquote>
+<div><ol class="arabic simple">
+<li>Prefix RK search against registered words.</li>
+<li>Cooccurrence search against learned data.</li>
+<li>Prefix search against registered words. (optional)</li>
+</ol>
+</div></blockquote>
+<div class="section" id="prefix-rk-search">
+<h3>5.3.1.1. Prefix RK search<a class="headerlink" href="#prefix-rk-search" title="Permalink to this headline">¶</a></h3>
+<p>RK means Romaji and Katakana. Prefix RK search can find
+registered words that start with user's input by romaji,
+katakana or hiragana. It's useful for searching in Japanese.</p>
+<p>For example, there is a registered word &quot;日本&quot;. And &quot;ニホン&quot;
+(it must be katakana) is registered as its reading. An user
+can find &quot;日本&quot; by &quot;ni&quot;, &quot;二&quot; or &quot;に&quot;.</p>
+</div>
+<div class="section" id="cooccurrence-search">
+<h3>5.3.1.2. Cooccurrence search<a class="headerlink" href="#cooccurrence-search" title="Permalink to this headline">¶</a></h3>
+<p>Cooccurrence search can find registered words from user's
+partial input. It uses user input sequences that will be
+learned from query logs, access logs and so on.</p>
+<p>For example, there is the following user input sequence:</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="50%" />
+<col width="50%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">input</th>
+<th class="head">submit</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td>s</td>
+<td>no</td>
+</tr>
+<tr class="row-odd"><td>se</td>
+<td>no</td>
+</tr>
+<tr class="row-even"><td>sea</td>
+<td>no</td>
+</tr>
+<tr class="row-odd"><td>sear</td>
+<td>no</td>
+</tr>
+<tr class="row-even"><td>searc</td>
+<td>no</td>
+</tr>
+<tr class="row-odd"><td>search</td>
+<td>yes</td>
+</tr>
+<tr class="row-even"><td>e</td>
+<td>no</td>
+</tr>
+<tr class="row-odd"><td>en</td>
+<td>no</td>
+</tr>
+<tr class="row-even"><td>eng</td>
+<td>no</td>
+</tr>
+<tr class="row-odd"><td>engi</td>
+<td>no</td>
+</tr>
+<tr class="row-even"><td>engin</td>
+<td>no</td>
+</tr>
+<tr class="row-odd"><td>engine</td>
+<td>no</td>
+</tr>
+<tr class="row-even"><td>enginen</td>
+<td>no (typo!)</td>
+</tr>
+<tr class="row-odd"><td>engine</td>
+<td>yes</td>
+</tr>
+</tbody>
+</table>
+<p>Groonga creates the following completion pairs:</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="33%" />
+<col width="67%" />
+</colgroup>
+<thead valign="bottom">
+<tr class="row-odd"><th class="head">input</th>
+<th class="head">completed word</th>
+</tr>
+</thead>
+<tbody valign="top">
+<tr class="row-even"><td>s</td>
+<td>search</td>
+</tr>
+<tr class="row-odd"><td>se</td>
+<td>search</td>
+</tr>
+<tr class="row-even"><td>sea</td>
+<td>search</td>
+</tr>
+<tr class="row-odd"><td>sear</td>
+<td>search</td>
+</tr>
+<tr class="row-even"><td>searc</td>
+<td>search</td>
+</tr>
+<tr class="row-odd"><td>e</td>
+<td>engine</td>
+</tr>
+<tr class="row-even"><td>en</td>
+<td>engine</td>
+</tr>
+<tr class="row-odd"><td>eng</td>
+<td>engine</td>
+</tr>
+<tr class="row-even"><td>engi</td>
+<td>engine</td>
+</tr>
+<tr class="row-odd"><td>engin</td>
+<td>engine</td>
+</tr>
+<tr class="row-even"><td>engine</td>
+<td>engine</td>
+</tr>
+<tr class="row-odd"><td>enginen</td>
+<td>engine</td>
+</tr>
+</tbody>
+</table>
+<p>All user not-submitted inputs (e.g. &quot;s&quot;, &quot;se&quot; and so on)
+before each an user submission maps to the submitted input
+(e.g. &quot;search&quot;).</p>
+<p>To be precise, this description isn't correct because it
+omits about time stamp. Groonga doesn't case about &quot;all user
+not-submitted inputs before each an user
+submission&quot;. Groonga just case about &quot;all user not-submitted
+inputs within a minute from an user submission before each
+an user submission&quot;. Groonga doesn't treat user inputs
+before a minute ago.</p>
+<p>If an user inputs &quot;sea&quot; and cooccurrence search returns
+&quot;search&quot; because &quot;sea&quot; is in input column and corresponding
+completed word column value is &quot;search&quot;.</p>
+</div>
+<div class="section" id="prefix-search">
+<h3>5.3.1.3. Prefix search<a class="headerlink" href="#prefix-search" title="Permalink to this headline">¶</a></h3>
+<p>Prefix search can find registered word that start with
+user's input. This search doesn't care about romaji,
+katakana and hiragana not like Prefix RK search.</p>
+<p>This search isn't always ran. It's just ran when it's
+requested explicitly or both prefix RK search and
+cooccurrence search return nothing.</p>
+<p>For example, there is a registered word &quot;search&quot;. An user
+can find &quot;search&quot; by &quot;s&quot;, &quot;se&quot;, &quot;sea&quot;, &quot;sear&quot;, &quot;searc&quot; and
+&quot;search&quot;.</p>
+</div>
+</div>
+<div class="section" id="how-to-use">
+<h2>5.3.2. How to use<a class="headerlink" href="#how-to-use" title="Permalink to this headline">¶</a></h2>
+<p>Groonga provides <a class="reference internal" href="../commands/suggest.html"><em>suggest</em></a> command to use
+completion. <cite>--type complete</cite> option requests completion.</p>
+<p>For example, here is an command to get completion results by
+&quot;en&quot;:</p>
+<p>Execution example:</p>
+<div class="highlight-none"><div class="highlight"><pre>&gt; suggest --table item_query --column kana --types complete --threshold 1 --query en
+[[0,1313131879.64588,0.000913584],{&quot;complete&quot;:[[1],[[&quot;_key&quot;,&quot;ShortText&quot;],[&quot;_score&quot;,&quot;Int32&quot;]],[&quot;engine&quot;,1]]}]
+</pre></div>
+</div>
+</div>
+<div class="section" id="how-it-learns">
+<h2>5.3.3. How it learns<a class="headerlink" href="#how-it-learns" title="Permalink to this headline">¶</a></h2>
+<p>Cooccurrence search uses learned data. They are based on
+query logs, access logs and so on. To create learned data,
+groonga needs user input sequence with time stamp and user
+submit input with time stamp.</p>
+<p>For example, an user wants to search by &quot;engine&quot;. The user
+inputs the query with the following sequence:</p>
+<blockquote>
+<div><ol class="arabic simple">
+<li>2011-08-10T13:33:23+09:00: e</li>
+<li>2011-08-10T13:33:23+09:00: en</li>
+<li>2011-08-10T13:33:24+09:00: eng</li>
+<li>2011-08-10T13:33:24+09:00: engi</li>
+<li>2011-08-10T13:33:24+09:00: engin</li>
+<li>2011-08-10T13:33:25+09:00: engine (submit!)</li>
+</ol>
+</div></blockquote>
+<p>Groonga can be learned from the input sequence by the
+following command:</p>
+<div class="highlight-none"><div class="highlight"><pre>load --table event_query --each &#39;suggest_preparer(_id, type, item, sequence, time, pair_query)&#39;
+[
+{&quot;sequence&quot;: &quot;1&quot;, &quot;time&quot;: 1312950803.86057, &quot;item&quot;: &quot;e&quot;},
+{&quot;sequence&quot;: &quot;1&quot;, &quot;time&quot;: 1312950803.96857, &quot;item&quot;: &quot;en&quot;},
+{&quot;sequence&quot;: &quot;1&quot;, &quot;time&quot;: 1312950804.26057, &quot;item&quot;: &quot;eng&quot;},
+{&quot;sequence&quot;: &quot;1&quot;, &quot;time&quot;: 1312950804.56057, &quot;item&quot;: &quot;engi&quot;},
+{&quot;sequence&quot;: &quot;1&quot;, &quot;time&quot;: 1312950804.76057, &quot;item&quot;: &quot;engin&quot;},
+{&quot;sequence&quot;: &quot;1&quot;, &quot;time&quot;: 1312950805.86057, &quot;item&quot;: &quot;engine&quot;, &quot;type&quot;: &quot;submit&quot;}
+]
+</pre></div>
+</div>
+</div>
+</div>
+          </div>
+        </div>
+      </div>
+      <div class="sphinxsidebar">
+        <div class="sphinxsidebarwrapper">
+  <h3><a href="../index.html">Table Of Contents</a></h3>
+  <ul>
+<li><a class="reference internal" href="#">5.3. Completion</a><ul>
+<li><a class="reference internal" href="#how-it-works">5.3.1. How it works</a><ul>
+<li><a class="reference internal" href="#prefix-rk-search">5.3.1.1. Prefix RK search</a></li>
+<li><a class="reference internal" href="#cooccurrence-search">5.3.1.2. Cooccurrence search</a></li>
+<li><a class="reference internal" href="#prefix-search">5.3.1.3. Prefix search</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#how-to-use">5.3.2. How to use</a></li>
+<li><a class="reference internal" href="#how-it-learns">5.3.3. How it learns</a></li>
+</ul>
+</li>
+</ul>
+  <h4>Previous topic</h4>
+  <p class="topless"><a href="tutorial.html"
+                        title="previous chapter">5.2. Tutorial</a></p>
+  <h4>Next topic</h4>
+  <p class="topless"><a href="correction.html"
+                        title="next chapter">5.4. Correction</a></p>
+  <h3>This Page</h3>
+  <ul class="this-page-menu">
+    <li><a href="../_sources/suggest/completion.txt"
+           rel="nofollow">Show Source</a></li>
+  </ul>
+<div id="searchbox" style="display: none">
+  <h3>Quick search</h3>
+    <form class="search" action="../search.html" method="get">
+      <input type="text" name="q" size="18" />
+      <input type="submit" value="Go" />
+      <input type="hidden" name="check_keywords" value="yes" />
+      <input type="hidden" name="area" value="default" />
+    </form>
+    <p class="searchtip" style="font-size: 90%">
+    Enter search terms or a module, class or function name.
+    </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+        </div>
+      </div>
+      <div class="clearer"></div>
+    </div>
+    <div class="related">
+      <h3>Navigation</h3>
+      <ul>
+        <li class="right" style="margin-right: 10px">
+          <a href="../genindex.html" title="General Index"
+             >index</a></li>
+        <li class="right" >
+          <a href="correction.html" title="5.4. Correction"
+             >next</a> |</li>
+        <li class="right" >
+          <a href="tutorial.html" title="5.2. Tutorial"
+             >previous</a> |</li>
+        <li><a href="../index.html">groonga v1.2.5 documentation</a> &raquo;</li>
+          <li><a href="../suggest.html" >5. Suggest</a> &raquo;</li>
+      </ul>
+    </div>
+    <div class="footer">
+        &copy; Copyright 2009-2011, Brazil, Inc.
+    </div>
+  </body>
+</html>