rroonga 2.1.2-x86-mingw32 → 2.1.3-x86-mingw32

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

@@ -17,26 +17,47 @@ size data.
 Installer
 ---------
 
-For 32-bit environment, download `groonga-2.1.0-x86.exe
-<http://packages.groonga.org/windows/groonga/groonga-2.1.0-x86.exe>`_
-and run it.
+For 32-bit environment, download x86 executable binary from packages.groonga.org.
 
-For 64-bit environment, download `groonga-2.1.0-x64.exe
-<http://packages.groonga.org/windows/groonga/groonga-2.1.0-x64.exe>`_
-and run it.
+You can download such a binary by command line operation.
+
+Start command prompt ``cmd.exe`` and download x86 executable binary by default browser::
+
+  > "c:\\Program Files\\Internet Explorer\\iexplore.exe" http://packages.groonga.org/windows/groonga/groonga-2.1.2-x86.exe
+
+Then run it.
+
+
+For 64-bit environment, download x64 executable binary from packages.groonga.org.
+
+Start command prompt ``cmd.exe`` and download x64 executable binary by default browser::
+
+  > "c:\\Program Files\\Internet Explorer\\iexplore.exe" http://packages.groonga.org/windows/groonga/groonga-2.1.2-x64.exe
+
+Then run it.
 
 Use command prompt for :doc:`/reference/executables/groonga` installed in start menu.
 
 zip
 ---
 
-For 32-bit environment, download `groonga-2.1.0-x86.zip
-<http://packages.groonga.org/windows/groonga/groonga-2.1.0-x86.zip>`_
-and extract it.
+For 32-bit environment, download x86 zip archive from packages.groonga.org.
+
+You can download such a binary by command line operation.
+
+Start command prompt ``cmd.exe`` and download x86 zip archive by default browser::
 
-For 64-bit environment, download `groonga-2.1.0-x64.zip
-<http://packages.groonga.org/windows/groonga/groonga-2.1.0-x64.zip>`_
-and extract it.
+  > "c:\\Program Files\\Internet Explorer\\iexplore.exe" http://packages.groonga.org/windows/groonga/groonga-2.1.2-x86.zip
+
+Then extract it.
+
+For 64-bit environment, download x64 zip archive from packages.groonga.org.
+
+Start command prompt ``cmd.exe`` and download x64 zip archive by default browser::
+
+  > "c:\\Program Files\\Internet Explorer\\iexplore.exe" http://packages.groonga.org/windows/groonga/groonga-2.1.2-x64.zip
+
+Then extract it.
 
 :doc:`/reference/executables/groonga` is in ``bin`` folder.
 
@@ -50,38 +71,45 @@ Windows. Here are required tools:
     <http://www.microsoft.com/japan/msdn/vstudio/express/>`_
   * `CMake <http://www.cmake.org/>`_
 
-Download zipped source `groonga-2.1.0.zip
-<http://packages.groonga.org/source/groonga/groonga-2.1.0.zip>`_
-and extract it.
+Download zipped source from packages.groonga.org.
+
+You can download such a zipped source file by command line operation.
 
 Start ``Visual Studio Command Prompt (2010)`` installed by Microsoft
-Visual Studio 2010 Express and move to the groonga's source folder::
+Visual Studio 2010 Express and download it by default browser::
+
+  > cd c:\Users\%USERNAME%\Downloads
+  > "c:\\Program Files\\Internet Explorer\\iexplore.exe" http://packages.groonga.org/source/groonga/groonga-2.1.2.zip
+
+Then extract it.
+
+Move to the groonga's source folder::
 
-  > cd c:\Users\%USERNAME%\Downloads\groonga-2.1.0
+  > cd c:\Users\%USERNAME%\Downloads\groonga-2.1.2
 
 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-2.1.0> cmake . -G "Visual Studio 10 Win64" -DCMAKE_INSTALL_PREFIX=C:\groonga
+  groonga-2.1.2> cmake . -G "Visual Studio 10 Win64" -DCMAKE_INSTALL_PREFIX=C:\groonga
 
 Build by Visual C++ 2010 Express::
 
