rroonga 2.0.2-x86-mingw32 → 2.0.3-x86-mingw32

data/vendor/local/share/man/man1/groonga.1

@@ -1,4 +1,4 @@
-.TH "GROONGA" "1" "March 29, 2012" "2.0.0" "groonga"
+.TH "GROONGA" "1" "April 28, 2012" "2.0.2" "groonga"
 .SH NAME
 groonga \- groonga documentation
 .
@@ -100,8 +100,8 @@ Install:
 .sp
 .nf
 .ft C
-% sudo apt\-key adv \-\-recv\-keys \-\-keyserver keyserver.ubuntu.com 1C837F31
 % sudo aptitude update
+% sudo aptitude \-V \-D \-y \-\-allow\-untrusted install groonga\-keyring
 % sudo aptitude \-V \-D \-y install groonga
 .ft P
 .fi
@@ -140,8 +140,8 @@ Install:
 .sp
 .nf
 .ft C
-% sudo apt\-key adv \-\-recv\-keys \-\-keyserver keyserver.ubuntu.com 1C837F31
 % sudo aptitude update
+% sudo aptitude \-V \-D \-y \-\-allow\-untrusted install groonga\-keyring
 % sudo aptitude \-V \-D \-y install groonga
 .ft P
 .fi
@@ -180,8 +180,8 @@ Install:
 .sp
 .nf
 .ft C
-% sudo apt\-key adv \-\-recv\-keys \-\-keyserver keyserver.ubuntu.com 1C837F31
 % sudo aptitude update
+% sudo aptitude \-V \-D \-y \-\-allow\-untrusted install groonga\-keyring
 % sudo aptitude \-V \-D \-y install groonga
 .ft P
 .fi
@@ -224,8 +224,8 @@ Install:
 .sp
 .nf
 .ft C
-% sudo apt\-key adv \-\-recv\-keys \-\-keyserver keyserver.ubuntu.com 1C837F31
 % sudo apt\-get update
+% sudo apt\-get \-y \-\-allow\-unauthenticated install groonga\-keyring
 % sudo apt\-get \-y install groonga
 .ft P
 .fi
@@ -268,8 +268,8 @@ Install:
 .sp
 .nf
 .ft C
-% sudo apt\-key adv \-\-recv\-keys \-\-keyserver keyserver.ubuntu.com 1C837F31
 % sudo apt\-get update
+% sudo apt\-get \-y \-\-allow\-unauthenticated install groonga\-keyring
 % sudo apt\-get \-y install groonga
 .ft P
 .fi
@@ -312,8 +312,52 @@ Install:
 .sp
 .nf
 .ft C
-% sudo apt\-key adv \-\-recv\-keys \-\-keyserver keyserver.ubuntu.com 1C837F31
 % sudo apt\-get update
