rroonga 6.0.7-x86-mingw32 → 6.0.9-x86-mingw32

data/vendor/local/share/doc/groonga/en/html/_sources/limitations.txt

@@ -1,5 +1,4 @@
 .. -*- rst -*-
-.. Groonga Project
 
 .. highlightlang:: none
 
@@ -14,11 +13,31 @@ Limitations of table
 A table has the following limitations.
 
 * The maximum one key size: 4KiB
-* The maximum total size of keys: 4GiB or 1TiB (by specifying
-  ``KEY_LARGE`` flag to :ref:`table-create-flags`)
-* The maximum number of records: 268,435,455 (more than 268 million)
+* The maximum total size of keys:
 
-Keep in mind that these limitations may vary depending on conditions.
+  * 4GiB by default.
+
+  * 1TiB by specifying ``KEY_LARGE`` flag to
+    :ref:`table-create-flags`. ``KEY_LARGE`` can be used only with
+    :ref:`table-hash-key`.
+
+* The maximum number of records:
+
+  * :ref:`table-no-key`: 1,073,741,815 (2 :sup:`30` - 9)
+  * :ref:`table-hash-key`: 536,870,912 (2 :sup:`29`)
+  * :ref:`table-pat-key`: 1,073,741,823 (2 :sup:`30` - 1)
+  * :ref:`table-dat-key`: 268,435,455 (2 :sup:`28` - 1)
+
+Keep in mind that these limitations may vary depending on
+conditions.
+
+For example, you need to use small size type for key to store many
+records. Because the maximum total size of keys limitation is exceeded
+before the maximum number of records limitation is exceeded. If you
+use ``UInt64`` (8byte) type and store 2 :sup:`29` records, total key
+size is 4GiB (= 8 * (2 :sup:`29`)). You can't add more records. You
+need to choose decreasing key size (e.g. ``UInt32``) or using
+``KEY_LARGE`` and :ref:`table-hash-key` to store more records.
 
 Limitations of indexing
 -----------------------

data/vendor/local/share/doc/groonga/en/html/_sources/news.txt

@@ -7,6 +7,159 @@
 News
 ====
 
