rroonga 3.1.0-x86-mingw32 → 3.1.1-x86-mingw32

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

@@ -21,7 +21,7 @@ status - groongaプロセスの状態表示
 説明
 ----
 
-groonga組込コマンドの一つであるstatusについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるstatusについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 
 statusコマンドは、groongaプロセスの状態を表示します。主にgroongaサーバプロセスに対して使用することを想定しています。
 
@@ -42,7 +42,7 @@ json形式
 
 ``alloc_count``
 
-  groongaプロセスの内部でアロケートされ、まだ解放されてないメモリブロックの数を示します。groongaをbuildする際に、configureオプションで --enable-exact-alloc-countが指定されていたならば、正確な値を返します。それ以外の場合は不正確な値を返す場合があります。
+  groongaプロセスの内部でアロケートされ、まだ解放されてないメモリブロックの数を示します。Groongaをbuildする際に、configureオプションで --enable-exact-alloc-countが指定されていたならば、正確な値を返します。それ以外の場合は不正確な値を返す場合があります。
 
 ``starttime``
 

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

@@ -52,7 +52,7 @@ and is ``TABLE_NO_KEY`` type.
 
 If your records aren't searched by key, ``TABLE_NO_KEY`` type table is
 suitable. Because ``TABLE_NO_KEY`` doesn't support key but it is fast
-and small table. Storing logs into groonga database is the case.
+and small table. Storing logs into Groonga database is the case.
 
 If your records are searched by key or referenced by one or more
 columns, ``TABLE_NO_KEY`` type isn't suitable. Lexicon for fulltext
@@ -172,7 +172,7 @@ Here are available characters:
   character.)
 
 You need to create a name with one or more the above chracters. Note
-that you cannot use ``_`` as the first charcter such as
+that you cannot use ``_`` as the first character such as
 ``_name``.
 
 ``flags``
@@ -198,7 +198,7 @@ Here are available flags:
 +--------------------+------------------------------+
 
 .. note::
-   Since groonga 2.1.0 ``KEY_NORMALIZE`` flag is deprecated. Use
+   Since Groonga 2.1.0 ``KEY_NORMALIZE`` flag is deprecated. Use
    ``normalizer`` option with ``NormalizerAuto`` instead.
 
 You must specify one of ``TABLE_${TYPE}`` flags. You cannot specify two
@@ -253,6 +253,8 @@ See :doc:`/reference/tokenizers` for all tokenizers
 
 The default value is none.
 
+.. _table-create-normalizer:
+
 ``normalizer``
 ^^^^^^^^^^^^^^
 

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

@@ -19,7 +19,7 @@ table_list - DBに定義されているテーブルをリスト表示
 説明
 ----
 
-groonga組込コマンドの一つであるtable_listについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるtable_listについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 
 table_listは、DBに定義されているテーブルのリストを表示します。
 

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

@@ -129,7 +129,7 @@ groonga-benchmark命令
 
   test_local コマンドファイル 入力ファイル名
     コマンドファイルをgroonga-benchmark単体で実行し、各コマンドの実行結果を入力ファイルと比較します。処理時間など本質的要素以外に差分があった場合、差分を、入力ファイル.diffというファイルに書きだします。
- 
+
 
 コマンドファイル
 ^^^^^^^^^^^^^^^^
@@ -192,10 +192,10 @@ groonga-benchmark命令
 
 
 groonga-benchmark実行結果
----------------
+-------------------------
 
 groonga-benchmarkが正常に終了すると、(拡張子を除いた)スクリプト名-ユーザ名-実行開始時刻.logという形式のログファイルがカレントディレクトリに作られます。ログファイルは自動的にftp.groonga.org
-に送信されます。ログファイルは以下のようなjson形式のテキストです。 
+に送信されます。ログファイルは以下のようなjson形式のテキストです。
 
 ::
 