+% sudo apt\-get \-y \-\-allow\-unauthenticated install groonga\-keyring
+% sudo apt\-get \-y install groonga
+.ft P
+.fi
+.sp
+If you want to use \fI\%MeCab\fP as a tokenizer. please install groonga\-tokenizer\-mecab package.
+.sp
+Install groonga\-tokenizer\-mecab package:
+.sp
+.nf
+.ft C
+% sudo apt\-get \-y install groonga\-tokenizer\-mecab
+.ft P
+.fi
+.sp
+There is a package that provides \fI\%Munin\fP plugins. If you want to monitor groonga status by Munin, please install groonga\-munin\-plugins package.
+.sp
+Install groonga\-munin\-plugins package:
+.sp
+.nf
+.ft C
+% sudo apt\-get \-y install groonga\-munin\-plugins
+.ft P
+.fi
+.SS Ubuntu 12.04 Precise Pangolin
+.IP Note
+You\(aqll need to enable the universe repository of Ubuntu to install groonga.
+The following describes how to do it.
+.RE
+.sp
+/etc/apt/sources.list.d/groonga.list:
+.sp
+.nf
+.ft C
+deb http://packages.groonga.org/ubuntu/ precise universe
+deb\-src http://packages.groonga.org/ubuntu/ precise universe
+.ft P
+.fi
+.sp
+Install:
+.sp
+.nf
+.ft C
+% sudo apt\-get update
+% sudo apt\-get \-y \-\-allow\-unauthenticated install groonga\-keyring
 % sudo apt\-get \-y install groonga
 .ft P
 .fi
@@ -343,7 +387,7 @@ Install:
 .sp
 .nf
 .ft C
-% sudo rpm \-ivh http://packages.groonga.org/centos/groonga\-repository\-1.0.0\-0.noarch.rpm
+% sudo rpm \-ivh http://packages.groonga.org/centos/groonga\-repository\-1.0.1\-0.noarch.rpm
 % sudo yum update
 % sudo yum install \-y groonga
 .ft P
@@ -402,7 +446,7 @@ Install:
 .sp
 .nf
 .ft C
-% sudo rpm \-ivh http://packages.groonga.org/centos/groonga\-repository\-1.0.0\-0.noarch.rpm
+% sudo rpm \-ivh http://packages.groonga.org/centos/groonga\-repository\-1.0.1\-0.noarch.rpm
 % sudo yum update
 % sudo yum install \-y groonga
 .ft P
@@ -461,7 +505,7 @@ Install:
 .sp
 .nf
 .ft C
-% sudo rpm \-ivh http://packages.groonga.org/fedora/groonga\-repository\-1.0.0\-0.noarch.rpm
+% sudo rpm \-ivh http://packages.groonga.org/fedora/groonga\-repository\-1.0.1\-0.noarch.rpm
 % sudo yum update
 % sudo yum install \-y groonga
 .ft P
@@ -528,7 +572,7 @@ Install:
 .ft P
 .fi
 .sp
-The \fI\-\-prefix\fP option specifies the path to install groonga. If you don\(aqt specify the install path, "/usr/local" is used. Please specify "/usr" if you are not familiar with environment variables such as LD_LIBRARY_PATH.
+The \fB\-\-prefix\fP option specifies the path to install groonga. If you don\(aqt specify the install path, "/usr/local" is used. Please specify "/usr" if you are not familiar with environment variables such as LD_LIBRARY_PATH.
 .sp
 There are some \fI\%Munin\fP plugins in groonga package. You need to specify \fI\-\-with\-munin\-plugins\fP option if you want to install them.
 .SH COMMUNITY
@@ -981,7 +1025,24 @@ Execution example:
 .ft C
 % groonga \-c
 > status
-[[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}]
+[
+  [
+    0,
+    1335519662.04579,
+    5.79357147216797e\-05
+  ],
+  {
+    "uptime": 0,
+    "max_command_version": 2,
+    "n_queries": 0,
+    "cache_hit_rate": 0.0,
+    "version": "2.0.1\-283\-g3f815e2",
+    "alloc_count": 130,
+    "command_version": 1,
+    "starttime": 1335519662,
+    "default_command_version": 1
+  }
+]
 > ctrl\-d
 %
 .ft P
@@ -1052,12 +1113,90 @@ Execution example:
 http://HOST_NAME_OR_IP_ADDRESS[:PORT_NUMBER]/d/status
 Executed command:
 > status
-[[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}]
+[
+  [
+    0,
+    1335519662.24808,
+    9.918212890625e\-05
+  ],
+  {
+    "uptime": 0,
+    "max_command_version": 2,
+    "n_queries": 0,
+    "cache_hit_rate": 0.0,
+    "version": "2.0.1\-283\-g3f815e2",
+    "alloc_count": 131,
+    "command_version": 1,
+    "starttime": 1335519662,
+    "default_command_version": 1
+  }
+]
 
 http://HOST_NAME_OR_IP_ADDRESS[:PORT_NUMBER]/d/select?table=Site&query=title:@this
 Executed command:
 > select \-\-table Site \-\-query title:@this
-[[0,1332486613.90319,0.00245404243469238],[[[1],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"]],[1,"http://example.org/","This is test record 1!"]]]]
+[
+  [
+    0,
+    1335519662.45038,
+    0.00197672843933105
+  ],
+  [
+    [
+      [
+        1
+      ],
+      [
+        [
+          "_id",
+          "UInt32"
+        ],
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "country",
+          "SiteCountry"
+        ],
+        [
+          "domain",
+          "SiteDomain"
+        ],
+        [
+          "link",
+          "Site"
+        ],
+        [
+          "links",
+          "Site"
+        ],
+        [
+          "location",
+          "WGS84GeoPoint"
+        ],
+        [
+          "title",
+          "ShortText"
+        ]
+      ],
+      [
+        1,
+        "http://example.org/",
+        "japan",
+        ".org",
+        "http://example.net/",
+        [
+          "http://example.net/",
+          "http://example.org/",
+          "http://example.com/"
+        ],
+        "128452975x503157902",
+        "This is test record 1!"
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .SS Administration tool (HTTP)
@@ -1082,7 +1221,7 @@ Execution example:
 .nf
 .ft C
 > table_create \-\-name ToyBox \-\-flags TABLE_HASH_KEY \-\-key_type ShortText
-[[0,1332498286.03578,0.00542259216308594],true]
+[[0,1335519604.4465,0.000195741653442383],true]
 .ft P
 .fi
 .SS Boolean type
@@ -1096,16 +1235,51 @@ Execution example:
 .nf
 .ft C
 > column_create \-\-table ToyBox \-\-name is_animal \-\-type Bool
-[[0,1332498286.2427,0.00578594207763672],true]
+[[0,1335519604.64795,0.000276803970336914],true]
 > load \-\-table ToyBox
 > [
 > {"_key":"Monkey","is_animal":true}
 > {"_key":"Flower","is_animal":false}
 > {"_key":"Block"}
 > ]
-[[0,1332498286.44978,1.00197458267212],3]
+[[0,1335519604.84886,1.00171399116516],3]
 > select \-\-table ToyBox \-\-output_columns _key,is_animal
-[[0,1332498287.65257,0.000472545623779297],[[[3],[["_key","ShortText"],["is_animal","Bool"]],["Monkey",true],["Flower",false],["Block",false]]]]
+[
+  [
+    0,
+    1335519606.05127,
+    0.000250577926635742
+  ],
+  [
+    [
+      [
+        3
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "is_animal",
+          "Bool"
+        ]
+      ],
+      [
+        "Monkey",
+        true
+      ],
+      [
+        "Flower",
+        false
+      ],
+      [
+        "Block",
+        false
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .SS Numeric types
@@ -1119,18 +1293,60 @@ Execution example:
 .nf
 .ft C
 > column_create \-\-table ToyBox \-\-name price \-\-type Int8
-[[0,1332498287.85609,0.00574946403503418],true]
+[[0,1335519606.2531,0.000290155410766602],true]
 > column_create \-\-table ToyBox \-\-name weight \-\-type Float
-[[0,1332498288.06304,0.00493621826171875],true]
+[[0,1335519606.45421,0.000332832336425781],true]
 > load \-\-table ToyBox
 > [
 > {"_key":"Monkey","price":15.9}
 > {"_key":"Flower","price":200,"weight":0.13}
 > {"_key":"Block","weight":25.7}
 > ]
-[[0,1332498288.26924,1.00213837623596],3]
+[[0,1335519606.65545,1.00174689292908],3]
 > select \-\-table ToyBox \-\-output_columns _key,price,weight
-[[0,1332498289.47254,0.000308036804199219],[[[3],[["_key","ShortText"],["price","Int8"],["weight","Float"]],["Monkey",15,0.0],["Flower",\-56,0.13],["Block",0,25.7]]]]
+[
+  [
+    0,
+    1335519607.85801,
+    0.000263452529907227
+  ],
+  [
+    [
+      [
+        3
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "price",
+          "Int8"
+        ],
+        [
+          "weight",
+          "Float"
+        ]
+      ],
+      [
+        "Monkey",
+        15,
+        0.0
+      ],
+      [
+        "Flower",
+        \-56,
+        0.13
+      ],
+      [
+        "Block",
+        0,
+        25.7
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .SS String types
@@ -1144,24 +1360,55 @@ Execution example:
 .nf
 .ft C
 > column_create \-\-table ToyBox \-\-name name \-\-type ShortText
-[[0,1332498289.67627,0.00676369667053223],true]
+[[0,1335519608.06052,0.000979185104370117],true]
 > load \-\-table ToyBox
 > [
 > {"_key":"Monkey","name":"Grease"}
 > {"_key":"Flower","name":"Rose"}
 > ]
-[[0,1332498289.88434,0.801783800125122],2]
+[[0,1335519608.26235,0.8014075756073],2]
 > select \-\-table ToyBox \-\-output_columns _key,name
-[[0,1332498290.88724,0.000265598297119141],[[[3],[["_key","ShortText"],["name","ShortText"]],["Monkey","Grease"],["Flower","Rose"],["Block",""]]]]
+[
+  [
+    0,
+    1335519609.26462,
+    0.000252008438110352
+  ],
+  [
+    [
+      [
+        3
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "name",
+          "ShortText"
+        ]
+      ],
+      [
+        "Monkey",
+        "Grease"
+      ],
+      [
+        "Flower",
+        "Rose"
+      ],
+      [
+        "Block",
+        ""
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .SS Date and time type
 .sp
-The date and time type of groonga is Time. Actually, a Time column stores a date and time as the number of microseconds since the Epoch, 1970\-01\-01 00:00:00. A Time value can represent a date and time before the Epoch because the actual data type is a signed integer. Note that \fB/commands/load\fP and :doc:
-.nf
-\(ga
-.fi
-/commands/select commands use a decimal number to represent a data and time in seconds. The default value is 0.0, which means the Epoch.
+The date and time type of groonga is Time. Actually, a Time column stores a date and time as the number of microseconds since the Epoch, 1970\-01\-01 00:00:00. A Time value can represent a date and time before the Epoch because the actual data type is a signed integer. Note that \fB/commands/load\fP and \fB/commands/select\fP commands use a decimal number to represent a data and time in seconds. The default value is 0.0, which means the Epoch.
 .sp
 The following example creates a Time column and updates existing records. The first record has the default value because not updated.
 .sp
@@ -1170,15 +1417,50 @@ Execution example:
 .nf
 .ft C
 > column_create \-\-table ToyBox \-\-name time \-\-type Time
-[[0,1332498291.0906,0.00631809234619141],true]
+[[0,1335519609.46723,0.000249862670898438],true]
 > load \-\-table ToyBox
 > [
 > {"_key":"Flower","time":1234567890.1234569999}
 > {"_key":"Block","time":\-1234567890}
 > ]
-[[0,1332498291.29814,0.801807641983032],2]
+[[0,1335519609.66827,0.801551818847656],2]
 > select \-\-table ToyBox \-\-output_columns _key,time
-[[0,1332498292.30117,0.000299692153930664],[[[3],[["_key","ShortText"],["time","Time"]],["Monkey",0.0],["Flower",1234567890.12346],["Block",\-1234567890.0]]]]
+[
+  [
+    0,
+    1335519610.67062,
+    0.000240564346313477
+  ],
+  [
+    [
+      [
+        3
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "time",
+          "Time"
+        ]
+      ],
+      [
+        "Monkey",
+        0.0
+      ],
+      [
+        "Flower",
+        1234567890.12346
+      ],
+      [
+        "Block",
+        \-1234567890.0
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .SS Longitude and latitude types
@@ -1200,15 +1482,50 @@ Execution example:
 .nf
 .ft C
 > column_create \-\-table ToyBox \-\-name location \-\-type WGS84GeoPoint
-[[0,1332498292.50467,0.0079643726348877],true]
+[[0,1335519610.87363,0.00025629997253418],true]
 > load \-\-table ToyBox
 > [
 > {"_key":"Monkey","location":"128452975x503157902"}
 > {"_key":"Block","location":"35.6813819x139.7660839"}
 > ]
-[[0,1332498292.71385,0.801813840866089],2]
+[[0,1335519611.07464,0.801477193832397],2]
 > select \-\-table ToyBox \-\-output_columns _key,location
-[[0,1332498293.71678,0.000298976898193359],[[[3],[["_key","ShortText"],["location","WGS84GeoPoint"]],["Monkey","128452975x503157902"],["Flower","0x0"],["Block","128452975x503157902"]]]]
+[
+  [
+    0,
+    1335519612.07663,
+    0.000145435333251953
+  ],
+  [
+    [
+      [
+        3
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "location",
+          "WGS84GeoPoint"
+        ]
+      ],
+      [
+        "Monkey",
+        "128452975x503157902"
+      ],
+      [
+        "Flower",
+        "0x0"
+      ],
+      [
+        "Block",
+        "128452975x503157902"
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .SS Reference types
@@ -1224,12 +1541,49 @@ Execution example:
 .nf
 .ft C
 > column_create \-\-table Site \-\-name link \-\-type Site
-[[0,1332498293.92066,0.00589966773986816],true]
+[[0,1335519612.27812,0.000259876251220703],true]
 > load \-\-table Site
 > [{"_key":"http://example.org/","link":"http://example.net/"}]
-[[0,1332498294.1274,0.201014280319214],1]
+[[0,1335519612.47892,0.200559377670288],1]
 > select \-\-table Site \-\-output_columns _key,title,link._key,link.title \-\-query title:@this
-[[0,1332498294.52959,0.00171041488647461],[[[1],[["_key","ShortText"],["title","ShortText"],["link._key","ShortText"],["link.title","ShortText"]],["http://example.org/","This is test record 1!","http://example.net/","test record 2."]]]]
+[
+  [
+    0,
+    1335519612.88015,
+    0.000769853591918945
+  ],
+  [
+    [
+      [
+        1
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "title",
+          "ShortText"
+        ],
+        [
+          "link._key",
+          "ShortText"
+        ],
+        [
+          "link.title",
+          "ShortText"
+        ]
+      ],
+      [
+        "http://example.org/",
+        "This is test record 1!",
+        "http://example.net/",
+        "test record 2."
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .sp
@@ -1245,12 +1599,57 @@ Execution example:
 .nf
 .ft C
 > column_create \-\-table Site \-\-name links \-\-flags COLUMN_VECTOR \-\-type Site
-[[0,1332498294.7353,0.00729537010192871],true]
+[[0,1335519613.08263,0.00126886367797852],true]
 > load \-\-table Site
 > [{"_key":"http://example.org/","links":["http://example.net/","http://example.org/","http://example.com/"]}]
-[[0,1332498294.94353,0.200709581375122],1]
+[[0,1335519613.28473,0.200579166412354],1]
 > select \-\-table Site \-\-output_columns _key,title,links._key,links.title \-\-query title:@this
-[[0,1332498295.34514,0.00077366828918457],[[[1],[["_key","ShortText"],["title","ShortText"],["links._key","ShortText"],["links.title","ShortText"]],["http://example.org/","This is test record 1!",["http://example.net/","http://example.org/","http://example.com/"],["test record 2.","This is test record 1!","test test record three."]]]]]
+[
+  [
+    0,
+    1335519613.68602,
+    0.000647306442260742
+  ],
+  [
+    [
+      [
+        1
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "title",
+          "ShortText"
+        ],
+        [
+          "links._key",
+          "ShortText"
+        ],
+        [
+          "links.title",
+          "ShortText"
+        ]
+      ],
+      [
+        "http://example.org/",
+        "This is test record 1!",
+        [
+          "http://example.net/",
+          "http://example.org/",
+          "http://example.com/"
+        ],
+        [
+          "test record 2.",
+          "This is test record 1!",
+          "test test record three."
+        ]
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .sp
@@ -1522,15 +1921,15 @@ Execution example:
 .nf
 .ft C
 > table_create \-\-name Video \-\-flags TABLE_HASH_KEY \-\-key_type UInt32
-[[0,1317212832.70606,0.061331715],true]
+[[0,1335519627.03224,0.000266790390014648],true]
 > table_create \-\-name Tag \-\-flags TABLE_HASH_KEY \-\-key_type ShortText
-[[0,1317212832.968,0.039868236],true]
+[[0,1335519627.23315,0.000222206115722656],true]
 > column_create \-\-table Video \-\-name title \-\-flags COLUMN_SCALAR \-\-type ShortText
-[[0,1317212833.20833,0.040494862],true]
+[[0,1335519627.43389,0.000550031661987305],true]
 > column_create \-\-table Video \-\-name tags \-\-flags COLUMN_VECTOR \-\-type Tag
-[[0,1317212833.44939,0.051861409],true]
+[[0,1335519627.63497,0.000490188598632812],true]
 > column_create \-\-table Tag \-\-name index_tags \-\-flags COLUMN_INDEX \-\-type Video \-\-source tags
-[[0,1317212833.70185,0.092878953],true]
+[[0,1335519627.83602,0.0032198429107666],true]
 > load \-\-table Video
 > [
 > {"_key":1,"title":"Soccer 2010","tags":["Sports","Soccer"]},
@@ -1542,7 +1941,7 @@ Execution example:
 > {"_key":7,"title":"Draw 8 Month","tags":["Animation","Raccoon"]},
 > {"_key":8,"title":"K.O.","tags":["Animation","Music"]}
 > ]
-[[0,1317212833.99531,2.002850011],8]
+[[0,1335519628.03974,2.00352549552917],8]
 .ft P
 .fi
 .sp
@@ -1555,11 +1954,108 @@ Execution example:
 .nf
 .ft C
 > select \-\-table Video \-\-query tags:@Variety \-\-output_columns _key,title
-[[0,1317212836.19894,0.000330108],[[[2],[["_key","UInt32"],["title","ShortText"]],[2,"Zenigata Kinjirou"],[5,"Hex Gone!"]]]]
+[
+  [
+    0,
+    1335519630.24437,
+    0.000667810440063477
+  ],
+  [
+    [
+      [
+        2
+      ],
+      [
+        [
+          "_key",
+          "UInt32"
+        ],
+        [
+          "title",
+          "ShortText"
+        ]
+      ],
+      [
+        2,
+        "Zenigata Kinjirou"
+      ],
+      [
+        5,
+        "Hex Gone!"
+      ]
+    ]
+  ]
+]
 > select \-\-table Video \-\-query tags:@Sports \-\-output_columns _key,title
-[[0,1317212836.39998,0.000316897],[[[2],[["_key","UInt32"],["title","ShortText"]],[1,"Soccer 2010"],[4,"Moero!! Ultra Baseball"]]]]
+[
+  [
+    0,
+    1335519630.44675,
+    0.000470399856567383
+  ],
+  [
+    [
+      [
+        2
+      ],
+      [
+        [
+          "_key",
+          "UInt32"
+        ],
+        [
+          "title",
+          "ShortText"
+        ]
+      ],
+      [
+        1,
+        "Soccer 2010"
+      ],
+      [
+        4,
+        "Moero!! Ultra Baseball"
+      ]
+    ]
+  ]
+]
 > select \-\-table Video \-\-query tags:@Animation \-\-output_columns _key,title
-[[0,1317212836.60111,0.000349157],[[[3],[["_key","UInt32"],["title","ShortText"]],[6,"Pikonyan 1"],[7,"Draw 8 Month"],[8,"K.O."]]]]
+[
+  [
+    0,
+    1335519630.64889,
+    0.000455856323242188
+  ],
+  [
+    [
+      [
+        3
+      ],
+      [
+        [
+          "_key",
+          "UInt32"
+        ],
+        [
+          "title",
+          "ShortText"
+        ]
+      ],
+      [
+        6,
+        "Pikonyan 1"
+      ],
+      [
+        7,
+        "Draw 8 Month"
+      ],
+      [
+        8,
+        "K.O."
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .sp
@@ -1577,13 +2073,13 @@ Execution example:
 .nf
 .ft C
 > table_create \-\-name User \-\-flags TABLE_HASH_KEY \-\-key_type ShortText
-[[0,1317212836.80268,0.048923839],true]
+[[0,1335519630.85121,0.00020289421081543],true]
 > column_create \-\-table User \-\-name username \-\-flags COLUMN_SCALAR \-\-type ShortText
-[[0,1317212837.05226,0.040322616],true]
+[[0,1335519631.05176,0.00130391120910645],true]
 > column_create \-\-table User \-\-name friends \-\-flags COLUMN_VECTOR \-\-type User
-[[0,1317212837.29306,0.039978793],true]
+[[0,1335519631.25402,0.000970840454101562],true]
 > column_create \-\-table User \-\-name index_friends \-\-flags COLUMN_INDEX \-\-type User \-\-source friends
-[[0,1317212837.53369,0.067271637],true]
+[[0,1335519631.45581,0.00640487670898438],true]
 > load \-\-table User
 > [
 > {"_key":"ken","username":"健作","friends":["taro","jiro","tomo","moritapo"]}
@@ -1593,7 +2089,7 @@ Execution example:
 > {"_key":"tomo","username":"トモちゃん","friends":["ken","hana"]}
 > {"_key":"hana","username":"花子","friends":["ken","taro","jiro","moritapo","tomo"]}
 > ]
-[[0,1317212837.80152,1.602221355],6]
+[[0,1335519631.6631,1.60283184051514],6]
 .ft P
 .fi
 .sp
@@ -1604,9 +2100,87 @@ Execution example:
 .nf
 .ft C
 > select \-\-table User \-\-query friends:@tomo \-\-output_columns _key,username
-[[0,1317212839.60442,0.000260617],[[[5],[["_key","ShortText"],["username","ShortText"]],["ken","健作"],["taro","ぐるんが太郎"],["jiro","ぐるんが次郎"],["moritapo","森田"],["hana","花子"]]]]
+[
+  [
+    0,
+    1335519633.46704,
+    0.000623941421508789
+  ],
+  [
+    [
+      [
+        5
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "username",
+          "ShortText"
+        ]
+      ],
+      [
+        "ken",
+        "健作"
+      ],
+      [
+        "taro",
+        "ぐるんが太郎"
+      ],
+      [
+        "jiro",
+        "ぐるんが次郎"
+      ],
+      [
+        "moritapo",
+        "森田"
+      ],
+      [
+        "hana",
+        "花子"
+      ]
+    ]
+  ]
+]
 > select \-\-table User \-\-query friends:@jiro \-\-output_columns _key,username
-[[0,1317212839.80577,0.000253172],[[[3],[["_key","ShortText"],["username","ShortText"]],["ken","健作"],["taro","ぐるんが太郎"],["hana","花子"]]]]
+[
+  [
+    0,
+    1335519633.67028,
+    0.000344514846801758
+  ],
+  [
+    [
+      [
+        3
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "username",
+          "ShortText"
+        ]
+      ],
+      [
+        "ken",
+        "健作"
+      ],
+      [
+        "taro",
+        "ぐるんが太郎"
+      ],
+      [
+        "hana",
+        "花子"
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .sp
@@ -1617,7 +2191,81 @@ Execution example:
 .nf
 .ft C
 > select \-\-table User \-\-limit 0 \-\-drilldown friends
-[[0,1317212840.00717,0.000223187],[[[6],[["_id","UInt32"],["_key","ShortText"],["username","ShortText"],["index_friends","User"],["friends","User"]]],[[6],[["_key","ShortText"],["_nsubrecs","Int32"]],["taro",3],["jiro",3],["tomo",5],["moritapo",2],["ken",3],["hana",1]]]]
+[
+  [
+    0,
+    1335519633.87264,
+    0.000327825546264648
+  ],
+  [
+    [
+      [
+        6
+      ],
+      [
+        [
+          "_id",
+          "UInt32"
+        ],
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "friends",
+          "User"
+        ],
+        [
+          "index_friends",
+          "User"
+        ],
+        [
+          "username",
+          "ShortText"
+        ]
+      ]
+    ],
+    [
+      [
+        6
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "_nsubrecs",
+          "Int32"
+        ]
+      ],
+      [
+        "taro",
+        3
+      ],
+      [
+        "jiro",
+        3
+      ],
+      [
+        "tomo",
+        5
+      ],
+      [
+        "moritapo",
+        2
+      ],
+      [
+        "ken",
+        3
+      ],
+      [
+        "hana",
+        1
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .sp
@@ -1631,17 +2279,44 @@ Execution example:
 .nf
 .ft C
 > table_create \-\-name GeoIndex \-\-flags TABLE_PAT_KEY \-\-key_type WGS84GeoPoint
-[[0,1317212840.20962,0.088534001],true]
+[[0,1335519634.07459,0.00024867057800293],true]
 > column_create \-\-table GeoIndex \-\-name index_point \-\-type Site \-\-flags COLUMN_INDEX \-\-source location
-[[0,1317212840.49869,0.093704431],true]
+[[0,1335519634.2754,0.00743818283081055],true]
 > load \-\-table Site
 > [
 >  {"_key":"http://example.org/","location":"128452975x503157902"},
 >  {"_key":"http://example.net/","location":"128487316x502920929"}
 > ]
-[[0,1317212840.79332,0.801438285],2]
+[[0,1335519634.48372,0.801371812820435],2]
 > select \-\-table Site \-\-filter \(aqgeo_in_circle(location, "128515259x503187188", 5000)\(aq \-\-output_columns _key,location
-[[0,1317212841.79563,0.000626003],[[[1],[["_key","ShortText"],["location","WGS84GeoPoint"]],["http://example.org/","128452975x503157902"]]]]
+[
+  [
+    0,
+    1335519635.48562,
+    0.000363826751708984
+  ],
+  [
+    [
+      [
+        1
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "location",
+          "WGS84GeoPoint"
+        ]
+      ],
+      [
+        "http://example.org/",
+        "128452975x503157902"
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .sp
@@ -1652,7 +2327,44 @@ Execution example:
 .nf
 .ft C
 > select \-\-table Site \-\-filter \(aqgeo_in_circle(location, "128515259x503187188", 50000)\(aq \-\-output_columns _key,location,_score \-\-sortby \(aq\-geo_distance(location, "128515259x503187188")\(aq \-\-scorer \(aq_score = geo_distance(location, "128515259x503187188")\(aq
-[[0,1317212841.99878,0.0011657],[[[2],[["_key","ShortText"],["location","WGS84GeoPoint"],["_score","Int32"]],["http://example.org/","128452975x503157902",2054],["http://example.net/","128487316x502920929",6720]]]]
+[
+  [
+    0,
+    1335519635.68736,
+    0.000502824783325195
+  ],
+  [
+    [
+      [
+        2
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "location",
+          "WGS84GeoPoint"
+        ],
+        [
+          "_score",
+          "Int32"
+        ]
+      ],
+      [
+        "http://example.org/",
+        "128452975x503157902",
+        2054
+      ],
+      [
+        "http://example.net/",
+        "128487316x502920929",
+        6720
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .SS match_columnsパラメータ
@@ -1671,24 +2383,24 @@ Execution example:
 .nf
 .ft C
 > table_create \-\-name Blog1 \-\-flags TABLE_HASH_KEY \-\-key_type ShortText
-[[0,1317212795.41036,0.047939793],true]
+[[0,1335519613.90326,0.00016021728515625],true]
 > column_create \-\-table Blog1 \-\-name title \-\-flags COLUMN_SCALAR \-\-type ShortText
-[[0,1317212795.65884,0.040658195],true]
+[[0,1335519614.10411,0.00106573104858398],true]
 > column_create \-\-table Blog1 \-\-name message \-\-flags COLUMN_SCALAR \-\-type ShortText
-[[0,1317212795.89978,0.029458384],true]
+[[0,1335519614.30595,0.00101113319396973],true]
 > table_create \-\-name IndexBlog1 \-\-flags TABLE_PAT_KEY|KEY_NORMALIZE \-\-key_type ShortText \-\-default_tokenizer TokenBigram
-[[0,1317212796.12974,0.183567683],true]
+[[0,1335519614.50779,0.000327587127685547],true]
 > column_create \-\-table IndexBlog1 \-\-name index_title \-\-flags COLUMN_INDEX|WITH_POSITION \-\-type Blog1 \-\-source title
-[[0,1317212796.51381,0.092148792],true]
+[[0,1335519614.70891,0.00641822814941406],true]
 > column_create \-\-table IndexBlog1 \-\-name index_message \-\-flags COLUMN_INDEX|WITH_POSITION \-\-type Blog1 \-\-source message
-[[0,1317212796.80646,0.088690675],true]
+[[0,1335519614.91621,0.00670051574707031],true]
 > load \-\-table Blog1
 > [
 > {"_key":"grn1","title":"groonga test","message":"groonga message"},
 > {"_key":"grn2","title":"baseball result","message":"rakutan eggs 4 \- 4 groonga moritars"},
 > {"_key":"grn3","title":"groonga message","message":"none"}
 > ]
-[[0,1317212797.09575,1.001254761],3]
+[[0,1335519615.1238,1.00167393684387],3]
 .ft P
 .fi
 .sp
@@ -1701,11 +2413,140 @@ Execution example:
 .nf
 .ft C
 > select \-\-table Blog1 \-\-match_columns title||message \-\-query groonga
-[[0,1317212798.29761,0.000365318],[[[3],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"],["message","ShortText"]],[1,"grn1","groonga test","groonga message"],[3,"grn3","groonga message","none"],[2,"grn2","baseball result","rakutan eggs 4 \- 4 groonga moritars"]]]]
+[
+  [
+    0,
+    1335519616.32664,
+    0.00108003616333008
+  ],
+  [
+    [
+      [
+        3
+      ],
+      [
+        [
+          "_id",
+          "UInt32"
+        ],
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "message",
+          "ShortText"
+        ],
+        [
+          "title",
+          "ShortText"
+        ]
+      ],
+      [
+        1,
+        "grn1",
+        "groonga message",
+        "groonga test"
+      ],
+      [
+        3,
+        "grn3",
+        "none",
+        "groonga message"
+      ],
+      [
+        2,
+        "grn2",
+        "rakutan eggs 4 \- 4 groonga moritars",
+        "baseball result"
+      ]
+    ]
+  ]
+]
 > select \-\-table Blog1 \-\-match_columns title||message \-\-query message
-[[0,1317212798.49954,0.000310648],[[[2],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"],["message","ShortText"]],[3,"grn3","groonga message","none"],[1,"grn1","groonga test","groonga message"]]]]
+[
+  [
+    0,
+    1335519616.5306,
+    0.000397920608520508
+  ],
+  [
+    [
+      [
+        2
+      ],
+      [
+        [
+          "_id",
+          "UInt32"
+        ],
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "message",
+          "ShortText"
+        ],
+        [
+          "title",
+          "ShortText"
+        ]
+      ],
+      [
+        3,
+        "grn3",
+        "none",
+        "groonga message"
+      ],
+      [
+        1,
+        "grn1",
+        "groonga message",
+        "groonga test"
+      ]
+    ]
+  ]
+]
 > select \-\-table Blog1 \-\-match_columns title \-\-query message
-[[0,1317212798.70102,0.000314581],[[[1],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"],["message","ShortText"]],[3,"grn3","groonga message","none"]]]]
+[
+  [
+    0,
+    1335519616.73219,
+    0.000369548797607422
+  ],
+  [
+    [
+      [
+        1
+      ],
+      [
+        [
+          "_id",
+          "UInt32"
+        ],
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "message",
+          "ShortText"
+        ],
+        [
+          "title",
+          "ShortText"
+        ]
+      ],
+      [
+        3,
+        "grn3",
+        "none",
+        "groonga message"
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .SS 複数のカラムにまたがったインデックスを付与する場合
@@ -1719,22 +2560,22 @@ Execution example:
 .nf
 .ft C
 > table_create \-\-name Blog2 \-\-flags TABLE_HASH_KEY \-\-key_type ShortText
-[[0,1317212798.90253,0.052986511],true]
+[[0,1335519616.93386,0.000204801559448242],true]
 > column_create \-\-table Blog2 \-\-name title \-\-flags COLUMN_SCALAR \-\-type ShortText
-[[0,1317212799.156,0.028355347],true]
+[[0,1335519617.13462,0.000517606735229492],true]
 > column_create \-\-table Blog2 \-\-name message \-\-flags COLUMN_SCALAR \-\-type ShortText
-[[0,1317212799.38486,0.040142104],true]
+[[0,1335519617.33589,0.000973939895629883],true]
 > table_create \-\-name IndexBlog2 \-\-flags TABLE_PAT_KEY|KEY_NORMALIZE \-\-key_type ShortText \-\-default_tokenizer TokenBigram
-[[0,1317212799.62539,0.039673533],true]
+[[0,1335519617.53761,0.000263690948486328],true]
 > column_create \-\-table IndexBlog2 \-\-name index_blog \-\-flags COLUMN_INDEX|WITH_POSITION|WITH_SECTION \-\-type Blog2 \-\-source title,message
-[[0,1317212799.86551,0.079790187],true]
+[[0,1335519617.73843,0.00370573997497559],true]
 > load \-\-table Blog2
 > [
 > {"_key":"grn1","title":"groonga test","message":"groonga message"},
 > {"_key":"grn2","title":"baseball result","message":"rakutan eggs 4 \- 4 groonga moritars"},
 > {"_key":"grn3","title":"groonga message","message":"none"}
 > ]
-[[0,1317212800.14589,1.001367315],3]
+[[0,1335519617.94267,1.00162434577942],3]
 .ft P
 .fi
 .sp
@@ -1745,11 +2586,140 @@ Execution example:
 .nf
 .ft C
 > select \-\-table Blog2 \-\-match_columns title||message \-\-query groonga
-[[0,1317212801.34801,0.000328232],[[[3],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"],["message","ShortText"]],[1,"grn1","groonga test","groonga message"],[2,"grn2","baseball result","rakutan eggs 4 \- 4 groonga moritars"],[3,"grn3","groonga message","none"]]]]
+[
+  [
+    0,
+    1335519619.14503,
+    0.000397443771362305
+  ],
+  [
+    [
+      [
+        3
+      ],
+      [
+        [
+          "_id",
+          "UInt32"
+        ],
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "message",
+          "ShortText"
+        ],
+        [
+          "title",
+          "ShortText"
+        ]
+      ],
+      [
+        1,
+        "grn1",
+        "groonga message",
+        "groonga test"
+      ],
+      [
+        2,
+        "grn2",
+        "rakutan eggs 4 \- 4 groonga moritars",
+        "baseball result"
+      ],
+      [
+        3,
+        "grn3",
+        "none",
+        "groonga message"
+      ]
+    ]
+  ]
+]
 > select \-\-table Blog2 \-\-match_columns title||message \-\-query message
-[[0,1317212801.54962,0.000320935],[[[2],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"],["message","ShortText"]],[1,"grn1","groonga test","groonga message"],[3,"grn3","groonga message","none"]]]]
+[
+  [
+    0,
+    1335519619.34666,
+    0.000356435775756836
+  ],
+  [
+    [
+      [
+        2
+      ],
+      [
+        [
+          "_id",
+          "UInt32"
+        ],
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "message",
+          "ShortText"
+        ],
+        [
+          "title",
+          "ShortText"
+        ]
+      ],
+      [
+        1,
+        "grn1",
+        "groonga message",
+        "groonga test"
+      ],
+      [
+        3,
+        "grn3",
+        "none",
+        "groonga message"
+      ]
+    ]
+  ]
+]
 > select \-\-table Blog2 \-\-match_columns title \-\-query message
-[[0,1317212801.75107,0.000323124],[[[1],[["_id","UInt32"],["_key","ShortText"],["title","ShortText"],["message","ShortText"]],[3,"grn3","groonga message","none"]]]]
+[
+  [
+    0,
+    1335519619.54817,
+    0.000360250473022461
+  ],
+  [
+    [
+      [
+        1
+      ],
+      [
+        [
+          "_id",
+          "UInt32"
+        ],
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "message",
+          "ShortText"
+        ],
+        [
+          "title",
+          "ShortText"
+        ]
+      ],
+      [
+        3,
+        "grn3",
+        "none",
+        "groonga message"
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .SS インデックス名を指定した全文検索
@@ -1770,16 +2740,47 @@ Execution example:
 .nf
 .ft C
 > table_create \-\-name PatPrefix \-\-flags TABLE_PAT_KEY \-\-key_type ShortText
-[[0,1317212719.34619,0.047490604],true]
+[[0,1335519594.52747,0.000475168228149414],true]
 > load \-\-table PatPrefix
 > [
 > {"_key":"ひろゆき"},
 > {"_key":"まろゆき"},
 > {"_key":"ひろあき"}
 > ]
-[[0,1317212719.59456,1.001406593],3]
+[[0,1335519594.72892,1.00176382064819],3]
 > select \-\-table PatPrefix \-\-query _key:@ひろ
-[[0,1317212720.79648,0.00031203],[[[2],[["_id","UInt32"],["_key","ShortText"]],[3,"ひろあき"],[1,"ひろゆき"]]]]
+[
+  [
+    0,
+    1335519595.93126,
+    0.00059962272644043
+  ],
+  [
+    [
+      [
+        2
+      ],
+      [
+        [
+          "_id",
+          "UInt32"
+        ],
+        [
+          "_key",
+          "ShortText"
+        ]
+      ],
+      [
+        3,
+        "ひろあき"
+      ],
+      [
+        1,
+        "ひろゆき"
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .SS 主キーによる後方一致検索
@@ -1795,20 +2796,104 @@ Execution example:
 .nf
 .ft C
 > table_create \-\-name PatSuffix \-\-flags TABLE_PAT_KEY|KEY_WITH_SIS \-\-key_type ShortText
-[[0,1317212720.99778,0.0531648179999999],true]
+[[0,1335519596.13342,0.000287294387817383],true]
 > column_create \-\-table PatSuffix \-\-name original \-\-type Bool
-[[0,1317212721.25163,0.099479727],true]
+[[0,1335519596.33446,0.000329494476318359],true]
 > load \-\-table PatSuffix
 > [
 > {"_key":"ひろゆき","original":true},
 > {"_key":"まろゆき","original":true},
 > {"_key":"ひろあき","original":true}
 > ]
-[[0,1317212721.55167,1.001449341],3]
+[[0,1335519596.53576,1.00176548957825],3]
 > select \-\-table PatSuffix \-\-query _key:@ゆき
-[[0,1317212722.75369,0.000313623],[[[4],[["_id","UInt32"],["_key","ShortText"],["original","Bool"]],[1,"ひろゆき",true],[5,"まろゆき",true],[3,"ゆき",false],[2,"ろゆき",false]]]]
+[
+  [
+    0,
+    1335519597.73837,
+    0.000630855560302734
+  ],
+  [
+    [
+      [
+        4
+      ],
+      [
+        [
+          "_id",
+          "UInt32"
+        ],
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "original",
+          "Bool"
+        ]
+      ],
+      [
+        1,
+        "ひろゆき",
+        true
+      ],
+      [
+        5,
+        "まろゆき",
+        true
+      ],
+      [
+        3,
+        "ゆき",
+        false
+      ],
+      [
+        2,
+        "ろゆき",
+        false
+      ]
+    ]
+  ]
+]
 > select \-\-table PatSuffix \-\-query "_key:@ゆき original:true"
-[[0,1317212722.95502,0.00032577],[[[2],[["_id","UInt32"],["_key","ShortText"],["original","Bool"]],[1,"ひろゆき",true],[5,"まろゆき",true]]]]
+[
+  [
+    0,
+    1335519597.94114,
+    0.000690460205078125
+  ],
+  [
+    [
+      [
+        2
+      ],
+      [
+        [
+          "_id",
+          "UInt32"
+        ],
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "original",
+          "Bool"
+        ]
+      ],
+      [
+        1,
+        "ひろゆき",
+        true
+      ],
+      [
+        5,
+        "まろゆき",
+        true
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .SS 全文検索の語彙表に対する追加情報
@@ -2063,7 +3148,38 @@ Execution example:
 .nf
 .ft C
 > select \-\-table Users \-\-match_columns name,location_str,description \-\-query 東京 \-\-output_columns _key,name
-[[0,1317212781.80175,0.000302755],[[[2],[["_key","ShortText"],["name","ShortText"]],["tasukuchan","グニャラくん"],["OffGao","OffGao"]]]]
+[
+  [
+    0,
+    1335519659.99711,
+    0.000482797622680664
+  ],
+  [
+    [
+      [
+        2
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "name",
+          "ShortText"
+        ]
+      ],
+      [
+        "tasukuchan",
+        "グニャラくん"
+      ],
+      [
+        "OffGao",
+        "OffGao"
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .sp
@@ -2078,7 +3194,38 @@ Execution example:
 .nf
 .ft C
 > select \-\-table Users \-\-filter \(aqgeo_in_circle(location,"128484216x502919856",5000)\(aq \-\-output_columns _key,name
-[[0,1317212782.00321,0.000241271],[[[2],[["_key","ShortText"],["name","ShortText"]],["tasukuchan","グニャラくん"],["OffGao","OffGao"]]]]
+[
+  [
+    0,
+    1335519660.19891,
+    0.000342607498168945
+  ],
+  [
+    [
+      [
+        2
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "name",
+          "ShortText"
+        ]
+      ],
+      [
+        "tasukuchan",
+        "グニャラくん"
+      ],
+      [
+        "OffGao",
+        "OffGao"
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .sp
@@ -2093,7 +3240,38 @@ Execution example:
 .nf
 .ft C
 > select \-\-table Users \-\-query follower:@tasukuchan \-\-output_columns _key,name
-[[0,1317212782.20472,0.000231885],[[[2],[["_key","ShortText"],["name","ShortText"]],["daijiro","hsiomaneki"],["OffGao","OffGao"]]]]
+[
+  [
+    0,
+    1335519660.40055,
+    0.000302791595458984
+  ],
+  [
+    [
+      [
+        2
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "name",
+          "ShortText"
+        ]
+      ],
+      [
+        "daijiro",
+        "hsiomaneki"
+      ],
+      [
+        "OffGao",
+        "OffGao"
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .sp
@@ -2108,7 +3286,92 @@ Execution example:
 .nf
 .ft C
 > select \-\-table Comments \-\-filter \(aqgeo_in_circle(location,"127975798x502919856",20000)\(aq \-\-output_columns posted_by.name,comment \-\-drilldown hash_tags,posted_by
-[[0,1317212782.40617,0.000451828],[[[4],[["posted_by.name","ShortText"],["comment","ShortText"]],["OffGao","@daijiro @tasukuchan 登録してみましたよー！"],["グニャラくん","groongaなう #groonga"],["グニャラくん","groonga開発合宿のため羽田空港に来ました！ #groonga #travel"],["OffGao","中野ブロードウェイなうなう"]],[[2],[["_key","ShortText"],["_nsubrecs","Int32"]],["groonga",2],["travel",1]],[[2],[["_key","ShortText"],["_nsubrecs","Int32"]],["OffGao",2],["tasukuchan",2]]]]
+[
+  [
+    0,
+    1335519660.60211,
+    0.00048828125
+  ],
+  [
+    [
+      [
+        4
+      ],
+      [
+        [
+          "posted_by.name",
+          "ShortText"
+        ],
+        [
+          "comment",
+          "ShortText"
+        ]
+      ],
+      [
+        "OffGao",
+        "@daijiro @tasukuchan 登録してみましたよー！"
+      ],
+      [
+        "グニャラくん",
+        "groongaなう #groonga"
+      ],
+      [
+        "グニャラくん",
+        "groonga開発合宿のため羽田空港に来ました！ #groonga #travel"
+      ],
+      [
+        "OffGao",
+        "中野ブロードウェイなうなう"
+      ]
+    ],
+    [
+      [
+        2
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "_nsubrecs",
+          "Int32"
+        ]
+      ],
+      [
+        "groonga",
+        2
+      ],
+      [
+        "travel",
+        1
+      ]
+    ],
+    [
+      [
+        2
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "_nsubrecs",
+          "Int32"
+        ]
+      ],
+      [
+        "OffGao",
+        2
+      ],
+      [
+        "tasukuchan",
+        2
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .sp
@@ -2123,7 +3386,38 @@ Execution example:
 .nf
 .ft C
 > select \-\-table Comments \-\-query comment:@なう \-\-output_columns comment,_score
-[[0,1317212782.60919,0.000239996],[[[2],[["comment","ShortText"],["_score","Int32"]],["groongaなう #groonga",1],["中野ブロードウェイなうなう",2]]]]
+[
+  [
+    0,
+    1335519660.80493,
+    0.000359296798706055
+  ],
+  [
+    [
+      [
+        2
+      ],
+      [
+        [
+          "comment",
+          "ShortText"
+        ],
+        [
+          "_score",
+          "Int32"
+        ]
+      ],
+      [
+        "groongaなう #groonga",
+        1
+      ],
+      [
+        "中野ブロードウェイなうなう",
+        2
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .sp
@@ -2137,7 +3431,76 @@ Execution example:
 .nf
 .ft C
 > select \-\-table Comments \-\-query comment:@羽田 \-\-filter \(aqgeo_in_circle(location,"127975798x502919856",20000)\(aq \-\-output_columns posted_by.name,comment \-\-drilldown hash_tags,posted_by
-[[0,1317212782.81082,0.000427163],[[[1],[["posted_by.name","ShortText"],["comment","ShortText"]],["グニャラくん","groonga開発合宿のため羽田空港に来ました！ #groonga #travel"]],[[2],[["_key","ShortText"],["_nsubrecs","Int32"]],["groonga",1],["travel",1]],[[1],[["_key","ShortText"],["_nsubrecs","Int32"]],["tasukuchan",1]]]]
+[
+  [
+    0,
+    1335519661.00659,
+    0.000471353530883789
+  ],
+  [
+    [
+      [
+        1
+      ],
+      [
+        [
+          "posted_by.name",
+          "ShortText"
+        ],
+        [
+          "comment",
+          "ShortText"
+        ]
+      ],
+      [
+        "グニャラくん",
+        "groonga開発合宿のため羽田空港に来ました！ #groonga #travel"
+      ]
+    ],
+    [
+      [
+        2
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "_nsubrecs",
+          "Int32"
+        ]
+      ],
+      [
+        "groonga",
+        1
+      ],
+      [
+        "travel",
+        1
+      ]
+    ],
+    [
+      [
+        1
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "_nsubrecs",
+          "Int32"
+        ]
+      ],
+      [
+        "tasukuchan",
+        1
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .sp
@@ -2152,7 +3515,57 @@ Execution example:
 .nf
 .ft C
 > select \-\-table Comments \-\-query hash_tags:@groonga \-\-output_columns posted_by.name,comment \-\-drilldown posted_by
-[[0,1317212783.01379,0.000311974],[[[2],[["posted_by.name","ShortText"],["comment","ShortText"]],["グニャラくん","groongaなう #groonga"],["グニャラくん","groonga開発合宿のため羽田空港に来ました！ #groonga #travel"]],[[1],[["_key","ShortText"],["_nsubrecs","Int32"]],["tasukuchan",2]]]]
+[
+  [
+    0,
+    1335519661.2089,
+    0.000585079193115234
+  ],
+  [
+    [
+      [
+        2
+      ],
+      [
+        [
+          "posted_by.name",
+          "ShortText"
+        ],
+        [
+          "comment",
+          "ShortText"
+        ]
+      ],
+      [
+        "グニャラくん",
+        "groongaなう #groonga"
+      ],
+      [
+        "グニャラくん",
+        "groonga開発合宿のため羽田空港に来ました！ #groonga #travel"
+      ]
+    ],
+    [
+      [
+        1
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "_nsubrecs",
+          "Int32"
+        ]
+      ],
+      [
+        "tasukuchan",
+        2
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .sp
@@ -2166,7 +3579,61 @@ Execution example:
 .nf
 .ft C
 > select \-\-table Comments \-\-query posted_by:tasukuchan \-\-output_columns comment \-\-drilldown hash_tags
-[[0,1317212783.21601,0.000313114],[[[4],[["comment","ShortText"]],["初の書き込み。テストテスト。"],["@daijiro ありがとう！"],["groongaなう #groonga"],["groonga開発合宿のため羽田空港に来ました！ #groonga #travel"]],[[2],[["_key","ShortText"],["_nsubrecs","Int32"]],["groonga",2],["travel",1]]]]
+[
+  [
+    0,
+    1335519661.41271,
+    0.000678777694702148
+  ],
+  [
+    [
+      [
+        4
+      ],
+      [
+        [
+          "comment",
+          "ShortText"
+        ]
+      ],
+      [
+        "初の書き込み。テストテスト。"
+      ],
+      [
+        "@daijiro ありがとう！"
+      ],
+      [
+        "groongaなう #groonga"
+      ],
+      [
+        "groonga開発合宿のため羽田空港に来ました！ #groonga #travel"
+      ]
+    ],
+    [
+      [
+        2
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "_nsubrecs",
+          "Int32"
+        ]
+      ],
+      [
+        "groonga",
+        2
+      ],
+      [
+        "travel",
+        1
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .sp
@@ -2180,7 +3647,40 @@ Execution example:
 .nf
 .ft C
 > select \-\-table Users \-\-query _key:tasukuchan \-\-output_columns favorites.posted_by,favorites.comment
-[[0,1317212783.41809,0.000257979],[[[1],[["favorites.posted_by","Users"],["favorites.comment","ShortText"]],[["daijiro","OffGao"],["マイクロブログ作ってみました（甘栗むいちゃいました的な感じで）。","@daijiro @tasukuchan 登録してみましたよー！"]]]]]
+[
+  [
+    0,
+    1335519661.61696,
+    0.000443696975708008
+  ],
+  [
+    [
+      [
+        1
+      ],
+      [
+        [
+          "favorites.posted_by",
+          "Users"
+        ],
+        [
+          "favorites.comment",
+          "ShortText"
+        ]
+      ],
+      [
+        [
+          "daijiro",
+          "OffGao"
+        ],
+        [
+          "マイクロブログ作ってみました（甘栗むいちゃいました的な感じで）。",
+          "@daijiro @tasukuchan 登録してみましたよー！"
+        ]
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .sp
@@ -2195,7 +3695,101 @@ Execution example:
 .nf
 .ft C
 > select Comments \-\-filter \(aqlast_modified<=1268802000\(aq \-\-output_columns posted_by.name,comment,last_modified \-\-drilldown hash_tags,posted_by
-[[0,1317212783.61997,0.000426254],[[[5],[["posted_by.name","ShortText"],["comment","ShortText"],["last_modified","Time"]],["hsiomaneki","マイクロブログ作ってみました（甘栗むいちゃいました的な感じで）。",1268795100.0],["グニャラくん","初の書き込み。テストテスト。",1268794800.0],["hsiomaneki","@tasukuchan ようこそ!!!",1268795100.0],["グニャラくん","@daijiro ありがとう！",1268798400.0],["グニャラくん","groongaなう #groonga",1268802000.0]],[[1],[["_key","ShortText"],["_nsubrecs","Int32"]],["groonga",1]],[[2],[["_key","ShortText"],["_nsubrecs","Int32"]],["daijiro",2],["tasukuchan",3]]]]
+[
+  [
+    0,
+    1335519661.82081,
+    0.000457286834716797
+  ],
+  [
+    [
+      [
+        5
+      ],
+      [
+        [
+          "posted_by.name",
+          "ShortText"
+        ],
+        [
+          "comment",
+          "ShortText"
+        ],
+        [
+          "last_modified",
+          "Time"
+        ]
+      ],
+      [
+        "hsiomaneki",
+        "マイクロブログ作ってみました（甘栗むいちゃいました的な感じで）。",
+        1268795100.0
+      ],
+      [
+        "グニャラくん",
+        "初の書き込み。テストテスト。",
+        1268794800.0
+      ],
+      [
+        "hsiomaneki",
+        "@tasukuchan ようこそ!!!",
+        1268795100.0
+      ],
+      [
+        "グニャラくん",
+        "@daijiro ありがとう！",
+        1268798400.0
+      ],
+      [
+        "グニャラくん",
+        "groongaなう #groonga",
+        1268802000.0
+      ]
+    ],
+    [
+      [
+        1
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "_nsubrecs",
+          "Int32"
+        ]
+      ],
+      [
+        "groonga",
+        1
+      ]
+    ],
+    [
+      [
+        2
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "_nsubrecs",
+          "Int32"
+        ]
+      ],
+      [
+        "daijiro",
+        2
+      ],
+      [
+        "tasukuchan",
+        3
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .sp
@@ -2218,29 +3812,29 @@ Execution example:
 .nf
 .ft C
 > table_create Doc TABLE_PAT_KEY ShortText
-[[0,1317212801.95257,0.054058921],true]
+[[0,1335519662.68773,0.000400543212890625],true]
 > column_create Doc body COLUMN_SCALAR ShortText
-[[0,1317212802.2071,0.040301713],true]
+[[0,1335519662.88919,0.000899314880371094],true]
 > table_create Term TABLE_PAT_KEY|KEY_NORMALIZE ShortText \-\-default_tokenizer TokenBigram
-[[0,1317212802.44812,0.027340933],true]
+[[0,1335519663.09089,0.000370979309082031],true]
 > column_create Term Doc_body COLUMN_INDEX|WITH_POSITION Doc body
-[[0,1317212802.676,0.079743674],true]
+[[0,1335519663.29217,0.00676441192626953],true]
 > table_create Synonym TABLE_PAT_KEY ShortText
-[[0,1317212802.95629,0.03656858],true]
+[[0,1335519663.4998,0.000351667404174805],true]
 > column_create Synonym body COLUMN_SCALAR ShortText
-[[0,1317212803.19316,0.040515932],true]
+[[0,1335519663.70094,0.000846624374389648],true]
 > load \-\-table Doc
 > [
 > {"_key": "001", "body": "すっぱいブドウと甘いシークァーサー"},
 > {"_key": "002", "body": "シークヮーサージュースとゴーヤチャンプル"},
 > ]
-[[0,1317212803.43422,0.80056314],2]
+[[0,1335519663.90262,0.801640033721924],2]
 > load \-\-table Synonym
 > [
 > {"_key": "シークァーサー", "body": "(シークァーサー OR シークヮーサー)"},
 > {"_key": "シークヮーサー", "body": "(シークァーサー OR シークヮーサー)"},
 > ]
-[[0,1317212804.43524,0.801037492],2]
+[[0,1335519664.905,0.801484823226929],2]
 .ft P
 .fi
 .sp
@@ -2254,9 +3848,73 @@ Execution example:
 .nf
 .ft C
 > select Doc \-\-match_columns body \-\-query "シークァーサー"
-[[0,1317212805.4371,0.000567851],[[[1],[["_id","UInt32"],["_key","ShortText"],["body","ShortText"]],[1,"001","すっぱいブドウと甘いシークァーサー"]]]]
+[
+  [
+    0,
+    1335519665.90753,
+    0.000537633895874023
+  ],
+  [
+    [
+      [
+        1
+      ],
+      [
+        [
+          "_id",
+          "UInt32"
+        ],
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "body",
+          "ShortText"
+        ]
+      ],
+      [
+        1,
+        "001",
+        "すっぱいブドウと甘いシークァーサー"
+      ]
+    ]
+  ]
+]
 > select Doc \-\-match_columns body \-\-query "シークヮーサー"
-[[0,1317212805.63859,0.000387831],[[[1],[["_id","UInt32"],["_key","ShortText"],["body","ShortText"]],[2,"002","シークヮーサージュースとゴーヤチャンプル"]]]]
+[
+  [
+    0,
+    1335519666.10912,
+    0.000688791275024414
+  ],
+  [
+    [
+      [
+        1
+      ],
+      [
+        [
+          "_id",
+          "UInt32"
+        ],
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "body",
+          "ShortText"
+        ]
+      ],
+      [
+        2,
+        "002",
+        "シークヮーサージュースとゴーヤチャンプル"
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .sp
@@ -2267,9 +3925,83 @@ Execution example:
 .nf
 .ft C
 > select Doc \-\-match_columns body \-\-query "シークァーサー" \-\-query_expansion Synonym.body
-[[0,1317212805.84016,0.000441852],[[[2],[["_id","UInt32"],["_key","ShortText"],["body","ShortText"]],[1,"001","すっぱいブドウと甘いシークァーサー"],[2,"002","シークヮーサージュースとゴーヤチャンプル"]]]]
+[
+  [
+    0,
+    1335519666.31137,
+    0.000792741775512695
+  ],
+  [
+    [
+      [
+        2
+      ],
+      [
+        [
+          "_id",
+          "UInt32"
+        ],
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "body",
+          "ShortText"
+        ]
+      ],
+      [
+        1,
+        "001",
+        "すっぱいブドウと甘いシークァーサー"
+      ],
+      [
+        2,
+        "002",
+        "シークヮーサージュースとゴーヤチャンプル"
+      ]
+    ]
+  ]
+]
 > select Doc \-\-match_columns body \-\-query "シークヮーサー" \-\-query_expansion Synonym.body
-[[0,1317212806.04176,0.000580261],[[[2],[["_id","UInt32"],["_key","ShortText"],["body","ShortText"]],[1,"001","すっぱいブドウと甘いシークァーサー"],[2,"002","シークヮーサージュースとゴーヤチャンプル"]]]]
+[
+  [
+    0,
+    1335519666.51486,
+    0.000669717788696289
+  ],
+  [
+    [
+      [
+        2
+      ],
+      [
+        [
+          "_id",
+          "UInt32"
+        ],
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "body",
+          "ShortText"
+        ]
+      ],
+      [
+        1,
+        "001",
+        "すっぱいブドウと甘いシークァーサー"
+      ],
+      [
+        2,
+        "002",
+        "シークヮーサージュースとゴーヤチャンプル"
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .sp
@@ -2668,7 +4400,34 @@ Execution example:
 .nf
 .ft C
 > suggest \-\-table item_query \-\-column kana \-\-types complete \-\-frequency_threshold 1 \-\-query en
-[[0,1317212704.42103,0.001348612],{"complete":[[1],[["_key","ShortText"],["_score","Int32"]],["engine",1]]}]
+[
+  [
+    0,
+    1335519580.61411,
+    0.00101041793823242
+  ],
+  {
+    "complete": [
+      [
+        1
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "_score",
+          "Int32"
+        ]
+      ],
+      [
+        "engine",
+        1
+      ]
+    ]
+  }
+]
 .ft P
 .fi
 .SS How it learns
@@ -2836,7 +4595,34 @@ Execution example:
 .nf
 .ft C
 > suggest \-\-table item_query \-\-column kana \-\-types correction \-\-frequency_threshold 1 \-\-query saerch
-[[0,1317212708.7696,0.000882462],{"correct":[[1],[["_key","ShortText"],["_score","Int32"]],["search",1]]}]
+[
+  [
+    0,
+    1335519584.34144,
+    0.000605106353759766
+  ],
+  {
+    "correct": [
+      [
+        1
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "_score",
+          "Int32"
+        ]
+      ],
+      [
+        "search",
+        1
+      ]
+    ]
+  }
+]
 .ft P
 .fi
 .SS How it learns
@@ -3014,7 +4800,38 @@ Execution example:
 .nf
 .ft C
 > suggest \-\-table item_query \-\-column kana \-\-types suggest \-\-frequency_threshold 1 \-\-query search
-[[0,1317212711.42188,0.000553344],{"suggest":[[2],[["_key","ShortText"],["_score","Int32"]],["search engine",1],["web search realtime",1]]}]
+[
+  [
+    0,
+    1335519581.87931,
+    0.000770807266235352
+  ],
+  {
+    "suggest": [
+      [
+        2
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "_score",
+          "Int32"
+        ]
+      ],
+      [
+        "search engine",
+        1
+      ],
+      [
+        "web search realtime",
+        1
+      ]
+    ]
+  }
+]
 .ft P
 .fi
 .SS How it learns
@@ -5368,138 +7185,640 @@ quit
 .ft P
 .fi
 .SS select
-.SS 名前
+.SS Summary
 .sp
-select \- テーブルの中から条件にマッチするレコードを検索して出力する
-.SS 書式
+\fBselect\fP searches records that are matched to specified conditions
+from a table and then outputs them.
+.sp
+\fBselect\fP is the most important command in groonga. You need to
+understand \fBselect\fP to use the full power of groonga.
+.SS Syntax
+.sp
+\fBselect\fP has many parameters. The required parameter is only
+\fBtable\fP and others are optional:
 .sp
 .nf
 .ft C
-select table [match_columns [query [filter [scorer [sortby [output_columns
-             [offset [limit [drilldown [drilldown_sortby [drilldown_output_columns
-             [drilldown_offset [drilldown_limit [cache
-             [match_escalation_threshold [query_expansion]]]]]]]]]]]]]]]]
+select table
+       [match_columns=null]
+       [query=null]
+       [filter=null]
+       [scorer=null]
+       [sortby=null]
+       [output_columns="_id, _key, *"]
+       [offset=0]
+       [limit=10]
+       [drilldown=null]
+       [drilldown_sortby=null]
+       [drilldown_output_columns=null]
+       [drilldown_offset=0]
+       [drilldown_limit=10]
+       [cache=yes]
+       [match_escalation_threshold=0]
+       [query_expansion=null]
 .ft P
 .fi
-.SS 説明
+.SS Usage
 .sp
-groonga組込コマンドの一つであるselectについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
+Let\(aqs learn about \fBselect\fP usage with examples. This section shows
+many popular usages.
 .sp
-selectは、使用しているデータベースのテーブルの中から条件にマッチするレコードを検索して出力します。
-.SS 引数
+Here are a schema definition and sample data to show usage.
 .sp
-\fBtable\fP
-.INDENT 0.0
-.INDENT 3.5
-検索対象のテーブルを指定します。存在しないテーブルを指定した場合はエラーになります。
-.UNINDENT
-.UNINDENT
+Execution example:
 .sp
-\fBmatch_columns\fP
-.INDENT 0.0
-.INDENT 3.5
-query引数に指定する検索条件文字列でデフォルトの検索対象となるカラムを指定します。
-.INDENT 0.0
-.INDENT 3.5
-カラム名
-.UNINDENT
-.UNINDENT
+.nf
+.ft C
+> table_create Entries TABLE_HASH_KEY ShortText
+[[0,1335594537.43378,0.000381708145141602],true]
+> column_create Entries content COLUMN_SCALAR Text
+[[0,1335594537.63582,0.000931501388549805],true]
+> table_create Terms TABLE_PAT_KEY|KEY_NORMALIZE ShortText \-\-default_tokenizer TokenBigram
+[[0,1335594537.83776,0.000288009643554688],true]
+> column_create Terms entries_key_index COLUMN_INDEX|WITH_POSITION Entries _key
+[[0,1335594538.03901,0.0059964656829834],true]
+> column_create Terms entries_content_index COLUMN_INDEX|WITH_POSITION Entries content
+[[0,1335594538.24584,0.00617790222167969],true]
+> load \-\-table Entries
+> [
+> {"_key": "The first post!", "content": "Welcome! This is my first post!"},
+> {"_key": "Groonga", "content": "I started to use groonga. It\(aqs very fast!"}
+> {"_key": "Mroonga", "content": "I also started to use mroonga. It\(aqs also very fast! Really fast!"}
+> ]
+.ft P
+.fi
 .sp
-カラム名の後ろに\(aq* 数値\(aqを指定することによって、そのカラムにヒットした際のスコアに積算される重みを指定することができます。
-.INDENT 0.0
-.INDENT 3.5
-カラム名 * 重み
-.UNINDENT
-.UNINDENT
+There is a table, \fBEntries\fP, for blog entries. An entry has title
+and content. Title is key of \fBEntries\fP. Content is value of
+\fBEntries.content\fP column.
 .sp
-複数のカラムを\(aq||\(aqで結合して指定することもできます。
-.INDENT 0.0
-.INDENT 3.5
-カラム名1 * 重み1 || カラム名2 * 重み2
-.UNINDENT
-.UNINDENT
+\fBEntries._key\fP column and \fBEntries.content\fP column are indexed
+using \fBTokenBigram\fP tokenizer. So both \fBEntries._key\fP and
+\fBEntries.content\fP are fulltext search ready.
 .sp
-また、カラム名ではなく、検索に使用するインデックス名を指定することもできます。
-.UNINDENT
-.UNINDENT
+OK. The schema and data for examples are ready.
+.SS Simple usage
 .sp
-\fBquery\fP
+Here is the most simple usage with the above shema and data. It outputs
+all records in \fBEntries\fP table.
+.sp
+Execution example:
+.sp
+.nf
+.ft C
+> select Entries
+[
+  [
+    0,
+    1335519592.67133,
+    0.000493049621582031
+  ],
+  [
+    [
+      [
+        3
+      ],
+      [
+        [
+          "_id",
+          "UInt32"
+        ],
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "content",
+          "Text"
+        ]
+      ],
+      [
+        1,
+        "The first post!",
+        "Welcome! This is my first post!"
+      ],
+      [
+        2,
+        "Groonga",
+        "I started to use groonga. It\(aqs very fast!"
+      ],
+      [
+        3,
+        "Mroonga",
+        "I also started to use mroonga. It\(aqs also very fast! Really fast!"
+      ]
+    ]
+  ]
+]
+.ft P
+.fi
+.sp
+Why does the command output all records? There are two reasons. The
+first reason is that the command doesn\(aqt specify any search
+conditions. No search condition means all records are matched. The
+second reason is that the number of all records is 3. \fBselect\fP
+command outputs 10 records at a maximum by default. There are only 3
+records. It is less than 10. So the command outputs all records.
+.SS Search conditions
+.sp
+Search conditions are specified by \fBquery\fP or \fBfilter\fP. You can
+also specify both \fBquery\fP and \fBfilter\fP. It means that selected
+records must be matched against both \fBquery\fP and \fBfilter\fP.
+.SS Search condition: \fBquery\fP
+.sp
+\fBquery\fP is designed for search box in Web page. Imagine a search box
+in google.com. You specify search conditions for \fBquery\fP as space
+separated keywords. For example, \fBsearch engine\fP means a matched
+record should contain two words, \fBsearch\fP and \fBengine\fP.
+.sp
+Normally, \fBquery\fP parameter is used for specifying fulltext search
+conditions. It can be used for non fulltext search conditions but
+\fBfilter\fP is used for the propose.
+.sp
+\fBquery\fP parameter is used with \fBmatch_columns\fP parameter when
+\fBquery\fP parameter is used for specifying fulltext search
+conditions. \fBmatch_columns\fP specifies which columnes and indexes are
+matched against \fBquery\fP.
+.sp
+Here is a simple \fBquery\fP usage example.
+.sp
+Execution example:
+.sp
+.nf
+.ft C
+> select Entries \-\-match_columns content \-\-query fast
+[
+  [
+    0,
+    1335519592.87374,
+    0.000868797302246094
+  ],
+  [
+    [
+      [
+        2
+      ],
+      [
+        [
+          "_id",
+          "UInt32"
+        ],
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "content",
+          "Text"
+        ]
+      ],
+      [
+        2,
+        "Groonga",
+        "I started to use groonga. It\(aqs very fast!"
+      ],
+      [
+        3,
+        "Mroonga",
+        "I also started to use mroonga. It\(aqs also very fast! Really fast!"
+      ]
+    ]
+  ]
+]
+.ft P
+.fi
+.sp
+The \fBselect\fP command searches records that contain a word \fBfast\fP
+in \fBcontent\fP column value from \fBEntries\fP table.
+.sp
+\fBquery\fP has query syntax but its deatils aren\(aqt described here. See
+\fB/spec/query_syntax\fP for datails.
+.SS Search condition: \fBfilter\fP
+.sp
+\fBfilter\fP is designed for complex search conditions. You specify
+search conditions for \fBfilter\fP as ECMAScript like syntax.
+.sp
+Here is a simple \fBfilter\fP usage example.
+.sp
+Execution example:
+.sp
+.nf
+.ft C
+> select Entries \-\-filter \(aqcontent @ "fast" && _key == "Groonga"\(aq
+[
+  [
+    0,
+    1335520300.98383,
+    0.000544071197509766
+  ],
+  [
+    [
+      [
+        1
+      ],
+      [
+        [
+          "_id",
+          "UInt32"
+        ],
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "content",
+          "Text"
+        ]
+      ],
+      [
+        2,
+        "Groonga",
+        "I started to use groonga. It\(aqs very fast!"
+      ]
+    ]
+  ]
+]
+.ft P
+.fi
+.sp
+The \fBselect\fP command searches records that contain a word \fBfast\fP
+in \fBcontent\fP column value and has \fBGroonga\fP as \fB_key\fP from
+\fBEntries\fP table. There are three operators in the command, \fB@\fP,
+\fB&&\fP and \fB==\fP. \fB@\fP is fulltext search operator. \fB&&\fP and
+\fB==\fP are the same as ECMAScript. \fB&&\fP is logical AND operator and
+\fB==\fP is equality operator.
+.sp
+\fBfilter\fP has more operators and syntax like grouping by \fB(...)\fP
+its deatils aren\(aqt described here. See \fB/spec/script_syntax\fP for
+datails.
+.SS Paging
+.sp
+You can specify range of outputted records by \fBoffset\fP and \fBlimit\fP.
+Here is an example to output only the 2nd record.
+.sp
+Execution example:
+.sp
+.nf
+.ft C
+> select Entries \-\-offset 1 \-\-limit 1
+[
+  [
+    0,
+    1335519593.28077,
+    0.000288248062133789
+  ],
+  [
+    [
+      [
+        3
+      ],
+      [
+        [
+          "_id",
+          "UInt32"
+        ],
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "content",
+          "Text"
+        ]
+      ],
+      [
+        2,
+        "Groonga",
+        "I started to use groonga. It\(aqs very fast!"
+      ]
+    ]
+  ]
+]
+.ft P
+.fi
+.sp
+\fBoffset\fP is zero\-origin. \fB\-\-offset 1\fP means output range is
+started from the 2nd record.
+.sp
+\fBlimit\fP specifies the max number of output records. \fB\-\-limit 1\fP
+means the number of output records is 1 at a maximium. If no records
+are matched, \fBselect\fP command outputs no records.
+.SS The total number of records
+.sp
+You can use \fB\-\-limit 0\fP to retrieve the total number of recrods
+without any contents of records.
+.sp
+Execution example:
+.sp
+.nf
+.ft C
+> select Entries \-\-limit 0
+[
+  [
+    0,
+    1335519593.48351,
+    0.000329017639160156
+  ],
+  [
+    [
+      [
+        3
+      ],
+      [
+        [
+          "_id",
+          "UInt32"
+        ],
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "content",
+          "Text"
+        ]
+      ]
+    ]
+  ]
+]
+.ft P
+.fi
+.sp
+\fB\-\-limit 0\fP is also useful for retrieving only the number of matched
+records.
+.SS Parameters
+.sp
+This section describes all parameters. Parameters are categorized.
+.SS Required parameter
+.sp
+There is a required parameter, \fBtable\fP.
+.SS \fBtable\fP
+.sp
+It specifies a table to be searched. \fBtable\fP must be specified.
+.sp
+If nonexistent table is specified, an error is returned.
+.sp
+Execution example:
+.sp
+.nf
+.ft C
+> select Nonexistent
+[
+  [
+    \-22,
+    1335519593.68574,
+    0.000583171844482422,
+    "invalid table name: <Nonexistent>",
+    [
+      [
+        "grn_select",
+        "proc.c",
+        542
+      ]
+    ]
+  ]
+]
+.ft P
+.fi
+.SS Search related parameters
+.sp
+There are search related parameters. Typically, \fBmatch_columns\fP and
+\fBquery\fP parameters are used for implementing a search
+box. \fBfilter\fP parameters is used for implementing complex search
+feature.
+.sp
+If both \fBquery\fP and \fBfilter\fP are specified, selected records must
+be matched against both \fBquery\fP and \fBfilter\fP. If both \fBquery\fP
+and \fBfilter\fP aren\(aqt specified, all records are selected.
+.SS \fBmatch_columns\fP
+.sp
+It specifies the default target column for fulltext search by
+\fBquery\fP parameter value. A target column for fulltext search can be
+specified in \fBquery\fP parameter. The difference between
+\fBmatch_columns\fP and \fBquery\fP is whether weight is supported or
+not. \fBmatch_columns\fP supports weight but \fBquery\fP doesn\(aqt.
+.sp
+Weight is relative importance of target column. A higher weight target
+column gets more hit score rather than a lower weight target column
+when a record is matched by fulltext search. The default weight is 1.
+.sp
+Here is a simple \fBmatch_columns\fP usage example.
+.sp
+Execution example:
+.sp
+.nf
+.ft C
+> select Entries \-\-match_columns content \-\-query fast \-\-output_columns \(aq_key, _score\(aq
+[
+  [
+    0,
+    1335519593.88754,
+    0.000384092330932617
+  ],
+  [
+    [
+      [
+        2
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "_score",
+          "Int32"
+        ]
+      ],
+      [
+        "Groonga",
+        1
+      ],
+      [
+        "Mroonga",
+        2
+      ]
+    ]
+  ]
+]
+.ft P
+.fi
+.sp
+\fB\-\-match_columns content\fP means the default target column for
+fulltext search is \fBcontent\fP column and its weight
+is 1. \fB\-\-output_columns \(aq_key, _score\(aq\fP means that the \fBselect\fP
+command outputs \fB_key\fP value and \fB_score\fP value for matched
+records.
+.sp
+Pay attention to \fB_score\fP value. \fB_score\fP value is the number of
+matched counts against \fBquery\fP parameter value. In the example,
+\fBquery\fP parameter value is \fBfast\fP. The fact that \fB_score\fP value
+is 1 means that \fBfast\fP appers in \fBcontent\fP column only once.  The
+fact that \fB_score\fP value is 2 means that \fBfast\fP appears in
+\fBcontent\fP column twice.
+.sp
+To specify weight, \fBcolumn * weight\fP syntax is used. Here is a
+weight usage example.
+.sp
+Execution example:
+.sp
+.nf
+.ft C
+> select Entries \-\-match_columns \(aqcontent * 2\(aq \-\-query fast \-\-output_columns \(aq_key, _score\(aq
+[
+  [
+    0,
+    1335519594.08917,
+    0.0003814697265625
+  ],
+  [
+    [
+      [
+        2
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "_score",
+          "Int32"
+        ]
+      ],
+      [
+        "Groonga",
+        2
+      ],
+      [
+        "Mroonga",
+        4
+      ]
+    ]
+  ]
+]
+.ft P
+.fi
+.sp
+\fB\-\-match_columns \(aqcontent * 2\(aq\fP means the default target column for
+fulltext search is \fBcontent\fP column and its weight is 2.
+.sp
+Pay attention to \fB_score\fP value. \fB_score\fP value is doubled because
+weight is 2.
+.sp
+You can specify one or more columns as the default target columns for
+fulltext search. If one or more columns are specified, fulltext search
+is done for all columns and scores are accumulated. If one of the
+columns is matched against \fBquery\fP parameter value, the record is
+treated as matched.
+.sp
+To specify one or more columns, \fBcolumn1 * weight1 || column2 *
+weight2 || ...\fP syntax is used. \fB* weight\fP can be omitted. If it is
+omitted, 1 is used for weight. Here is a one or more columns usage
+example.
+.sp
+Execution example:
+.sp
+.nf
+.ft C
+> select Entries \-\-match_columns \(aq_key * 10 || content\(aq \-\-query groonga \-\-output_columns \(aq_key, _score\(aq
+[
+  [
+    0,
+    1335594540.29792,
+    0.000547885894775391
+  ],
+  [
+    [
+      [
+        1
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "_score",
+          "Int32"
+        ]
+      ],
+      [
+        "Groonga",
+        11
+      ]
+    ]
+  ]
+]
+.ft P
+.fi
+.sp
+\fB\-\-match_columns \(aq_key * 10 || content\(aq\fP means the default target
+columns for fulltext search are \fB_key\fP and \fBcontent\fP columns and
+\fB_key\fP column\(aqs weight is 10 and \fBcontent\fP column\(aqs weight
+is 1. This weight allocation means \fB_key\fP column value is more
+important rather than \fBcontent\fP column value. In this example, title
+of blog entry is more important rather thatn content of blog entry.
+.SS \fBquery\fP
+.sp
+TODO: write short description and add example.
+.sp
+See \fB/spec/query_syntax\fP.
+.SS \fBfilter\fP
+.sp
+TODO: write short description and add example.
+.sp
+See \fB/spec/script_syntax\fP.
+.SS Advanced search parameters
+.SS \fBmatch_escalation_threshold\fP
+.sp
+TODO: add example.
+.sp
+It specifies threshold to determine whether search storategy
+escalation is used or not. The threshold is compared against the
+number of matched records. If the number of matched records is equal
+to or less than the threshold, search storategy escalation is
+used. See \fB/spec/search\fP about search storategy escalation.
+.sp
+The default threshold is 0. It means that search storategy escalation
+is used only when no records are matched.
+.sp
+The default threshold can be customized by one of the followings.
 .INDENT 0.0
 .INDENT 3.5
-以下の形式の文字列によって検索条件を指定します。
+.INDENT 0.0
+.IP \(bu 2
+\fB\-\-with\-match\-escalation\-threshold\fP option of configure
+.IP \(bu 2
+\fB\-\-match\-escalation\-threshold\fP option of groogna command
+.IP \(bu 2
+\fBmatch\-escalation\-threshold\fP configuration item in configuration
+file
 .UNINDENT
 .UNINDENT
-.SS 条件式
-.sp
-以下の条件式が使用できます。
-.INDENT 0.0
-.TP
-.B 文字列
-全文検索条件(デフォルト検索対象カラムの値が指定された文字列を含んでいる)
-.TP
-.B "文字列"
-フレーズ検索条件(デフォルト検索対象カラムの値が指定されたフレーズを含んでいる)
-.TP
-.B カラム名:値
-一致条件(カラム値 == 値)
-.TP
-.B カラム名:!値
-不一致条件(カラム値 != 値)
-.TP
-.B カラム名:<値
-比較条件(カラム値 < 値)
-.TP
-.B カラム名:>値
-比較条件(カラム値 > 値)
-.TP
-.B カラム名:<=値
-比較条件(カラム値 <= 値)
-.TP
-.B カラム名:>=値
-比較条件(カラム値 >= 値)
-.TP
-.B カラム名:@文字列
-全文検索条件(カラム値が指定された文字列を含んでいる)
 .UNINDENT
-.SS 結合演算子
+.SS \fBquery_expansion\fP
 .sp
-複数の条件式を結合するために以下の演算子が使用できます。
-.INDENT 0.0
-.TP
-.B a OR b
-論理和(aとbといずれかの条件がマッチする)
-.TP
-.B a + b
-論理積(aとbの両方がマッチする)
-.TP
-.B a \- b
-aにマッチし、bにはマッチしない
-.TP
-.B ( )
-複数の条件をまとめる
-.UNINDENT
+TODO: write in English and add example.
 .sp
-\fBfilter\fP
-.INDENT 0.0
-.INDENT 3.5
-絞り込み条件をscript形式のgrn_expr文字列によって指定します。
+It specifies a column that is used to expand (substitute) \fBquery\fP
+parameter value.
 .sp
-query引数とfilter引数をどちらも指定した場合は、両方の条件を満足するレコードのみがヒットします。どちらも指定しない場合は全件がヒットします。
-.UNINDENT
-.UNINDENT
+query_expansionパラメータには、queryパラメータに指定された文字列を置換(拡張)する条件となるテーブル・カラムを指定します。フォーマットは「${テーブル名}.${カラム名}」となります。指定するテーブルは文字列を主キーとするハッシュ型あるいはパトリシア木型のテーブルで、一つ以上の文字列型のカラムが定義されている必要があります。(ここでは置換テーブルと呼びます。)
 .sp
-\fBscorer\fP
-.INDENT 0.0
-.INDENT 3.5
-検索条件にマッチする全てのレコードに対して適用するgrn_exprをscript形式で指定します。
+queryパラメータに指定された文字列が、指定されたテーブルの主キーと完全一致する場合、その文字列を指定されたカラム値の文字列に置換します。queryパラメータが、空白、括弧、演算子などを含む場合は、その演算子によって区切られた文字列の単位で置換が実行されます。ダブルクォート("")で括られた範囲は、その内部に空白を含んでいても一つの置換される単位と見なされます。検索文字列と置換テーブルの主キー値との比較に際して大文字小文字等を区別したくない場合には、置換テーブルを定義する際にKEY_NORMALIZEを指定します。置換後の文字列となるカラムの値には、括弧や*, ORなど、queryパラメータで利用可能な全ての演算子を指定することができます。
+.SS Output related parameters
+.SS \fBoutput_columns\fP
 .sp
-scorerは、検索処理が完了し、ソート処理が実行される前に呼び出されます。従って、各レコードのスコアを操作する式を指定しておけば、検索結果のソート順序をカスタマイズできるようになります。
-.UNINDENT
-.UNINDENT
+TODO: write in English and add example.
+.sp
+出力するカラム名のリストをカンマ(\(aq,\(aq)区切りで指定します。
+.sp
+アスタリスク(\(aq*\(aq)を指定すると、全てのカラムが指定されたものとみなされます。または、script形式のgrn_expr文字列を指定します。 (デフォルトは、\(aq_id, _key, *\(aq)
+.SS \fBsortby\fP
+.sp
+TODO: write in English and add example.
 .sp
-\fBsortby\fP
-.INDENT 0.0
-.INDENT 3.5
 ソートキーとなるカラム名のリストをカンマ(\(aq,\(aq)区切りで指定します。:
 .sp
 .nf
@@ -5511,115 +7830,66 @@ scorerは、検索処理が完了し、ソート処理が実行される前に
 カラム名1の値でソートし、値が同一である場合はカラム名2でソート、と順次比較を行いソートします。カラム名の前に \- を付加した場合は降順にソートします。付加しない場合には昇順にソートします。
 .sp
 query引数またはfilter引数を指定した場合はカラム名に\(aq_score\(aqを使えます。\(aq_score\(aqを指定することでスコアでソートすることができます。query引数もfilter引数も指定していない状態で\(aq_score\(aqを指定するとエラーになります。
-.UNINDENT
-.UNINDENT
-.sp
-\fBoutput_columns\fP
-.INDENT 0.0
-.INDENT 3.5
-出力するカラム名のリストをカンマ(\(aq,\(aq)区切りで指定します。
+.SS \fBoffset\fP
 .sp
-アスタリスク(\(aq*\(aq)を指定すると、全てのカラムが指定されたものとみなされます。または、script形式のgrn_expr文字列を指定します。 (デフォルトは、\(aq_id, _key, *\(aq)
-.UNINDENT
-.UNINDENT
+TODO: write in English and add example.
 .sp
-\fBoffset\fP
-.INDENT 0.0
-.INDENT 3.5
 検索条件にマッチしたレコードのうち、出力対象となる最初のレコードの番号を0ベースで指定します。デフォルト値は0です。offsetに負の値を指定した場合は、ヒットした件数 + offset によって算出される値が指定されたものとみなされます。
-.UNINDENT
-.UNINDENT
+.SS \fBlimit\fP
+.sp
+TODO: write in English and add example.
 .sp
-\fBlimit\fP
-.INDENT 0.0
-.INDENT 3.5
 検索条件にマッチしたレコードのうち、出力を行うレコードの件数を指定します。デフォルト値は10です。実際には、offset + limit がヒットした件数を超えない範囲でレコードが出力されます。limitに負の値を指定した場合は、ヒットした件数 + limit + 1 によって算出される値が指定されたものとみなされます。
-.UNINDENT
-.UNINDENT
+.SS \fBscorer\fP
+.sp
+TODO: write in English and add example.
+.sp
+検索条件にマッチする全てのレコードに対して適用するgrn_exprをscript形式で指定します。
+.sp
+scorerは、検索処理が完了し、ソート処理が実行される前に呼び出されます。従って、各レコードのスコアを操作する式を指定しておけば、検索結果のソート順序をカスタマイズできるようになります。
+.SS Facet related parameters
+.SS \fBdrilldown\fP
+.sp
+TODO: write in English and add example.
 .sp
-\fBdrilldown\fP
-.INDENT 0.0
-.INDENT 3.5
 グループ化のキーとなるカラム名のリストをカンマ(\(aq,\(aq)区切りで指定します。検索条件にマッチした各レコードを出力したのちに、drilldownに指定されたカラムの値が同一であるレコードをとりまとめて、それぞれについて結果レコードを出力します。
-.UNINDENT
-.UNINDENT
+.SS \fBdrilldown_sortby\fP
+.sp
+TODO: write in English and add example.
 .sp
-\fBdrilldown_sortby\fP
-.INDENT 0.0
-.INDENT 3.5
 drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、ソートキーとなるカラム名のリストをカンマ(\(aq,\(aq)区切りで指定します。sortbyパラメータと同様に昇降順を指定できます。
-.UNINDENT
-.UNINDENT
+.SS \fBdrilldown_output_columns\fP
+.sp
+TODO: write in English and add example.
 .sp
-\fBdrilldown_output_columns\fP
-.INDENT 0.0
-.INDENT 3.5
 drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、出力するカラム名のリストをカンマ(\(aq,\(aq)区切りで指定します。
-.UNINDENT
-.UNINDENT
+.SS \fBdrilldown_offset\fP
+.sp
+TODO: write in English and add example.
 .sp
-\fBdrilldown_offset\fP
-.INDENT 0.0
-.INDENT 3.5
 drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、出力対象となる最初のレコードの番号を0ベースで指定します。デフォルト値は0です。drilldown_offsetに負の値を指定した場合は、ヒットした件数 + drilldown_offsetによって算出される値が指定されたものとみなされます。
-.UNINDENT
-.UNINDENT
+.SS \fBdrilldown_limit\fP
+.sp
+TODO: write in English and add example.
 .sp
-\fBdrilldown_limit\fP
-.INDENT 0.0
-.INDENT 3.5
 drilldown条件に指定されたカラムの値毎にとりまとめられたレコードについて、出力を行うレコードの件数を指定します。デフォルト値は10です。実際には、drilldown_offset + drilldown_limit がヒットした件数を超えない範囲でレコードが出力されます。drilldown_limitに負の値を指定した場合は、ヒットした件数 + drilldown_limit + 1 によって算出される値が指定されたものとみなされます。
-.UNINDENT
-.UNINDENT
+.SS Cache related parameter
+.SS \fBcache\fP
+.sp
+TODO: write in English and add example.
 .sp
-\fBcache\fP
-.INDENT 0.0
-.INDENT 3.5
 クエリキャッシュに関する動作を設定します。
-.INDENT 0.0
-.INDENT 3.5
+.sp
 \fBno\fP
 .INDENT 0.0
 .INDENT 3.5
 検索結果をクエリキャッシュに残しません。キャッシュして再利用される可能性が低いクエリに対して用います。キャッシュ容量は有限です。有効なキャッシュが多くヒットするために、このパラメータは有効です。
 .UNINDENT
 .UNINDENT
-.UNINDENT
-.UNINDENT
-.UNINDENT
-.UNINDENT
-.sp
-\fBmatch_escalation_threshold\fP
-.INDENT 0.0
-.INDENT 3.5
-検索の挙動をエスカレーションするかどうかの閾値を設定します。デフォルト値は0です。デフォルト値は以下のいずれかの方法で設定できます。
-.INDENT 0.0
-.INDENT 3.5
-.INDENT 0.0
-.IP \(bu 2
-configureの\-\-with\-match\-escalation\-thresholdオプション
-.IP \(bu 2
-groongaコマンド起動時の\-\-match\-escalation\-thresholdオプション
-.IP \(bu 2
-設定ファイル中のmatch\-escalation\-threshold設定項目
-.UNINDENT
-.UNINDENT
-.UNINDENT
-.sp
-クエリのヒット件数が閾値を越えない場合は \fB/spec/search\fP で説明している方法で検索方法をエスカレーションしてきます。
-.UNINDENT
-.UNINDENT
-.sp
-\fBquery_expansion\fP
-.INDENT 0.0
-.INDENT 3.5
-query_expansionパラメータには、queryパラメータに指定された文字列を置換(拡張)する条件となるテーブル・カラムを指定します。フォーマットは「${テーブル名}.${カラム名}」となります。指定するテーブルは文字列を主キーとするハッシュ型あるいはパトリシア木型のテーブルで、一つ以上の文字列型のカラムが定義されている必要があります。(ここでは置換テーブルと呼びます。)
-.sp
-queryパラメータに指定された文字列が、指定されたテーブルの主キーと完全一致する場合、その文字列を指定されたカラム値の文字列に置換します。queryパラメータが、空白、括弧、演算子などを含む場合は、その演算子によって区切られた文字列の単位で置換が実行されます。ダブルクォート("")で括られた範囲は、その内部に空白を含んでいても一つの置換される単位と見なされます。検索文字列と置換テーブルの主キー値との比較に際して大文字小文字等を区別したくない場合には、置換テーブルを定義する際にKEY_NORMALIZEを指定します。置換後の文字列となるカラムの値には、括弧や*, ORなど、queryパラメータで利用可能な全ての演算子を指定することができます。
-.UNINDENT
-.UNINDENT
 .SS 返値
 .sp
+TODO: write in English and add example.
+.sp
 以下のようなjson形式で値が返却されます。
 .sp
 .nf
@@ -5731,20 +8001,17 @@ drilldown_output_columns, drilldown_offset, drilldown_limitによって指定さ
 .UNINDENT
 .UNINDENT
 .UNINDENT
-.SS 例
-.sp
-テーブルEntryの全レコード・全カラムの値を出力します。:
-.sp
-.nf
-.ft C
-select Entry
-
-[[[2],[["_id", "UInt32"],["_key","ShortText"],["body","ShortText"]],[1,"abandon","放棄する"],[2,"abbreviate","短縮する"]]]
-.ft P
-.fi
-.SS 関連項目
-.sp
-\fB../expr\fP
+.SS See also
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.IP \(bu 2
+\fB/spec/query_syntax\fP
+.IP \(bu 2
+\fB/spec/script_syntax\fP
+.UNINDENT
+.UNINDENT
+.UNINDENT
 .SS shutdown
 .SS 名前
 .sp
@@ -6090,7 +8357,7 @@ Execution example:
 > {"sequence": "1", "time": 1312950804.76057, "item": "engin"},
 > {"sequence": "1", "time": 1312950805.86057, "item": "engine", "type": "submit"}
 > ]
-[[0,1317212843.70335,1.584911917],6]
+[[0,1335519584.62528,1.57926440238953],6]
 .ft P
 .fi
 .sp
@@ -6111,7 +8378,7 @@ Execution example:
 > {"sequence": "2", "time": 1312950809.76057, "item": "serch"},
 > {"sequence": "2", "time": 1312950810.86057, "item": "search", "type": "submit"}
 > ]
-[[0,1317212845.48948,2.003051709],8]
+[[0,1335519586.4057,2.00371694564819],8]
 .ft P
 .fi
 .sp
@@ -6126,7 +8393,7 @@ Execution example:
 > {"sequence": "3", "time": 1312950803.86057, "item": "search engine", "type": "submit"},
 > {"sequence": "3", "time": 1312950808.86057, "item": "web search realtime", "type": "submit"}
 > ]
-[[0,1317212847.69365,0.801326259],2]
+[[0,1335519588.61046,0.801591634750366],2]
 .ft P
 .fi
 .sp
@@ -6137,7 +8404,34 @@ Execution example:
 .nf
 .ft C
 > suggest \-\-table item_query \-\-column kana \-\-types complete \-\-frequency_threshold 1 \-\-query en
-[[0,1317212848.69611,0.00164469],{"complete":[[1],[["_key","ShortText"],["_score","Int32"]],["engine",1]]}]
+[
+  [
+    0,
+    1335519589.6131,
+    0.000982522964477539
+  ],
+  {
+    "complete": [
+      [
+        1
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "_score",
+          "Int32"
+        ]
+      ],
+      [
+        "engine",
+        1
+      ]
+    ]
+  }
+]
 .ft P
 .fi
 .sp
@@ -6148,7 +8442,34 @@ Execution example:
 .nf
 .ft C
 > suggest \-\-table item_query \-\-column kana \-\-types correct \-\-frequency_threshold 1 \-\-query saerch
-[[0,1317212848.8995,0.00037794],{"correct":[[1],[["_key","ShortText"],["_score","Int32"]],["search",1]]}]
+[
+  [
+    0,
+    1335519589.81612,
+    0.000555992126464844
+  ],
+  {
+    "correct": [
+      [
+        1
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "_score",
+          "Int32"
+        ]
+      ],
+      [
+        "search",
+        1
+      ]
+    ]
+  }
+]
 .ft P
 .fi
 .sp
@@ -6159,7 +8480,38 @@ Execution example:
 .nf
 .ft C
 > suggest \-\-table item_query \-\-column kana \-\-types suggest \-\-frequency_threshold 1 \-\-query search
-[[0,1317212849.10158,0.000376811],{"suggest":[[2],[["_key","ShortText"],["_score","Int32"]],["search engine",1],["web search realtime",1]]}]
+[
+  [
+    0,
+    1335519590.01861,
+    0.000383615493774414
+  ],
+  {
+    "suggest": [
+      [
+        2
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "_score",
+          "Int32"
+        ]
+      ],
+      [
+        "search engine",
+        1
+      ],
+      [
+        "web search realtime",
+        1
+      ]
+    ]
+  }
+]
 .ft P
 .fi
 .sp
@@ -6170,7 +8522,80 @@ Execution example:
 .nf
 .ft C
 > suggest \-\-table item_query \-\-column kana \-\-types complete|correct|suggest \-\-frequency_threshold 1 \-\-query search
-[[0,1317212849.30453,0.001329747],{"complete":[[2],[["_key","ShortText"],["_score","Int32"]],["search",2],["search engine",2]],"correct":[[1],[["_key","ShortText"],["_score","Int32"]],["search",2]],"suggest":[[2],[["_key","ShortText"],["_score","Int32"]],["search engine",1],["web search realtime",1]]}]
+[
+  [
+    0,
+    1335519590.22114,
+    0.00113773345947266
+  ],
+  {
+    "suggest": [
+      [
+        2
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "_score",
+          "Int32"
+        ]
+      ],
+      [
+        "search engine",
+        1
+      ],
+      [
+        "web search realtime",
+        1
+      ]
+    ],
+    "complete": [
+      [
+        2
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "_score",
+          "Int32"
+        ]
+      ],
+      [
+        "search",
+        2
+      ],
+      [
+        "search engine",
+        2
+      ]
+    ],
+    "correct": [
+      [
+        1
+      ],
+      [
+        [
+          "_key",
+          "ShortText"
+        ],
+        [
+          "_score",
+          "Int32"
+        ]
+      ],
+      [
+        "search",
+        2
+      ]
+    ]
+  }
+]
 .ft P
 .fi
 .SS SEE ALSO
@@ -7164,11 +9589,11 @@ Execution example:
 .nf
 .ft C
 > table_create Tweets TABLE_NO_KEY
-[[0,1330339027.61804,0.000236272811889648],true]
+[[0,1335519575.12183,0.000383138656616211],true]
 > column_create Tweets content COLUMN_SCALAR ShortText
-[[0,1330339027.81905,0.000560760498046875],true]
+[[0,1335519575.32371,0.000842571258544922],true]
 > table_create Lexicon TABLE_HASH_KEY|KEY_NORMALIZE ShortText \-\-default_tokenizer TokenBigram
-[[0,1330339028.02028,0.000248432159423828],true]
+[[0,1335519575.52538,0.000417470932006836],true]
 .ft P
 .fi
 .sp
@@ -7184,7 +9609,7 @@ Execution example:
 > {"content":"I just start it!"},
 > {"content":"I\(aqm sleepy... Have a nice day... Good night..."}
 > ]
-[[0,1330339028.22155,1.00183534622192],3]
+[[0,1335519575.72702,1.00192642211914],3]
 .ft P
 .fi
 .sp
@@ -7195,7 +9620,30 @@ Execution example:
 .nf
 .ft C
 > select Tweets \-\-match_columns content \-\-query \(aqgood nice\(aq
-[[0,1330339029.42452,0.000802278518676758],[[[0],[["_id","UInt32"],["content","ShortText"]]]]]
+[
+  [
+    0,
+    1335519576.93011,
+    0.000945568084716797
+  ],
+  [
+    [
+      [
+        0
+      ],
+      [
+        [
+          "_id",
+          "UInt32"
+        ],
+        [
+          "content",
+          "ShortText"
+        ]
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .sp
@@ -7208,7 +9656,7 @@ Execution example:
 .nf
 .ft C
 > column_create Lexicon tweet COLUMN_INDEX|WITH_POSITION Tweets content
-[[0,1330339029.62682,0.00742125511169434],true]
+[[0,1335519577.13347,0.00795507431030273],true]
 .ft P
 .fi
 .sp
@@ -7219,7 +9667,34 @@ Execution example:
 .nf
 .ft C
 > select Tweets \-\-match_columns content \-\-query \(aqgood nice\(aq
-[[0,1330339029.83545,0.000765085220336914],[[[1],[["_id","UInt32"],["content","ShortText"]],[3,"I\(aqm sleepy... Have a nice day... Good night..."]]]]
+[
+  [
+    0,
+    1335519577.34259,
+    0.000716209411621094
+  ],
+  [
+    [
+      [
+        1
+      ],
+      [
+        [
+          "_id",
+          "UInt32"
+        ],
+        [
+          "content",
+          "ShortText"
+        ]
+      ],
+      [
+        3,
+        "I\(aqm sleepy... Have a nice day... Good night..."
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .sp
@@ -7235,7 +9710,7 @@ Execution example:
 > {"content":"Good morning! Nice day."},
 > {"content":"Let\(aqs go shopping."}
 > ]
-[[0,1330339030.03821,0.801372528076172],2]
+[[0,1335519577.54547,0.801515579223633],2]
 .ft P
 .fi
 .sp
@@ -7246,7 +9721,38 @@ Execution example:
 .nf
 .ft C
 > select Tweets \-\-match_columns content \-\-query \(aqgood nice\(aq
-[[0,1330339031.04064,0.000650644302368164],[[[2],[["_id","UInt32"],["content","ShortText"]],[3,"I\(aqm sleepy... Have a nice day... Good night..."],[4,"Good morning! Nice day."]]]]
+[
+  [
+    0,
+    1335519578.54813,
+    0.000664234161376953
+  ],
+  [
+    [
+      [
+        2
+      ],
+      [
+        [
+          "_id",
+          "UInt32"
+        ],
+        [
+          "content",
+          "ShortText"
+        ]
+      ],
+      [
+        3,
+        "I\(aqm sleepy... Have a nice day... Good night..."
+      ],
+      [
+        4,
+        "Good morning! Nice day."
+      ]
+    ]
+  ]
+]
 .ft P
 .fi
 .SS Log
@@ -7531,6 +10037,61 @@ Example:
 .ft P
 .fi
 .SH 仕様
+.SS Query syntax
+.sp
+TODO: revised.
+.sp
+一般的なWebページの検索フォームで使われるような書式を使って検索条件を指定することができます。これをクエリ構文と呼びます。
+.sp
+クエリ構文は「条件式」と条件式を組み合わせる「結合式」からなります。
+.SS 条件式
+.sp
+以下の条件式が使用できます。
+.SS \fB文字列\fP
+.sp
+全文検索条件(デフォルト検索対象カラムの値が指定された文字列を含んでいる)
+.SS \fB"文字列"\fP
+.sp
+フレーズ検索条件(デフォルト検索対象カラムの値が指定されたフレーズを含んでいる)
+.SS \fBカラム名:値\fP
+.sp
+一致条件( \fBカラム値 == 値\fP )
+.SS \fBカラム名:!値\fP
+.sp
+不一致条件( \fBカラム値 != 値\fP )
+.SS \fBカラム名:<値\fP
+.sp
+比較条件( \fBカラム値 < 値\fP )
+.SS \fBカラム名:>値\fP
+.sp
+比較条件( \fBカラム値 > 値\fP )
+.SS \fBカラム名:<=値\fP
+.sp
+比較条件( \fBカラム値 <= 値\fP )
+.SS \fBカラム名:>=値\fP
+.sp
+比較条件( \fBカラム値 >= 値\fP )
+.SS \fBカラム名:@文字列\fP
+.sp
+全文検索条件(カラム値が指定された文字列を含んでいる)
+.SS 結合演算子
+.sp
+複数の条件式を結合するために以下の演算子が使用できます。
+.SS \fBa OR b\fP
+.sp
+論理和( \fBa\fP と \fBb\fP といずれかの条件がマッチする)
+.SS \fBa + b\fP
+.sp
+論理積( \fBa\fP と \fBb\fP の両方がマッチする)
+.SS \fBa \- b\fP
+.sp
+\fBa\fP にマッチし、 \fBb\fP にはマッチしない
+.SS \fB(...)\fP
+.sp
+複数の条件をまとめる
+.SS Script Syntax
+.sp
+TODO...
 .SS 検索
 .sp
 \fB/commands/select\fP コマンドがqueryパラメータを使ってどのように検索するのかを説明します。