rroonga 5.1.1-x86-mingw32 → 6.0.0-x86-mingw32

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

@@ -7,6 +7,290 @@
 News
 ====
 
+.. _release-6-0-0:
+
+Release 6.0.0 - 2016-02-29
+--------------------------
+
+Improvements
+^^^^^^^^^^^^
+
+* [:doc:`/reference/executables/grndb`] Supported check against table
+  specified as table domain in ``--target`` mode.
+
+* [``grn_pat_fuzzy_search()``] Added a new API that provides fuzzy
+  search feature by patricia trie. [GitHub#460][Patch by Naoya
+  Murakami]
+
+* [``functions/string``] Added a new plugin that provides string
+  related functions. [GitHub#459][Patch by Naoya Murakami]
+
+* [``string_length()``] Added a new function that returns the number
+  of characters in the specified string. It's contained in
+  ``functions/string`` plugin. [GitHub#459][Patch by Naoya Murakami]
+
+* [``grn_table_fuzzy_search()``] Added a new DB API that provides
+  fuzzy search feature. [GitHub#463][Patch by Naoya Murakami]
+
+* [``GRN_OP_FUZZY``] Added a new operator. [GitHub#463][Patch by Naoya
+  Murakami]
+
+* [``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()``. [GitHub#463][Patch by Naoya Murakami]
+
+* [``GRN_TOKENIZE_ONLY``] Added a new tokenization mode that returns
+  all tokens even if the token doesn't exist in
+  lexicon. [GitHub#463][Patch by Naoya Murakami]
+
+* [``grn_obj_type_to_string()``] Add a new function that stringify
+  type ID such as ``GRN_VOID`` and ``GRN_BULK``.
+
+* [:doc:`/reference/commands/object_inspect`] Added a new command that
+  returns information of the target object.
+
+* Supported compare operations against vector. If left hand side
+  vector includes any element that satisfies ``left_hand_side_element
+  OP right_hand_side``, it returns true.
+
+  Example::
+
+    [1, 2, 3] < 2 # -> true because 1 is less than 2
+    [1, 2, 3] > 4 # -> false because all elements are less than 4
+
+* [``fuzzy_search()``] Added a new function that provides fuzzy search
+  feature. [GitHub#464][Patch by Naoya Murakami]
+
+* [:doc:`/reference/functions/edit_distance`] Supported transposition
+  flag. [GitHub#464][Patch by Naoya Murakami]
+
+* Supported index search for ``vector_column[2] == 29``.
+
+* [``GRN_PLUGIN_CALLOC()``] Added a new API for plugin that provides
+  ``calloc()`` feature. [GitHub#472][Patch by Naoya Murakami]
+
+* Supported index search for compare operations against vector element
+  such as ``vector_column[2] < 29``.
+
+* [``grn_plugin_proc_get_var_bool()``] Add a new API for plugin that
+  provides getting boolean argument value feature.
+
+* [``grn_plugin_proc_get_var_int32()``] Add a new API for plugin that
+  provides getting 32bit integer argument value feature.
+
+* [``grn_plugin_proc_get_var_string()``] Add a new API for plugin that
+  provides getting string argument value feature.
+
+* [: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
+  Iwamatsu][Reported by Thorsten Glaser][Reported by YunQiang
+  Su][Reported by Dejan Latinovic][Reported by Steve Langasek]
+
+* [:doc:`/reference/executables/grndb`][CMake] Supported.
+
+* [``grn_expr_syntax_expand_query()``] Added a new API that provides
+  query expansion feature.
+
+* [``snippet()``] Add a new function that provides snippet feature.
+  [GitHub#481][Patch by Naoya Murakami]
+
+* [``highlight()``] Add a new function that provides highlight feature.
+  [GitHub#487][Patch by Naoya Murakami]
+
+* Added ``XXX && column != xxx`` optimization. It's converted to ``XXX
+  &! column == xxx`` internally.
+
+* [:doc:`/server/memcached`] Added ``--memcached-column``. You can
+  access existing column by memcached protocol.
+
+* [:doc:`/reference/executables/groonga-httpd`] Supported TLS.
+  [groonga-dev,03948][Reported by KITAITI Makoto]
+
+* [:doc:`/reference/executables/groonga-httpd`] Updated bundled nginx
+  version to 1.9.11 from 1.9.10.
+
+* [Windows][CMake] Supported LZ4. LZ4 is bundled.
+
+Fixes
+^^^^^
+
+* [:doc:`/reference/commands/select`] Added a missing error check for
+  outputting column. [GitHub#332][Reported by Masafumi Yokoyama]
+
+* Fixed a bug that ``function(column_with_index) == 29`` ignores
+  ``function()``. [groonga-dev,03884][Reported by Naoya Murakami]
+
+* [:doc:`/reference/commands/reindex`] Fixed a bug that ``reindex``
+  doesn't clear query cache.
+
+* [patricia trie] Fixed a bug that sorting by integer patricia trie
+  key returns unsorted result. [GitHub#476][Reported by Ryunosuke SATO]
+
+* [:doc:`/reference/commands/select`] Fixed a crash bug that is
+  occurred when too many keywords is specified into ``--query``.
+  [GitHub#484][Reported by Hiroyuki Sato]
+
+* [:doc:`/reference/commands/select`] Fixed a bug that wrong cache is
+  used when :doc:`/reference/command/command_version` or
+  :doc:`/reference/command/pretty_print` is
+  used. [GitHub#490][Reported by KITAITI Makoto]
+
+Thanks
+^^^^^^
+
+* Masafumi Yokoyama
+
+* Naoya Murakami
+
+* Nobuhiro Iwamatsu
+
+* Thorsten Glaser
+
+* YunQiang Su
+
+* Dejan Latinovic
+
+* Steve Langasek
+
+* Ryunosuke SATO
+
+* Hiroyuki Sato
+
+* KITAITI Makoto
+
+.. _release-5-1-2:
+
+Release 5.1.2 - 2016-01-29
+--------------------------
+
+Improvements
+^^^^^^^^^^^^
+
+* Improved performance for sequential search against constant value
+  such as ``true`` and ``29``.
+
+* Improved performance for sequential search against binary operation
+  with constant value such as ``x == 29`` and ``x < 29``.
+
+* [:doc:`/reference/commands/select`] Changed score type to ``Float``
+  from ``Int32`` when :doc:`/reference/command/command_version` is 2.
+  The current default command version is 1. Command version 2 is
+  experimental. So this change isn't affected to normal users.
+  [GitHub#450][Patch by Naoya Murakami]
+
+* [grn_ts] Supported match operator.
+
+* [:doc:`/reference/executables/grndb`] Added ``--target`` option to
+  ``check`` command. It reduces check target.
+
+* [Windows] Updated bundled msgpack to 1.3.0 from 1.0.1.
+
+* [Windows] Updated bundled MeCab to 0.996 from 0.98.
+
+* [``grn_hash_size()``] Added a new API that returns the number of
+  records in the hash table.
+
+* [``GRN_HASH_TINY``] Added a new flag to create tiny hash table.
+
+* [``grn_dump_table_create_flags()``] Added a new API that converts
+  ``flags`` value of a table to ``flags`` parameter format of
+  :doc:`/reference/commands/table_create`.
+
+* [``grn_dump_column_create_flags()``] Added a new API that converts
+  ``flags`` value of a column to ``flags`` parameter format of
+  :doc:`/reference/commands/column_create`.
+
+* [``grn_plugin_get_names()``] Added a new API that returns all plugin
+  names in a database.
+
+* [``grn_column_get_all_index_data()``] Added a new API that returns
+  all index data for a table or data column.
+
+* [:doc:`/reference/commands/schema`] Added indexes information to
+  indexed tables and data columns.
+
+* [``grn_config_get()``] Renamed from ``grn_conf_get()``.
+
+* [``grn_config_set()``] Renamed from ``grn_conf_set()``.
+
+* [``grn_config_delete()``] Added a new API that deletes a
+  configuration item.
+
+* [:doc:`/reference/commands/config_set`] Added a new command that
+  sets a configuration item.
+
+* [:doc:`/reference/commands/config_get`] Added a new command that
+  gets a configuration item value.
+
+* [:doc:`/reference/commands/config_delete`] Added a new command that
+  deletes a configuration item.
+
+* [``grn_config_cursor_open()``] Added a new API that opens a new
+  cursor that iterates all configuration items.
+
+* [``grn_config_cursor_next()``] Added a new API that moves to the
+  next configuration item in the cursor.
+
+* [``grn_config_cursor_get_key()``] Added a new API that gets the
+  key of the current configuration item.
+
+* [``grn_config_cursor_get_value()``] Added a new API that gets the
+  value of the current configuration item.
+
+* [:doc:`/reference/alias`] Supported aliasing table and column names.
+
+* [hash table] Added total key size overflow check.
+
+* [:doc:`/reference/commands/dump`] Supported dumping configurations
+  set by :doc:`/reference/commands/config_set`.
+
+* [patricia trie] Improved inspection.
+  [GitHub#452][GitHub#457][Patch by Naoya Murakami]
+
+* [``grn_get_global_error_message()``] Added a new API that gets the
+  current error message in the process.
+
+* [:doc:`/reference/commands/lock_acquire`] Added a new command that
+  acquires a lock of a database, table or column.
+
+* [:doc:`/reference/commands/lock_release`] Added a new command that
+  releases a lock of a database, table or column.
+
+* [:doc:`/reference/executables/groonga-httpd`] Updated bundled nginx
+  version to 1.9.10 from 1.9.7.
+
+Fixes
+^^^^^
+
+* Fixed mruby related crash bugs.
+
+* [Windows] Fixed label in installer.
+  [groonga-dev,03825][Reported by Atsushi Shinoda]
+
+* [doc] Fixed typos.
+  [GitHub#456][GitHub#458][Patch by tSU_RooT]
+
+* [:doc:`/server/memcached`] Added more description.
+  [GitHub#454][Patch by Hiroyuki Sato]
+
+* Fixed a bug that :doc:`/reference/command/command_version` specified
+  by ``command_version`` parameter in a request isn't reset.
+
+Thanks
+^^^^^^
+
+* Naoya Murakami
+
+* Atsushi Shinoda
+
+* tSU_RooT
+
+* Hiroyuki Sato
+
 .. _release-5-1-1:
 
 Release 5.1.1 - 2015-12-29
@@ -163,9 +447,10 @@ Improvements
 * [Windows][CMake] Supported building bundled MeCab.
   [groonga-dev,03562][Reported by Sato]
 
-* [``schema``] Added a new command that returns schema. Schema is
-  consists with loaded plugins, loaded tokenizers, loaded normalizers,
-  loaded token filters, defined tables and defined columns.
+* [:doc:`/reference/commands/schema`] Added a new command that returns
+  schema. Schema is consists with loaded plugins, loaded tokenizers,
+  loaded normalizers, loaded token filters, defined tables and defined
+  columns.
 
 * [:c:func:`grn_plugin_win32_base_dir()`] Deprecated. Use
   :c:func:`grn_plugin_windows_base_dir()` instead.

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

@@ -24,6 +24,8 @@ Reference manual
    reference/regular_expression
    reference/function
    reference/operations
+   reference/configuration
+   reference/alias
    reference/suggest
    reference/indexing
    reference/sharding

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

@@ -0,0 +1,164 @@
+.. -*- rst -*-
+
+.. highlightlang:: none
+
+.. groonga-command
+.. database: alias
+
+Alias
+=====
+
+.. versionadded:: 5.1.2
+
+You can refer a table and column by multiple names by using alias
+feature.
+
+Summary
+-------
+
+The alias feature is useful for the following cases:
+
+  * You want to rename a table but you can't change some Groonga
+    clients that uses the current table name.
+
+  * You want to change column type without downtime.
+
+In the former case, some Groonga clients can use the current table
+name after you rename a table. Because the alias feature maps the
+current table name to the renamed new table name.
+
+In the latter case, all Groonga clients access the column by aliased
+name such as ``aliased_column``. ``aliased_column`` refers
+``current_column``. You create a new column ``new_column`` with new
+type and copy data from ``current_column`` by
+:doc:`/reference/commands/column_copy`. You change ``aliased_column``
+to refer ``new_column`` from ``current_column``. Now, all Groonga
+clients access ``new_column`` by ``aliased_column`` without stopping
+search requests.
+
+Usage
+-----
+
+You manage alias to real name mapping by a normal table and a normal
+column.
+
+You can use any table type except :ref:`table-no-key` for the
+table. :ref:`table-hash-key` is recommended because exact key match
+search is only used for the alias feature. :ref:`table-hash-key` is
+the fastest table type for exact key match search.
+
+The column must be :doc:`/reference/columns/scalar` and type is
+``ShortText``. You can also use ``Text`` and ``LongText`` types but
+they are meaningless. Because the max table/column name size is
+4KiB. ``ShortText`` can store 4KiB data.
+
+Here are example definitions of table and column for managing aliases:
+
+.. groonga-command
+.. include:: ../../example/reference/alias/table_and_column.log
+.. table_create Aliases TABLE_HASH_KEY ShortText
+.. column_create Aliases real_name COLUMN_SCALAR ShortText
+
+You need to register the table and column by :doc:`configuration`.
+The alias feature uses ``alias.column`` configuration item. You can
+register the table and column by the following
+:doc:`/reference/commands/config_set`:
+
+.. groonga-command
+.. 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
+.. table_create Users TABLE_HASH_KEY ShortText
+.. column_create Users age COLUMN_SCALAR UInt8
+..
+.. load --table Users
+.. [
+.. {"_key": "alice", "age": 14},
+.. {"_key": "bob",   "age": 29}
+.. ]
+
+You can use ``Users.age`` in :doc:`/reference/commands/select`:
+
+.. groonga-command
+.. 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
+.. column_rename Users age years
+.. select Users --filter 'age < 20'
+
+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
+.. load --table Aliases
+.. [
+.. {"_key": "Users.age", "real_name": "Users.years"}
+.. ]
+..
+.. select Users --filter 'age < 20'
+
+Now, you can use ``Users.age`` as alias of ``Users.years``.
+
+How to resolve alias
+--------------------
+
+This section describes how to resolve alias.
+
+Groonga uses the alias feature when nonexistent object name (table
+name, column name, command name, function name and so on) is
+referred. It means that you can't override existing object (table,
+column, command, function and so on) by the alias feature.
+
+For example, alias isn't resolved in the following example because
+``Users.years`` exists:
+
+.. groonga-command
+.. include:: ../../example/reference/alias/existing_name.log
+.. load --table Aliases
+.. [
+.. {"_key": "Users.years", "real_name": "Users.years_old"}
+.. ]
+..
+.. select Users --filter 'years < 20'
+
+Alias is resolved recursively. If you rename ``Users.years`` to
+``Users.years_old`` and you refer ``Users.age``, Groonga replaces
+``Users.age`` with ``Users.years`` and then ``Users.years`` with
+``Users.years_old``. Because ``Aliases`` table has the following
+records:
+
+.. list-table::
+   :header-rows: 1
+
+   * - ``_key``
+     - ``real_name``
+   * - ``Users.age``
+     - ``Users.years``
+   * - ``Users.years``
+     - ``Users.years_old``
+
+Here is an example to ``Users.age`` is resolved recursively:
+
+.. groonga-command
+.. include:: ../../example/reference/alias/existing_name.log
+.. column_rename Users years years_old
+.. select Users --filter 'age < 20'
+
+See also
+--------
+
+  * :doc:`/reference/configuration`
+  * :doc:`/reference/commands/config_set`
+  * :doc:`/reference/commands/table_create`
+  * :doc:`/reference/commands/column_create`
+  * :doc:`/reference/commands/select`