@@ -248,7 +248,7 @@ groonga-benchmarkが正常に終了すると、(拡張子を除いた)スクリ
   ency": 831495, "self": 762519, "qps": 1967.164097, "min": 73, "max": 135631, "queries": 15
   00}]},
   {"total": 915408, "qps": 1718.359464, "queries": 1573}]
-  
+
 
 
 制限事項

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

@@ -0,0 +1,118 @@
+.. -*- rst -*-
+
+.. highlightlang:: none
+
+.. groonga-command
+.. database: between
+
+between
+=======
+
+Summary
+-------
+
+``between`` is used for checking the specified value exists in the specific range.
+It is often used for combination with :ref:`select-filter` option in :doc:`/reference/commands/select`.
+
+Syntax
+------
+
+``between`` has five parameters::
+
+  between(column_or_value, min, min_border, max, max_border)
+
+
+Usage
+-----
+
+Here are a schema definition and sample data to show usage.::
+
+  table_create Users TABLE_HASH_KEY ShortText
+  column_create Users age COLUMN_SCALAR Int32
+  table_create Ages TABLE_HASH_KEY Int32
+  column_create Ages user_age COLUMN_INDEX Users age
+  load --table Users
+  [
+  {"_key": "Alice",  "age": 12},
+  {"_key": "Bob",    "age": 13},
+  {"_key": "Calros", "age": 15},
+  {"_key": "Dave",   "age": 16},
+  {"_key": "Eric",   "age": 20}
+  {"_key": "Frank",  "age": 21}
+  ]
+ 
+.. groonga-command
+.. table_create Users TABLE_HASH_KEY ShortText
+.. column_create Users age COLUMN_SCALAR Int32
+.. table_create Ages TABLE_HASH_KEY Int32
+.. column_create Ages user_age COLUMN_INDEX Users age
+.. load --table Users
+.. [
+.. {"_key": "Alice",  "age": 12},
+.. {"_key": "Bob",    "age": 13},
+.. {"_key": "Calros", "age": 15},
+.. {"_key": "Dave",   "age": 16},
+.. {"_key": "Eric",   "age": 20}
+.. {"_key": "Frank",  "age": 21}
+.. ]
+
+Here is the query to show the persons to match PG-13 rating (MPAA).
+
+.. groonga-command
+.. include:: ../../example/reference/functions/between/usage_age.log
+.. select Users --filter 'between(age, 13, "include", 16, "include")'
+
+It returns 13, 14, 15 and 16 years old users.
+
+``between`` function accepts not only a column of table, but also the value.
+
+If you specify the value as 1st parameter, it is checked whether the value is included or not. if it matches to the specified range, it returns the all records because ``between`` function returns true.
+
+If it doesn't match to the specified range, it returns no records because ``between`` function returns false.
+
+.. groonga-command
+.. include:: ../../example/reference/functions/between/usage_value.log
+.. select Users --filter 'between(14, 13, "include", 16, "include")'
+
+In the above case, it returns all the records, because 14 exists in between 13 and 16.
+This behavior is used for checking the specified value exists or not in the table.
+
+Parameters
+----------
+
+There are five required parameters, ``column_or_value``, and ``min``, ``min_border``, ``max`` and ``max_border``.
+
+``column_or_value``
+^^^^^^^^^^^^^^^^^^^
+
+It specifies a column of the table or the value.
+
+``min``
+^^^^^^^^^^^^^^^^^^^
+
+It specifies the minimal border value of the range.
+You can control the behavior that the value of ``max`` is included or excluded by ``max_border`` parameter.
+
+``min_border``
+^^^^^^^^^^^^^^^^^^^
+
+It specifies whether the specified range contains the value of ``min`` or not.
+The value of ``min_border`` are either "include" or "exclude". If it is "include", ``min`` value is included. If it is "exclude", ``min`` value is not included.
+
+``max``
+^^^^^^^^^^^^^^^^^^^
+
+It specifies the maximum border value of the range.
+You can control the behavior that the value of ``max`` is included or excluded by ``max_border`` parameter.
+
+``max_border``
+^^^^^^^^^^^^^^^^^^^
+
+It specifies whether the specified range contains the value of ``max`` or not.
+The value of ``max_border`` are either "include" or "exclude". If it is "include", ``max`` value is included. If it is "exclude", ``max`` value is not included.
+
+Return value
+------------
+
+``between`` returns whether the value of column exists in specified the value of range or not. If record is matched to specified the value of range, it returns true. Otherwise, it returns false.
+

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

