rroonga 4.0.0-x64-mingw32 → 4.0.1-x64-mingw32

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

@@ -74,9 +74,9 @@ Build from source
 Groonga uses GNU build system. So the following is the simplest build
 steps::
 
-  % wget http://packages.groonga.org/source/groonga/groonga-4.0.0.tar.gz
-  % tar xvzf groonga-4.0.0.tar.gz
-  % cd groonga-4.0.0
+  % wget http://packages.groonga.org/source/groonga/groonga-4.0.1.tar.gz
+  % tar xvzf groonga-4.0.1.tar.gz
+  % cd groonga-4.0.1
   % ./configure
   % make
   % sudo make install

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

@@ -17,9 +17,9 @@ Install required packages to build groonga::
 
 Download source::
 
-  % wget http://packages.groonga.org/source/groonga/groonga-4.0.0.tar.gz
-  % gtar xvzf groonga-4.0.0.tar.gz
-  % cd groonga-4.0.0
+  % wget http://packages.groonga.org/source/groonga/groonga-4.0.1.tar.gz
+  % gtar xvzf groonga-4.0.1.tar.gz
+  % cd groonga-4.0.1
 
 Configure with ``CFLAGS="-m64" CXXFLAGS="-m64"`` variables. They are
 needed for building 64-bit version. To build 32-bit version, just

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

@@ -206,9 +206,9 @@ Install required packages to build groonga::
 
 Download source::
 
-  % wget http://packages.groonga.org/source/groonga/groonga-4.0.0.tar.gz
-  % tar xvzf groonga-4.0.0.tar.gz
-  % cd groonga-4.0.0
+  % wget http://packages.groonga.org/source/groonga/groonga-4.0.1.tar.gz
+  % tar xvzf groonga-4.0.1.tar.gz
+  % cd groonga-4.0.1
 
 Configure (see :ref:`source-configure` about ``configure`` options)::
 

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

@@ -21,14 +21,14 @@ Installer
 For 32-bit environment, download x86 executable binary from
 packages.groonga.org:
 
-  * http://packages.groonga.org/windows/groonga/groonga-4.0.0-x86.exe
+  * http://packages.groonga.org/windows/groonga/groonga-4.0.1-x86.exe
 
 Then run it.
 
 For 64-bit environment, download x64 executable binary from
 packages.goronga.org:
 
-  * http://packages.groonga.org/windows/groonga/groonga-4.0.0-x64.exe
+  * http://packages.groonga.org/windows/groonga/groonga-4.0.1-x64.exe
 
 Then run it.
 
@@ -41,14 +41,14 @@ zip
 For 32-bit environment, download x86 zip archive from
 packages.groonga.org:
 
-  * http://packages.groonga.org/windows/groonga/groonga-4.0.0-x86.zip
+  * http://packages.groonga.org/windows/groonga/groonga-4.0.1-x86.zip
 
 Then extract it.
 
 For 64-bit environment, download x64 zip archive from
 packages.groonga.org:
 
-  * http://packages.groonga.org/windows/groonga/groonga-4.0.0-x64.zip
+  * http://packages.groonga.org/windows/groonga/groonga-4.0.1-x64.zip
 
 Then extract it.
 
@@ -66,27 +66,27 @@ Windows. Here are required tools:
 
 Download zipped source from packages.groonga.org:
 
-  * http://packages.groonga.org/source/groonga/groonga-4.0.0.zip
+  * http://packages.groonga.org/source/groonga/groonga-4.0.1.zip
 
 Then extract it.
 
 Move to the Groonga's source folder::
 
-  > cd c:\Users\%USERNAME%\Downloads\groonga-4.0.0
+  > cd c:\Users\%USERNAME%\Downloads\groonga-4.0.1
 
 Configure by ``cmake``. The following commnad line is for 64-bit
 version. To build 32-bit version, use ``-G "Visual Studio 10"``
 parameter instead::
 
-  groonga-4.0.0> cmake . -G "Visual Studio 10 Win64" -DCMAKE_INSTALL_PREFIX=C:\groonga
+  groonga-4.0.1> cmake . -G "Visual Studio 10 Win64" -DCMAKE_INSTALL_PREFIX=C:\groonga
 
 Build::
 
-  groonga-4.0.0> cmake --build . --config Release
+  groonga-4.0.1> cmake --build . --config Release
 
 Install::
 
-  groonga-4.0.0> cmake --build . --config Release --target Install
+  groonga-4.0.1> cmake --build . --config Release --target Install
 
 After the above steps, :doc:`/reference/executables/groonga` is found in
 ``c:\groonga\bin\groonga.exe``.

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

