rroonga 2.0.8-x86-mingw32 → 2.1.0-x86-mingw32

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

@@ -5,6 +5,65 @@
 News
 ====
 
+.. _release-2-1-0:
+
+Release 2.1.0 - 2012/12/29
+--------------------------
+
+.. Caution::
+
+   This release has backward incompatible changes against ``table_list`` and
+   ``column_list`` commands. If you use own program which depends on the output
+   results above commands, you need to support null instead of "null" string.
+
+   This release has supported ``--normalizer`` option, but there is side effect for
+   this feature. If you open old version of groonga database at least once, 
+   you can not open its database by old version of groonga.
+
+   There is also another backward incompatible change agaist plugin API for
+   tokenizer. The argument of ``grn_tokenizer_query_open`` API has changed.
+   This API change affects developer of tokenizer plugin.
+
+Improvements
+^^^^^^^^^^^^
+
+* [doc] Added documentation about :ref:`nested-index-search`.
+* Supported the expression as :doc:`/reference/functions/snippet_html` arguments.
+  This change enables you to use ``snippet_html("STRING" + "STRING")`` for example.
+  You can specify column name or literal for "STRING". [Reported by Tomoatsu Shimada]
+* Supported to create own normalizer as a plugin.
+* Moved ``groonga-query-log-analyzer`` as
+  `groonga-query-log <http://rubygems.org/gems/groonga-query-log>`_ RubyGems.
+  It enables you to analyze query logs without installing groonga package.
+* Supported ``--normalizer`` option for :doc:`/reference/commands/table_create` command.
+  This change enables you to specify normalizer plugin.
+* Changed "null" string to null value as meaning for "No Object".
+  This is backward incompatible change and affects output results of introspection
+  related commands such as ``table_list`` and ``column_list``.
+* Added a flag which controls behavior about normalizer as the last argument
+  of ``grn_tokenizer_query_open`` API.
+* Supported continuous line in command list.
+* Improved to support not only no key table, but also hash table, patricia trie
+  and double array trie for :ref:`nested-index-search`.
+
+Fixes
+^^^^^
+
+* [windows] Added missing ``O_BINARY`` flag to open file correctly.
+  This change fixes the infinite loop problem about groonga HTTP server.
+  [GitHub#47] [Patch by Shimomura Tatsuya]
+* Fixed a bug that ``--default-match-escalation-threshold`` doesn't accept
+  negative value to disable functionality.
+  This fix enable you to disable search escalation.
+  see :option:`--default-match-escalation-threshold` about details.
+* Fixed a bug that ``_score`` after "*" is ignored in ``--output_columns``.
+
+Thanks
+^^^^^^
+
+* Tomoatsu Shimada
+* Shimomura Tatsuya
+
 .. _release-2-0-9:
 
 Release 2.0.9 - 2012/11/29

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

@@ -83,6 +83,135 @@ match_columnsオプションで、検索対象のカラムを複数指定する
 
 .. TODO: match_columnsにインデックス名を指定しての検索についても触れる。
 
+
+.. _nested-index-search:
+
+Nested index search among related table by column index
+--------------------------------------------------------
+
+If there are relationships among multiple table with column index,
+you can search multiple table by specifying reference column name.
+
+Here is the concrete example.
+
+There are tables which store blog articles, comments for articles.
+The table which stores articles has columns for article and comment.
+And the comment column refers Comments table.
+The table which stores comments has columns for comment and column index to article table.
+
+if you want to search the articles which contain specified keyword in comment,
+you need to execute fulltext search for table of comment, then search the records which contains fulltext search results.
+
+But, you can search the records by specifying the reference column index at once.
+
+Here is the sample schema.
+
+.. groonga-command
+.. include:: ../example/tutorial/match_columns-nested-index-schema.log
+.. table_create Comments TABLE_HASH_KEY UInt32
+.. column_create Comments content COLUMN_SCALAR ShortText
+.. table_create Articles TABLE_NO_KEY
+.. column_create Articles content COLUMN_SCALAR Text
+.. column_create Articles comment COLUMN_SCALAR Comments
+.. table_create Lexicon TABLE_PAT_KEY|KEY_NORMALIZE ShortText --default_tokenizer TokenBigram
+.. column_create Lexicon articles_content COLUMN_INDEX|WITH_POSITION Articles content
+.. column_create Lexicon comments_content COLUMN_INDEX|WITH_POSITION Comments content
+.. column_create Comments article COLUMN_INDEX Articles comment
+
+Here is the sample data.
+
+.. groonga-command
+.. include:: ../example/tutorial/match_columns-nested-index-data.log
+.. load --table Comments
+.. [
+.. {"_key": 1, "content": "I'm using groonga too!"},
+.. {"_key": 2, "content": "I'm using groonga and mroonga!"},
+.. {"_key": 3, "content": "I'm using mroonga too!"}
+.. ]
+.. load --table Articles
+.. [
+.. {"content": "Groonga is fast!", "comment": 1},
+.. {"content": "Groonga is useful!"},
+.. {"content": "Mroonga is fast!", "comment": 3}
+.. ]
+
+You can write the query that search the records which contains specified keyword as a comment, then fetch the articles which refers to it.
+
+Query for searching the records described above::
+
+  select Articles --match_columns comment.content --query groonga --output_columns "_id, _score, *" 
+
+You need to concatenate comment column of Articles table and content column of Comments table with period(.) as --match_columns arguments.
+
+At first, this query execute fulltext search from content of Comments table, then fetch the records of Articles table which refers to already searched records of Comments table.
+(Because of this, if you comment out the query which create column index 'article' of Comments table, you can't get intended search results.)
+
+.. groonga-command
+.. include:: ../example/tutorial/match_columns-nested-index-select.log
+.. select Articles --match_columns comment.content --query groonga --output_columns "_id, _score, *" 
+
+Now, you can search articles which contains specific keywords as a comment.
+
+The feature of nested index search is not limited to the relationship between two table only.
+
+Here is the sample schema similar to previous one. The difference is added table which express 'Reply' and relationship is extended to three tables.
+
+.. groonga-command
+.. include:: ../example/tutorial/match_columns-nested-index-schema-with-three-relationship.log
+.. table_create Replies2 TABLE_HASH_KEY UInt32
+.. column_create Replies2 content COLUMN_SCALAR ShortText
+.. table_create Comments2 TABLE_HASH_KEY UInt32
+.. column_create Comments2 content COLUMN_SCALAR ShortText
+.. column_create Comments2 comment COLUMN_SCALAR Replies2
+.. table_create Articles2 TABLE_NO_KEY
+.. column_create Articles2 content COLUMN_SCALAR Text
+.. column_create Articles2 comment COLUMN_SCALAR Comments2
+.. table_create Lexicon2 TABLE_PAT_KEY|KEY_NORMALIZE ShortText --default_tokenizer TokenBigram
+.. column_create Lexicon2 articles_content COLUMN_INDEX|WITH_POSITION Articles2 content
+.. column_create Lexicon2 comments_content COLUMN_INDEX|WITH_POSITION Comments2 content
+.. column_create Lexicon2 replies_content COLUMN_INDEX|WITH_POSITION Replies2 content
+.. column_create Comments2 article COLUMN_INDEX Articles2 comment
+.. column_create Replies2 reply_to COLUMN_INDEX Comments2 comment
+
+Here is the sample data.
+
+.. groonga-command
+.. include:: ../example/tutorial/match_columns-nested-index-data-with-three-relationship.log
+.. load --table Replies2
+.. [
+.. {"_key": 1, "content": "I'm using rroonga too!"},
+.. {"_key": 2, "content": "I'm using groonga and mroonga and rroonga!"},
+.. {"_key": 3, "content": "I'm using nroonga too!"}
+.. ]
+.. load --table Comments2
+.. [
+.. {"_key": 1, "content": "I'm using groonga too!", "comment": 1},
+.. {"_key": 2, "content": "I'm using groonga and mroonga!", "comment": 2},
+.. {"_key": 3, "content": "I'm using mroonga too!"}
+.. ]
+.. load --table Articles2
+.. [
+.. {"content": "Groonga is fast!", "comment": 1},
+.. {"content": "Groonga is useful!", "comment": 2},
+.. {"content": "Mroonga is fast!", "comment": 3}
+.. ]
+
+Query for searching the records described above::
+
+  select Articles2 --match_columns comment.content --query mroonga --output_columns "_id, _score, *" 
+  select Articles2 --match_columns comment.comment.content --query mroonga --output_columns "_id, _score, *" 
+
+The first query searches 'mroonga' from Comments2 table, the second one searches 'mroonga' from Replies2 and Comment2 table by using reference column index.
+
+.. groonga-command
+.. include:: ../example/tutorial/match_columns-nested-index-select-with-three-relationship.log
+.. select Articles2 --match_columns comment.content --query mroonga --output_columns "_id, _score, *" 
+.. select Articles2 --match_columns comment.comment.content --query mroonga --output_columns "_id, _score, *" 
+
+As a result, the first query matches two article because of Comments2 table has two records which contains 'mroonga' as keyword.
+
+On the other hand, the second one matches one article only because of Replies2 table has only one record which contains 'mroonga' as keyword, and there is one record which contains same keyword and refers to the record in Comments2 table.
+
 インデックスの重み
 ------------------
 

data/vendor/local/share/doc/groonga/ja/html/_static/doctools.js

@@ -61,18 +61,6 @@ jQuery.getQueryParameters = function(s) {
   return result;
 };
 
-/**
- * small function to check if an array contains
- * a given item.
- */
-jQuery.contains = function(arr, item) {
-  for (var i = 0; i < arr.length; i++) {
-    if (arr[i] == item)
-      return true;
-  }
-  return false;
-};
-
 /**
  * highlight a given string on a jquery object by wrapping it in
  * span elements with the given class name.

data/vendor/local/share/doc/groonga/ja/html/_static/searchtools.js

@@ -159,7 +159,7 @@ var Search = {
         hlterms.push(tmp[i].toLowerCase());
       }
       // only add if not already in the list
-      if (!$.contains(toAppend, word))
+      if (!$u.contains(toAppend, word))
         toAppend.push(word);
     };
     var highlightstring = '?highlight=' + $.urlencode(hlterms.join(" "));
@@ -226,7 +226,7 @@ var Search = {
       // search result.
       for (var i = 0; i < excluded.length; i++) {
         if (terms[excluded[i]] == file ||
-            $.contains(terms[excluded[i]] || [], file)) {
+            $u.contains(terms[excluded[i]] || [], file)) {
           valid = false;
           break;
         }

data/vendor/local/share/doc/groonga/ja/html/characteristic.html

@@ -9,15 +9,15 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
     
-    <title>1. groongaの特徴 &mdash; groonga v2.0.9ドキュメント</title>
+    <title>1. groongaの特徴 &mdash; groonga v2.1.0ドキュメント</title>
     
     <link rel="stylesheet" href="_static/groonga.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
     
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '',
-        VERSION:     '2.0.9',
+        URL_ROOT:    './',
+        VERSION:     '2.1.0',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
@@ -28,7 +28,7 @@
     <script type="text/javascript" src="_static/doctools.js"></script>
     <script type="text/javascript" src="_static/translations.js"></script>
     <link rel="shortcut icon" href="_static/favicon.ico"/>
-    <link rel="top" title="groonga v2.0.9ドキュメント" href="index.html" />
+    <link rel="top" title="groonga v2.1.0ドキュメント" href="index.html" />
     <link rel="next" title="2. インストール" href="install.html" />
     <link rel="prev" title="groonga ドキュメント" href="index.html" /> 
   </head>
@@ -62,7 +62,7 @@
         <li class="right" >
           <a href="index.html" title="groonga ドキュメント"
              accesskey="P">前へ</a> |</li>
-        <li><a href="index.html">groonga v2.0.9ドキュメント</a> &raquo;</li> 
+        <li><a href="index.html">groonga v2.1.0ドキュメント</a> &raquo;</li> 
       </ul>
     </div>  
 
@@ -182,7 +182,7 @@
         <li class="right" >
           <a href="index.html" title="groonga ドキュメント"
              >前へ</a> |</li>
-        <li><a href="index.html">groonga v2.0.9ドキュメント</a> &raquo;</li> 
+        <li><a href="index.html">groonga v2.1.0ドキュメント</a> &raquo;</li> 
       </ul>
     </div>
     <div class="footer">

data/vendor/local/share/doc/groonga/ja/html/community.html

@@ -9,15 +9,15 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
     
-    <title>3. コミュニティ &mdash; groonga v2.0.9ドキュメント</title>
+    <title>3. コミュニティ &mdash; groonga v2.1.0ドキュメント</title>
     
     <link rel="stylesheet" href="_static/groonga.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
     
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '',
-        VERSION:     '2.0.9',
+        URL_ROOT:    './',
+        VERSION:     '2.1.0',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
@@ -28,7 +28,7 @@
     <script type="text/javascript" src="_static/doctools.js"></script>
     <script type="text/javascript" src="_static/translations.js"></script>
     <link rel="shortcut icon" href="_static/favicon.ico"/>
-    <link rel="top" title="groonga v2.0.9ドキュメント" href="index.html" />
+    <link rel="top" title="groonga v2.1.0ドキュメント" href="index.html" />
     <link rel="next" title="4. チュートリアル" href="tutorial.html" />
     <link rel="prev" title="2.8. その他" href="install/others.html" /> 
   </head>
@@ -62,7 +62,7 @@
         <li class="right" >
           <a href="install/others.html" title="2.8. その他"
              accesskey="P">前へ</a> |</li>
-        <li><a href="index.html">groonga v2.0.9ドキュメント</a> &raquo;</li> 
+        <li><a href="index.html">groonga v2.1.0ドキュメント</a> &raquo;</li> 
       </ul>
     </div>  
 
@@ -152,7 +152,7 @@
         <li class="right" >
           <a href="install/others.html" title="2.8. その他"
              >前へ</a> |</li>
-        <li><a href="index.html">groonga v2.0.9ドキュメント</a> &raquo;</li> 
+        <li><a href="index.html">groonga v2.1.0ドキュメント</a> &raquo;</li> 
       </ul>
     </div>
     <div class="footer">

data/vendor/local/share/doc/groonga/ja/html/contribution.html

@@ -9,15 +9,15 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
     
-    <title>13. groongaへのコントリビュート方法 &mdash; groonga v2.0.9ドキュメント</title>
+    <title>13. groongaへのコントリビュート方法 &mdash; groonga v2.1.0ドキュメント</title>
     
     <link rel="stylesheet" href="_static/groonga.css" type="text/css" />
     <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
     
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '',
-        VERSION:     '2.0.9',
+        URL_ROOT:    './',
+        VERSION:     '2.1.0',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
@@ -28,7 +28,7 @@
     <script type="text/javascript" src="_static/doctools.js"></script>
     <script type="text/javascript" src="_static/translations.js"></script>
     <link rel="shortcut icon" href="_static/favicon.ico"/>
-    <link rel="top" title="groonga v2.0.9ドキュメント" href="index.html" />
+    <link rel="top" title="groonga v2.1.0ドキュメント" href="index.html" />
     <link rel="next" title="13.1. バグレポートの送り方" href="contribution/report.html" />
     <link rel="prev" title="12.1. Travis CI" href="development/travis-ci.html" /> 
   </head>
@@ -62,7 +62,7 @@
         <li class="right" >
           <a href="development/travis-ci.html" title="12.1. Travis CI"
              accesskey="P">前へ</a> |</li>
-        <li><a href="index.html">groonga v2.0.9ドキュメント</a> &raquo;</li> 
+        <li><a href="index.html">groonga v2.1.0ドキュメント</a> &raquo;</li> 
       </ul>
     </div>  
 
@@ -75,11 +75,11 @@
 <h1>13. groongaへのコントリビュート方法<a class="headerlink" href="#how-to-contribute-to-groonga" title="このヘッドラインへのパーマリンク">¶</a></h1>
 <p>groongaプロジェクトではみなさんからのコントリビュートを歓迎します！コントリビュートの方法はいくつもあります。groongaを使ったり誰かに紹介することもコントリビュートですし、バグレポートを送ったり、groonga本体やgroonga関連の開発に参加することもコントリビュートです。プログラムではなく、ドキュメントでのコントリビュートも歓迎します！</p>
 <dl class="docutils">
-<dt>As a user:</dt>
+<dt>ユーザーの立場で:</dt>
 <dd>このドキュメントを読んでください。</dd>
-<dt>As a spokesman:</dt>
+<dt>布教する立場で:</dt>
 <dd>groongaについてまわりの人に話してください。</dd>
-<dt>As a developer: Bug report, development and documentation</dt>
+<dt>開発者の立場で: 不具合報告や開発、ドキュメント</dt>
 <dd>これらについてはこのセクションで説明します。</dd>
 </dl>
 <div class="toctree-wrapper compound">
@@ -221,7 +221,7 @@
         <li class="right" >
           <a href="development/travis-ci.html" title="12.1. Travis CI"
              >前へ</a> |</li>
-        <li><a href="index.html">groonga v2.0.9ドキュメント</a> &raquo;</li> 
+        <li><a href="index.html">groonga v2.1.0ドキュメント</a> &raquo;</li> 
       </ul>
     </div>
     <div class="footer">

data/vendor/local/share/doc/groonga/ja/html/contribution/development.html

@@ -9,7 +9,7 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
     
-    <title>13.2. groonga開発者向け情報 &mdash; groonga v2.0.9ドキュメント</title>
+    <title>13.2. groonga開発者向け情報 &mdash; groonga v2.1.0ドキュメント</title>
     
     <link rel="stylesheet" href="../_static/groonga.css" type="text/css" />
     <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
@@ -17,7 +17,7 @@
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '../',
-        VERSION:     '2.0.9',
+        VERSION:     '2.1.0',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
@@ -28,7 +28,7 @@
     <script type="text/javascript" src="../_static/doctools.js"></script>
     <script type="text/javascript" src="../_static/translations.js"></script>
     <link rel="shortcut icon" href="../_static/favicon.ico"/>
-    <link rel="top" title="groonga v2.0.9ドキュメント" href="../index.html" />
+    <link rel="top" title="groonga v2.1.0ドキュメント" href="../index.html" />
     <link rel="up" title="13. groongaへのコントリビュート方法" href="../contribution.html" />
     <link rel="next" title="13.2.1. groonga 通信アーキテクチャ" href="development/com.html" />
     <link rel="prev" title="13.1. バグレポートの送り方" href="report.html" /> 
@@ -63,7 +63,7 @@
         <li class="right" >
           <a href="report.html" title="13.1. バグレポートの送り方"
              accesskey="P">前へ</a> |</li>
-        <li><a href="../index.html">groonga v2.0.9ドキュメント</a> &raquo;</li>
+        <li><a href="../index.html">groonga v2.1.0ドキュメント</a> &raquo;</li>
           <li><a href="../contribution.html" accesskey="U">13. groongaへのコントリビュート方法</a> &raquo;</li> 
       </ul>
     </div>  
@@ -133,7 +133,7 @@
         <li class="right" >
           <a href="report.html" title="13.1. バグレポートの送り方"
              >前へ</a> |</li>
-        <li><a href="../index.html">groonga v2.0.9ドキュメント</a> &raquo;</li>
+        <li><a href="../index.html">groonga v2.1.0ドキュメント</a> &raquo;</li>
           <li><a href="../contribution.html" >13. groongaへのコントリビュート方法</a> &raquo;</li> 
       </ul>
     </div>

data/vendor/local/share/doc/groonga/ja/html/contribution/development/com.html

@@ -9,7 +9,7 @@
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
     
-    <title>13.2.1. groonga 通信アーキテクチャ &mdash; groonga v2.0.9ドキュメント</title>
+    <title>13.2.1. groonga 通信アーキテクチャ &mdash; groonga v2.1.0ドキュメント</title>
     
     <link rel="stylesheet" href="../../_static/groonga.css" type="text/css" />
     <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
@@ -17,7 +17,7 @@
     <script type="text/javascript">
       var DOCUMENTATION_OPTIONS = {
         URL_ROOT:    '../../',
-        VERSION:     '2.0.9',
+        VERSION:     '2.1.0',
         COLLAPSE_INDEX: false,
         FILE_SUFFIX: '.html',
         HAS_SOURCE:  true
@@ -28,7 +28,7 @@
     <script type="text/javascript" src="../../_static/doctools.js"></script>
     <script type="text/javascript" src="../../_static/translations.js"></script>
     <link rel="shortcut icon" href="../../_static/favicon.ico"/>
-    <link rel="top" title="groonga v2.0.9ドキュメント" href="../../index.html" />
+    <link rel="top" title="groonga v2.1.0ドキュメント" href="../../index.html" />
     <link rel="up" title="13.2. groonga開発者向け情報" href="../development.html" />
     <link rel="next" title="13.2.2. ドキュメント作成" href="document.html" />
     <link rel="prev" title="13.2. groonga開発者向け情報" href="../development.html" /> 
@@ -63,7 +63,7 @@
         <li class="right" >
           <a href="../development.html" title="13.2. groonga開発者向け情報"
              accesskey="P">前へ</a> |</li>
-        <li><a href="../../index.html">groonga v2.0.9ドキュメント</a> &raquo;</li>
+        <li><a href="../../index.html">groonga v2.1.0ドキュメント</a> &raquo;</li>
           <li><a href="../../contribution.html" >13. groongaへのコントリビュート方法</a> &raquo;</li>
           <li><a href="../development.html" accesskey="U">13.2. groonga開発者向け情報</a> &raquo;</li> 
       </ul>
@@ -148,7 +148,7 @@ edgeがworkerに結びついていないときは、同時に、ctx_newという
         <li class="right" >
           <a href="../development.html" title="13.2. groonga開発者向け情報"
              >前へ</a> |</li>
-        <li><a href="../../index.html">groonga v2.0.9ドキュメント</a> &raquo;</li>
+        <li><a href="../../index.html">groonga v2.1.0ドキュメント</a> &raquo;</li>
           <li><a href="../../contribution.html" >13. groongaへのコントリビュート方法</a> &raquo;</li>
           <li><a href="../development.html" >13.2. groonga開発者向け情報</a> &raquo;</li> 
       </ul>