rroonga 4.0.1-x64-mingw32 → 4.0.2-x64-mingw32

data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/normalizer_list.txt

@@ -0,0 +1,65 @@
+.. -*- rst -*-
+
+.. highlightlang:: none
+
+.. groonga-command
+.. database: commands_normalizer_list
+
+``normalizer_list``
+===================
+
+Summary
+-------
+
+``normalizer_list`` command lists normalizers in a database.
+
+
+Syntax
+------
+
+``normalizer_list`` command takes no parameter.
+::
+
+  normalizer_list
+
+Usage
+-----
+
+Here is a simple example.
+
+.. groonga-command
+.. include:: ../../example/reference/commands/normalizer_list/simple_example.log
+.. normalizer_list
+
+It returns normalizers in a database.
+
+Return value
+------------
+
+``normalizer_list`` command returns normalizers. Each normalizers has an attribute
+that contains the name. The attribute will be increased in the feature::
+
+  [HEADER, normalizer]
+
+``HEADER``
+
+  See :doc:`/reference/command/output_format` about ``HEADER``.
+
+``normalizer``
+
+  ``normalizer`` is an array of normalizer. Normalizer is an object that has the following
+  attributes.
+
+  .. list-table::
+     :header-rows: 1
+
+     * - Name
+       - Description
+     * - ``name``
+       - Normalizer name.
+
+See also
+--------
+
+* :doc:`/reference/normalizers`
+* :doc:`/reference/commands/normalize`

data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/select.txt

@@ -34,7 +34,7 @@ Syntax
          [limit=10]
          [drilldown=null]
          [drilldown_sortby=null]
-         [drilldown_output_columns=null]
+         [drilldown_output_columns="_key, _nsubrecs"]
          [drilldown_offset=0]
          [drilldown_limit=10]
          [cache=yes]
@@ -667,7 +667,7 @@ The ``select`` command just outputs ``_id`` and ``_key`` column
 values.
 
 ``*`` is a special value. It means that all columns that are not
-:doc:`/reference/pseudo_column`.
+:doc:`/reference/columns/pseudo`.
 
 Here is a ``*`` usage example.
 

data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/tokenizer_list.txt

@@ -0,0 +1,65 @@
+.. -*- rst -*-
+
+.. highlightlang:: none
+
+.. groonga-command
+.. database: commands_tokenizer_list
+
+``tokenizer_list``
+==================
+
+Summary
+-------
+
+``tokenizer_list`` command lists tokenizers in a database.
+
+
+Syntax
+------
+
+``tokenizer_list`` command takes no parameter.
+::
+
+  tokenizer_list
+
+Usage
+-----
+
+Here is a simple example.
+
+.. groonga-command
+.. include:: ../../example/reference/commands/tokenizer_list/simple_example.log
+.. tokenizer_list
+
+It returns tokenizers in a database.
+
+Return value
+------------
+
+``tokenizer_list`` command returns tokenizers. Each tokenizers has an attribute
+that contains the name. The attribute will be increased in the feature::
+
+  [HEADER, tokenizer]
+
+``HEADER``
+
+  See :doc:`/reference/command/output_format` about ``HEADER``.
+
+``tokenizer``
+
+  ``tokenizer`` is an array of tokenizer. Tokenizer is an object that has the following
+  attributes.
+
+  .. list-table::
+     :header-rows: 1
+
+     * - Name
+       - Description
+     * - ``name``
+       - Tokenizer name.
+
+See also
+--------
+
+* :doc:`/reference/tokenizers`
+* :doc:`/reference/commands/tokenize`

data/vendor/local/share/doc/groonga/ja/html/_sources/reference/executables/groonga-suggest-httpd.txt

@@ -45,10 +45,26 @@ Execute groonga-suggest-httpd command:
 
 After executing above command, groonga-suggest-httpd accepts HTTP request on 8080 port.
 
+If you just want to save requests into log file, use ``-l`` option.
+
+Here is the example to save log files under ``logs`` directory with ``log`` prefix for each file.::
+
+  % groonga-suggest-httpd -l logs/log /tmp/groonga-databases/groonga-suggest-httpd
+
+Under ``logs`` directory, log files such as ``logYYYYmmddHHMMSS-00`` are created.
+
 Request to groonga-suggest-httpd
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-TODO
+Here is the sample requests to learn ``groonga`` for ``query`` dataset::
+
+  % curl 'http://localhost:8080/?i=127.0.0.1&l=query&s=92619&t=complete&q=g'
+  % curl 'http://localhost:8080/?i=127.0.0.1&l=query&s=93850&t=complete&q=gr'
+  % curl 'http://localhost:8080/?i=127.0.0.1&l=query&s=94293&t=complete&q=gro'
+  % curl 'http://localhost:8080/?i=127.0.0.1&l=query&s=94734&t=complete&q=groo'
+  % curl 'http://localhost:8080/?i=127.0.0.1&l=query&s=95147&t=complete&q=grooon'
+  % curl 'http://localhost:8080/?i=127.0.0.1&l=query&s=95553&t=complete&q=groonga'
+  % curl 'http://localhost:8080/?i=127.0.0.1&l=query&s=95959&t=submit&q=groonga
 
 Options
 -------
