rroonga 1.0.1-x86-mingw32 → 1.1.0-x86-mingw32

data/pkg/rroonga-1.1.0-x86-mingw32/README.ja.rdoc

@@ -0,0 +1,68 @@
+= はじめに
+
+== 名前
+
+rroonga
+
+== 説明
+
+全文検索機能とカラムストア機能を提供するgroongaのRubyバイン
+ディングです。
+
+groongaのいわゆるDB-API層をRubyから使うための拡張ライブラリで
+す。groongaのAPIをそのままRubyレベルに提供するのではなく、
+Rubyらしく読み書きしやすいAPIとして提供します。高速・高機能な
+groongaをRubyらしい書き方で利用できます。
+
+groongaに関する情報は以下を参照して下さい。
+
+* groonga: http://groonga.org/
+
+== 作者
+
+Kouhei Sutou:: <tt><kou@clear-code.com></tt>
+Tasuku SUENAGA:: <tt><a@razil.jp></tt>
+daijiro:: <tt><morita@razil.jp></tt>
+Yuto HAYAMIZU:: <tt><y.hayamizu@gmail.com></tt>
+SHIDARA Yoji:: <tt><dara@shidara.net></tt>
+
+== ライセンス
+
+LGPL 2.1です。詳しくはlicense/LGPLを見てください。
+
+（コントリビュートされたパッチなども含み、Kouhei Sutouが
+ライセンスを変更する権利を持ちます。）
+
+== 依存ソフトウェア
+
+* Ruby >= 1.8 （1.9.2対応）
+* groonga >= 1.1.0
+
+== インストール
+
+  % sudo gem install rroonga
+
+== ドキュメント
+
+http://groonga.rubyforge.org/rroonga/
+
+== メーリングリスト
+
+質問、要望、バグ報告などはgroongaのMLにお願いします。
+
+http://lists.sourceforge.jp/mailman/listinfo/groonga-dev
+
+== 感謝
+
+* 森さん: 最新groonga対応パッチをくれました。
+* グニャラくん: バグレポートしてくれました。
+* にくさん: バグレポートしてくれました。
+* daraさん:
+  * テストを書いてくれました。
+  * バグを直してくれました。
+* id:mat_akiさん: チュートリアルのバグを教えてくれました。
+* @yune_kotomiさん: バグレポートしてくれました。
+* 咳さん: バグレポートしてくれました。
+* 小野マトペさん: バグレポートしてくれました。
+* @kamipoさん: バグレポートしてくれました。
+* ongaeshiさん: Windows上でgemをビルドするためのパッチをくれました。

data/pkg/rroonga-1.1.0-x86-mingw32/README.rdoc

@@ -0,0 +1,68 @@
+= README
+
+== Name
+
+rroonga
+
+== Description
+
+Ruby bindings for groonga that provides full text search and
+column store features.
+
+rroonga is a extension library to use groonga's DB-API
+layer. rroonga provides Rubyish readable and writable
+API. You can use groonga's first and highly functional
+features from Ruby.
+
+See the following URL about groonga.
+
+* groonga: http://groonga.org/
+
+== Authors
+
+Kouhei Sutou:: <tt><kou@clear-code.com></tt>
+Tasuku SUENAGA:: <tt><a@razil.jp></tt>
+daijiro:: <tt><morita@razil.jp></tt>
+Yuto HAYAMIZU:: <tt><y.hayamizu@gmail.com></tt>
+SHIDARA Yoji:: <tt><dara@shidara.net></tt>
+
+== License
+
+LGPL 2.1. See license/LGPL for details.
+
+(Kouhei Sutou has a right to change the license
+inclidng contributed patches.)
+
+== Dependencies
+
+* Ruby >= 1.8 (including 1.9.2)
+* groonga >= 1.1.0
+
+== Install
+
+  % sudo gem install rroonga
+
+== Documents
+
+Japanese only. Sorry.
+
+http://groonga.rubyforge.org/rroonga/
+
+== Mailing list
+
+http://rubyforge.org/mailman/listinfo/groonga-users-en
+
+== Thanks
+
+* mori: sent patches to support the latest groonga.
+* Tasuku SUENAGA: sent bug reports.
+* niku: sent bug reports.
+* dara:
+  * wrote tests.
+  * fixed bugs.
+* id:mat_aki: sent bug reports.
+* @yune_kotomi: sent a bug report.
+* m_seki: sent bug reports.
+* ono matope: sent bug reports.
+* @kamipo: send a bug report.
+* ongaeshi: sent a patch to build gem on Windows.

data/pkg/rroonga-1.1.0-x86-mingw32/text/expression.rdoc

