rroonga 2.1.2-x86-mingw32 → 2.1.3-x86-mingw32

data/vendor/local/share/doc/groonga/source/reference/api/grn_expr.txt

@@ -1,8 +0,0 @@
-.. -*- rst -*-
-
-.. highlightlang:: none
-
-grn_expr
-========
-
-TODO...

data/vendor/local/share/doc/groonga/source/reference/api.txt

@@ -1,8 +0,0 @@
-.. -*- rst -*-
-
-.. highlightlang:: none
-
-API
-===
-
-TODO...

data/vendor/local/share/doc/groonga/source/reference/cast.txt

@@ -1,8 +0,0 @@
-.. -*- rst -*-
-
-.. highlightlang:: none
-
-Cast
-====
-
-TODO...

data/vendor/local/share/doc/groonga/source/reference/command/command_version.txt

@@ -1,75 +0,0 @@
-.. -*- rst -*-
-
-.. highlightlang:: none
-
-コマンドバージョン
-==================
-
-概要
-----
-
-groonga1.1からコマンドバージョンという概念が導入されます。コマンドバージョンは、selectやloadなどのgroongaのコマンドの仕様の互換性を表します。groongaパッケージのバージョンが新しくなったとしても、同一のコマンドバージョンが使用可能であるなら、すべてのコマンドについて互換性が保証されます。コマンドバージョンが異なれば、同じ名前のコマンドであっても、動作に互換性がない可能性があります。
-
-あるバージョンのgroongaは、二つのコマンドバージョンを同時にサポートするようになります。
-使用するコマンドバージョンは、groongaを起動する際のコマンドラインオプションないしコンフィグファイルにdefault-commnad-versionパラメータを与えることによって指定できます。また、個々のコマンドを実行する際に、command_versionパラメータを与えることによっても指定することができます。
-
-コマンドバージョンは1からはじまり、更新されるたびに1ずつ大きくなります。現状のgroongaのコマンドの仕様はcommand-version 1という扱いになります。次回提供するgroongaは、command-version 1とcommand-version 2の二つをサポートすることになります。
-
-バージョンの位置づけ
---------------------
-
-あるバージョンのgroongaにおいてサポートされるコマンドバージョンは、develop, stable,deprecatedのいずれかの位置づけとなります。
-
-develop
-  まだ開発中であり、仕様が変更される可能性があります。
-
-stable
-  使用可能であり仕様も安定しています。その時点で使用することが推奨されます。
-
-deprecated
-  使用可能であり仕様も安定していますが、廃止予定であり使用が推奨されません。
-
-あるバージョンのgroongaがサポートする二つのコマンドバージョンのうち、いずれか一つが必ずstableの位置づけとなります。残りの一つは、developないしdeprecatedとなります。
-
-たとえば下記のようにgroongaのサポートするコマンドバージョンは推移します。::
-
-  groonga1.1: command-version1=stable     command-version2=develop
-  groonga1.2: command-version1=deprecated command-version2=stable
-  groonga1.3: command-version2=stable     command-version3=develop
-  groonga1.4: command-version2=deprecated command-version3=stable
-  groonga1.5: command-version3=stable     command-version4=develop
-
-あるコマンドバージョンははじめにdevelop扱いとしてリリースされ、やがてstableに移行します。
-その後二世代経過するとそのコマンドバージョンはdeprecated扱いとなります。さらに次のコマンドバージョンがリリースされると、deprecatedだったコマンドバージョンはサポート対象外となります。
-
-default-commnad-versionパラメータやcommand_versionパラメータを指定せずにgroongaコマンドを実行した際には、その時点でstableであるコマンドバージョンが指定されたものとみなします。
-
-groongaプロセス起動時に、default-command-versionパラメータにstable扱いでないコマンドバージョンを指定した場合には、警告メッセージがログファイルに出力されます。また、サポート範囲外のコマンドバージョンを指定した場合にはエラーとなり、プロセスは速やかに停止します。
-
-コマンドバージョンの指定方法
-----------------------------
-
-コマンドバージョンの指定方法はgroonga実行モジュールの引数として指定する方法と各コマンドの引数として指定する方法があります。
-
-default-command-versionパラメータ
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-groonga実行モジュールの引数としてdefault-command-versionパラメータを指定できます。
-(configファイルの中に指定することも可能です)
-
-実行例::
-
-  groonga --default-command-version 1
-
-そのプロセスで実行するすべてのコマンドについて、デフォルトのコマンドバージョンとして指定されたバージョンを使用します。指定されたコマンドバージョンがstableであった場合にはなんのメッセージも表示されずそのまま起動します。指定されたコマンドバージョンがdevelopあるいはdeprecatedであった場合には、groonga.logファイルに警告メッセージを出力します。指定されたコマンドバージョンがサポート対象外であった場合には標準エラー出力にエラーメッセージを出力し、プロセスは速やかに終了します。
-
-command_versionパラメータ
-^^^^^^^^^^^^^^^^^^^^^^^^^
-
-select,loadなどのすべてのgroongaコマンドにcommand_versionが指定できます。
-
-実行例::
-
-  select --command_version 1 --table tablename
-
-指定されたコマンドバージョンでコマンドを実行します。指定されたコマンドバージョンがサポート対象外であった場合にはエラーが返されます。command-versionが指定されなかった場合は、当該プロセス起動時にdefault-command-versionに指定した値が指定されたものとみなします。

