rroonga 4.0.0-x64-mingw32 → 4.0.1-x64-mingw32

data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/delete.txt

@@ -40,7 +40,7 @@ Here are a schema definition and sample data to show usage.
 .. [
 .. {"_key": 1, "status": "OK"}
 .. {"_key": 2, "status": "NG"}
-.. ] 
+.. ]
 
 Delete the record from Entry table which has "2" as the key.
 
@@ -67,12 +67,12 @@ The country column of Users table associates with Country table.
 .. {"_key": 2, "name": "Mike", country: "United States"}
 .. {"_key": 3, "name": "Takashi", country: "Japan"}
 .. {"_key": 4, "name": "Hanako", country: "Japan"}
-.. ] 
+.. ]
 .. load --table Country
 .. [
 .. {"_key": "United States"}
 .. {"_key": "Japan"}
-.. ] 
+.. ]
 .. delete Country "United States"
 .. select Country
 .. select Users
@@ -108,8 +108,7 @@ Return value
 
 ``HEADER``
 
-  The format of HEADER is [0, UNIX_TIME_WHEN_COMMAND_IS_STARTED, ELAPSED_TIME].
-  See :doc:`/reference/command/output_format` about HEADER.
+  See :doc:`/reference/command/output_format` about ``HEADER``.
 
 ``SUCCEEDED_OR_NOT``
 

data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/normalize.txt

@@ -132,8 +132,7 @@ Return value
 
 ``HEADER``
 
-  The format of HEADER is [0, UNIX_TIME_WHEN_COMMAND_IS_STARTED, ELAPSED_TIME].
-  See :doc:`/reference/command/output_format` about HEADER.
+  See :doc:`/reference/command/output_format` about ``HEADER``.
 
 ``normalized_text``
 

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

@@ -42,6 +42,7 @@ Syntax
          [query_expansion=null]
          [query_flags=ALLOW_PRAGMA|ALLOW_COLUMN|ALLOW_UPDATE|ALLOW_LEADING_NOT|NONE]
          [query_expander=null]
+         [adjuster=null]
 
 Usage
 -----
@@ -838,6 +839,104 @@ TODO: write in English and add example.
 
   検索結果をクエリキャッシュに残しません。キャッシュして再利用される可能性が低いクエリに対して用います。キャッシュ容量は有限です。有効なキャッシュが多くヒットするために、このパラメータは有効です。
 
+Score related parameters
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+There is a score related parameter, ``adjuster``.
+
+.. _select-adjuster:
+
+
+``adjuster``
+""""""""""""
+
+It specifies one or more score adjust expressions. You need to use
+``adjuster`` with ``query`` or ``filter``. ``adjuster`` doesn't work
+with not searched request.
+
+You can increase score of specific records by ``adjuster``. You can
+use ``adjuster`` to set high score for important records.
+
+For example, you can use ``adjuster`` to increase score of records
+that have ``groonga`` tag.
+
+Here is the syntax::
+
+  --adjuster "SCORE_ADJUST_EXPRESSION1 + SCORE_ADJUST_EXPRESSION2 + ..."
+
+Here is the ``SCORE_ADJUST_EXPRESSION`` syntax::
+
+  COLUMN @ "KEYWORD" * FACTOR
+
+Note the following:
+
+  * ``COLUMN`` must be indexed.
+  * ``"KEYWORD"`` must be a string.
+  * ``FACTOR`` must be a positive integer.
+
+Here is a sample ``adjuster`` usage example that uses just one
+``SCORE_ADJUST_EXPRESSION``:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/select/adjuster_one.log
+.. select Entries \
+..   --filter true \
+..   --adjuster 'content @ "groonga" * 5' \
+..   --output_columns _key,content,_score
+
+The ``select`` command matches all records. Then it applies
+``adjuster``. The adjuster increases score of records that have
+``"groonga"`` in ``Entries.content`` column by 5. There is only one
+record that has ``"groonga"`` in ``Entries.content`` column.  So the
+record that its key is ``"Groonga"`` has score 6 (``= 1 + 5``).
+
+You can omit ``FACTOR``. If you omit ``FACTOR``, it is treated as 1.
+
+Here is a sample ``adjuster`` usage example that omits ``FACTOR``:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/select/adjuster_no_factor.log
+.. select Entries \
+..   --filter true \
+..   --adjuster 'content @ "groonga"' \
+..   --output_columns _key,content,_score
+
+The ``adjuster`` in the ``select`` command doesn't have ``FACTOR``. So
+the factor is treated as 1. There is only one record that has
+``"groonga"`` in ``Entries.content`` column. So the record that its
+key is ``"Groonga"`` has score 2 (``= 1 + 1``).
+
+Here is a sample ``adjuster`` usage example that uses multiple
+``SCORE_ADJUST_EXPRESSION``:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/select/adjuster_multiple.log
+.. select Entries \
+..   --filter true \
+..   --adjuster 'content @ "groonga" * 5 + content @ "started" * 3' \
+..   --output_columns _key,content,_score
+
+The ``adjuster`` in the ``select`` command has two
+``SCORE_ADJUST_EXPRESSION`` s. The final increased score is sum of
+scores of these ``SCORE_ADJUST_EXPRESSION`` s. All
+``SCORE_ADJUST_EXPRESSION`` s in the ``select`` command are applied to
+a record that its key is ``"Groonga"``. So the final increased score
+of the record is sum of scores of all ``SCORE_ADJUST_EXPRESSION`` s.
+
+The first ``SCORE_ADJUST_EXPRESSION`` is ``content @ "groonga" * 5``.
+It increases score by 5.
+
+The second ``SCORE_ADJUST_EXPRESSION`` is ``content @ "started" * 3``.
+It increases score by 3.
+
+The final increased score is 9 (``= 1 + 5 + 3``).
+
+A ``SCORE_ADJUST_EXPRESSION`` has a factor for ``"KEYWORD"``. This
+means that increased scores of all records that has ``"KEYWORD"`` are
+the same value. You can change increase score for each record that has
+the same ``"KEYWORD"``. It is useful to tune search score. See
+:ref:`weight-vector-column` for details.
+
 返値
 ----
 