@@ -0,0 +1,285 @@
+# -*- coding: utf-8 -*-
+
+= grn式 (grn_expr)
+
+
+== 名前
+
+grn式 - 検索条件やデータベースへの操作を表現する文字列の形式。(読み方:"ぐるんしき")
+
+
+== 書式
+
+grn式はquery形式とscript形式のいずれかによって表現することができます。
+
+query形式
+
+[条件式]
+  以下の条件式が使用できます。
+
+  [文字列]
+    全文検索条件(デフォルト検索対象カラムの値が指定された文字列を含んでいる)
+
+  ["文字列"]
+    フレーズ検索条件(デフォルト検索対象カラムの値が指定されたフレーズを含んでいる)
+
+  [カラム名:値]
+    一致条件(カラム値 == 値)
+
+  [カラム名:!値]
+    不一致条件(カラム値 != 値)
+
+  [カラム名:<値]
+    比較条件(カラム値 < 値)
+
+  [カラム名:>値]
+    比較条件(カラム値 > 値)
+
+  [カラム名:<=値]
+    比較条件(カラム値 <= 値)
+
+  [カラム名:>=値]
+    比較条件(カラム値 >= 値)
+
+  [カラム名:@文字列]
+    全文検索条件(カラム値が指定された文字列を含んでいる)
+
+[補助演算子 [1]]
+  全文検索条件の挙動を制御する以下の演算子が指定できます。
+
+  [~文字列]
+    文字列を含んでいた場合は、そのレコードのスコアを下げます。
+
+  [<文字列]
+    文字列を含んでいた場合に加算されるスコアの値を小さくします。
+
+  [>文字列]
+    文字列を含んでいた場合に加算されるスコアの値を大きくします。
+
+  [文字列*]
+    文字列に前方一致する条件を示します。
+
+  [*S[数値]"文字列"]
+    文字列と関連する文書を検索します。文字列から抽出する特徴語の数を数値に指定します。
+
+  [*N[数値]"文字列"]
+    文字列に含まれる複数の語が、近傍に含まれる文書を検索します。近傍の範囲の上限とな
+    る語数を数値に指定します。N-gramの場合は、文字数を指定します。
+
+[結合演算子]
+  複数の条件式を結合するために以下の演算子が使用できる。演算子を伴わずに複数の条件式 が空白('
+  ')区切りで指定された場合は、デフォルトの結合演算子が指定されたものとみな される。
+
+  [a OR b]
+    論理和(aとbといずれかの条件がマッチする)
+
+  [a + b]
+    論理積(aとbの両方がマッチする)
+
+  [a - b]
+    aにマッチし、bにはマッチしない
+
+  [( )]
+    複数の条件をまとめる
+
+[プラグマ [2]]
+  query形式文字列の先頭に、処理方法を指定するプラグマを埋め込むことができます。
+
+  プラグマは必ずクエリ文字列の冒頭に存在しなければなりません。(先頭に空白を入れては いけません)
+
+  一つのクエリに複数のプラグマを指定することができます。
+
+  複数のプラグマを指定する場合は、間に空白を入れてはいけません。
+
+  [*E数値1[,数値2]]
+    検索結果の数が数値1よりも小さい場合、完全一致→非わかち書き→部分一致の順に自動
+    的に検索処理方法を切り替えます。完全一致でヒットした文書と比べて非わかち書き一致、
+    部分一致でヒットした文書には数値2分だけ小さいスコアを付与します。数値2を省略した
+    場合は既定値(=2)と解釈されます。数値1に負の数を指定した場合は以下のように処理し ます。
+
+    -1
+
+    完全一致検索のみを行う
+
+    -2
+
+    非わかち書き検索のみを行う
+
+    -3
+
+    完全一致検索と非わかち書き検索のみを行う
+
+    -4
+
+    部分一致検索のみを行う
+
+    -5
+
+    完全一致検索と部分一致検索のみを行う
+
+    -6
+
+    非わかち書き検索と部分一致検索のみを行う
+
+    -7
+
+    完全一致検索,非わかち書き検索,部分一致検索の全てを行う
+
+    例:
+
+    *E10,3
+
+    検索結果数が10件以下だった場合に検索処理方法を順次切り替え、スコアを3ずつ小さ くします。
+
+  [*D演算子]
+    結合演算子の既定値(演算子を省略した場合にどの演算を行うか)を指定します。指定できる演 算子は、OR, +, - のいずれかです。
+
+    例1:
+
+    *D+ abc def
+
+    abcとdefを両方含む文書を検索します。
+
+    例2:
+
+    *DOR abc def
+
+    abcとdefのいずれかを含む文書を検索します。
+
+  [*W[数値[:重み][,数値[:重み]]...]
+    数値で指定されたセクション番号のみを対象に検索します。セクションごとに検索スコア
+    の倍数を指定することができます。重みは、省略された場合1となります。負の重みも指 定することができます。
+
+script形式 [3]
+
+ECMAScript風の構文で検索条件やレコードへの操作を記述します。
+
+式中のIDENTIFIER(識別子)は、以下のいずれかを指します。
+
+[引数名]
+  grn式が受け取る引数の名前
+
+[カラム名]
+  操作対象としているレコードのカラム名
+
+[型名・関数名・テーブル名]
+  データベースに定義された型・テーブル・関数の名前
+
+
+== 説明
+
+grn式は、検索条件やデータベースへの操作を表現するために使用される文字列の形式です。
+
+selectやloadなどのいくつかの組込コマンドや、API関数grn_table_select()などで使用されます。grn式はquery
+形式とscript形式という2種類の方式で記述することができます。query形式は、多くのweb検索エンジンなどで検索フォームにユーザが指定
+可能なクエリ文字列の書式に合わせた形式です。script形式は、ECMAScriptの構文から式(expression)以下の構文要素を抜粋
+した形式になっており、文(statement)や制御構造などは表現できません。
+
+query形式のgrn式もscript形式のgrn式も、共通の中間形式に翻訳された上で処理されますので、処理速度や効率には差違はありません。
+記述できる処理の範囲はscript形式の方がquery形式より広くなっています。たとえば更新系の操作はscript形式のみで記述できます。
+
+DB-APIレイヤでは、異なる形式で記述された複数のgrn式を結合することも可能です。
+
+
+== 例
+
+query形式でcolumn1の値が'hoge'に等しいという条件
+
+column1:hoge
+
+script形式でcolumn1の値が'hoge'に等しいという条件
+
+column1 == "hoge"
+
+
+== 構文
+
+query形式のgrn式で有効な式の構文を拡張BNF記法で示します。
+
+  query             ::= query_element
+            | ( query query_element )
+            | ( query "+" query_element )
+            | ( query "-" query_element )
+            | ( query "OR" query_element )
+  query_element     ::= STRING
+                    | ( "(" query ")" )
+                    | ( IDENTIFIER relative_operator query_element )
+  relative_operator ::= ( ":" | ":!" | ":<" | ":>" | ":<=" | ":>=" | ":@" )
+
+script形式のgrn式で有効な式の構文を拡張BNF記法で示します。
+
+  expression                   ::= assignment_expression
+  expression                   ::= ( expression "," assignment_expression )
+  assignment_expression        ::= conditional_expression
+                            | ( lefthand_side_expression assign_operator assignment_expression )
+  assign_operator              ::= ( "=" | "*=" | "/=" | "%=" | "+=" | "-=" | "<<=" | ">>=" | ">>>=" | "&=" | "^=" | "|=" )
+  conditional_expression       ::= logical_or_expression
+                             | ( logical_or_expression "?" assignment_expression ":" assignment_expression )
+  logical_or_expression        ::= logical_and_expression
+                            | ( logical_or_expression "||" logical_and_expression )
+  logical_and_expression       ::= bitwise_or_expression
+                             | ( logical_and_expression logical_and_operator bitwise_or_expression )
+  logical_and_operator         ::= ( "&&" | "&!" )
+  bitwise_or_expression        ::= bitwise_xor_expression
+                            | ( bitwise_or_expression "|" bitwise_xor_expression )
+  bitwise_xor_expression       ::= bitwise_and_expression
+                             | ( bitwise_xor_expression "^" bitwise_and_expression )
+  bitwise_and_expression       ::= equality_expression
+                             | bitwise_and_expression "&" equality_expression )
+  equality_expression          ::= relational_expression
+                          | ( equality_expression equality_operator relational_expression )
+  equality_operator            ::= ( "==" | "!=" )
+  relational_expression        ::= shift_expression
+                            | ( relational_expression relational_operator shift_expression )
+  relational_operator          ::= ( "<" | ">" | "<=" | ">=" | "in" | "@" )
+  shift_expression             ::= additive_expression
+                       | ( shift_expression shift_operator additive_expression )
+  shift_operator               ::= ( "<<" | ">>" | ">>>" )
+  additive_expression          ::= multiplicative_expression
+                          | ( additive_expression additive_operator multiplicative_expression )
+  additive_operator            ::= ( "+" | "-" )
+  multiplicative_expression    ::= unary_expression
+                                | ( multiplicative_expression multiplicative_operator unary_expression )
+  multiplicative_operator      ::= ( "*" | "/" | "%" )
+  unary_expression             ::= postfix_expression
+                       | ( unary_operator unary_expression )
+  unary_operator               ::= ( "delete" : "++" : "--" : "+" : "-" : "!" : "~" )
+  postfix_expression           ::= lefthand_side_expression
+                         | ( lefthand_side_expression postfix_operator )
+  postfix_operator             ::= ( "++" | "--" )
+  lefthand_side_expression     ::= (call_expression | member_expression)
+  call_expression              ::= member_expression arguments
+  member_expression            ::= primary_expression
+  member_expression            ::= member_expression member_expression_part
+  primary_expression           ::= object_literal
+                         | ( "(" expression ")" )
+                         | IDENTIFIER
+                         | array_literal
+                         | DECIMAL
+                         | HEX_INTEGER
+                         | STRING
+                         | "true"
+                         | "false
+                         | "null"
+  array_literal                ::= ( "[" elision "]" )
+                    | ( "[" `element_list elision` "]" )
+                    | ( "[" element_list "]" )
+  elision                      ::= "," | ( elision "," )
+  element_list                 ::= assignment_expression
+                   | ( elision assignment_expression )
+                   | ( element_list elision assignment_expression )
+  object_literal               ::= ( "{" property_name_and_value_list "}" )
+  property_name_and_value_list ::= ( property_name_and_value_list "," property_name_and_value )
+  property_name_and_value      ::= ( property_name ":" assignment_expression )
+  property_name                ::= IDENTIFIER | STRING | DECIMAL
+  member_expression_part       ::= "[" expression "]" | ( "." IDENTIFIER )
+  arguments                    ::= ( "(" argument_list ")" )
+  argument_list                ::= assignment_expression | ( argument_list "," assignment_expression )
+
+-[ 脚注 ]-
+
+[1] 補助演算子はv1.0でサポートされます。
+
+[2] プラグマはv1.0でサポートされます。
+
+[3] script形式のgrn式はv1.0でサポートされます。

data/{text/TUTORIAL.ja.rdoc → pkg/rroonga-1.1.0-x86-mingw32/text/tutorial.ja.rdoc}

@@ -7,7 +7,7 @@ rroongaの操作方法を紹介します。
 
 == インストール
 
-Ruby/groongaはRubyGemsでインストールできます。
+rroongaはRubyGemsでインストールできます。
 
   % sudo gem install rroonga
 
@@ -55,19 +55,23 @@ groongaには以下の3種類のテーブルがあります。
 ここではハッシュテーブルを利用して、<tt>Items</tt>という名前のテー
 ブルを作成します。キーは文字列とします。
 
-  >> items = Groonga::Hash.create(:name => "Items", :key_type => "ShortText")
-  => #<Groonga::Hash ...>
-
+  >> Groonga::Schema.create_table("Items", :type => :hash)
+  => [...]
 
 これで<tt>Items</tt>という名前のテーブルが作成できました。
 
+定義したテーブルはGroonga.[]で参照できます。
+
+  >> items = Groonga["Items"]
+  => #<Groonga::Hash ...>
+
 テーブルはRubyのHashのように扱えます。
 
 例えば、以下のように+size+でテーブルに登録されているレコード
 の件数を取得できます。
 
   >> items.size
-  0
+  => 0
 
 == レコードを追加する
 
@@ -75,7 +79,7 @@ groongaには以下の3種類のテーブルがあります。
 
   >> items.add("http://ja.wikipedia.org/wiki/Ruby")
   => #<Groonga::Record ...>
-  >> items.add("http://www.ruby-lang.org/")
+  >> items.add("http://www.ruby-lang.org/ja/")
   => #<Groonga::Record ...>
 
 件数を確認すると確かに2件増えています。
@@ -85,7 +89,7 @@ groongaには以下の3種類のテーブルがあります。
 
 主キーを指定してレコードを取り出す時には以下のようにします。
 
-  >> items.find("http://ja.wikipedia.org/wiki/Ruby")
+  >> items["http://ja.wikipedia.org/wiki/Ruby"]
   => #<Groonga::Record ...>
 
 == 全文検索を行う
@@ -93,42 +97,52 @@ groongaには以下の3種類のテーブルがあります。
 各itemのタイトル文字列を登録して、全文検索できるようにしてみ
 ましょう。
 
-まず<tt>Items</tt>テーブルに+title+という名前のカラムを追加します。
+まず<tt>Items</tt>テーブルに+title+という名前のカラムを追加し
+ます。ここでは、<tt>Text</tt>型のデータを持つカラムとして定義
+します。
 
-  >> title_column = items.define_column("title", "Text")
-  => #<Groonga::VarSizeColumn ...>
+  >> Groonga::Schema.change_table("Items") do |table|
+  ?>     table.text("title")
+  >>   end
+  => [...]
 
-2番目の引数は、追加するカラムのデータ型を示しています。
-<tt><int></tt>、<tt>Text</tt>、<tt><longtext></tt>等の型が基本型として用意されて
-います。
+定義したカラムは「#{テーブル名}.#{カラム名}」という名前になります。
+テーブルと同じようにGroonga.[]で参照できます。
 
-全文検索するためには、文字列を分解して得られる各単語を格納す
-るためのテーブルを別途しなければなりません。ここではTermsと
-いう名前でテーブルを定義します。
+  >> title_column = Groonga["Items.title"]
+  => #<Groonga::VariableSizeColumn ...>
 
-  >> terms = Groonga::Hash.create(:name => "Terms",
-                                  :key_type => "ShortText",
-                                  :default_tokenizer => "TokenBigram")
-  => #<Groonga::Hash ...>
+全文検索するために、文字列を分解して得られる各単語を格納する
+ためのテーブルを別途用意します。ここではTermsという名前でテー
+ブルを定義します。
+
+  >> Groonga::Schema.create_table("Terms",
+  ?>                              :type => :patricia_trie,
+  ?>                              :key_normalize => true,
+  ?>                              :default_tokenizer => "TokenBigram")
 
 ここでは、トークナイザとして<tt>:default_tokenzier =>
-"TokenBigram"</tt> を指定しています。トークナイザとは文字
-列を単語に分解するオブジェクトのことです。デフォルトではトー
-クナイザは指定されていません。全文検索を利用するためにはトー
-クナイザを指定する必要があるので、ここではN-gramの一種である
-バイグラムを指定しています。
+"TokenBigram"</tt> を指定しています。トークナイザとは文字列を
+単語に分解するオブジェクトのことです。デフォルトではトークナ
+イザは指定されていません。全文検索を利用するためにはトークナ
+イザを指定する必要があるので、ここではN-gramの一種であるバイ
+グラムを指定しています。
 
 N-gramを利用した全文検索では、分解したN文字とその出現位置を利
 用して全文検索を行います。N-gramのNは文字列を何文字毎に分解す
 るかの文字数になります。groongaは1文字で分解するユニグラム、
 2文字のバイグラム、3文字のトリグラムをサポートしています。
 
+また、大文字小文字の区別なく検索するために
+<tt>:key_normalize => true</tt>も指定しています。
+
 単語格納用テーブルの準備ができたので、<tt>Items</tt>テーブ
 ルの+title+カラムに対するインデックスを定義します。
 
-  >> title_index_column = terms.define_index_column("item_title", items,
-						    :source => "Items.title")
-  => #<Groonga::IndexColumn ...>
+  >> Groonga::Schema.change_table("Terms") do |table|
+  ?>     table.index("Items.title")
+  >>   end
+  => [...]
 
 少し違和感を感じるかも知れませんが、<tt>Items</tt>テーブル
 のカラムに対するインデックスは、<tt>Terms</tt>テーブルのカ
@@ -148,22 +162,31 @@ N-gramを利用した全文検索では、分解したN文字とその出現位
 
 先ほど登録した各レコードの+title+カラムに値をセットします。
 
-  >> items.find("http://ja.wikipedia.org/wiki/Ruby")["title"] = "Ruby"
+  >> items["http://ja.wikipedia.org/wiki/Ruby"].title = "Ruby"
   => "Ruby"
-  >> items.find("http://www.ruby-lang.org/")["title"] = "オブジェクトスクリプト言語Ruby"
+  >> items["http://www.ruby-lang.org/ja/"].title = "オブジェクトスクリプト言語Ruby"
   "オブジェクトスクリプト言語Ruby"
 
 以下のようにして検索することができます。
 
-  >> title_index_column.search("Ruby").collect {|record| record.key.key}
-  ["http://ja.wikipedia.org/wiki/Ruby", "http://www.ruby-lang.org/"]
+  >> ruby_items = items.select {|record| record.title =~ "Ruby"}
+  => #<Groonga::Hash ..., size: <2>>
 
 検索結果はGroonga::Hashで返されます。ハッシュのキーに見つかっ
-た<tt>Items</tt>のレコードが入っています。上の例では
-+record.key+で<tt>Items</tt>のレコードを取得して、さらにそ
-のキーを指定して（+record.key.key+）で<tt>Items</tt>のキー
-を返しています。
+た<tt>Items</tt>のレコードが入っています。
 
+  >> ruby_items.collect {|record| record.key.key}
+  => ["http://ja.wikipedia.org/wiki/Ruby", "http://www.ruby-lang.org/ja/"]
+
+上の例では+record.key+で<tt>Items</tt>のレコードを取得して、
+さらにそのキーを指定して（+record.key.key+）で<tt>Items</tt>
+のキーを返しています。
+
++record["_key"]+でアクセスすると自動的に参照しているレコード
+を辿っていき、参照先のキーにアクセスできます。
+
+  >> ruby_items.collect {|record| record["_key"]}
+  => ["http://ja.wikipedia.org/wiki/Ruby", "http://www.ruby-lang.org/ja/"]
 
 == マルチユーザ向けのブックマークアプリケーション
 
@@ -178,37 +201,35 @@ http://qwik.jp/senna/senna2.files/rect4605.png
 
 まず、<tt>Users</tt>テーブルを追加します。
 
-  >> users = Groonga::Hash.create(:name => "Users",
-                                  :key_type => "ShortText")
-  => #<Groonga::Hash ...>
-  >> users.define_column("name", "Text")
-  => #<Groonga::VarSizeColumn ...>
-
+  >> Groonga::Schema.create_table("Users", :type => :hash) do |table|
+  ?>     table.text("name")
+  >>   end
+  => [...]
 
 次に、<tt>Comments</tt>テーブルを追加します。
 
-  >> comments = Groonga::Array.create(:name => "Comments")
-  => #<Groonga::Array ...>
-  >> comments.define_column("item", items)
-  => #<Groonga::FixSizeColumn ..>
-  >> comments.define_column("author", users)
-  => #<Groonga::FixSizeColumn ..>
-  >> comments.define_column("content", "Text")
-  => #<Groonga::VarSizeColumn ..>
-  >> comments.define_column("issued", "Time")
-  => #<Groonga::FixSizeColumn ..>
+  >> Groonga::Schema.create_table("Comments") do |table|
+  ?>     table.reference("item")
+  >>   table.reference("author", "Users")
+  >>   table.text("content")
+  >>   table.time("issued")
+  >>   end
+  => [...]
 
 <tt>Comments</tt>テーブルの+content+カラムを全文検索できる
 ようにインデックスを定義します。
 
-  >> terms.define_index_column("comment_content", comments,
-                               :source => "Comments.content")
-  => #<Groonga::IndexColumn ...>
+  >> Groonga::Schema.change_table("Terms") do |table|
+  ?>     table.index("Comments.content")
+  >>   end
+  => [...]
 
 これでテーブルが定義できました。
 
 続いてユーザを何人か追加します。
 
+  >> users = Groonga["Users"]
+  => #<Groonga::Hash ...>
   >> users.add("moritan", :name => "モリタン")
   => #<Groonga::Record ...>
   >> users.add("taporobo", :name => "タポロボ")
@@ -217,28 +238,32 @@ http://qwik.jp/senna/senna2.files/rect4605.png
 次に、実際にユーザがブックマークを貼る時の処理を実行してみま
 しょう。
 
-ユーザ+moritan+が、はてなダイアリーのとあるページをブックマーク
-したと想定します。
+ユーザ+moritan+が、Ruby関連のとあるページをブックマークしたと
+想定します。
 
 まず対象のページが<tt>Items</tt>テーブルに登録済かどうか調
 べます。
 
-  >> items.find("http://d.hatena.ne.jp/brazil/20050829/1125321936")
-  => nil
+  >> items.has_key?("http://www.rubyist.net/~matz/")
+  => false
 
 未登録なのでまず当該ページを<tt>Items</tt>に登録します。
 
-  >> items.add("http://d.hatena.ne.jp/brazil/20050829/1125321936",
-               :title => "[翻訳]JavaScript: 世界で最も誤解されたプログラミング言語")
+  >> items.add("http://www.rubyist.net/~matz/",
+  ?>           :title => "Matzにっき")
   => #<Groonga::Record ...>
 
 次に、登録したitemを+item+カラムの値に指定して
 <tt>Comments</tt>にレコードを登録します。
 
-  >> comments.add(:item => "http://d.hatena.ne.jp/brazil/20050829/1125321936",
-                  :author => "moritan",
-                  :content => "JavaScript LISP",
-                  :issued => 1187430026)
+  >> require "time"
+  => true
+  >> comments = Groonga["Comments"]
+  => #<Groonga::Array ...>
+  >> comments.add(:item => "http://www.rubyist.net/~matz/",
+  ?>              :author => "moritan",
+  ?>              :content => "Ruby Matz",
+  ?>              :issued => Time.parse("2010-11-20T18:01:22+09:00"))
   => #<Groonga::Record ...>
 
 == メソッド化
@@ -246,14 +271,17 @@ http://qwik.jp/senna/senna2.files/rect4605.png
 上記の一連の手続きをメソッドにまとめてみます。
 
   >> @items = items
+  => #<Groonga::Hash ...>
   >> @comments = comments
+  => #<Groonga::Array ...>
   >> def add_bookmark(url, title, author, content, issued)
-  >>   item = @items.find(url) || @items.add(url, :title => title)
+  >>   item = @items[url] || @items.add(url, :title => title)
   >>   @comments.add(:item => item,
-  >>                 :author => author,
-  >>                 :content => content,
-  >>                 :issued => issued)
-  >> end
+  ?>                 :author => author,
+  ?>                 :content => content,
+  ?>                 :issued => issued)
+  >>   end
+  => nil
 
 +itmes+と+comments+をインスタンス変数に代入しているのはメソッ
 ド内からでも見えるようにするためです。