@@ -964,7 +964,7 @@ registered as keys of the table of ``_key``.
 
 Note that the table must be patricia trie (``TABLE_PAT_KEY``) or
 double array trie (``TABLE_DAT_KEY``). You can't use hash table
-(``TABLE_HASH_KEY``) and array (``TABLE_NO_KEY``) becuase they don't
+(``TABLE_HASH_KEY``) and array (``TABLE_NO_KEY``) because they don't
 support longest common prefix search. Longest common prefix search is
 used to implement the operator.
 

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

@@ -16,7 +16,7 @@ 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.
+normalization by registering your normalizer plugins to Groonga.
 
 A normalizer module is attached to a table. A table can have zero or
 one normalizer module. You can attach a normalizer module to a table
@@ -35,12 +35,12 @@ normalizer module:
    Groonga 2.0.9 or earlier doesn't have ``--normalizer`` option in
    ``table_create``. ``KEY_NORMALIZE`` flag was used instead.
 
-   You can open an old database by groonga 2.1.0 or later. An old
-   database means that the database is created by groonga 2.0.9 or
-   earlier. But you cannot open the opened old database by groonga
-   2.0.9 or earlier. Once you open the old database by groonga 2.1.0
+   You can open an old database by Groonga 2.1.0 or later. An old
+   database means that the database is created by Groonga 2.0.9 or
+   earlier. But you cannot open the opened old database by Groonga
+   2.0.9 or earlier. Once you open the old database by Groonga 2.1.0
    or later, ``KEY_NORMALIZE`` flag information in the old database is
-   converted to normalizer information. So groogna 2.0.9 or earlier
+   converted to normalizer information. So Groonga 2.0.9 or earlier
    cannot find ``KEY_NORMALIZE`` flag information in the opened old
    database.
 
@@ -77,10 +77,10 @@ Here is a list of built-in normalizers:
 ^^^^^^^^^^^^^^^^^^
 
 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
+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_create`` 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
@@ -125,8 +125,8 @@ Here is a list of additional normalizers provided by ``groonga-normalizer-mysql`
   * ``NormalizerMySQLUnicodeCI``
   * ``NormalizerMySQLUnicodeCIExceptKanaCIKanaWithVoicedSoundMark``
 
-``groonga-normalizer-mysql`` is a groonga plugin.
-It provides MySQL compatible normalizers to groonga.
+``groonga-normalizer-mysql`` is a Groonga plugin.
+It provides MySQL compatible normalizers to Groonga.
 ``NormalizerMySQLGeneralCI`` corresponds to ``utf8mb4_general_ci``.
 
 You need to register ``normalizers/mysql`` plugin in advance.

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

@@ -116,7 +116,7 @@ can always map database files onto memory. It is no problem until
 groonga touch mapped database files that their size is larger than
 memory and swap. Groonga recommends the configuration.
 
-See `Linux kernel documentaion about overcommit
+See `Linux kernel documentation about overcommit
 <https://www.kernel.org/doc/Documentation/vm/overcommit-accounting>`_
 about ``vm.overcommit_memory`` parameter details.
 

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

@@ -8,16 +8,16 @@
 名前
 ----
 
-groonga データ型
+Groonga データ型
 
 説明
 ----
 