data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/table_create.txt

@@ -187,7 +187,7 @@ Here are available flags:
 +--------------------+------------------------------+
 | ``TABLE_NO_KEY``   | Array table.                 |
 +--------------------+------------------------------+
-| ``TABLE_HASH_HEY`` | Hash table.                  |
+| ``TABLE_HASH_KEY`` | Hash table.                  |
 +--------------------+------------------------------+
 | ``TABLE_PAT_KEY``  | Patricia trie.               |
 +--------------------+------------------------------+

data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/truncate.txt

@@ -64,8 +64,7 @@ Return value
 
 ``HEADER``
 
-  The format of HEADER is [0, UNIX_TIME_WHEN_COMMAND_IS_STARTED, ELAPSED_TIME].
-  See :doc:`/reference/command/output_format` about HEADER.
+  See :doc:`/reference/command/output_format` about ``HEADER``.
 
 ``SUCCEEDED_OR_NOT``
 

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

@@ -2,13 +2,17 @@
 
 .. highlightlang:: none
 
+.. groonga-command
+.. database: groonga-suggest-httpd
+
 groonga-suggest-httpd
 =====================
 
 Summary
 -------
 
-TODO
+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.
 
 Synopsis
 --------
@@ -20,6 +24,30 @@ Synopsis
 Usage
 -----
 
+
+Set up
+^^^^^^
+
+First you need to set up database for suggestion.
+
+.. groonga-command
+.. include:: ../example/reference/executables/groonga-suggest-httpd-setup.log
+.. .. % groonga-suggest-create-dataset /tmp/groonga-databases/groonga-suggest-httpd query
+
+Launch groonga-suggest-httpd
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Execute groonga-suggest-httpd command:
+
+.. groonga-command
+.. include:: ../example/reference/executables/groonga-suggest-httpd-launch.log
+.. .. % groonga-suggest-httpd /tmp/groonga-databases/groonga-suggest-httpd
+
+After executing above command, groonga-suggest-httpd accepts HTTP request on 8080 port.
+
+Request to groonga-suggest-httpd
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
 TODO
 
 Options
@@ -57,12 +85,108 @@ Options
 
    Specify this option to disable checking max fd on start.
 
-Parameters
-----------
+Command line Parameters
+-----------------------
 
 There is one required parameter - ``database_path``.
 
 ``database_path``
 ^^^^^^^^^^^^^^^^^^^
 
-Specifies the path to a groonga database.
+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
+--------------
+
+groonga-suggest-httpd accepts following GET parameters.
+
+There are required parameters which depends on type of query.
+
+Required parameters
+^^^^^^^^^^^^^^^^^^^
+
+.. list-table::
+   :header-rows: 1
+
+   * - Key
+     - Description
+     - Note
+   * - q
+     - 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.
+     - 
+
+Required parameters for learning
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. list-table::
+   :header-rows: 1
+
+   * - Key
+     - Description
+     - Note
+   * - s
+     - Elapsed time from 0:00 January 1, 1970
+     - 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}'
+
+Required parameters for suggestion
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. list-table::
+   :header-rows: 1
+
+   * - Key
+     - Description
+     - Note
+   * - n
+     - Specify the name of dataset for suggestion
+     - This dataset name is used to calculate suggestion results
+
+Optional parameter
+^^^^^^^^^^^^^^^^^^
+
+.. list-table::
+   :header-rows: 1
+
+   * - Key
+     - Description
+     - 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}'
+
+Return value
+------------
+
+``groonga-suggest-httpd`` command returns following response in JSON or JSONP format.
+
+In JSON format::
+
+  {TYPE: [[CANDIDATE_1, SCORE_1], [CANDIDATE_2, SCORE_2], ... [CANDIDATE_N, SCORE_N]]}
+
+In JSONP format::
+
+  FUNCTION({TYPE: [[CANDIDATE_1, SCORE_1], [CANDIDATE_2, SCORE_2], ... [CANDIDATE_N, SCORE_N]]})
+
+
+``TYPE``
+
+  'complete', 'correct' or 'suggest'.
+
+``CANDIDATE_N``
+
+  The string of candidate (UTF-8).
+
+``SCORE_N``
+
+  The number of score.
+

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

