rroonga 4.0.3-x86-mingw32 → 4.0.4-x86-mingw32

data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/drilldown.txt

@@ -11,7 +11,7 @@
 Drilldown
 =========
 
-You learned how to filter search results and sort ones in the previous sections.
+You learned how to search and sort searched results in the previous sections.
 Now that you can search as you likes, but how do you summarize the number of records which has specific value in the column?
 
 As you know, there is a naive solution to execute query by every the value of column, then you can get the number of records as a result. It is a simple way, but it is not reasonable to many records.
@@ -126,4 +126,5 @@ The number of drilldown results is limited to 10 as a default. Use ``drilldown_l
 .. include:: ../example/tutorial/drilldown-limit.log
 .. select --table Site --limit 0 --drilldown country --drilldown_sortby _nsubrecs --drilldown_limit 2 --drilldown_offset 2
 
-文字列型のカラムに対するドリルダウンは、他の型でのドリルダウンに比べて低速です。文字列でのドリルダウンを行いたい場合には、このチュートリアルのように、文字列型を主キーとするテーブルを別途作成し、そのテーブルを型とするカラムを作成します。
+Note that drilldown to the column which stores string is slower than the columns which stores the other types.
+If you drilldown to string type of column, create the table that type of primary key is string, then create the column which refers that table.

data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/index.txt

@@ -7,22 +7,24 @@
 .. groonga-command
 .. database: tutorial
 
-タグ検索・参照関係の逆引き
-==========================
+Tag search and reverse resolution of reference relationships
+============================================================
 
-本チュートリアルで、Groongaはカラム値として他のテーブルへの参照の配列を持つことができることを紹介いたしました。実は、テーブルへの参照の配列データを用いることによって、いわゆるタグ検索を行うことが可能となります。
+As you know, Groonga supports to store array in column which refers other table.
+In fact, you can do tag search by using array data which refers other table.
 
-タグ検索はGroongaの転置インデックスというデータ構造を用いて高速に行われます。
+Tag search is very fast because Groonga use inverted index as data structure.
 
-タグ検索
---------
+Tag search
+----------
 
-動画共有サイトの検索エンジンを作ることを想定します。1つの動画には、その動画の特徴を表す、複数の語句が付与されています。「ある語句が付与されている動画の一覧を取得する」検索を行いたいとします。
+Let's consider to create a search engine for an web site to share movies. Each movie may be associated with multiple keywords which represents the content of movie.
 
-実際に、動画情報のテーブルを作成し、検索をしてみましょう。
+Let's create tables for movie information, then search the movies.
 
-動画の情報を保存する、Videoテーブルを作成します。Videoテーブルでは、動画のタイトルをtitleカラムに、動画のタグ情報をtagsカラムにTagテーブル型で複数格納しています。
-タグの情報を保存する、Tagテーブルを作成します。Tagテーブルでは、タグ文字列を主キーに格納し、Videoテーブルのtagsカラムに対するインデックスをindex_tagsカラムに格納しています。
+First, create the ``Video`` table which stores movie information. the ``Video`` table has two columns. the ``title`` column stores title of the movie. the ``tags`` column stores multiple tag information in reference Tag table.
+
+Next, create the ``Tag`` table which stores tag information. the ``Tag`` table has one column. The tag string is stored as primary key, then ``index_tags`` stores indexes for tags column of Video table.
 
 .. groonga-command
 .. include:: ../example/tutorial/index-1.log
@@ -43,9 +45,9 @@
 .. {"_key":8,"title":"K.O.","tags":["Animation","Music"]}
 .. ]
 
-インデックスカラムを作成すると、全文検索が高速に行えるようになります。インデックスカラムは、対象のカラムに保存されたデータに更新があったとき、自動的に更新されます。
+After creating indexed column, you can do full-text search very fast. The indexed column is also automatically updated when stored data is refreshed.
 
-「ある語句が付与されている動画の一覧を取得する」検索を行いましょう。
+List up the movies that specific keywords are given.
 
 .. groonga-command
 .. include:: ../example/tutorial/index-2.log
@@ -53,16 +55,16 @@
 .. select --table Video --query tags:@Sports --output_columns _key,title
 .. select --table Video --query tags:@Animation --output_columns _key,title
 