data/vendor/local/share/doc/groonga/source/reference/command/output_format.txt

@@ -1,228 +0,0 @@
-.. -*- rst -*-
-
-.. highlightlang:: none
-
-Output format
-=============
-
-Summary
--------
-
-Commands output their result as JSON, MessagePack, XML or TSV format.
-
-JSON and MessagePack output have the same structure. XML and TSV are
-their original structure.
-
-JSON or MessagePack is recommend format. XML is useful for visual
-result check. TSV is just for special use. Normally you doesn't need
-to use TSV.
-
-JSON and MessagePack
---------------------
-
-This secsion describes the structure of command result on JSON and
-MessagePack format. JSON is used to show structure because MessagePack
-is binary format. Binary format isn't proper for documenataion.
-
-JSON and MessagePack uses the following structure::
-
-  [HEADER, BODY]
-
-For example::
-
-  [
-    [
-      0,
-      1337566253.89858,
-      0.000355720520019531
-    ],
-    [
-      [
-        [
-          1
-        ],
-        [
-          [
-            "_id",
-            "UInt32"
-          ],
-          [
-            "_key",
-            "ShortText"
-          ],
-          [
-            "content",
-            "Text"
-          ],
-          [
-            "n_likes",
-            "UInt32"
-          ]
-        ],
-        [
-          2,
-          "Groonga",
-          "I started to use groonga. It's very fast!",
-          10
-        ]
-      ]
-    ]
-  ]
-
-In the example, the following part is ``HEADER``::
-
-  [
-    0,
-    1337566253.89858,
-    0.000355720520019531
-  ]
-
-The following part is ``BODY``::
-
-  [
-    [
-      [
-        1
-      ],
-      [
-        [
-          "_id",
-          "UInt32"
-        ],
-        [
-          "_key",
-          "ShortText"
-        ],
-        [
-          "content",
-          "Text"
-        ],
-        [
-          "n_likes",
-          "UInt32"
-        ]
-      ],
-      [
-        2,
-        "Groonga",
-        "I started to use groonga. It's very fast!",
-        10
-      ]
-    ]
-  ]
-
-``HEADER``
-^^^^^^^^^^
-
-``HEADER`` is an array. The content of ``HEADER`` has some patterns.
-
-Success case
-++++++++++++
-
-``HEADER`` has three elements on success::
-
-  [0, UNIX_TIME_WHEN_COMMAND_IS_STARTED, ELAPSED_TIME]
-
-The first element is always ``0``.
-
-``UNIX_TIME_WHEN_COMMAND_IS_STARTED`` is the number of seconds
-since 1970-01-01 00:00:00 UTC when the command is started
-processing. ``ELAPSED_TIME`` is the elapsed time for processing the
-command in seconds. Both ``UNIX_TIME_WHEN_COMMAND_IS_STARTED`` and
-``ELAPSED_TIME`` are float value. The precision of them are
-nanosecond.
-
-Error case
-++++++++++
-
-``HEADER`` has four or five elements on error::
-
-  [
-    RETURN_CODE,
-    UNIX_TIME_WHEN_COMMAND_IS_STARTED,
-    ELAPSED_TIME,
-    ERROR_MESSAGE,
-    ERROR_LOCATION
-  ]
-
-``ERROR_LOCATION`` may not be included in ``HEADER`` but other four
-elements are always included.
-
-``RETURN_CODE`` is non 0 value. See :doc:`return_code` about available
-return codes.
-
-``UNIX_TIME_WHEN_COMMAND_IS_STARTED`` and ``ELAPSED_TIME`` are the
-same as success case.
-
-``ERROR_MESSAGE`` is an error message in string.
-
-``ERROR_LOCATION`` is optional. If error location is collected,
-``ERROR_LOCATION`` is included. ``ERROR_LOCATION`` is an
-array. ``ERROR_LOCATION`` has one ore two elements::
-
-  [
-    LOCATION_IN_GROONGA,
-    LOCATION_IN_INPUT
-  ]
-
-``LOCATION_IN_GROONGA`` is the source location that error is occurred
-in groonga. It is useful for groonga developers but not useful for
-users. ``LOCATION_IN_GROONGA`` is an array. ``LOCATION_IN_GROONGA`` has
-three elements::
-
-  [
-    FUNCTION_NAME,
-    SOURCE_FILE_NAME,
-    LINE_NUMBER
-  ]
-
-``FUNCTION_NAME`` is the name of function that error is occurred.
-
-``SOURCE_FILE_NAME`` is the name of groonga's source file that error is
-occurred.
-
-``LINE_NUMBER`` is the line number of ``SOURCE_FILE_NAME`` that error
-is occurred.
-
-``LOCATION_IN_INPUT`` is optional. ``LOCATION_IN_INPUT`` is included
-when the location that error is occurred in input file is
-collected. Input file can be specified by ``--file`` command line
-option for ``groonga`` command. ``LOCATION_IN_GROONGA`` is an
-array. ``LOCATION_IN_GROONGA`` has three elements::
-
-  [
-    INPUT_FILE_NAME,
-    LINE_NUMBER,
-    LINE_CONTENT
-  ]
-
-``INPUT_FILE_NAME`` is the input file name that error is occurred.
-
-``LINE_NUMBER`` is the line number of ``INPUT_FILE_NAME`` that error
-is occurred.
-
-``LINE_CONTENT`` is the content at ``LINE_NUMBER`` in
-``INPUT_FILE_NAME``.
-
-``BODY``
-^^^^^^^^
-
-``BODY`` content depends on the executed command. It may be omitted.
-
-``BODY`` may be an error message on error case.
-
-XML
----
-
-TODO
-
-TSV
----
-
-TODO
-
-See also
---------
-
-* :doc:`return_code` describes about return code.
-