-groonga は、格納するデータの型を区別します。
+Groonga は、格納するデータの型を区別します。
 
-groongaのデータベースでは、テーブルの主キーや、カラムの値はいずれも何らかの型に属します。また通常は、一つのテーブルの中の全てのレコードについて、カラムの値は共通となります。
+Groongaのデータベースでは、テーブルの主キーや、カラムの値はいずれも何らかの型に属します。また通常は、一つのテーブルの中の全てのレコードについて、カラムの値は共通となります。
 
-主キーの型とカラムの型には、groongaで予め定義済みの型か、ユーザが定義する型、またはユーザが定義したテーブルを指定することができます。
+主キーの型とカラムの型には、Groongaで予め定義済みの型か、ユーザが定義する型、またはユーザが定義したテーブルを指定することができます。
 
 主キーの型に他のテーブルを指定する場合は、そのテーブルは、主キーの型となるテーブルのサブセットとなります。
 
@@ -120,7 +120,7 @@ Text型とLongText型については、テーブルの主キーに指定する
 ベクターとして格納できない型
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-groongaのカラムは、ある型のベクターを保存することができます。しかし、ShortText, Text, LongTextの３つの型についてはベクターとして保存したり出力したりすることはできますが、検索条件やドリルダウン条件に指定することができません。
+Groongaのカラムは、ある型のベクターを保存することができます。しかし、ShortText, Text, LongTextの３つの型についてはベクターとして保存したり出力したりすることはできますが、検索条件やドリルダウン条件に指定することができません。
 
 テーブル型は、ベクターとして格納することができます。よって、ShortTextのベクターを検索条件やドリルダウン条件に使用したい場合には、主キーがShortText型のテーブルを別途作成し、そのテーブルを型として利用します。
 

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

@@ -15,9 +15,9 @@ Groonga is a full text search engine but also serves as a column-oriented data s
 Overview
 --------
 
-The basic data types of groonga are roughly divided into 5 groups --- boolean type, numeric types, string types, date/time type and longitude/latitude types. The numeric types are further divided according to whether integer or floating point number, signed or unsigned and the number of bits allocated to each integer. The string types are further divided according to the maximum length. The longitude/latitude types are further divided according to the geographic coordinate system. For more details, see :doc:`/reference/types`.
+The basic data types of Groonga are roughly divided into 5 groups --- boolean type, numeric types, string types, date/time type and longitude/latitude types. The numeric types are further divided according to whether integer or floating point number, signed or unsigned and the number of bits allocated to each integer. The string types are further divided according to the maximum length. The longitude/latitude types are further divided according to the geographic coordinate system. For more details, see :doc:`/reference/types`.
 
-In addition, groonga supports reference types and vector types. Reference types are designed for accessing other tables. Vector types are designed for storing a variable number of values in one element.
+In addition, Groonga supports reference types and vector types. Reference types are designed for accessing other tables. Vector types are designed for storing a variable number of values in one element.
 
 First, let's create a table for this tutorial.
 
@@ -82,12 +82,12 @@ The following example creates a ShortText column and updates existing records. T
 Date and time type
 ------------------
 
-The date and time type of groonga is Time. Actually, a Time column stores a date and time as the number of microseconds since the Epoch, 1970-01-01 00:00:00. A Time value can represent a date and time before the Epoch because the actual data type is a signed integer. Note that :doc:`/reference/commands/load` and :doc:`/reference/commands/select` commands use a decimal number to represent a data and time in seconds. The default value is 0.0, which means the Epoch.
+The date and time type of Groonga is Time. Actually, a Time column stores a date and time as the number of microseconds since the Epoch, 1970-01-01 00:00:00. A Time value can represent a date and time before the Epoch because the actual data type is a signed integer. Note that :doc:`/reference/commands/load` and :doc:`/reference/commands/select` commands use a decimal number to represent a data and time in seconds. The default value is 0.0, which means the Epoch.
 
 .. note::
 
    Groonga internally holds the value of Epoch as pair of integer. The first integer represents the value of seconds, on the other hand, the second integer represents the value of micro seconds.
