rroonga 5.0.1-x86-mingw32 → 5.0.2-x86-mingw32

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

@@ -5,10 +5,10 @@
 News in Senna period
 ====================
 
-Senna -> groonga - 2009/01/14
+Senna -> groonga - 2009-01-14
 -----------------------------
 
-2006/04/05
+2006-04-05
 ----------
 
 Improvements
@@ -17,7 +17,7 @@ Improvements
 * SEN_INDEX_DELIMITED added
 * sen_sel_term_extract added
 
-2006/03/03
+2006-03-03
 ----------
 
 Improvements
@@ -25,7 +25,7 @@ Improvements
 
 * snippet function added
 
-2006/01/16
+2006-01-16
 ----------
 
 Fixes
@@ -33,7 +33,7 @@ Fixes
 
 * io.c bug fix. index format changed
 
-2006/01/12
+2006-01-12
 ----------
 
 Improvements
@@ -41,7 +41,7 @@ Improvements
 
 * windows porting released
 
-2005/12/22
+2005-12-22
 ----------
 
 Improvements
@@ -50,7 +50,7 @@ Improvements
 * support unpatched version of mecab (0.81, 0.82pre, 0.90)
   no longer depends on mecab mte patch.
 
-2005/10/27
+2005-10-27
 ----------
 
 Improvements
@@ -58,7 +58,7 @@ Improvements
 
 * mysql binding updated
 
-2005/09/17
+2005-09-17
 ----------
 
 Improvements
@@ -66,7 +66,7 @@ Improvements
 
 * mysql-5.0.12-beta binding from <tasuku at hottolink.co.jp>
 
-2005/09/08
+2005-09-08
 ----------
 
 Improvements
@@ -74,7 +74,7 @@ Improvements
 
 * utf-8 support enhanced. (SEN_INDEX_NORMALIZE become available)
 
-2005/08/16
+2005-08-16
 ----------
 
 Improvements
@@ -83,7 +83,7 @@ Improvements
 * Ruby binding has rewrited using SWIG and supports advanced API.
 * SJIS support enhanced.
 
-2005/07/05
+2005-07-05
 ----------
 
 Changes
@@ -91,7 +91,7 @@ Changes
 
 * the license has changed to LGPL from GPL.
 
-2005/06/23
+2005-06-23
 ----------
 
 Improvements
@@ -99,7 +99,7 @@ Improvements
 
 * advanced API functions implemented
 
-2005/04/12
+2005-04-12
 ----------
 
 Improvements

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

@@ -2,6 +2,9 @@
 
 .. highlightlang:: none
 
+.. groonga-command
+.. database: commands_dump
+
 ``dump``
 ========
 
@@ -26,59 +29,164 @@ Syntax
 ------
 ::
 
-  dump [tables]
+   dump [tables]
+        [dump_plugins]
+        [dump_schema]
+        [dump_records]
+        [dump_indexes]
 
 Usage
 -----
 
-データベース内のすべてのデータを出力::
+Here is the sample schema and data to check dump behaviour::
+
+  plugin_register token_filters/stop_word
+  table_create Bookmarks TABLE_HASH_KEY ShortText
+  column_create Bookmarks title COLUMN_SCALAR ShortText
+  table_create Lexicon TABLE_PAT_KEY ShortText
+  table_create Sites TABLE_NO_KEY
+  column_create Sites url COLUMN_SCALAR ShortText
+  column_create Lexicon bookmark_title COLUMN_INDEX Bookmarks title
+  load --table Bookmarks
+  [
+  {"_key":"Groonga", "title":"Introduction to Groonga"},
+  {"_key":"Mroonga", "title":"Introduction to Mroonga"}
+  ]
+  load --table Sites
+  [
+  {"_key": 1, "url":"http://groonga.org"},
+  {"_key": 2, "url":"http://mroonga.org"}
+  ]
+
+Dump all data in database::
 
   > dump
-  table_create LocalNames 48 ShortText
-  table_create Entries 48 ShortText
-  column_create Entries local_name 0 LocalNames
-  column_create LocalNames Entries_local_name 2 Entries local_name
-  ...
-  load --table LocalNames
+  plugin_register token_filters/stop_word
+  
+  table_create Sites TABLE_NO_KEY
+  column_create Sites url COLUMN_SCALAR ShortText
+  
+  table_create Bookmarks TABLE_HASH_KEY ShortText
+  column_create Bookmarks title COLUMN_SCALAR ShortText
+  
+  table_create Lexicon TABLE_PAT_KEY ShortText
+  
+  load --table Sites
   [
-  ["_key"],
-  ["Items"],
-  ["BLT"],
-  ...
+  ["_id","url"],
+  [1,"http://groonga.org"],
+  [2,"http://mroonga.org"]
   ]
