rroonga 2.0.0-x86-mingw32 → 2.0.1-x86-mingw32

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

@@ -7,25 +7,43 @@
 .. groonga-command
 .. database: tutorial
 
-How to use groonga with network
-===============================
+Remote access
+=============
 
-You can use groonga with network. When you run groonga by using the groonga original protocol or HTTP, groonga accepts connection for network.
+You can use groonga as a server which allows remote access. Groonga supports the original protocol (gqtp), the memcached binary protocol and HTTP.
 
-Connect with groonga's original protocol
-----------------------------------------
+Groonga query transfer protocol (gqtp)
+--------------------------------------
 
-Run groonga daemon
-^^^^^^^^^^^^^^^^^^
+How to run a gqtp server
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+Groonga has a special protocol, named groonga query transfer ptorotocl (gqtp), for remote access to a database. The following form shows how to run groonga as a gqtp server.
+
+Form::
+
+  groonga [-p PORT_NUMBER] -s DB_PATH
+
+The `-s` option specifies to run groonga as a server. DB_PATH specifies the path of the existing database to be hosted. The `-p` option and its argument, PORT_NUMBER, specify the port number of the server. The default port number is 10041, which is used when you don't specify PORT_NUMBER.
+
+The following command runs a server that listens on the default port number. The server accepts operations to the specified database.
+
+Execution example::
+
+  % groonga -s /tmp/groonga-databases/introduction.db
+  Ctrl-c
+  %
+
+How to run a gqtp daemon
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+You can also run a gqtp server as a daemon by using the `-d` option, instead of the `-s` option.
 
 Form::
 
-  groonga [-p PORT_NUMBER] -d DB_PATH_NAME
+  groonga [-p PORT_NUMBER] -d DB_PATH
 
-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.)
+A groonga daemon prints its process ID as follows. In this example, the process ID is 12345. Then, the daemon opens a specified database and accepts operations to that database.
 
 Execution example::
 
@@ -33,20 +51,16 @@ Execution example::
   12345
   %
 
-Groonga shows its process ID on daemon mode.
+How to run a gqtp client
+^^^^^^^^^^^^^^^^^^^^^^^^
 
-Connect to groonga server
-^^^^^^^^^^^^^^^^^^^^^^^^^
+You can run groonga as a gqtp client as follows:
 
 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.
+This command establishes a connection with a gqtp server and then enters into interactive mode. HOST_NAME_OR_IP_ADDRESS specifies the hostname or the IP address of the server. If not specifed, groonga uses the default hostname "localhost". The `-p` option and its argument, PORT_NUMBER, specify the port number of the server. If not specified, groonga uses the default port number 10041.
 
 .. groonga-command
 .. include:: ../example/tutorial/network-1.log
@@ -55,10 +69,12 @@ Groonga runs in interactive mode after connect to groonga server successfully. G
 .. .. > ctrl-d
 .. .. %
 
-Terminate groonga daemon
-^^^^^^^^^^^^^^^^^^^^^^^^
+In interactive mode, groonga reads commands from the standard input and executes them one by one.
+
+How to terminate a gqtp server
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-You can terminate groonga daemon with shutdown command.
+You can terminate a gqtp server with a :doc:`/commands/shutdown` command.
 
 .. groonga-command
 .. include:: ../example/tutorial/network-2.log
@@ -66,41 +82,61 @@ You can terminate groonga daemon with shutdown command.
 .. .. > shutdown
 .. .. %
 
-Connect with HTTP
------------------
+Memcached binary protocol
+-------------------------
+
+Groonga supports the memcached binary protocol. The following form shows how to run groonga as a memcached binary protocol server daemon.
+
+Form::
+
+  groonga [-p PORT_NUMBER] -d --protocol memcached DB_PATH
 
-You need to run groonga in HTTP protocol mode when you want to use groonga via HTTP.
+The `--protocol` option and its argument specify the protocol of the server. "memcached" specifies to use the memcached binary protocol.
+
+Hypertext transfer protocol (HTTP)
+-----------------------------------
+
+How to run an HTTP server
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Groonga supports the hypertext transfer protocol (HTTP). The following form shows how to run groonga as an HTTP server daemon.
 
 Form::
 