-   So, groonga shows the value of Epoch as floating point. Integral part means the value of seconds, fraction part means the value of micro seconds.
+   So, Groonga shows the value of Epoch as floating point. Integral part means the value of seconds, fraction part means the value of micro seconds.
 
 The following example creates a Time column and updates existing records. The first record has the default value because not updated.
 
@@ -104,7 +104,7 @@ The following example creates a Time column and updates existing records. The fi
 Longitude and latitude types
 ----------------------------
 
-The longitude and latitude types are divided according to the geographic coordinate system. For more details, see :doc:`/reference/types`. To represent a longitude and latitude, groonga uses a string formatted as follows:
+The longitude and latitude types are divided according to the geographic coordinate system. For more details, see :doc:`/reference/types`. To represent a longitude and latitude, Groonga uses a string formatted as follows:
 
 * "longitude x latitude" in milliseconds (e.g.: "128452975x503157902")
 * "longitude x latitude" in degrees (e.g.: "35.6813819x139.7660839")

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

@@ -7,12 +7,25 @@
 .. groonga-command
 .. database: tutorial
 
-ドリルダウン
-============
+Drilldown
+=========
 
-groongaでは、特定のカラム値で検索結果をグループ化することができます。これをドリルダウンと呼びます。
+You learned how to filter search results and sort ones in the previous sections.
+Now that you can search as you likes, but how do you summarize the number of records which has specific value in the column?
 
-Siteテーブルに２つのカラムを追加します。TLDドメイン名を格納するdomainカラムと、国名を格納するcountryカラムです。これらのカラムの型は、それぞれドメイン名を主キーとするSiteDomainテーブルと、国名を主キーとするSiteCountryテーブルとします。
+As you know, there is a naive solution to execute query by every the value of column, then you can get the number of records as a result. It is a simple way, but it is not reasonable to many records.
+
+If you are familiar with SQL, you will doubt with "Is there a similar SQL functionality to ``GROUP BY`` in Groonga?".
+
+Of course, Groonga provides such a functionality. It's called as ``drilldown``.
+
+``drilldown`` enables you to get the number of records which belongs to specific the value of column at once.
+
+To illustrate this feature, imagine the case that classification by domain and grouping by country that domain belongs to.
+
+Here is the concrete examples how to use this feature.
+
+In this example, we add two columns to ``Site`` table. ``domain`` column is used for TLD (top level domain). ``country`` column is used for country name. The type of these columns are ``SiteDomain`` table which uses domain name as a primary key and ``SiteCountry`` table which uses country name as a primary key.
 
 .. groonga-command
 .. include:: ../example/tutorial/drilldown-1.log
@@ -33,34 +46,83 @@ Siteテーブルに２つのカラムを追加します。TLDドメイン名を
 .. {"_key":"http://example.com/vdw","domain":".com","country":"japan"}
 .. ]
 
-domainカラムとcountryカラムでドリルダウンを行う例を以下に示します。
+Here is a example of drilldown with ``domain`` column. Three kind of values are used in ``domain`` column - ".org", ".net" and ".com".
 
 .. groonga-command
-.. include:: ../example/tutorial/drilldown-2.log
+.. include:: ../example/tutorial/drilldown-domain.log
 .. select --table Site --limit 0 --drilldown domain
 
