rroonga 5.0.4-x86-mingw32 → 5.0.5-x86-mingw32

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

@@ -7,6 +7,325 @@
 News
 ====
 
+.. _release-5-0-7:
+
+Release 5.0.7 - 2015-08-31
+--------------------------
+
+This release includes a bug fix of :ref:`offline-index-construction`.
+
+If you're using any multiple column index (index column with
+``WITH_SECTION`` flag) and :ref:`offline-index-construction`, we
+recommend that you upgrade your Groonga.
+
+This release has an important experimental feature for Windows users.
+See "sparse file support" entry in the following improvement list for
+details.
+
+Improvements
+^^^^^^^^^^^^
+
+* [experimental][Windows] Added sparse file support. It's experimental
+  feature. It's disabled by default. You can enable it by specifying
+  ``GRN_IO_USE_SPARSE=yes`` environment variable.
+
+  It reduces database file size on Windows. Please try the feature and
+  report the result. Groonga developers are interested in the
+  followings:
+
+  * Disk usage
+  * Performance (Improved? Degraded? No difference?)
+  * Memory usage (Especially virtual memory usage)
+
+* [experimental][:doc:`/reference/commands/logical_shard_list`] Added
+  a command that returns a shard list of the specified logical table.
+
+* [experimental][:ref:`script-syntax-regular-expression-operator`]
+  Supported regular expression match against vector column without
+  index.
+
+* [:doc:`/reference/commands/logical_range_filter`] Supported
+  ``--cache no`` option. It's same as :ref:`select-cache` option in
+  :doc:`/reference/commands/select`.
+
+* [:doc:`/reference/executables/groonga-httpd`] Supported returning
+  the max number of threads feature of
+  :doc:`/reference/commands/thread_limit`. You can't set the max
+  number of threads.
+
+* [:c:func:`grn_db_unmap()`] Added a new API that unmaps all opened
+  tables and columns. It's a thread unsafe operation. You can't touch
+  the database while :c:func:`grn_db_unmap()` is running.
+
+* [:doc:`/reference/commands/database_unmap`] Added a command that
+  unmaps all opened tables and columns in database.
+
+* [:doc:`/reference/commands/object_exist`] Added a command that
+  checks whether object with the specified name exists or not in
+  database.
+
+* [:doc:`/reference/commands/column_copy`] Added a command that copies
+  all values from source column to destination column.
+
+  You can use this command to change column value type, column type,
+  table type and so on.
+
+* Stopped to use non-standard ``__uint32_t``
+  type. [GitHub#375][Reported by Natanael Copa]
+
+* [experimental][Windows] Supported Windows Event log.
+
+* [mruby] Supported error handling on mruby initialization error.
+
+* [experimental][:doc:`/reference/commands/thread_limit`] Renamed from
+  ``thread_count``.
+
+* Supported logging used indexes in ``info`` level and ``debug``
+  level. It can be used like ``EXPLAIN`` in RDBMS. It's useful to
+  improve slow query.
+
+* [doc] Replaced deprecated ``KEY_NORMALIZE`` flags.
+  [GitHub#378][GitHub#380][GitHub#382] [Patch by Hiroyuki Sato]
+
+* [doc] Removed needless Sphinx configurations.
+  [GitHub#379] [Patch by Ayumu Osanai]
+
+* [experimental][incompatible][:ref:`script-syntax-regular-expression-operator`]
+  Changed ``.`` match behavior. ``.`` matches new line. It's backward
+  incompatible change.
+
+* [doc][:doc:`/contribution/development/build`] Added a document about
+  building Groonga as Groonga developer.
+  [GitHub#353] [Suggested by Hiro Yoshioka]
+
+Fixes
+^^^^^
+
+* [mruby] Fixed a time overflow bug.
+
+* [:doc:`/reference/executables/groonga`] Fixed a crash bug when
+  PID file can't be created. [GitHub#368] [Reported by Hiroyuki Sato]
+
+* Fixed a bug that :ref:`offline-index-construction` may generate
+  broken index. It may be caused for multiple column index. In other
+  words, index column with ``WITH_SECTION`` flag may be broken.
+
+  If you're using :ref:`online-index-construction` for index columns
+  with ``WITH_SECTION`` flag, this bug isn't affected.
+
+  You can recover this bug by recreating existing multiple column
+  indexes.
+
+* [:doc:`/reference/functions/query`] Fixed a crash bug when
+  :doc:`/reference/functions/query` is used in :ref:`select-scorer`.
+
+* [:ref:`select-filter`] Fixed a bug that
+  :ref:`script-syntax-bitwise-not` against unsigned int value doesn't
+  work for comparing to ``-NUMBER_LITERAL``.
+
+  For example, the following expression doesn't work::
+
+    ~UINT32_COLUMN == -6
+
+* Fixed a bug that :ref:`script-syntax-regular-expression-operator`
+  doesn't work in multithread.
+
+* Fixed some memory leaks.
+
+* Fixed a build error. [GitHub#381] [Patch by Hiroshi Hatake]
+
+Thanks
+^^^^^^
+
+* Hiroyuki Sato
+* Natanael Copa
+* Ayumu Osanai
+* Hiroshi Hatake
+* Hiro Yoshioka
+
+.. _release-5-0-6:
+
+Release 5.0.6 - 2015-07-29
+--------------------------
+
+Improvements
+^^^^^^^^^^^^
+
+* [:doc:`/install/ubuntu`] Dropped Ubuntu 14.10 (Utopic Unicorn) support. It had been
+  End of Life on July 23, 2015.
+* Supported offline index construction for reference vector. For example, ``load``
+  data before ``column_create`` an index::
+
+    table_create Entries TABLE_NO_KEY
+    column_create Entries numbers COLUMN_VECTOR Int32
+
+    load --table Entries
+    [
+    ["numbers"],
+    [[18, 19, 20]],
+    [[100, 200]]
+    ]
+
+    table_create Numbers TABLE_PAT_KEY Int32
+    column_create Numbers entries_numbers COLUMN_INDEX Entries numbers
+
+    select Numbers --output_columns _key
+
+* Supported ``'vector_text_column @ "element"'`` without index. For example, the
+  ``select`` command in the following commands::
+
+    table_create Memos TABLE_NO_KEY
+    column_create Memos tags COLUMN_VECTOR Text
+
+    load --table Memos
+    [
+    {"tags": ["Groonga", "Rroonga", "Mroonga"]}
+    ]
+
+    select Memos --filter 'tags @ "Rroonga"'
+
+* Supported ``'fixed_size_type_vector_column @ n'`` without index. For example, the
+  ``select`` command in the following commands::
+
+    table_create Memos TABLE_NO_KEY
+    column_create Memos numbers COLUMN_VECTOR Int32
+
+    load --table Memos
+    [
+    {"numbers": [1, 2, 3]}
+    ]
+
+    select Memos --filter 'numbers @ 2'
+
+* [:doc:`/install/centos`][:doc:`/server/package`][:doc:`/reference/executables/groonga-httpd`]
+  Show exit status. [GitHub#357] [Patch by jacob16bit]
+* [:doc:`/install/windows`][:doc:`/reference/executables/groonga`] Supported ``--pid-path``.
+* [:doc:`/install/windows`] Allowed to delete file that is opened by other process.
+* Accepted selector only proc. Note that the proc can't be used as function. It means
+  that the proc can't be used with sequential search.
+* Supported function call with complex argument. An example complex argument is
+  ``Table["key"].column``. For example::
+
+    function(_key, Table["key"].column)
+
+* [doc][:doc:`/tutorial`] Added more description about database creation fails if DB_PATH
+  points to an existing file. [GitHub#354] [Suggested by Hirotaka Takayama]
+* [doc][:doc:`/tutorial`] Described JSON formatting tools.
+  [GitHub#355] [Suggested by tiwawan]
+* [experimental] Added an API to get/set the number of threads. It's a experimental API.
+* [experimental][``thread_count``] Added a command that get/set the number of threads.
+  It's a experimental command.
+* [experimental][:doc:`/reference/executables/groonga`] Supported changing the number
+  of threads by ``thread_count`` command. It's a experimental feature.
+* [experimental][:doc:`/install/windows`] Added Windows event log support.
+  It's a experimental feature.
+* [experimental][:doc:`/reference/executables/groonga`] Added Windows event log related
+  option ``--use-windows-event-log``. It reports logs as Windows events.
+  It's a experimental feature.
+* [:doc:`/install/windows`] Used Groonga's default encoding for log message.
+* Log used indexes in ``INFO`` level. The default level ``NOTICE``. So the logs aren't
+  showed by default.
+* [API] Added :c:func:`grn_log_level_to_string()` and :c:func:`grn_log_level_parse()`.
+* [:doc:`/reference/executables/groonga`] Accepted log level name (e.g. ``info``,
+  ``debug`` and so on) for ``--log-level`` value.
+* [:doc:`/reference/commands/log_level`][:doc:`/reference/commands/log_put`]
+  Accepted log level name for ``--level`` argument.
+* [plugin] Added :c:func:`grn_command_input_get_arguments()`.
+* Updated sharding plugins.
+
+  * [:doc:`/reference/commands/logical_select`] Fixed output format.
+    It has become :doc:`/reference/commands/select` compatible format.
+  * [:doc:`/reference/commands/logical_select`] Supported the following parameters.
+
+    * ``--output_columns``
+    * ``--offset``
+    * ``--limit``
+    * ``--drilldown``
+    * ``--drilldown_sortby``
+    * ``--drilldown_offset``
+    * ``--drilldown_limit``
+
+  * [:doc:`/reference/commands/logical_select`] Used the same default output_columns
+    (``"_id, _key, *"``) as :doc:`/reference/commands/select`.
+  * [:doc:`/reference/commands/logical_select`] Supported
+    :ref:`logical-select-drilldown-label-calc-types` and
+    :ref:`logical-select-drilldown-label-calc-target` for labeled drilldown.
+  * [:doc:`/reference/commands/logical_select`] Supported cache.
+  * [:doc:`/reference/commands/logical_count`] Supported logging whether range index is
+    used or not.
+  * [:doc:`/reference/commands/logical_count`] Show target table name in debug log.
+  * [:doc:`/reference/commands/logical_count`] Supported cache.
+  * [:doc:`/reference/commands/logical_range_filter`] Supported
+    ``'fixed_size_type_vector_column @ element'``.
+  * [:doc:`/reference/commands/logical_range_filter`] Added ``use_range_index`` parameter.
+    It's a parameter for test. It should not be used for production.
+  * [:doc:`/reference/commands/logical_range_filter`] Log which mode (range-index or
+    select mode) is used.
+  * [:doc:`/reference/commands/logical_range_filter`] Supported cache.
+  * [:doc:`/reference/commands/logical_range_filter`] Supported nested reference vector
+    accessor.
+  * [:doc:`/reference/commands/logical_range_filter`] Used range_index value set by
+    :doc:`/reference/commands/logical_parameters`.
+  * [:doc:`/reference/commands/logical_parameters`] Added.
+
+* Added mruby APIs.
+
+  * [mrb] Added ``Accessor#name``.
+  * [mrb] Added ``Column#[]``.
+  * [mrb] Added ``Column#scalar?``, ``Column#vector?`` and ``Column#index?``.
+  * [mrb] Added ``Context#command_version`` and ``Context#command_version=`` (accessors).
+  * [mrb] Added ``Context#with_command_version``.
+  * [mrb] Added ``Database#each_name``.
+  * [mrb] Added ``Groonga::Cache.current``.
+  * [mrb] Added ``Record``.
+  * [mrb] Added ``Table#each``.
+  * [mrb] Added ``TableCursor#key``.
+  * [mrb] Binded :c:func:`grn_command_input_get_arguments()` to ``CommandInput#arguments``.
+  * [mrb] Binded :c:func:`grn_table_group()` to ``Table#group``.
+  * [mrb] Binded :c:func:`grn_table_group_flags()` to ``TableGroupFlags``.
+  * [mrb] Binded ``GRN_COMMAND_VERSION_DEFAULT``.
+  * [mrb] Binded ``grn_cache``.
+  * [mrb][estimate_size] Supported ``(... || ...) && (... || ...)`` as expression case.
+  * [mrb] Supported query log.
+
+Fixes
+^^^^^
+
+* Fixed a memory leak when an error is occurred in :c:func:`grn_expr_exec()`.
+  For example, unsupported operator (e.g. ``GRN_OP_TERM_EXTRACT``) is used
+  (``not implemented operator assigned`` is occurred for the case).
+* [bindings/php] Added a missing check for a memory allocation failure.
+  [Reported by Bill Parker]
+* [:doc:`/install/centos`][:doc:`/server/package`][logrotate] Fixed syntax error in script.
+* [:doc:`/install/centos`][:doc:`/server/package`][logrotate] Fixed wrong daemon running check.
+* [:doc:`/install/centos`][:doc:`/server/package`][logrotate] Stop to set owner/group to log files.
+  Because it's not consistent. groonga-httpd creates log files with root
+  owner/group. But logrotated log files are created with groonga
+  owner/group. [GitHub#358] [Reported by jacob16bit]
+* [:doc:`/reference/executables/groonga`] Fixed reported the maximum number of threads.
+* [:doc:`/reference/executables/groonga-httpd`] Remove a needless space in log message::
+
+    |n|  grn_fin (0) ->
+    |n| grn_fin (0)
+        ^
+
+* Fixed a bug that estimating size by regexp query with anchor (e.g. ``\\\\A`` in
+  ``--filter 'comment @~ "\\\\Abc"'``) doesn't work. The feature is used in
+  :doc:`/reference/commands/logical_range_filter`.
+* [:doc:`/reference/command/request_id`] Fixed a memory leak when ``request_id`` byte size >= 24.
+* [:doc:`/reference/commands/lock_clear`] Fixed a typo in command name in Syntax section.
+  [GitHub#363] [Reported by Christian Kakesa]
+* [sharding] Fixed wrong min include detection for month range type.
+
+Thanks
+^^^^^^
+
+* Bill Parker
+* jacob16bit
+* Hirotaka Takayama
+* tiwawan
+* Christian Kakesa
+
 .. _release-5-0-5:
 
 Release 5.0.5 - 2015-06-29

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

@@ -26,6 +26,7 @@ Reference manual
    reference/operations
    reference/suggest
    reference/indexing
+   reference/sharding
    reference/log
    reference/tuning
    reference/api

data/vendor/local/share/doc/groonga/ja/html/_sources/reference/api/grn_ctx.txt

@@ -13,7 +13,7 @@ keeps the current infomation such as:
 
 * The last occurred error.
 * The current encoding.
-* The default thresholds. (e.g. :ref:`match-escalation-threshold`)
+* The default thresholds. (e.g. :ref:`select-match-escalation-threshold`)
 * The default command version. (See :doc:`/reference/command/command_version`)
 
 :c:type:`grn_ctx` provides platform features such as:

data/vendor/local/share/doc/groonga/ja/html/_sources/reference/api/grn_db.txt

@@ -109,3 +109,26 @@ TODO...
 
    :param db: The database to be recovered.
    :return: ``GRN_SUCCESS`` on success, not ``GRN_SUCCESS`` on error.
+
+.. c:function:: grn_rc grn_db_unmap(grn_ctx *ctx, grn_obj *db)
+
+   .. note::
+
+      This is an experimental API.
+
+   .. note::
+
+      This is a thread unsafe API. You can't touch the database while
+      this API is running.
+
+   .. versionadded:: 5.0.7
+
+   Unmaps all opened tables and columns in the passed
+   database. Resources used by these opened tables and columns are
+   freed.
+
+   Normally, this API isn't useless. Because resources used by opened
+   tables and columns are managed by OS automatically.
+
+   :param db: The database to be recovered.
+   :return: ``GRN_SUCCESS`` on success, not ``GRN_SUCCESS`` on error.

data/vendor/local/share/doc/groonga/ja/html/_sources/reference/api/grn_thread.txt

@@ -0,0 +1,122 @@
+.. -*- rst -*-
+
+.. highlightlang:: none
+
+``grn_thread_*``
+================
+
+Summary
+-------
+
+Groonga provides thread related APIs with ``grn_thread_`` prefix.
+
+Normally, you don't need to use these APIs.
+
+You may want to use these APIs when you write a Groonga server.
+
+Example
+-------
+
+Here is a real word use case of ``grn_thread_*`` APIs by
+:doc:`/reference/executables/groonga`. :doc:`/reference/executables/groonga`
+increases its thread pool size when the max number of threads is
+increased. :doc:`/reference/executables/groonga` decreases its thread
+pool size and stops too many threads when the max number of threads is
+decreased.
+
+.. code-block :: c
+
+   static grn_mutex q_mutex;
+   static grn_cond q_cond;
+   static uint32_t nfthreads;
+   static uint32_t max_nfthreads;
+
+   static uint32_t
+   groonga_get_thread_limit(void *data)
+   {
+     return max_nfthreads;
+   }
+
+   static void
+   groonga_set_thread_limit(uint32_t new_limit, void *data)
+   {
+     uint32_t i;
+     uint32_t current_nfthreads;
+
+     MUTEX_LOCK(q_mutex);
+     current_nfthreads = nfthreads;
+     max_nfthreads = new_limit;
+     MUTEX_UNLOCK(q_mutex);
+
+     if (current_nfthreads > new_limit) {
+       for (i = 0; i < current_nfthreads; i++) {
+         MUTEX_LOCK(q_mutex);
+         COND_SIGNAL(q_cond);
+         MUTEX_UNLOCK(q_mutex);
+       }
+     }
+   }
+
+   int
+   main(int argc, char *argv)
+   {
+     /* ... */
+     grn_thread_set_get_limit_func(groonga_get_thread_limit, NULL);
+     grn_thread_set_set_limit_func(groonga_set_thread_limit, NULL);
+
+     grn_init();
+
+     /* ... */
+   }
+
+Reference
+---------
+
+.. c:type:: uint32_t (*grn_thread_get_limit_func)(void *data)
+
+   It's the type of function that returns the max number of threads.
+
+.. c:type:: void (*grn_thread_set_limit_func)(uint32_t new_limit, void *data)
+
+   It's the type of function that sets the max number of threads.
+
+.. c:function:: uint32_t grn_thread_get_limit(void)
+
+   It returns the max number of threads.
+
+   If :c:type:`grn_thread_get_limit_func` isn't set by
+   :c:func:`grn_thread_set_get_limit_func()`, it always returns ``0``.
+
+   :return: The max number of threads or ``0``.
+
+.. c:function:: void_t grn_thread_set_limit(uint32_t new_limit)
+
+   It sets the max number of threads.
+
+   If :c:type:`grn_thread_set_limit_func` isn't set by
+   :c:func:`grn_thread_set_set_limit_func()`, it does nothing.
+
+   :param new_limit: The new max number of threads.
+
+.. c:function:: void grn_thread_set_get_limit_func(grn_thread_get_limit_func func, void *data)
+
+   It sets the custom function that returns the max number of threads.
+
+   ``data`` is passed to ``func`` when ``func`` is called from
+   :c:func:`grn_thread_get_limit()`.
+
+   :param func: The custom function that returns the max number of threads.
+   :param data: An user data to be passed to ``func`` when ``func``
+                is called.
+
+.. c:function:: void grn_thread_set_set_limit_func(grn_thread_set_limit_func func, void *data)
+
+   It sets the custom function that sets the max number of threads.
+
+   ``data`` is passed to ``func`` when ``func`` is called from
+   :c:func:`grn_thread_set_limit()`.
+
+   :param func: The custom function that sets the max number of threads.
+   :param data: An user data to be passed to ``func`` when ``func``
+                is called.
+