-  ...
+  
+  load --table Bookmarks
+  [
+  ["_key","title"],
+  ["Groonga","Introduction to Groonga"],
+  ["Mroonga","Introduction to Mroonga"]
+  ]
+  
+  create Lexicon bookmark_title COLUMN_INDEX Bookmarks title
 
-データベース内のスキーマと特定のテーブルのデータのみ出力::
+Dump schema and specific table data::
 
-  > dump --tables Users,Sites
-  table_create Users TABLE_HASH_KEY ShortText
-  column_create Users name COLUMN_SCALAR ShortText
-  table_create Comments TABLE_PAT_KEY ShortText
-  column_create Comments text COLUMN_SCALAR ShortText
+  > dump Bookmarks
+  plugin_register token_filters/stop_word
+  
   table_create Sites TABLE_NO_KEY
   column_create Sites url COLUMN_SCALAR ShortText
-  load --table Users
+  
+  table_create Bookmarks TABLE_HASH_KEY ShortText
+  column_create Bookmarks title COLUMN_SCALAR ShortText
+  
+  table_create Lexicon TABLE_PAT_KEY ShortText
+  
+  load --table Bookmarks
   [
-  ["_key"],
-  ["mori"],
-  ["yu"],
-  ...
+  ["_key","title"],
+  ["Groonga","Introduction to Groonga"],
+  ["Mroonga","Introduction to Mroonga"]
   ]
+  
+  column_create Lexicon bookmark_title COLUMN_INDEX Bookmarks title
+
+Dump plugin only::
+
+  > dump --dump_schema no --dump_records no --dump_indexes no
+  plugin_register token_filters/stop_word
+
+Dump records only::
+
+  > dump --dump_schema no --dump_plugins no --dump_indexes no
   load --table Sites
   [
   ["_id","url"],
-  [1,"http://groonga.org/"],
-  [2,"http://qwik.jp/senna/"],
-  ...
+  [1,"http://groonga.org"],
+  [2,"http://mroonga.org"]
+  ]
+  
+  load --table Bookmarks
+  [
+  ["_key","title"],
+  ["Groonga","Introduction to Groonga"],
+  ["Mroonga","Introduction to Mroonga"]
   ]
+  
+Dump schema only::
 
+  > dump --dump_records no --dump_plugins no --dump_indexes no
+  table_create Sites TABLE_NO_KEY
+  column_create Sites url COLUMN_SCALAR ShortText
+  
+  table_create Bookmarks TABLE_HASH_KEY ShortText
+  column_create Bookmarks title COLUMN_SCALAR ShortText
+  
+  table_create Lexicon TABLE_PAT_KEY ShortText
+  
 Parameters
 ----------
 
+There are optional parameters.
+
+Optional parameters
+^^^^^^^^^^^^^^^^^^^
+
 ``tables``