-このように、「Variety」、「Sports」、「Animation」のようなタグで検索を行うことができました。
+You can search by tags such as "Variety", "Sports" and "Animation".
 
-参照関係の逆引き
-----------------
+Reverse resolution of reference relationships
+---------------------------------------------
 
-Groongaはテーブル間の参照関係の逆引きを高速に行うためのインデックスを付与することができます。タグ検索は、その1例にすぎません。
+Groonga supports indexes for reverse resolution among tables. Tag search is one of concrete examples.
 
-例えば、ソーシャルネットワーキングサイトにおける友人関係を逆引き検索することができます。
+For example, you can search friendships by reverse resolution in social networking site.
 
-以下の例では、ユーザー情報を格納するUserテーブルを作成し、ユーザー名を格納するusernameカラム、ユーザーの友人一覧を配列で格納するfriendsカラムとそのインデックスのindex_friendsカラムを追加しています。
+Following example shows how to create ``User`` table which stores user information, ``username`` column which stores user name, ``friends`` column which stores list of user's friends in array, ``index_friends`` column as indexed column.
 
 .. groonga-command
 .. include:: ../example/tutorial/index-3.log
@@ -80,25 +82,26 @@ Groongaはテーブル間の参照関係の逆引きを高速に行うための
 .. {"_key":"hana","username":"花子","friends":["ken","taro","jiro","moritapo","tomo"]}
 .. ]
 
-指定したユーザーを友人リストに入れているユーザーの一覧を表示してみましょう。
+Let's show list of users who contains specified user in friend list.
 
 .. groonga-command
 .. include:: ../example/tutorial/index-4.log
 .. select --table User --query friends:@tomo --output_columns _key,username
 .. select --table User --query friends:@jiro --output_columns _key,username
 
-さらに、ドリルダウンを使って、友人リストに入っている数の一覧を表示してみましょう。
+Then drilldown the count which shows user is listed as friend.
 
 .. groonga-command
 .. include:: ../example/tutorial/index-5.log
 .. select --table User --limit 0 --drilldown friends
 
-このように、テーブルの参照関係を逆にたどる検索ができました。
+As you can see, it shows the results which follows reverse resolution of reference relationship.
 
-インデックス付きジオサーチ
---------------------------
+Geo location search with index
+------------------------------
 
-位置情報のカラムに対して、インデックスを付与することが出来ます。大量の位置情報レコードを検索する場合に、検索速度が速くなります。
+Groonga supports to add indexes to the column which stores geo location information.
+Groonga is very fast because it use such indexes against the column which contains geo location information to search enormous number of records.
 
 .. groonga-command
 .. include:: ../example/tutorial/index-6.log
@@ -111,7 +114,7 @@ Groongaはテーブル間の参照関係の逆引きを高速に行うための
 .. ]
 .. select --table Site --filter 'geo_in_circle(location, "128515259x503187188", 5000)' --output_columns _key,location
 
-同様に、位置情報レコードを用いてソートする場合に、ソート速度が速くなります。
+These indexes are also used when sorting the records with geo location search.
 
 .. groonga-command
 .. include:: ../example/tutorial/index-7.log

data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/match_columns.txt

@@ -5,21 +5,24 @@
 .. groonga-command
 .. database: tutorial-match-columns
 
-match_columnsパラメータ
+match_columns parameter
 =======================
 
-複数のカラムを対象とした全文検索
---------------------------------
+Full-text search against multiple columns
+-----------------------------------------
 
-Groongaでは、複数のカラムを対象とした全文検索を行うことができます。例えば、ブログのテーブルで、タイトルと内容とがそれぞれ別のカラムに入ったものがあるとしましょう。「タイトルもしくは内容に特定の単語を含む」検索を行いたいとします。
+Groonga supports full-text search against multiple columns. Let's consider blog site. Usually, blog site has a table which contains title column and content column. How do you search the blog entry which contains specified keywords in title or content?
 