@@ -25,7 +25,17 @@ TODO
 Options
 -------
 
-TODO
+.. cmdoption:: -r, --receive-endpoint
+
+   Specify endpoint for receiver.
+
+.. cmdoption:: -s, --send-endpoint
+
+   Specify endpoint for sender.
+
+.. cmdoption:: -d, --daemon
+
+   Specify this option to daemonize.
 
 Parameters
 ----------

data/vendor/local/share/doc/groonga/en/html/_static/basic.css

@@ -4,7 +4,7 @@
  *
  * Sphinx stylesheet -- basic theme.
  *
- * :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
+ * :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS.
  * :license: BSD, see LICENSE for details.
  *
  */

data/vendor/local/share/doc/groonga/en/html/_static/doctools.js

@@ -4,7 +4,7 @@
  *
  * Sphinx JavaScript utilities for all documentation.
  *
- * :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
+ * :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS.
  * :license: BSD, see LICENSE for details.
  *
  */

data/vendor/local/share/doc/groonga/en/html/_static/searchtools.js

@@ -4,7 +4,7 @@
  *
  * Sphinx JavaScript utilties for the full-text search.
  *
- * :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
+ * :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS.
  * :license: BSD, see LICENSE for details.
  *
  */

data/vendor/local/share/doc/groonga/en/html/_static/websupport.js

@@ -4,7 +4,7 @@
  *
  * sphinx.websupport utilties for all documentation.
  *
- * :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
+ * :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS.
  * :license: BSD, see LICENSE for details.
  *
  */

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

@@ -7,7 +7,7 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
     
-    <title>1. Characteristics of Groonga &mdash; Groonga v3.1.2-13-gc6e6a93 documentation</title>
+    <title>1. Characteristics of Groonga &mdash; Groonga v4.0.1 documentation</title>
     
     <link rel="stylesheet" href="_static/groonga.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
@@ -15,7 +15,7 @@
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    './',
-        VERSION:     '3.1.2-13-gc6e6a93',
+        VERSION:     '4.0.1',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
@@ -25,7 +25,7 @@
     <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 v3.1.2-13-gc6e6a93 documentation" href="index.html" />
+    <link rel="top" title="Groonga v4.0.1 documentation" href="index.html" />
     <link rel="next" title="2. Install" href="install.html" />
     <link rel="prev" title="Groonga documentation" href="index.html" /> 
   </head>
@@ -59,7 +59,7 @@
         <li class="right" >
           <a href="index.html" title="Groonga documentation"
              accesskey="P">previous</a> |</li>
-        <li><a href="index.html">Groonga v3.1.2-13-gc6e6a93 documentation</a> &raquo;</li> 
+        <li><a href="index.html">Groonga v4.0.1 documentation</a> &raquo;</li> 
       </ul>
     </div>  
 
@@ -181,7 +181,7 @@
         <li class="right" >
           <a href="index.html" title="Groonga documentation"
              >previous</a> |</li>
-        <li><a href="index.html">Groonga v3.1.2-13-gc6e6a93 documentation</a> &raquo;</li> 
+        <li><a href="index.html">Groonga v4.0.1 documentation</a> &raquo;</li> 
       </ul>
     </div>
     <div class="footer" role="contentinfo">

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

@@ -7,7 +7,7 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
     
-    <title>3. Community &mdash; Groonga v3.1.2-13-gc6e6a93 documentation</title>
+    <title>3. Community &mdash; Groonga v4.0.1 documentation</title>
     
     <link rel="stylesheet" href="_static/groonga.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
@@ -15,7 +15,7 @@
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    './',
-        VERSION:     '3.1.2-13-gc6e6a93',
+        VERSION:     '4.0.1',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
@@ -25,7 +25,7 @@
     <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 v3.1.2-13-gc6e6a93 documentation" href="index.html" />
+    <link rel="top" title="Groonga v4.0.1 documentation" href="index.html" />
     <link rel="next" title="4. Tutorial" href="tutorial.html" />
     <link rel="prev" title="2.8. Others" href="install/others.html" /> 
   </head>
@@ -59,7 +59,7 @@
         <li class="right" >
           <a href="install/others.html" title="2.8. Others"
              accesskey="P">previous</a> |</li>
-        <li><a href="index.html">Groonga v3.1.2-13-gc6e6a93 documentation</a> &raquo;</li> 
+        <li><a href="index.html">Groonga v4.0.1 documentation</a> &raquo;</li> 
       </ul>
     </div>  
 
@@ -155,7 +155,7 @@ Groonga related information.</p>
         <li class="right" >
           <a href="install/others.html" title="2.8. Others"
              >previous</a> |</li>
-        <li><a href="index.html">Groonga v3.1.2-13-gc6e6a93 documentation</a> &raquo;</li> 
+        <li><a href="index.html">Groonga v4.0.1 documentation</a> &raquo;</li> 
       </ul>
     </div>
     <div class="footer" role="contentinfo">