@@ -5,6 +5,47 @@
 News
 ====
 
+.. _release-4-0-1:
+
+
+Release 4.0.1 - 2014/03/29
+--------------------------
+
+Improvements
+^^^^^^^^^^^^
+
+* [doc] Added a link in return value to detailed header description (:doc:`/reference/command/output_format`).
+* Supported to inspect vector and object value in JSON load.
+  It shows more details about data which is failed to load.
+* Added ``adjuster`` option to select command.
+  adjuster options accepts following syntax: INDEX_COLUMN @ STRING_LITERAL (* FACTOR).
+* Supported :ref:`weight-vector-column`. You need to specify 'COLUMN_VECTOR|WITH_WEIGHT' flags 
+  to create weight vector column.
+* Added missing MIN/MAX macros on SunOS. [GitHub#154] [Patch by Sebastian Wiedenroth]
+* Improved recycling garbage data. It suppress to increse database size.
+* [doc] Added documentation about GET parameters for :doc:`/reference/executables/groonga-suggest-httpd`.
+* [doc] Added documentation about :doc:`/reference/column`.
+* [doc] Added documentation about :doc:`/reference/columns/vector`.
+* [column_list] Supported to show weight vector column.
+* [column_create] Added error check for creating multi column index without WITH_SECTION.
+* [httpd] Enabled stub status module (NginxHttpStubStatusModule) for groonga-httpd. [Suggested by Masahiro Nagano]
+
+Fixes
+^^^^^
+
+* Fixed a bug that a division overflow caused a fatal error.
+  For example, it occurs when you execute 'COLUMN / -1' operation to Int32 or Int64 column. [#2307]
+* Fixed a bug that '%' operations performs '/' operations. [#2307]
+* [doc] Fixed a wrong documentation about :doc:`reference/commands/column_rename`.
+* Fixed the issue that out of bound array element access may occurs. [GitHub#158] [Reported by dcb314]
+
+Thanks
+^^^^^^
+
+* nise_nabe
+* Sebastian Wiedenroth
+* dcb314
+
 .. _release-4-0-0:
 
 

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

@@ -3,8 +3,8 @@
 
 .. highlightlang:: none
 
-リファレンスマニュアル
-======================
+Reference manual
+================
 
 .. toctree::
    :maxdepth: 2
@@ -14,6 +14,7 @@
    reference/command
    reference/types
    reference/tables
+   reference/column
    reference/normalizers
    reference/tokenizers
    reference/query_expanders

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

@@ -0,0 +1,25 @@
+.. -*- rst -*-
+
+.. highlightlang:: none
+
+Column
+======
+
+Column is a data store object or an index object for fast search.
+
+A column belongs to a table. Table has zero or more columns.
+
+Both data store column and index column have type. Type of data store
+column specifies data range. In other words, it is "value type". Type
+of index column specifies set of documents to be indexed. A set of
+documents is a table in Groonga. In other words, type of index column
+must be a table.
+
+Here are data store columns:
+
+  * :doc:`columns/scalar`
+  * :doc:`columns/vector`
+
+Here is an index column:
+
+  * :doc:`columns/index`

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

@@ -0,0 +1,333 @@
+.. -*- rst -*-
+
+.. highlightlang:: none
+
+.. groonga-command
+.. database: columns_vector
+
+Vector column
+=============
+
+Summary
+-------
+
+Vector column is a data store object. It can stores zero or more
+scalar values. In short, scalar value is a single value such as number
+and string. See :doc:`scalar` about scalar value details.
+
+One of vector column use cases is tags store. You can use a vector
+column to store tag values.
+
+You can use vector column as index search target in the same way as
+scalar column. You can set weight for each element. The element that
+has one or more weight is matched, the record has more score rather
+than no weight case. It is a vector column specific feature. Vector
+column that can store weight is called weight vector column.
+
+You can also do full text search against each text element. But search
+score is too high when weight is used. You should use full text search
+with weight carefully.
+
+Usage
+-----
+
+There are three vector column types:
+
+  * Normal vector column
+  * Reference vector column
+  * Weight vector column
+
+This section describes how to use these types.
+
+.. _normal-vector-column:
+
+Normal vector column
+^^^^^^^^^^^^^^^^^^^^
+
+Normal vector column stores zero or more scalar data. For example,
+scalar data are number, string and so on.
+
+A normal vector column can store the same type elements. You can't mix
+types. For example, you can't store a number and a string in the same
+normal vector column.
+
+Normal vector column is useful when a record has multiple values with
+a key. Tags are the most popular use case.
+
+How to create
+"""""""""""""
+
+Use :doc:`/reference/commands/column_create` command to create a
+normal vector column. The point is ``COLUMN_VECTOR`` flag:
+
+.. groonga-command
+.. include:: ../../example/reference/columns/vector/usage_create_normal.log
+.. table_create Bookmarks TABLE_HASH_KEY ShortText
+.. column_create Bookmarks tags COLUMN_VECTOR ShortText
+
+You can set zero or more tags to a bookmark.
+
+How to load
+"""""""""""
+
+You can load vector data by JSON array syntax::
+
+  [ELEMENT1, ELEMENT2, ELEMENT3, ...]
+
+Let's load the following data:
+
+.. list-table::
+   :header-rows: 1
+
+   * - ``_key``
+     - ``tags``
+   * - ``http://groonga.org/``
+     - ``["groonga"]``
+   * - ``http://mroonga.org/``
+     - ``["mroonga", "mysql", "groonga"]``
+   * - ``http://ranguba.org/``
+     - ``["ruby", "groonga"]``
+
+Here is a command that loads the data:
+
+.. groonga-command
+.. include:: ../../example/reference/columns/vector/usage_load_normal.log
+.. load --table Bookmarks
+.. [
+.. {"_key": "http://groonga.org/", "tags": ["groonga"]},
+.. {"_key": "http://mroonga.org/", "tags": ["mroonga", "mysql", "groonga"]},
+.. {"_key": "http://ranguba.org/", "tags": ["ruby", "groonga"]}
+.. ]
+
+The loaded data can be outputted as JSON array syntax:
+
+.. groonga-command
+.. include:: ../../example/reference/columns/vector/usage_output_normal.log
+.. select Bookmarks
+
+How to search
+"""""""""""""
+
+You need to create an index to search normal vector column:
+
+.. groonga-command
+.. include:: ../../example/reference/columns/vector/usage_index_normal.log
+.. 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
+a scalar column.
+
+You can search an element in ``tags`` like full text search syntax.
+
+With :ref:`select-match-columns` and :ref:`select-query`:
+
+.. groonga-command
+.. include:: ../../example/reference/columns/vector/usage_query_normal.log
+.. select Bookmarks --match_columns tags --query mysql --output_columns _key,tags,_score
+
+You can also use weight in :ref:`select-match-columns`:
+
+.. groonga-command
+.. include:: ../../example/reference/columns/vector/usage_query_weight_normal.log
+.. select Bookmarks --match_columns 'tags * 3' --query mysql --output_columns _key,tags,_score
+
+With :ref:`select-filter`:
+
+.. groonga-command
+.. include:: ../../example/reference/columns/vector/usage_filter_normal.log
+.. select Bookmarks --filter 'tags @ "msyql"' --output_columns _key,tags,_score
+
+.. groonga-command
+.. table_remove Tags
+.. table_remove Bookmarks
+
+.. _reference-vector-column:
+
+Reference vector column
+^^^^^^^^^^^^^^^^^^^^^^^
+
+TODO
+
+Reference vector column is space-efficient if there are many same
+value elements. Reference vector column keeps reference record IDs not
+value itself. Record ID is smaller than value itself.
+
+How to create
+"""""""""""""
+
+TODO
+
+How to load
+"""""""""""
+
+TODO
+
+How to search
+"""""""""""""
+
+TODO
+
+.. _weight-vector-column:
+
+Weight vector column
+^^^^^^^^^^^^^^^^^^^^
+
+Weight vector column is similar to normal vector column. It can store
+elements. It can also stores weights for them. Weight is degree of
+importance of the element.
+
+Weight is positive integer. ``0`` is the default weight. It means that
+no weight.
+
+If weight is one or larger, search score is increased by the
+weight. If the weight is ``0``, score is ``1``. If the weight is
+``10``, score is ``11`` (``= 1 + 10``).
+
+Weight vector column is useful for tuning search score. See also
+:ref:`select-adjuster`. You can increase search score of specific
+records.
+
+Limitations
+"""""""""""
+
+There are some limitations for now. They will be resolved in the
+future.
+
+Here are limitations:
+
+  * You need to use string representation for element value on load.
+    For example, you can't use ``29`` for number 29. You need to use
+    ``"29"`` for number 29.
+  * You can't use reference type.
+
+How to create
+"""""""""""""
+
+Use :doc:`/reference/commands/column_create` command to create a
+weight vector column. The point is ``COLUMN_VECTOR|WITH_WEIGHT``
+flags:
+
+.. groonga-command
+.. include:: ../../example/reference/columns/vector/usage_create_weight.log
+.. table_create Bookmarks TABLE_HASH_KEY ShortText
+.. column_create Bookmarks tags COLUMN_VECTOR|WITH_WEIGHT ShortText
+
+If you don't specify ``WITH_WEIGHT`` flag, it is just a normal vector
+column.
+
+You can set zero or more tags with weight to a bookmark.
+
+How to load
+"""""""""""
+
+You can load vector data by JSON object syntax::
+
+  {"ELEMENT1": WEIGHT1, "ELEMENT2": WEIGHT2, "ELEMENT3": WEIGHT3, ...}
+
+Let's load the following data:
+
+.. list-table::
+   :header-rows: 1
+
+   * - ``_key``
+     - ``tags``
+   * - ``http://groonga.org/``
+     - ``{"groonga": 100}``
+   * - ``http://mroonga.org/``
+     - ``{"mroonga": 100, "mysql": 50, "groonga": 10}``
+   * - ``http://ranguba.org/``
+     - ``{"ruby": 100, "groonga": 50}``
+
+Here is a command that loads the data:
+
+.. groonga-command
+.. include:: ../../example/reference/columns/vector/usage_load_weight.log
+.. load --table Bookmarks
+.. [
+.. {"_key": "http://groonga.org/",
+..  "tags": {"groonga": 100}},
+.. {"_key": "http://mroonga.org/",
+..  "tags": {"mroonga": 100,
+..           "mysql":   50,
+..           "groonga": 10}},
+.. {"_key": "http://ranguba.org/",
+..  "tags": {"ruby": 100,
+..           "groonga": 50}}
+.. ]
+
+The loaded data can be outputted as JSON object syntax:
+
+.. groonga-command
+.. include:: ../../example/reference/columns/vector/usage_output_weight.log
+.. select Bookmarks
+
+How to search
+"""""""""""""
+
+You need to create an index to search weight vector column. You don't
+forget to specify ``WITH_WEIGHT`` flag to ``column_create``:
+
+.. groonga-command
+.. include:: ../../example/reference/columns/vector/usage_index_weight.log
+.. 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``
+flag. You can create an index like a scalar column.
+
+You can search an element in ``tags`` like full text search syntax.
+
+With :ref:`select-match-columns` and :ref:`select-query`:
+
+.. groonga-command
+.. include:: ../../example/reference/columns/vector/usage_query_weight.log
+.. select Bookmarks --match_columns tags --query groonga --output_columns _key,tags,_score
+
+You can also use weight in :ref:`select-match-columns`. The score is
+``(1 + weight_in_weight_vector) * weight_in_match_columns``:
+
+.. groonga-command
+.. include:: ../../example/reference/columns/vector/usage_query_weight_weight.log
+.. select Bookmarks --match_columns 'tags * 3' --query groonga --output_columns _key,tags,_score
+
+With :ref:`select-filter`:
+
+.. groonga-command
+.. include:: ../../example/reference/columns/vector/usage_filter_weight.log
+.. select Bookmarks --filter 'tags @ "groonga"' --output_columns _key,tags,_score
+
+How to apply just weight
+""""""""""""""""""""""""
+
+You can use weight in weight vector column to just increase search
+score without changing a set of matched records.
+
+Use :ref:`select-adjuster` for the purpose:
+
+.. groonga-command
+.. include:: ../../example/reference/columns/vector/usage_adjuster_weight.log
+.. select Bookmarks \
+..   --filter true \
+..   --adjuster 'tags @ "mysql" * 10 + tags @ "groonga" * 5' \
+..   --output_columns _key,tags,_score
+
+The ``select`` command uses ``--filter true``. So all records are
+matched with score 1. Then it applies ``--adjuster``. The adjuster
+does the following:
+
+  * ``tags @ "mysql" * 10`` increases score by ``(1 + weight) * 10``
+    of records that has ``"mysql"`` tag.
+  * ``tags @ "groonga" * 5`` increases score by ``(1 + weight) * 5``
+    of records that has ``"groonga"`` tag.
+
+For example, record ``"http://mroonga.org/"`` has both ``"mysql"`` tag
+and ``"groonga"`` tag. So its score is increased by ``565`` (``=
+((1 + 50) * 10) + ((1 + 10) * 5) = (51 * 10) + (11 * 5) = 510 + 55``).
+The search score is 1 by ``--filter true`` before applying
+``--adjuster``. So the final search score is ``566`` (``= 1 + 565``)
+of record ``"http://mroonga.org/"``.
+
+.. groonga-command
+.. table_remove Tags
+.. table_remove Bookmarks