null+****@clear*****
null+****@clear*****
2012年 3月 23日 (金) 16:59:05 JST
Susumu Yata 2012-03-23 16:59:05 +0900 (Fri, 23 Mar 2012)
New Revision: b3893b5c67e58523cff83057e6cb87478dd7a851
Log:
doc tutorial: update network (4.2).
Modified files:
doc/locale/ja/LC_MESSAGES/tutorial.po
doc/source/example/tutorial/network-1.log
doc/source/example/tutorial/network-3.log
doc/source/tutorial/network.txt
Modified: doc/locale/ja/LC_MESSAGES/tutorial.po (+37 -39)
===================================================================
--- doc/locale/ja/LC_MESSAGES/tutorial.po 2012-03-23 15:53:25 +0900 (db6b297)
+++ doc/locale/ja/LC_MESSAGES/tutorial.po 2012-03-23 16:59:05 +0900 (420de8c)
@@ -7,7 +7,7 @@ msgid ""
msgstr ""
"Project-Id-Version: 1.2.1\n"
"Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2012-03-23 15:46\n"
+"POT-Creation-Date: 2012-03-23 16:54\n"
"PO-Revision-Date: 2011-11-27 22:36+0900\n"
"Last-Translator: Kouhei Sutou <kou****@clear*****>\n"
"Language-Team: Japanese\n"
@@ -1065,7 +1065,8 @@ msgid ""
msgstr ""
"整列の基準となるカラムを複数指定したいときは、カンマ（,）区切りでカラムを列挙"
"します。複数のカラムを指定したときは、最初のカラムを基準として整列した後、最"
-"初のカラムに同じ値が格納されているレコードを次のカラムを基準として整列します。"
+"初のカラムに同じ値が格納されているレコードを次のカラムを基準として整列しま"
+"す。"
# 483e363f1f964ab3a2be02e9c2b67b17
#: ../../../source/tutorial/introduction.txt:285
@@ -1078,9 +1079,9 @@ msgid ""
"inverted index for full text search. A `match_columns` parameter for a "
"regular column is not supported."
msgstr ""
-"現在のバージョンでは、全文検索インデックスが存在する場合にのみ、 `match_columns` "
-"引数を利用することができます。通常のカラムでの絞り込みには利用できませ"
-"ん。"
+"現在のバージョンでは、全文検索インデックスが存在する場合にのみ、 "
+"`match_columns` 引数を利用することができます。通常のカラムでの絞り込みには利"
+"用できません。"
#: ../../../source/tutorial/lexicon.txt:6
msgid "全文検索の語彙表に対する追加情報"
@@ -1570,26 +1571,24 @@ msgstr ""
# ec85c284500e4549b3ad9b977c5ca2aa
#: ../../../source/tutorial/network.txt:27
msgid ""
-"The '-s' option specifies to run groonga as a server. DB_PATH_NAME specifies "
-"the path of the existing database to be hosted. The '-p' option and its "
+"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."
msgstr ""
-"'-s'オプションはgroongaをサーバとして起動するためのオプションです。"
-"DB_PATH_NAMEには既存のデータベースのパスを指定します。'-p'オプションとその引"
-"数により、サーバのポート番号を指定することができます。ポート番号を省略した場"
-"合は10041が使用されます。"
+"`-s` オプションはgroongaをサーバとして起動するためのオプションです。DB_PATHに"
+"は既存のデータベースのパスを指定します。 `-p` オプションとその引数により、"
+"サーバのポート番号を指定することができます。ポート番号を省略した場合は10041が"
+"使用されます。"
# 0bbeedf7a0ce4fb98f0b9af07d086a93
#: ../../../source/tutorial/network.txt:29
msgid ""
"The following command runs a server that listens on the default port number. "
-"The server accepts operations to the specified database, \"/tmp/groonga-"
-"databases/introduction.db\"."
+"The server accepts operations to the specified database."
msgstr ""
"以下のコマンドにより、デフォルトのポート番号で待ち受けるサーバを起動すること"
-"ができます。この例では、\"/tmp/groonga-databases/introduction.db\"に対する操"
-"作を受け付けます。"
+"ができます。サーバは指定されたデータベースへの操作を受け付けます。"
# 5c086abd44eb4e40be44306cf06e1f13
#: ../../../source/tutorial/network.txt:38
@@ -1599,11 +1598,11 @@ msgstr "gqtpデーモンの起動"
# aba6954242c14501bd3a285d08a7f9b8
#: ../../../source/tutorial/network.txt:40
msgid ""
-"You can also run a gqtp server as a daemon by using the '-d' option, instead "
-"of the '-s' option."
+"You can also run a gqtp server as a daemon by using the `-d` option, instead "
+"of the `-s` option."
msgstr ""
-"gqtpサーバはデーモンとして起動することができます。オプションとして、'-s'の代"
-"わりに'-d'を与えてください。"
+"gqtpサーバはデーモンとして起動することができます。オプションとして、 `-s` の"
+"代わりに `-d` を与えてください。"
# 3c5469f173484ec8ba39c2245ed9455a
#: ../../../source/tutorial/network.txt:46
@@ -1632,16 +1631,16 @@ msgid ""
"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 "
+"\"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."
msgstr ""
"上記のコマンドによって起動されたクライアントは、サーバとの接続に成功すると対"
"話モードに入ります。HOST_NAME_OR_IP_ADDRESSにはサーバのホスト名もしくはIPアド"
"レスを指定します。HOST_NAME_OR_IP_ADDRESSが省略されたときは\"localhost\"を"
-"サーバのホスト名として採用します。また、'-p'オプションとその引数により、サー"
-"バのポート番号を指定することができます。ポート番号を省略した場合は10041が使用"
-"されます。"
+"サーバのホスト名として採用します。また、 `-p` オプションとその引数により、"
+"サーバのポート番号を指定することができます。ポート番号を省略した場合は10041が"
+"使用されます。"
#: ../../../source/tutorial/network.txt:72
msgid ""
@@ -1679,10 +1678,10 @@ msgstr ""
# f75869210a16483384edb6f91c8d3cf2
#: ../../../source/tutorial/network.txt:94
msgid ""
-"The '--protocol' option and its argument specify the protocol of the server. "
+"The `--protocol` option and its argument specify the protocol of the server. "
"\"memcached\" specifies to use the memcached binary protocol."
msgstr ""
-"'--protocol'オプションとその引数により、サーバのプロトコルを指定することがで"
+"`--protocol` オプションとその引数により、サーバのプロトコルを指定することがで"
"きます。\"memcached\"はmemcachedバイナリプロトコルを示しています。"
# de369068ea8c40d49adf03644d6b6f50
@@ -1706,10 +1705,10 @@ msgstr ""
# 3806418d724e4a11b0042ed5a51046c3
#: ../../../source/tutorial/network.txt:108
msgid ""
-"The '--protocol' option and its argument specify the protocol of the server. "
+"The `--protocol` option and its argument specify the protocol of the server. "
"\"http\" specifies to use HTTP."
msgstr ""
-"'--protocol'オプションとその引数により、サーバのプロトコルを指定することがで"
+"`--protocol` オプションとその引数により、サーバのプロトコルを指定することがで"
"きます。\"http\"はHTTPサーバの起動を指示しています。"
# 0bbeedf7a0ce4fb98f0b9af07d086a93
@@ -1728,14 +1727,13 @@ msgstr "HTTPサーバへのコマンド送信"
# df79fcf54432414da92f5c02ff7c9e2b
#: ../../../source/tutorial/network.txt:120
msgid ""
-"You can send a command to an HTTP server by sending a GET request to `/d/"
-"COMMAND_NAME`. Command options can be passed as parameters of the GET "
-"request. The format is `?OPTION=VALUE&OPTION=VALUE&...`."
+"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&...\"."
msgstr ""
-"groongaがHTTPサーバとして起動されているときは、「/d/コマンド名」というURLにア"
-"クセスすることにより、コマンドを実行することができます。コマンドのオプション"
-"は、HTTPのGETパラメータとして渡します。オプションの書式は「?オプション=値&オ"
-"プション=値 …」となります。"
+"groongaがHTTPサーバとして起動されているときは、/d/COMMAND_NAME というURLにア"
+"クセスすることにより、コマンドを実行することができます。コマンドの引数"
+"は、HTTPのGETパラメータとして渡します。引数の書式は \"?NAME_1=VALUE_1&NAME_2=VALUE_2&...\" となります。"
# f8c8c0a35b004171b80f3188d5ba7ee1
#: ../../../source/tutorial/network.txt:122
@@ -1751,15 +1749,15 @@ msgstr "ブラウザベースの管理ツール"
msgid ""
"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 "
+"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."
msgstr ""
"groongaをHTTPサーバとして起動しているときは、ブラウザベースの管理ツールを使う"
"ことにより、データベースを簡単に管理することができます。管理ツールを使いたい"
-"ときは、ブラウザを使って `http://[HOST_NAME_OR_IP_ADDRESS]:[PORT_NUMBER]/` へ"
-"とアクセスしてください。管理ツールの使用には、JavaScriptの実行が有効になって"
-"いる必要があります。"
+"ときは、ブラウザを使って http://HOST_NAME_OR_IP_ADDRESS[:PORT_NUMBER]/ へとア"
+"クセスしてください。管理ツールの使用には、JavaScriptの実行が有効になっている"
+"必要があります。"
#: ../../../source/tutorial/network.txt:140
msgid "Security issues"
Modified: doc/source/example/tutorial/network-1.log (+1 -1)
===================================================================
--- doc/source/example/tutorial/network-1.log 2012-03-23 15:53:25 +0900 (bdd3109)
+++ doc/source/example/tutorial/network-1.log 2012-03-23 16:59:05 +0900 (465d867)
@@ -2,7 +2,7 @@ Execution example::
% groonga -c
> status
- [[0,1317212813.13814,0.000102148],{"alloc_count":184,"starttime":1317212806,"uptime":7,"version":"1.2.5-84-g5c190df","n_queries":14,"cache_hit_rate":0.0,"command_version":1,"default_command_version":1,"max_command_version":2}]
+ [[0,1332486613.4953,9.918212890625e-05],{"alloc_count":130,"starttime":1332486613,"uptime":0,"version":"2.0.0-250-g5a3cf19","n_queries":0,"cache_hit_rate":0.0,"command_version":1,"default_command_version":1,"max_command_version":2}]
> ctrl-d
%
\ No newline at end of file
Modified: doc/source/example/tutorial/network-3.log (+6 -6)
===================================================================
--- doc/source/example/tutorial/network-3.log 2012-03-23 15:53:25 +0900 (a1913a3)
+++ doc/source/example/tutorial/network-3.log 2012-03-23 16:59:05 +0900 (f8d129e)
@@ -1,12 +1,12 @@
Execution example::
- http://[HOST_NAME_OR_IP_ADDRESS]:[PORT_NUMBER]/d/status
+ http://HOST_NAME_OR_IP_ADDRESS[:PORT_NUMBER]/d/status
Executed command:
> status
- [[0,1317212813.33982,0.000109691],{"alloc_count":184,"starttime":1317212806,"uptime":7,"version":"1.2.5-84-g5c190df","n_queries":14,"cache_hit_rate":0.0,"command_version":1,"default_command_version":1,"max_command_version":2}]
-
- http://[HOST_NAME_OR_IP_ADDRESS]:[PORT_NUMBER]/d/select?table=Site&query=title:@this
+ [[0,1332486613.69917,0.000123739242553711],{"alloc_count":131,"starttime":1332486613,"uptime":0,"version":"2.0.0-250-g5a3cf19","n_queries":0,"cache_hit_rate":0.0,"command_version":1,"default_command_version":1,"max_command_version":2}]
+
+ http://HOST_NAME_OR_IP_ADDRESS[:PORT_NUMBER]/d/select?table=Site&query=title:@this
Executed command:
> select --table Site --query title:@this
- [[0,1317212813.54112,6.7993e-05],[[[1],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"]],[1,"http://example.org/","This is test record 1!"]]]]
-
+ [[0,1332486613.90319,0.00245404243469238],[[[1],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"]],[1,"http://example.org/","This is test record 1!"]]]]
+
\ No newline at end of file
Modified: doc/source/tutorial/network.txt (+14 -14)
===================================================================
--- doc/source/tutorial/network.txt 2012-03-23 15:53:25 +0900 (4909603)
+++ doc/source/tutorial/network.txt 2012-03-23 16:59:05 +0900 (a658a43)
@@ -22,11 +22,11 @@ Groonga has a special protocol, named groonga query transfer ptorotocl (gqtp), f
Form::
- groonga [-p PORT_NUMBER] -s DB_PATH_NAME
+ groonga [-p PORT_NUMBER] -s DB_PATH
-The '-s' option specifies to run groonga as a server. DB_PATH_NAME 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 `-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, "/tmp/groonga-databases/introduction.db".
+The following command runs a server that listens on the default port number. The server accepts operations to the specified database.
Execution example::
@@ -37,11 +37,11 @@ Execution example::
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.
+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
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.
@@ -60,7 +60,7 @@ Form::
groonga [-p PORT_NUMBER] -c [HOST_NAME_OR_IP_ADDRESS]
-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.
+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
@@ -89,9 +89,9 @@ Groonga supports the memcached binary protocol. The following form shows how to
Form::
- groonga [-p PORT_NUMBER] -d --protocol memcached DB_PATH_NAME
+ groonga [-p PORT_NUMBER] -d --protocol memcached DB_PATH
-The '--protocol' option and its argument specify the protocol of the server. "memcached" specifies to use the memcached binary protocol.
+The `--protocol` option and its argument specify the protocol of the server. "memcached" specifies to use the memcached binary protocol.
Hypertext transfer protocol (HTTP)
-----------------------------------
@@ -103,9 +103,9 @@ Groonga supports the hypertext transfer protocol (HTTP). The following form show
Form::
- groonga [-p PORT_NUMBER] -d --protocol http DB_PATH_NAME
+ groonga [-p PORT_NUMBER] -d --protocol http DB_PATH
-The '--protocol' option and its argument specify the protocol of the server. "http" specifies to use HTTP.
+The `--protocol` option and its argument specify the protocol of the server. "http" specifies to use HTTP.
The following command runs an HTTP server that listens on the port number 80.
@@ -117,24 +117,24 @@ Execution example::
How to send a command to an HTTP server
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-You can send a command to an HTTP server by sending a GET request to `/d/COMMAND_NAME`. Command options can be passed as parameters of the GET request. The format is `?OPTION=VALUE&OPTION=VALUE&...`.
+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&...".
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.
+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 issues
---------------