-  groonga-2.1.0> msbuild groonga.sln /p:Configuration=Release
+  groonga-2.1.2> msbuild groonga.sln /p:Configuration=Release
 
 Install by Visual C++ 2010 Express::
 
-  groonga-2.1.0> msbuild groonga.sln /p:Configuration=Release /t:Install
+  groonga-2.1.2> msbuild groonga.sln /p:Configuration=Release /t:Install
 
 If you installed Visual Studio 2010, use can use devenv instead.
 
 Build by Visual Studio 2010::
 
-  groonga-2.1.0> devenv groonga.sln /Build Release
+  groonga-2.1.2> devenv groonga.sln /Build Release
 
 Install by Visual Studio 2010::
 
-  groonga-2.1.0> devenv groonga.sln /Build Release /Project Install
+  groonga-2.1.2> devenv groonga.sln /Build Release /Project Install
 
 After the above steps, :doc:`/reference/executables/groonga` is found in
 ``c:\groonga\bin\groonga.exe``.

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

@@ -5,6 +5,52 @@
 News
 ====
 
+.. _release-2-1-2:
+
+Release 2.1.2 - 2013/01/29
+--------------------------
+
+Improvements
+^^^^^^^^^^^^
+
+* Supported multiple ``query()`` in a select command.
+  For example, you can specify the keyword which has different weight such as
+  'query("column * weight1", keyword1) || query("column * weight2", keyword2) || ...'
+  for ``--filter``.
+* Dropped experimental view feature.
+* Added ``grn_logger_reopen`` API for custom logger.
+  Note that ``grn_logger_info`` API is deprecated, use ``grn_logger`` API instead.
+* Added ``grn_default_logger_set_path()`` and ``grn_default_logger_get_path()`` API.
+  Note that global ``grn_log_path`` variable was removed. Use above API.
+* Added ``grn_default_query_logger_set_path()`` and
+  ``grn_default_query_logger_get_path()`` API.
+  Note that global ``grn_qlog_path`` variable was removed. Use above API.
+* Added translated documentation about :doc:`/reference/tables` and :doc:`/reference/normalizers`.
+* [deb][rpm] Improved to install with missing dictionary when
+  ``groonga-tokenizer-mecab`` package is installed.
+* Supported :ref:`nested-index-search` with range search.
+  For example, you can specify 'column1.column2...columnN <= "1988-01-04 00:00:00"'
+  in ``--filter``.
+* [rpm][fedora] Supported Fedora 18.
+* [rpm][fedora] Dropped Fedora 17 support.
+* [doc] Added documentation for :doc:`/server/package`.
+* [doc] Added documentation for :doc:`/reference/functions/query`.
+
+Fixes
+^^^^^
+
+* Fixed not to report an error even though MeCab tokenizer shared object
+  isn't found. [groonga-dev,01174] [Reported by wing]
+* [httpd] Fixed not to fail configure on CentOS 5.4 by setting
+  ``SED`` variable explicitly.
+* Fixed a crash bug that not initialized vector column value is accessed
+  by select command.
+
+Thanks
+^^^^^^
+
+* wing
+
 .. _release-2-1-1:
 
 Release 2.1.1 - 2012/12/29

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

