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