rroonga 3.1.0-x64-mingw32 → 3.1.1-x64-mingw32

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

@@ -19,11 +19,11 @@ dump - データベースのスキーマとデータを出力する
 説明
 ----
 
-groonga組込コマンドの一つであるdumpについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるdumpについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 
 dumpはデータベースのスキーマとデータを後から読み込めるフォーマットで出力します。dumpの結果は大きくなるため、主にコマンドラインから使うことを想定しています。データベースのバックアップが主な利用方法です。
 
-dumpが出力するフォーマットは直接groongaが解釈できるフォーマットです。そのため、以下のようにしてデータベースをコピーすることができます。::
+dumpが出力するフォーマットは直接Groongaが解釈できるフォーマットです。そのため、以下のようにしてデータベースをコピーすることができます。::
 
   % groonga original/db dump > dump.grn
   % mkdir backup
@@ -39,7 +39,7 @@ dumpが出力するフォーマットは直接groongaが解釈できるフォー
 返値
 ----
 
-データベースのスキーマとデータをgroongaの組み込みコマンド呼び出し形式で出力します。output_type指定は無視されます。
+データベースのスキーマとデータをGroongaの組み込みコマンド呼び出し形式で出力します。output_type指定は無視されます。
 
 例
 --
@@ -84,8 +84,3 @@ dumpが出力するフォーマットは直接groongaが解釈できるフォー
   [2,"http://qwik.jp/senna/"],
   ...
   ]
-
-
-
-
-

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

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

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

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

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

@@ -19,7 +19,7 @@ Summary
 ``normalize`` command normalizes text by the specified normalizer.
 
 There is no need to create table to use ``normalize`` command.
-It is usefull for you to check the results of normalizer.
+It is useful for you to check the results of normalizer.
 
 Syntax
 --------

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

@@ -19,7 +19,7 @@ quit - セッション終了
 説明
 ----
 
-groonga組込コマンドの一つであるquitについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるquitについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 
 quitは、groongaプロセスとのセッションを終了します。クライアントプロセスならばgroongaプロセスとの接続を切ります。
 

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

@@ -205,6 +205,8 @@ Required parameter
 
 There is a required parameter, ``table``.
 
+.. _select-table:
+
 ``table``
 """""""""
 
@@ -358,6 +360,8 @@ is less than ``11`` from ``Entries`` table.
 
 See :doc:`/reference/grn_expr/query_syntax` for other operations.
 
+.. _select-filter:
+
 ``filter``
 """"""""""
 
@@ -591,7 +595,7 @@ Here is a sample substitution table to show a simple
 ``Thesaurus`` substitution table has two synonyms, ``"mroonga"`` and
 ``"groonga"``. If an user searches with ``"mroonga"``, groonga
 searches with ``"((mroonga) OR (tritonn) OR (groonga mysql))"``. If an
-user searches with ``"groonga"``, groonga searchs with ``"((groonga)
+user searches with ``"groonga"``, groonga searches with ``"((groonga)
 OR (senna))"``. Nomrally, it's good idea that substitution table has
 ``KEY_NORMALIZE`` flag. If the flag is used, substitute target word is
 matched in case insensitive manner.

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

@@ -19,7 +19,7 @@ shutdown - サーバプロセスの停止
 説明
 ----
 
-groonga組込コマンドの一つであるshutdownについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Groonga組込コマンドの一つであるshutdownについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
 
 shutdownは、接続しているgroongaサーバプロセスを停止します。
 

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")