rroonga 6.0.0-x86-mingw32 → 6.0.2-x86-mingw32

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

@@ -7,6 +7,228 @@
 News
 ====
 
+.. _release-6-0-2:
+
+Release 6.0.2 - 2016-04-29
+--------------------------
+
+Improvements
+^^^^^^^^^^^^
+
+* Supported bool in comparison operators (``>``, ``>=``, ``<``, ``<=``).
+  TRUE is casted to 1. FALSE is casted to 0. Thus you specify function
+  which returns boolean value in comparison.
+
+* [groonga-http][:doc:`/reference/command/request_timeout`] Supported
+  ``request_timeout`` parameter. Canceled request returns
+  ``HTTP/1.1 408 Request Timeout`` status code.
+
+* [:doc:`/reference/commands/table_tokenize`] Added ``index_column`` option.
+  [GitHub#534] [Patch by Naoya Murakami]
+
+* [: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.
+
+* Reduced needless internal loops. It improves phrase search performance.
+  [GitHub#519] [Patch by Naoya Murakami]
+
+* [:doc:`/contribution`] Updated documentation about contribution.
+  [GitHub#522] [Patch by Hiroshi Ohkubo]
+
+* [:doc:`/reference/command/return_code`] Updated documentation about return code list.
+
+* [:doc:`/reference/executables/groonga`] Added ``--default-request-timeout`` option.
+
+* [windows] Supported DLL version.
+
+* Supported index used search even if value only term exists.
+  For example, ``true || column > 0`` doesn't use index even if ``column`` has
+  index. In this release, above issue is resolved.
+
+* [:doc:`/reference/commands/select`] Supported specifying grouped table
+  [GitHub#524,#526,#527,#528,#529] [Patch by Naoya Murakami]
+
+* Supported grouping by ``Int{8,16,64}/UInt{8,16,64}`` value.
+  In the previous versions, only 32bit fixed size value was supported.
+
+* Added table name to error message for invalid sort key.
+
+* [:doc:`/reference/executables/groonga-suggest-httpd`] Updated documentation.
+
+* [:doc:`/reference/suggest/completion`] Fixed a typo about example.
+  [groonga-dev,04008] [Reported by Tachikawa Hiroaki]
+
+* [:doc:`/reference/executables/grndb`] Added a workaround to keep
+  backward compatibility. use ``object_inspect`` instead of ``inspect``.
+
+* [groonga-httpd] Updated bundled nginx version to 1.9.15.
+
+* [centos] Supported systemd.
+
+* [doc] Supported only HTML output. [GitHub#532] [Patch by Hiroshi Ohkubo]
+
+* [:doc:`/reference/executables/groonga-httpd`][centos] Supported to customize
+  environment variables.
+
+* [:doc:`/install/others`] Updated documentation about ``--with-package-platorm`` option.
+
+* [ubuntu] Supported Ubuntu 16.04 (Xenial Xerus)
+
+Fixes
+^^^^^
+
+* Fixed a bug that tokenization of zero-length values are failed.
+  For example, if ``description`` column is indexed column, tokenizer reports an error.
+  [GitHub#508] [Reported by Naoya Murakami]::
+
+    load --table docs
+    [
+    ["_key","description"],
+    [2,""]
+    ]
+
+* Fixed a crash bug because of invalid critical section handling. [GitHub#507]
+
+* [:doc:`/contribution/development/release`] Fixed a typo about grntest howto.
+  [GitHub#511] [Patch by Hiroshi Ohkubo]
+
+* [doc] Removed man support.
+
+* Removed invalid debug log messages which make user confused.
+
+* Fixed a bug that data is not correctly flushed because internal counter is wrongly cleared.
+  In the previous version, when size of data exceeds specific one, it was failed to create indexes.
+  [GitHub#517] [Reported by Naoya Murakami]
+
+* Fixed a bug that a process can't use more than one caches in parallel.
+  [GitHub#515]
+
+* Fixed a bug that internally used ``alloc_info`` structure which is used to find memory leaks is
+  not exclusively accessed. Without this fix, it may causes a crash. [GitHub#523]
+
+* [tokenizer mecab] Fixed a memory leak on dictionary encoding mismatch error.
+  [groonga-dev,04012] [Reported by Naoya Murakami]
+
+* Fixed a bug that combination of [:doc:`/reference/executables/groonga-suggest-httpd`] and
+  [:doc:`/reference/executables/groonga-suggest-learner`] didn't work.
+
+* [doc] Removed needless uuid from \*.po [GitHub#531] [Patch by Hiroshi Ohkubo]
+
+* [:doc:`/reference/functions/highlight_html`] Fixed a bug that duplicated text
+  is returned. This bug occurs when highlighted keyword occurred 1024 or more times.
+
+* Fixed a bug that ``KEY_LARGE`` conflicts with existing flag.
+  If you use ``TABLE_HASH_KEY|KEY_LARGE`` in the previous version,
+  there is a possibility to break database. Please recreate the table.
+
+Thanks
+^^^^^^
+
+* Naoya Murakami
+* Hiroshi Ohkubo
+* Tachikawa Hiroaki
+
+.. _release-6-0-1:
+
+Release 6.0.1 - 2016-03-29
+--------------------------
+
+Improvements
+^^^^^^^^^^^^
+
+* [mruby] Updated bundled mruby to fix a crash bug related to GC and
+  backtrace.
+
+* Exported the following API
+
+  * grn_expr_take_obj()
+  * grn_request_canceler_cancel_all()
+  * grn_obj_remove_dependent()
+  * grn_obj_is_text_family_type()
+
+* [hash] Supported 4GiB over total key size when ``KEY_LARGE`` flag is set
+  to a table::
+
+    table_create Users TABLE_HASH_KEY|KEY_LARGE ShortText
+
+* [:doc:`/reference/commands/load`] Supported
+  :doc:`/reference/command/request_id` when you specify input data as
+  raw JSON instead of parameter value::
+
+    POST /d/load?table=XXX&request_id=x
+    
+    load --table XXX --request_id x
+    [
+      ...
+    ]
+
+* [:doc:`/reference/commands/shutdown`] Added ``mode`` argument to
+  shutdown immediately. Use ``shutdown --mode immediate`` in such a purpose.
+
+* [:doc:`/install/mac_os_x`] Added a instruction to setup MeCab dictionary for Homebrew.
+
+* [:doc:`/reference/commands/load`] Supported to stop load when cancel
+  is requested.
+
+* [:doc:`/reference/commands/table_remove`] Supported to remove
+  dependent tables. Use ``--dependent yes`` for it.
+
+* [:doc:`/reference/commands/logical_table_remove`] Supported to
+  remove dependent tables.
+
+* [Windows] Supported memory debug mode on Windows.
+
+* Supported to dump allocation information by status on memory debug mode
+
+* [:doc:`/contribution/documentation/i18n`] Added installation step for Sphinx.
+
+* [experimental] Supported to split chunks in static indexing.
+  Use ``GRN_INDEX_CHUNK_SPLIT_ENABLE=yes`` to enable it. [GitHub#479]
+
+Fixes
+^^^^^
+
+* [:doc:`/reference/commands/load`] Fixed a crash bug when
+  nonexistent column is specified. [GitHub#493]
+
+* [:doc:`/reference/commands/load`] Fixed a bug that load command does
+  not return error code correctly. [GitHub#495]
+
+* [:doc:`/reference/commands/load`] Fixed a memory leak when parsing
+  columns parameter in load command.
+
+* [:doc:`/reference/commands/load`] Fixed a bug that only the first
+  array in ``--values`` is handled as a list of column names if ``--columns`` is not
+  specified. [GitHub#497]
+
+* [:doc:`/reference/commands/load`] Fixed to check ``--columns`` more precisely
+  [GitHub#496]
+
+* Fixed a insufficient critical section handling for
+  thread-safety.
+
+* [:doc:`/reference/commands/column_create`] Fixed a crash bug when
+  failed to create a column.
+
+* [:doc:`/reference/commands/table_remove`] Fixed a crash bug to
+  remove nonexistent table. [GitHub#504]
+
+* Fixed a bug that offline index construction against ``WITH_POSITION`` +
+  non-text ``VECTOR`` column ignores position.
+
+* [:doc:`/reference/executables/grndb`] Fixed a bug that cycle
+  reference causes stack over flow.
+
+* [deb] Dropped support for Ubuntu 15.04 (Vivid Vervet)
+
+Thanks
+^^^^^^
+
+* YUKI Hiroshi
+
 .. _release-6-0-0:
 
 Release 6.0.0 - 2016-02-29
@@ -38,7 +260,7 @@ Improvements
 * [``grn_obj_search()``] Supported ``GRN_OP_FUZZY``
   operator. [GitHub#463][Patch by Naoya Murakami]
 
-* [``GRN_TABLE_FUZZY_WITH_TRANSPOSITION``] Added a flag for
+* [``GRN_TABLE_FUZZY_SEARCH_WITH_TRANSPOSITION``] Added a flag for
   ``grn_table_fuzzy_search()``. [GitHub#463][Patch by Naoya Murakami]
 
 * [``GRN_TOKENIZE_ONLY``] Added a new tokenization mode that returns
@@ -86,7 +308,7 @@ Improvements
 * [:doc:`/reference/commands/object_remove`] Added a new command that
   removes an object. ``object_remove`` can also remove a broken object.
 
-* Supported mips/mpisel. [debian-bugs:770243][Reported by Nobuhiro
+* Supported mips/mipsel. [debian-bugs:770243][Reported by Nobuhiro
   Iwamatsu][Reported by Thorsten Glaser][Reported by YunQiang
   Su][Reported by Dejan Latinovic][Reported by Steve Langasek]
 

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

@@ -55,7 +55,7 @@ they are meaningless. Because the max table/column name size is
 Here are example definitions of table and column for managing aliases:
 
 .. groonga-command
-.. include:: ../../example/reference/alias/table_and_column.log
+.. include:: ../example/reference/alias/table_and_column.log
 .. table_create Aliases TABLE_HASH_KEY ShortText
 .. column_create Aliases real_name COLUMN_SCALAR ShortText
 
@@ -65,13 +65,13 @@ register the table and column by the following
 :doc:`/reference/commands/config_set`:
 
 .. groonga-command
-.. include:: ../../example/reference/alias/register.log
+.. include:: ../example/reference/alias/register.log
 .. config_set alias.column Aliases.real_name
 
 Here are schema and data to show how to use alias:
 
 .. groonga-command
-.. include:: ../../example/reference/alias/schema.log
+.. include:: ../example/reference/alias/schema.log
 .. table_create Users TABLE_HASH_KEY ShortText
 .. column_create Users age COLUMN_SCALAR UInt8
 ..
@@ -84,14 +84,14 @@ Here are schema and data to show how to use alias:
 You can use ``Users.age`` in :doc:`/reference/commands/select`:
 
 .. groonga-command
-.. include:: ../../example/reference/alias/select_age.log
+.. include:: ../example/reference/alias/select_age.log
 .. select Users --filter 'age < 20'
 
 You can't use ``Users.age`` when you rename ``Users.age`` to
 ``Users.years`` by :doc:`/reference/commands/column_rename`:
 
 .. groonga-command
-.. include:: ../../example/reference/alias/select_age_after_rename.log
+.. include:: ../example/reference/alias/select_age_after_rename.log
 .. column_rename Users age years
 .. select Users --filter 'age < 20'
 
@@ -99,7 +99,7 @@ But you can use ``Users.age`` by registering ``Users.age`` to
 ``Users.years`` mapping to ``Aliases``.
 
 .. groonga-command
-.. include:: ../../example/reference/alias/select_age_by_alias.log
+.. include:: ../example/reference/alias/select_age_by_alias.log
 .. load --table Aliases
 .. [
 .. {"_key": "Users.age", "real_name": "Users.years"}
@@ -123,7 +123,7 @@ For example, alias isn't resolved in the following example because
 ``Users.years`` exists:
 
 .. groonga-command
-.. include:: ../../example/reference/alias/existing_name.log
+.. include:: ../example/reference/alias/existing_name.log
 .. load --table Aliases
 .. [
 .. {"_key": "Users.years", "real_name": "Users.years_old"}
@@ -150,7 +150,7 @@ records:
 Here is an example to ``Users.age`` is resolved recursively:
 
 .. groonga-command
-.. include:: ../../example/reference/alias/existing_name.log
+.. include:: ../example/reference/alias/existing_name.log
 .. column_rename Users years years_old
 .. select Users --filter 'age < 20'
 

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

@@ -115,7 +115,7 @@ You need to create an index to search normal vector column:
 .. table_create Tags TABLE_PAT_KEY ShortText
 .. column_create Tags bookmark_index COLUMN_INDEX Bookmarks tags
 
-There are no vector column specific way. You can create an index like
+There is no vector column specific way. You can create an index like
 a scalar column.
 
 You can search an element in ``tags`` like full text search syntax.
@@ -272,7 +272,7 @@ forget to specify ``WITH_WEIGHT`` flag to ``column_create``:
 .. table_create Tags TABLE_PAT_KEY ShortText
 .. column_create Tags bookmark_index COLUMN_INDEX|WITH_WEIGHT Bookmarks tags
 
-There are no weight vector column specific way except ``WITH_WEIGHT``
+There is no weight vector column specific way except ``WITH_WEIGHT``
 flag. You can create an index like a scalar column.
 
 You can search an element in ``tags`` like full text search syntax.

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

@@ -0,0 +1,78 @@
+.. -*- rst -*-
+
+.. highlightlang:: none
+
+Request timeout
+===============
+
+Summary
+-------
+
+.. versionadded:: 6.0.2
+
+You can set timeout to each request.
+
+If a request isn't completed until the specified timeout, the request
+is canceled. If you don't set timeout, the request is processed until
+the request is completed.
+
+Request timeout feature is useful when you implement timeout on client
+side. If you only implement timeout only on client side, the request
+keeps processing after client stops waiting response. It uses needless
+resources. If you set timeout to the request, the request will be
+canceled soon.
+
+How to set timeout to request
+-----------------------------
+
+All commands accept ``request_timeout`` parameter. You can set timeout
+to request by adding ``request_timeout`` parameter.
+
+Unit of timeout out value is second. You can set timeout less than 1
+second by using decimal such as ``0.1``. ``0.1`` means 100
+milliseconds.
+
+Here is an example to set ``5.5`` seconds timeout to a request::
+
+  select Users --request_timeout 5.5
+
+Return code on timeout
+----------------------
+
+If the request is timed out, ``GRN_CANCEL`` (``-77``)
+:doc:`return_code` is returned in response header.
+
+Here is an example response on timeout::
+
+  [
+    [
+      -77,
+      1459846102.63304,
+      0.000220775604248047,
+      "[request-canceler] a request is canceled: <0x7fa0d5d7ed00>"
+    ]
+  ]
+
+See :doc:`/reference/command/output_format` for response header.
+
+Enable request timeout by default
+---------------------------------
+
+:doc:`/reference/executables/groonga` supports enabling request
+timeout by default. You can specify the default request timeout by
+:option:`--default-request-timeout`.
+
+If the default request timeout is larger than 0 second, the default
+request timeout is used as request timeout for all requests.
+
+You can overwrite the default request timeout by specifying
+``request_timeout`` parameter to request. If the default request
+timeout is 3 seconds and ``request_timeout`` parameter is 1 second,
+the request is canceled after 1 second.
+
+See also
+--------
+
+* :doc:`/reference/command/return_code`
+* :doc:`/reference/command/output_format`
+* :doc:`/reference/commands/request_cancel`

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

@@ -97,6 +97,12 @@ only C API. It is not showen in query API.
 * -69: ``GRN_TOO_SMALL_LIMIT``
 * -70: ``GRN_CAS_ERROR``
 * -71: ``GRN_UNSUPPORTED_COMMAND_VERSION``
+* -72: ``GRN_NORMALIZER_ERROR``
+* -73: ``GRN_TOKEN_FILTER_ERROR``
+* -74: ``GRN_COMMAND_ERROR``
+* -75: ``GRN_PLUGIN_ERROR``
+* -76: ``GRN_SCORER_ERROR``
+* -77: ``GRN_CANCEL``
 
 See also
 --------

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

@@ -18,5 +18,6 @@ This section describes about command and built-in commands.
    command/output_format
    command/pretty_print
    command/request_id
+   command/request_timeout
    command/return_code
    commands/*

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

@@ -367,7 +367,7 @@ See :ref:`column-copy-to-table` for example.
 Optional parameters
 ^^^^^^^^^^^^^^^^^^^
 
-There is no optional parameters.
+There is no optional parameter.
 
 Return value
 ------------

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

@@ -67,7 +67,7 @@ You can't use an empty string as key.
 Optional parameters
 ^^^^^^^^^^^^^^^^^^^
 
-There is no optional parameters.
+There is no optional parameter.
 
 Return value
 ------------

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

@@ -67,7 +67,7 @@ You can't use an empty string as key.
 Optional parameters
 ^^^^^^^^^^^^^^^^^^^
 
-There is no optional parameters.
+There is no optional parameter.
 
 Return value
 ------------

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

@@ -68,7 +68,7 @@ The max value size is 4091B (= 4KiB - 5B).
 Optional parameters
 ^^^^^^^^^^^^^^^^^^^
 
-There is no optional parameters.
+There is no optional parameter.
 
 Return value
 ------------

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

@@ -66,12 +66,12 @@ This section describes all parameters.
 Required parameters
 ^^^^^^^^^^^^^^^^^^^
 
-There is no required parameters.
+There is no required parameter.
 
 Optional parameters
 ^^^^^^^^^^^^^^^^^^^
 
-There is no optional parameters.
+There is no optional parameter.
 
 Return value
 ------------

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

@@ -173,7 +173,7 @@ This section describes all parameters.
 Required parameters
 ^^^^^^^^^^^^^^^^^^^
 
-There is no required parameters.
+There is no required parameter.
 
 Optional parameters
 ^^^^^^^^^^^^^^^^^^^

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

@@ -37,7 +37,7 @@ This section describes all parameters.
   ``Format 2:``
     [{COLUMN_NAME1: VALUE1, COLUMN_NAME2: VALUE2}, {COLUMN_NAME1: VALUE1, COLUMN_NAME2: VALUE2},..]
 
-  ``[COLUMN_NAME1, COLUMN_NAME2,..]`` format in ``Format 1`` is effective only when ``column`` parameter isn't specified.
+  ``[COLUMN_NAME1, COLUMN_NAME2,..]`` format in ``Format 1`` is effective only when ``columns`` parameter isn't specified.
 
   When a target table contains primary key, you must specify ``_key`` column (pseudo column associated primary key) as the one of ``COLUMN_NAME``.
 

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

@@ -11,10 +11,6 @@
 Summary
 -------
 
-.. note::
-
-   This command is an experimental feature.
-
 .. versionadded:: 5.0.0
 
 ``logical_count`` is a command to count matched records even though actual records are stored into parted tables. It is useful for users because there is less need to care about maximum records of table :doc:`/limitations`.
@@ -118,8 +114,8 @@ Parameters
 
 This section describes parameters of ``logical_count``.
 
-Required parameter
-^^^^^^^^^^^^^^^^^^
+Required parameters
+^^^^^^^^^^^^^^^^^^^
 
 There are required parameters, ``logical_table`` and ``shard_key``.
 

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

@@ -11,10 +11,6 @@
 Summary
 -------
 
-.. note::
-
-   This command is an experimental feature.
-
 .. versionadded:: 5.0.6
 
 ``logical_parameters`` is a command for test. Normally, you don't need
@@ -77,7 +73,7 @@ This section describes parameters.
 Required parameters
 ^^^^^^^^^^^^^^^^^^^
 
-There is no required parameters.
+There is no required parameter.
 
 Optional parameters
 ^^^^^^^^^^^^^^^^^^^

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

@@ -11,10 +11,6 @@
 Summary
 -------
 
-.. note::
-
-   This command is an experimental feature.
-
 .. versionadded:: 5.0.0
 
 TODO: Write summary
@@ -63,8 +59,8 @@ Parameters
 
 This section describes parameters of ``logical_range_filter``.
 
-Required parameter
-^^^^^^^^^^^^^^^^^^
+Required parameters
+^^^^^^^^^^^^^^^^^^^
 
 There are required parameters, ``logical_table`` and ``shard_key``.
 

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

@@ -11,10 +11,6 @@
 Summary
 -------
 
-.. note::
-
-   This command is an experimental feature.
-
 .. versionadded:: 5.0.5
 
 ``logical_select`` is a sharding version of
@@ -210,8 +206,8 @@ Parameters
 
 This section describes parameters of ``logical_select``.
 
-Required parameter
-^^^^^^^^^^^^^^^^^^
+Required parameters
+^^^^^^^^^^^^^^^^^^^
 
 There are required parameters, ``logical_table`` and ``shard_key``.
 
@@ -283,7 +279,7 @@ table. ``Entry_20150708`` isn't used.
 ``min_border``
 """"""""""""""
 
-Specifies whether the minimum value is include or not. Here is
+Specifies whether the minimum value is included or not. Here is
 available values.
 
 .. list-table::
@@ -335,7 +331,7 @@ table. ``Entry_20150709`` isn't used.
 ``max_border``
 """"""""""""""
 
-Specifies whether the maximum value is include or not. Here is
+Specifies whether the maximum value is included or not. Here is
 available values.
 
 .. list-table::

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

@@ -11,10 +11,6 @@
 Summary
 -------
 
-.. note::
-
-   This command is an experimental feature.
-
 .. versionadded:: 5.0.7
 
 ``logical_shard_list`` returns all existing shard names against the
@@ -82,7 +78,7 @@ The list is sorted by shard name in ascending order.
 Optional parameters
 ^^^^^^^^^^^^^^^^^^^
 
-There is no optional parameters.
+There is no optional parameter.
 
 Return value
 ------------