-テーブル型を持つカラムに対してドリルダウンを行った場合、参照先のテーブルに存在するカラム値を取得することもできます。ドリルダウンを行ったテーブルには、_nsubrecsという仮想的なカラムが追加されます。このカラムには、グループ化されたレコード数が入ります。
+
+Here is a summary of above query.
+
+.. list-table:: Drilldown by ``domain`` column
+   :header-rows: 1
+
+   * - Group by
+     - The number of group records
+     - Group records means following records
+   * - .org
+     - 3 
+     - * http://example.org/
+       * http://example.org/aba
+       * http://example.org/gat
+   * - .net
+     - 3
+     - * http://example.net/
+       * http://example.net/afr
+       * http://example.net/atv
+   * - .com
+     - 3
+     - * http://example.com/
+       * http://example.com/rab
+       * http://example.com/vdw
+
+
+The value of drilldown are returned as the value of ``_nsubrecs`` column. In this case, ``Site`` table is grouped by ".org", ".net", ".com" domain. ``_nsubrecs`` shows that each three domain has three records.
+
+If you execute drildown to the column which has table as a type, you can get the value of column which is stored in referenced table.
+``_nsubrecs`` pseudo column is added to the table which is used for drilldown. this pseudo column stores the number of records which is grouped by.
+
+Then, investigate referenced table in detail. As ``Site`` table use ``SiteDomain`` table as column type of ``domain``, you can use ``--drilldown_output_columns`` to know detail of referenced column.
 
 .. groonga-command
-.. include:: ../example/tutorial/drilldown-3.log
+.. include:: ../example/tutorial/drilldown-output-columns.log
 .. select --table Site --limit 0 --drilldown domain --drilldown_output_columns _id,_key,_nsubrecs
 
-複数のカラムに対してドリルダウンを行うことができます。複数のカラムに対してドリルダウンを行う場合には、drilldownパラメータにカラム名をカンマ区切りで与えます。
+Now, you can see detail of each grouped domain, drilldown by ``country`` column which has ".org" as column value.
+
+.. groonga-command
+.. include:: ../example/tutorial/drilldown-country.log
+.. select --table Site --limit 0 --filter "domain._id == 1" --drilldown country
+
+Drilldown with multiple column
+------------------------------
+
+Drilldown feature supports multiple column. Use comma separated multiple column names as ``drildown`` parameter.
+You can get the each result of drilldown at once.
 
 .. groonga-command
-.. include:: ../example/tutorial/drilldown-4.log
+.. include:: ../example/tutorial/drilldown-multiple-column.log
 .. select --table Site --limit 0 --drilldown domain,country
 
-ドリルダウン結果を並びかえることができます。例えば、_nsubrecsパラメータの降順で並び替えることができます。
+
+Sorting drildown results
+------------------------
+
+Use ``--drilldown_sortby`` if you want to sort the result of drilldown. For example, specify ``_nsubrecs`` as ascending order.
 
 .. groonga-command
-.. include:: ../example/tutorial/drilldown-5.log
+.. include:: ../example/tutorial/drilldown-sortby.log
 .. select --table Site --limit 0 --drilldown country --drilldown_sortby _nsubrecs
 
-ドリルダウン結果は、デフォルトでは10件のみ表示されます。drilldown_offsetパラメータと、drilldown_limitパラメータによって、offsetとlimitを指定することができます。
+
+limits drildown results
+------------------------
+
+The number of drilldown results is limited to 10 as a default. Use ``drilldown_limits`` and ``drilldown_offset`` parameter to customize orilldown results.
 
 .. groonga-command
-.. include:: ../example/tutorial/drilldown-6.log
+.. include:: ../example/tutorial/drilldown-limit.log
 .. select --table Site --limit 0 --drilldown country --drilldown_sortby _nsubrecs --drilldown_limit 2 --drilldown_offset 2
 
 文字列型のカラムに対するドリルダウンは、他の型でのドリルダウンに比べて低速です。文字列でのドリルダウンを行いたい場合には、このチュートリアルのように、文字列型を主キーとするテーブルを別途作成し、そのテーブルを型とするカラムを作成します。

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

@@ -10,9 +10,9 @@
 タグ検索・参照関係の逆引き
 ==========================
 