@@ -267,15 +295,18 @@ http://qwik.jp/senna/senna2.files/rect4605.png
 作成したメソッドを呼び出していくつかブックマークを登録してみ
 ましょう。
 
-  >> add_bookmark("http://practical-scheme.net/docs/cont-j.html",
-                  "なんでも継続", "moritan", "継続 LISP Scheme", 1187568692)
+  >> add_bookmark("http://jp.rubyist.net/magazine/",
+  ?>              "Rubyist Magazine - るびま", "moritan", "Ruby 記事",
+  ?>              Time.parse("2010-10-07T14:18:28+09:00"))
   => #<Groonga::Record ...>
-  >> add_bookmark("http://d.hatena.ne.jp/higepon/20070815/1187192864",
-                  "末尾再帰", "taporobo", "末尾再帰 Scheme LISP", 1187568793)
+  >> add_bookmark("http://groonga.rubyforge.org/",
+  ?>              "Rubyでgroonga使って全文検索 - ラングバ", "taporobo",
+  ?>              "Ruby groonga 全文検索",
+  ?>              Time.parse("2010-11-11T12:39:59+09:00"))
   => #<Groonga::Record ...>
-  >> add_bookmark("http://practical-scheme.net/docs/cont-j.html",
-                  "なんでも継続", "taporobo", "トランポリン LISP continuation",
-                  1187568692)
+  >> add_bookmark("http://www.rubyist.net/~matz/",
+  ?>              "Matz日記", "taporobo", "Ruby 日記",
+  ?>              Time.parse("2010-07-28T20:46:23+09:00"))
   => #<Groonga::Record ...>
 
 == 全文検索その2