+""""""""""
 
   出力対象のテーブルを「,」（カンマ）区切りで指定します。存在しないテーブルを指定した場合は無視されます。
 
+``dump_plugins``
+""""""""""""""""
+
+You can customize the output whether it contains registered plugins or not.
+To exclude registered plugins from the output, specify ``no``.
+
+The default value is ``yes``.
+
+``dump_schema``
+"""""""""""""""
+
+You can customize the output whether it contains database schema or not.
+To exclude database schema from the output, specify ``no``.
+
+The default value is ``yes``.
+
+``dump_records``
+""""""""""""""""
+
+You can customize the output whether it contains records or not.
+To exclude records from the output, specify ``no``.
+
+The default value is ``yes``.
+
+``dump_indexes``
+""""""""""""""""
+
+You can customize the output whether it contains indexes or not.
+To exclude indexes from the output, specify ``no``.
+
+The default value is ``yes``.
+
 Return value
 ------------
 

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

@@ -66,7 +66,7 @@ request may be ignored.
 
 You can send cancel request for the same request ID multiple times. If
 the target request is canceled or finished, ``"canceled"`` value is
-changed to ``false`` from ``true``::
+changed to ``false`` from ``true`` in return value::
 
   $ curl 'http://localhost:10041/d/request_cancel?id=unique-id-1'
   [[...], {"id": "unique-id-1", "canceled": true}]

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

@@ -2,23 +2,164 @@
 
 .. highlightlang:: none
 
-groonga command
-===============
+``groonga`` executable file
+===========================
 
 Summary
 -------
 
-groonga - 列指向データベース機能を持つ全文検索エンジンソフトウェア
+``groonga`` executable file provides the following features:
+
+  * Fulltext search server
+  * Fulltext search shell
+  * Client for Groonga fulltext search server
+
+Groonga can be used as a library. If you want to use Groonga as a
+library, you need to write a program in C, C++ and so on. Library use
+is useful for embedding fulltext search feature to your application,
+but it's not easy to use.
+
+You can use ``groonga`` executable file to get fulltext search
+feature.
+
+If you want to try Groonga, fulltext search shell usage is useful. You
+don't need any server and client. You just need one terminal. You can
+try Groonga like the following::
+
+  % groonga -n db
+  > status
+  [[0,1429687763.70845,0.000115633010864258],{"alloc_count":195,...}]
+  > quit
+  %
+
+If you want to create an application that has fulltext search feature,
+fulltext search server usage is useful. You can use Groonga as a
+server like RDBMS (Relational DataBase Management
+System). Client-server model is a popular architecture.
+
+Normally, client for Groonga fulltext server usage isn't used.
 
-Groongaは列指向のデータベース機能を持つ高速でスケーラブルな全文検索エンジンです。
-Groongaのデータベースは、groongaコマンドかCライブラリインタフェースを通して操作することができます。このマニュアルページでは、groongaコマンドの使い方について説明します。
 
 Syntax
 ------
 
-::
+``groonga`` executable file has the following four modes:
+
+  * Standalone mode
+  * Server mode
+  * Daemon mode
+  * Client mode
+
+There are common options in these modes. These common options is
+described later section.
+
+.. _groonga-executable-file-standalone-mode:
+
+Standalone mode
+^^^^^^^^^^^^^^^
+
+In standalone mode, ``groonga`` executable file runs one or more
+Groonga :doc:`/reference/command` against a local Groonga database.
+
+Here is the syntax to run shell that executes Groonga command against
+temporary database::
+
+  groonga [options]
+
+Here is the syntax to create a new database and run shell that
+executes Groonga command against the new database::
+
+  groonga [options] -n DB_PATH
+
+Here is the syntax to run shell that executes Groonga command against
+existing database::
+
+  groonga [options] DB_PATH
+
+Here is the syntax to run Groonga command against existing database
+and exit::
+
+  groonga [options] DB_PATH COMMAND [command arguments]
+
+.. _groonga-executable-file-server-mode:
+
+Server mode
+^^^^^^^^^^^
+
+In server mode, ``groonga`` executable file runs as a server. The
+server accepts connections from other processes at local machine or
+remote machine and executes received Groonga :doc:`/reference/command`
+against a local Groonga database.
+
+You can choose one protocol from :doc:`/server/http` and
+:doc:`/server/gqtp`. Normally, HTTP is suitable but GQTP is the
+default protocol. This section describes only about HTTP protocol
+usage.
+
+In server mode, ``groonga`` executable file runs in the foreground. If
+you want to run Groonga server in the background, see
+:ref:`groonga-executable-file-server-mode`.
+
+Here is the syntax to run Groonga server with temporary database::
+
+  groonga [options] --protocol http -s
+
+Here is the syntax to create a new database and run Groonga server
+with the new database::
+
+  groonga [options] --protocol http -s -n DB_PATH
+
+Here is the syntax to run Groonga server with existing database::
+
+  groonga [options] --protocol http -s DB_PATH
+
+.. _groonga-executable-file-daemon-mode:
+
+Daemon mode
+^^^^^^^^^^^
+
+In daemon mode, ``groonga`` executable file runs as a daemon. Daemon
+is similar to server but it runs in the background. See
+:ref:`_groonga-executable-file-daemon-mode` about server.
+
+Here is the syntax to run Groonga daemon with temporary database::
+
+  groonga [options] --protocol http -d
+
+Here is the syntax to create a new database and run Groonga daemon
+with the new database::
+
+  groonga [options] --protocol http -d -n DB_PATH
+
+Here is the syntax to run Groonga daemon with existing database::
+
+  groonga [options] --protocol http -d DB_PATH
+
+:option:`--pid-file` option will be useful for daemon mode.
+
+.. _groonga-executable-file-client-mode:
+
+Client mode
+^^^^^^^^^^^
+
+In client mode, ``groonga`` executable file runs as a client for GQTP
+protocol Groonga server. Its usage is similar to
+:ref:`groonga-executable-file-standalone-mode`. You can run shell and
+execute one command. You need to specify server address instead of
+local database.
+
+Note that you can use ``groonga`` executable file as a client for HTTP
+protocol Groonga server.
+
+Here is the syntax to run shell that executes Groonga command against
+Groonga server that is running at ``192.168.0.1:10043``::
+
+  groonga [options] -c --host 192.168.0.1 --port 10043
+
+Here is the syntax to run Groonga command against Groonga server that
+is running at ``192.168.0.1:10043`` and exit::
 
- groonga [options] [dest] [command [args]]
+  groonga [options] -c --host 192.168.0.1 --port 10043 COMMAND [command arguments]
 
 Options
 -------