-本チュートリアルで、groongaはカラム値として他のテーブルへの参照の配列を持つことができることを紹介いたしました。実は、テーブルへの参照の配列データを用いることによって、いわゆるタグ検索を行うことが可能となります。
+本チュートリアルで、Groongaはカラム値として他のテーブルへの参照の配列を持つことができることを紹介いたしました。実は、テーブルへの参照の配列データを用いることによって、いわゆるタグ検索を行うことが可能となります。
 
-タグ検索はgroongaの転置インデックスというデータ構造を用いて高速に行われます。
+タグ検索はGroongaの転置インデックスというデータ構造を用いて高速に行われます。
 
 タグ検索
 --------
@@ -58,7 +58,7 @@
 参照関係の逆引き
 ----------------
 
-groongaはテーブル間の参照関係の逆引きを高速に行うためのインデックスを付与することができます。タグ検索は、その1例にすぎません。
+Groongaはテーブル間の参照関係の逆引きを高速に行うためのインデックスを付与することができます。タグ検索は、その1例にすぎません。
 
 例えば、ソーシャルネットワーキングサイトにおける友人関係を逆引き検索することができます。
 

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

@@ -8,12 +8,12 @@
 Basic operations
 ================
 
-A groonga package provides a C library (libgroonga) and a command line tool (groonga). This tutorial explains how to use the command line tool, with which you can create/operate databases, start a server, establish a connection with a server, etc.
+A Groonga package provides a C library (libgroonga) and a command line tool (groonga). This tutorial explains how to use the command line tool, with which you can create/operate databases, start a server, establish a connection with a server, etc.
 
 Create a database
 -----------------
 
-The first step to using groonga is to create a new database. The following shows how to do it.
+The first step to using Groonga is to create a new database. The following shows how to do it.
 
 Form::
 
@@ -21,7 +21,7 @@ Form::
 
 The `-n` option specifies to create a new database and DB_PATH specifies the path of the new database. Actually, a database consists of a series of files and DB_PATH specifies the file which will be the entrance to the new database. DB_PATH also specifies the path prefix for other files. Note that database creation fails if DB_PATH points to an existing file.
 
-This command creates a new database and then enters into interactive mode in which groonga prompts you to enter commands for operating that database. You can terminate this mode with Ctrl-d.
+This command creates a new database and then enters into interactive mode in which Groonga prompts you to enter commands for operating that database. You can terminate this mode with Ctrl-d.
 
 .. groonga-command
 .. include:: ../example/tutorial/introduction-1.log
@@ -40,9 +40,9 @@ Form::
 
 DB_PATH specifies the path of a target database. This command fails if the specified database does not exist.
 
-If COMMAND is specified, groonga executes COMMAND and returns the result. Otherwise, groonga starts in interactive mode that reads commands from the standard input and executes them one by one. This tutorial focuses on the interactive mode.
+If COMMAND is specified, Groonga executes COMMAND and returns the result. Otherwise, Groonga starts in interactive mode that reads commands from the standard input and executes them one by one. This tutorial focuses on the interactive mode.
 
-Let's see the status of a groonga process by using a :doc:`/reference/commands/status` command.
+Let's see the status of a Groonga process by using a :doc:`/reference/commands/status` command.
 
 .. groonga-command
 .. include:: ../example/tutorial/introduction-2.log
@@ -72,7 +72,7 @@ Basic commands
 --------------
 
  :doc:`/reference/commands/status`
-  shows status of a groonga process.
+  shows status of a Groonga process.
  :doc:`/reference/commands/table_list`
   shows a list of tables in a database.
  :doc:`/reference/commands/column_list`
@@ -114,7 +114,7 @@ A :doc:`/reference/commands/select` command can enumerate records in a table.
 
 When only a table name is specified with a `table` parameter, a :doc:`/reference/commands/select` command returns the first (at most) 10 records in the table. [0] in the result shows the number of records in the table. The next array is a list of columns. ["_id","Uint32"] is a column of UInt32, named _id. ["_key","ShortText"] is a column of ShortText, named _key.
 