+.. _release-6-0-9:
+
+Release 6.0.9 - 2016-09-29
+--------------------------
+
+Improvements
+^^^^^^^^^^^^
+
+* [:doc:`/reference/commands/logical_table_remove`] Supported to remove broken
+  tables and columns. It supports ``force`` parameter.
+
+* [:doc:`/reference/commands/select`] Supported match_columns, query,
+  query_flags and query_expander for slices.
+
+* [http][httpd] Supported incomplete POST-ed JSON. Only passed JSON is
+  processed.
+
+* [httpd] Changed to stop not to create the default log file when
+  custom file is specified.
+
+* Changed to reduce the default lock timeout to 15min from 2.7h.
+
+* [:doc:`/reference/executables/groonga-httpd`] support "~" modifier
+  in location such as "location ~ /d/...".
+
+* [mruby] Updated to the latest mruby to fix build error with Visutal
+  Studio.
+
+* [httpd] Updated bundled nginx to 1.11.4.
+  
+Fixes
+^^^^^
+
+* Fixed build error on OpenBSD. OpenBSD doesn't provide
+  ``TCP_NODELAY``. [MariaDB JIRA: fix MDEV-7209][Reported by Brad
+  Smith]
+
+* Fixed a missing deleted check for indexes. It causes missing search
+  results even though it should be matched. Groonga 6.0.3 or later
+  version are affected. [groonga-dev, 04107] [Reported by Kazuhiko]
+
+* [doc] Fixed a missing entry in Groonga 6.0.2 news that sequential
+  search is also executed as a fallback for :doc:`/reference/functions/geo_in_circle` [Reported by Gurunavi,
+  Inc]
+
+* [:doc:`/reference/commands/table_create`] Fixed a bug that
+  ``table_create`` command accepts no key type for ``TABLE_PAT_KEY``,
+  ``TABLE_HASH_KEY`` and ``TABLE_DAT_KEY`` tables. It creates a
+  invalid table. [GitHub#599]
+
+* [admin] Fixed a bug that it can not create a new record.
+
+* Fixed a bug that select command with a wrong filter causes
+  crash. [GitHub#601]
+
+
+Thanks
+^^^^^^
+
+* Brad Smith
+* Kazuhiko
+* Gurunavi, Inc
+
+.. _release-6-0-8:
+
+Release 6.0.8 - 2016-08-29
+--------------------------
+
+Improvements
+^^^^^^^^^^^^
+
+* [:doc:`/reference/commands/object_list`] Supported to show more
+  properties such as ``value_size`` and ``n_elements`` in metadata.
+
+* Supported operator per selector. This change enables to choose
+  correct index for selector. It means that ``between()`` chooses
+  index for range search, ``in_values()`` chooses index for equality
+  comparison. [GitHub#589] [Reported by Naoya Murakami]
+
+* [debian] Changed to use nginx log reopen feature instead of
+  Groonga's [:doc:`/reference/commands/log_reopen`] command because
+  log_reopen command works only for one worker. On the contrast, nginx
+  log reopen feature works for multiple workers.
+
+* [:doc:`/reference/commands/table_copy`] Added ``table_copy`` command
+  which copies specified table.
+
+* [:doc:`/reference/commands/column_copy`] Supported to cast A table
+  record to B table record. It fixes a case that ``column_copy``
+  failure in the previous version. Note that both tables must support
+  key.
+
+* [:doc:`/reference/commands/column_copy`] Supported reference type
+  vector.
+
+* [admin] Supported no response error case. It fixes the problem
+  that "Loading..." message will remain displayed.
+
+* [:doc:`/reference/executables/groonga`][http] Supported to return
+  400 Bad Request against not implemented function.
+
+* [:doc:`/reference/executables/groonga-httpd`] Supported to return
+  body on failure.
+
+* [:doc:`/reference/executables/groonga-httpd`] Supported to load
+  large data as stream.
+
+* Supported sequential search by ``_key`` when it is specified as a
+  source of index column.
+
+* Supported to report index information on resolving by accessor for
+  data column if log level is equal to info.
+
+* Added valid lexicon check on setting index sources. If users create
+  wrong index for sources by
+  [:doc:`/reference/commands/column_create`], this check shows
+  details.
+
+* [:doc:`/limitations`] Updated description about table
+  limitations.
+
+Fixes
+^^^^^
+
+* [:doc:`/reference/commands/column_create`] Fixed a bug that buffer
+  overflow occurs on logging.
+
+* Fixed to output response even when critical level error.
+
+* Fixed to ensure clearing output buffer for each grn_ctx_send.
+  This change solves sometimes response may broken. [GitHub#330]
+
+* [:doc:`/reference/functions/fuzzy_search`] Fixed a bug that
+  ``prefix_match_size`` option returns wrong node. It causes a problem
+  that ``fuzzy_search`` returns wrong edit distance. [GitHub#590]
+  [Patch by Naoya Murakami]
+
+* [:doc:`/reference/commands/load`] Changed to report error when
+  column value set is failed. It enables you to notice mismatch
+  between type of column and actual value.
+
+* [:doc:`/reference/executables/groonga-httpd`] Fixed a bug that wrong
+  HTTP status is set on success.
+
+* [:doc:`/reference/functions/fuzzy_search`][:doc:`/reference/functions/in_values`]
+  Fixed to resolve record id correctly on sequential
+  search. [GitHub#591,#592,#593] [Patch by Naoya Murakami]
+
+Thanks
+^^^^^^
+
+* Naoya Murakami
+
 .. _release-6-0-7:
 
 Release 6.0.7 - 2016-07-29
@@ -27,8 +180,6 @@ Improvements
   index column for fixed size scalar column. It reduces memory usage
   but not tested widely yet.
 
-* [:doc:`/news/5.x`] Extracted Groonga 5.x news entries from :doc:`/news`.
-
 * [:doc:`/reference/functions/vector_slice`] Added ``vector_slice``
   function to extract specific elements in vector column. [GitHub#582]
   [Patch by Naoya Murakami]
@@ -309,8 +460,9 @@ Improvements
 * [:doc:`/reference/commands/table_tokenize`] Supported to output ``estimated_size``.
   [GitHub#518] [Patch by Naoya Murakami]
 
-* [geo_in_rectangle] Supported to work without index. In this case, sequential search
-  is executed as a fallback.
+* [:doc:`/reference/functions/geo_in_rectangle`][:doc:`/reference/functions/geo_in_circle`]
+  Supported to work without index. In this case, sequential search is
+  executed as a fallback.
 
 * Reduced needless internal loops. It improves phrase search performance.
   [GitHub#519] [Patch by Naoya Murakami]

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

@@ -28,7 +28,7 @@ Syntax
 
 This command takes only one optional parameter::
 
-  lock_clear [target_name=null]
+  lock_acquire [target_name=null]
 
 If ``target_name`` parameters is omitted, database is used for the
 target object.

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

@@ -27,7 +27,7 @@ Syntax
 
 This command takes only one optional parameter::
 
-  lock_clear [target_name=null]
+  lock_release [target_name=null]
 
 If ``target_name`` parameters is omitted, database is used for the
 target object.

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

@@ -37,6 +37,11 @@ specify range as between ``2016-03-18 00:00:00`` and ``2016-03-18
    table and tables related with the target shard by using
    ``dependent`` parameter.
 
+.. versionadded:: 6.0.9
+
+   You can remove broken tables and columns as much as possible by
+   using ``force`` parameter.
+
 Syntax
 ------
 
@@ -51,6 +56,7 @@ The required parameters are ``logical_table`` and ``shard_key``::
                        [max=null]
                        [max_border="include"]
                        [dependent=no]
+                       [force=no]
 
 .. _logical-table-remove-usage:
 
@@ -65,6 +71,7 @@ This section describes about the followings:
   * Removes parts of a logical table
   * Unremovable cases
   * Removes with related tables
+  * Removes broken tables as much as possible
   * Decreases used resources
 
 .. _logical-table-remove-basic-usage:
@@ -332,6 +339,69 @@ table aren't removed:
 .. object_exist NotRelated_20160320
 .. object_exist Servers
 
+.. _logical-table-remove-removes-broken-tables-as-much-as-possible:
+
+Removes broken tables as much as possible
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. versionadded:: 6.0.9
+
+If the target tables are broken, you can't remove them. But you can
+remove them as much as possible by using ``force`` parameter.
+
+If you specify ``--force yes``, they are removed as much as
+possible. You can also use ``--dependent yes`` with ``--force yes``.
+
+Here is a sample schema to show how ``--force yes`` behavior:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/logical_table_remove/remove_broken_tables_create.log
+.. table_create  Logs_20160320 TABLE_NO_KEY
+.. column_create Logs_20160320 timestamp COLUMN_SCALAR Time
+..
+.. table_create  Timestamps TABLE_PAT_KEY Time
+.. column_create Timestamps logs_20160320_timestamp \
+..   COLUMN_INDEX Logs_20160320 timestamp
+
+You can't remove ``Logs_20160320`` when
+``Timestamps.logs_20160320_timestamp`` is broken:
+
+.. groonga-command
+.. thread_limit 1
+.. database_unmap
+.. .. ${DB_PATH}.0000109 is Timestamps.logs_20160320_timestamp.
+.. .. You can confirm ID of Timestamps.logs_20160320_timestamp by object_list.
+.. % echo > ${DB_PATH}.0000109
+
+.. groonga-command
+.. include:: ../../example/reference/commands/logical_table_remove/remove_broken_tables_remove.log
+.. logical_table_remove \
+..   --logical_table Logs \
+..   --shard_key timestamp
+
+You can remove ``Logs_20160320`` and its columns by using ``--force
+yes`` parameter even when ``Timestamps.logs_20160320_timestamp`` is
+broken:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/logical_table_remove/remove_broken_tables_remove_force.log
+.. logical_table_remove \
+..   --logical_table Logs \
+..   --shard_key timestamp \
+..   --force yes
+
+``Logs_20160320``, its columns and
+``Timestamps.logs_20160320_timestamp`` are removed:
+
+.. groonga-command
+.. include:: ../../example/reference/commands/logical_table_remove/remove_broken_tables_index_column_exist.log
+.. object_exist Logs_20160320
+.. object_exist Logs_20160320.timestamp
+.. object_exist Timestamps.logs_20160320_timestamp
+
+``--force yes`` parameter is a dangerous parameter. Normally, you
+don't need to use it.
+
 .. _logical-table-remove-decreases-used-resources:
 
 Decreases used resources
@@ -443,6 +513,22 @@ You should use this parameter carefully. This is a danger parameter.
 See :ref:`logical-table-remove-removes-with-related-tables` how to use
 this parameter.
 
+.. _logical-table-remove-force:
+
+``force``
+"""""""""
+
+.. versionadded:: 6.0.9
+
+Specifies whether you want to remove target tables and columns even if
+some problems exist.
+
+You should use this parameter carefully. This is a danger parameter.
+
+See
+:ref:`logical-table-remove-removes-broken-tables-as-much-as-possible`
+how to use this parameter.
+
 Return value
 ------------
 

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

@@ -101,12 +101,14 @@ properties.
 Here are common properties::
 
   {
-    "id":     ID,
-    "name":   NAME,
-    "opened": OPENED,
-    "type":   OBJECT_TYPE,
-    "flags":  FLAGS,
-    "path":   PATH
+    "id":         ID,
+    "name":       NAME,
+    "opened":     OPENED,
+    "value_size": N_BYTES,
+    "n_elements": N_ELEMENTS,
+    "type":       OBJECT_TYPE,
+    "flags":      FLAGS,
+    "path":       PATH
   }
 
 .. list-table::
@@ -122,6 +124,16 @@ Here are common properties::
      - Whether the object is opened or not. It's ``true`` or
        ``false``.  If the object is opened, this value is
        ``true``. Otherwise, this value is ``false``.
+   * - ``value_size``
+     - The number of bytes of the metadata. It's an integer.
+
+       It's appeared only when the metadata are broken. If this
+       property is appeared, ``type``, ``n_elements``, ``flags`` and
+       ``path`` aren't appeared. Because they can't be retrieved from
+       broken metadata.
+   * - ``n_elements``
+     - The number of internal elements in the metadata. It's an
+       integer.
    * - ``type``
      - The type of the object. See
        :ref:`object-list-return-value-object-type` for details.
@@ -234,10 +246,10 @@ Here are ``"proc"`` object type specific properties in ``OBJECT``::
        object is defined by plugin, the value is ``1`` or more larger
        integer. Plugin ID is ``0`` for builtin ``"proc"`` object.
 
-``OBJECT`` (``"table:\*"`` object types specific properties)
+``OBJECT`` (``"table:*"`` object types specific properties)
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Here are ``"table:\*"`` object types specific properties in
+Here are ``"table:*"`` object types specific properties in
 ``OBJECT``::
 
   {
@@ -254,7 +266,7 @@ Here are ``"table:\*"`` object types specific properties in
      - The type of the table's value. See
        :ref:`object-list-return-value-range` for details.
    * - ``token_filters``
-     - The token filters of the table.See
+     - The token filters of the table. See
        :ref:`object-list-return-value-token-filters` for details.
 
 .. _object-list-return-value-range:
@@ -316,10 +328,10 @@ Here are ``"table:\*"`` object types specific properties in
    * - ``name``
      - The name of the token filter. It's a string.
 
-``OBJECT`` (``"column:\*"`` object types specific properties)
+``OBJECT`` (``"column:*"`` object types specific properties)
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Here are ``"column:\*"`` object types specific properties in
+Here are ``"column:*"`` object types specific properties in
 ``OBJECT``::
 
   {

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

@@ -0,0 +1,64 @@
+.. -*- rst -*-
+
+.. highlightlang:: none
+
+
+``table_copy``
+==============
+
+Summary
+-------
+
+.. versionadded:: 6.0.8
+
+TOOD: Write me
+
+Syntax
+------
+
+This command takes two parameters.
+
+All parameters are required::
+
+  table_copy from_name
+             to_name
+
+Usage
+-----
+
+
+Parameters
+----------
+
+This section describes parameters.
+
+Required parameters
+^^^^^^^^^^^^^^^^^^^
+
+All parameters are required.
+
+``from_name``
+"""""""""""""
+
+Specifies the table name of source table.
+
+``to_name``
+"""""""""""
+
+Specifies the destination table name.
+
+Optional parameters
+^^^^^^^^^^^^^^^^^^^
+
+There is no optional parameter.
+
+Return value
+------------
+
+The command returns ``true`` as body on success such as::
+
+  [HEADER, true]
+
+If the command fails, error details are in ``HEADER``.
+
+See :doc:`/reference/command/output_format` for ``HEADER``.

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

@@ -23,51 +23,94 @@ Characteristics
 Here is a chracteristic table of all tables in Groonga. (``TABLE_``
 prefix is omitted in the table.)
 
-+--------------+------------+--------------+-------------+-------------+
-|              | ``NO_KEY`` | ``HASH_KEY`` | ``PAT_KEY`` | ``DAT_KEY`` |
-+==============+============+==============+=============+=============+
-| Data         | Array      | Hash table   | Patricia    | Double      |
-| structure    |            |              | trie        | array       |
-|              |            |              |             | trie        |
-+--------------+------------+--------------+-------------+-------------+
-| ID           | o          | o            | o           | o           |
-| support      |            |              |             |             |
-+--------------+------------+--------------+-------------+-------------+
-| Key          | x          | o            | o           | o           |
-| support      |            |              |             |             |
-+--------------+------------+--------------+-------------+-------------+
-| Value        | o          | o            | o           | x           |
-| support      |            |              |             |             |
-+--------------+------------+--------------+-------------+-------------+
-| Key -> ID    | \-         | oo           | x           | o           |
-| speed        |            |              |             |             |
-|              |            |              |             |             |
-| * o: fast    |            |              |             |             |
-| * x: slow    |            |              |             |             |
-+--------------+------------+--------------+-------------+-------------+
-| Update speed | ooo        | o            | o           | x           |
-|              |            |              |             |             |
-| * o: fast    |            |              |             |             |
-| * x: slow    |            |              |             |             |
-+--------------+------------+--------------+-------------+-------------+
-| Size         | ooo        | o            | oo          | x           |
-|              |            |              |             |             |
-| * o: small   |            |              |             |             |
-| * x: large   |            |              |             |             |
-+--------------+------------+--------------+-------------+-------------+
-| Key          | \-         | x            | x           | o           |
-| update       |            |              |             |             |
-+--------------+------------+--------------+-------------+-------------+
-| Common       | \-         | x            | o           | o           |
-| prefix       |            |              |             |             |
-| search       |            |              |             |             |
-+--------------+------------+--------------+-------------+-------------+
-| Predictive   | \-         | x            | o           | o           |
-| search       |            |              |             |             |
-+--------------+------------+--------------+-------------+-------------+
-| Range        | \-         | x            | o           | o           |
-| search       |            |              |             |             |
-+--------------+------------+--------------+-------------+-------------+
+.. list-table:: Characteristics of all tables
+   :header-rows: 1
+
+   * - Item
+     - ``NO_KEY``
+     - ``HASH_KEY``
+     - ``PAT_KEY``
+     - ``DAT_KEY``
+   * - Data structure
+     - Array
+     - Hash table
+     - Patricia trie
+     - Double array trie
+   * - ID support
+     - o
+     - o
+     - o
+     - o
+   * - Key support
+     - x
+     - o
+     - o
+     - o
+   * - Value support
+     - o
+     - o
+     - o
+     - x
+   * - Key -> ID speed
+
+       * o: fast
+       * x: slow
+     - \-
+     - oo
+     - x
+     - o
+   * - Update speed
+
+       * o: fast
+       * x: slow
+     - ooo
+     - o
+     - o
+     - x
+   * - Size
+
+       * o: small
+       * x: large
+     - ooo
+     - o
+     - oo
+     - x
+   * - Key update
+     - \-
+     - x
+     - x
+     - o
+   * - Common prefix search
+     - \-
+     - x
+     - o
+     - o
+   * - Predictive search
+     - \-
+     - x
+     - o
+     - o
+   * - Range search
+     - \-
+     - x
+     - o
+     - o
+   * - The maximum one key size
+     - \-
+     - 4KiB
+     - 4KiB
+     - 4KiB
+   * - The maximum total size of keys
+     - \-
+     - 4GiB or 1TiB (by specifying ``KEY_LARGE`` flag to
+       :ref:`table-create-flags`)
+     - 4GiB
+     - 4GiB
+   * - The maximum number of records
+     - 1,073,741,815 (2 :sup:`30` - 9)
+     - 536,870,912 (2 :sup:`29`)
+     - 1,073,741,823 (2 :sup:`30` - 1)
+     - 268,435,455 (2 :sup:`28` - 1)
 
 .. _table-no-key:
 

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 v6.0.7 documentation</title>
+    <title>1. Characteristics of Groonga &mdash; Groonga v6.0.9 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:     '6.0.7',
+        VERSION:     '6.0.9',
         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 v6.0.7 documentation" href="index.html" />
+    <link rel="top" title="Groonga v6.0.9 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 class="nav-item nav-item-0"><a href="index.html">Groonga v6.0.7 documentation</a> &raquo;</li> 
+        <li class="nav-item nav-item-0"><a href="index.html">Groonga v6.0.9 documentation</a> &raquo;</li> 
       </ul>
     </div>  
 
@@ -178,7 +178,7 @@
         <li class="right" >
           <a href="index.html" title="Groonga documentation"
              >previous</a> |</li>
-        <li class="nav-item nav-item-0"><a href="index.html">Groonga v6.0.7 documentation</a> &raquo;</li> 
+        <li class="nav-item nav-item-0"><a href="index.html">Groonga v6.0.9 documentation</a> &raquo;</li> 
       </ul>
     </div>
     <div class="footer" role="contentinfo">