@@ -31,7 +31,7 @@ clearlockは、対象となるオブジェクト(データベース,テーブル
   対象となるオブジェクト名を指定します。空の場合、開いているdbオブジェクトが対象となります。
 
 返値
----
+----
 
 json形式
 ^^^^^^^^

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

@@ -227,6 +227,8 @@ If both ``query`` and ``filter`` are specified, selected records must
 be matched against both ``query`` and ``filter``. If both ``query``
 and ``filter`` aren't specified, all records are selected.
 
+.. _select-match-columns:
+
 ``match_columns``
 """""""""""""""""
 
@@ -294,6 +296,8 @@ is 1. This weight allocation means ``_key`` column value is more
 important rather than ``content`` column value. In this example, title
 of blog entry is more important rather thatn content of blog entry.
 
+.. _select-query:
+
 ``query``
 """""""""
 

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

@@ -0,0 +1,135 @@
+.. -*- rst -*-
+
+.. highlightlang:: none
+
+.. groonga-command
+.. database: functions_query
+
+query
+=====
+
+Summary
+-------
+
+``query`` enables you to specify ``--match_columns`` and ``--query`` parameters as
+function arguments.
+
+``query`` is one of the groonga builtin functions, so you can specify
+multiple ``query`` function as parameters of ``--filter`` option.
+
+Because of such flexibility, you can control full text search behavior
+by combination of multiple ``query`` function.
+
+``query`` can be used in only ``--filter`` in :doc:`/reference/commands/select`.
+
+Syntax
+------
+
+``query`` requires two arguments - ``match_column`` and ``query_string``.
+
+::
+
+  query(match_column, query_string)
+
+
+Usage
+-----
+
+Here are a schema definition and sample data to show usage.
+
+Sample schema:
+
+.. groonga-command
+.. include:: ../../example/reference/functions/query/usage_setup_schema.log
+.. table_create Documents TABLE_NO_KEY
+.. column_create Documents content COLUMN_SCALAR Text
+.. table_create Terms TABLE_PAT_KEY|KEY_NORMALIZE ShortText --default_tokenizer TokenBigram
+.. column_create Terms documents_content_index COLUMN_INDEX|WITH_POSITION Documents content
+.. table_create Users TABLE_NO_KEY
+.. column_create Users name COLUMN_SCALAR ShortText
+.. column_create Users memo COLUMN_SCALAR ShortText
+.. table_create Lexicon TABLE_HASH_KEY ShortText \
+..   --default_tokenizer TokenBigramSplitSymbolAlphaDigit \
+..   --normalizer NormalizerAuto
+.. column_create Lexicon users_name COLUMN_INDEX|WITH_POSITION Users name
+.. column_create Lexicon users_memo COLUMN_INDEX|WITH_POSITION Users memo
+
+Sample data:
+
+.. groonga-command
+.. include:: ../../example/reference/functions/query/usage_setup_data.log
+.. load --table Users
+.. [
+.. {"name": "Alice", "memo": "groonga user"},
+.. {"name": "Alisa", "memo": "mroonga user"},
+.. {"name": "Bob",   "memo": "rroonga user"},
+.. {"name": "Tom",   "memo": "nroonga user"},
+.. {"name": "Tobby", "memo": "groonga and mroonga user. mroonga is ..."},
+.. ]
+
+Here is the simple usage of ``query`` function which execute full text
+search by keyword 'alice' without using ``--match_column`` and
+``--query`` arguments in ``--filter``.
+
+.. groonga-command
+.. include:: ../../example/reference/functions/query/usage_basic.log
+.. select Users --output_columns name,_score --filter 'query("name * 10", "alice")'
+
+When executing above query, the keyword 'alice' is weighted to the value -
+'10'.
+
+Here are the contrasting examples with/without ``query``.
+
+.. groonga-command
+.. include:: ../../example/reference/functions/query/usage_without_query.log
+.. select Users --output_columns name,memo,_score --match_columns "memo * 10" --query "memo:@groonga OR memo:@mroonga OR memo:@user" --sortby -_score
+
+In this case, the keywords 'groonga' and 'mroonga' and 'user' are
+given same weight value.
+You can't pass different weight value to each keyword in this way.
+
+
+.. groonga-command
+.. include:: ../../example/reference/functions/query/usage_with_query.log
+.. select Users --output_columns name,memo,_score --filter 'query("memo * 10", "groonga") || query("memo * 20", "mroonga") || query("memo * 1", "user")' --sortby -_score
+
+On the other hand, by specifying multiple ``query``, the keywords
+'groonga' and 'mroonga' and 'user' are given different value of weight.
+
+As a result, you can control full text search result by giving different weight to the
+keywords on your purpose.
+
+Parameters
+----------
+
+There are two required parameter, ``match_column`` and ``query_string``.
+
+``match_column``
+^^^^^^^^^^^^^^^^
+
+  It specifies ``match_column`` equivalent parameter.
+
+See :ref:`select-match-columns` about match_column.
+
+``query_string``
+^^^^^^^^^^^^^^^^
+
+  It specifies ``query`` equivalent parameter.
+
+See :ref:`select-query` about query string.
+
+Return value
+------------
+
+``query`` returns a value of boolean (true or false).
+
+TODO
+----
+
+* Support query_expansion
+* Support query_flags
+
+See also
+--------
+
+* :doc:`/reference/commands/select`

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

@@ -9,6 +9,8 @@ Groonga has two log files. They are process log and query
 log. Process log is for all of :doc:`executables/groonga`
 works. Query log is just for query processing.
 
+.. _process-log:
+
 Process log
 -----------
 
@@ -102,6 +104,8 @@ Example::
   2011-07-05 08:35:09.276421|n| grn_init
   2011-07-05 08:35:09.276553|n| RLIMIT_NOFILE(4096,4096)
 
+.. _query-log:
+
 Query log
 ---------
 

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

@@ -11,9 +11,9 @@ Normalizers
 Summary
 -------
 
-Groonga has normalizer module. It is used when tokenizing text and
-storing table key. For example, ``A`` and ``a`` are processed as the
-same character after normalization.
+Groonga has normalizer module that normalizes text. It is used when
+tokenizing text and storing table key. For example, ``A`` and ``a``
+are processed as the same character after normalization.
 
 Normalizer module can be added as a plugin. You can customize text
 normalization by registering your normalizer plugins to groonga.
@@ -68,7 +68,7 @@ normalized as described above.
 Built-in normalizers
 --------------------
 
-Here is a list of built-in-normalizers:
+Here is a list of built-in normalizers:
 
   * ``NormalizerAuto``
   * ``NormalizerNFKC51``
@@ -80,7 +80,7 @@ Normally you should use ``NormalizerAuto``
 normalizer. ``NormalizerAuto`` was the normalizer for groonga 2.0.9 or
 earlier. ``KEY_NORMALIZE`` flag in ``table_create`` on groonga 2.0.9
 or earlier equals to ``--normalizer NormalizerAuto`` option in
-``table`` on groonga 2.1.0 or later.
+``table_create`` on groonga 2.1.0 or later.
 
 ``NormalizerAuto`` supports all encoding. It uses Unicode NFKC
 (Normalization Form Compatibility Composition) for UTF-8 encoding

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

@@ -12,7 +12,7 @@ Table in groonga manages relation between ID and key. Groonga provides
 four table types. They are ``TABLE_NO_KEY``, ``TABLE_HASH_KEY``,
 ``TABLE_PAT_KEY`` and ``TABLE_DAT_KEY``.
 
-All table except ``TABLE_NO_KEY`` provides both fast ID search by key
+All tables except ``TABLE_NO_KEY`` provides both fast ID search by key
 and fast key search by ID. ``TABLE_NO_KEY`` doesn't support
 key. ``TABLE_NO_KEY`` only manages ID. So ``TABLE_NO_KEY`` doesn't
 provides ID search and key search.
@@ -25,7 +25,7 @@ prefix is omitted in the table.)
 
 +--------------+------------+--------------+-------------+-------------+
 |              | ``NO_KEY`` | ``HASH_KEY`` | ``PAT_KEY`` | ``DAT_KEY`` |