-The above two columns, _id and _key, are the necessary columns. The _id column stores IDs those are automatically allocated by groonga. The _key column is associated with the primary key. You are not allowed to rename these columns.
+The above two columns, _id and _key, are the necessary columns. The _id column stores IDs those are automatically allocated by Groonga. The _key column is associated with the primary key. You are not allowed to rename these columns.
 
 Create a column
 ---------------
@@ -209,7 +209,7 @@ The `table` parameter specifies the index table and the `name` parameter specifi
 
 .. note::
 
-   You can create a lexicon table and index columns before/during/after loading records. If a target column already has records, groonga creates an inverted index in a static manner. In contrast, if you load records into an already indexed column, groonga updates the inverted index in a dynamic manner.
+   You can create a lexicon table and index columns before/during/after loading records. If a target column already has records, Groonga creates an inverted index in a static manner. In contrast, if you load records into an already indexed column, Groonga updates the inverted index in a dynamic manner.
 
 Full text search
 ----------------

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

@@ -5,7 +5,7 @@
 全文検索の語彙表に対する追加情報
 ================================
 
-groongaでは、全文検索に用いるための語意表がテーブルとして扱えます。よって、語彙ごとに複数の情報を保持することができます。例えば、語彙の出現数や検索ストップワードのフラグ、単語の重要度などを保持することができます。
+Groongaでは、全文検索に用いるための語意表がテーブルとして扱えます。よって、語彙ごとに複数の情報を保持することができます。例えば、語彙の出現数や検索ストップワードのフラグ、単語の重要度などを保持することができます。
 
 この項目については、現在執筆中です。
 

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

@@ -11,9 +11,9 @@ match_columnsパラメータ
 複数のカラムを対象とした全文検索
 --------------------------------
 
-groongaでは、複数のカラムを対象とした全文検索を行うことができます。例えば、ブログのテーブルで、タイトルと内容とがそれぞれ別のカラムに入ったものがあるとしましょう。「タイトルもしくは内容に特定の単語を含む」検索を行いたいとします。
+Groongaでは、複数のカラムを対象とした全文検索を行うことができます。例えば、ブログのテーブルで、タイトルと内容とがそれぞれ別のカラムに入ったものがあるとしましょう。「タイトルもしくは内容に特定の単語を含む」検索を行いたいとします。
 
-この場合、2つのインデックス作成方式があります。1つは、それぞれのカラムに1つずつインデックスを付与する方式です。もう1つは、複数のカラムに対して1つのインデックスを付与する方式です。groongaでは、どちらの形式のインデックスが存在している場合でも、同一の記法で全文検索を行うことができます。
+この場合、2つのインデックス作成方式があります。1つは、それぞれのカラムに1つずつインデックスを付与する方式です。もう1つは、複数のカラムに対して1つのインデックスを付与する方式です。Groongaでは、どちらの形式のインデックスが存在している場合でも、同一の記法で全文検索を行うことができます。
 
 カラムごとにインデックスを付与する場合
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -148,7 +148,7 @@ You can write the query that search the records which contains specified keyword
 
 Query for searching the records described above::
 
-  select Articles --match_columns comment.content --query groonga --output_columns "_id, _score, *" 
+  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.
 
@@ -157,7 +157,7 @@ At first, this query execute fulltext search from content of Comments table, the
 
 .. groonga-command
 .. include:: ../example/tutorial/match_columns-nested-index-select.log
-.. select Articles --match_columns comment.content --query groonga --output_columns "_id, _score, *" 
+.. select Articles --match_columns comment.content --query groonga --output_columns "_id, _score, *"
 
 Now, you can search articles which contains specific keywords as a comment.
 
@@ -207,15 +207,15 @@ Here is the sample data.
 
 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, *" 
+  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, *" 
+.. 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.