@@ -60,6 +76,8 @@ Options
 .. cmdoption:: -t, --n-threads
 
    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.
 
 .. cmdoption:: -s, --send-endpoint
 
@@ -85,7 +103,7 @@ Options
 
    Specify this option to disable checking max fd on start.
 
-Command line Parameters
+Command line parameters
 -----------------------
 
 There is one required parameter - ``database_path``.
@@ -96,7 +114,7 @@ There is one required parameter - ``database_path``.
 Specifies the path to a Groonga database. This database must be created by :doc:`groonga-suggest-create-dataset` command because it executes required initialization for suggestion.
 
 
-GET Parameters
+GET parameters
 --------------
 
 groonga-suggest-httpd accepts following GET parameters.
@@ -116,7 +134,7 @@ Required parameters
      - UTF-8 encoded string which user fills in form
      - 
    * - t
-     - 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 '|'. Note that 'submit' is invalid value when you specify multiple type of query.
+     - 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 ``|``. Note that ``submit`` is invalid value when you specify multiple type of query.
      - 
 
 Required parameters for learning
@@ -130,13 +148,13 @@ Required parameters for learning
      - Note
    * - s
      - Elapsed time from 0:00 January 1, 1970
-     - Note that you need specify the value of 's' in milliseconds
+     - Note that you need specify the value of ``s`` in milliseconds
    * - i
      - Unique ID to distinct user
      - Use session ID or IP address for example
    * - l
-     - Specify the name of dataset for learning. It also accepts multiple dataset name which is concatinated by '|'
-     - Note that dataset name must be matched to following regular expression '[A-Za-z ][A-Za-z0-9 ]{0,15}'
+     - Specify the name of dataset for learning. It also accepts multiple dataset name which is concatinated by ``|``
+     - Note that dataset name must be matched to following regular expression ``[A-Za-z ][A-Za-z0-9 ]{0,15}``
 
 Required parameters for suggestion
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -162,7 +180,7 @@ Optional parameter
      - Note
    * - callback
      - Specify the name of function if you prefer JSONP as response format
-     - The name of function must be matched to reqular expression '[A-Za-z ][A-Za-z0-9 ]{0,15}'
+     - The name of function must be matched to reqular expression ``[A-Za-z ][A-Za-z0-9 ]{0,15}``
 
 Return value
 ------------
@@ -180,7 +198,7 @@ In JSONP format::
 
 ``TYPE``
 
-  'complete', 'correct' or 'suggest'.
+  One of ``complete``, ``correct`` and ``suggest``.
 
 ``CANDIDATE_N``
 
@@ -188,5 +206,5 @@ In JSONP format::
 
 ``SCORE_N``
 
-  The number of score.
+  The score.
 

data/vendor/local/share/doc/groonga/ja/html/_sources/reference/executables/groonga-suggest-learner.txt

@@ -8,7 +8,9 @@ groonga-suggest-learner
 Summary
 -------
 
-TODO
+groonga-suggest-learner is a program to learn suggest result from data which derived from groonga-suggest-httpd.
+Usually, it is used with groonga-suggest-httpd, but It is allowed to launch standalone.
+In such a case, groonga-suggest-learner loads data from log directory.
 
 Synopsis
 --------
@@ -20,23 +22,45 @@ Synopsis
 Usage
 -----
 
-TODO
+groonga-suggest-leaner supports the two way of learning data.
+One is learning data from groonga-suggest-httpd, the other is
+learning data from already existing log files.
+
+Learning data from groonga-suggest-httpd
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Execute groonga-suggest-learner.::
+
+  groonga-suggest-learner testdb/db
+
+Learning data from log files
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Execute groonga-suggest-learner with ``-l`` option.
+
+Here is the sample to load log data under ``logs`` directory::
+
+  groonga-suggest-learner -l logs testdb/db
 
 Options
 -------
 
-.. cmdoption:: -r, --receive-endpoint
+.. cmdoption:: -r
 
    Specify endpoint for receiver.
 
-.. cmdoption:: -s, --send-endpoint
+.. cmdoption:: -s
 
    Specify endpoint for sender.
 
-.. cmdoption:: -d, --daemon
+.. cmdoption:: -d
 
    Specify this option to daemonize.
 
+.. cmdoption:: -l
+
+   Specify log directory.
+
 Parameters
 ----------
 