-この場合、2つのインデックス作成方式があります。1つは、それぞれのカラムに1つずつインデックスを付与する方式です。もう1つは、複数のカラムに対して1つのインデックスを付与する方式です。Groongaでは、どちらの形式のインデックスが存在している場合でも、同一の記法で全文検索を行うことができます。
+In such a case, there are two ways to create indexes. One way is creating column index against each column. The other way is creating one column index against multiple columns. Either way, Groonga supports similar full-text search syntax.
 
-カラムごとにインデックスを付与する場合
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Creating column index against each column
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Blog1テーブルを作り、タイトル文字列のtitleカラム、本文のmessageカラムを追加しています。
-インデックス用のIndexBlog1テーブルも作り、titleカラムのインデックス用にindex_titleカラム、messageカラムのインデック用にindex_messageカラムと、それぞれ1カラムごとに1つずつ追加しています。
+Here is the example which create column index against each column.
+
+First, create ``Blog1`` table, add ``title`` column which stores title string, ``message`` column which stores content of blog entry.
+
+Then create ``IndexBlog1`` table for column indexes, add ``index_title`` column for ``title`` column, ``index_message`` column for ``message`` column.
 
 .. groonga-command
 .. include:: ../example/tutorial/match_columns-1.log
@@ -36,9 +39,10 @@ Blog1テーブルを作り、タイトル文字列のtitleカラム、本文のm
 .. {"_key":"grn3","title":"groonga message","message":"none"}
 .. ]
 
-match_columnsオプションで、検索対象のカラムを複数指定することが出来ます。検索する文字列はqueryオプションで指定します。これを使うことで、タイトルと本文を全文検索することができます。
+``match_columns`` option of ``select`` command accepts multiple columns as search target.
+Specify query string to ``query`` option. Then you can do full-text search title and content of blog entries.
 
-実際に検索してみましょう。
+Let's try to search blog entries.
 
 .. groonga-command
 .. include:: ../example/tutorial/match_columns-2.log
@@ -46,13 +50,14 @@ match_columnsオプションで、検索対象のカラムを複数指定する
 .. select --table Blog1 --match_columns title||message --query message
 .. select --table Blog1 --match_columns title --query message
 
-複数のカラムにまたがったインデックスを付与する場合
+Creating one column index against multiple columns
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-内容は上の例とほぼ同じですが、titleとmessageの2つのカラムに対するインデックスが共通になっており、インデックスカラムが1つしかありません。
+Groonga also supports one column index against multiple columns.
 
-共通のインデックスを用いても、titleカラムのみでの検索、messageカラムのみでの検索、titleもしくはmessageカラムでの検索、全ての検索を行うことができます。
+The difference for previous example is only one column index exists. Thus, There is one common column index against title and message column.
 
+Even though same column index is used, Groonga supports to search against title column only, message column only and title or message column.
 
 .. groonga-command
 .. include:: ../example/tutorial/match_columns-3.log
@@ -68,7 +73,7 @@ match_columnsオプションで、検索対象のカラムを複数指定する
 .. {"_key":"grn3","title":"groonga message","message":"none"}
 .. ]
 
-実際に検索してみましょう。結果は上の例と同じになります。
+Let's search same query in previous section. You can get same search results.
 
 .. groonga-command
 .. include:: ../example/tutorial/match_columns-4.log
@@ -85,10 +90,10 @@ match_columnsオプションで、検索対象のカラムを複数指定する
    * Indexes for multiple column - It saves disk usage because it shares common buffer. On the other hand, the update performance is not so good.
 
 
-インデックス名を指定した全文検索
---------------------------------
+Full text search with specific index name
+-----------------------------------------
 
-執筆中です。
+TODO
 
 .. TODO: match_columnsにインデックス名を指定しての検索についても触れる。
 
@@ -221,9 +226,9 @@ As a result, the first query matches two article because of Comments2 table has
 
 On the other hand, the second one matches one article only because of Replies2 table has only one record which contains 'mroonga' as keyword, and there is one record which contains same keyword and refers to the record in Comments2 table.
 
-インデックスの重み
-------------------
+Indexes with Weight
+-------------------
 
-執筆中です。
+TODO
 
 .. TODO: match_columnsの重み指定機能についても触れる。

data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/network.txt