-+--------------+------------+--------------+-------------+-------------+
++==============+============+==============+=============+=============+
 | Data         | Array      | Hash table   | Patricia    | Double      |
 | structure    |            |              | trie        | array       |
 |              |            |              |             | trie        |
@@ -39,31 +39,33 @@ prefix is omitted in the table.)
 | Value        | o          | o            | o           | x           |
 | support      |            |              |             |             |
 +--------------+------------+--------------+-------------+-------------+
-| Key -> ID    | -          | oo           | x           | o           |
+| Key -> ID    | \-         | oo           | x           | o           |
 | speed        |            |              |             |             |
-| (o -> fast)  |            |              |             |             |
-| (x -> slow)  |            |              |             |             |
+|              |            |              |             |             |
+| * o: fast    |            |              |             |             |
+| * x: slow    |            |              |             |             |
 +--------------+------------+--------------+-------------+-------------+
-| Update       | ooo        | o            | o           | x           |
-| speed        |            |              |             |             |
-| (o -> fast)  |            |              |             |             |
-| (x -> slow)  |            |              |             |             |
+| Update speed | ooo        | o            | o           | x           |
+|              |            |              |             |             |
+| * o: fast    |            |              |             |             |
+| * x: slow    |            |              |             |             |
 +--------------+------------+--------------+-------------+-------------+
 | Size         | ooo        | o            | oo          | x           |