@@ -48,3 +72,12 @@ There is one required parameter - ``database_path``.
 Specifies the path to a groonga database.
 
 
+
+Related tables
+--------------
+
+Here is the list of table which learned data is stored. If you specify ``query`` as dataset name, following ``_DATASET`` suffix are replaced. Thus, ``event_query`` table is used.
+
+* event_DATASET
+
+

data/vendor/local/share/doc/groonga/ja/html/_sources/reference/grn_expr/query_syntax.txt

@@ -87,11 +87,14 @@ Here is a special character list:
   * ``)`` (escaped as ``\)``)
   * ``\`` (escaped as ``\\``)
 
-You can use quote instead of escape. Quote syntax is ``"..."`` or
-``'...'``. You need escape ``"`` as ``\"`` in ``"..."`` quote syntax.
-You need escape ``'`` as ``\'`` in ``'...'`` quote syntax. For
-example, ``Alice's brother (Bob)`` can be quoted ``"Alice's brother
-(Bob)"`` or ``'Alice\'s brother (Bob)'``.
+You can use quote instead of escape special characters except ``\``
+(backslash). You need to use backslash for escaping backslash like
+``\\`` in quote.
+
+Quote syntax is ``"..."`` or ``'...'``. You need escape ``"`` as
+``\"`` in ``"..."`` quote syntax.  You need escape ``'`` as ``\'`` in
+``'...'`` quote syntax. For example, ``Alice's brother (Bob)`` can be
+quoted ``"Alice's brother (Bob)"`` or ``'Alice\'s brother (Bob)'``.
 
 .. note::
 

data/vendor/local/share/doc/groonga/ja/html/_sources/suggest/suggestion.txt

@@ -113,3 +113,20 @@ following command::
   {"sequence": "1", "time": 1312950803.86057, "item": "search engine", "type": "submit"},
   {"sequence": "1", "time": 1312950808.86057, "item": "web search realtime", "type": "submit"}
   ]
+
+How to extract learning data
+----------------------------
+
+The learning data is stored into item_DATASET and pair_DATASET tables.
+By using select command for such tables, you can all extract learing data.
+
+Here is the query to extract all learning data::
+
+  select item_DATASET --limit -1
+  select pair_DATASET --filter 'freq0 > 0 || freq1 > 0 || freq2 > 0' --limit -1
+
+Without '--limit -1', you can't get all data.
+In pair table, the valid value of freq0, freq1 and freq2 column must be larger than 0.
+
+Don't execute above query via HTTP request because enourmous number of records are fetched.
+ 

data/vendor/local/share/doc/groonga/ja/html/characteristic.html

@@ -7,7 +7,7 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
     
-    <title>1. Groongaの特徴 &mdash; Groonga v4.0.1ドキュメント</title>
+    <title>1. Groongaの特徴 &mdash; Groonga v4.0.1-127-g9422d50ドキュメント</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:     '4.0.1',
+        VERSION:     '4.0.1-127-g9422d50',
         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 v4.0.1ドキュメント" href="index.html" />
+    <link rel="top" title="Groonga v4.0.1-127-g9422d50ドキュメント" href="index.html" />
     <link rel="next" title="2. インストール" href="install.html" />
     <link rel="prev" title="Groonga ドキュメント" href="index.html" /> 
   </head>
@@ -60,7 +60,7 @@
         <li class="right" >
           <a href="index.html" title="Groonga ドキュメント"
              accesskey="P">前へ</a> |</li>
-        <li><a href="index.html">Groonga v4.0.1ドキュメント</a> &raquo;</li> 
+        <li><a href="index.html">Groonga v4.0.1-127-g9422d50ドキュメント</a> &raquo;</li> 
       </ul>
     </div>  
 
@@ -110,11 +110,11 @@
 </div>
 <div class="section" id="groonga-server">
 <h2>1.8. Groonga サーバ<a class="headerlink" href="#groonga-server" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<p>Groonga にはサーバ機能があるため、レンタルサーバなどの新しいライブラリをインストールできない環境においても利用できます。対応しているのは HTTP, memcached binary プロトコル、およびに Groonga の独自プロトコルである GQTP（Groonga Query Transfer Protocol） です。サーバとして利用するときはクエリのキャッシュ機能が有効になるため、同じクエリを受け取ったときは応答時間が短くなるという特徴があります。</p>
+<p>Groonga にはサーバ機能があるため、レンタルサーバなどの新しいライブラリをインストールできない環境においても利用できます。対応しているのは HTTP, memcached binary プロトコル、および Groonga の独自プロトコルである GQTP（Groonga Query Transfer Protocol） です。サーバとして利用するときはクエリのキャッシュ機能が有効になるため、同じクエリを受け取ったときは応答時間が短くなるという特徴があります。</p>
 </div>