@@ -24,7 +24,7 @@ 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 `-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 10043, 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.
 
@@ -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 specified, 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 specified, 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 10043.
 
 .. groonga-command
 .. include:: ../example/tutorial/network-1.log
@@ -105,7 +105,7 @@ Form::
 
   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. If the `-p` option is not specified, Groonga uses the default port number 10041.
 
 The following command runs an HTTP server that listens on the port number 80.
 

data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/patricia_trie.txt

@@ -5,28 +5,33 @@
 .. groonga-command
 .. database: tutorial-patricia-trie
 
-パトリシア木による前方一致検索
-==============================
+Prefix search with patricia trie
+================================
 
-Groongaのテーブルは、テーブル作成時にパトリシア木オプションを指定すると、前方一致検索を行うことができます。また、追加のオプションを指定することにより、主キーの後方一致検索をも行うことができます。
+Groonga supports to create a table with patricia trie option.
+By specifying it, You can do prefix search.
 
-主キーによる前方一致検索
-------------------------
+And more, you can do suffix search against primary key by specifying additional option.
+
+Prefix search by primary key
+----------------------------
 
-table_createコマンドのflagsオプションにTABLE_PAT_KEYを指定することで、主キーによる前方一致検索ができるようになります。
+table_create command which uses TABLE_PAT_KEY for flags option supports prefix search by primary key.
 
 .. groonga-command
-.. include:: ../example/tutorial/patricia_trie-1.log
+.. include:: ../example/tutorial/patricia_trie_prefix_search.log
 ..
 .. table_create --name PatPrefix --flags TABLE_PAT_KEY --key_type ShortText
 .. load --table PatPrefix
 .. [
-.. {"_key":"ひろゆき"},
-.. {"_key":"まろゆき"},
-.. {"_key":"ひろあき"},
-.. {"_key":"ゆきひろ"}
+.. {"_key":"James"}
+.. {"_key":"Jason"}
+.. {"_key":"Jennifer"},
+.. {"_key":"Jeff"},
+.. {"_key":"John"},
+.. {"_key":"Joseph"},
 .. ]
-.. select --table PatPrefix --query _key:^ひろ
+.. select --table PatPrefix --query _key:^Je
 
 主キーによる後方一致検索
 ------------------------

data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/search.txt

@@ -7,80 +7,82 @@
 .. groonga-command
 .. database: tutorial
 
-さまざまな検索条件の指定
-========================
+Various search conditions
+=========================
 
-Groongaは、JavaScriptに似た文法での条件絞込や、計算した値を用いたソートを行うことができます。また、位置情報(緯度・経度)を用いた絞込・ソートを行うことができます。
+Groonga supports to narrow down by using syntax like JavaScript, sort by the calculated value. Additionally, Groonga also supports to narrow down & sort search results by using location information (latitude & longitude).
 
-JavaScriptに似た文法での絞込・全文検索
---------------------------------------
+Narrow down & Full-text search by using syntax like JavaScript
+--------------------------------------------------------------
 
-selectコマンドのfilterパラメータは、queryパラメータと同様に、レコードの検索条件を指定します。filterパラメータとqueryパラメータが異なる点は、filterパラメータには、JavaScriptの式に似た文法で条件を指定する点です。
+The ``filter`` parameter of ``select`` command accepts the search condition.
+There is one difference between ``filter`` parameter and ``query`` parameter, you need to specify the condition by syntax like JavaScript for ``filter`` parameter.
 
 .. groonga-command
 .. include:: ../example/tutorial/search-1.log
 .. select --table Site --filter "_id <= 1" --output_columns _id,_key
 
-ここで、filterパラメータには
+See the detail of above query. Here is the condition which is specified as ``filter`` parameter::
 
   _id <= 1
 
-という条件を指定しています。この場合は_idの値が1以下のレコードが検索結果として得られます。
+In this case, this query returns the records which meets the condition that the value of ``_id`` is equal to 1.
 
-また、&& や || を使って、条件のAND・OR指定をすることもできます。
+Moreover, you can use ``&&`` for AND search, ``||`` for OR search.
 
 .. groonga-command
 .. include:: ../example/tutorial/search-2.log
 .. select --table Site --filter "_id >= 4 && _id <= 6" --output_columns _id,_key
 .. select --table Site --filter "_id <= 2 || _id >= 7" --output_columns _id,_key
 
-queryパラメータとfilterパラメータを同時に指定すると、両者の条件をともに満たすレコードが結果として返ります。
+If you specify ``query`` parameter and ``filter`` parameter at the same time, you can get the records which meets both of the condition as a result.
 
-scorerを利用したソート
-----------------------
+Sort by using ``scorer``
+------------------------
 
-selectコマンドのscorerパラメータは、
-全文検索を行った結果の各レコードに対して処理を行うためのパラメータです。
+``select`` command accepts ``scorer`` parameter which is used to process each record of full-text search results.
 
-filterパラメータと同様に、
-JavaScriptの式に似たな文法で様々な条件を指定することができます。
+This parameter accepts the conditions which is specified by syntax like JavaScript as same as ``filter`` parameter.
 
 .. groonga-command
 .. include:: ../example/tutorial/search-3.log
 .. select --table Site --filter "1" --scorer "_score = rand()" --output_columns _id,_key,_score --sortby _score
 .. select --table Site --filter "1" --scorer "_score = rand()" --output_columns _id,_key,_score --sortby _score
 
-検索結果には、'_score'という名前の、全文検索のスコアが代入されている仮想的なカラムが付与されることをチュートリアル中ソートの項目で説明しました。
+'_score' is one of a pseudo column. The score of full-text search is assigned to it.
+See :doc:`/reference/columns/pseudo` about '_score' column.
 
-上記の実行例では、scorerパラメータに
+In the above query, the condition of ``scorer`` parameter is::
 
- _score = rand()
+  _score = rand()
 
-という条件を指定しています。ここでは、rand()という乱数を返す関数を用いて、全文検索のスコアを乱数で上書きしています。
+In this case, the score of full-text search is overwritten by the value of rand() function.
 
-sortbyパラメータには、
+The condition of ``sortby`` parameter is::
 
- _score
+  _score
 
-を指定しています。これは、スコア順に昇順にソートすることを意味しています。
+This means that sorting the search result by ascending order.
 
-よって、上記のクエリは実行されるたびに検索結果の並び順がランダムに変わります。
+As a result, the order of search result is randomized.
 
-位置情報を用いた絞込・ソート
-----------------------------
+Narrow down & sort by using location information
+------------------------------------------------
 
-Groongaでは、位置情報（経緯度）を保存することができます。また、保存した経緯度を用いて絞込やソートができます。
+Groonga supports to store location information (Longitude & Latitude) and not only narrow down but also sort by using it.
 
-位置情報を保存するためのカラムの型として、TokyoGeoPoint/WGS84GeoPointの２つの型があります。前者は日本測地系、後者は世界測地系(WGS84相当)の経緯度を保存します。
+Groonga supports two kind of column types to store location information. One is ``TokyoGeoPoint``, the other is ``WGS84GeoPoint``. ``TokyoGeoPoint`` is used for Japan geodetic system. ``WGS84GeoPoint`` is used for world geodetic system.
 
-経緯度は以下のいずれかの形式の文字列として指定します。
+Specify longitude and latitude as follows:
 
-* "[緯度のミリ秒]x[経度のミリ秒]"（例: "128452975x503157902"）
-* "[緯度のミリ秒],[経度のミリ秒]"（例: "128452975,503157902"）
-* "[緯度の小数表記の度数]x[経度の小数表記の度数]"（例: "35.6813819x139.7660839"）
-* "[緯度の小数表記の度数],[経度の小数表記の度数]"（例: "35.6813819,139.7660839"）
+* "[latitude in milliseconds]x[longitude in milliseconds]"（e.g.: "128452975x503157902"）
+* "[latitude in milliseconds],[longitude in milliseconds]"（e.g.: "128452975,503157902"）
+* "[latitude in degrees]x[longitude in degrees]"（e.g.: "35.6813819x139.7660839"）
+* "[latitude in degrees],[longitude in degrees]"（e.g.: "35.6813819,139.7660839"）
 
-ここでは、ためしに東京駅と新宿駅とついて、世界測地系での位置情報を保存してみましょう。東京駅は緯度が35度40分52.975秒、経度が139度45分57.902秒です。新宿駅は緯度が35度41分27.316秒、経度が139度42分0.929秒です。よって、ミリ秒表記の場合はそれぞれ"128452975x503157902"/"128487316x502920929"となります。度数表記の場合はそれぞれ"35.6813819x139.7660839"/"35.6909211x139.7002581"となります。ここではミリ秒表記で登録しましょう。
+Let's store two location information about station in Japan by WGS. One is Tokyo station, the other is Shinjyuku station. Both of them are station in Japan. The latitude of Tokyo station is 35 degrees 40 minutes 52.975 seconds, the longitude of Tokyo station is 139 degrees 45 minutes 57.902 seconds. The latitude of Shinjyuku station is  35 degrees 41 minutes  27.316 seconds, the longitude of Shinjyuku station is 139 degrees 42 minutes 0.929 seconds. Thus, location information in milliseconds are "128452975x503157902" and "128487316x502920929" respectively. location information in degrees are  "35.6813819x139.7660839" and "35.6909211x139.7002581" respectively.
+
+Let's register location information in milliseconds.
 
 .. groonga-command
 .. include:: ../example/tutorial/search-4.log
@@ -92,30 +94,30 @@ Groongaでは、位置情報（経緯度）を保存することができます
 .. ]
 .. select --table Site --query "_id:1 OR _id:2" --output_columns _key,location
 
-scorerパラメータにおいて、 :doc:`/reference/functions/geo_distance` 関数を用いることにより、２点間の距離を計算することができます。
+Then assign the value of geo distance which is calculated by :doc:`/reference/functions/geo_distance` function to ``scorer`` parameter.
 
-ここでは、秋葉原駅からの距離を表示させてみましょう。世界測地系では、秋葉原駅の位置は緯度が35度41分55.259秒、経度が139度46分27.188秒です。よって、geo_distance関数に与える文字列は"128515259x503187188"となります。
+Let's show geo distance from Akihabara station in Japan. In world geodetic system, the latitude of Akihabara station is  35 degrees 41 minutes 55.259 seconds, the longitude of Akihabara station is 139 degrees 46 minutes 27.188 seconds. Specify "128515259x503187188" for geo_distance function.
 
 .. groonga-command
 .. include:: ../example/tutorial/search-5.log
 .. select --table Site --query "_id:1 OR _id:2" --output_columns _key,location,_score --scorer '_score = geo_distance(location, "128515259x503187188")'
 
-この結果を見ると、東京駅と秋葉原駅は2054m、秋葉原駅と新宿駅は6720m離れているようです。
+As you can see, the geo distance between Tokyo station and Akihabara station is 2054 meters, the geo distance between Akihabara station and Shinjyuku station is 6720 meters.
 
-geo_distance関数は、_scoreを通じてソートでも用いることができます。
+The return value of geo_distance function is also used for sorting by specifying pseudo ``_score`` column to ``sortby`` parameter.
 
 .. groonga-command
 .. include:: ../example/tutorial/search-6.log
 .. select --table Site --query "_id:1 OR _id:2" --output_columns _key,location,_score --scorer '_score = geo_distance(location, "128515259x503187188")' --sortby -_score
 
-「ある地点から何m以内に存在する」といった絞込も可能です。
+Groonga also supports to narrow down by "a certain point within specified meters".
 
-filterパラメータにおいて、 :doc:`/reference/functions/geo_in_circle` 関数を用いることにより、２点間の距離が指定のm以下におさまるかどうかを判定することができます。
+In such a case, use :doc:`/reference/functions/geo_in_circle` function in ``filter`` parameter.
 
-たとえば、秋葉原駅から5000m以内にあるレコードを検索してみましょう。
+For example, search the records which exists within 5000 meters from Akihabara station.
 
 .. groonga-command
 .. include:: ../example/tutorial/search-7.log
 .. select --table Site --output_columns _key,location --filter 'geo_in_circle(location, "128515259x503187188", 5000)'
 
-また、経緯度が指定の矩形領域内であるかどうかを判定する :doc:`/reference/functions/geo_in_rectangle` 関数も存在します。
+There is :doc:`/reference/functions/geo_in_rectangle` function which is used to search a certain point within specified region.