rroonga 3.0.8-x64-mingw32 → 3.0.9-x64-mingw32

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

@@ -11,21 +11,21 @@
 Summary
 -------
 
-``ruby_eval`` command evaluates ruby script and returns the result.
+``ruby_eval`` command evaluates Ruby script and returns the result.
 
 Syntax
 ------
 
 ``ruby_eval`` has one required parameter::
 
-  ruby_eval ruby_script
+  ruby_eval script
 
 Usage
 -----
 
 You can execute any scripts which mruby supports by calling ``ruby_eval``.
 
-Here is an example that just calculate ``1 + 2`` by mruby plugin.
+Here is an example that just calculate ``1 + 2`` as Ruby script.
 
 .. groonga-command
 .. include:: ../../example/reference/commands/ruby_eval/calc.log
@@ -42,35 +42,29 @@ Parameters
 
 This section describes all parameters.
 
-``ruby_script``
-"""""""""""""""
+``script``
+""""""""""
 
-It specifies the ruby script which you want to evaluate.
+It specifies the Ruby script which you want to evaluate.
 
 Return value
 ------------
 
-``ruby_eval`` returns the evaluated result which key is "value" as json format::
+``ruby_eval`` returns the evaluated result with metadata such as
+exception information (Including metadata isn't implemented yet)::
 
-  [[HEADER, EVALUATED]]
+  [HEADER, {"value": EVALUATED_VALUE}]
 
 ``HEADER``
 
   See :doc:`/reference/command/output_format` about ``HEADER``.
 
-``EVALUATED``
+``EVALUATED_VALUE``
 
-  ``EVALUATED`` consists of pair of key and value in forms of {key:value}.
+  ``EVALUATED_VALUE`` is the evaludated value of ``ruby_script``.
 
-  .. list-table::
-     :header-rows: 1
-
-     * - Name
-       - Description
-     * - ``key``
-       - reserved word 'value'.
-     * - ``value``
-       - the value of evaluated script. It must be a number.
+  ``ruby_eval`` supports only a number for evaluated value for now.
+  Supported types will be increased in the future.
 
 See also
 --------

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

@@ -0,0 +1,71 @@
+.. -*- rst -*-
+
+.. highlightlang:: none
+
+.. groonga-command
+.. database: commands_ruby_load
+
+``ruby_load``
+=============
+
+Summary
+-------
+
+``ruby_load`` command loads specified Ruby script.
+
+Syntax
+------
+
+``ruby_load`` has one required parameter::
+
+  ruby_load path
+
+Usage
+-----
+
+You can load any script file which mruby supports by calling ``ruby_load``.
+
+Here is an example that just load ``expression.rb`` as Ruby script.
+
+.. groonga-command
+.. include:: ../../example/reference/commands/ruby_load/load.log
+.. register ruby/load
+.. ruby_load "expression.rb"
+
+Register ``ruby/load`` plugin to use ``ruby_load`` command in advance.
+
+Note that ``ruby_load`` is implemented as an experimental plugin,
+and the specification may be changed in the future.
+
+Parameters
+----------
+
+This section describes all parameters.
+
+``path``
+"""""""""""""""
+
+It specifies the Ruby script path which you want to load.
+
+Return value
+------------
+
+``ruby_load`` returns the loaded result with metadata such as
+exception information (Including metadata isn't implemented yet)::
+
+  [HEADER, {"value": LOADED_VALUE}]
+
+``HEADER``
+
+  See :doc:`/reference/command/output_format` about ``HEADER``.
+
+``LOADED_VALUE``
+
+  ``LOADED_VALUE`` is the loaded value of ruby script.
+
+  ``ruby_load`` just return ``null`` as ``LOADED_VALUE`` for now, it will be supported in the future.
+
+See also
+--------
+
+:doc:`/reference/commands/ruby_eval`

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

@@ -58,7 +58,7 @@ tokenizer that is named ``tokenizer``.
 
 See :doc:`/reference/tokenizers` about built-in tokenizers.
 
-Here is an example to use ``TokenTrigram`` tokenizer.
+Here is an example to use built-in ``TokenTrigram`` tokenizer.
 
 .. groonga-command
 .. include:: ../../example/reference/commands/tokenize/tokenizer_token_trigram.log
@@ -66,15 +66,16 @@ Here is an example to use ``TokenTrigram`` tokenizer.
 
 If you want to use other tokenizers, you need to register additional
 tokenizer plugin by :doc:`register` command. For example, you can use
-MySQL compatible normalizer by registering `groonga-normalizer-mysql
-<https://github.com/groonga/groonga-normalizer-mysql>`_.
+`KyTea <http://www.phontron.com/kytea/>`_ based tokenizer by
+registering ``tokenizers/kytea``.
 
 ``string``
 """"""""""
 
-It specifies any string which you want to tokenize. If you want to
-include spaces in ``string``, you need to quote ``string`` by
-single quotation (``'``) or double quotation (``"``).
+It specifies any string which you want to tokenize.
+
+If you want to include spaces in ``string``, you need to quote
+``string`` by single quotation (``'``) or double quotation (``"``).
 
 Here is an example to use spaces in ``string``.
 

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

@@ -120,6 +120,8 @@ Examples::
     groonga off; # Disables groonga under /d/... path
   }
 
+.. _groonga-database:
+
 ``groonga_database``
 """"""""""""""""""""
 
@@ -136,10 +138,33 @@ Context
 Specifies the path to a groonga database. This is the required
 directive.
 
+.. _groonga-database-auto-create:
+
 ``groonga_database_auto_create``
 """"""""""""""""""""""""""""""""
 
-TODO
+Synopsis::
+
+  groonga_database_auto_create on | off;
+
+Default
+  ``groonga_database_auto_create on;``
+
+Context
+  ``http``, ``server``, ``location``
+
+Specifies whether groonga database is created automatically or not. If
+the value is ``on`` and the groonga database specified by
+:ref:`groonga-database` doesn't exist, the groonga database is created
+automatically. If the groonga database exists, groonga-httpd does
+nothing.
+
+If parent directory doesn't exist, parent directory is also created
+recursively.
+
+The default value is ``on``. Normally, the value doesn't need to be
+changed.
+
 
 ``groonga_base_path``
 """""""""""""""""""""
@@ -300,6 +325,35 @@ see http://wiki.nginx.org/CoreModule#worker_processes.
 
 By default, this is set to 1. It is nginx's default.
 
+.. _groonga-cache-limit:
+
+``groonga_cache_limit``
+"""""""""""""""""""""""
+
+This directive is introduced to customize cache limit for each worker process.
+
+Synopsis::
+
+  groonga_cache_limit CACHE_LIMIT;
+
+Default
+  100
+
+Context
+  ``http``, ``server``, ``location``
+
+Specifies groonga's limit of query cache in the ``http``, ``server`` or
+``location`` block. The default value is 100.
+You can disable query cache to specify 0 to ``groonga_cache_limit`` explicitly.
+
+Examples::
+
+  location /d/ {
+    groonga on;
+    # You can customize query cache limit for groonga.
+    groonga_cache_limit 100;
+  }
+
 ``proxy_cache``
 """""""""""""""
 
@@ -367,38 +421,38 @@ change cache configuration dynamically by HTTP.
 
 Here is a sample configuration::
 
-   ...
-   http {
-     proxy_cache_path /var/cache/groonga-httpd levels=1:2 keys_zone=groonga:10m;
-     proxy_cache_valid 10m;
-     ...
-     # Reverse proxy and cache
-     server {
-       listen 10041;
-       ...
-       # Only select command
-       location /d/select {
-         # Pass through groonga with cache
-         proxy_cache groonga;
-         proxy_pass http://localhost:20041;
-       }
-
-       location / {
-         # Pass through groonga
-         proxy_pass http://localhost:20041;
-       }
-     }
-
-     # groonga
-     server {
-       location 20041;
-       location /d/ {
-         groonga on;
-         groonga_database /var/lib/groonga/db/db;
-       }
-     }
-     ...
-   }
+  ...
+  http {
+    proxy_cache_path /var/cache/groonga-httpd levels=1:2 keys_zone=groonga:10m;
+    proxy_cache_valid 10m;
+    ...
+    # Reverse proxy and cache
+    server {
+      listen 10041;
+      ...
+      # Only select command
+      location /d/select {
+        # Pass through groonga with cache
+        proxy_cache groonga;
+        proxy_pass http://localhost:20041;
+      }
+
+      location / {
+        # Pass through groonga
+        proxy_pass http://localhost:20041;
+      }
+    }
+
+    # groonga
+    server {
+      location 20041;
+      location /d/ {
+        groonga on;
+        groonga_database /var/lib/groonga/db/db;
+      }
+    }
+    ...
+  }
 
 See the following nginx documentations for parameter details:
 

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

@@ -22,6 +22,19 @@ DESCTIPION
 
 groonga-suggest-create-dataset creates a dataset for :doc:`/suggest`. A database has many datasets. This command just defines schema for a suggestion dataset.
 
+This command generates some tables and columns for :doc:`/suggest`.
+
+Here is the list of such tables. If you specify 'query' as dataset name, following '_DATASET' suffix are replaced. Thus, 'item_query', 'pair_query', 'sequence_query', 'event_query' tables are generated.
+
+* event_type
+* bigram
+* kana
+* item_DATASET
+* pair_DATASET
+* sequence_DATASET
+* event_DATASET
+* configuration
+
 OPTIONS
 -------
 
@@ -46,5 +59,5 @@ SEE ALSO
 --------
 
 :doc:`/suggest`
-.. : doc:`groonga-suggest-httpd`
-.. : doc:`groonga-suggest-learner`
+:doc:`groonga-suggest-httpd`
+:doc:`groonga-suggest-learner`

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

@@ -0,0 +1,68 @@
+.. -*- rst -*-
+
+.. highlightlang:: none
+
+groonga-suggest-httpd
+=====================
+
+Summary
+-------
+
+TODO
+
+Synopsis
+--------
+
+::
+
+  groonga-suggest-httpd [options] database_path
+
+Usage
+-----
+
+TODO
+
+Options
+-------
+
+.. cmdoption:: -p, --port
+
+   Specify http server port number. The default value is 8080.
+
+.. cmdoption:: -t, --n-threads
+
+   Specify number of threads. The default value is 8.
+
+.. cmdoption:: -s, --send-endpoint
+
+   Specify endpoint for sender.
+
+.. cmdoption:: -r, --receive-endpoint
+
+   Specify endpoint for receiver.
+
+.. cmdoption:: -l, --log-base-path
+
+   Specify path prefix of log.
+
+.. cmdoption:: --n-lines-per-log-file
+
+   Specify the number of lines in a log file. The default value is 1,000,000.
+
+.. cmdoption:: -d, --daemon
+
+   Specify this option to daemonize.
+
+.. cmdoption:: --disable-max-fd-check
+
+   Specify this option to disable checking max fd on start.
+
+Parameters
+----------
+
+There is one required parameter - ``database_path``.
+
+``database_path``
+^^^^^^^^^^^^^^^^^^^
+
+Specifies the path to a groonga database.

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

@@ -0,0 +1,40 @@
+.. -*- rst -*-
+
+.. highlightlang:: none
+
+groonga-suggest-learner
+=======================
+
+Summary
+-------
+
+TODO
+
+Synopsis
+--------
+
+::
+
+  groonga-suggest-learner [options] database_path
+
+Usage
+-----
+
+TODO
+
+Options
+-------
+
+TODO
+
+Parameters
+----------
+
+There is one required parameter - ``database_path``.
+
+``database_path``
+^^^^^^^^^^^^^^^^^
+
+Specifies the path to a groonga database.
+
+