-  groonga [-p PORT_NUMBER] -d --protocol http DB_PATH_NAME
+  groonga [-p PORT_NUMBER] -d --protocol http DB_PATH
 
-`--protocol` option specifies a protocol of groonga server. `http` means that groonga accepts connections via HTTP.
+The `--protocol` option and its argument specify the protocol of the server. "http" specifies to use HTTP.
 
-Administration tool based on HTML
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+The following command runs an HTTP server that listens on the port number 80.
 
-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.
+Execution example::
+
+  % groonga -p 80 -d --protocol http /tmp/groonga-databases/introduction.db
+  %
 
-Run command with HTTP
-^^^^^^^^^^^^^^^^^^^^^
+How to send a command to an HTTP server
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-You can run command at `/d/COMMAND_NAME` when groonga is ran in HTTP protocol mode.
+You can send a command to an HTTP server by sending a GET request to /d/COMMAND_NAME. Command parameters can be passed as parameters of the GET request. The format is "?NAME_1=VALUE_1&NAME_2=VALUE_2&...".
 
-Command options are passed as HTTP's GET parameters. They are in `?OPTION=VALUE&OPTION=VALUE&...` form.
+The following example shows how to send commands to an HTTP server.
 
 .. groonga-command
 .. include:: ../example/tutorial/network-3.log
-.. .. http://[HOST_NAME_OR_IP_ADDRESS]:[PORT_NUMBER]/d/status
+.. .. 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
+.. .. http://HOST_NAME_OR_IP_ADDRESS[:PORT_NUMBER]/d/select?table=Site&query=title:@this
 .. .. Executed command:
 .. select --table Site --query title:@this
 
+Administration tool (HTTP)
+--------------------------
+
+An HTTP server of groonga provides a browser based administration tool that makes database management easy. After starting an HTTP server, you can use the administration tool by accessing http://HOST_NAME_OR_IP_ADDRESS[:PORT_NUMBER]/. Note that Javascript must be enabled for the tool to work properly.
 
-Security
---------
+Security issues
+---------------
 
-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.
+Groonga servers don't support user authentication. Everyone can view and modify databases hosted by groonga servers. You are recommended to restrict IP addresses that can access groonga servers. You can use iptables or similar for this purpose.

data/vendor/local/share/doc/groonga/source/type.txt

@@ -30,75 +30,84 @@ groongaのデータベースでは、テーブルの主キーや、カラムの
 
 ``Object``
 