data/vendor/local/share/doc/groonga/source/reference/command/return_code.txt

@@ -1,110 +0,0 @@
-.. -*- rst -*-
-
-.. highlightlang:: none
-
-Return code
-===========
-
-Summary
--------
-
-Return code is used to show whether a processing is succeeded or
-not. If the processing is not succeeded, return code shows error type.
-
-Return code is used in C API and query API. You can check return code
-via ``grn_ctx_t::rc`` in C API. You can check return code by looking
-the header element in query API. See :doc:`output_format` about the
-header element in query API.
-
-List
-----
-
-Here is a list of return codes. ``GRN_SUCCESS`` (= 0) means that the
-processing is succeeded. Return codes that have negative value show
-error type. ``GRN_END_OF_DATA`` is a special return code. It is used
-only C API. It is not showen in query API.
-
-* 0: ``GRN_SUCCESS``
-* 1: ``GRN_END_OF_DATA``
-* -1: ``GRN_UNKNOWN_ERROR``
-* -2: ``GRN_OPERATION_NOT_PERMITTED``
-* -3: ``GRN_NO_SUCH_FILE_OR_DIRECTORY``
-* -4: ``GRN_NO_SUCH_PROCESS``
-* -5: ``GRN_INTERRUPTED_FUNCTION_CALL``
-* -6: ``GRN_INPUT_OUTPUT_ERROR``
-* -7: ``GRN_NO_SUCH_DEVICE_OR_ADDRESS``
-* -8: ``GRN_ARG_LIST_TOO_LONG``
-* -9: ``GRN_EXEC_FORMAT_ERROR``
-* -10: ``GRN_BAD_FILE_DESCRIPTOR``
-* -11: ``GRN_NO_CHILD_PROCESSES``
-* -12: ``GRN_RESOURCE_TEMPORARILY_UNAVAILABLE``
-* -13: ``GRN_NOT_ENOUGH_SPACE``
-* -14: ``GRN_PERMISSION_DENIED``
-* -15: ``GRN_BAD_ADDRESS``
-* -16: ``GRN_RESOURCE_BUSY``
-* -17: ``GRN_FILE_EXISTS``
-* -18: ``GRN_IMPROPER_LINK``
-* -19: ``GRN_NO_SUCH_DEVICE``
-* -20: ``GRN_NOT_A_DIRECTORY``
-* -21: ``GRN_IS_A_DIRECTORY``
-* -22: ``GRN_INVALID_ARGUMENT``
-* -23: ``GRN_TOO_MANY_OPEN_FILES_IN_SYSTEM``
-* -24: ``GRN_TOO_MANY_OPEN_FILES``
-* -25: ``GRN_INAPPROPRIATE_I_O_CONTROL_OPERATION``
-* -26: ``GRN_FILE_TOO_LARGE``
-* -27: ``GRN_NO_SPACE_LEFT_ON_DEVICE``
-* -28: ``GRN_INVALID_SEEK``
-* -29: ``GRN_READ_ONLY_FILE_SYSTEM``
-* -30: ``GRN_TOO_MANY_LINKS``
-* -31: ``GRN_BROKEN_PIPE``
-* -32: ``GRN_DOMAIN_ERROR``
-* -33: ``GRN_RESULT_TOO_LARGE``
-* -34: ``GRN_RESOURCE_DEADLOCK_AVOIDED``
-* -35: ``GRN_NO_MEMORY_AVAILABLE``
-* -36: ``GRN_FILENAME_TOO_LONG``
-* -37: ``GRN_NO_LOCKS_AVAILABLE``
-* -38: ``GRN_FUNCTION_NOT_IMPLEMENTED``
-* -39: ``GRN_DIRECTORY_NOT_EMPTY``
-* -40: ``GRN_ILLEGAL_BYTE_SEQUENCE``
-* -41: ``GRN_SOCKET_NOT_INITIALIZED``
-* -42: ``GRN_OPERATION_WOULD_BLOCK``
-* -43: ``GRN_ADDRESS_IS_NOT_AVAILABLE``
-* -44: ``GRN_NETWORK_IS_DOWN``
-* -45: ``GRN_NO_BUFFER``
-* -46: ``GRN_SOCKET_IS_ALREADY_CONNECTED``
-* -47: ``GRN_SOCKET_IS_NOT_CONNECTED``
-* -48: ``GRN_SOCKET_IS_ALREADY_SHUTDOWNED``
-* -49: ``GRN_OPERATION_TIMEOUT``
-* -50: ``GRN_CONNECTION_REFUSED``
-* -51: ``GRN_RANGE_ERROR``
-* -52: ``GRN_TOKENIZER_ERROR``
-* -53: ``GRN_FILE_CORRUPT``
-* -54: ``GRN_INVALID_FORMAT``
-* -55: ``GRN_OBJECT_CORRUPT``
-* -56: ``GRN_TOO_MANY_SYMBOLIC_LINKS``
-* -57: ``GRN_NOT_SOCKET``
-* -58: ``GRN_OPERATION_NOT_SUPPORTED``
-* -59: ``GRN_ADDRESS_IS_IN_USE``
-* -60: ``GRN_ZLIB_ERROR``
-* -61: ``GRN_LZO_ERROR``
-* -62: ``GRN_STACK_OVER_FLOW``
-* -63: ``GRN_SYNTAX_ERROR``
-* -64: ``GRN_RETRY_MAX``
-* -65: ``GRN_INCOMPATIBLE_FILE_FORMAT``
-* -66: ``GRN_UPDATE_NOT_ALLOWED``
-* -67: ``GRN_TOO_SMALL_OFFSET``
-* -68: ``GRN_TOO_LARGE_OFFSET``
-* -69: ``GRN_TOO_SMALL_LIMIT``
-* -70: ``GRN_CAS_ERROR``
-* -71: ``GRN_UNSUPPORTED_COMMAND_VERSION``
-
-See also
---------
-
-* :doc:`output_format` shows where return code is appeared in query
-  API response.
-* :doc:`/spec/gqtp`: GQTP protocol also uses return code as status but
-  it uses 2byte unsigned integer. So return codes that have negative
-  value are statuses that have positive value in GQTP protocol. You
-  can convert status value in GQTP protocol to return code by
-  handling it as 2byte signed integer.

