rroonga 1.2.7-x86-mingw32 → 1.3.0-x86-mingw32

data/vendor/local/share/doc/groonga/{en/html/_sources/tutorial/tutorial06.txt → source/tutorial/index.txt}

@@ -2,7 +2,7 @@
 
 .. highlightlang:: none
 
-.. groonga-include : tutorial05.txt
+.. groonga-include : drilldown.txt
 .. groonga-command
 .. table_remove GeoIndex
 
@@ -24,7 +24,7 @@
 タグの情報を保存する、Tagテーブルを作成します。Tagテーブルでは、タグ文字列を主キーに格納し、Videoテーブルのtagsカラムに対するインデックスをindex_tagsカラムに格納しています。
 
 .. groonga-command
-.. include:: ../example/tutorial06-1.log
+.. include:: ../example/tutorial/index-1.log
 .. table_create --name Video --flags TABLE_HASH_KEY --key_type UInt32
 .. table_create --name Tag --flags TABLE_HASH_KEY --key_type ShortText
 .. column_create --table Video --name title --flags COLUMN_SCALAR --type ShortText
@@ -47,7 +47,7 @@
 「ある語句が付与されている動画の一覧を取得する」検索を行いましょう。
 
 .. groonga-command
-.. include:: ../example/tutorial06-2.log
+.. include:: ../example/tutorial/index-2.log
 .. select --table Video --query tags:@Variety --output_columns _key,title
 .. select --table Video --query tags:@Sports --output_columns _key,title
 .. select --table Video --query tags:@Animation --output_columns _key,title
@@ -64,7 +64,7 @@ groongaはテーブル間の参照関係の逆引きを高速に行うための
 以下の例では、ユーザー情報を格納するUserテーブルを作成し、ユーザー名を格納するusernameカラム、ユーザーの友人一覧を配列で格納するfriendsカラムとそのインデックスのindex_friendsカラムを追加しています。
 
 .. groonga-command
-.. include:: ../example/tutorial06-3.log
+.. include:: ../example/tutorial/index-3.log
 .. table_create --name User --flags TABLE_HASH_KEY --key_type ShortText
 .. column_create --table User --name username --flags COLUMN_SCALAR --type ShortText
 .. column_create --table User --name friends --flags COLUMN_VECTOR --type User
@@ -82,14 +82,14 @@ groongaはテーブル間の参照関係の逆引きを高速に行うための
 指定したユーザーを友人リストに入れているユーザーの一覧を表示してみましょう。
 
 .. groonga-command
-.. include:: ../example/tutorial06-4.log
+.. include:: ../example/tutorial/index-4.log
 .. select --table User --query friends:@tomo --output_columns _key,username
 .. select --table User --query friends:@jiro --output_columns _key,username
 
 さらに、ドリルダウンを使って、友人リストに入っている数の一覧を表示してみましょう。
 
 .. groonga-command
-.. include:: ../example/tutorial06-5.log
+.. include:: ../example/tutorial/index-5.log
 .. select --table User --limit 0 --drilldown friends
 
 このように、テーブルの参照関係を逆にたどる検索ができました。
@@ -100,7 +100,7 @@ groongaはテーブル間の参照関係の逆引きを高速に行うための
 位置情報のカラムに対して、インデックスを付与することが出来ます。大量の位置情報レコードを検索する場合に、検索速度が速くなります。
 
 .. groonga-command
-.. include:: ../example/tutorial06-6.log
+.. include:: ../example/tutorial/index-6.log
 .. table_create --name GeoIndex --flags TABLE_PAT_KEY --key_type WGS84GeoPoint
 .. column_create --table GeoIndex --name index_point --type Site --flags COLUMN_INDEX --source location
 .. load --table Site
@@ -113,5 +113,5 @@ groongaはテーブル間の参照関係の逆引きを高速に行うための
 同様に、位置情報レコードを用いてソートする場合に、ソート速度が速くなります。
 
 .. groonga-command