-  任意のテーブルに属する全てのレコード [#]_
+  任意のテーブルに属する全てのレコードです。 [#]_
 
 ``Bool``
 
-  bool型。trueとfalse。
+  ブーリアン型やブール型などと呼ばれる型であり、真偽値を表します。取り得る値はtrueとfalseです。（デフォルト値: false）
+
+  :doc:`/commands/load` コマンドで値を格納するときは、false、0、空文字列のいずれかを指定するとfalseになり、それ以外を指定するとtrueになります。
 
 ``Int8``
 
-  8bit符号付き整数。
+  8bit符号付き整数であり、-128以上127以下の整数を表します。（デフォルト値: 0）
 
 ``UInt8``
 
-  8bit符号なし整数。
+  8bit符号なし整数であり、0以上255以下の整数を表します。（デフォルト値: 0）
 
 ``Int16``
 
-  16bit符号付き整数。
+  16bit符号付き整数であり、-32,768以上32,767以下の整数を表します。（デフォルト値: 0）
 
 ``UInt16``
 
-  16bit符号なし整数。
+  16bit符号なし整数であり、0以上65,535以下の整数を表します。（デフォルト値: 0）
 
 ``Int32``
 
-  32bit符号付き整数。
+  32bit符号付き整数であり、-2,147,483,648以上2,147,483,647以下の整数を表します。（デフォルト値: 0）
 
 ``UInt32``
 
-  32bit符号なし整数。
+  32bit符号なし整数であり、0以上4,294,967,295以下の整数を表します。（デフォルト値: 0）
 
 ``Int64``
 
-  64bit符号付き整数。
+  64bit符号付き整数であり、-9,223,372,036,854,775,808以上9,223,372,036,854,775,807以下の整数を表します。（デフォルト値: 0）
 
 ``UInt64``
 
-  64bit符号なし整数。
+  64bit符号なし整数であり、0以上18,446,744,073,709,551,615以下の整数を表します。（デフォルト値: 0）
 
 ``Float``
 
-  ieee754形式の64bit浮動小数点数。
+  IEEE 754形式の倍精度浮動小数点数であり、実数を表します。（デフォルト値: 0.0）
+
+  IEEE 754形式の詳細については、 `IEEE 754 - Wikipedia <http://ja.wikipedia.org/wiki/IEEE_754>`_ や `IEEE 754: Standard for Binary Floating-Point <http://grouper.ieee.org/groups/754/>`_ を参照してください。
 
 ``Time``
 
-  1970年1月1日0時0分0秒からの経過マイクロ秒数を64bit符号付き整数で表現した値。
+  日時を表す型であり、1970年1月1日0時0分0秒からの経過時間を、マイクロ秒単位で64bit符号付き整数により表現します。（デフォルト値: 0）
+
+  :doc:`/commands/load` コマンドで値を格納するときは、1970年1月1日0時0分0秒からの経過秒数を指定します。秒単位より詳細な日時を指定するには、小数を使います。
 
 ``ShortText``
 
-  4Kbyte以下の文字列。
+  4,095バイト以下の文字列を表します。（デフォルト値: ""）
 
 ``Text``
 
-  64Kbyte以下の文字列。
+  65,535バイト以下の文字列を表します。（デフォルト値: ""）
 
 ``LongText``
 
-  2Gbyte以下の文字列。
+  2,147,483,647バイト以下の文字列を表します。（デフォルト値: ""）
 
 ``TokyoGeoPoint``
 
-  日本測地系緯度経度座標。緯度と経度はミリ秒単位での整数。
-  "経度のミリ秒x緯度のミリ秒"という文字列表現を持つ。
-  度分秒形式であれば、x度y分z秒は(((x * 60) + y) * 60 + z) * 1000という計算式で変換した値を代入します。
+  旧日本測地系による経緯度であり、経度と緯度をミリ秒単位で表現した整数の組により表現します。（デフォルト値: 0x0）
+
+  度分秒形式でx度y分z秒となる経度・緯度は、(((x * 60) + y) * 60 + z) * 1000という計算式でミリ秒単位へと変換されます。
+  :doc:`/commands/load` コマンドで値を格納するときは、"ミリ秒単位の経度xミリ秒単位の緯度" もしくは "経度の小数表記x緯度の小数表記" という文字列表現を使って指定します。経度と緯度の区切りとしては、'x' のほかに ',' を使うことができます。
+
+  測地系の詳細については、 `測地系 - Wikipedia <http://ja.wikipedia.org/wiki/%E6%B8%AC%E5%9C%B0%E7%B3%BB>`_ を参照してください。
 
 ``WGS84GeoPoint``
 
-  世界測地系緯度経度座標。緯度と経度はミリ秒単位での整数。
-  "経度のミリ秒x緯度のミリ秒"という文字列表現を持つ。
-  度分秒形式であれば、x度y分z秒は(((x * 60) + y) * 60 + z) * 1000という計算式で変換した値を代入します。
+  世界測地系（World Geodetic System, WGS 84）による経緯度であり、経度と緯度をミリ秒単位で表現した整数の組により表現します。（デフォルト値: 0x0）
+
+  度分秒形式からミリ秒形式への変換方法や :doc:`/commands/load` コマンドにおける指定方法はTokyoGeoPointと同じです。
 
 型に関する制限事項
 ------------------

data/vendor/local/share/groonga/html/admin/css/admin.css

@@ -30,7 +30,7 @@ input {
 
 #header {
   height: 80px;
-  background: url(/images/groonga.png) no-repeat left bottom;
+  background: url(/images/groonga.png) no-repeat left center;
 }
 
 #side-menu {