@@ -283,25 +314,27 @@ http://qwik.jp/senna/senna2.files/rect4605.png
 登録したレコードに対して全文検索を実行してみます。
 
   >> records = comments.select do |record|
-  >>   record["content"] =~ "LISP"
-  >> end
+  ?>     record["content"] =~ "Ruby"
+  >>   end
+  => #<Groonga::Hash ...>
   >> records.each do |record|
-  >>   record = record.key
+  ?>     record = record.key
   >>   p [record.id,
-  >>      record[".issued"],
-  >>      record[".item.title"],
-  >>      record[".author.name"],
-  >>      record[".content"]]
-  >> end
-  [1, Sat Aug 18 18:40:26 +0900 2007, "[翻訳]JavaScript: 世界で最も誤解されたプログラミング言語", "モリタン", "JavaScript LISP"]
-  [2, Mon Aug 20 09:11:32 +0900 2007, "なんでも継続", "モリタン", "継続 LISP Scheme"]
-  [3, Mon Aug 20 09:13:13 +0900 2007, "末尾再帰", "タポロボ", "末尾再帰 Scheme LISP"]
-  [4, Mon Aug 20 09:11:32 +0900 2007, "なんでも継続", "タポロボ", "トランポリン LISP continuation"]
-
-カラムへのアクセスは、カラム名を+.+で繋いで複合データ型の要素
-を再帰的に辿ることができます。（同様の出力を普通のRDBで実現す
-るためには、<tt>Items</tt>テーブル、<tt>Comments</tt>テー
-ブル、<tt>Users</tt>テーブルのJOIN操作が必要になります。）
+  ?>       record.issued,
+  ?>       record.item.title,
+  ?>       record.author.name,
+  ?>       record.content]
+  >>   end
+  [1, Sat Nov 20 18:01:22 +0900 2010, "Matzにっき", "モリタン", "Ruby Matz"]
+  [2, Thu Oct 07 14:18:28 +0900 2010, "Rubyist Magazine - るびま", "モリタン", "Ruby 記事"]
+  [3, Thu Nov 11 12:39:59 +0900 2010, "Rubyでgroonga使って全文検索 - ラングバ", "タポロボ", "Ruby groonga 全文検索検"]
+  [4, Wed Jul 28 20:46:23 +0900 2010, "Matzにっき", "タポロボ", "Ruby 日記"]
+
+カラム名と同じメソッドでカラムへのアクセスできます。複合デー
+タ型の要素も再帰的に辿ることができます。（同様の出力を普通の
+RDBで実現するためには、<tt>Items</tt>テーブル、
+<tt>Comments</tt>テーブル、<tt>Users</tt>テーブルのJOIN操作が
+必要になります。）
 
 上の式の中で、肝心の検索処理は、第一引数の式を評価する時点で
 完了していて、レコードセットオブジェクトとしてメモリに蓄積さ