data/vendor/local/share/doc/groonga/source/reference/command.txt

@@ -1,20 +0,0 @@
-.. -*- rst -*-
-
-.. highlightlang:: none
-
-Command
-=======
-
-Command is the most important processing unit in query API. You
-request a processing to groonga by a command.
-
-This section describes about command and built-in commands.
-
-.. toctree::
-   :maxdepth: 1
-   :glob:
-
-   command/command_version
-   command/output_format
-   command/return_code
-   commands/*

data/vendor/local/share/doc/groonga/source/reference/commands/cache_limit.txt

@@ -1,54 +0,0 @@
-.. -*- rst -*-
-
-.. highlightlang:: none
-
-cache_limit
-===========
-
-名前
-----
-
-cache_limit - cacheサイズの設定・取得
-
-書式
-----
-::
-
- cache_limit max
-
-説明
-----
-
-groonga組込コマンドの一つであるcache_limitについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
-
-cache_limitは、クエリキャッシュの最大件数を取得したり設定したりします。
-
-引数
-----
-
-``max``
-
-  クエリキャッシュの最大件数を整数で指定します。
-  maxが指定されなかった場合には、クエリキャッシュの最大件数は変更せず、
-  現在の設定値のみが返されます。
-
-返値
-----
-
-json
-^^^^
-
-::
-
- [以前の設定値]
-
- ``以前の設定値``
-
-   すでに設定されていたクエリキャッシュの最大件数を返す。
-
-例
---
-::
-
- cache_limit 4
- [100]

data/vendor/local/share/doc/groonga/source/reference/commands/check.txt

@@ -1,166 +0,0 @@
-.. -*- rst -*-
-
-.. highlightlang:: none
-
-check
-=====
-
-名前
-----
-
-check - オブジェクトの状態表示
-
-書式
-----
-::
-
- check obj
-
-説明
-----
-
-groonga組込コマンドの一つであるcheckについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
-
-checkコマンドは、groongaプロセス内の指定したオブジェクトの状態を表示します。主にデータベースが壊れた場合など異常時の問題解決のために使用することを想定しています。デバッグ用のため、返値のフォーマットが安定しているということは保証されません。（フォーマットが変更される可能性が高い）
-
-引数
-----
-
-``obj``
-
-  状態を表示するオブジェクトの名前を指定します。
-
-返値
-----
-
-json形式
-^^^^^^^^
-
-チェックするオブジェクトにより返される値が変わります。
-
-インデックスカラムの場合::
-
-  下記のような配列が出力されます。
-
-    [インデックスの状態, バッファの状態1, バッファの状態2, ...]
-
-  ``インデックスの状態``には下記の項目がハッシュ形式で出力されます。
-
-  ``flags``
-
-    指定されているフラグ値です。16進数で表現されています。
-
-  ``max sid``
-
-    セグメントのうち最も大きなIDです。
-
-  ``number of garbage segments``
-
-    ゴミセグメントの数です。
-
-  ``number of array segments``
-
-    配列セグメントの数です。
-
-  ``max id of array segment``
-
-    配列セグメントのうち最も大きなIDです。
-
-  ``number of buffer segments``
-
-    バッファセグメントの数です。
-
-  ``max id of buffer segment``
-
-    バッファセグメントのうち最も大きなIDです。
-
-  ``max id of physical segment in use``
-
-    使用中の論理セグメントのうち最も大きなIDです。
-
-  ``number of unmanaged segments``
-
-    管理されていないセグメントの数です。
-
-  ``total chunk size``
-
-    チャンクサイズの合計です。
-
-  ``max id of chunk segments in use``
-
-    使用中のチャンクセグメントのうち最も大きなIDです。
-
-  ``number of garbage chunk``
-
-    各チャンク毎のゴミの数です。
-
-  ``バッファの状態``には下記の項目がハッシュ形式で出力されます。
-
-  ``buffer id``
-
-    バッファIDです。
-
-  ``chunk size``
-
-    チャンクのサイズです。
-
-  ``buffer term``
-
-    バッファ内にある語の一覧です。各語の状態は以下のような配列となっています。
-
-      [語, バッファに登録されている語のID, 用語集に登録されている語のID, バッファ内でのサイズ, チャンク内でのサイズ]
-
-  ``buffer free``
-
-    バッファの空き容量です。
-
-  ``size in buffer``
-
-    バッファの使用量です。
-
-  ``nterms``
-
-    バッファ内にある語の数です。
-
-  ``nterms with chunk``
-
-    バッファ内にある語のうち、チャンクを使っている語の数です。
-
-例
---
-
-テーブルTermsのインデックスカラムnameの状態を表示します。::
-
- check Terms.name
- [{"flags":"00008202",
-   "max sid":1,
-   "number of garbage segments":0,
-   "number of array segments":1,
-   "max id of array segment":1,
-   "number of buffer segments":110,
-   "max id of buffer segment":111,
-   "max id of physical segment in use":111,
-   "number of unmanaged segments":4294967185,
-   "total chunk size":7470239,
-   "max id of chunk segments in use":127,
-   "number of garbage chunk":[0,0,0,0,0,0,0,0,2,2,0,0,0,0,0]},
-  {"buffer id":0,
-   "chunk size":94392,
-   "buffer term":["596","59777","6",...],
-   "buffer free":152944,
-   "size in buffer":7361,
-   "nterms":237,
-   "nterms with chunk":216,
-   "buffer id":1,
-   "chunk size":71236,
-   "buffer term":[["に述",18149,18149,2,25,6,6],
-                  ["に追",4505,4505,76,485,136,174],
-                  ["に退",26568,26568,2,9,2,2],
-                  ...],
-   "buffer free":120000,
-   "size in buffer":11155,
-   "nterms":121,
-   "nterms with chunk":116},
-   {"buffer id":1,
-    ...},
-   ...]