-| (o -> small) |            |              |             |             |
-| (x -> large) |            |              |             |             |
+|              |            |              |             |             |
+| * o: small   |            |              |             |             |
+| * x: large   |            |              |             |             |
 +--------------+------------+--------------+-------------+-------------+
-| Key          | -          | x            | x           | o           |
+| Key          | \-         | x            | x           | o           |
 | update       |            |              |             |             |
 +--------------+------------+--------------+-------------+-------------+
-| Common       | -          | x            | o           | o           |
+| Common       | \-         | x            | o           | o           |
 | prefix       |            |              |             |             |
 | search       |            |              |             |             |
 +--------------+------------+--------------+-------------+-------------+
-| Predictive   | -          | x            | o           | o           |
+| Predictive   | \-         | x            | o           | o           |
 | search       |            |              |             |             |
 +--------------+------------+--------------+-------------+-------------+
-| Range        | -          | x            | o           | o           |
+| Range        | \-         | x            | o           | o           |
 | search       |            |              |             |             |
 +--------------+------------+--------------+-------------+-------------+
 

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

@@ -0,0 +1,192 @@
+.. -*- rst -*-
+
+.. highlightlang:: none
+
+Server packages
+===============
+
+The package ``groonga`` is the mininum set of fulltext search engine.
+If you want to use groonga for server use, you can install
+additional preconfigured packages.
+
+There are three packages for server use.
+
+* ``groonga-httpd`` (nginx and HTTP protocol based server package)
+* ``groonga-server-http`` (simple HTTP protocol based server package)
+* ``groonga-server-gqtp`` (GQTP protocol based server package)
+
+Note that there is a conflict between ``groonga-httpd`` and ``groonga-server-http``
+package because of port number.
+See :doc:`/server/http/comparison` if you want to know which package meets your demands.
+
+groonga-httpd
+-------------
+
+``groonga-httpd`` is a nginx and HTTP protocol based server package.
+
+Preconfigured setting:
+
++--------------------+---------------------------------------+
+| Item               | Default value                         |
++====================+=======================================+
+| Port number        | 10041                                 |
++--------------------+---------------------------------------+
+| Access log path    | /var/log/groonga/httpd/acccess.log    |
++--------------------+---------------------------------------+
+| Error log path     | /var/log/groonga/http-query.log       |
++--------------------+---------------------------------------+
+| Database           | /var/lib/groonga/db/*                 |
++--------------------+---------------------------------------+
+| Configuration file | /etc/groonga/httpd/groonga-httpd.conf |
++--------------------+---------------------------------------+
+
+Start HTTP server
+^^^^^^^^^^^^^^^^^
+
+Starting groonga HTTP server(Debian/Ubuntu/CentOS)::
+
+  % sudo service groonga-httpd start
+ 
+Starting groonga HTTP server(Fedora)::
+
+  % sudo systemctl start groonga-httpd
+ 
+Stop HTTP server
+^^^^^^^^^^^^^^^^
+
+Stopping groonga HTTP server(Debian/Ubuntu/CentOS)::
+
+  % sudo service groonga-httpd stop
+ 
+Starting groonga HTTP server(Fedora)::
+
+  % sudo systemctl stop groonga-httpd
+
+Restart HTTP server
+^^^^^^^^^^^^^^^^^^^
+
+Restarting groonga HTTP server(Debian/Ubuntu/CentOS)::
+
+  % sudo service groonga-httpd restart
+ 
+Restarting groonga HTTP server(Fedora)::
+
+  % sudo systemctl restart groonga-httpd
+
+groonga-server-http
+-------------------
+
+``groonga-server-http`` is a simple HTTP protocol based server package.
+
+Preconfigured setting:
+
++--------------------+---------------------------------------+
+| Item               | Default value                         |
++====================+=======================================+
+| Port number        | 10041                                 |
++--------------------+---------------------------------------+
+| :ref:`process-log` | /var/log/groonga/groonga-http.log     |
++--------------------+---------------------------------------+
+| :ref:`query-log`   | /var/log/groonga/http-query.log       |
++--------------------+---------------------------------------+
+| Database           | /var/lib/groonga/db/*                 |
++--------------------+---------------------------------------+
+
+Configuration file for server setting (Debian/Ubuntu)::
+
+  /etc/default/groonga/groonga-server-http
+
+Configuration file for server setting (CentOS)::
+
+  /etc/sysconfig/groonga-server-http
+
+Start HTTP server
+^^^^^^^^^^^^^^^^^
+
+Starting groonga HTTP server(Debian/Ubuntu/CentOS)::
+
+  % sudo service groonga-server-http start
+ 
+Starting groonga HTTP server(Fedora)::
+
+  % sudo systemctl start groonga-server-http
+ 
+Stop HTTP server
+^^^^^^^^^^^^^^^^
+
+Stopping groonga HTTP server(Debian/Ubuntu/CentOS)::
+
+  % sudo service groonga-server-http stop
+ 
+Stopping groonga HTTP server(Fedora)::
+
+  % sudo systemctl stop groonga-server-http
+
+Restart HTTP server
+^^^^^^^^^^^^^^^^^^^
+
+Restarting groonga HTTP server(Debian/Ubuntu/CentOS)::
+
+  % sudo service groonga-server-http restart
+ 
+Restarting groonga HTTP server(Fedora)::
+
+  % sudo systemctl restart groonga-server-http
+
+groonga-server-gqtp
+-------------------
+
+``groonga-server-gqtp`` is a GQTP protocol based server package.
+
++--------------------+---------------------------------------+
+| Item               | Default value                         |
++====================+=======================================+
+| Port number        | 10043                                 |
++--------------------+---------------------------------------+
+| :ref:`process-log` | /var/log/groonga/groonga-gqtp.log     |
++--------------------+---------------------------------------+
+| :ref:`query-log`   | /var/log/groonga/gqtp-query.log       |
++--------------------+---------------------------------------+
+| Database           | /var/lib/groonga/db/*                 |
++--------------------+---------------------------------------+
+
+Configuration file for server setting (Debian/Ubuntu)::
+
+  /etc/default/groonga/groonga-server-gqtp
+
+Configuration file for server setting (CentOS)::
+
+  /etc/sysconfig/groonga-server-gqtp
+
+Start GQTP server
+^^^^^^^^^^^^^^^^^
+
+Starting groonga GQTP server(Debian/Ubuntu/CentOS)::
+
+  % sudo service groonga-server-gqtp start
+ 
+Starting groonga GQTP server(Fedora)::
+
+  % sudo systemctl start groonga-server-gqtp
+
+Stop GQTP server
+^^^^^^^^^^^^^^^^
+
+Stopping groonga GQTP server(Debian/Ubuntu/CentOS)::
+
+  % sudo service groonga-server-http stop
+ 
+Stopping groonga GQTP server(Fedora)::
+
+  % sudo systemctl stop groonga-server-gqtp
+
+Restart GQTP server
+^^^^^^^^^^^^^^^^^^^
+
+Restarting groonga HTTP server(Debian/Ubuntu/CentOS)::
+
+  % sudo service groonga-server-gqtp restart
+ 
+Restarting groonga HTTP server(Fedora)::
+
+  % sudo systemctl restart groonga-server-gqtp

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

@@ -8,5 +8,6 @@ Server
 .. toctree::
    :maxdepth: 2
 
+   server/package
    server/gqtp
    server/http

data/vendor/local/share/doc/groonga/en/html/_static/basic.css

@@ -4,7 +4,7 @@
  *
  * Sphinx stylesheet -- basic theme.
  *
- * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS.
+ * :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
  * :license: BSD, see LICENSE for details.
  *
  */