@@ -314,31 +347,33 @@ http://qwik.jp/senna/senna2.files/rect4605.png
 
 以下は、日付で降順にソートしてから出力した例です。
 
-  >> records.sort([{:key => ".issued", :order => "descending"}]).each do |record|
-  >>   record = record.key
+  >> records.sort([{:key => "issued", :order => "descending"}]).each do |record|
+  ?>     record = record.key
   >>   p [record.id,
-  >>      record[".issued"],
-  >>      record[".item.title"],
-  >>      record[".author.name"],
-  >>      record[".content"]]
-  >> end
-  [3, Mon Aug 20 09:13:13 +0900 2007, "末尾再帰", "タポロボ", "末尾再帰 Scheme LISP"]
-  [2, Mon Aug 20 09:11:32 +0900 2007, "なんでも継続", "モリタン", "継続 LISP Scheme"]
-  [4, Mon Aug 20 09:11:32 +0900 2007, "なんでも継続", "タポロボ", "トランポリン LISP continuation"]
-  [1, Sat Aug 18 18:40:26 +0900 2007, "[翻訳]JavaScript: 世界で最も誤解されたプログラミング言語", "モリタン", "JavaScript LISP"]
+  ?>       record.issued,
+  ?>       record.item.title,
+  ?>       record.author.name,
+  ?>       record.content]
+  >>   end
+  [1, Sat Nov 20 18:01:22 +0900 2010, "Matzにっき", "モリタン", "Ruby Matz"]
+  [3, Thu Nov 11 12:39:59 +0900 2010, "Rubyでgroonga使って全文検索 - ラングバ", "タポロボ", "Ruby groonga 全文検索"]
+  [2, Thu Oct 07 14:18:28 +0900 2010, "Rubyist Magazine - るびま", "モリタン", "Ruby 記事"]
+  [4, Wed Jul 28 20:46:23 +0900 2010, "Matzにっき, "タポロボ", "Ruby 日記"]
+  => [...]
 
 同じitemが何度も出てくると検索結果が見にくいので、item毎にグ
 ループ化してみます。
 
   >> records.group("item").each do |record|
-  >>   item = record.key
+  ?>     item = record.key
   >>   p [record.n_sub_records,
-  >>      item.key,
-  >>      item[".title"]]
-  >> end
-  [1, "http://d.hatena.ne.jp/brazil/20050829/1125321936", "[翻訳]JavaScript: 世界で最も誤解されたプログラミング言語"]
-  [2, "http://practical-scheme.net/docs/cont-j.html", "なんでも継続"]
-  [1, "http://d.hatena.ne.jp/higepon/20070815/1187192864", "末尾再帰"]
+  ?>       item.key,
+  ?>       item.title]
+  >>   end
+  [2, "http://www.rubyist.net/~matz/", "Matzにっき"]
+  [1, "http://jp.rubyist.net/magazine/", "Rubyist Magazine - るびま"]
+  [1, "http://groonga.rubyforge.org/", "Rubyでgroonga使って全文検索 - ラングバ"]
+  => nil
 
 +n_sub_records+というのはグループ化した単位に含まれるレコード
 の件数を示します。SQLで言えば、GROUP BY句を含むクエリのcount