-.. include:: ../example/tutorial06-7.log
+.. include:: ../example/tutorial/index-7.log
 .. select --table Site --filter 'geo_in_circle(location, "128515259x503187188", 50000)' --output_columns _key,location,_score --sortby '-geo_distance(location, "128515259x503187188")' --scorer '_score = geo_distance(location, "128515259x503187188")'

data/vendor/local/share/doc/groonga/source/tutorial/introduction.txt

@@ -0,0 +1,297 @@
+.. -*- rst -*-
+
+.. highlightlang:: none
+
+.. groonga-command
+.. database: tutorial
+.. table_remove Site
+.. table_remove Terms
+
+Fundamental operation
+=====================
+
+You can use groonga as a library of programming language C or an executable file.
+This tutorial explains how to use groonga as an executable file.
+Using its file, you can create and operate databases, start and connect to server, and so on.
+
+Create database
+---------------
+
+You can create a new database in the following command.
+
+Form ::
+
+  groonga -n DB_PATH_NAME
+
+'-n' option specifies to create a database. DB_PATH_NAME specifies full-path of new database.
+
+Groonga starts as interactive mode after you create a database with this command, and so groonga accepts commands from standard input. This mode is terminated with Ctrl-d.
+
+Execution example::
+
+  % groonga -n /tmp/tutorial.db
+  > ctrl-d
+  %
+
+Operate database
+----------------
+
+Form ::
+
+  groonga DB_PATH_NAME [COMMAND]
+
+DB_PATH_NAME specifies full-path of existing database.
+If COMMAND is specified, result of COMMAND is returned.
+
+With no COMMAND, this command starts groonga as interactive-mode.
+Groonga of this mode reads a command from standard input evaluates it repeatedly.
+This tutorial uses interactive-mode mainly.
+
+For example, we will run the `status` command.
+This command returns status of groonga's execution.
+
+.. groonga-command
+.. include:: ../example/tutorial/introduction-1.log
+.. .. % groonga -n /tmp/groonga-databases/introduction.db
+.. status
+
+The mentioned above, results of executed commands are generally JSON style.
+The first element in a array of JSON has information of error-code, execution time, and so on.
+The second element has a result of exectuted command.
+
+Commands
+--------
+
+You can operate database with various commands via execution file of groonga or groonga server.
+There are forms of commands in the following::
+
+ Form1: COMMAND ARGUMENT1 ARGUMENT2 ..
+
+ Form2: COMMAND --ARAGUMENT1 VALUE1 --ARGUMENT2 VALUE2 ..
+
+You can mix these forms in commands running.
+
+In Form2, if you want to specify a value including some spaces or symbols("'()/), you should enclose its value with single-quote or double-quote.
+
+For detail, you can see paragraph of "command" in :doc:`/executables/groonga`.
+
+Basicaly commands
+-----------------
+
+ :doc:`/commands/status`
+  Show status of groonga process.
+ :doc:`/commands/table_list`
+  Show lists of tables defined in a database.
+ :doc:`/commands/column_list`
+  Show lists of columns defined in a table.
+ :doc:`/commands/table_create`
+  Add table to a database.
+ :doc:`/commands/column_create`
+  Add column to a table.
+ :doc:`/commands/select`
+  Search and show records included a table.
+ :doc:`/commands/load`
+  Insert record to a table.
+
+Create table
+------------
+
+:doc:`/commands/table_create` creates table.
+
+In using groonga, to creating tables generally needed master key.
+Master key should be specified the types and the way to store.
+
+We're going to explain the types in tutorial after.
+Please imagine it as expressing sort of data.
+How to store master key defines speed of search with master key and advisability of begins-with-match search. This is also explained in this tutorial later.
+
+For example, we create 'Site' table. This table has master key of ShortText type, and the way to store its key is HASH.
+
+.. groonga-command
+.. include:: ../example/tutorial/introduction-2.log
+.. table_create --name Site --flags TABLE_HASH_KEY --key_type ShortText
+
+Search
+------
+
+:doc:`/commands/select` shows contents of table.
+
+.. groonga-command
+.. include:: ../example/tutorial/introduction-3.log
+.. select --table Site
+
+With name of a table, 'select' command shows 10 contents of its table. [0] shows the number of searched records. ["_id","Uint32"] is column named "_id" and type of this column's value is UInt32. ["_key","ShortText"] is "_key" column, type of this column's value is ShortText.
+
+'table_create' command creates table including two columns, '_id' and '_key' first. '_id' has ID-number given automatically by groonga. '_key' column is stored master key. You cannot modify this column's name.
+
+Create columns
+--------------
+
+:doc:`/commands/column_create` command create columns.
+
+We add a column named 'comment' that lets us store value whose type is ShortText.
+
+.. groonga-command
+.. include:: ../example/tutorial/introduction-4.log
+.. column_create --table Site --name title --flags COLUMN_SCALAR --type ShortText
+.. select --table Site
+
+COLUMN_SCALAR means this is normal column.
+
+Create terminology table with fulltext-searching
+------------------------------------------------
+
+This tutorial explains fulltext searching with entried data in groonga table.
+
+We need terminology table in fulltext-searching.
+Terminology table is a table whose master key's values are words in text.
+We create 'Terms' table, it has type of master key value is ShortText.
+
+.. groonga-command
+.. include:: ../example/tutorial/introduction-5.log
+.. table_create --name Terms --flags TABLE_PAT_KEY|KEY_NORMALIZE --key_type ShortText --default_tokenizer TokenBigram
+
+Many parameters is specified in this execution example.
+You don't hove to understand all parameters.
+There are the simple explaination, but you can skipped.
+
+In this examples, 'TABLE_PAT_KEY|KEY_NORMALIZE' stores master key in patricia-trie and entries each teminology after nomalized.
+The 'default_tokenizer' parametar specifies the way to tokenize target texts. In this examples, we specifies 'TokenBigram' as this parameter, and so we choose 'N-gram' generally called.
+
+Create index-column with fulltext search
+----------------------------------------
+
+We will fulltext search 'title' column in 'Site' table. In this case, we create column whose type index in terminology table.
+
+.. groonga-command
+.. include:: ../example/tutorial/introduction-6.log
+.. column_create --table Terms --name blog_title --flags COLUMN_INDEX|WITH_POSITION --type Site --source title
+
+This command creates index column 'blog_title' in 'Term' table. '--type' option specifies target indexed table, and '--source' option does target index column.
+In execution example, 'COLUMN_INDEX|WITH_POSITION' for '--flags' option specifies that this column is index column for storing information of terminology existing position. This option should be specified 'COLUMN_INDEX|WITH_POSITION' in generally fulltext searching. This tutorial does not deal with the reason why store information of terminology existing position.
+
+Load data
+---------
+
+:doc:`/commands/load` is used to load data for groonga database. This command stores json-formatted data in a table.
+
+.. groonga-command
+.. include:: ../example/tutorial/introduction-7.log
+.. load --table Site
+.. [
+.. {"_key":"http://example.org/","title":"This is test record 1!"},
+.. {"_key":"http://example.net/","title":"test record 2."},
+.. {"_key":"http://example.com/","title":"test test record three."},
+.. {"_key":"http://example.net/afr","title":"test record four."},
+.. {"_key":"http://example.org/aba","title":"test test test record five."},
+.. {"_key":"http://example.com/rab","title":"test test test test record six."},
+.. {"_key":"http://example.net/atv","title":"test test test record seven."},
+.. {"_key":"http://example.org/gat","title":"test test record eight."},
+.. {"_key":"http://example.com/vdw","title":"test test record nine."},
+.. ]
+
+Let's make sure that its table has data with 'select' command.
+
+.. groonga-command
+.. include:: ../example/tutorial/introduction-8.log
+.. select --table Site
+
+Search data
+-----------
+
+'_id' and '_key' columns are unique in groonga's table, so let's search data in table using these columns.
+
+You can search data using 'select' command with 'query' parameter.
+
+.. groonga-command
+.. include:: ../example/tutorial/introduction-9.log
+.. select --table Site --query _id:1
+
+'_id:1' specified 'query' parameter means to search records whose '_id' column has '1'.
+
+Let's search records with '_key' column.
+
+.. groonga-command
+.. include:: ../example/tutorial/introduction-10.log
+.. select --table Site --query "_key:\"http://example.org/\""
+
+'_key:\"http://example.org/\"' specified 'query' parameter means to search records whose '_key' column has '"http://example.org/"'.
+
+
+Fulltext searching
+------------------
+
+Using 'query' parameter, you can fulltext search with index.
+
+.. groonga-command
+.. include:: ../example/tutorial/introduction-11.log
+.. select --table Site --query title:@this
+
+This command shows result of fulltext searching by string 'this' for 'title' column.
+
+"title:@this" specified 'query' parameter means to search records whose 'title' column including 'this' string.
+
+'select' command has parameter 'match_columns'.
+
+If this parameter is specified, it means to search in columns specified 'match_columns' when 'query' parameter doesn't specify column-name condition.[1]_
+
+If you specify 'match_columns' is 'title' and 'query' is 'this', you can take same result as above query.
+
+.. groonga-command
+.. include:: ../example/tutorial/introduction-12.log
+.. select --table Site --match_columns title --query this
+
+Specify output column
+---------------------
+
+'output_columns' parameter in 'select' command specifies columns shown in result of search.
+
+If you want to specify some columns, you should separate column names by comma(,).
+
+.. groonga-command
+.. include:: ../example/tutorial/introduction-13.log
+.. select --table Site --output_columns _key,title,_score --query title:@test
+
+"_score" column is added to The groonga's result. This column has the higher number, the more condition of fulltext seaching matches text.
+
+Ranges to display
+-----------------
+
+'select' command can display result in only specified ranges using 'offset' and 'limit' parameter. This parameters is useful when you want to show only a page in much result of searching.
+
+'offset' parameter specifies starting point of result. If you want 'select' command to return from first records, this parameter specifies '0'.
+
+'limit' parameter specifies how many records of searching result.
+
+.. groonga-command
+.. include:: ../example/tutorial/introduction-14.log
+.. select --table Site --offset 0 --limit 3
+.. select --table Site --offset 3 --limit 3
+.. select --table Site --offset 7 --limit 3
+
+Sort
+-----
+
+If you use 'sortby' parameter in 'select' command, this command sorts result of searching.
+
+When 'sortby' parameter specifies column name, result is sorted in ascending-order to its column's value. This 'select' command also sort in descending-order when you add hyphen(-) before column name.
+
+.. groonga-command
+.. include:: ../example/tutorial/introduction-15.log
+.. select --table Site --sortby -_id
+
+For condition of sort, you can use '_score' column introduced in the paragraph of "Specify output column".
+
+.. groonga-command
+.. include:: ../example/tutorial/introduction-16.log
+.. select --table Site --query title:@test --output_columns _id,_score,title --sortby _score
+
+If you want to specify some column names, you should use comma(,) between these names. In this case, when same value of records is existed in first column, this command sorts result of searching to value of second column.
+
+.. groonga-command
+.. include:: ../example/tutorial/introduction-17.log
+.. select --table Site --query title:@test --output_columns _id,_score,title --sortby _score,_id
+
+.. rubric:: footnote
+
+.. [1] In now groonga's version, you can only use 'match_columns' parameter in the case of existing index of fulltext searching. This parameter cannot be use in searching for ordinary columns.

data/vendor/local/share/doc/groonga/{ja/html/_sources/tutorial/tutorial07.txt → source/tutorial/match_columns.txt}

@@ -25,7 +25,7 @@ Blog1テーブルを作り、タイトル文字列のtitleカラム、本文のm
 インデックス用のIndexBlog1テーブルも作り、titleカラムのインデックス用にindex_titleカラム、messageカラムのインデック用にindex_messageカラムと、それぞれ1カラムごとに1つずつ追加しています。
 
 .. groonga-command
-.. include:: ../example/tutorial07-1.log
+.. include:: ../example/tutorial/match_columns-1.log
 .. table_create --name Blog1 --flags TABLE_HASH_KEY --key_type ShortText
 .. column_create --table Blog1 --name title --flags COLUMN_SCALAR --type ShortText
 .. column_create --table Blog1 --name message --flags COLUMN_SCALAR --type ShortText
@@ -44,7 +44,7 @@ match_columnsオプションで、検索対象のカラムを複数指定する
 実際に検索してみましょう。
 
 .. groonga-command
-.. include:: ../example/tutorial07-2.log
+.. include:: ../example/tutorial/match_columns-2.log
 .. select --table Blog1 --match_columns title||message --query groonga
 .. select --table Blog1 --match_columns title||message --query message
 .. select --table Blog1 --match_columns title --query message
@@ -58,7 +58,7 @@ match_columnsオプションで、検索対象のカラムを複数指定する
 
 
 .. groonga-command
-.. include:: ../example/tutorial07-3.log
+.. include:: ../example/tutorial/match_columns-3.log
 .. table_create --name Blog2 --flags TABLE_HASH_KEY --key_type ShortText
 .. column_create --table Blog2 --name title --flags COLUMN_SCALAR --type ShortText
 .. column_create --table Blog2 --name message --flags COLUMN_SCALAR --type ShortText
@@ -74,7 +74,7 @@ match_columnsオプションで、検索対象のカラムを複数指定する
 実際に検索してみましょう。結果は上の例と同じになります。
 
 .. groonga-command
-.. include:: ../example/tutorial07-4.log
+.. include:: ../example/tutorial/match_columns-4.log
 .. select --table Blog2 --match_columns title||message --query groonga
 .. select --table Blog2 --match_columns title||message --query message
 .. select --table Blog2 --match_columns title --query message

data/vendor/local/share/doc/groonga/{ja/html/_sources/tutorial/tutorial10.txt → source/tutorial/micro_blog.txt}

@@ -376,11 +376,11 @@ Commentsテーブルのlast_modifiedカラムは、Time型です。この型で
 
 キーワードでユーザー検索
 ^^^^^^^^^^^^^^^^^^^^^^^^
-ここでは、 :doc:`tutorial07` で扱った、複数カラムを対象とした検索を行います。
+ここでは、 :doc:`match_columns` で扱った、複数カラムを対象とした検索を行います。
 指定された文字列で、ユーザー名・現在地・自己紹介文を対象に検索をします。
 
 .. groonga-command
-.. include:: ../example/tutorial10-1.log
+.. include:: ../example/tutorial/micro_blog-1.log
 .. select --table Users --match_columns name,location_str,description --query 東京 --output_columns _key,name
 
 「東京」をキーワードにユーザー検索した結果、東京都に住んでいる「グニャラくん」と「OffGao」がヒットしました。
@@ -388,11 +388,11 @@ Commentsテーブルのlast_modifiedカラムは、Time型です。この型で
 GeoPointでユーザー検索
 ^^^^^^^^^^^^^^^^^^^^^^
 
-ここでは、 :doc:`tutorial04` で扱った、GeoPoint型のカラムで検索をします。
+ここでは、 :doc:`search` で扱った、GeoPoint型のカラムで検索をします。
 以下の例では、指定された位置から5000m以内にいるユーザーを検索しています。
 
 .. groonga-command
-.. include:: ../example/tutorial10-2.log
+.. include:: ../example/tutorial/micro_blog-2.log
 .. select --table Users --filter 'geo_in_circle(location,"128484216x502919856",5000)' --output_columns _key,name
 
 新宿駅から5km以内にすんでいるユーザーを検索したところ、「グニャラくん」と「OffGao」がヒットしました。
@@ -400,11 +400,11 @@ GeoPointでユーザー検索
 あるユーザーをフォローしているユーザーの検索
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-ここでは、 :doc:`tutorial06` で扱った、参照関係の逆引きをします。
+ここでは、 :doc:`index` で扱った、参照関係の逆引きをします。
 以下の例では、Usersテーブルのfollowerカラムにあるフォローリストを逆引きします。
 
 .. groonga-command
-.. include:: ../example/tutorial10-3.log
+.. include:: ../example/tutorial/micro_blog-3.log
 .. select --table Users --query follower:@tasukuchan --output_columns _key,name
 
 「グニャラくん」をフォローしている「hsiomaneki」と「OffGao」がヒットしました。
@@ -412,10 +412,10 @@ GeoPointでユーザー検索
 GeoPointでコメント検索
 ^^^^^^^^^^^^^^^^^^^^^^
 ある範囲内で書かれたコメントを検索します。
-また、 :doc:`tutorial05` で扱ったドリルダウンも行います。検索結果をハッシュタグとユーザーでドリルダウンし、ユーザー別・ハッシュタグ別のカウントを出します。
+また、 :doc:`drilldown` で扱ったドリルダウンも行います。検索結果をハッシュタグとユーザーでドリルダウンし、ユーザー別・ハッシュタグ別のカウントを出します。
 
 .. groonga-command
-.. include:: ../example/tutorial10-4.log
+.. include:: ../example/tutorial/micro_blog-4.log
 .. select --table Comments --filter 'geo_in_circle(location,"127975798x502919856",20000)' --output_columns posted_by.name,comment --drilldown hash_tags,posted_by
 
 範囲を広く指定したため、位置情報のあるすべてのコメントがヒットしました。そして、ヒットしたコメントからドリルダウンされた結果も返ってきており、ハッシュタグは「#groonga」が2つに「#travel」が1つ、投稿者は「グニャラくん」「OffGao」がそれぞれ2件ずつであることがわかります。
@@ -423,10 +423,10 @@ GeoPointでコメント検索
 キーワードでコメント検索
 ^^^^^^^^^^^^^^^^^^^^^^^^
 あるキーワードを含むコメントを検索します。
-さらに、 :doc:`tutorial04` で扱った、スコア値_scoreも出してみましょう。
+さらに、 :doc:`search` で扱った、スコア値_scoreも出してみましょう。
 
 .. groonga-command
-.. include:: ../example/tutorial10-5.log
+.. include:: ../example/tutorial/micro_blog-5.log
 .. select --table Comments --query comment:@なう --output_columns comment,_score
 
 「なう」をキーワードにコメント検索した結果、2件のコメントがヒットしました。また、_scoreの値も返ってきており、「なう」の数が出力されていることが確認できます。
@@ -436,7 +436,7 @@ GeoPointとキーワードでコメント検索
 今度は、キーワードとGeoPointの両方を条件に検索をしてみます。--queryと--filterの両方を使用した場合、両方の条件に一致するレコードがヒットします。
 
 .. groonga-command
-.. include:: ../example/tutorial10-6.log
+.. include:: ../example/tutorial/micro_blog-6.log
 .. select --table Comments --query comment:@羽田 --filter 'geo_in_circle(location,"127975798x502919856",20000)' --output_columns posted_by.name,comment --drilldown hash_tags,posted_by
 
 両方の条件を満たすコメントが1件ヒットしました。また、ドリルダウンの結果も返ってきており、「グニャラくん」のコメント1件であることがわかります。
@@ -444,10 +444,10 @@ GeoPointとキーワードでコメント検索
 ハッシュタグでコメント検索
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 あるハッシュタグのついているコメントを検索します。
-これも、 :doc:`tutorial06` で扱った、参照関係の逆引きを使います。
+これも、 :doc:`index` で扱った、参照関係の逆引きを使います。
 
 .. groonga-command
-.. include:: ../example/tutorial10-7.log
+.. include:: ../example/tutorial/micro_blog-7.log
 .. select --table Comments --query hash_tags:@groonga --output_columns posted_by.name,comment --drilldown posted_by
 
 #groongaタグの付いている2件のコメントがヒットしました。また、投稿者のドリルダウンも返ってきており、2件とも「グニャラくん」のものであることがわかります。
@@ -457,7 +457,7 @@ GeoPointとキーワードでコメント検索
 あるユーザーが投稿したコメントを検索します。
 
 .. groonga-command
-.. include:: ../example/tutorial10-8.log
+.. include:: ../example/tutorial/micro_blog-8.log
 .. select --table Comments --query posted_by:tasukuchan --output_columns comment --drilldown hash_tags
 
 「グニャラくん」が書き込んだ4件のコメントがヒットしました。また、ハッシュタグでドリルダウンした結果も返ってきており、ハッシュタグは「#groonga」が2つに「#travel」が1つあることがわかります。
@@ -467,18 +467,18 @@ GeoPointとキーワードでコメント検索
 あるユーザーがお気に入りに入れているコメントを検索します。
 
 .. groonga-command
-.. include:: ../example/tutorial10-9.log
+.. include:: ../example/tutorial/micro_blog-9.log
 .. select --table Users --query _key:tasukuchan --output_columns favorites.posted_by,favorites.comment
 
 「グニャラくん」がお気に入りに入れている2件のコメントがヒットしました。
 
 投稿時間でコメント検索
 ^^^^^^^^^^^^^^^^^^^^^^
-コメントの投稿時間で検索をします。Time型については :doc:`tutorial03` で扱っています。
+コメントの投稿時間で検索をします。Time型については :doc:`data` で扱っています。
 この例では、指定した時間よりも前に投稿されているコメントを検索します。
 
 .. groonga-command
-.. include:: ../example/tutorial10-10.log
+.. include:: ../example/tutorial/micro_blog-10.log
 .. select Comments --filter 'last_modified<=1268802000' --output_columns posted_by.name,comment,last_modified --drilldown hash_tags,posted_by
 
 2010/03/17 14:00:00以前に書かれたコメント5件がヒットしました。また、ドリルダウンの結果も返ってきており、「hsiomaneki」が2件、「グニャラくん」が3件ヒットしていることがわかります。

data/vendor/local/share/doc/groonga/source/tutorial/network.txt

@@ -0,0 +1,103 @@
+.. -*- rst -*-
+
+.. highlightlang:: none
+
+.. groonga-include : introduction.txt
+
+How to use groonga with network
+===============================
+
+You can use groonga with network. When you run groonga by using the groonga original protocol or HTTP, groonga accepts connection for network.
+
+Connect with groonga's original protocol
+----------------------------------------
+
+Run groonga daemon
+^^^^^^^^^^^^^^^^^^
+
+Form::
+
+  groonga [-p PORT_NUMBER] -d DB_PATH_NAME
+
+The DB_PATH_NAME is set the full-path of existing database.
+With this form, you can run groonga as a daemon and connect by
+with groonga original protocol on PORT_NUMBER.
+(The port number is 10041 when you don't specify PORT_NUMBER.)
+
+Execution example::
+
+  % groonga -d /tmp/groonga-databases/introduction.db
+  12345
+  %
+
+Groonga shows its process ID on daemon mode.
+
+Connect to groonga server
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Form::
+
+  groonga [-p PORT_NUMBER] -c [HOST_NAME_OR_IP_ADDRESS]
+
+This command connects to groonga server running at specified HOST_NAME_OR_IP_ADDRESS.
+
+When you don't specify HOST_NAME_OR_IP_ADDRESS, this command connects to groonga server running at localhost. When you don't specify PORT_NUMBER, 10041 is used.
+
+Groonga runs in interactive mode after connect to groonga server successfully. Groonga reads command from standard input and evaluates it repeatedly.
+
+.. groonga-command
+.. include:: ../example/tutorial/network-1.log
+.. .. % groonga -c
+.. status
+.. .. > ctrl-d
+.. .. %
+
+Terminate groonga daemon
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+You can terminate groonga daemon with shutdown command.
+
+.. groonga-command
+.. include:: ../example/tutorial/network-2.log
+.. .. % groonga -c
+.. .. > shutdown
+.. .. %
+
+Connect with HTTP
+-----------------
+
+You need to run groonga in HTTP protocol mode when you want to use groonga via HTTP.
+
+Form::
+
+  groonga [-p PORT_NUMBER] -d --protocol http DB_PATH_NAME
+
+`--protocol` option specifies a protocol of groonga server. `http` means that groonga accepts connections via HTTP.
+
+Administration tool based on HTML
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+You can access administration tool based on HTML at `http://[HOST_NAME_OR_IP_ADDRESS]:[PORT_NUMBER]/` after the above command is ran. Your browser must enable JavaScript.
+
+Run command with HTTP
+^^^^^^^^^^^^^^^^^^^^^
+
+You can run command at `/d/COMMAND_NAME` when groonga is ran in HTTP protocol mode.
+
+Command options are passed as HTTP's GET parameters. They are in `?OPTION=VALUE&OPTION=VALUE&...` form.
+
+.. groonga-command
+.. include:: ../example/tutorial/network-3.log
+.. .. http://[HOST_NAME_OR_IP_ADDRESS]:[PORT_NUMBER]/d/status
+.. .. Executed command:
+.. status
+.. .. 
+.. .. http://[HOST_NAME_OR_IP_ADDRESS]:[PORT_NUMBER]/d/select?table=Site&query=title:@this
+.. .. Executed command:
+.. select --table Site --query title:@this
+
+
+Security
+--------
+
+Network service of groonga doesn't support authentication. Everyone can view and modify the database. We recommend that you restrict client accesses by IP address. You can use iptables or any similar tool for it.

data/vendor/local/share/doc/groonga/{ja/html/_sources/tutorial/tutorial08.txt → source/tutorial/patricia_trie.txt}

@@ -6,8 +6,8 @@
 .. table_remove PatPrefix
 .. table_remove PatSuffix
 
-主キーによる前方一致検索
-========================
+パトリシア木による前方一致検索
+==============================
 
 groongaのテーブルは、テーブル作成時にパトリシア木オプションを指定すると、前方一致検索を行うことができます。また、追加のオプションを指定することにより、主キーの後方一致検索をも行うことができます。
 
@@ -17,7 +17,7 @@ groongaのテーブルは、テーブル作成時にパトリシア木オプシ
 table_createコマンドのflagsオプションにTABLE_PAT_KEYを指定することで、主キーによる前方一致検索ができるようになります。
 
 .. groonga-command
-.. include:: ../example/tutorial08-1.log
+.. include:: ../example/tutorial/patricia_trie-1.log
 ..
 .. table_create --name PatPrefix --flags TABLE_PAT_KEY --key_type ShortText
 .. load --table PatPrefix
@@ -38,7 +38,7 @@ KEY_WITH_SISフラグを付与すると、データを追加する際に後方
 例えば、元のレコードと自動的に追加されたレコードとの区別をつけるために、元のレコードであることを示すoriginalカラムを追加して、検索時にはoriginalカラムが ``true`` も検索条件に加えます。
 
 .. groonga-command
-.. include:: ../example/tutorial08-2.log
+.. include:: ../example/tutorial/patricia_trie-2.log
 ..
 .. table_create --name PatSuffix --flags TABLE_PAT_KEY|KEY_WITH_SIS --key_type ShortText
 .. column_create --table PatSuffix --name original --type Bool