-<div class="section" id="groonga-storage-engine">
-<h2>1.9. Groonga ストレージエンジン<a class="headerlink" href="#groonga-storage-engine" title="このヘッドラインへのパーマリンク">¶</a></h2>
-<p>Groonga は独自のカラムストアを持つ列指向のデータベースとしての側面を持っていますが、既存の RDBMS のストレージエンジンとして利用することもできます。たとえば、Groonga をベースとする MySQL のストレージエンジンとして <a class="reference external" href="http://mroonga.org/ja/">mroonga</a> が開発されています。mroonga は MySQL のプラグインとして動的にロードすることが可能であり、Groonga のカラムストアをストレージとして利用したり、全文検索エンジンとして Groonga を MyISAM や InnoDB と連携させたりすることができます。Groonga 単体での利用、およびに MyISAM, InnoDB との連携には一長一短があるので、用途に応じて適切な組み合わせを選ぶことが大切です。詳しくは <a class="reference external" href="http://groonga.org/ja/related-projects.html">関連プロジェクト</a> を参照してください。</p>
+<div class="section" id="mroonga-storage-engine">
+<h2>1.9. Mroonga ストレージエンジン<a class="headerlink" href="#mroonga-storage-engine" title="このヘッドラインへのパーマリンク">¶</a></h2>
+<p>Groonga は独自のカラムストアを持つ列指向のデータベースとしての側面を持っていますが、既存の RDBMS のストレージエンジンとして利用することもできます。たとえば、Groonga をベースとする MySQL のストレージエンジンとして <a class="reference external" href="http://mroonga.org/ja/">Mroonga</a> が開発されています。Mroonga は MySQL のプラグインとして動的にロードすることが可能であり、Groonga のカラムストアをストレージとして利用したり、全文検索エンジンとして Groonga を MyISAM や InnoDB と連携させたりすることができます。Groonga 単体での利用、および MyISAM, InnoDB との連携には一長一短があるので、用途に応じて適切な組み合わせを選ぶことが大切です。詳しくは <a class="reference external" href="http://groonga.org/ja/related-projects.html">関連プロジェクト</a> を参照してください。</p>
 </div>
 </div>
 
@@ -135,7 +135,7 @@
 <li><a class="reference internal" href="#geo-location-latitude-and-longitude-search">1.6. 位置情報（緯度・経度）検索</a></li>
 <li><a class="reference internal" href="#groonga-library">1.7. Groonga ライブラリ</a></li>
 <li><a class="reference internal" href="#groonga-server">1.8. Groonga サーバ</a></li>
-<li><a class="reference internal" href="#groonga-storage-engine">1.9. Groonga ストレージエンジン</a></li>
+<li><a class="reference internal" href="#mroonga-storage-engine">1.9. Mroonga ストレージエンジン</a></li>
 </ul>
 </li>
 </ul>
@@ -182,7 +182,7 @@
         <li class="right" >
           <a href="index.html" title="Groonga ドキュメント"
              >前へ</a> |</li>
-        <li><a href="index.html">Groonga v4.0.1ドキュメント</a> &raquo;</li> 
+        <li><a href="index.html">Groonga v4.0.1-127-g9422d50ドキュメント</a> &raquo;</li> 
       </ul>
     </div>
     <div class="footer" role="contentinfo">

data/vendor/local/share/doc/groonga/ja/html/community.html

@@ -7,7 +7,7 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
     
-    <title>3. コミュニティ &mdash; Groonga v4.0.1ドキュメント</title>
+    <title>3. コミュニティ &mdash; Groonga v4.0.1-127-g9422d50ドキュメント</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:     '4.0.1',
+        VERSION:     '4.0.1-127-g9422d50',
         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 v4.0.1ドキュメント" href="index.html" />
+    <link rel="top" title="Groonga v4.0.1-127-g9422d50ドキュメント" href="index.html" />
     <link rel="next" title="4. チュートリアル" href="tutorial.html" />
     <link rel="prev" title="2.8. その他" href="install/others.html" /> 
   </head>
@@ -60,7 +60,7 @@
         <li class="right" >
           <a href="install/others.html" title="2.8. その他"
              accesskey="P">前へ</a> |</li>
-        <li><a href="index.html">Groonga v4.0.1ドキュメント</a> &raquo;</li> 
+        <li><a href="index.html">Groonga v4.0.1-127-g9422d50ドキュメント</a> &raquo;</li> 
       </ul>
     </div>  
 
@@ -152,7 +152,7 @@
         <li class="right" >
           <a href="install/others.html" title="2.8. その他"
              >前へ</a> |</li>
-        <li><a href="index.html">Groonga v4.0.1ドキュメント</a> &raquo;</li> 
+        <li><a href="index.html">Groonga v4.0.1-127-g9422d50ドキュメント</a> &raquo;</li> 
       </ul>
     </div>
     <div class="footer" role="contentinfo">