@@ -346,8 +381,6 @@ http://qwik.jp/senna/senna2.files/rect4605.png
 
 == 少し複雑な検索
 
-↓はまだ動かない！！！
-
 さらに実用的な検索について考えてみましょう。
 
 ブックマークが大量に蓄積されるに従って、より的確に適合度を算
@@ -373,22 +406,28 @@ http://qwik.jp/senna/senna2.files/rect4605.png
 以下のようにして、commentとitemとそれぞれに対する検索結果を求
 めます。
 
-  >> ruby_comments = @comments.select {|record| record["content"] =~ "Ruby"}
-  #<Groonga::Hash ..., size: <2>>
-  >> ruby_items = @items.select("*W1:50 title:@Ruby")
-  #<Groonga::Hash ..., size: <2>>
+  >> ruby_comments = @comments.select {|record| record.content =~ "Ruby"}
+  => #<Groonga::Hash ..., size: <4>
+  >> ruby_items = @items.select do |record|
+  ?>     target = record.match_target do |match_record|
+  ?>       match_record.title * 10
+  >>     end
+  >>   target =~ "Ruby"
+  >>   end
+  #<Groonga::Hash ..., size: <4>>
 
 _ruby_comments_の結果をitem毎にグループ化し、_ruby_items_と
 unionして出力します。
 
   >> ruby_items = ruby_comments.group("item").union!(ruby_items)
-  #<Groonga::Hash ..., size: <4>>
-  >> ruby_items.sort([{:key => "._score", :order => "descendant"}]).each do |record|
-  >>   p [record["._score"], record[".title"]]
+  #<Groonga::Hash ..., size: <5>>
+  >> ruby_items.sort([{:key => "_score", :order => "descending"}]).each do |record|
+  >>   p [record.score, record.title]
   >> end
-  [1, "るびま"]
-  [1, "オブジェクトスクリプト言語Ruby"]
-  [1, "Ruby"]
-  [1, "ラングバ"]
+  [10, "Rubyist Magazine - るびま"]
+  [10, "Ruby"]
+  [10, "Rubyでgroonga使って全文検索 - ラングバ"]
+  [10, "オブジェクトスクリプト言語Ruby"]
+  [2, "Matzにっき"]
 
-これで目的の結果が得られました。（FIXME: 得られていない！）
+これで目的の結果が得られました。