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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (682) hide show
  1. checksums.yaml +13 -5
  2. data/Gemfile +1 -1
  3. data/README.textile +1 -1
  4. data/Rakefile +8 -1
  5. data/bin/grndump +1 -1
  6. data/bin/grntest-log-analyze +1 -1
  7. data/bin/groonga-database-inspect +1 -1
  8. data/bin/groonga-index-dump +1 -1
  9. data/doc/text/news.textile +28 -0
  10. data/ext/groonga/extconf.rb +12 -2
  11. data/ext/groonga/rb-grn-accessor.c +2 -1
  12. data/ext/groonga/rb-grn-array-cursor.c +1 -1
  13. data/ext/groonga/rb-grn-array.c +1 -1
  14. data/ext/groonga/rb-grn-column.c +1 -1
  15. data/ext/groonga/rb-grn-context.c +7 -5
  16. data/ext/groonga/rb-grn-database.c +1 -1
  17. data/ext/groonga/rb-grn-double-array-trie-cursor.c +1 -1
  18. data/ext/groonga/rb-grn-double-array-trie.c +1 -1
  19. data/ext/groonga/rb-grn-encoding-support.c +1 -1
  20. data/ext/groonga/rb-grn-encoding.c +1 -1
  21. data/ext/groonga/rb-grn-exception.c +1 -1
  22. data/ext/groonga/rb-grn-expression-builder.c +1 -1
  23. data/ext/groonga/rb-grn-expression.c +1 -1
  24. data/ext/groonga/rb-grn-fix-size-column.c +1 -1
  25. data/ext/groonga/rb-grn-geo-point.c +1 -1
  26. data/ext/groonga/rb-grn-hash-cursor.c +1 -1
  27. data/ext/groonga/rb-grn-hash.c +1 -1
  28. data/ext/groonga/rb-grn-index-column.c +1 -1
  29. data/ext/groonga/rb-grn-index-cursor.c +1 -1
  30. data/ext/groonga/rb-grn-logger.c +1 -1
  31. data/ext/groonga/rb-grn-normalizer.c +1 -1
  32. data/ext/groonga/rb-grn-object.c +71 -45
  33. data/ext/groonga/rb-grn-operator.c +1 -1
  34. data/ext/groonga/rb-grn-patricia-trie-cursor.c +1 -1
  35. data/ext/groonga/rb-grn-patricia-trie.c +1 -1
  36. data/ext/groonga/rb-grn-plugin.c +1 -1
  37. data/ext/groonga/rb-grn-posting.c +1 -1
  38. data/ext/groonga/rb-grn-procedure-type.c +40 -0
  39. data/ext/groonga/rb-grn-procedure.c +17 -4
  40. data/ext/groonga/rb-grn-query-logger.c +1 -1
  41. data/ext/groonga/rb-grn-record.c +1 -1
  42. data/ext/groonga/rb-grn-snippet.c +1 -1
  43. data/ext/groonga/rb-grn-table-cursor-key-support.c +1 -1
  44. data/ext/groonga/rb-grn-table-cursor.c +1 -1
  45. data/ext/groonga/rb-grn-table-key-support.c +1 -1
  46. data/ext/groonga/rb-grn-table.c +3 -2
  47. data/ext/groonga/rb-grn-type.c +1 -1
  48. data/ext/groonga/rb-grn-utils.c +1 -1
  49. data/ext/groonga/rb-grn-variable-size-column.c +55 -27
  50. data/ext/groonga/rb-grn-variable.c +1 -1
  51. data/ext/groonga/rb-grn.h +4 -2
  52. data/ext/groonga/rb-groonga.c +3 -2
  53. data/extconf.rb +1 -1
  54. data/lib/1.9/groonga.so +0 -0
  55. data/lib/2.0/groonga.so +0 -0
  56. data/lib/2.1/groonga.so +0 -0
  57. data/lib/groonga.rb +1 -1
  58. data/lib/groonga/column.rb +1 -1
  59. data/lib/groonga/context.rb +1 -1
  60. data/lib/groonga/context/command-executor.rb +1 -1
  61. data/lib/groonga/database-inspector.rb +1 -1
  62. data/lib/groonga/database.rb +1 -1
  63. data/lib/groonga/dumper.rb +1 -1
  64. data/lib/groonga/expression-builder-19.rb +1 -1
  65. data/lib/groonga/expression-builder.rb +1 -1
  66. data/lib/groonga/geo-point.rb +1 -1
  67. data/lib/groonga/grntest-log.rb +1 -1
  68. data/lib/groonga/index-column.rb +1 -1
  69. data/lib/groonga/logger.rb +1 -1
  70. data/lib/groonga/memory-pool.rb +1 -2
  71. data/lib/groonga/pagination.rb +1 -1
  72. data/lib/groonga/patricia-trie.rb +1 -1
  73. data/lib/groonga/posting.rb +1 -1
  74. data/lib/groonga/query-logger.rb +1 -1
  75. data/lib/groonga/record.rb +6 -2
  76. data/lib/groonga/schema.rb +1 -1
  77. data/lib/groonga/statistic-measurer.rb +1 -1
  78. data/lib/groonga/sub-records.rb +1 -1
  79. data/lib/groonga/table.rb +1 -1
  80. data/misc/grnop2ruby.rb +1 -1
  81. data/rroonga-build.rb +4 -4
  82. data/rroonga.gemspec +3 -3
  83. data/test/groonga-test-utils.rb +4 -4
  84. data/test/run-test.rb +1 -1
  85. data/test/test-accessor.rb +1 -1
  86. data/test/test-array.rb +1 -1
  87. data/test/test-column.rb +1 -1
  88. data/test/test-command-select.rb +1 -1
  89. data/test/test-context.rb +21 -16
  90. data/test/test-convert.rb +1 -1
  91. data/test/test-database-dumper.rb +1 -1
  92. data/test/test-database-inspector.rb +1 -1
  93. data/test/test-database.rb +38 -25
  94. data/test/test-double-array-trie.rb +1 -1
  95. data/test/test-encoding.rb +1 -1
  96. data/test/test-exception.rb +12 -7
  97. data/test/test-expression-builder.rb +1 -1
  98. data/test/test-expression.rb +1 -1
  99. data/test/test-fix-size-column.rb +1 -1
  100. data/test/test-geo-point.rb +1 -1
  101. data/test/test-gqtp.rb +1 -1
  102. data/test/test-hash.rb +1 -1
  103. data/test/test-index-column.rb +1 -1
  104. data/test/test-index-cursor.rb +1 -1
  105. data/test/test-lock-timeout.rb +1 -1
  106. data/test/test-logger.rb +1 -1
  107. data/test/test-memory-pool.rb +1 -1
  108. data/test/test-normalizer.rb +1 -1
  109. data/test/test-pagination.rb +1 -1
  110. data/test/test-patricia-trie.rb +1 -1
  111. data/test/test-plugin.rb +1 -1
  112. data/test/test-procedure.rb +9 -2
  113. data/test/test-record.rb +1 -1
  114. data/test/test-remote.rb +1 -1
  115. data/test/test-schema-create-table.rb +1 -1
  116. data/test/test-schema-dumper.rb +1 -1
  117. data/test/test-schema-type.rb +1 -1
  118. data/test/test-schema.rb +1 -1
  119. data/test/test-snippet.rb +1 -1
  120. data/test/test-statistic-measurer.rb +1 -1
  121. data/test/test-sub-records.rb +1 -1
  122. data/test/test-table-dumper.rb +1 -1
  123. data/test/test-table-key-support.rb +1 -1
  124. data/test/test-table-offset-and-limit.rb +1 -1
  125. data/test/test-table-select-mecab.rb +1 -1
  126. data/test/test-table-select-normalize.rb +1 -1
  127. data/test/test-table-select-weight.rb +1 -1
  128. data/test/test-table-select.rb +1 -1
  129. data/test/test-table-traverse.rb +1 -1
  130. data/test/test-table.rb +1 -1
  131. data/test/test-type.rb +1 -1
  132. data/test/test-variable-size-column.rb +136 -67
  133. data/test/test-variable.rb +1 -1
  134. data/test/test-vector-column.rb +1 -1
  135. data/test/test-version.rb +1 -1
  136. data/vendor/local/bin/groonga-benchmark.exe +0 -0
  137. data/vendor/local/bin/groonga.exe +0 -0
  138. data/vendor/local/bin/libgcc_s_sjlj-1.dll +0 -0
  139. data/vendor/local/bin/libgroonga-0.dll +0 -0
  140. data/vendor/local/bin/libmecab-1.dll +0 -0
  141. data/vendor/local/bin/libmsgpack-3.dll +0 -0
  142. data/vendor/local/bin/libmsgpackc-2.dll +0 -0
  143. data/vendor/local/bin/libstdc++-6.dll +0 -0
  144. data/vendor/local/bin/libwinpthread-1.dll +0 -0
  145. data/vendor/local/bin/mecab-config +0 -0
  146. data/vendor/local/bin/mecab.exe +0 -0
  147. data/vendor/local/include/groonga/groonga.h +38 -5
  148. data/vendor/local/include/groonga/groonga/plugin.h +11 -83
  149. data/vendor/local/include/groonga/groonga/tokenizer.h +10 -5
  150. data/vendor/local/include/msgpack.h +1 -0
  151. data/vendor/local/include/msgpack/fbuffer.h +47 -0
  152. data/vendor/local/include/msgpack/fbuffer.hpp +56 -0
  153. data/vendor/local/include/msgpack/object.hpp +12 -3
  154. data/vendor/local/include/msgpack/pack.h +7 -3
  155. data/vendor/local/include/msgpack/pack.hpp +26 -7
  156. data/vendor/local/include/msgpack/pack_template.h +34 -7
  157. data/vendor/local/include/msgpack/sbuffer.h +3 -2
  158. data/vendor/local/include/msgpack/sbuffer.hpp +1 -1
  159. data/vendor/local/include/msgpack/sysdep.h +27 -14
  160. data/vendor/local/include/msgpack/type.hpp +2 -1
  161. data/vendor/local/include/msgpack/type/define.hpp +747 -561
  162. data/vendor/local/include/msgpack/type/float.hpp +24 -4
  163. data/vendor/local/include/msgpack/type/int.hpp +78 -13
  164. data/vendor/local/include/msgpack/type/tr1/unordered_map.hpp +31 -10
  165. data/vendor/local/include/msgpack/type/tr1/unordered_set.hpp +30 -10
  166. data/vendor/local/include/msgpack/unpack.h +9 -9
  167. data/vendor/local/include/msgpack/unpack_define.h +16 -14
  168. data/vendor/local/include/msgpack/unpack_template.h +19 -8
  169. data/vendor/local/include/msgpack/version.h +1 -1
  170. data/vendor/local/include/msgpack/vrefbuffer.h +10 -9
  171. data/vendor/local/include/msgpack/vrefbuffer.hpp +4 -2
  172. data/vendor/local/include/msgpack/zbuffer.h +3 -2
  173. data/vendor/local/include/msgpack/zbuffer.hpp +4 -2
  174. data/vendor/local/include/msgpack/zone.h +5 -4
  175. data/vendor/local/include/msgpack/zone.hpp +10 -1
  176. data/vendor/local/lib/groonga/plugins/query_expanders/tsv.a +0 -0
  177. data/vendor/local/lib/groonga/plugins/query_expanders/tsv.dll +0 -0
  178. data/vendor/local/lib/groonga/plugins/query_expanders/tsv.dll.a +0 -0
  179. data/vendor/local/lib/groonga/plugins/query_expanders/tsv.la +1 -1
  180. data/vendor/local/lib/groonga/plugins/suggest/suggest.a +0 -0
  181. data/vendor/local/lib/groonga/plugins/suggest/suggest.dll +0 -0
  182. data/vendor/local/lib/groonga/plugins/suggest/suggest.dll.a +0 -0
  183. data/vendor/local/lib/groonga/plugins/suggest/suggest.la +1 -1
  184. data/vendor/local/lib/groonga/plugins/table/table.a +0 -0
  185. data/vendor/local/lib/groonga/plugins/table/table.dll +0 -0
  186. data/vendor/local/lib/groonga/plugins/table/table.dll.a +0 -0
  187. data/vendor/local/lib/groonga/plugins/table/table.la +1 -1
  188. data/vendor/local/lib/groonga/plugins/tokenizers/mecab.a +0 -0
  189. data/vendor/local/lib/groonga/plugins/tokenizers/mecab.dll +0 -0
  190. data/vendor/local/lib/groonga/plugins/tokenizers/mecab.dll.a +0 -0
  191. data/vendor/local/lib/groonga/plugins/tokenizers/mecab.la +2 -2
  192. data/vendor/local/lib/libgroonga.a +0 -0
  193. data/vendor/local/lib/libgroonga.dll.a +0 -0
  194. data/vendor/local/lib/libgroonga.la +1 -1
  195. data/vendor/local/lib/libmecab.a +0 -0
  196. data/vendor/local/lib/libmecab.dll.a +0 -0
  197. data/vendor/local/lib/libmecab.la +2 -2
  198. data/vendor/local/lib/libmsgpack.a +0 -0
  199. data/vendor/local/lib/libmsgpack.dll.a +0 -0
  200. data/vendor/local/lib/libmsgpack.la +1 -1
  201. data/vendor/local/lib/libmsgpackc.a +0 -0
  202. data/vendor/local/lib/libmsgpackc.dll.a +0 -0
  203. data/vendor/local/lib/libmsgpackc.la +1 -1
  204. data/vendor/local/lib/pkgconfig/groonga.pc +2 -2
  205. data/vendor/local/lib/pkgconfig/msgpack.pc +10 -0
  206. data/vendor/local/libexec/mecab/mecab-cost-train.exe +0 -0
  207. data/vendor/local/libexec/mecab/mecab-dict-gen.exe +0 -0
  208. data/vendor/local/libexec/mecab/mecab-dict-index.exe +0 -0
  209. data/vendor/local/libexec/mecab/mecab-system-eval.exe +0 -0
  210. data/vendor/local/libexec/mecab/mecab-test-gen.exe +0 -0
  211. data/vendor/local/sbin/groonga-httpd-restart +0 -0
  212. data/vendor/local/share/doc/groonga/en/html/.buildinfo +1 -1
  213. data/vendor/local/share/doc/groonga/en/html/_sources/contribution/documentation/i18n.txt +2 -6
  214. data/vendor/local/share/doc/groonga/en/html/_sources/install/centos.txt +7 -26
  215. data/vendor/local/share/doc/groonga/en/html/_sources/install/debian.txt +9 -5
  216. data/vendor/local/share/doc/groonga/en/html/_sources/install/fedora.txt +13 -15
  217. data/vendor/local/share/doc/groonga/en/html/_sources/install/mac_os_x.txt +3 -3
  218. data/vendor/local/share/doc/groonga/en/html/_sources/install/others.txt +4 -4
  219. data/vendor/local/share/doc/groonga/en/html/_sources/install/solaris.txt +3 -3
  220. data/vendor/local/share/doc/groonga/en/html/_sources/install/ubuntu.txt +5 -5
  221. data/vendor/local/share/doc/groonga/en/html/_sources/install/windows.txt +9 -9
  222. data/vendor/local/share/doc/groonga/en/html/_sources/news.txt +149 -1194
  223. data/vendor/local/share/doc/groonga/en/html/_sources/news/1.3.x.txt +49 -0
  224. data/vendor/local/share/doc/groonga/en/html/_sources/news/2.x.txt +617 -0
  225. data/vendor/local/share/doc/groonga/en/html/_sources/news/3.x.txt +536 -0
  226. data/vendor/local/share/doc/groonga/en/html/_sources/reference/api/plugin.txt +122 -3
  227. data/vendor/local/share/doc/groonga/en/html/_sources/reference/columns/vector.txt +0 -1
  228. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/check.txt +50 -55
  229. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/clearlock.txt +25 -31
  230. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/column_remove.txt +26 -29
  231. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/define_selector.txt +20 -26
  232. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/defrag.txt +26 -29
  233. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/dump.txt +28 -28
  234. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/log_level.txt +20 -26
  235. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/log_put.txt +20 -26
  236. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/log_reopen.txt +29 -34
  237. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/normalizer_list.txt +3 -3
  238. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/quit.txt +20 -20
  239. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/register.txt +2 -2
  240. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/shutdown.txt +19 -20
  241. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/status.txt +19 -24
  242. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/suggest.txt +78 -87
  243. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/table_list.txt +20 -22
  244. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/table_remove.txt +19 -24
  245. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/tokenize.txt +27 -0
  246. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/tokenizer_list.txt +3 -3
  247. data/vendor/local/share/doc/groonga/en/html/_sources/reference/executables/groonga-benchmark.txt +17 -5
  248. data/vendor/local/share/doc/groonga/en/html/_sources/reference/executables/groonga-suggest-learner.txt +17 -8
  249. data/vendor/local/share/doc/groonga/en/html/_sources/reference/executables/groonga.txt +2 -2
  250. data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/highlight_full.txt +132 -0
  251. data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/highlight_html.txt +100 -0
  252. data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/snippet_html.txt +1 -1
  253. data/vendor/local/share/doc/groonga/en/html/_sources/server/http/comparison.txt +1 -1
  254. data/vendor/local/share/doc/groonga/en/html/_sources/troubleshooting/mmap_cannot_allocate_memory.txt +1 -1
  255. data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/data.txt +6 -2
  256. data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/drilldown.txt +3 -2
  257. data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/index.txt +28 -25
  258. data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/match_columns.txt +26 -21
  259. data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/network.txt +3 -3
  260. data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/patricia_trie.txt +17 -12
  261. data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/search.txt +44 -42
  262. data/vendor/local/share/doc/groonga/en/html/_static/basic.css +0 -18
  263. data/vendor/local/share/doc/groonga/en/html/_static/groonga.css +2 -0
  264. data/vendor/local/share/doc/groonga/en/html/characteristic.html +17 -19
  265. data/vendor/local/share/doc/groonga/en/html/community.html +17 -19
  266. data/vendor/local/share/doc/groonga/en/html/contribution.html +17 -19
  267. data/vendor/local/share/doc/groonga/en/html/contribution/development.html +17 -19
  268. data/vendor/local/share/doc/groonga/en/html/contribution/development/com.html +17 -19
  269. data/vendor/local/share/doc/groonga/en/html/contribution/development/cooperation.html +17 -19
  270. data/vendor/local/share/doc/groonga/en/html/contribution/development/query.html +17 -19
  271. data/vendor/local/share/doc/groonga/en/html/contribution/development/release.html +17 -19
  272. data/vendor/local/share/doc/groonga/en/html/contribution/development/repository.html +17 -19
  273. data/vendor/local/share/doc/groonga/en/html/contribution/development/test.html +17 -19
  274. data/vendor/local/share/doc/groonga/en/html/contribution/documentation.html +17 -19
  275. data/vendor/local/share/doc/groonga/en/html/contribution/documentation/c-api.html +17 -19
  276. data/vendor/local/share/doc/groonga/en/html/contribution/documentation/i18n.html +17 -19
  277. data/vendor/local/share/doc/groonga/en/html/contribution/documentation/introduction.html +17 -19
  278. data/vendor/local/share/doc/groonga/en/html/contribution/report.html +17 -19
  279. data/vendor/local/share/doc/groonga/en/html/development.html +17 -19
  280. data/vendor/local/share/doc/groonga/en/html/development/travis-ci.html +17 -19
  281. data/vendor/local/share/doc/groonga/en/html/genindex.html +136 -26
  282. data/vendor/local/share/doc/groonga/en/html/geolocation_search.html +17 -19
  283. data/vendor/local/share/doc/groonga/en/html/index.html +56 -56
  284. data/vendor/local/share/doc/groonga/en/html/install.html +17 -19
  285. data/vendor/local/share/doc/groonga/en/html/install/centos.html +43 -50
  286. data/vendor/local/share/doc/groonga/en/html/install/debian.html +59 -35
  287. data/vendor/local/share/doc/groonga/en/html/install/fedora.html +40 -44
  288. data/vendor/local/share/doc/groonga/en/html/install/mac_os_x.html +20 -22
  289. data/vendor/local/share/doc/groonga/en/html/install/others.html +21 -23
  290. data/vendor/local/share/doc/groonga/en/html/install/solaris.html +20 -22
  291. data/vendor/local/share/doc/groonga/en/html/install/ubuntu.html +33 -35
  292. data/vendor/local/share/doc/groonga/en/html/install/windows.html +26 -28
  293. data/vendor/local/share/doc/groonga/en/html/limitations.html +17 -19
  294. data/vendor/local/share/doc/groonga/en/html/news.html +320 -1367
  295. data/vendor/local/share/doc/groonga/en/html/news/0.x.html +17 -19
  296. data/vendor/local/share/doc/groonga/en/html/news/1.0.x.html +17 -19
  297. data/vendor/local/share/doc/groonga/en/html/news/1.1.x.html +17 -19
  298. data/vendor/local/share/doc/groonga/en/html/news/1.2.x.html +17 -19
  299. data/vendor/local/share/doc/groonga/en/html/news/1.3.x.html +160 -0
  300. data/vendor/local/share/doc/groonga/en/html/news/2.x.html +804 -0
  301. data/vendor/local/share/doc/groonga/en/html/news/3.x.html +727 -0
  302. data/vendor/local/share/doc/groonga/en/html/news/senna.html +17 -19
  303. data/vendor/local/share/doc/groonga/en/html/objects.inv +0 -0
  304. data/vendor/local/share/doc/groonga/en/html/reference.html +41 -41
  305. data/vendor/local/share/doc/groonga/en/html/reference/api.html +17 -19
  306. data/vendor/local/share/doc/groonga/en/html/reference/api/global_configurations.html +19 -21
  307. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_cache.html +23 -25
  308. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_column.html +23 -25
  309. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_command_version.html +19 -21
  310. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_ctx.html +28 -30
  311. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_db.html +21 -23
  312. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_encoding.html +21 -23
  313. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_expr.html +30 -32
  314. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_geo.html +21 -23
  315. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_hook.html +21 -23
  316. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_ii.html +21 -23
  317. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_index_cursor.html +19 -21
  318. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_info.html +21 -23
  319. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_match_escalation.html +21 -23
  320. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_obj.html +40 -42
  321. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_proc.html +20 -22
  322. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_search.html +18 -20
  323. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_table.html +35 -37
  324. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_table_cursor.html +25 -27
  325. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_type.html +18 -20
  326. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_user_data.html +18 -20
  327. data/vendor/local/share/doc/groonga/en/html/reference/api/plugin.html +226 -24
  328. data/vendor/local/share/doc/groonga/en/html/reference/cast.html +17 -19
  329. data/vendor/local/share/doc/groonga/en/html/reference/column.html +17 -19
  330. data/vendor/local/share/doc/groonga/en/html/reference/columns/pseudo.html +17 -19
  331. data/vendor/local/share/doc/groonga/en/html/reference/columns/vector.html +17 -20
  332. data/vendor/local/share/doc/groonga/en/html/reference/command.html +33 -35
  333. data/vendor/local/share/doc/groonga/en/html/reference/command/command_version.html +17 -19
  334. data/vendor/local/share/doc/groonga/en/html/reference/command/output_format.html +17 -19
  335. data/vendor/local/share/doc/groonga/en/html/reference/command/return_code.html +17 -19
  336. data/vendor/local/share/doc/groonga/en/html/reference/commands/cache_limit.html +18 -20
  337. data/vendor/local/share/doc/groonga/en/html/reference/commands/check.html +73 -85
  338. data/vendor/local/share/doc/groonga/en/html/reference/commands/clearlock.html +50 -62
  339. data/vendor/local/share/doc/groonga/en/html/reference/commands/column_create.html +18 -20
  340. data/vendor/local/share/doc/groonga/en/html/reference/commands/column_list.html +18 -20
  341. data/vendor/local/share/doc/groonga/en/html/reference/commands/column_remove.html +53 -65
  342. data/vendor/local/share/doc/groonga/en/html/reference/commands/column_rename.html +19 -21
  343. data/vendor/local/share/doc/groonga/en/html/reference/commands/define_selector.html +45 -57
  344. data/vendor/local/share/doc/groonga/en/html/reference/commands/defrag.html +49 -59
  345. data/vendor/local/share/doc/groonga/en/html/reference/commands/delete.html +19 -21
  346. data/vendor/local/share/doc/groonga/en/html/reference/commands/dump.html +47 -51
  347. data/vendor/local/share/doc/groonga/en/html/reference/commands/load.html +19 -21
  348. data/vendor/local/share/doc/groonga/en/html/reference/commands/log_level.html +44 -56
  349. data/vendor/local/share/doc/groonga/en/html/reference/commands/log_put.html +45 -57
  350. data/vendor/local/share/doc/groonga/en/html/reference/commands/log_reopen.html +54 -63
  351. data/vendor/local/share/doc/groonga/en/html/reference/commands/normalize.html +18 -20
  352. data/vendor/local/share/doc/groonga/en/html/reference/commands/normalizer_list.html +21 -23
  353. data/vendor/local/share/doc/groonga/en/html/reference/commands/quit.html +42 -46
  354. data/vendor/local/share/doc/groonga/en/html/reference/commands/register.html +20 -22
  355. data/vendor/local/share/doc/groonga/en/html/reference/commands/ruby_eval.html +18 -20
  356. data/vendor/local/share/doc/groonga/en/html/reference/commands/ruby_load.html +17 -19
  357. data/vendor/local/share/doc/groonga/en/html/reference/commands/select.html +18 -20
  358. data/vendor/local/share/doc/groonga/en/html/reference/commands/shutdown.html +41 -46
  359. data/vendor/local/share/doc/groonga/en/html/reference/commands/status.html +52 -64
  360. data/vendor/local/share/doc/groonga/en/html/reference/commands/suggest.html +201 -213
  361. data/vendor/local/share/doc/groonga/en/html/reference/commands/table_create.html +19 -21
  362. data/vendor/local/share/doc/groonga/en/html/reference/commands/table_list.html +74 -81
  363. data/vendor/local/share/doc/groonga/en/html/reference/commands/table_remove.html +42 -54
  364. data/vendor/local/share/doc/groonga/en/html/reference/commands/tokenize.html +174 -20
  365. data/vendor/local/share/doc/groonga/en/html/reference/commands/tokenizer_list.html +20 -22
  366. data/vendor/local/share/doc/groonga/en/html/reference/commands/truncate.html +17 -19
  367. data/vendor/local/share/doc/groonga/en/html/reference/executables.html +17 -19
  368. data/vendor/local/share/doc/groonga/en/html/reference/executables/grnslap.html +17 -19
  369. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-benchmark.html +31 -24
  370. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-httpd.html +17 -19
  371. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-server-http.html +17 -19
  372. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-create-dataset.html +17 -19
  373. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-httpd.html +17 -19
  374. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-learner.html +38 -27
  375. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga.html +19 -21
  376. data/vendor/local/share/doc/groonga/en/html/reference/function.html +25 -25
  377. data/vendor/local/share/doc/groonga/en/html/reference/functions/between.html +17 -19
  378. data/vendor/local/share/doc/groonga/en/html/reference/functions/edit_distance.html +17 -19
  379. data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_distance.html +17 -19
  380. data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_in_circle.html +17 -19
  381. data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_in_rectangle.html +22 -24
  382. data/vendor/local/share/doc/groonga/en/html/reference/functions/highlight_full.html +311 -0
  383. data/vendor/local/share/doc/groonga/en/html/reference/functions/highlight_html.html +278 -0
  384. data/vendor/local/share/doc/groonga/en/html/reference/functions/html_untag.html +42 -44
  385. data/vendor/local/share/doc/groonga/en/html/reference/functions/now.html +37 -39
  386. data/vendor/local/share/doc/groonga/en/html/reference/functions/query.html +53 -55
  387. data/vendor/local/share/doc/groonga/en/html/reference/functions/rand.html +39 -41
  388. data/vendor/local/share/doc/groonga/en/html/reference/functions/snippet_html.html +40 -42
  389. data/vendor/local/share/doc/groonga/en/html/reference/functions/sub_filter.html +39 -41
  390. data/vendor/local/share/doc/groonga/en/html/reference/grn_expr.html +17 -19
  391. data/vendor/local/share/doc/groonga/en/html/reference/grn_expr/query_syntax.html +17 -19
  392. data/vendor/local/share/doc/groonga/en/html/reference/grn_expr/script_syntax.html +17 -19
  393. data/vendor/local/share/doc/groonga/en/html/reference/indexing.html +21 -23
  394. data/vendor/local/share/doc/groonga/en/html/reference/log.html +18 -20
  395. data/vendor/local/share/doc/groonga/en/html/reference/normalizers.html +17 -19
  396. data/vendor/local/share/doc/groonga/en/html/reference/output.html +17 -19
  397. data/vendor/local/share/doc/groonga/en/html/reference/query_expanders.html +17 -19
  398. data/vendor/local/share/doc/groonga/en/html/reference/query_expanders/tsv.html +17 -19
  399. data/vendor/local/share/doc/groonga/en/html/reference/tables.html +17 -19
  400. data/vendor/local/share/doc/groonga/en/html/reference/tokenizers.html +17 -19
  401. data/vendor/local/share/doc/groonga/en/html/reference/tuning.html +17 -19
  402. data/vendor/local/share/doc/groonga/en/html/reference/types.html +17 -19
  403. data/vendor/local/share/doc/groonga/en/html/search.html +11 -11
  404. data/vendor/local/share/doc/groonga/en/html/searchindex.js +1 -1
  405. data/vendor/local/share/doc/groonga/en/html/server.html +17 -19
  406. data/vendor/local/share/doc/groonga/en/html/server/gqtp.html +17 -19
  407. data/vendor/local/share/doc/groonga/en/html/server/http.html +17 -19
  408. data/vendor/local/share/doc/groonga/en/html/server/http/comparison.html +18 -20
  409. data/vendor/local/share/doc/groonga/en/html/server/http/groonga-httpd.html +17 -19
  410. data/vendor/local/share/doc/groonga/en/html/server/http/groonga.html +17 -19
  411. data/vendor/local/share/doc/groonga/en/html/server/package.html +17 -19
  412. data/vendor/local/share/doc/groonga/en/html/spec.html +17 -19
  413. data/vendor/local/share/doc/groonga/en/html/spec/gqtp.html +17 -19
  414. data/vendor/local/share/doc/groonga/en/html/spec/search.html +17 -19
  415. data/vendor/local/share/doc/groonga/en/html/suggest.html +17 -19
  416. data/vendor/local/share/doc/groonga/en/html/suggest/completion.html +17 -19
  417. data/vendor/local/share/doc/groonga/en/html/suggest/correction.html +17 -19
  418. data/vendor/local/share/doc/groonga/en/html/suggest/introduction.html +17 -19
  419. data/vendor/local/share/doc/groonga/en/html/suggest/suggestion.html +17 -19
  420. data/vendor/local/share/doc/groonga/en/html/suggest/tutorial.html +17 -19
  421. data/vendor/local/share/doc/groonga/en/html/troubleshooting.html +17 -19
  422. data/vendor/local/share/doc/groonga/en/html/troubleshooting/different_results_with_the_same_keyword.html +17 -19
  423. data/vendor/local/share/doc/groonga/en/html/troubleshooting/mmap_cannot_allocate_memory.html +18 -20
  424. data/vendor/local/share/doc/groonga/en/html/tutorial.html +32 -34
  425. data/vendor/local/share/doc/groonga/en/html/tutorial/data.html +21 -23
  426. data/vendor/local/share/doc/groonga/en/html/tutorial/drilldown.html +28 -29
  427. data/vendor/local/share/doc/groonga/en/html/tutorial/index.html +52 -52
  428. data/vendor/local/share/doc/groonga/en/html/tutorial/introduction.html +17 -19
  429. data/vendor/local/share/doc/groonga/en/html/tutorial/lexicon.html +21 -23
  430. data/vendor/local/share/doc/groonga/en/html/tutorial/match_columns.html +57 -56
  431. data/vendor/local/share/doc/groonga/en/html/tutorial/micro_blog.html +22 -24
  432. data/vendor/local/share/doc/groonga/en/html/tutorial/network.html +20 -22
  433. data/vendor/local/share/doc/groonga/en/html/tutorial/patricia_trie.html +46 -44
  434. data/vendor/local/share/doc/groonga/en/html/tutorial/query_expansion.html +17 -19
  435. data/vendor/local/share/doc/groonga/en/html/tutorial/search.html +71 -69
  436. data/vendor/local/share/doc/groonga/ja/html/.buildinfo +1 -1
  437. data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/documentation/i18n.txt +2 -6
  438. data/vendor/local/share/doc/groonga/ja/html/_sources/install/centos.txt +7 -26
  439. data/vendor/local/share/doc/groonga/ja/html/_sources/install/debian.txt +9 -5
  440. data/vendor/local/share/doc/groonga/ja/html/_sources/install/fedora.txt +13 -15
  441. data/vendor/local/share/doc/groonga/ja/html/_sources/install/mac_os_x.txt +3 -3
  442. data/vendor/local/share/doc/groonga/ja/html/_sources/install/others.txt +4 -4
  443. data/vendor/local/share/doc/groonga/ja/html/_sources/install/solaris.txt +3 -3
  444. data/vendor/local/share/doc/groonga/ja/html/_sources/install/ubuntu.txt +5 -5
  445. data/vendor/local/share/doc/groonga/ja/html/_sources/install/windows.txt +9 -9
  446. data/vendor/local/share/doc/groonga/ja/html/_sources/news.txt +149 -1194
  447. data/vendor/local/share/doc/groonga/ja/html/_sources/news/1.3.x.txt +49 -0
  448. data/vendor/local/share/doc/groonga/ja/html/_sources/news/2.x.txt +617 -0
  449. data/vendor/local/share/doc/groonga/ja/html/_sources/news/3.x.txt +536 -0
  450. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/api/plugin.txt +122 -3
  451. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/columns/vector.txt +0 -1
  452. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/check.txt +50 -55
  453. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/clearlock.txt +25 -31
  454. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/column_remove.txt +26 -29
  455. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/define_selector.txt +20 -26
  456. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/defrag.txt +26 -29
  457. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/dump.txt +28 -28
  458. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/log_level.txt +20 -26
  459. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/log_put.txt +20 -26
  460. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/log_reopen.txt +29 -34
  461. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/normalizer_list.txt +3 -3
  462. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/quit.txt +20 -20
  463. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/register.txt +2 -2
  464. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/shutdown.txt +19 -20
  465. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/status.txt +19 -24
  466. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/suggest.txt +78 -87
  467. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/table_list.txt +20 -22
  468. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/table_remove.txt +19 -24
  469. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/tokenize.txt +27 -0
  470. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/tokenizer_list.txt +3 -3
  471. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/executables/groonga-benchmark.txt +17 -5
  472. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/executables/groonga-suggest-learner.txt +17 -8
  473. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/executables/groonga.txt +2 -2
  474. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/highlight_full.txt +132 -0
  475. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/highlight_html.txt +100 -0
  476. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/snippet_html.txt +1 -1
  477. data/vendor/local/share/doc/groonga/ja/html/_sources/server/http/comparison.txt +1 -1
  478. data/vendor/local/share/doc/groonga/ja/html/_sources/troubleshooting/mmap_cannot_allocate_memory.txt +1 -1
  479. data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/data.txt +6 -2
  480. data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/drilldown.txt +3 -2
  481. data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/index.txt +28 -25
  482. data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/match_columns.txt +26 -21
  483. data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/network.txt +3 -3
  484. data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/patricia_trie.txt +17 -12
  485. data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/search.txt +44 -42
  486. data/vendor/local/share/doc/groonga/ja/html/_static/basic.css +0 -18
  487. data/vendor/local/share/doc/groonga/ja/html/_static/groonga.css +2 -0
  488. data/vendor/local/share/doc/groonga/ja/html/characteristic.html +17 -19
  489. data/vendor/local/share/doc/groonga/ja/html/community.html +17 -19
  490. data/vendor/local/share/doc/groonga/ja/html/contribution.html +17 -19
  491. data/vendor/local/share/doc/groonga/ja/html/contribution/development.html +17 -19
  492. data/vendor/local/share/doc/groonga/ja/html/contribution/development/com.html +17 -19
  493. data/vendor/local/share/doc/groonga/ja/html/contribution/development/cooperation.html +17 -19
  494. data/vendor/local/share/doc/groonga/ja/html/contribution/development/query.html +17 -19
  495. data/vendor/local/share/doc/groonga/ja/html/contribution/development/release.html +17 -19
  496. data/vendor/local/share/doc/groonga/ja/html/contribution/development/repository.html +17 -19
  497. data/vendor/local/share/doc/groonga/ja/html/contribution/development/test.html +17 -19
  498. data/vendor/local/share/doc/groonga/ja/html/contribution/documentation.html +17 -19
  499. data/vendor/local/share/doc/groonga/ja/html/contribution/documentation/c-api.html +17 -19
  500. data/vendor/local/share/doc/groonga/ja/html/contribution/documentation/i18n.html +19 -21
  501. data/vendor/local/share/doc/groonga/ja/html/contribution/documentation/introduction.html +17 -19
  502. data/vendor/local/share/doc/groonga/ja/html/contribution/report.html +18 -20
  503. data/vendor/local/share/doc/groonga/ja/html/development.html +17 -19
  504. data/vendor/local/share/doc/groonga/ja/html/development/travis-ci.html +17 -19
  505. data/vendor/local/share/doc/groonga/ja/html/genindex.html +136 -26
  506. data/vendor/local/share/doc/groonga/ja/html/geolocation_search.html +17 -19
  507. data/vendor/local/share/doc/groonga/ja/html/index.html +53 -53
  508. data/vendor/local/share/doc/groonga/ja/html/install.html +17 -19
  509. data/vendor/local/share/doc/groonga/ja/html/install/centos.html +44 -50
  510. data/vendor/local/share/doc/groonga/ja/html/install/debian.html +62 -36
  511. data/vendor/local/share/doc/groonga/ja/html/install/fedora.html +33 -35
  512. data/vendor/local/share/doc/groonga/ja/html/install/mac_os_x.html +20 -22
  513. data/vendor/local/share/doc/groonga/ja/html/install/others.html +21 -23
  514. data/vendor/local/share/doc/groonga/ja/html/install/solaris.html +20 -22
  515. data/vendor/local/share/doc/groonga/ja/html/install/ubuntu.html +34 -36
  516. data/vendor/local/share/doc/groonga/ja/html/install/windows.html +26 -28
  517. data/vendor/local/share/doc/groonga/ja/html/limitations.html +17 -19
  518. data/vendor/local/share/doc/groonga/ja/html/news.html +354 -1643
  519. data/vendor/local/share/doc/groonga/ja/html/news/0.x.html +17 -19
  520. data/vendor/local/share/doc/groonga/ja/html/news/1.0.x.html +17 -19
  521. data/vendor/local/share/doc/groonga/ja/html/news/1.1.x.html +17 -19
  522. data/vendor/local/share/doc/groonga/ja/html/news/1.2.x.html +17 -19
  523. data/vendor/local/share/doc/groonga/ja/html/news/1.3.x.html +180 -0
  524. data/vendor/local/share/doc/groonga/ja/html/news/2.x.html +950 -0
  525. data/vendor/local/share/doc/groonga/ja/html/news/3.x.html +831 -0
  526. data/vendor/local/share/doc/groonga/ja/html/news/senna.html +17 -19
  527. data/vendor/local/share/doc/groonga/ja/html/objects.inv +0 -0
  528. data/vendor/local/share/doc/groonga/ja/html/reference.html +41 -41
  529. data/vendor/local/share/doc/groonga/ja/html/reference/api.html +17 -19
  530. data/vendor/local/share/doc/groonga/ja/html/reference/api/global_configurations.html +19 -21
  531. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_cache.html +24 -26
  532. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_column.html +23 -25
  533. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_command_version.html +19 -21
  534. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_ctx.html +28 -30
  535. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_db.html +21 -23
  536. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_encoding.html +21 -23
  537. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_expr.html +30 -32
  538. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_geo.html +21 -23
  539. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_hook.html +21 -23
  540. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_ii.html +21 -23
  541. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_index_cursor.html +19 -21
  542. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_info.html +21 -23
  543. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_match_escalation.html +21 -23
  544. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_obj.html +40 -42
  545. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_proc.html +20 -22
  546. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_search.html +18 -20
  547. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_table.html +35 -37
  548. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_table_cursor.html +25 -27
  549. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_type.html +18 -20
  550. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_user_data.html +18 -20
  551. data/vendor/local/share/doc/groonga/ja/html/reference/api/plugin.html +226 -24
  552. data/vendor/local/share/doc/groonga/ja/html/reference/cast.html +17 -19
  553. data/vendor/local/share/doc/groonga/ja/html/reference/column.html +17 -19
  554. data/vendor/local/share/doc/groonga/ja/html/reference/columns/pseudo.html +17 -19
  555. data/vendor/local/share/doc/groonga/ja/html/reference/columns/vector.html +17 -21
  556. data/vendor/local/share/doc/groonga/ja/html/reference/command.html +33 -35
  557. data/vendor/local/share/doc/groonga/ja/html/reference/command/command_version.html +17 -19
  558. data/vendor/local/share/doc/groonga/ja/html/reference/command/output_format.html +17 -19
  559. data/vendor/local/share/doc/groonga/ja/html/reference/command/return_code.html +17 -19
  560. data/vendor/local/share/doc/groonga/ja/html/reference/commands/cache_limit.html +18 -20
  561. data/vendor/local/share/doc/groonga/ja/html/reference/commands/check.html +73 -85
  562. data/vendor/local/share/doc/groonga/ja/html/reference/commands/clearlock.html +50 -62
  563. data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_create.html +18 -20
  564. data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_list.html +42 -57
  565. data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_remove.html +53 -65
  566. data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_rename.html +27 -35
  567. data/vendor/local/share/doc/groonga/ja/html/reference/commands/define_selector.html +45 -57
  568. data/vendor/local/share/doc/groonga/ja/html/reference/commands/defrag.html +49 -59
  569. data/vendor/local/share/doc/groonga/ja/html/reference/commands/delete.html +19 -21
  570. data/vendor/local/share/doc/groonga/ja/html/reference/commands/dump.html +47 -51
  571. data/vendor/local/share/doc/groonga/ja/html/reference/commands/load.html +19 -21
  572. data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_level.html +44 -56
  573. data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_put.html +45 -57
  574. data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_reopen.html +54 -63
  575. data/vendor/local/share/doc/groonga/ja/html/reference/commands/normalize.html +20 -22
  576. data/vendor/local/share/doc/groonga/ja/html/reference/commands/normalizer_list.html +27 -30
  577. data/vendor/local/share/doc/groonga/ja/html/reference/commands/quit.html +42 -46
  578. data/vendor/local/share/doc/groonga/ja/html/reference/commands/register.html +20 -22
  579. data/vendor/local/share/doc/groonga/ja/html/reference/commands/ruby_eval.html +18 -20
  580. data/vendor/local/share/doc/groonga/ja/html/reference/commands/ruby_load.html +17 -19
  581. data/vendor/local/share/doc/groonga/ja/html/reference/commands/select.html +18 -20
  582. data/vendor/local/share/doc/groonga/ja/html/reference/commands/shutdown.html +41 -46
  583. data/vendor/local/share/doc/groonga/ja/html/reference/commands/status.html +52 -64
  584. data/vendor/local/share/doc/groonga/ja/html/reference/commands/suggest.html +195 -207
  585. data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_create.html +19 -21
  586. data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_list.html +74 -81
  587. data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_remove.html +42 -54
  588. data/vendor/local/share/doc/groonga/ja/html/reference/commands/tokenize.html +172 -21
  589. data/vendor/local/share/doc/groonga/ja/html/reference/commands/tokenizer_list.html +26 -29
  590. data/vendor/local/share/doc/groonga/ja/html/reference/commands/truncate.html +17 -19
  591. data/vendor/local/share/doc/groonga/ja/html/reference/executables.html +17 -19
  592. data/vendor/local/share/doc/groonga/ja/html/reference/executables/grnslap.html +17 -19
  593. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-benchmark.html +31 -24
  594. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-httpd.html +17 -19
  595. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-server-http.html +17 -19
  596. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-create-dataset.html +17 -19
  597. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-httpd.html +17 -19
  598. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-learner.html +38 -27
  599. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga.html +19 -21
  600. data/vendor/local/share/doc/groonga/ja/html/reference/function.html +25 -25
  601. data/vendor/local/share/doc/groonga/ja/html/reference/functions/between.html +18 -21
  602. data/vendor/local/share/doc/groonga/ja/html/reference/functions/edit_distance.html +17 -19
  603. data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_distance.html +17 -19
  604. data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_in_circle.html +17 -19
  605. data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_in_rectangle.html +22 -24
  606. data/vendor/local/share/doc/groonga/ja/html/reference/functions/highlight_full.html +294 -0
  607. data/vendor/local/share/doc/groonga/ja/html/reference/functions/highlight_html.html +266 -0
  608. data/vendor/local/share/doc/groonga/ja/html/reference/functions/html_untag.html +42 -44
  609. data/vendor/local/share/doc/groonga/ja/html/reference/functions/now.html +37 -39
  610. data/vendor/local/share/doc/groonga/ja/html/reference/functions/query.html +55 -62
  611. data/vendor/local/share/doc/groonga/ja/html/reference/functions/rand.html +39 -41
  612. data/vendor/local/share/doc/groonga/ja/html/reference/functions/snippet_html.html +39 -41
  613. data/vendor/local/share/doc/groonga/ja/html/reference/functions/sub_filter.html +39 -41
  614. data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr.html +17 -19
  615. data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr/query_syntax.html +17 -19
  616. data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr/script_syntax.html +17 -19
  617. data/vendor/local/share/doc/groonga/ja/html/reference/indexing.html +21 -23
  618. data/vendor/local/share/doc/groonga/ja/html/reference/log.html +18 -20
  619. data/vendor/local/share/doc/groonga/ja/html/reference/normalizers.html +17 -19
  620. data/vendor/local/share/doc/groonga/ja/html/reference/output.html +17 -19
  621. data/vendor/local/share/doc/groonga/ja/html/reference/query_expanders.html +17 -19
  622. data/vendor/local/share/doc/groonga/ja/html/reference/query_expanders/tsv.html +17 -19
  623. data/vendor/local/share/doc/groonga/ja/html/reference/tables.html +17 -19
  624. data/vendor/local/share/doc/groonga/ja/html/reference/tokenizers.html +17 -19
  625. data/vendor/local/share/doc/groonga/ja/html/reference/tuning.html +17 -19
  626. data/vendor/local/share/doc/groonga/ja/html/reference/types.html +17 -19
  627. data/vendor/local/share/doc/groonga/ja/html/search.html +11 -11
  628. data/vendor/local/share/doc/groonga/ja/html/searchindex.js +1 -1
  629. data/vendor/local/share/doc/groonga/ja/html/server.html +17 -19
  630. data/vendor/local/share/doc/groonga/ja/html/server/gqtp.html +17 -19
  631. data/vendor/local/share/doc/groonga/ja/html/server/http.html +17 -19
  632. data/vendor/local/share/doc/groonga/ja/html/server/http/comparison.html +18 -20
  633. data/vendor/local/share/doc/groonga/ja/html/server/http/groonga-httpd.html +17 -19
  634. data/vendor/local/share/doc/groonga/ja/html/server/http/groonga.html +17 -19
  635. data/vendor/local/share/doc/groonga/ja/html/server/package.html +17 -19
  636. data/vendor/local/share/doc/groonga/ja/html/spec.html +17 -19
  637. data/vendor/local/share/doc/groonga/ja/html/spec/gqtp.html +17 -19
  638. data/vendor/local/share/doc/groonga/ja/html/spec/search.html +17 -19
  639. data/vendor/local/share/doc/groonga/ja/html/suggest.html +17 -19
  640. data/vendor/local/share/doc/groonga/ja/html/suggest/completion.html +17 -19
  641. data/vendor/local/share/doc/groonga/ja/html/suggest/correction.html +17 -19
  642. data/vendor/local/share/doc/groonga/ja/html/suggest/introduction.html +17 -19
  643. data/vendor/local/share/doc/groonga/ja/html/suggest/suggestion.html +17 -19
  644. data/vendor/local/share/doc/groonga/ja/html/suggest/tutorial.html +17 -19
  645. data/vendor/local/share/doc/groonga/ja/html/troubleshooting.html +17 -19
  646. data/vendor/local/share/doc/groonga/ja/html/troubleshooting/different_results_with_the_same_keyword.html +17 -19
  647. data/vendor/local/share/doc/groonga/ja/html/troubleshooting/mmap_cannot_allocate_memory.html +18 -20
  648. data/vendor/local/share/doc/groonga/ja/html/tutorial.html +29 -31
  649. data/vendor/local/share/doc/groonga/ja/html/tutorial/data.html +24 -26
  650. data/vendor/local/share/doc/groonga/ja/html/tutorial/drilldown.html +28 -31
  651. data/vendor/local/share/doc/groonga/ja/html/tutorial/index.html +33 -35
  652. data/vendor/local/share/doc/groonga/ja/html/tutorial/introduction.html +20 -22
  653. data/vendor/local/share/doc/groonga/ja/html/tutorial/lexicon.html +17 -19
  654. data/vendor/local/share/doc/groonga/ja/html/tutorial/match_columns.html +43 -43
  655. data/vendor/local/share/doc/groonga/ja/html/tutorial/micro_blog.html +19 -21
  656. data/vendor/local/share/doc/groonga/ja/html/tutorial/network.html +21 -23
  657. data/vendor/local/share/doc/groonga/ja/html/tutorial/patricia_trie.html +39 -38
  658. data/vendor/local/share/doc/groonga/ja/html/tutorial/query_expansion.html +17 -19
  659. data/vendor/local/share/doc/groonga/ja/html/tutorial/search.html +68 -64
  660. data/vendor/local/share/groonga/examples/dictionary/edict/edict-import.sh +0 -0
  661. data/vendor/local/share/groonga/examples/dictionary/edict/edict2grn.rb +2 -2
  662. data/vendor/local/share/groonga/examples/dictionary/eijiro/eijiro-import.sh +0 -0
  663. data/vendor/local/share/groonga/examples/dictionary/eijiro/eijiro2grn.rb +0 -0
  664. data/vendor/local/share/groonga/examples/dictionary/gene95/gene-import.sh +0 -0
  665. data/vendor/local/share/groonga/examples/dictionary/gene95/gene2grn.rb +0 -0
  666. data/vendor/local/share/groonga/examples/dictionary/html/index.html +2 -2
  667. data/vendor/local/share/groonga/examples/dictionary/html/js/jquery-1.7.2.min.js +4 -0
  668. data/vendor/local/share/groonga/examples/dictionary/html/js/jquery-ui-1.8.18.custom.min.js +356 -0
  669. data/vendor/local/share/groonga/examples/dictionary/init-db.sh +0 -0
  670. data/vendor/local/share/groonga/examples/dictionary/jmdict/jmdict.rb +0 -0
  671. data/vendor/local/share/groonga/html/admin/css/groonga-admin.css +11 -0
  672. data/vendor/local/share/groonga/html/admin/index.html +75 -75
  673. data/vendor/local/share/groonga/html/admin/index.ja.html +301 -0
  674. data/vendor/local/share/groonga/html/admin/js/groonga-admin.ja.js +1372 -0
  675. data/vendor/local/share/groonga/html/admin/js/groonga-admin.js +28 -28
  676. data/vendor/local/share/license/groonga/README.md +49 -0
  677. data/vendor/local/share/man/ja/man1/groonga.1 +1934 -1247
  678. data/vendor/local/share/man/man1/groonga.1 +2008 -1240
  679. metadata +111 -83
  680. data/vendor/local/share/groonga/examples/dictionary/html/js/jquery-1.6.0.min.js +0 -16
  681. data/vendor/local/share/groonga/examples/dictionary/html/js/jquery-ui-1.8.12.min.js +0 -406
  682. data/vendor/local/share/license/groonga/AUTHORS +0 -17
data/vendor/local/share/man/man1/groonga.1 CHANGED
@@ -1,6 +1,6 @@
1
1
  .\" Man page generated from reStructuredText.
2
2
  .
3
- .TH "GROONGA" "1" "May 29, 2014" "4.0.2" "Groonga"
3
+ .TH "GROONGA" "1" "August 28, 2014" "4.0.5" "Groonga"
4
4
  .SH NAME
5
5
  groonga \- Groonga documentation
6
6
  .
@@ -110,7 +110,7 @@ packages.groonga.org:
110
110
  .INDENT 3.5
111
111
  .INDENT 0.0
112
112
  .IP \(bu 2
113
- \fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.2\-x86.exe\fP
113
+ \fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.5\-x86.exe\fP
114
114
  .UNINDENT
115
115
  .UNINDENT
116
116
  .UNINDENT
@@ -123,7 +123,7 @@ packages.goronga.org:
123
123
  .INDENT 3.5
124
124
  .INDENT 0.0
125
125
  .IP \(bu 2
126
- \fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.2\-x64.exe\fP
126
+ \fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.5\-x64.exe\fP
127
127
  .UNINDENT
128
128
  .UNINDENT
129
129
  .UNINDENT
@@ -140,7 +140,7 @@ packages.groonga.org:
140
140
  .INDENT 3.5
141
141
  .INDENT 0.0
142
142
  .IP \(bu 2
143
- \fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.2\-x86.zip\fP
143
+ \fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.5\-x86.zip\fP
144
144
  .UNINDENT
145
145
  .UNINDENT
146
146
  .UNINDENT
@@ -153,7 +153,7 @@ packages.groonga.org:
153
153
  .INDENT 3.5
154
154
  .INDENT 0.0
155
155
  .IP \(bu 2
156
- \fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.2\-x64.zip\fP
156
+ \fI\%http://packages.groonga.org/windows/groonga/groonga\-4.0.5\-x64.zip\fP
157
157
  .UNINDENT
158
158
  .UNINDENT
159
159
  .UNINDENT
@@ -181,7 +181,7 @@ Download zipped source from packages.groonga.org:
181
181
  .INDENT 3.5
182
182
  .INDENT 0.0
183
183
  .IP \(bu 2
184
- \fI\%http://packages.groonga.org/source/groonga/groonga\-4.0.2.zip\fP
184
+ \fI\%http://packages.groonga.org/source/groonga/groonga\-4.0.5.zip\fP
185
185
  .UNINDENT
186
186
  .UNINDENT
187
187
  .UNINDENT
@@ -194,7 +194,7 @@ Move to the Groonga\(aqs source folder:
194
194
  .sp
195
195
  .nf
196
196
  .ft C
197
- > cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-4.0.2
197
+ > cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-4.0.5
198
198
  .ft P
199
199
  .fi
200
200
  .UNINDENT
@@ -208,7 +208,7 @@ parameter instead:
208
208
  .sp
209
209
  .nf
210
210
  .ft C
211
- groonga\-4.0.2> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\egroonga
211
+ groonga\-4.0.5> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\egroonga
212
212
  .ft P
213
213
  .fi
214
214
  .UNINDENT
@@ -220,7 +220,7 @@ Build:
220
220
  .sp
221
221
  .nf
222
222
  .ft C
223
- groonga\-4.0.2> cmake \-\-build . \-\-config Release
223
+ groonga\-4.0.5> cmake \-\-build . \-\-config Release
224
224
  .ft P
225
225
  .fi
226
226
  .UNINDENT
@@ -232,7 +232,7 @@ Install:
232
232
  .sp
233
233
  .nf
234
234
  .ft C
235
- groonga\-4.0.2> cmake \-\-build . \-\-config Release \-\-target Install
235
+ groonga\-4.0.5> cmake \-\-build . \-\-config Release \-\-target Install
236
236
  .ft P
237
237
  .fi
238
238
  .UNINDENT
@@ -293,9 +293,9 @@ Download source:
293
293
  .sp
294
294
  .nf
295
295
  .ft C
296
- % curl \-O http://packages.groonga.org/source/groonga/groonga\-4.0.2.tar.gz
297
- % tar xvzf groonga\-4.0.2.tar.gz
298
- % cd groonga\-4.0.2
296
+ % curl \-O http://packages.groonga.org/source/groonga/groonga\-4.0.5.tar.gz
297
+ % tar xvzf groonga\-4.0.5.tar.gz
298
+ % cd groonga\-4.0.5
299
299
  .ft P
300
300
  .fi
301
301
  .UNINDENT
@@ -346,27 +346,6 @@ recommend a 64\-bit package for server. You should use a 32\-bit package
346
346
  just only for tests or development. You will encounter an out of
347
347
  memory error with a 32\-bit package even if you just process medium
348
348
  size data.
349
- .sp
350
- \fBNOTE:\fP
351
- .INDENT 0.0
352
- .INDENT 3.5
353
- The package \(aqgroonga\(aq is the mininum set of fulltext search engine.
354
- If you want to use groonga for server use, you can install
355
- additional preconfigured packages.
356
- .sp
357
- There are three packages for server use.
358
- .INDENT 0.0
359
- .IP \(bu 2
360
- groonga\-server\-http (simple HTTP protocol based server package)
361
- .IP \(bu 2
362
- groonga\-httpd (nginx and HTTP protocol based server package)
363
- .IP \(bu 2
364
- groonga\-server\-gqtp (GQTP protocol based server package)
365
- .UNINDENT
366
- .sp
367
- See \fB/server\fP section about details.
368
- .UNINDENT
369
- .UNINDENT
370
349
  .SS wheezy
371
350
  .sp
372
351
  Add the Groonga apt repository.
@@ -399,6 +378,27 @@ Install:
399
378
  .UNINDENT
400
379
  .UNINDENT
401
380
  .sp
381
+ \fBNOTE:\fP
382
+ .INDENT 0.0
383
+ .INDENT 3.5
384
+ \fBgroonga\fP package is the minimum set of fulltext search engine.
385
+ If you want to use Groonga for server use, you can install
386
+ additional preconfigured packages.
387
+ .sp
388
+ There are three packages for server use.
389
+ .INDENT 0.0
390
+ .IP \(bu 2
391
+ groonga\-server\-http (simple HTTP protocol based server package)
392
+ .IP \(bu 2
393
+ groonga\-httpd (nginx and HTTP protocol based server package)
394
+ .IP \(bu 2
395
+ groonga\-server\-gqtp (GQTP protocol based server package)
396
+ .UNINDENT
397
+ .sp
398
+ See \fB/server\fP section about details.
399
+ .UNINDENT
400
+ .UNINDENT
401
+ .sp
402
402
  If you want to use \fI\%MeCab\fP as a
403
403
  tokenizer, install groonga\-tokenizer\-mecab package.
404
404
  .sp
@@ -476,6 +476,27 @@ Install:
476
476
  .UNINDENT
477
477
  .UNINDENT
478
478
  .sp
479
+ \fBNOTE:\fP
480
+ .INDENT 0.0
481
+ .INDENT 3.5
482
+ \fBgroonga\fP package is the minimum set of fulltext search engine.
483
+ If you want to use Groonga for server use, you can install
484
+ additional preconfigured packages.
485
+ .sp
486
+ There are three packages for server use.
487
+ .INDENT 0.0
488
+ .IP \(bu 2
489
+ groonga\-server\-http (simple HTTP protocol based server package)
490
+ .IP \(bu 2
491
+ groonga\-httpd (nginx and HTTP protocol based server package)
492
+ .IP \(bu 2
493
+ groonga\-server\-gqtp (GQTP protocol based server package)
494
+ .UNINDENT
495
+ .sp
496
+ See \fB/server\fP section about details.
497
+ .UNINDENT
498
+ .UNINDENT
499
+ .sp
479
500
  If you want to use \fI\%MeCab\fP as a
480
501
  tokenizer, install groonga\-tokenizer\-mecab package.
481
502
  .sp
@@ -553,6 +574,27 @@ Install:
553
574
  .UNINDENT
554
575
  .UNINDENT
555
576
  .sp
577
+ \fBNOTE:\fP
578
+ .INDENT 0.0
579
+ .INDENT 3.5
580
+ \fBgroonga\fP package is the minimum set of fulltext search engine.
581
+ If you want to use Groonga for server use, you can install
582
+ additional preconfigured packages.
583
+ .sp
584
+ There are three packages for server use.
585
+ .INDENT 0.0
586
+ .IP \(bu 2
587
+ groonga\-server\-http (simple HTTP protocol based server package)
588
+ .IP \(bu 2
589
+ groonga\-httpd (nginx and HTTP protocol based server package)
590
+ .IP \(bu 2
591
+ groonga\-server\-gqtp (GQTP protocol based server package)
592
+ .UNINDENT
593
+ .sp
594
+ See \fB/server\fP section about details.
595
+ .UNINDENT
596
+ .UNINDENT
597
+ .sp
556
598
  If you want to use \fI\%MeCab\fP as a
557
599
  tokenizer, install groonga\-tokenizer\-mecab package.
558
600
  .sp
@@ -618,9 +660,9 @@ Download source:
618
660
  .sp
619
661
  .nf
620
662
  .ft C
621
- % wget http://packages.groonga.org/source/groonga/groonga\-4.0.2.tar.gz
622
- % tar xvzf groonga\-4.0.2.tar.gz
623
- % cd groonga\-4.0.2
663
+ % wget http://packages.groonga.org/source/groonga/groonga\-4.0.5.tar.gz
664
+ % tar xvzf groonga\-4.0.5.tar.gz
665
+ % cd groonga\-4.0.5
624
666
  .ft P
625
667
  .fi
626
668
  .UNINDENT
@@ -671,27 +713,6 @@ recommend a 64\-bit package for server. You should use a 32\-bit package
671
713
  just only for tests or development. You will encounter an out of
672
714
  memory error with a 32\-bit package even if you just process medium
673
715
  size data.
674
- .sp
675
- \fBNOTE:\fP
676
- .INDENT 0.0
677
- .INDENT 3.5
678
- The package \(aqgroonga\(aq is the mininum set of fulltext search engine.
679
- If you want to use groonga for server use, you can install
680
- additional preconfigured packages.
681
- .sp
682
- There are three packages for server use.
683
- .INDENT 0.0
684
- .IP \(bu 2
685
- groonga\-server\-http (simple HTTP protocol based server package)
686
- .IP \(bu 2
687
- groonga\-httpd (nginx and HTTP protocol based server package)
688
- .IP \(bu 2
689
- groonga\-server\-gqtp (GQTP protocol based server package)
690
- .UNINDENT
691
- .sp
692
- See \fB/server\fP section about details.
693
- .UNINDENT
694
- .UNINDENT
695
716
  .SS PPA (Personal Package Archive)
696
717
  .sp
697
718
  The Groonga APT repository for Ubuntu uses PPA (Personal Package
@@ -749,6 +770,27 @@ Install:
749
770
  .UNINDENT
750
771
  .UNINDENT
751
772
  .sp
773
+ \fBNOTE:\fP
774
+ .INDENT 0.0
775
+ .INDENT 3.5
776
+ \fBgroonga\fP package is the minimum set of fulltext search engine.
777
+ If you want to use Groonga for server use, you can install
778
+ additional preconfigured packages.
779
+ .sp
780
+ There are three packages for server use.
781
+ .INDENT 0.0
782
+ .IP \(bu 2
783
+ groonga\-server\-http (simple HTTP protocol based server package)
784
+ .IP \(bu 2
785
+ groonga\-httpd (nginx and HTTP protocol based server package)
786
+ .IP \(bu 2
787
+ groonga\-server\-gqtp (GQTP protocol based server package)
788
+ .UNINDENT
789
+ .sp
790
+ See \fB/server\fP section about details.
791
+ .UNINDENT
792
+ .UNINDENT
793
+ .sp
752
794
  If you want to use \fI\%MeCab\fP as a
753
795
  tokenizer, install groonga\-tokenizer\-mecab package.
754
796
  .sp
@@ -814,9 +856,9 @@ Download source:
814
856
  .sp
815
857
  .nf
816
858
  .ft C
817
- % wget http://packages.groonga.org/source/groonga/groonga\-4.0.2.tar.gz
818
- % tar xvzf groonga\-4.0.2.tar.gz
819
- % cd groonga\-4.0.2
859
+ % wget http://packages.groonga.org/source/groonga/groonga\-4.0.5.tar.gz
860
+ % tar xvzf groonga\-4.0.5.tar.gz
861
+ % cd groonga\-4.0.5
820
862
  .ft P
821
863
  .fi
822
864
  .UNINDENT
@@ -867,12 +909,27 @@ recommend a 64\-bit package for server. You should use a 32\-bit package
867
909
  just only for tests or development. You will encounter an out of
868
910
  memory error with a 32\-bit package even if you just process medium
869
911
  size data.
912
+ .SS CentOS 5
913
+ .sp
914
+ Install:
915
+ .INDENT 0.0
916
+ .INDENT 3.5
917
+ .sp
918
+ .nf
919
+ .ft C
920
+ % sudo rpm \-ivh http://packages.groonga.org/centos/groonga\-release\-1.1.0\-1.noarch.rpm
921
+ % sudo yum makecache
922
+ % sudo yum install \-y groonga
923
+ .ft P
924
+ .fi
925
+ .UNINDENT
926
+ .UNINDENT
870
927
  .sp
871
928
  \fBNOTE:\fP
872
929
  .INDENT 0.0
873
930
  .INDENT 3.5
874
- The package \(aqgroonga\(aq is the mininum set of fulltext search engine.
875
- If you want to use groonga for server use, you can install
931
+ \fBgroonga\fP package is the minimum set of fulltext search engine.
932
+ If you want to use Groonga for server use, you can install
876
933
  additional preconfigured packages.
877
934
  .sp
878
935
  There are three packages for server use.
@@ -888,21 +945,6 @@ groonga\-server\-gqtp (GQTP protocol based server package)
888
945
  See \fB/server\fP section about details.
889
946
  .UNINDENT
890
947
  .UNINDENT
891
- .SS CentOS 5
892
- .sp
893
- Install:
894
- .INDENT 0.0
895
- .INDENT 3.5
896
- .sp
897
- .nf
898
- .ft C
899
- % sudo rpm \-ivh http://packages.groonga.org/centos/groonga\-release\-1.1.0\-1.noarch.rpm
900
- % sudo yum makecache
901
- % sudo yum install \-y groonga
902
- .ft P
903
- .fi
904
- .UNINDENT
905
- .UNINDENT
906
948
  .sp
907
949
  If you want to use \fI\%MeCab\fP as a
908
950
  tokenizer, install groonga\-tokenizer\-mecab package.
@@ -919,32 +961,6 @@ Install groonga\-tokenizer\-mecab package:
919
961
  .UNINDENT
920
962
  .UNINDENT
921
963
  .sp
922
- Then install MeCab dictionary. (mecab\-ipadic or mecab\-jumandic)
923
- .sp
924
- Install IPA dictionary:
925
- .INDENT 0.0
926
- .INDENT 3.5
927
- .sp
928
- .nf
929
- .ft C
930
- % sudo yum install \-y mecab\-ipadic
931
- .ft P
932
- .fi
933
- .UNINDENT
934
- .UNINDENT
935
- .sp
936
- Or install Juman dictionary:
937
- .INDENT 0.0
938
- .INDENT 3.5
939
- .sp
940
- .nf
941
- .ft C
942
- % sudo yum install \-y mecab\-jumandic
943
- .ft P
944
- .fi
945
- .UNINDENT
946
- .UNINDENT
947
- .sp
948
964
  There is a package that provides \fI\%Munin\fP plugins. If you want to monitor
949
965
  Groonga status by Munin, install groonga\-munin\-plugins package.
950
966
  .sp
@@ -1041,42 +1057,37 @@ Install:
1041
1057
  .UNINDENT
1042
1058
  .UNINDENT
1043
1059
  .sp
1044
- If you want to use \fI\%MeCab\fP as a
1045
- tokenizer, install groonga\-tokenizer\-mecab package.
1046
- .sp
1047
- Install groonga\-tokenizer\-mecab package:
1060
+ \fBNOTE:\fP
1048
1061
  .INDENT 0.0
1049
1062
  .INDENT 3.5
1063
+ \fBgroonga\fP package is the minimum set of fulltext search engine.
1064
+ If you want to use Groonga for server use, you can install
1065
+ additional preconfigured packages.
1050
1066
  .sp
1051
- .nf
1052
- .ft C
1053
- % sudo yum install \-y groonga\-tokenizer\-mecab
1054
- .ft P
1055
- .fi
1056
- .UNINDENT
1057
- .UNINDENT
1058
- .sp
1059
- Then install MeCab dictionary. (mecab\-ipadic or mecab\-jumandic)
1060
- .sp
1061
- Install IPA dictionary:
1067
+ There are three packages for server use.
1062
1068
  .INDENT 0.0
1063
- .INDENT 3.5
1069
+ .IP \(bu 2
1070
+ groonga\-server\-http (simple HTTP protocol based server package)
1071
+ .IP \(bu 2
1072
+ groonga\-httpd (nginx and HTTP protocol based server package)
1073
+ .IP \(bu 2
1074
+ groonga\-server\-gqtp (GQTP protocol based server package)
1075
+ .UNINDENT
1064
1076
  .sp
1065
- .nf
1066
- .ft C
1067
- % sudo yum install \-y mecab\-ipadic
1068
- .ft P
1069
- .fi
1077
+ See \fB/server\fP section about details.
1070
1078
  .UNINDENT
1071
1079
  .UNINDENT
1072
1080
  .sp
1073
- Or install Juman dictionary:
1081
+ If you want to use \fI\%MeCab\fP as a
1082
+ tokenizer, install groonga\-tokenizer\-mecab package.
1083
+ .sp
1084
+ Install groonga\-tokenizer\-mecab package:
1074
1085
  .INDENT 0.0
1075
1086
  .INDENT 3.5
1076
1087
  .sp
1077
1088
  .nf
1078
1089
  .ft C
1079
- % sudo yum install \-y mecab\-jumandic
1090
+ % sudo yum install \-y groonga\-tokenizer\-mecab
1080
1091
  .ft P
1081
1092
  .fi
1082
1093
  .UNINDENT
@@ -1154,9 +1165,9 @@ Download source:
1154
1165
  .sp
1155
1166
  .nf
1156
1167
  .ft C
1157
- % wget http://packages.groonga.org/source/groonga/groonga\-4.0.2.tar.gz
1158
- % tar xvzf groonga\-4.0.2.tar.gz
1159
- % cd groonga\-4.0.2
1168
+ % wget http://packages.groonga.org/source/groonga/groonga\-4.0.5.tar.gz
1169
+ % tar xvzf groonga\-4.0.5.tar.gz
1170
+ % cd groonga\-4.0.5
1160
1171
  .ft P
1161
1172
  .fi
1162
1173
  .UNINDENT
@@ -1205,13 +1216,12 @@ Fedora. You can install them by \fByum\fP\&.
1205
1216
  \fBNOTE:\fP
1206
1217
  .INDENT 0.0
1207
1218
  .INDENT 3.5
1208
- Since Groonga 3.0.2 release, Groonga related RPM pakcages are in the official
1209
- Fedora yum repository (Fedora 18). So you can use them instead of the groonga yum
1210
- repository now. There is some exceptions to use the groonga yum
1211
- repository because \fBgroonga\-normalizer\-mysql\fP and mecab dictionaries
1212
- (mecab\-ipadic or mecab\-jumandic) are provided by
1213
- the groonga yum repository. But we will also plan to release
1214
- \fBgroonga\-normalizer\-mysql\fP in the official Fedora yum repository in the future.
1219
+ Since Groonga 3.0.2 release, Groonga related RPM pakcages are in the
1220
+ official Fedora yum repository (Fedora 18). So you can use them
1221
+ instead of the Groonga yum repository now. There is some exceptions
1222
+ to use the Groonga yum repository because mecab dictionaries
1223
+ (mecab\-ipadic or mecab\-jumandic) are provided by the Groonga yum
1224
+ repository.
1215
1225
  .UNINDENT
1216
1226
  .UNINDENT
1217
1227
  .sp
@@ -1220,27 +1230,6 @@ recommend a 64\-bit package for server. You should use a 32\-bit package
1220
1230
  just only for tests or development. You will encounter an out of
1221
1231
  memory error with a 32\-bit package even if you just process medium
1222
1232
  size data.
1223
- .sp
1224
- \fBNOTE:\fP
1225
- .INDENT 0.0
1226
- .INDENT 3.5
1227
- The package \(aqgroonga\(aq is the mininum set of fulltext search engine.
1228
- If you want to use groonga for server use, you can install
1229
- additional preconfigured packages.
1230
- .sp
1231
- There are three packages for server use.
1232
- .INDENT 0.0
1233
- .IP \(bu 2
1234
- groonga\-server\-http (simple HTTP protocol based server package)
1235
- .IP \(bu 2
1236
- groonga\-httpd (nginx and HTTP protocol based server package)
1237
- .IP \(bu 2
1238
- groonga\-server\-gqtp (GQTP protocol based server package)
1239
- .UNINDENT
1240
- .sp
1241
- See \fB/server\fP section about details.
1242
- .UNINDENT
1243
- .UNINDENT
1244
1233
  .SS Fedora 20
1245
1234
  .sp
1246
1235
  Install:
@@ -1255,9 +1244,8 @@ Install:
1255
1244
  .UNINDENT
1256
1245
  .UNINDENT
1257
1246
  .sp
1258
- Note that additional packages such as \fBgroonga\-normalizer\-mysql\fP,
1259
- \fBmecab\-dic\fP and \fBmecab\-jumandic\fP packages require to install
1260
- \fBgroonga\-release\fP package which provides the groonga yum repository beforehand:
1247
+ Note that additional packages such as \fBmecab\-dic\fP and \fBmecab\-jumandic\fP packages require to install
1248
+ \fBgroonga\-release\fP package which provides the Groonga yum repository beforehand:
1261
1249
  .INDENT 0.0
1262
1250
  .INDENT 3.5
1263
1251
  .sp
@@ -1270,6 +1258,27 @@ Note that additional packages such as \fBgroonga\-normalizer\-mysql\fP,
1270
1258
  .UNINDENT
1271
1259
  .UNINDENT
1272
1260
  .sp
1261
+ \fBNOTE:\fP
1262
+ .INDENT 0.0
1263
+ .INDENT 3.5
1264
+ \fBgroonga\fP package is the minimum set of fulltext search engine.
1265
+ If you want to use Groonga for server use, you can install
1266
+ additional preconfigured packages.
1267
+ .sp
1268
+ There are three packages for server use.
1269
+ .INDENT 0.0
1270
+ .IP \(bu 2
1271
+ groonga\-server\-http (simple HTTP protocol based server package)
1272
+ .IP \(bu 2
1273
+ groonga\-httpd (nginx and HTTP protocol based server package)
1274
+ .IP \(bu 2
1275
+ groonga\-server\-gqtp (GQTP protocol based server package)
1276
+ .UNINDENT
1277
+ .sp
1278
+ See \fB/server\fP section about details.
1279
+ .UNINDENT
1280
+ .UNINDENT
1281
+ .sp
1273
1282
  If you want to use \fI\%MeCab\fP as a
1274
1283
  tokenizer, install groonga\-tokenizer\-mecab package.
1275
1284
  .sp
@@ -1361,9 +1370,9 @@ Download source:
1361
1370
  .sp
1362
1371
  .nf
1363
1372
  .ft C
1364
- % wget http://packages.groonga.org/source/groonga/groonga\-4.0.2.tar.gz
1365
- % tar xvzf groonga\-4.0.2.tar.gz
1366
- % cd groonga\-4.0.2
1373
+ % wget http://packages.groonga.org/source/groonga/groonga\-4.0.5.tar.gz
1374
+ % tar xvzf groonga\-4.0.5.tar.gz
1375
+ % cd groonga\-4.0.5
1367
1376
  .ft P
1368
1377
  .fi
1369
1378
  .UNINDENT
@@ -1428,9 +1437,9 @@ Download source:
1428
1437
  .sp
1429
1438
  .nf
1430
1439
  .ft C
1431
- % wget http://packages.groonga.org/source/groonga/groonga\-4.0.2.tar.gz
1432
- % gtar xvzf groonga\-4.0.2.tar.gz
1433
- % cd groonga\-4.0.2
1440
+ % wget http://packages.groonga.org/source/groonga/groonga\-4.0.5.tar.gz
1441
+ % gtar xvzf groonga\-4.0.5.tar.gz
1442
+ % cd groonga\-4.0.5
1434
1443
  .ft P
1435
1444
  .fi
1436
1445
  .UNINDENT
@@ -1570,9 +1579,9 @@ steps:
1570
1579
  .sp
1571
1580
  .nf
1572
1581
  .ft C
1573
- % wget http://packages.groonga.org/source/groonga/groonga\-4.0.2.tar.gz
1574
- % tar xvzf groonga\-4.0.2.tar.gz
1575
- % cd groonga\-4.0.2
1582
+ % wget http://packages.groonga.org/source/groonga/groonga\-4.0.5.tar.gz
1583
+ % tar xvzf groonga\-4.0.5.tar.gz
1584
+ % cd groonga\-4.0.5
1576
1585
  % ./configure
1577
1586
  % make
1578
1587
  % sudo make install
@@ -1640,7 +1649,7 @@ command line option. So this option is not critical build option. It\(aqs
1640
1649
  just for convenient.
1641
1650
  .sp
1642
1651
  The default is \fB/usr/local/var/log/groonga.log\fP\&. The
1643
- \fB/usr/local/var\fP part is changed by \fB\-\-localestatedir\fP option.
1652
+ \fB/usr/local/var\fP part is changed by \fB\-\-localstatedir\fP option.
1644
1653
  .sp
1645
1654
  Here is an example that log file is placed into shared NFS directory
1646
1655
  \fB/nfs/log/groonga.log\fP:
@@ -3040,7 +3049,7 @@ groonga [\-p PORT_NUMBER] \-s DB_PATH
3040
3049
  .UNINDENT
3041
3050
  .UNINDENT
3042
3051
  .sp
3043
- The \fI\-s\fP option specifies to run Groonga as a server. DB_PATH specifies the path of the existing database to be hosted. The \fI\-p\fP 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\(aqt specify PORT_NUMBER.
3052
+ The \fI\-s\fP option specifies to run Groonga as a server. DB_PATH specifies the path of the existing database to be hosted. The \fI\-p\fP 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\(aqt specify PORT_NUMBER.
3044
3053
  .sp
3045
3054
  The following command runs a server that listens on the default port number. The server accepts operations to the specified database.
3046
3055
  .sp
@@ -3104,7 +3113,7 @@ groonga [\-p PORT_NUMBER] \-c [HOST_NAME_OR_IP_ADDRESS]
3104
3113
  .UNINDENT
3105
3114
  .UNINDENT
3106
3115
  .sp
3107
- 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 \fI\-p\fP option and its argument, PORT_NUMBER, specify the port number of the server. If not specified, Groonga uses the default port number 10041.
3116
+ 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 \fI\-p\fP option and its argument, PORT_NUMBER, specify the port number of the server. If not specified, Groonga uses the default port number 10043.
3108
3117
  .sp
3109
3118
  Execution example:
3110
3119
  .INDENT 0.0
@@ -3191,7 +3200,7 @@ groonga [\-p PORT_NUMBER] \-d \-\-protocol http DB_PATH
3191
3200
  .UNINDENT
3192
3201
  .UNINDENT
3193
3202
  .sp
3194
- The \fI\-\-protocol\fP option and its argument specify the protocol of the server. "http" specifies to use HTTP.
3203
+ The \fI\-\-protocol\fP option and its argument specify the protocol of the server. "http" specifies to use HTTP. If the \fI\-p\fP option is not specified, Groonga uses the default port number 10041.
3195
3204
  .sp
3196
3205
  The following command runs an HTTP server that listens on the port number 80.
3197
3206
  .sp
@@ -3812,12 +3821,13 @@ select \-\-table Site \-\-output_columns _key,title,links._key,links.title \-\-q
3812
3821
  .UNINDENT
3813
3822
  .sp
3814
3823
  The only difference at the first step is the \fIflags\fP parameter that specifies to create a vector column. The \fItype\fP parameter of the \fB/reference/commands/column_create\fP command is the same as in the previous example. Then, the \fB/reference/commands/load\fP command registers three links from "\fI\%http://example.org/\fP" to "\fI\%http://example.net/\fP", "\fI\%http://example.org/\fP" and "\fI\%http://example.com/\fP". After that, the links are confirmed by the \fB/reference/commands/select\fP command. In this case, the primary keys and the titles are output as arrays because links._key and links.title are specified to the \fIoutput_columns\fP parameter.
3815
- .SS さまざまな検索条件の指定
3824
+ .SS Various search conditions
3816
3825
  .sp
3817
- Groongaは、JavaScriptに似た文法での条件絞込や、計算した値を用いたソートを行うことができます。また、位置情報(緯度・経度)を用いた絞込・ソートを行うことができます。
3818
- .SS JavaScriptに似た文法での絞込・全文検索
3826
+ 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).
3827
+ .SS Narrow down & Full\-text search by using syntax like JavaScript
3819
3828
  .sp
3820
- selectコマンドのfilterパラメータは、queryパラメータと同様に、レコードの検索条件を指定します。filterパラメータとqueryパラメータが異なる点は、filterパラメータには、JavaScriptの式に似た文法で条件を指定する点です。
3829
+ The \fBfilter\fP parameter of \fBselect\fP command accepts the search condition.
3830
+ There is one difference between \fBfilter\fP parameter and \fBquery\fP parameter, you need to specify the condition by syntax like JavaScript for \fBfilter\fP parameter.
3821
3831
  .sp
3822
3832
  Execution example:
3823
3833
  .INDENT 0.0
@@ -3859,16 +3869,21 @@ select \-\-table Site \-\-filter "_id <= 1" \-\-output_columns _id,_key
3859
3869
  .UNINDENT
3860
3870
  .UNINDENT
3861
3871
  .sp
3862
- ここで、filterパラメータには
3872
+ See the detail of above query. Here is the condition which is specified as \fBfilter\fP parameter:
3863
3873
  .INDENT 0.0
3864
3874
  .INDENT 3.5
3875
+ .sp
3876
+ .nf
3877
+ .ft C
3865
3878
  _id <= 1
3879
+ .ft P
3880
+ .fi
3866
3881
  .UNINDENT
3867
3882
  .UNINDENT
3868
3883
  .sp
3869
- という条件を指定しています。この場合は_idの値が1以下のレコードが検索結果として得られます。
3884
+ In this case, this query returns the records which meets the condition that the value of \fB_id\fP is equal to 1.
3870
3885
  .sp
3871
- また、&& や || を使って、条件のAND・OR指定をすることもできます。
3886
+ Moreover, you can use \fB&&\fP for AND search, \fB||\fP for OR search.
3872
3887
  .sp
3873
3888
  Execution example:
3874
3889
  .INDENT 0.0
@@ -3963,14 +3978,12 @@ select \-\-table Site \-\-filter "_id <= 2 || _id >= 7" \-\-output_columns _id,_
3963
3978
  .UNINDENT
3964
3979
  .UNINDENT
3965
3980
  .sp
3966
- queryパラメータとfilterパラメータを同時に指定すると、両者の条件をともに満たすレコードが結果として返ります。
3967
- .SS scorerを利用したソート
3981
+ If you specify \fBquery\fP parameter and \fBfilter\fP parameter at the same time, you can get the records which meets both of the condition as a result.
3982
+ .SS Sort by using \fBscorer\fP
3968
3983
  .sp
3969
- selectコマンドのscorerパラメータは、
3970
- 全文検索を行った結果の各レコードに対して処理を行うためのパラメータです。
3984
+ \fBselect\fP command accepts \fBscorer\fP parameter which is used to process each record of full\-text search results.
3971
3985
  .sp
3972
- filterパラメータと同様に、
3973
- JavaScriptの式に似たな文法で様々な条件を指定することができます。
3986
+ This parameter accepts the conditions which is specified by syntax like JavaScript as same as \fBfilter\fP parameter.
3974
3987
  .sp
3975
3988
  Execution example:
3976
3989
  .INDENT 0.0
@@ -4131,46 +4144,59 @@ select \-\-table Site \-\-filter "1" \-\-scorer "_score = rand()" \-\-output_col
4131
4144
  .UNINDENT
4132
4145
  .UNINDENT
4133
4146
  .sp
4134
- 検索結果には、\(aq_score\(aqという名前の、全文検索のスコアが代入されている仮想的なカラムが付与されることをチュートリアル中ソートの項目で説明しました。
4147
+ \(aq_score\(aq is one of a pseudo column. The score of full\-text search is assigned to it.
4148
+ See \fB/reference/columns/pseudo\fP about \(aq_score\(aq column.
4135
4149
  .sp
4136
- 上記の実行例では、scorerパラメータに
4150
+ In the above query, the condition of \fBscorer\fP parameter is:
4137
4151
  .INDENT 0.0
4138
4152
  .INDENT 3.5
4153
+ .sp
4154
+ .nf
4155
+ .ft C
4139
4156
  _score = rand()
4157
+ .ft P
4158
+ .fi
4140
4159
  .UNINDENT
4141
4160
  .UNINDENT
4142
4161
  .sp
4143
- という条件を指定しています。ここでは、rand()という乱数を返す関数を用いて、全文検索のスコアを乱数で上書きしています。
4162
+ In this case, the score of full\-text search is overwritten by the value of rand() function.
4144
4163
  .sp
4145
- sortbyパラメータには、
4164
+ The condition of \fBsortby\fP parameter is:
4146
4165
  .INDENT 0.0
4147
4166
  .INDENT 3.5
4167
+ .sp
4168
+ .nf
4169
+ .ft C
4148
4170
  _score
4171
+ .ft P
4172
+ .fi
4149
4173
  .UNINDENT
4150
4174
  .UNINDENT
4151
4175
  .sp
4152
- を指定しています。これは、スコア順に昇順にソートすることを意味しています。
4176
+ This means that sorting the search result by ascending order.
4153
4177
  .sp
4154
- よって、上記のクエリは実行されるたびに検索結果の並び順がランダムに変わります。
4155
- .SS 位置情報を用いた絞込・ソート
4178
+ As a result, the order of search result is randomized.
4179
+ .SS Narrow down & sort by using location information
4156
4180
  .sp
4157
- Groongaでは、位置情報（経緯度）を保存することができます。また、保存した経緯度を用いて絞込やソートができます。
4181
+ Groonga supports to store location information (Longitude & Latitude) and not only narrow down but also sort by using it.
4158
4182
  .sp
4159
- 位置情報を保存するためのカラムの型として、TokyoGeoPoint/WGS84GeoPointの２つの型があります。前者は日本測地系、後者は世界測地系(WGS84相当)の経緯度を保存します。
4183
+ Groonga supports two kind of column types to store location information. One is \fBTokyoGeoPoint\fP, the other is \fBWGS84GeoPoint\fP\&. \fBTokyoGeoPoint\fP is used for Japan geodetic system. \fBWGS84GeoPoint\fP is used for world geodetic system.
4160
4184
  .sp
4161
- 経緯度は以下のいずれかの形式の文字列として指定します。
4185
+ Specify longitude and latitude as follows:
4162
4186
  .INDENT 0.0
4163
4187
  .IP \(bu 2
4164
- "[緯度のミリ秒]x[経度のミリ秒]"（例: "128452975x503157902"）
4188
+ "[latitude in milliseconds]x[longitude in milliseconds]"（e.g.: "128452975x503157902"）
4165
4189
  .IP \(bu 2
4166
- "[緯度のミリ秒],[経度のミリ秒]"（例: "128452975,503157902"）
4190
+ "[latitude in milliseconds],[longitude in milliseconds]"（e.g.: "128452975,503157902"）
4167
4191
  .IP \(bu 2
4168
- "[緯度の小数表記の度数]x[経度の小数表記の度数]"（例: "35.6813819x139.7660839"）
4192
+ "[latitude in degrees]x[longitude in degrees]"（e.g.: "35.6813819x139.7660839"）
4169
4193
  .IP \(bu 2
4170
- "[緯度の小数表記の度数],[経度の小数表記の度数]"（例: "35.6813819,139.7660839"）
4194
+ "[latitude in degrees],[longitude in degrees]"（e.g.: "35.6813819,139.7660839"）
4171
4195
  .UNINDENT
4172
4196
  .sp
4173
- ここでは、ためしに東京駅と新宿駅とついて、世界測地系での位置情報を保存してみましょう。東京駅は緯度が35度40分52.975秒、経度が139度45分57.902秒です。新宿駅は緯度が35度41分27.316秒、経度が139度42分0.929秒です。よって、ミリ秒表記の場合はそれぞれ"128452975x503157902"/"128487316x502920929"となります。度数表記の場合はそれぞれ"35.6813819x139.7660839"/"35.6909211x139.7002581"となります。ここではミリ秒表記で登録しましょう。
4197
+ Let\(aqs 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.
4198
+ .sp
4199
+ Let\(aqs register location information in milliseconds.
4174
4200
  .sp
4175
4201
  Execution example:
4176
4202
  .INDENT 0.0
@@ -4224,9 +4250,9 @@ select \-\-table Site \-\-query "_id:1 OR _id:2" \-\-output_columns _key,locatio
4224
4250
  .UNINDENT
4225
4251
  .UNINDENT
4226
4252
  .sp
4227
- scorerパラメータにおいて、 \fB/reference/functions/geo_distance\fP 関数を用いることにより、２点間の距離を計算することができます。
4253
+ Then assign the value of geo distance which is calculated by \fB/reference/functions/geo_distance\fP function to \fBscorer\fP parameter.
4228
4254
  .sp
4229
- ここでは、秋葉原駅からの距離を表示させてみましょう。世界測地系では、秋葉原駅の位置は緯度が35度41分55.259秒、経度が139度46分27.188秒です。よって、geo_distance関数に与える文字列は"128515259x503187188"となります。
4255
+ Let\(aqs 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.
4230
4256
  .sp
4231
4257
  Execution example:
4232
4258
  .INDENT 0.0
@@ -4278,9 +4304,9 @@ select \-\-table Site \-\-query "_id:1 OR _id:2" \-\-output_columns _key,locatio
4278
4304
  .UNINDENT
4279
4305
  .UNINDENT
4280
4306
  .sp
4281
- この結果を見ると、東京駅と秋葉原駅は2054m、秋葉原駅と新宿駅は6720m離れているようです。
4307
+ 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.
4282
4308
  .sp
4283
- geo_distance関数は、_scoreを通じてソートでも用いることができます。
4309
+ The return value of geo_distance function is also used for sorting by specifying pseudo \fB_score\fP column to \fBsortby\fP parameter.
4284
4310
  .sp
4285
4311
  Execution example:
4286
4312
  .INDENT 0.0
@@ -4332,11 +4358,11 @@ select \-\-table Site \-\-query "_id:1 OR _id:2" \-\-output_columns _key,locatio
4332
4358
  .UNINDENT
4333
4359
  .UNINDENT
4334
4360
  .sp
4335
- 「ある地点から何m以内に存在する」といった絞込も可能です。
4361
+ Groonga also supports to narrow down by "a certain point within specified meters".
4336
4362
  .sp
4337
- filterパラメータにおいて、 \fB/reference/functions/geo_in_circle\fP 関数を用いることにより、２点間の距離が指定のm以下におさまるかどうかを判定することができます。
4363
+ In such a case, use \fB/reference/functions/geo_in_circle\fP function in \fBfilter\fP parameter.
4338
4364
  .sp
4339
- たとえば、秋葉原駅から5000m以内にあるレコードを検索してみましょう。
4365
+ For example, search the records which exists within 5000 meters from Akihabara station.
4340
4366
  .sp
4341
4367
  Execution example:
4342
4368
  .INDENT 0.0
@@ -4378,10 +4404,10 @@ select \-\-table Site \-\-output_columns _key,location \-\-filter \(aqgeo_in_cir
4378
4404
  .UNINDENT
4379
4405
  .UNINDENT
4380
4406
  .sp
4381
- また、経緯度が指定の矩形領域内であるかどうかを判定する \fB/reference/functions/geo_in_rectangle\fP 関数も存在します。
4407
+ There is \fB/reference/functions/geo_in_rectangle\fP function which is used to search a certain point within specified region.
4382
4408
  .SS Drilldown
4383
4409
  .sp
4384
- You learned how to filter search results and sort ones in the previous sections.
4410
+ You learned how to search and sort searched results in the previous sections.
4385
4411
  Now that you can search as you likes, but how do you summarize the number of records which has specific value in the column?
4386
4412
  .sp
4387
4413
  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.
@@ -5080,20 +5106,23 @@ select \-\-table Site \-\-limit 0 \-\-drilldown country \-\-drilldown_sortby _ns
5080
5106
  .UNINDENT
5081
5107
  .UNINDENT
5082
5108
  .sp
5083
- 文字列型のカラムに対するドリルダウンは、他の型でのドリルダウンに比べて低速です。文字列でのドリルダウンを行いたい場合には、このチュートリアルのように、文字列型を主キーとするテーブルを別途作成し、そのテーブルを型とするカラムを作成します。
5084
- .SS タグ検索・参照関係の逆引き
5109
+ Note that drilldown to the column which stores string is slower than the columns which stores the other types.
5110
+ 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.
5111
+ .SS Tag search and reverse resolution of reference relationships
5112
+ .sp
5113
+ As you know, Groonga supports to store array in column which refers other table.
5114
+ In fact, you can do tag search by using array data which refers other table.
5085
5115
  .sp
5086
- 本チュートリアルで、Groongaはカラム値として他のテーブルへの参照の配列を持つことができることを紹介いたしました。実は、テーブルへの参照の配列データを用いることによって、いわゆるタグ検索を行うことが可能となります。
5116
+ Tag search is very fast because Groonga use inverted index as data structure.
5117
+ .SS Tag search
5087
5118
  .sp
5088
- タグ検索はGroongaの転置インデックスというデータ構造を用いて高速に行われます。
5089
- .SS タグ検索
5119
+ Let\(aqs 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.
5090
5120
  .sp
5091
- 動画共有サイトの検索エンジンを作ることを想定します。1つの動画には、その動画の特徴を表す、複数の語句が付与されています。「ある語句が付与されている動画の一覧を取得する」検索を行いたいとします。
5121
+ Let\(aqs create tables for movie information, then search the movies.
5092
5122
  .sp
5093
- 実際に、動画情報のテーブルを作成し、検索をしてみましょう。
5123
+ First, create the \fBVideo\fP table which stores movie information. the \fBVideo\fP table has two columns. the \fBtitle\fP column stores title of the movie. the \fBtags\fP column stores multiple tag information in reference Tag table.
5094
5124
  .sp
5095
- 動画の情報を保存する、Videoテーブルを作成します。Videoテーブルでは、動画のタイトルをtitleカラムに、動画のタグ情報をtagsカラムにTagテーブル型で複数格納しています。
5096
- タグの情報を保存する、Tagテーブルを作成します。Tagテーブルでは、タグ文字列を主キーに格納し、Videoテーブルのtagsカラムに対するインデックスをindex_tagsカラムに格納しています。
5125
+ Next, create the \fBTag\fP table which stores tag information. the \fBTag\fP table has one column. The tag string is stored as primary key, then \fBindex_tags\fP stores indexes for tags column of Video table.
5097
5126
  .sp
5098
5127
  Execution example:
5099
5128
  .INDENT 0.0
@@ -5128,9 +5157,9 @@ load \-\-table Video
5128
5157
  .UNINDENT
5129
5158
  .UNINDENT
5130
5159
  .sp
5131
- インデックスカラムを作成すると、全文検索が高速に行えるようになります。インデックスカラムは、対象のカラムに保存されたデータに更新があったとき、自動的に更新されます。
5160
+ After creating indexed column, you can do full\-text search very fast. The indexed column is also automatically updated when stored data is refreshed.
5132
5161
  .sp
5133
- 「ある語句が付与されている動画の一覧を取得する」検索を行いましょう。
5162
+ List up the movies that specific keywords are given.
5134
5163
  .sp
5135
5164
  Execution example:
5136
5165
  .INDENT 0.0
@@ -5246,14 +5275,14 @@ select \-\-table Video \-\-query tags:@Animation \-\-output_columns _key,title
5246
5275
  .UNINDENT
5247
5276
  .UNINDENT
5248
5277
  .sp
5249
- このように、「Variety」、「Sports」、「Animation」のようなタグで検索を行うことができました。
5250
- .SS 参照関係の逆引き
5278
+ You can search by tags such as "Variety", "Sports" and "Animation".
5279
+ .SS Reverse resolution of reference relationships
5251
5280
  .sp
5252
- Groongaはテーブル間の参照関係の逆引きを高速に行うためのインデックスを付与することができます。タグ検索は、その1例にすぎません。
5281
+ Groonga supports indexes for reverse resolution among tables. Tag search is one of concrete examples.
5253
5282
  .sp
5254
- 例えば、ソーシャルネットワーキングサイトにおける友人関係を逆引き検索することができます。
5283
+ For example, you can search friendships by reverse resolution in social networking site.
5255
5284
  .sp
5256
- 以下の例では、ユーザー情報を格納するUserテーブルを作成し、ユーザー名を格納するusernameカラム、ユーザーの友人一覧を配列で格納するfriendsカラムとそのインデックスのindex_friendsカラムを追加しています。
5285
+ Following example shows how to create \fBUser\fP table which stores user information, \fBusername\fP column which stores user name, \fBfriends\fP column which stores list of user\(aqs friends in array, \fBindex_friends\fP column as indexed column.
5257
5286
  .sp
5258
5287
  Execution example:
5259
5288
  .INDENT 0.0
@@ -5284,7 +5313,7 @@ load \-\-table User
5284
5313
  .UNINDENT
5285
5314
  .UNINDENT
5286
5315
  .sp
5287
- 指定したユーザーを友人リストに入れているユーザーの一覧を表示してみましょう。
5316
+ Let\(aqs show list of users who contains specified user in friend list.
5288
5317
  .sp
5289
5318
  Execution example:
5290
5319
  .INDENT 0.0
@@ -5379,7 +5408,7 @@ select \-\-table User \-\-query friends:@jiro \-\-output_columns _key,username
5379
5408
  .UNINDENT
5380
5409
  .UNINDENT
5381
5410
  .sp
5382
- さらに、ドリルダウンを使って、友人リストに入っている数の一覧を表示してみましょう。
5411
+ Then drilldown the count which shows user is listed as friend.
5383
5412
  .sp
5384
5413
  Execution example:
5385
5414
  .INDENT 0.0
@@ -5468,10 +5497,11 @@ select \-\-table User \-\-limit 0 \-\-drilldown friends
5468
5497
  .UNINDENT
5469
5498
  .UNINDENT
5470
5499
  .sp
5471
- このように、テーブルの参照関係を逆にたどる検索ができました。
5472
- .SS インデックス付きジオサーチ
5500
+ As you can see, it shows the results which follows reverse resolution of reference relationship.
5501
+ .SS Geo location search with index
5473
5502
  .sp
5474
- 位置情報のカラムに対して、インデックスを付与することが出来ます。大量の位置情報レコードを検索する場合に、検索速度が速くなります。
5503
+ Groonga supports to add indexes to the column which stores geo location information.
5504
+ Groonga is very fast because it use such indexes against the column which contains geo location information to search enormous number of records.
5475
5505
  .sp
5476
5506
  Execution example:
5477
5507
  .INDENT 0.0
@@ -5523,7 +5553,7 @@ select \-\-table Site \-\-filter \(aqgeo_in_circle(location, "128515259x50318718
5523
5553
  .UNINDENT
5524
5554
  .UNINDENT
5525
5555
  .sp
5526
- 同様に、位置情報レコードを用いてソートする場合に、ソート速度が速くなります。
5556
+ These indexes are also used when sorting the records with geo location search.
5527
5557
  .sp
5528
5558
  Execution example:
5529
5559
  .INDENT 0.0
@@ -5574,16 +5604,19 @@ select \-\-table Site \-\-filter \(aqgeo_in_circle(location, "128515259x50318718
5574
5604
  .fi
5575
5605
  .UNINDENT
5576
5606
  .UNINDENT
5577
- .SS match_columnsパラメータ
5578
- .SS 複数のカラムを対象とした全文検索
5607
+ .SS match_columns parameter
5608
+ .SS Full\-text search against multiple columns
5579
5609
  .sp
5580
- Groongaでは、複数のカラムを対象とした全文検索を行うことができます。例えば、ブログのテーブルで、タイトルと内容とがそれぞれ別のカラムに入ったものがあるとしましょう。「タイトルもしくは内容に特定の単語を含む」検索を行いたいとします。
5610
+ Groonga supports full\-text search against multiple columns. Let\(aqs 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?
5581
5611
  .sp
5582
- この場合、2つのインデックス作成方式があります。1つは、それぞれのカラムに1つずつインデックスを付与する方式です。もう1つは、複数のカラムに対して1つのインデックスを付与する方式です。Groongaでは、どちらの形式のインデックスが存在している場合でも、同一の記法で全文検索を行うことができます。
5583
- .SS カラムごとにインデックスを付与する場合
5612
+ 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.
5613
+ .SS Creating column index against each column
5584
5614
  .sp
5585
- Blog1テーブルを作り、タイトル文字列のtitleカラム、本文のmessageカラムを追加しています。
5586
- インデックス用のIndexBlog1テーブルも作り、titleカラムのインデックス用にindex_titleカラム、messageカラムのインデック用にindex_messageカラムと、それぞれ1カラムごとに1つずつ追加しています。
5615
+ Here is the example which create column index against each column.
5616
+ .sp
5617
+ First, create \fBBlog1\fP table, add \fBtitle\fP column which stores title string, \fBmessage\fP column which stores content of blog entry.
5618
+ .sp
5619
+ Then create \fBIndexBlog1\fP table for column indexes, add \fBindex_title\fP column for \fBtitle\fP column, \fBindex_message\fP column for \fBmessage\fP column.
5587
5620
  .sp
5588
5621
  Execution example:
5589
5622
  .INDENT 0.0
@@ -5615,9 +5648,10 @@ load \-\-table Blog1
5615
5648
  .UNINDENT
5616
5649
  .UNINDENT
5617
5650
  .sp
5618
- match_columnsオプションで、検索対象のカラムを複数指定することが出来ます。検索する文字列はqueryオプションで指定します。これを使うことで、タイトルと本文を全文検索することができます。
5651
+ \fBmatch_columns\fP option of \fBselect\fP command accepts multiple columns as search target.
5652
+ Specify query string to \fBquery\fP option. Then you can do full\-text search title and content of blog entries.
5619
5653
  .sp
5620
- 実際に検索してみましょう。
5654
+ Let\(aqs try to search blog entries.
5621
5655
  .sp
5622
5656
  Execution example:
5623
5657
  .INDENT 0.0
@@ -5764,11 +5798,13 @@ select \-\-table Blog1 \-\-match_columns title \-\-query message
5764
5798
  .fi
5765
5799
  .UNINDENT
5766
5800
  .UNINDENT
5767
- .SS 複数のカラムにまたがったインデックスを付与する場合
5801
+ .SS Creating one column index against multiple columns
5768
5802
  .sp
5769
- 内容は上の例とほぼ同じですが、titleとmessageの2つのカラムに対するインデックスが共通になっており、インデックスカラムが1つしかありません。
5803
+ Groonga also supports one column index against multiple columns.
5770
5804
  .sp
5771
- 共通のインデックスを用いても、titleカラムのみでの検索、messageカラムのみでの検索、titleもしくはmessageカラムでの検索、全ての検索を行うことができます。
5805
+ The difference for previous example is only one column index exists. Thus, There is one common column index against title and message column.
5806
+ .sp
5807
+ Even though same column index is used, Groonga supports to search against title column only, message column only and title or message column.
5772
5808
  .sp
5773
5809
  Execution example:
5774
5810
  .INDENT 0.0
@@ -5798,7 +5834,7 @@ load \-\-table Blog2
5798
5834
  .UNINDENT
5799
5835
  .UNINDENT
5800
5836
  .sp
5801
- 実際に検索してみましょう。結果は上の例と同じになります。
5837
+ Let\(aqs search same query in previous section. You can get same search results.
5802
5838
  .sp
5803
5839
  Execution example:
5804
5840
  .INDENT 0.0
@@ -5959,9 +5995,9 @@ Indexes for multiple column \- It saves disk usage because it shares common buff
5959
5995
  .UNINDENT
5960
5996
  .UNINDENT
5961
5997
  .UNINDENT
5962
- .SS インデックス名を指定した全文検索
5998
+ .SS Full text search with specific index name
5963
5999
  .sp
5964
- 執筆中です。
6000
+ TODO
5965
6001
  .SS Nested index search among related table by column index
5966
6002
  .sp
5967
6003
  If there are relationships among multiple table with column index,
@@ -6298,15 +6334,18 @@ select Articles2 \-\-match_columns comment.comment.content \-\-query mroonga \-\
6298
6334
  As a result, the first query matches two article because of Comments2 table has two records which contains \(aqmroonga\(aq as keyword.
6299
6335
  .sp
6300
6336
  On the other hand, the second one matches one article only because of Replies2 table has only one record which contains \(aqmroonga\(aq as keyword, and there is one record which contains same keyword and refers to the record in Comments2 table.
6301
- .SS インデックスの重み
6337
+ .SS Indexes with Weight
6302
6338
  .sp
6303
- 執筆中です。
6304
- .SS パトリシア木による前方一致検索
6339
+ TODO
6340
+ .SS Prefix search with patricia trie
6341
+ .sp
6342
+ Groonga supports to create a table with patricia trie option.
6343
+ By specifying it, You can do prefix search.
6305
6344
  .sp
6306
- Groongaのテーブルは、テーブル作成時にパトリシア木オプションを指定すると、前方一致検索を行うことができます。また、追加のオプションを指定することにより、主キーの後方一致検索をも行うことができます。
6307
- .SS 主キーによる前方一致検索
6345
+ And more, you can do suffix search against primary key by specifying additional option.
6346
+ .SS Prefix search by primary key
6308
6347
  .sp
6309
- table_createコマンドのflagsオプションにTABLE_PAT_KEYを指定することで、主キーによる前方一致検索ができるようになります。
6348
+ table_create command which uses TABLE_PAT_KEY for flags option supports prefix search by primary key.
6310
6349
  .sp
6311
6350
  Execution example:
6312
6351
  .INDENT 0.0
@@ -6318,13 +6357,15 @@ table_create \-\-name PatPrefix \-\-flags TABLE_PAT_KEY \-\-key_type ShortText
6318
6357
  # [[0, 1337566253.89858, 0.000355720520019531], true]
6319
6358
  load \-\-table PatPrefix
6320
6359
  [
6321
- {"_key":"ひろゆき"},
6322
- {"_key":"まろゆき"},
6323
- {"_key":"ひろあき"},
6324
- {"_key":"ゆきひろ"}
6360
+ {"_key":"James"}
6361
+ {"_key":"Jason"}
6362
+ {"_key":"Jennifer"},
6363
+ {"_key":"Jeff"},
6364
+ {"_key":"John"},
6365
+ {"_key":"Joseph"},
6325
6366
  ]
6326
- # [[0, 1337566253.89858, 0.000355720520019531], 4]
6327
- select \-\-table PatPrefix \-\-query _key:^ひろ
6367
+ # [[0, 1337566253.89858, 0.000355720520019531], 6]
6368
+ select \-\-table PatPrefix \-\-query _key:^Je
6328
6369
  # [
6329
6370
  # [
6330
6371
  # 0,
@@ -6347,12 +6388,12 @@ select \-\-table PatPrefix \-\-query _key:^ひろ
6347
6388
  # ]
6348
6389
  # ],
6349
6390
  # [
6350
- # 1,
6351
- # "ひろゆき"
6391
+ # 3,
6392
+ # "Jennifer"
6352
6393
  # ],
6353
6394
  # [
6354
- # 3,
6355
- # "ひろあき"
6395
+ # 4,
6396
+ # "Jeff"
6356
6397
  # ]
6357
6398
  # ]
6358
6399
  # ]
@@ -9455,7 +9496,7 @@ _
9455
9496
  T{
9456
9497
  POST
9457
9498
  T} T{
9458
- x
9499
+ o
9459
9500
  T} T{
9460
9501
  o
9461
9502
  T}
@@ -9953,7 +9994,7 @@ New in version 1.2.2.
9953
9994
  .TP
9954
9995
  .B \-p, \-\-port <port number>
9955
9996
  クライアント、サーバ、またはデーモンモードで使用するTCPポート番号。
9956
- (デフォルトは10041番)
9997
+ (クライアントモードのデフォルトは10043番、サーバ、またはデーモンモードのデフォルトは、HTTPの場合、10041番、GQTPの場合、10043番)
9957
9998
  .UNINDENT
9958
9999
  .INDENT 0.0
9959
10000
  .TP
@@ -10039,7 +10080,7 @@ pid\-file=/var/run/groonga.pid
10039
10080
  .B dest
10040
10081
  使用するデータベースのパス名を指定します。
10041
10082
  .sp
10042
- クライアントモードの場合は接続先のホスト名とポート番号を指定します(デフォルト値は\(aqlocalhost:10041\(aq)。ポート番号を指定しない場合には、10041が指定されたものとします。
10083
+ クライアントモードの場合は接続先のホスト名とポート番号を指定します(デフォルト値は\(aqlocalhost:10043\(aq)。ポート番号を指定しない場合には、10043が指定されたものとします。
10043
10084
  .UNINDENT
10044
10085
  .INDENT 0.0
10045
10086
  .TP
@@ -10310,7 +10351,7 @@ test\-ユーザ名\-数字.log
10310
10351
  "#"で始まる行はコメントとして扱われます。
10311
10352
  .SS groonga\-benchmark命令
10312
10353
  .sp
10313
- 現在サポートされているgroonga\-benchmark命令は以下の8つです。
10354
+ 現在サポートされているgroonga\-benchmark命令は以下の11種類です。
10314
10355
  .INDENT 0.0
10315
10356
  .INDENT 3.5
10316
10357
  do_local コマンドファイル [スレッド数] [繰り返し数]
@@ -10323,7 +10364,14 @@ do_local コマンドファイル [スレッド数] [繰り返し数]
10323
10364
  do_gqpt コマンドファイル [スレッド数] [繰り返し数]
10324
10365
  .INDENT 0.0
10325
10366
  .INDENT 3.5
10326
- コマンドファイルをgroongaサーバで実行します。スレッド数や繰り返し数の意味はdo_localの場合と同じです。
10367
+ コマンドファイルをgroongaサーバでGQTP経由で実行します。スレッド数や繰り返し数の意味はdo_localの場合と同じです。
10368
+ .UNINDENT
10369
+ .UNINDENT
10370
+ .sp
10371
+ do_http コマンドファイル [スレッド数] [繰り返し数]
10372
+ .INDENT 0.0
10373
+ .INDENT 3.5
10374
+ コマンドファイルをgroongaサーバでHTTP経由で実行します。スレッド数や繰り返し数の意味はdo_localの場合と同じです。
10327
10375
  .UNINDENT
10328
10376
  .UNINDENT
10329
10377
  .sp
@@ -10337,7 +10385,14 @@ rep_local コマンドファイル [スレッド数] [繰り返し数]
10337
10385
  rep_gqpt コマンドファイル [スレッド数] [繰り返し数]
10338
10386
  .INDENT 0.0
10339
10387
  .INDENT 3.5
10340
- コマンドファイルをgroongaサーバで実行し、より詳細な報告を行います。 スレッド数や繰り返し数の意味はdo_localと 同じです。
10388
+ コマンドファイルをgroongaサーバでGQTP経由で実行し、より詳細な報告を行います。 スレッド数や繰り返し数の意味はdo_localと 同じです。
10389
+ .UNINDENT
10390
+ .UNINDENT
10391
+ .sp
10392
+ rep_http コマンドファイル [スレッド数] [繰り返し数]
10393
+ .INDENT 0.0
10394
+ .INDENT 3.5
10395
+ コマンドファイルをgroongaサーバでHTTP経由で実行し、より詳細な報告を行います。 スレッド数や繰り返し数の意味はdo_localと 同じです。
10341
10396
  .UNINDENT
10342
10397
  .UNINDENT
10343
10398
  .sp
@@ -10363,7 +10418,14 @@ groonga < コマンドファイル > 出力ファイル
10363
10418
  out_gqtp コマンドファイル 出力ファイル名
10364
10419
  .INDENT 0.0
10365
10420
  .INDENT 3.5
10366
- コマンドファイルをgroongaサーバで実行します。その他はout_local命令と同等です。
10421
+ コマンドファイルをgroongaサーバでGQTP経由で実行します。その他はout_local命令と同等です。
10422
+ .UNINDENT
10423
+ .UNINDENT
10424
+ .sp
10425
+ out_http コマンドファイル 出力ファイル名
10426
+ .INDENT 0.0
10427
+ .INDENT 3.5
10428
+ コマンドファイルをgroongaサーバでHTTP経由で実行します。その他はout_local命令と同等です。
10367
10429
  .UNINDENT
10368
10430
  .UNINDENT
10369
10431
  .INDENT 0.0
@@ -10402,7 +10464,7 @@ do_gqtp test.select 10 10; do_local test.status 10
10402
10464
  コメント行。
10403
10465
  .TP
10404
10466
  .B 2行目
10405
- test.dll というコマンドファイルをgroonga単体で実行し、詳細に報告する。
10467
+ test.ddl というコマンドファイルをgroonga単体で実行し、詳細に報告する。
10406
10468
  .TP
10407
10469
  .B 3行目
10408
10470
  test.load というコマンドファイルをgroonga単体で実行する。(最後の";"セミコロンは複数のgroonga\-benchmark命令を記述する場合に必要ですが、この例のように1つのgroonga\-benchmark命令を実行する場合に付与しても問題ありません。)
@@ -11711,23 +11773,34 @@ groonga\-suggest\-learner \-l logs testdb/db
11711
11773
  .SS Options
11712
11774
  .INDENT 0.0
11713
11775
  .TP
11714
- .B \-r
11715
- Specify endpoint for receiver.
11776
+ .B \-r <endpoint>, \-\-receive\-endpoint <endpoint>
11777
+ Uses \fB<endpoint>\fP as the receiver endpoint.
11716
11778
  .UNINDENT
11717
11779
  .INDENT 0.0
11718
11780
  .TP
11719
- .B \-s
11720
- Specify endpoint for sender.
11781
+ .B \-s <endpoint>, \-\-send\-endpoint <endpoint>
11782
+ Uses \fB<endpoint>\fP as the sender endpoint.
11721
11783
  .UNINDENT
11722
11784
  .INDENT 0.0
11723
11785
  .TP
11724
- .B \-d
11725
- Specify this option to daemonize.
11786
+ .B \-d, \-\-daemon
11787
+ Runs as a daemon.
11788
+ .UNINDENT
11789
+ .INDENT 0.0
11790
+ .TP
11791
+ .B \-l <directory>, \-\-log\-base\-path <directory>
11792
+ Reads logs from \fB<directory>\fP\&.
11793
+ .UNINDENT
11794
+ .INDENT 0.0
11795
+ .TP
11796
+ .B \-\-log\-path <path>
11797
+ Outputs log to \fB<path>\fP\&.
11726
11798
  .UNINDENT
11727
11799
  .INDENT 0.0
11728
11800
  .TP
11729
- .B \-l
11730
- Specify log directory.
11801
+ .B \-\-log\-level <level>
11802
+ Uses \fB<level>\fP for log level. \fB<level>\fP must be between 1 and 9.
11803
+ Larger level outputs more logs.
11731
11804
  .UNINDENT
11732
11805
  .SS Parameters
11733
11806
  .sp
@@ -12642,11 +12715,15 @@ is a number.
12642
12715
  .IP \(bu 2
12643
12716
  \fBselect\fP
12644
12717
  .UNINDENT
12645
- .SS check
12646
- .SS 名前
12718
+ .SS \fBcheck\fP
12719
+ .SS Summary
12647
12720
  .sp
12648
12721
  check \- オブジェクトの状態表示
12649
- .SS 書式
12722
+ .sp
12723
+ Groonga組込コマンドの一つであるcheckについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
12724
+ .sp
12725
+ checkコマンドは、groongaプロセス内の指定したオブジェクトの状態を表示します。主にデータベースが壊れた場合など異常時の問題解決のために使用することを想定しています。デバッグ用のため、返値のフォーマットが安定しているということは保証されません。（フォーマットが変更される可能性が高い）
12726
+ .SS Syntax
12650
12727
  .INDENT 0.0
12651
12728
  .INDENT 3.5
12652
12729
  .sp
@@ -12657,12 +12734,52 @@ check obj
12657
12734
  .fi
12658
12735
  .UNINDENT
12659
12736
  .UNINDENT
12660
- .SS 説明
12737
+ .SS Usage
12661
12738
  .sp
12662
- Groonga組込コマンドの一つであるcheckについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
12739
+ テーブルTermsのインデックスカラムnameの状態を表示します。:
12740
+ .INDENT 0.0
12741
+ .INDENT 3.5
12663
12742
  .sp
12664
- checkコマンドは、groongaプロセス内の指定したオブジェクトの状態を表示します。主にデータベースが壊れた場合など異常時の問題解決のために使用することを想定しています。デバッグ用のため、返値のフォーマットが安定しているということは保証されません。（フォーマットが変更される可能性が高い）
12665
- .SS 引数
12743
+ .nf
12744
+ .ft C
12745
+ check Terms.name
12746
+ [{"flags":"00008202",
12747
+ "max sid":1,
12748
+ "number of garbage segments":0,
12749
+ "number of array segments":1,
12750
+ "max id of array segment":1,
12751
+ "number of buffer segments":110,
12752
+ "max id of buffer segment":111,
12753
+ "max id of physical segment in use":111,
12754
+ "number of unmanaged segments":4294967185,
12755
+ "total chunk size":7470239,
12756
+ "max id of chunk segments in use":127,
12757
+ "number of garbage chunk":[0,0,0,0,0,0,0,0,2,2,0,0,0,0,0]},
12758
+ {"buffer id":0,
12759
+ "chunk size":94392,
12760
+ "buffer term":["596","59777","6",...],
12761
+ "buffer free":152944,
12762
+ "size in buffer":7361,
12763
+ "nterms":237,
12764
+ "nterms with chunk":216,
12765
+ "buffer id":1,
12766
+ "chunk size":71236,
12767
+ "buffer term":[["に述",18149,18149,2,25,6,6],
12768
+ ["に追",4505,4505,76,485,136,174],
12769
+ ["に退",26568,26568,2,9,2,2],
12770
+ ...],
12771
+ "buffer free":120000,
12772
+ "size in buffer":11155,
12773
+ "nterms":121,
12774
+ "nterms with chunk":116},
12775
+ {"buffer id":1,
12776
+ ...},
12777
+ ...]
12778
+ .ft P
12779
+ .fi
12780
+ .UNINDENT
12781
+ .UNINDENT
12782
+ .SS Parameters
12666
12783
  .sp
12667
12784
  \fBobj\fP
12668
12785
  .INDENT 0.0
@@ -12670,8 +12787,7 @@ checkコマンドは、groongaプロセス内の指定したオブジェクト
12670
12787
  状態を表示するオブジェクトの名前を指定します。
12671
12788
  .UNINDENT
12672
12789
  .UNINDENT
12673
- .SS 返値
12674
- .SS json形式
12790
+ .SS Return value
12675
12791
  .sp
12676
12792
  チェックするオブジェクトにより返される値が変わります。
12677
12793
  .sp
@@ -12836,126 +12952,79 @@ checkコマンドは、groongaプロセス内の指定したオブジェクト
12836
12952
  .UNINDENT
12837
12953
  .UNINDENT
12838
12954
  .UNINDENT
12839
- .SS 例
12955
+ .SS \fBclearlock\fP
12956
+ .SS Summary
12840
12957
  .sp
12841
- テーブルTermsのインデックスカラムnameの状態を表示します。:
12958
+ clearlock \- オブジェクトにセットされたロックを解除する
12959
+ .sp
12960
+ Groonga組込コマンドの一つであるclearlockについて説明します。組込コマンドは、groonga実行ファイルの引数、標準>入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
12961
+ .sp
12962
+ clearlockは、対象となるオブジェクト(データベース,テーブル,インデックス等)を指定し、オブジェクトにかけられた>ロックを再帰的に解除します。
12963
+ .SS Syntax
12842
12964
  .INDENT 0.0
12843
12965
  .INDENT 3.5
12844
12966
  .sp
12845
12967
  .nf
12846
12968
  .ft C
12847
- check Terms.name
12848
- [{"flags":"00008202",
12849
- "max sid":1,
12850
- "number of garbage segments":0,
12851
- "number of array segments":1,
12852
- "max id of array segment":1,
12853
- "number of buffer segments":110,
12854
- "max id of buffer segment":111,
12855
- "max id of physical segment in use":111,
12856
- "number of unmanaged segments":4294967185,
12857
- "total chunk size":7470239,
12858
- "max id of chunk segments in use":127,
12859
- "number of garbage chunk":[0,0,0,0,0,0,0,0,2,2,0,0,0,0,0]},
12860
- {"buffer id":0,
12861
- "chunk size":94392,
12862
- "buffer term":["596","59777","6",...],
12863
- "buffer free":152944,
12864
- "size in buffer":7361,
12865
- "nterms":237,
12866
- "nterms with chunk":216,
12867
- "buffer id":1,
12868
- "chunk size":71236,
12869
- "buffer term":[["に述",18149,18149,2,25,6,6],
12870
- ["に追",4505,4505,76,485,136,174],
12871
- ["に退",26568,26568,2,9,2,2],
12872
- ...],
12873
- "buffer free":120000,
12874
- "size in buffer":11155,
12875
- "nterms":121,
12876
- "nterms with chunk":116},
12877
- {"buffer id":1,
12878
- ...},
12879
- ...]
12969
+ clearlock objname
12880
12970
  .ft P
12881
12971
  .fi
12882
12972
  .UNINDENT
12883
12973
  .UNINDENT
12884
- .SS clearlock
12885
- .SS 名前
12974
+ .SS Usage
12886
12975
  .sp
12887
- clearlock \- オブジェクトにセットされたロックを解除する
12888
- .SS 書式
12976
+ 開いているデータベースのロックをすべて解除する:
12889
12977
  .INDENT 0.0
12890
12978
  .INDENT 3.5
12891
12979
  .sp
12892
12980
  .nf
12893
12981
  .ft C
12894
- clearlock objname
12982
+ clearlock
12983
+ [true]
12895
12984
  .ft P
12896
12985
  .fi
12897
12986
  .UNINDENT
12898
12987
  .UNINDENT
12899
- .SS 説明
12900
- .sp
12901
- Groonga組込コマンドの一つであるclearlockについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
12902
- .sp
12903
- clearlockは、対象となるオブジェクト(データベース,テーブル,インデックス等)を指定し、オブジェクトにかけられたロックを再帰的に解除します。
12904
- .SS 引数
12905
12988
  .sp
12906
- \fBobjname\fP
12907
- .INDENT 0.0
12908
- .INDENT 3.5
12909
- 対象となるオブジェクト名を指定します。空の場合、開いているdbオブジェクトが対象となります。
12910
- .UNINDENT
12911
- .UNINDENT
12912
- .SS 返値
12913
- .SS json形式
12989
+ テーブル名 Entry のカラム body のロックを解除する:
12914
12990
  .INDENT 0.0
12915
12991
  .INDENT 3.5
12916
12992
  .sp
12917
12993
  .nf
12918
12994
  .ft C
12919
- [成功かどうかのフラグ]
12995
+ clearlock Entry.body
12996
+ [true]
12920
12997
  .ft P
12921
12998
  .fi
12922
12999
  .UNINDENT
12923
13000
  .UNINDENT
13001
+ .SS Parameters
12924
13002
  .sp
12925
- \fB成功かどうかのフラグ\fP
13003
+ \fBobjname\fP
12926
13004
  .INDENT 0.0
12927
13005
  .INDENT 3.5
12928
- エラーが生じなかった場合にはtrue、エラーが生じた場合にはfalseを返す。
13006
+ 対象となるオブジェクト名を指定します。空の場合、開いているdbオブジェクトが対象となります。
12929
13007
  .UNINDENT
12930
13008
  .UNINDENT
12931
- .SS 例
12932
- .sp
12933
- 開いているデータベースのロックをすべて解除する:
13009
+ .SS Return value
12934
13010
  .INDENT 0.0
12935
13011
  .INDENT 3.5
12936
13012
  .sp
12937
13013
  .nf
12938
13014
  .ft C
12939
- clearlock
12940
- [true]
13015
+ [成功かどうかのフラグ]
12941
13016
  .ft P
12942
13017
  .fi
12943
13018
  .UNINDENT
12944
13019
  .UNINDENT
12945
13020
  .sp
12946
- テーブル名 Entry のカラム body のロックを解除する:
13021
+ \fB成功かどうかのフラグ\fP
12947
13022
  .INDENT 0.0
12948
13023
  .INDENT 3.5
12949
- .sp
12950
- .nf
12951
- .ft C
12952
- clearlock Entry.body
12953
- [true]
12954
- .ft P
12955
- .fi
13024
+ エラーが生じなかった場合にはtrue、エラーが生じた場合にはfalseを返す。
12956
13025
  .UNINDENT
12957
13026
  .UNINDENT
12958
- .SS 関連項目
13027
+ .SS See also
12959
13028
  .sp
12960
13029
  \fBload\fP
12961
13030
  .SS \fBcolumn_create\fP
@@ -13496,11 +13565,16 @@ It is always an empty array for \fBCOLUMN_SCALAR\fP and
13496
13565
  .IP \(bu 2
13497
13566
  \fB/reference/column\fP
13498
13567
  .UNINDENT
13499
- .SS column_remove
13500
- .SS 名前
13568
+ .SS \fBcolumn_remove\fP
13569
+ .SS Summary
13501
13570
  .sp
13502
13571
  column_remove \- テーブルに定義されているカラムの削除
13503
- .SS 書式
13572
+ .sp
13573
+ Groonga組込コマンドの一つであるcolumn_removeについて説明します。組込コマンドは、groonga実行ファイルの引数、>標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
13574
+ .sp
13575
+ column_removeはテーブルに定義されているカラムを削除します。
13576
+ また、付随するインデックスも削除されます。[1]
13577
+ .SS Syntax
13504
13578
  .INDENT 0.0
13505
13579
  .INDENT 3.5
13506
13580
  .sp
@@ -13511,23 +13585,38 @@ column_remove table name
13511
13585
  .fi
13512
13586
  .UNINDENT
13513
13587
  .UNINDENT
13514
- .SS 説明
13588
+ .SS Usage
13589
+ .INDENT 0.0
13590
+ .INDENT 3.5
13515
13591
  .sp
13516
- Groonga組込コマンドの一つであるcolumn_removeについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
13592
+ .nf
13593
+ .ft C
13594
+ column_remove Entry body
13595
+
13596
+ [true]
13597
+ .ft P
13598
+ .fi
13599
+ .UNINDENT
13600
+ .UNINDENT
13601
+ 脚注
13602
+ .IP [1] 5
13603
+ マルチセクションインデックスの一部である場合も、インデックスが削除されます。
13604
+ .SS Parameters
13517
13605
  .sp
13518
- column_removeはテーブルに定義されているカラムを削除します。
13519
- また、付随するインデックスも削除されます。[1]
13520
- .SS 引数
13606
+ \fBtable\fP
13521
13607
  .INDENT 0.0
13522
- .TP
13523
- .B \fBtable\fP
13608
+ .INDENT 3.5
13524
13609
  削除対象のカラムが定義されているテーブルの名前を指定します。
13525
- .TP
13526
- .B \fBname\fP
13610
+ .UNINDENT
13611
+ .UNINDENT
13612
+ .sp
13613
+ \fBname\fP
13614
+ .INDENT 0.0
13615
+ .INDENT 3.5
13527
13616
  削除対象のカラム名を指定します。
13528
13617
  .UNINDENT
13529
- .SS 返値
13530
- .SS json形式
13618
+ .UNINDENT
13619
+ .SS Return value
13531
13620
  .INDENT 0.0
13532
13621
  .INDENT 3.5
13533
13622
  .sp
@@ -13545,33 +13634,17 @@ column_removeはテーブルに定義されているカラムを削除します
13545
13634
  エラーが生じなかった場合にはtrue、エラーが生じた場合にはfalseを返す。
13546
13635
  .UNINDENT
13547
13636
  .UNINDENT
13548
- .SS 例
13549
- .INDENT 0.0
13550
- .INDENT 3.5
13551
- .sp
13552
- .nf
13553
- .ft C
13554
- column_remove Entry body
13555
-
13556
- [true]
13557
- .ft P
13558
- .fi
13559
- .UNINDENT
13560
- .UNINDENT
13561
- 脚注
13562
- .IP [1] 5
13563
- マルチセクションインデックスの一部である場合も、インデックスが削除されます。
13564
- .SS \fBcolumn_rename\fP
13565
- .SS Summary
13566
- .sp
13567
- \fBcolumn_rename\fP command renames a column.
13568
- .sp
13569
- It is a light operation. It just changes a relationship between name
13570
- and the column object. It doesn\(aqt copy column values.
13571
- .sp
13572
- It is a dangerous operation. You must stop all operations including
13573
- read operations while you run \fBcolumn_rename\fP\&. If the following case
13574
- is occurred, Groonga process may be crashed:
13637
+ .SS \fBcolumn_rename\fP
13638
+ .SS Summary
13639
+ .sp
13640
+ \fBcolumn_rename\fP command renames a column.
13641
+ .sp
13642
+ It is a light operation. It just changes a relationship between name
13643
+ and the column object. It doesn\(aqt copy column values.
13644
+ .sp
13645
+ It is a dangerous operation. You must stop all operations including
13646
+ read operations while you run \fBcolumn_rename\fP\&. If the following case
13647
+ is occurred, Groonga process may be crashed:
13575
13648
  .INDENT 0.0
13576
13649
  .INDENT 3.5
13577
13650
  .INDENT 0.0
@@ -13778,11 +13851,15 @@ See \fB/reference/command/output_format\fP about \fBHEADER\fP\&.
13778
13851
  It is \fBtrue\fP on success, \fBfalse\fP otherwise.
13779
13852
  .UNINDENT
13780
13853
  .UNINDENT
13781
- .SS define_selector
13782
- .SS 名前
13854
+ .SS \fBdefine_selector\fP
13855
+ .SS Summary
13783
13856
  .sp
13784
13857
  define_selector \- 検索コマンドを定義
13785
- .SS 書式
13858
+ .sp
13859
+ Groonga組込コマンドの一つであるdefine_selectorについて説明します。組込コマンドは、groonga実行ファイルの引数>、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
13860
+ .sp
13861
+ define_selectorは、検索条件をカスタマイズした新たな検索コマンドを定義します。
13862
+ .SS Syntax
13786
13863
  .INDENT 0.0
13787
13864
  .INDENT 3.5
13788
13865
  .sp
@@ -13795,12 +13872,21 @@ define_selector name table [match_columns [query [filter [scorer [sortby
13795
13872
  .fi
13796
13873
  .UNINDENT
13797
13874
  .UNINDENT
13798
- .SS 説明
13875
+ .SS Usage
13799
13876
  .sp
13800
- Groonga組込コマンドの一つであるdefine_selectorについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
13877
+ テーブルEntryの全レコード・全カラムの値を出力するselectorコマンドを定義します。:
13878
+ .INDENT 0.0
13879
+ .INDENT 3.5
13801
13880
  .sp
13802
- define_selectorは、検索条件をカスタマイズした新たな検索コマンドを定義します。
13803
- .SS 引数
13881
+ .nf
13882
+ .ft C
13883
+ define_selector entry_selector Entry
13884
+ [true]
13885
+ .ft P
13886
+ .fi
13887
+ .UNINDENT
13888
+ .UNINDENT
13889
+ .SS Parameters
13804
13890
  .sp
13805
13891
  \fBname\fP
13806
13892
  .INDENT 0.0
@@ -13906,8 +13992,7 @@ define_selectorは、検索条件をカスタマイズした新たな検索コ
13906
13992
  追加するselectorコマンドのdrilldown_limit引数のデフォルト値を指定します。
13907
13993
  .UNINDENT
13908
13994
  .UNINDENT
13909
- .SS 返値
13910
- .SS json形式
13995
+ .SS Return value
13911
13996
  .INDENT 0.0
13912
13997
  .INDENT 3.5
13913
13998
  .sp
@@ -13925,95 +14010,81 @@ define_selectorは、検索条件をカスタマイズした新たな検索コ
13925
14010
  エラーが生じなかった場合にはtrue、エラーが生じた場合にはfalseを返す。
13926
14011
  .UNINDENT
13927
14012
  .UNINDENT
13928
- .SS 例
14013
+ .SS See also
13929
14014
  .sp
13930
- テーブルEntryの全レコード・全カラムの値を出力するselectorコマンドを定義します。:
14015
+ \fB/reference/grn_expr\fP
14016
+ .SS \fBdefrag\fP
14017
+ .SS Summary
14018
+ .sp
14019
+ \fBdefrag\fP command resolves fragmentation of specified objects.
14020
+ .sp
14021
+ Groonga組込コマンドの一つであるdefragについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力
14022
+ 、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
14023
+ .sp
14024
+ defragは、対象となるオブジェクト(データベースか可変長サイズカラム)を指定し、オブジェクトのフラグメンテーショ
14025
+ ンを解消します。
14026
+ .SS Syntax
13931
14027
  .INDENT 0.0
13932
14028
  .INDENT 3.5
13933
14029
  .sp
13934
14030
  .nf
13935
14031
  .ft C
13936
- define_selector entry_selector Entry
13937
- [true]
14032
+ defrag objname threshold
13938
14033
  .ft P
13939
14034
  .fi
13940
14035
  .UNINDENT
13941
14036
  .UNINDENT
13942
- .SS 関連項目
13943
- .sp
13944
- \fB/reference/grn_expr\fP
13945
- .SS defrag
13946
- .SS 名前
14037
+ .SS Usage
13947
14038
  .sp
13948
- \fBdefrag\fP command resolves fragmentation of specified objects.
13949
- .SS 書式
14039
+ 開いているデータベースのフラグメンテーションを解消する:
13950
14040
  .INDENT 0.0
13951
14041
  .INDENT 3.5
13952
14042
  .sp
13953
14043
  .nf
13954
14044
  .ft C
13955
- defrag objname threshold
14045
+ defrag
14046
+ [300]
13956
14047
  .ft P
13957
14048
  .fi
13958
14049
  .UNINDENT
13959
14050
  .UNINDENT
13960
- .SS 説明
13961
- .sp
13962
- Groonga組込コマンドの一つであるdefragについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
13963
- .sp
13964
- defragは、対象となるオブジェクト(データベースか可変長サイズカラム)を指定し、オブジェクトのフラグメンテーションを解消します。
13965
- .SS 引数
13966
14051
  .sp
13967
- \fBobjname\fP
13968
- .INDENT 0.0
13969
- .INDENT 3.5
13970
- 対象となるオブジェクト名を指定します。空の場合、開いているdbオブジェクトが対象となります。
13971
- .UNINDENT
13972
- .UNINDENT
13973
- .SS 返値
13974
- .SS json形式
14052
+ テーブル名 Entry のカラム body のフラグメンテーションを解消する:
13975
14053
  .INDENT 0.0
13976
14054
  .INDENT 3.5
13977
14055
  .sp
13978
14056
  .nf
13979
14057
  .ft C
13980
- [フラグメンテーション解消を実行したセグメントの数]
14058
+ defrag Entry.body
14059
+ [30]
13981
14060
  .ft P
13982
14061
  .fi
13983
14062
  .UNINDENT
13984
14063
  .UNINDENT
14064
+ .SS Parameters
13985
14065
  .sp
13986
- \fBフラグメンテーション解消を実行したセグメントの数\fP
14066
+ \fBobjname\fP
13987
14067
  .INDENT 0.0
13988
14068
  .INDENT 3.5
13989
- フラグメンテーション解消を実行したセグメントの数を返す。
14069
+ 対象となるオブジェクト名を指定します。空の場合、開いているdbオブジェクトが対象となります。
13990
14070
  .UNINDENT
13991
14071
  .UNINDENT
13992
- .SS 例
13993
- .sp
13994
- 開いているデータベースのフラグメンテーションを解消する:
14072
+ .SS Return value
13995
14073
  .INDENT 0.0
13996
14074
  .INDENT 3.5
13997
14075
  .sp
13998
14076
  .nf
13999
14077
  .ft C
14000
- defrag
14001
- [300]
14078
+ [フラグメンテーション解消を実行したセグメントの数]
14002
14079
  .ft P
14003
14080
  .fi
14004
14081
  .UNINDENT
14005
14082
  .UNINDENT
14006
14083
  .sp
14007
- テーブル名 Entry のカラム body のフラグメンテーションを解消する:
14084
+ \fBフラグメンテーション解消を実行したセグメントの数\fP
14008
14085
  .INDENT 0.0
14009
14086
  .INDENT 3.5
14010
- .sp
14011
- .nf
14012
- .ft C
14013
- defrag Entry.body
14014
- [30]
14015
- .ft P
14016
- .fi
14087
+ フラグメンテーション解消を実行したセグメントの数を返す。
14017
14088
  .UNINDENT
14018
14089
  .UNINDENT
14019
14090
  .SS \fBdelete\fP
@@ -14274,28 +14345,18 @@ If command succeeded, it returns true, otherwise it returns false on error.
14274
14345
  .SS See also
14275
14346
  .sp
14276
14347
  \fBload\fP
14277
- .SS dump
14278
- .SS 名前
14348
+ .SS \fBdump\fP
14349
+ .SS Summary
14279
14350
  .sp
14280
14351
  dump \- データベースのスキーマとデータを出力する
14281
- .SS 書式
14282
- .INDENT 0.0
14283
- .INDENT 3.5
14284
- .sp
14285
- .nf
14286
- .ft C
14287
- dump [tables]
14288
- .ft P
14289
- .fi
14290
- .UNINDENT
14291
- .UNINDENT
14292
- .SS 説明
14293
14352
  .sp
14294
- Groonga組込コマンドの一つであるdumpについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
14353
+ Groonga組込コマンドの一つであるdumpについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、
14354
+ またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
14295
14355
  .sp
14296
- dumpはデータベースのスキーマとデータを後から読み込めるフォーマットで出力します。dumpの結果は大きくなるため、主にコマンドラインから使うことを想定しています。データベースのバックアップが主な利用方法です。
14356
+ dumpはデータベースのスキーマとデータを後から読み込めるフォーマットで出力します。dumpの結果は大きくなるため、
14357
+ 主にコマンドラインから使うことを想定しています。データベースのバックアップが主な利用方法です。
14297
14358
  .sp
14298
- dumpが出力するフォーマットは直接Groongaが解釈できるフォーマットです。そのため、以下のようにしてデータベースをコピーすることができます。:
14359
+ dumpが出力するフォーマットは直接Groongaが解釈できるフォーマットです。そのため、以下のようにしてデータベース>をコピーすることができます。:
14299
14360
  .INDENT 0.0
14300
14361
  .INDENT 3.5
14301
14362
  .sp
@@ -14308,18 +14369,18 @@ dumpが出力するフォーマットは直接Groongaが解釈できるフォー
14308
14369
  .fi
14309
14370
  .UNINDENT
14310
14371
  .UNINDENT
14311
- .SS 引数
14312
- .sp
14313
- \fBtables\fP
14372
+ .SS Syntax
14314
14373
  .INDENT 0.0
14315
14374
  .INDENT 3.5
14316
- 出力対象のテーブルを「,」（カンマ）区切りで指定します。存在しないテーブルを指定した場合は無視されます。
14375
+ .sp
14376
+ .nf
14377
+ .ft C
14378
+ dump [tables]
14379
+ .ft P
14380
+ .fi
14317
14381
  .UNINDENT
14318
14382
  .UNINDENT
14319
- .SS 返値
14320
- .sp
14321
- データベースのスキーマとデータをGroongaの組み込みコマンド呼び出し形式で出力します。output_type指定は無視されます。
14322
- .SS 例
14383
+ .SS Usage
14323
14384
  .sp
14324
14385
  データベース内のすべてのデータを出力:
14325
14386
  .INDENT 0.0
@@ -14377,6 +14438,17 @@ load \-\-table Sites
14377
14438
  .fi
14378
14439
  .UNINDENT
14379
14440
  .UNINDENT
14441
+ .SS Parameters
14442
+ .sp
14443
+ \fBtables\fP
14444
+ .INDENT 0.0
14445
+ .INDENT 3.5
14446
+ 出力対象のテーブルを「,」（カンマ）区切りで指定します。存在しないテーブルを指定した場合は無視されます。
14447
+ .UNINDENT
14448
+ .UNINDENT
14449
+ .SS Return value
14450
+ .sp
14451
+ データベースのスキーマとデータをGroongaの組み込みコマンド呼び出し形式で出力します。output_type指定は無視されます。
14380
14452
  .SS \fBload\fP
14381
14453
  .SS Summary
14382
14454
  .sp
@@ -14505,11 +14577,15 @@ load \-\-table Entry \-\-input_type json
14505
14577
  .SS See also
14506
14578
  .sp
14507
14579
  \fB/reference/grn_expr\fP
14508
- .SS log_level
14509
- .SS 名前
14580
+ .SS \fBlog_level\fP
14581
+ .SS Summary
14510
14582
  .sp
14511
14583
  log_level \- ログ出力レベルの設定
14512
- .SS 書式
14584
+ .sp
14585
+ Groonga組込コマンドの一つであるlog_levelについて説明します。組込コマンドは、groonga実行ファイルの引数、標準>入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
14586
+ .sp
14587
+ log_levelは、ログ出力レベルを設定します。
14588
+ .SS Syntax
14513
14589
  .INDENT 0.0
14514
14590
  .INDENT 3.5
14515
14591
  .sp
@@ -14520,12 +14596,19 @@ log_level level
14520
14596
  .fi
14521
14597
  .UNINDENT
14522
14598
  .UNINDENT
14523
- .SS 説明
14524
- .sp
14525
- Groonga組込コマンドの一つであるlog_levelについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
14599
+ .SS Usage
14600
+ .INDENT 0.0
14601
+ .INDENT 3.5
14526
14602
  .sp
14527
- log_levelは、ログ出力レベルを設定します。
14528
- .SS 引数
14603
+ .nf
14604
+ .ft C
14605
+ log_level warning
14606
+ [true]
14607
+ .ft P
14608
+ .fi
14609
+ .UNINDENT
14610
+ .UNINDENT
14611
+ .SS Parameters
14529
14612
  .sp
14530
14613
  \fBlevel\fP
14531
14614
  .INDENT 0.0
@@ -14545,8 +14628,7 @@ debug
14545
14628
  .UNINDENT
14546
14629
  .UNINDENT
14547
14630
  .UNINDENT
14548
- .SS 返値
14549
- .SS json形式
14631
+ .SS Return value
14550
14632
  .INDENT 0.0
14551
14633
  .INDENT 3.5
14552
14634
  .sp
@@ -14564,43 +14646,42 @@ debug
14564
14646
  エラーが生じなかった場合にはtrue、エラーが生じた場合にはfalseを返す。
14565
14647
  .UNINDENT
14566
14648
  .UNINDENT
14567
- .SS 例
14649
+ .SS See also
14650
+ .sp
14651
+ \fBlog_put\fP
14652
+ \fBlog_reopen\fP
14653
+ .SS \fBlog_put\fP
14654
+ .SS Summary
14655
+ .sp
14656
+ log_put \- ログ出力
14657
+ .sp
14658
+ groonga組込コマンドの一つであるlog_putについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入>力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
14659
+ .sp
14660
+ log_putは、ログにmessageを出力します。
14661
+ .SS Syntax
14568
14662
  .INDENT 0.0
14569
14663
  .INDENT 3.5
14570
14664
  .sp
14571
14665
  .nf
14572
14666
  .ft C
14573
- log_level warning
14574
- [true]
14667
+ log_put level message
14575
14668
  .ft P
14576
14669
  .fi
14577
14670
  .UNINDENT
14578
14671
  .UNINDENT
14579
- .SS 関連項目
14580
- .sp
14581
- \fBlog_put\fP
14582
- \fBlog_reopen\fP
14583
- .SS log_put
14584
- .SS 名前
14585
- .sp
14586
- log_put \- ログ出力
14587
- .SS 書式
14672
+ .SS Usage
14588
14673
  .INDENT 0.0
14589
14674
  .INDENT 3.5
14590
14675
  .sp
14591
14676
  .nf
14592
14677
  .ft C
14593
- log_put level message
14678
+ log_put ERROR ****MESSAGE****
14679
+ [true]
14594
14680
  .ft P
14595
14681
  .fi
14596
14682
  .UNINDENT
14597
14683
  .UNINDENT
14598
- .SS 説明
14599
- .sp
14600
- groonga組込コマンドの一つであるlog_putについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
14601
- .sp
14602
- log_putは、ログにmessageを出力します。
14603
- .SS 引数
14684
+ .SS Parameters
14604
14685
  .sp
14605
14686
  \fBlevel\fP
14606
14687
  .INDENT 0.0
@@ -14627,8 +14708,7 @@ debug
14627
14708
  出力する文字列を指定します。
14628
14709
  .UNINDENT
14629
14710
  .UNINDENT
14630
- .SS 返値
14631
- .SS json形式
14711
+ .SS Return value
14632
14712
  .INDENT 0.0
14633
14713
  .INDENT 3.5
14634
14714
  .sp
@@ -14646,67 +14726,33 @@ debug
14646
14726
  エラーが生じなかった場合にはtrue、エラーが生じた場合にはfalseを返す。
14647
14727
  .UNINDENT
14648
14728
  .UNINDENT
14649
- .SS 例
14650
- .INDENT 0.0
14651
- .INDENT 3.5
14652
- .sp
14653
- .nf
14654
- .ft C
14655
- log_put ERROR ****MESSAGE****
14656
- [true]
14657
- .ft P
14658
- .fi
14659
- .UNINDENT
14660
- .UNINDENT
14661
- .SS 関連項目
14729
+ .SS See also
14662
14730
  .sp
14663
14731
  \fBlog_level\fP
14664
14732
  \fBlog_reopen\fP
14665
- .SS log_reopen
14666
- .SS 名前
14733
+ .SS \fBlog_reopen\fP
14734
+ .SS Summary
14667
14735
  .sp
14668
14736
  log_reopen \- ログファイルの再読み込み
14669
- .SS 書式
14670
- .INDENT 0.0
14671
- .INDENT 3.5
14672
- .sp
14673
- .nf
14674
- .ft C
14675
- log_reopen
14676
- .ft P
14677
- .fi
14678
- .UNINDENT
14679
- .UNINDENT
14680
- .SS 説明
14681
14737
  .sp
14682
- Groonga組込コマンドの一つであるlog_reopenについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
14738
+ Groonga組込コマンドの一つであるlog_reopenについて説明します。組込コマンドは、groonga実行ファイルの引数、標準
14739
+ 入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
14683
14740
  .sp
14684
14741
  log_reopenは、ログファイルを再読み込みします。
14685
14742
  .sp
14686
14743
  現在、デフォルトのログ関数を用いている場合のみに対応しています。
14687
- .SS 引数
14688
- .sp
14689
- ありません。
14690
- .SS 返値
14691
- .SS json形式
14744
+ .SS Syntax
14692
14745
  .INDENT 0.0
14693
14746
  .INDENT 3.5
14694
14747
  .sp
14695
14748
  .nf
14696
14749
  .ft C
14697
- [成功かどうかのフラグ]
14750
+ log_reopen
14698
14751
  .ft P
14699
14752
  .fi
14700
14753
  .UNINDENT
14701
14754
  .UNINDENT
14702
- .sp
14703
- \fB成功かどうかのフラグ\fP
14704
- .INDENT 0.0
14705
- .INDENT 3.5
14706
- エラーが生じなかった場合にはtrue、エラーが生じた場合にはfalseを返す。
14707
- .UNINDENT
14708
- .UNINDENT
14709
- .SS 例
14755
+ .SS Usage
14710
14756
  .INDENT 0.0
14711
14757
  .INDENT 3.5
14712
14758
  .sp
@@ -14730,11 +14776,32 @@ log_reopenコマンドを実行する。
14730
14776
  既存のログファイル名と同じファイル名で、新たなログファイルが作成される。
14731
14777
  今後のログは新たなログファイルに書き込まれる。
14732
14778
  .UNINDENT
14733
- .SS 関連項目
14779
+ .SS Parameters
14734
14780
  .sp
14735
- \fBlog_level\fP
14736
- \fBlog_put\fP
14737
- .SS \fBnormalize\fP
14781
+ ありません。
14782
+ .SS Return value
14783
+ .INDENT 0.0
14784
+ .INDENT 3.5
14785
+ .sp
14786
+ .nf
14787
+ .ft C
14788
+ [成功かどうかのフラグ]
14789
+ .ft P
14790
+ .fi
14791
+ .UNINDENT
14792
+ .UNINDENT
14793
+ .sp
14794
+ \fB成功かどうかのフラグ\fP
14795
+ .INDENT 0.0
14796
+ .INDENT 3.5
14797
+ エラーが生じなかった場合にはtrue、エラーが生じた場合にはfalseを返す。
14798
+ .UNINDENT
14799
+ .UNINDENT
14800
+ .SS See also
14801
+ .sp
14802
+ \fBlog_level\fP
14803
+ \fBlog_put\fP
14804
+ .SS \fBnormalize\fP
14738
14805
  .sp
14739
14806
  \fBCAUTION:\fP
14740
14807
  .INDENT 0.0
@@ -14997,7 +15064,7 @@ that contains the name. The attribute will be increased in the feature:
14997
15064
  .sp
14998
15065
  .nf
14999
15066
  .ft C
15000
- [HEADER, normalizer]
15067
+ [HEADER, normalizers]
15001
15068
  .ft P
15002
15069
  .fi
15003
15070
  .UNINDENT
@@ -15010,10 +15077,10 @@ See \fB/reference/command/output_format\fP about \fBHEADER\fP\&.
15010
15077
  .UNINDENT
15011
15078
  .UNINDENT
15012
15079
  .sp
15013
- \fBnormalizer\fP
15080
+ \fBnormalizers\fP
15014
15081
  .INDENT 0.0
15015
15082
  .INDENT 3.5
15016
- \fBnormalizer\fP is an array of normalizer. Normalizer is an object that has the following
15083
+ \fBnormalizers\fP is an array of normalizer. Normalizer is an object that has the following
15017
15084
  attributes.
15018
15085
  .TS
15019
15086
  center;
@@ -15041,11 +15108,17 @@ _
15041
15108
  .IP \(bu 2
15042
15109
  \fB/reference/commands/normalize\fP
15043
15110
  .UNINDENT
15044
- .SS quit
15045
- .SS 名前
15111
+ .SS \fBquit\fP
15112
+ .SS Summary
15046
15113
  .sp
15047
15114
  quit \- セッション終了
15048
- .SS 書式
15115
+ .sp
15116
+ Groonga組込コマンドの一つであるquitについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、
15117
+ またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
15118
+ .sp
15119
+ quitは、groongaプロセスとのセッションを終了します。クライアントプロセスならばgroongaプロセスとの接続を切りま
15120
+ す。
15121
+ .SS Syntax
15049
15122
  .INDENT 0.0
15050
15123
  .INDENT 3.5
15051
15124
  .sp
@@ -15056,18 +15129,7 @@ quit
15056
15129
  .fi
15057
15130
  .UNINDENT
15058
15131
  .UNINDENT
15059
- .SS 説明
15060
- .sp
15061
- Groonga組込コマンドの一つであるquitについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
15062
- .sp
15063
- quitは、groongaプロセスとのセッションを終了します。クライアントプロセスならばgroongaプロセスとの接続を切ります。
15064
- .SS 引数
15065
- .sp
15066
- ありません。
15067
- .SS 返値
15068
- .sp
15069
- ありません。
15070
- .SS 例
15132
+ .SS Usage
15071
15133
  .INDENT 0.0
15072
15134
  .INDENT 3.5
15073
15135
  .sp
@@ -15078,7 +15140,13 @@ quit
15078
15140
  .fi
15079
15141
  .UNINDENT
15080
15142
  .UNINDENT
15081
- .SS register
15143
+ .SS Parameters
15144
+ .sp
15145
+ ありません。
15146
+ .SS Return value
15147
+ .sp
15148
+ ありません。
15149
+ .SS \fBregister\fP
15082
15150
  .SS Summary
15083
15151
  .sp
15084
15152
  \fBregister\fP command registers a plugin. You need to register a plugin
@@ -18191,11 +18259,16 @@ drilldown_output_columns, drilldown_offset, drilldown_limitによって指定さ
18191
18259
  .UNINDENT
18192
18260
  .UNINDENT
18193
18261
  .UNINDENT
18194
- .SS shutdown
18195
- .SS 名前
18262
+ .SS \fBshutdown\fP
18263
+ .SS Summary
18196
18264
  .sp
18197
18265
  shutdown \- サーバプロセスの停止
18198
- .SS 書式
18266
+ .sp
18267
+ Groonga組込コマンドの一つであるshutdownについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入
18268
+ 力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
18269
+ .sp
18270
+ shutdownは、接続しているgroongaサーバプロセスを停止します。
18271
+ .SS Syntax
18199
18272
  .INDENT 0.0
18200
18273
  .INDENT 3.5
18201
18274
  .sp
@@ -18206,53 +18279,77 @@ shutdown
18206
18279
  .fi
18207
18280
  .UNINDENT
18208
18281
  .UNINDENT
18209
- .SS 説明
18210
- .sp
18211
- Groonga組込コマンドの一つであるshutdownについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
18282
+ .SS Usage
18283
+ .INDENT 0.0
18284
+ .INDENT 3.5
18212
18285
  .sp
18213
- shutdownは、接続しているgroongaサーバプロセスを停止します。
18214
- .SS 引数
18286
+ .nf
18287
+ .ft C
18288
+ shutdown
18289
+ .ft P
18290
+ .fi
18291
+ .UNINDENT
18292
+ .UNINDENT
18293
+ .SS Parameters
18215
18294
  .sp
18216
18295
  ありません。
18217
- .SS 返値
18296
+ .SS Return value
18218
18297
  .sp
18219
18298
  ありません。
18220
- .SS 例
18299
+ .SS \fBstatus\fP
18300
+ .SS Summary
18301
+ .sp
18302
+ status \- groongaプロセスの状態表示
18303
+ .sp
18304
+ Groonga組込コマンドの一つであるstatusについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
18305
+ .sp
18306
+ statusコマンドは、groongaプロセスの状態を表示します。主にgroongaサーバプロセスに対して使用することを想定しています。
18307
+ .SS Syntax
18221
18308
  .INDENT 0.0
18222
18309
  .INDENT 3.5
18223
18310
  .sp
18224
18311
  .nf
18225
18312
  .ft C
18226
- shutdown
18313
+ status
18227
18314
  .ft P
18228
18315
  .fi
18229
18316
  .UNINDENT
18230
18317
  .UNINDENT
18231
- .SS status
18232
- .SS 名前
18318
+ .SS Usage
18233
18319
  .sp
18234
- status \- groongaプロセスの状態表示
18235
- .SS 書式
18320
+ Execution example:
18236
18321
  .INDENT 0.0
18237
18322
  .INDENT 3.5
18238
18323
  .sp
18239
18324
  .nf
18240
18325
  .ft C
18241
18326
  status
18327
+ # [
18328
+ # [
18329
+ # 0,
18330
+ # 1337566253.89858,
18331
+ # 0.000355720520019531
18332
+ # ],
18333
+ # {
18334
+ # "uptime": 7,
18335
+ # "max_command_version": 2,
18336
+ # "n_queries": 39,
18337
+ # "cache_hit_rate": 0.0,
18338
+ # "version": "4.0.1",
18339
+ # "alloc_count": 309,
18340
+ # "command_version": 1,
18341
+ # "starttime": 1395806014,
18342
+ # "default_command_version": 1
18343
+ # }
18344
+ # ]
18242
18345
  .ft P
18243
18346
  .fi
18244
18347
  .UNINDENT
18245
18348
  .UNINDENT
18246
- .SS 説明
18247
- .sp
18248
- Groonga組込コマンドの一つであるstatusについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
18249
- .sp
18250
- statusコマンドは、groongaプロセスの状態を表示します。主にgroongaサーバプロセスに対して使用することを想定しています。
18251
- .SS 引数
18349
+ .SS Parameters
18252
18350
  .sp
18253
18351
  ありません。
18254
- .SS 返値
18255
- .SS json形式
18352
+ .SS Return value
18256
18353
  .INDENT 0.0
18257
18354
  .INDENT 3.5
18258
18355
  .sp
@@ -18284,38 +18381,7 @@ groongaプロセスが起動した時刻のtvsec値を返します。
18284
18381
  groongaプロセスが起動してから経過した秒数を返します。
18285
18382
  .UNINDENT
18286
18383
  .UNINDENT
18287
- .SS 例
18288
- .sp
18289
- Execution example:
18290
- .INDENT 0.0
18291
- .INDENT 3.5
18292
- .sp
18293
- .nf
18294
- .ft C
18295
- status
18296
- # [
18297
- # [
18298
- # 0,
18299
- # 1337566253.89858,
18300
- # 0.000355720520019531
18301
- # ],
18302
- # {
18303
- # "uptime": 7,
18304
- # "max_command_version": 2,
18305
- # "n_queries": 39,
18306
- # "cache_hit_rate": 0.0,
18307
- # "version": "4.0.1",
18308
- # "alloc_count": 309,
18309
- # "command_version": 1,
18310
- # "starttime": 1395806014,
18311
- # "default_command_version": 1
18312
- # }
18313
- # ]
18314
- .ft P
18315
- .fi
18316
- .UNINDENT
18317
- .UNINDENT
18318
- .SS suggest
18384
+ .SS \fBsuggest\fP
18319
18385
  .sp
18320
18386
  \fBNOTE:\fP
18321
18387
  .INDENT 0.0
@@ -18324,10 +18390,16 @@ The suggest feature specification isn\(aqt stable. The
18324
18390
  specification may be changed.
18325
18391
  .UNINDENT
18326
18392
  .UNINDENT
18327
- .SS NAME
18393
+ .SS Summary
18328
18394
  .sp
18329
18395
  suggest \- returns completion, correction and/or suggestion for a query.
18330
- .SS SYNOPSIS
18396
+ .sp
18397
+ The suggest command returns completion, correction and/or
18398
+ suggestion for a specified query.
18399
+ .sp
18400
+ See \fB/suggest/introduction\fP about completion,
18401
+ correction and suggestion.
18402
+ .SS Syntax
18331
18403
  .INDENT 0.0
18332
18404
  .INDENT 3.5
18333
18405
  .sp
@@ -18338,101 +18410,380 @@ suggest types table column query [sortby [output_columns [offset [limit [frequen
18338
18410
  .fi
18339
18411
  .UNINDENT
18340
18412
  .UNINDENT
18341
- .SS DESCRIPTION
18342
- .sp
18343
- The suggest command returns completion, correction and/or
18344
- suggestion for a specified query.
18345
- .sp
18346
- See \fB/suggest/introduction\fP about completion,
18347
- correction and suggestion.
18348
- .SS OPTIONS
18349
- .INDENT 0.0
18350
- .TP
18351
- .B \fBtypes\fP
18352
- It specifies what types are returned by the suggest
18353
- command.
18413
+ .SS Usage
18354
18414
  .sp
18355
- Here are available types:
18356
- .INDENT 7.0
18357
- .INDENT 3.5
18358
- .INDENT 0.0
18359
- .TP
18360
- .B \fBcomplete\fP
18361
- The suggest command does completion.
18362
- .TP
18363
- .B \fBcorrect\fP
18364
- The suggest command does correction.
18365
- .TP
18366
- .B \fBsuggest\fP
18367
- The suggest command does suggestion.
18368
- .UNINDENT
18369
- .UNINDENT
18370
- .UNINDENT
18415
+ Here are learned data for completion.
18371
18416
  .sp
18372
- You can specify one or more types separated by \fB|\fP\&.
18373
- Here are examples:
18374
- .INDENT 7.0
18375
- .INDENT 3.5
18376
- It returns correction:
18417
+ Execution example:
18377
18418
  .INDENT 0.0
18378
18419
  .INDENT 3.5
18379
18420
  .sp
18380
18421
  .nf
18381
18422
  .ft C
18382
- correct
18423
+ load \-\-table event_query \-\-each \(aqsuggest_preparer(_id, type, item, sequence, time, pair_query)\(aq
18424
+ [
18425
+ {"sequence": "1", "time": 1312950803.86057, "item": "e"},
18426
+ {"sequence": "1", "time": 1312950803.96857, "item": "en"},
18427
+ {"sequence": "1", "time": 1312950804.26057, "item": "eng"},
18428
+ {"sequence": "1", "time": 1312950804.56057, "item": "engi"},
18429
+ {"sequence": "1", "time": 1312950804.76057, "item": "engin"},
18430
+ {"sequence": "1", "time": 1312950805.86057, "item": "engine", "type": "submit"}
18431
+ ]
18432
+ # [[0, 1337566253.89858, 0.000355720520019531], 6]
18383
18433
  .ft P
18384
18434
  .fi
18385
18435
  .UNINDENT
18386
18436
  .UNINDENT
18387
18437
  .sp
18388
- It returns correction and suggestion:
18438
+ Here are learned data for correction.
18439
+ .sp
18440
+ Execution example:
18389
18441
  .INDENT 0.0
18390
18442
  .INDENT 3.5
18391
18443
  .sp
18392
18444
  .nf
18393
18445
  .ft C
18394
- correct|suggest
18446
+ load \-\-table event_query \-\-each \(aqsuggest_preparer(_id, type, item, sequence, time, pair_query)\(aq
18447
+ [
18448
+ {"sequence": "2", "time": 1312950803.86057, "item": "s"},
18449
+ {"sequence": "2", "time": 1312950803.96857, "item": "sa"},
18450
+ {"sequence": "2", "time": 1312950804.26057, "item": "sae"},
18451
+ {"sequence": "2", "time": 1312950804.56057, "item": "saer"},
18452
+ {"sequence": "2", "time": 1312950804.76057, "item": "saerc"},
18453
+ {"sequence": "2", "time": 1312950805.76057, "item": "saerch", "type": "submit"},
18454
+ {"sequence": "2", "time": 1312950809.76057, "item": "serch"},
18455
+ {"sequence": "2", "time": 1312950810.86057, "item": "search", "type": "submit"}
18456
+ ]
18457
+ # [[0, 1337566253.89858, 0.000355720520019531], 8]
18395
18458
  .ft P
18396
18459
  .fi
18397
18460
  .UNINDENT
18398
18461
  .UNINDENT
18399
18462
  .sp
18400
- It returns complete, correction and suggestion:
18463
+ Here are learned data for suggestion.
18464
+ .sp
18465
+ Execution example:
18401
18466
  .INDENT 0.0
18402
18467
  .INDENT 3.5
18403
18468
  .sp
18404
18469
  .nf
18405
18470
  .ft C
18406
- complete|correct|suggest
18471
+ load \-\-table event_query \-\-each \(aqsuggest_preparer(_id, type, item, sequence, time, pair_query)\(aq
18472
+ [
18473
+ {"sequence": "3", "time": 1312950803.86057, "item": "search engine", "type": "submit"},
18474
+ {"sequence": "3", "time": 1312950808.86057, "item": "web search realtime", "type": "submit"}
18475
+ ]
18476
+ # [[0, 1337566253.89858, 0.000355720520019531], 2]
18407
18477
  .ft P
18408
18478
  .fi
18409
18479
  .UNINDENT
18410
18480
  .UNINDENT
18411
- .UNINDENT
18412
- .UNINDENT
18413
- .TP
18414
- .B \fBtable\fP
18415
- It specifies table name that has \fBitem_${DATA_SET_NAME}\fP format.
18416
- For example, \fBitem_query\fP is a table name if you created
18417
- dataset by the following command:
18418
- .INDENT 7.0
18481
+ .sp
18482
+ Here is a completion example.
18483
+ .sp
18484
+ Execution example:
18485
+ .INDENT 0.0
18419
18486
  .INDENT 3.5
18420
18487
  .sp
18421
18488
  .nf
18422
18489
  .ft C
18423
- groonga\-suggest\-create\-dataset /tmp/db\-path query
18424
- .ft P
18425
- .fi
18426
- .UNINDENT
18427
- .UNINDENT
18428
- .TP
18429
- .B \fBcolumn\fP
18430
- It specifies a column name that has furigana in
18431
- Katakana in \fBtable\fP table.
18432
- .TP
18433
- .B \fBquery\fP
18434
- It specifies query for completion, correction and/or
18435
- suggestion.
18490
+ suggest \-\-table item_query \-\-column kana \-\-types complete \-\-frequency_threshold 1 \-\-query en
18491
+ # [
18492
+ # [
18493
+ # 0,
18494
+ # 1337566253.89858,
18495
+ # 0.000355720520019531
18496
+ # ],
18497
+ # {
18498
+ # "complete": [
18499
+ # [
18500
+ # 1
18501
+ # ],
18502
+ # [
18503
+ # [
18504
+ # "_key",
18505
+ # "ShortText"
18506
+ # ],
18507
+ # [
18508
+ # "_score",
18509
+ # "Int32"
18510
+ # ]
18511
+ # ],
18512
+ # [
18513
+ # "engine",
18514
+ # 1
18515
+ # ]
18516
+ # ]
18517
+ # }
18518
+ # ]
18519
+ .ft P
18520
+ .fi
18521
+ .UNINDENT
18522
+ .UNINDENT
18523
+ .sp
18524
+ Here is a correction example.
18525
+ .sp
18526
+ Execution example:
18527
+ .INDENT 0.0
18528
+ .INDENT 3.5
18529
+ .sp
18530
+ .nf
18531
+ .ft C
18532
+ suggest \-\-table item_query \-\-column kana \-\-types correct \-\-frequency_threshold 1 \-\-query saerch
18533
+ # [
18534
+ # [
18535
+ # 0,
18536
+ # 1337566253.89858,
18537
+ # 0.000355720520019531
18538
+ # ],
18539
+ # {
18540
+ # "correct": [
18541
+ # [
18542
+ # 1
18543
+ # ],
18544
+ # [
18545
+ # [
18546
+ # "_key",
18547
+ # "ShortText"
18548
+ # ],
18549
+ # [
18550
+ # "_score",
18551
+ # "Int32"
18552
+ # ]
18553
+ # ],
18554
+ # [
18555
+ # "search",
18556
+ # 1
18557
+ # ]
18558
+ # ]
18559
+ # }
18560
+ # ]
18561
+ .ft P
18562
+ .fi
18563
+ .UNINDENT
18564
+ .UNINDENT
18565
+ .sp
18566
+ Here is a suggestion example.
18567
+ .sp
18568
+ Execution example:
18569
+ .INDENT 0.0
18570
+ .INDENT 3.5
18571
+ .sp
18572
+ .nf
18573
+ .ft C
18574
+ suggest \-\-table item_query \-\-column kana \-\-types suggest \-\-frequency_threshold 1 \-\-query search
18575
+ # [
18576
+ # [
18577
+ # 0,
18578
+ # 1337566253.89858,
18579
+ # 0.000355720520019531
18580
+ # ],
18581
+ # {
18582
+ # "suggest": [
18583
+ # [
18584
+ # 2
18585
+ # ],
18586
+ # [
18587
+ # [
18588
+ # "_key",
18589
+ # "ShortText"
18590
+ # ],
18591
+ # [
18592
+ # "_score",
18593
+ # "Int32"
18594
+ # ]
18595
+ # ],
18596
+ # [
18597
+ # "search engine",
18598
+ # 1
18599
+ # ],
18600
+ # [
18601
+ # "web search realtime",
18602
+ # 1
18603
+ # ]
18604
+ # ]
18605
+ # }
18606
+ # ]
18607
+ .ft P
18608
+ .fi
18609
+ .UNINDENT
18610
+ .UNINDENT
18611
+ .sp
18612
+ Here is a mixed example.
18613
+ .sp
18614
+ Execution example:
18615
+ .INDENT 0.0
18616
+ .INDENT 3.5
18617
+ .sp
18618
+ .nf
18619
+ .ft C
18620
+ suggest \-\-table item_query \-\-column kana \-\-types complete|correct|suggest \-\-frequency_threshold 1 \-\-query search
18621
+ # [
18622
+ # [
18623
+ # 0,
18624
+ # 1337566253.89858,
18625
+ # 0.000355720520019531
18626
+ # ],
18627
+ # {
18628
+ # "suggest": [
18629
+ # [
18630
+ # 2
18631
+ # ],
18632
+ # [
18633
+ # [
18634
+ # "_key",
18635
+ # "ShortText"
18636
+ # ],
18637
+ # [
18638
+ # "_score",
18639
+ # "Int32"
18640
+ # ]
18641
+ # ],
18642
+ # [
18643
+ # "search engine",
18644
+ # 1
18645
+ # ],
18646
+ # [
18647
+ # "web search realtime",
18648
+ # 1
18649
+ # ]
18650
+ # ],
18651
+ # "complete": [
18652
+ # [
18653
+ # 2
18654
+ # ],
18655
+ # [
18656
+ # [
18657
+ # "_key",
18658
+ # "ShortText"
18659
+ # ],
18660
+ # [
18661
+ # "_score",
18662
+ # "Int32"
18663
+ # ]
18664
+ # ],
18665
+ # [
18666
+ # "search",
18667
+ # 2
18668
+ # ],
18669
+ # [
18670
+ # "search engine",
18671
+ # 2
18672
+ # ]
18673
+ # ],
18674
+ # "correct": [
18675
+ # [
18676
+ # 1
18677
+ # ],
18678
+ # [
18679
+ # [
18680
+ # "_key",
18681
+ # "ShortText"
18682
+ # ],
18683
+ # [
18684
+ # "_score",
18685
+ # "Int32"
18686
+ # ]
18687
+ # ],
18688
+ # [
18689
+ # "search",
18690
+ # 2
18691
+ # ]
18692
+ # ]
18693
+ # }
18694
+ # ]
18695
+ .ft P
18696
+ .fi
18697
+ .UNINDENT
18698
+ .UNINDENT
18699
+ .SS Parameters
18700
+ .INDENT 0.0
18701
+ .TP
18702
+ .B \fBtypes\fP
18703
+ It specifies what types are returned by the suggest
18704
+ command.
18705
+ .sp
18706
+ Here are available types:
18707
+ .INDENT 7.0
18708
+ .INDENT 3.5
18709
+ .INDENT 0.0
18710
+ .TP
18711
+ .B \fBcomplete\fP
18712
+ The suggest command does completion.
18713
+ .TP
18714
+ .B \fBcorrect\fP
18715
+ The suggest command does correction.
18716
+ .TP
18717
+ .B \fBsuggest\fP
18718
+ The suggest command does suggestion.
18719
+ .UNINDENT
18720
+ .UNINDENT
18721
+ .UNINDENT
18722
+ .sp
18723
+ You can specify one or more types separated by \fB|\fP\&.
18724
+ Here are examples:
18725
+ .INDENT 7.0
18726
+ .INDENT 3.5
18727
+ It returns correction:
18728
+ .INDENT 0.0
18729
+ .INDENT 3.5
18730
+ .sp
18731
+ .nf
18732
+ .ft C
18733
+ correct
18734
+ .ft P
18735
+ .fi
18736
+ .UNINDENT
18737
+ .UNINDENT
18738
+ .sp
18739
+ It returns correction and suggestion:
18740
+ .INDENT 0.0
18741
+ .INDENT 3.5
18742
+ .sp
18743
+ .nf
18744
+ .ft C
18745
+ correct|suggest
18746
+ .ft P
18747
+ .fi
18748
+ .UNINDENT
18749
+ .UNINDENT
18750
+ .sp
18751
+ It returns complete, correction and suggestion:
18752
+ .INDENT 0.0
18753
+ .INDENT 3.5
18754
+ .sp
18755
+ .nf
18756
+ .ft C
18757
+ complete|correct|suggest
18758
+ .ft P
18759
+ .fi
18760
+ .UNINDENT
18761
+ .UNINDENT
18762
+ .UNINDENT
18763
+ .UNINDENT
18764
+ .TP
18765
+ .B \fBtable\fP
18766
+ It specifies table name that has \fBitem_${DATA_SET_NAME}\fP format.
18767
+ For example, \fBitem_query\fP is a table name if you created
18768
+ dataset by the following command:
18769
+ .INDENT 7.0
18770
+ .INDENT 3.5
18771
+ .sp
18772
+ .nf
18773
+ .ft C
18774
+ groonga\-suggest\-create\-dataset /tmp/db\-path query
18775
+ .ft P
18776
+ .fi
18777
+ .UNINDENT
18778
+ .UNINDENT
18779
+ .TP
18780
+ .B \fBcolumn\fP
18781
+ It specifies a column name that has furigana in
18782
+ Katakana in \fBtable\fP table.
18783
+ .TP
18784
+ .B \fBquery\fP
18785
+ It specifies query for completion, correction and/or
18786
+ suggestion.
18436
18787
  .TP
18437
18788
  .B \fBsortby\fP
18438
18789
  It specifies sort key.
@@ -18542,344 +18893,57 @@ find any records.
18542
18893
  .UNINDENT
18543
18894
  .UNINDENT
18544
18895
  .UNINDENT
18545
- .INDENT 7.0
18546
- .TP
18547
- .B Default:
18548
- \fBauto\fP
18549
- .UNINDENT
18550
- .UNINDENT
18551
- .SS RETURN VALUE
18552
- .SS JSON format
18553
- .sp
18554
- Here is a returned JSON format:
18555
- .INDENT 0.0
18556
- .INDENT 3.5
18557
- .sp
18558
- .nf
18559
- .ft C
18560
- {"type1": [["candidate1", score of candidate1],
18561
- ["candidate2", score of candidate2],
18562
- ...],
18563
- "type2": [["candidate1", score of candidate1],
18564
- ["candidate2", score of candidate2],
18565
- ...],
18566
- ...}
18567
- .ft P
18568
- .fi
18569
- .UNINDENT
18570
- .UNINDENT
18571
- .sp
18572
- \fBtype\fP
18573
- .INDENT 0.0
18574
- .INDENT 3.5
18575
- A type specified by \fBtypes\fP\&.
18576
- .UNINDENT
18577
- .UNINDENT
18578
- .sp
18579
- \fBcandidate\fP
18580
- .INDENT 0.0
18581
- .INDENT 3.5
18582
- A candidate for completion, correction or suggestion.
18583
- .UNINDENT
18584
- .UNINDENT
18585
- .sp
18586
- \fBscore of candidate\fP
18587
- .INDENT 0.0
18588
- .INDENT 3.5
18589
- A score of corresponding \fBcandidate\fP\&. It means that
18590
- higher score candidate is more likely candidate for
18591
- completion, correction or suggestion. Returned candidates
18592
- are sorted by \fBscore of candidate\fP descending by
18593
- default.
18594
- .UNINDENT
18595
- .UNINDENT
18596
- .SS EXAMPLE
18597
- .sp
18598
- Here are learned data for completion.
18599
- .sp
18600
- Execution example:
18601
- .INDENT 0.0
18602
- .INDENT 3.5
18603
- .sp
18604
- .nf
18605
- .ft C
18606
- load \-\-table event_query \-\-each \(aqsuggest_preparer(_id, type, item, sequence, time, pair_query)\(aq
18607
- [
18608
- {"sequence": "1", "time": 1312950803.86057, "item": "e"},
18609
- {"sequence": "1", "time": 1312950803.96857, "item": "en"},
18610
- {"sequence": "1", "time": 1312950804.26057, "item": "eng"},
18611
- {"sequence": "1", "time": 1312950804.56057, "item": "engi"},
18612
- {"sequence": "1", "time": 1312950804.76057, "item": "engin"},
18613
- {"sequence": "1", "time": 1312950805.86057, "item": "engine", "type": "submit"}
18614
- ]
18615
- # [[0, 1337566253.89858, 0.000355720520019531], 6]
18616
- .ft P
18617
- .fi
18618
- .UNINDENT
18619
- .UNINDENT
18620
- .sp
18621
- Here are learned data for correction.
18622
- .sp
18623
- Execution example:
18624
- .INDENT 0.0
18625
- .INDENT 3.5
18626
- .sp
18627
- .nf
18628
- .ft C
18629
- load \-\-table event_query \-\-each \(aqsuggest_preparer(_id, type, item, sequence, time, pair_query)\(aq
18630
- [
18631
- {"sequence": "2", "time": 1312950803.86057, "item": "s"},
18632
- {"sequence": "2", "time": 1312950803.96857, "item": "sa"},
18633
- {"sequence": "2", "time": 1312950804.26057, "item": "sae"},
18634
- {"sequence": "2", "time": 1312950804.56057, "item": "saer"},
18635
- {"sequence": "2", "time": 1312950804.76057, "item": "saerc"},
18636
- {"sequence": "2", "time": 1312950805.76057, "item": "saerch", "type": "submit"},
18637
- {"sequence": "2", "time": 1312950809.76057, "item": "serch"},
18638
- {"sequence": "2", "time": 1312950810.86057, "item": "search", "type": "submit"}
18639
- ]
18640
- # [[0, 1337566253.89858, 0.000355720520019531], 8]
18641
- .ft P
18642
- .fi
18643
- .UNINDENT
18644
- .UNINDENT
18645
- .sp
18646
- Here are learned data for suggestion.
18647
- .sp
18648
- Execution example:
18649
- .INDENT 0.0
18650
- .INDENT 3.5
18651
- .sp
18652
- .nf
18653
- .ft C
18654
- load \-\-table event_query \-\-each \(aqsuggest_preparer(_id, type, item, sequence, time, pair_query)\(aq
18655
- [
18656
- {"sequence": "3", "time": 1312950803.86057, "item": "search engine", "type": "submit"},
18657
- {"sequence": "3", "time": 1312950808.86057, "item": "web search realtime", "type": "submit"}
18658
- ]
18659
- # [[0, 1337566253.89858, 0.000355720520019531], 2]
18660
- .ft P
18661
- .fi
18662
- .UNINDENT
18663
- .UNINDENT
18664
- .sp
18665
- Here is a completion example.
18666
- .sp
18667
- Execution example:
18668
- .INDENT 0.0
18669
- .INDENT 3.5
18670
- .sp
18671
- .nf
18672
- .ft C
18673
- suggest \-\-table item_query \-\-column kana \-\-types complete \-\-frequency_threshold 1 \-\-query en
18674
- # [
18675
- # [
18676
- # 0,
18677
- # 1337566253.89858,
18678
- # 0.000355720520019531
18679
- # ],
18680
- # {
18681
- # "complete": [
18682
- # [
18683
- # 1
18684
- # ],
18685
- # [
18686
- # [
18687
- # "_key",
18688
- # "ShortText"
18689
- # ],
18690
- # [
18691
- # "_score",
18692
- # "Int32"
18693
- # ]
18694
- # ],
18695
- # [
18696
- # "engine",
18697
- # 1
18698
- # ]
18699
- # ]
18700
- # }
18701
- # ]
18702
- .ft P
18703
- .fi
18704
- .UNINDENT
18705
- .UNINDENT
18706
- .sp
18707
- Here is a correction example.
18708
- .sp
18709
- Execution example:
18710
- .INDENT 0.0
18711
- .INDENT 3.5
18712
- .sp
18713
- .nf
18714
- .ft C
18715
- suggest \-\-table item_query \-\-column kana \-\-types correct \-\-frequency_threshold 1 \-\-query saerch
18716
- # [
18717
- # [
18718
- # 0,
18719
- # 1337566253.89858,
18720
- # 0.000355720520019531
18721
- # ],
18722
- # {
18723
- # "correct": [
18724
- # [
18725
- # 1
18726
- # ],
18727
- # [
18728
- # [
18729
- # "_key",
18730
- # "ShortText"
18731
- # ],
18732
- # [
18733
- # "_score",
18734
- # "Int32"
18735
- # ]
18736
- # ],
18737
- # [
18738
- # "search",
18739
- # 1
18740
- # ]
18741
- # ]
18742
- # }
18743
- # ]
18744
- .ft P
18745
- .fi
18746
- .UNINDENT
18896
+ .INDENT 7.0
18897
+ .TP
18898
+ .B Default:
18899
+ \fBauto\fP
18747
18900
  .UNINDENT
18901
+ .UNINDENT
18902
+ .SS Return value
18748
18903
  .sp
18749
- Here is a suggestion example.
18750
- .sp
18751
- Execution example:
18904
+ Here is a returned JSON format:
18752
18905
  .INDENT 0.0
18753
18906
  .INDENT 3.5
18754
18907
  .sp
18755
18908
  .nf
18756
18909
  .ft C
18757
- suggest \-\-table item_query \-\-column kana \-\-types suggest \-\-frequency_threshold 1 \-\-query search
18758
- # [
18759
- # [
18760
- # 0,
18761
- # 1337566253.89858,
18762
- # 0.000355720520019531
18763
- # ],
18764
- # {
18765
- # "suggest": [
18766
- # [
18767
- # 2
18768
- # ],
18769
- # [
18770
- # [
18771
- # "_key",
18772
- # "ShortText"
18773
- # ],
18774
- # [
18775
- # "_score",
18776
- # "Int32"
18777
- # ]
18778
- # ],
18779
- # [
18780
- # "search engine",
18781
- # 1
18782
- # ],
18783
- # [
18784
- # "web search realtime",
18785
- # 1
18786
- # ]
18787
- # ]
18788
- # }
18789
- # ]
18910
+ {"type1": [["candidate1", score of candidate1],
18911
+ ["candidate2", score of candidate2],
18912
+ ...],
18913
+ "type2": [["candidate1", score of candidate1],
18914
+ ["candidate2", score of candidate2],
18915
+ ...],
18916
+ ...}
18790
18917
  .ft P
18791
18918
  .fi
18792
18919
  .UNINDENT
18793
18920
  .UNINDENT
18794
18921
  .sp
18795
- Here is a mixed example.
18922
+ \fBtype\fP
18923
+ .INDENT 0.0
18924
+ .INDENT 3.5
18925
+ A type specified by \fBtypes\fP\&.
18926
+ .UNINDENT
18927
+ .UNINDENT
18796
18928
  .sp
18797
- Execution example:
18929
+ \fBcandidate\fP
18798
18930
  .INDENT 0.0
18799
18931
  .INDENT 3.5
18932
+ A candidate for completion, correction or suggestion.
18933
+ .UNINDENT
18934
+ .UNINDENT
18800
18935
  .sp
18801
- .nf
18802
- .ft C
18803
- suggest \-\-table item_query \-\-column kana \-\-types complete|correct|suggest \-\-frequency_threshold 1 \-\-query search
18804
- # [
18805
- # [
18806
- # 0,
18807
- # 1337566253.89858,
18808
- # 0.000355720520019531
18809
- # ],
18810
- # {
18811
- # "suggest": [
18812
- # [
18813
- # 2
18814
- # ],
18815
- # [
18816
- # [
18817
- # "_key",
18818
- # "ShortText"
18819
- # ],
18820
- # [
18821
- # "_score",
18822
- # "Int32"
18823
- # ]
18824
- # ],
18825
- # [
18826
- # "search engine",
18827
- # 1
18828
- # ],
18829
- # [
18830
- # "web search realtime",
18831
- # 1
18832
- # ]
18833
- # ],
18834
- # "complete": [
18835
- # [
18836
- # 2
18837
- # ],
18838
- # [
18839
- # [
18840
- # "_key",
18841
- # "ShortText"
18842
- # ],
18843
- # [
18844
- # "_score",
18845
- # "Int32"
18846
- # ]
18847
- # ],
18848
- # [
18849
- # "search",
18850
- # 2
18851
- # ],
18852
- # [
18853
- # "search engine",
18854
- # 2
18855
- # ]
18856
- # ],
18857
- # "correct": [
18858
- # [
18859
- # 1
18860
- # ],
18861
- # [
18862
- # [
18863
- # "_key",
18864
- # "ShortText"
18865
- # ],
18866
- # [
18867
- # "_score",
18868
- # "Int32"
18869
- # ]
18870
- # ],
18871
- # [
18872
- # "search",
18873
- # 2
18874
- # ]
18875
- # ]
18876
- # }
18877
- # ]
18878
- .ft P
18879
- .fi
18936
+ \fBscore of candidate\fP
18937
+ .INDENT 0.0
18938
+ .INDENT 3.5
18939
+ A score of corresponding \fBcandidate\fP\&. It means that
18940
+ higher score candidate is more likely candidate for
18941
+ completion, correction or suggestion. Returned candidates
18942
+ are sorted by \fBscore of candidate\fP descending by
18943
+ default.
18880
18944
  .UNINDENT
18881
18945
  .UNINDENT
18882
- .SS SEE ALSO
18946
+ .SS See also
18883
18947
  .INDENT 0.0
18884
18948
  .IP \(bu 2
18885
18949
  \fB/suggest\fP
@@ -19207,136 +19271,55 @@ See \fB/reference/normalizers\fP for all normalizsers.
19207
19271
  The default value is none.
19208
19272
  .SS Return value
19209
19273
  .sp
19210
- \fBtable_create\fP returns \fBtrue\fP as body on success such as:
19211
- .INDENT 0.0
19212
- .INDENT 3.5
19213
- .sp
19214
- .nf
19215
- .ft C
19216
- [HEADER, true]
19217
- .ft P
19218
- .fi
19219
- .UNINDENT
19220
- .UNINDENT
19221
- .sp
19222
- If \fBtable_create\fP fails, error details are in \fBHEADER\fP\&.
19223
- .sp
19224
- See \fB/reference/command/output_format\fP for \fBHEADER\fP\&.
19225
- .SS See also
19226
- .INDENT 0.0
19227
- .IP \(bu 2
19228
- \fB/reference/tables\fP
19229
- .IP \(bu 2
19230
- \fB/reference/commands/column_create\fP
19231
- .IP \(bu 2
19232
- \fB/reference/tokenizers\fP
19233
- .IP \(bu 2
19234
- \fB/reference/normalizers\fP
19235
- .IP \(bu 2
19236
- \fB/reference/command/output_format\fP
19237
- .UNINDENT
19238
- .SS table_list
19239
- .SS 名前
19240
- .sp
19241
- table_list \- DBに定義されているテーブルをリスト表示
19242
- .SS 書式
19243
- .INDENT 0.0
19244
- .INDENT 3.5
19245
- .sp
19246
- .nf
19247
- .ft C
19248
- table_list
19249
- .ft P
19250
- .fi
19251
- .UNINDENT
19252
- .UNINDENT
19253
- .SS 説明
19254
- .sp
19255
- Groonga組込コマンドの一つであるtable_listについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
19256
- .sp
19257
- table_listは、DBに定義されているテーブルのリストを表示します。
19258
- .SS 引数
19259
- .sp
19260
- ありません。
19261
- .SS 返値
19262
- .SS json形式
19263
- .sp
19264
- テーブル名一覧が以下の形式で返却されます。:
19265
- .INDENT 0.0
19266
- .INDENT 3.5
19267
- .sp
19268
- .nf
19269
- .ft C
19270
- [[[テーブル情報名1,テーブル情報型1],...], テーブル情報1,...]
19271
- .ft P
19272
- .fi
19273
- .UNINDENT
19274
- .UNINDENT
19275
- .sp
19276
- \fBテーブル情報名n\fP
19277
- .INDENT 0.0
19278
- .INDENT 3.5
19279
- \fBテーブル情報n\fP には複数の情報が含まれますが、そこに入る情報がどんな内容かを示す名前を出力します。
19280
- 情報名は以下の通りです。
19281
- .sp
19282
- \fBid\fP
19283
- .INDENT 0.0
19284
- .INDENT 3.5
19285
- テーブルオブジェクトに割り当てられたID
19286
- .UNINDENT
19287
- .UNINDENT
19288
- .sp
19289
- \fBname\fP
19290
- .INDENT 0.0
19291
- .INDENT 3.5
19292
- テーブル名
19293
- .UNINDENT
19294
- .UNINDENT
19295
- .sp
19296
- \fBpath\fP
19297
- .INDENT 0.0
19298
- .INDENT 3.5
19299
- テーブルのレコードを格納するファイル名
19300
- .UNINDENT
19301
- .UNINDENT
19302
- .sp
19303
- \fBflags\fP
19304
- .INDENT 0.0
19305
- .INDENT 3.5
19306
- テーブルのflags属性
19307
- .UNINDENT
19308
- .UNINDENT
19309
- .sp
19310
- \fBdomain\fP
19311
- .INDENT 0.0
19312
- .INDENT 3.5
19313
- 主キー値の属する型
19314
- .UNINDENT
19315
- .UNINDENT
19316
- .sp
19317
- \fBrange\fP
19274
+ \fBtable_create\fP returns \fBtrue\fP as body on success such as:
19318
19275
  .INDENT 0.0
19319
19276
  .INDENT 3.5
19320
- valueが属する型
19321
- .UNINDENT
19322
- .UNINDENT
19277
+ .sp
19278
+ .nf
19279
+ .ft C
19280
+ [HEADER, true]
19281
+ .ft P
19282
+ .fi
19323
19283
  .UNINDENT
19324
19284
  .UNINDENT
19325
19285
  .sp
19326
- \fBテーブル情報型n\fP
19286
+ If \fBtable_create\fP fails, error details are in \fBHEADER\fP\&.
19287
+ .sp
19288
+ See \fB/reference/command/output_format\fP for \fBHEADER\fP\&.
19289
+ .SS See also
19327
19290
  .INDENT 0.0
19328
- .INDENT 3.5
19329
- テーブル情報の型を出力します。
19330
- .UNINDENT
19291
+ .IP \(bu 2
19292
+ \fB/reference/tables\fP
19293
+ .IP \(bu 2
19294
+ \fB/reference/commands/column_create\fP
19295
+ .IP \(bu 2
19296
+ \fB/reference/tokenizers\fP
19297
+ .IP \(bu 2
19298
+ \fB/reference/normalizers\fP
19299
+ .IP \(bu 2
19300
+ \fB/reference/command/output_format\fP
19331
19301
  .UNINDENT
19302
+ .SS \fBtable_list\fP
19303
+ .SS Summary
19332
19304
  .sp
19333
- \fBテーブル情報n\fP
19305
+ table_list \- DBに定義されているテーブルをリスト表示
19306
+ .sp
19307
+ Groonga組込コマンドの一つであるtable_listについて説明します。組込コマンドは、groonga実行ファイルの引数、標準
19308
+ 入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
19309
+ .sp
19310
+ table_listは、DBに定義されているテーブルのリストを表示します。
19311
+ .SS Syntax
19334
19312
  .INDENT 0.0
19335
19313
  .INDENT 3.5
19336
- \fBテーブル情報名n\fP で示された情報の配列を出力します。
19337
- 情報の順序は \fBテーブル情報名n\fP の順序と同じです。
19314
+ .sp
19315
+ .nf
19316
+ .ft C
19317
+ table_list
19318
+ .ft P
19319
+ .fi
19338
19320
  .UNINDENT
19339
19321
  .UNINDENT
19322
+ .SS Usage
19340
19323
  .sp
19341
19324
  Execution example:
19342
19325
  .INDENT 0.0
@@ -19432,52 +19415,107 @@ table_list
19432
19415
  .fi
19433
19416
  .UNINDENT
19434
19417
  .UNINDENT
19435
- .SS table_remove
19436
- .SS 名前
19418
+ .SS Parameters
19437
19419
  .sp
19438
- table_remove \- テーブルの削除
19439
- .SS 書式
19420
+ ありません。
19421
+ .SS Return value
19422
+ .sp
19423
+ テーブル名一覧が以下の形式で返却されます。:
19440
19424
  .INDENT 0.0
19441
19425
  .INDENT 3.5
19442
19426
  .sp
19443
19427
  .nf
19444
19428
  .ft C
19445
- table_remove name
19429
+ [[[テーブル情報名1,テーブル情報型1],...], テーブル情報1,...]
19446
19430
  .ft P
19447
19431
  .fi
19448
19432
  .UNINDENT
19449
19433
  .UNINDENT
19450
- .SS 説明
19451
19434
  .sp
19452
- groonga組込コマンドの一つであるtable_removeについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
19435
+ \fBテーブル情報名n\fP
19436
+ .INDENT 0.0
19437
+ .INDENT 3.5
19438
+ \fBテーブル情報n\fP には複数の情報が含まれますが、そこに入る情報がどんな内容かを示す名前を出力します。
19439
+ 情報名は以下の通りです。
19453
19440
  .sp
19454
- table_removeはテーブルと定義されているカラムを削除します。カラムに付随するインデックスも再帰的に削除されます。
19455
- .SS 引数
19441
+ \fBid\fP
19456
19442
  .INDENT 0.0
19457
- .TP
19458
- .B \fBname\fP
19459
- 削除対象のカラムが定義されているテーブルの名前を指定します。
19443
+ .INDENT 3.5
19444
+ テーブルオブジェクトに割り当てられたID
19460
19445
  .UNINDENT
19461
- .SS 返値
19462
- .SS json形式
19446
+ .UNINDENT
19447
+ .sp
19448
+ \fBname\fP
19463
19449
  .INDENT 0.0
19464
19450
  .INDENT 3.5
19451
+ テーブル名
19452
+ .UNINDENT
19453
+ .UNINDENT
19465
19454
  .sp
19466
- .nf
19467
- .ft C
19468
- [成功かどうかのフラグ]
19469
- .ft P
19470
- .fi
19455
+ \fBpath\fP
19456
+ .INDENT 0.0
19457
+ .INDENT 3.5
19458
+ テーブルのレコードを格納するファイル名
19471
19459
  .UNINDENT
19472
19460
  .UNINDENT
19473
19461
  .sp
19474
- \fB成功かどうかのフラグ\fP
19462
+ \fBflags\fP
19475
19463
  .INDENT 0.0
19476
19464
  .INDENT 3.5
19477
- エラーが生じなかった場合にはtrue、エラーが生じた場合にはfalseを返す。
19465
+ テーブルのflags属性
19478
19466
  .UNINDENT
19479
19467
  .UNINDENT
19480
- .SS 例
19468
+ .sp
19469
+ \fBdomain\fP
19470
+ .INDENT 0.0
19471
+ .INDENT 3.5
19472
+ 主キー値の属する型
19473
+ .UNINDENT
19474
+ .UNINDENT
19475
+ .sp
19476
+ \fBrange\fP
19477
+ .INDENT 0.0
19478
+ .INDENT 3.5
19479
+ valueが属する型
19480
+ .UNINDENT
19481
+ .UNINDENT
19482
+ .UNINDENT
19483
+ .UNINDENT
19484
+ .sp
19485
+ \fBテーブル情報型n\fP
19486
+ .INDENT 0.0
19487
+ .INDENT 3.5
19488
+ テーブル情報の型を出力します。
19489
+ .UNINDENT
19490
+ .UNINDENT
19491
+ .sp
19492
+ \fBテーブル情報n\fP
19493
+ .INDENT 0.0
19494
+ .INDENT 3.5
19495
+ \fBテーブル情報名n\fP で示された情報の配列を出力します。
19496
+ 情報の順序は \fBテーブル情報名n\fP の順序と同じです。
19497
+ .UNINDENT
19498
+ .UNINDENT
19499
+ .SS \fBtable_remove\fP
19500
+ .SS Summary
19501
+ .sp
19502
+ table_remove \- テーブルの削除
19503
+ .sp
19504
+ groonga組込コマンドの一つであるtable_removeについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
19505
+ .sp
19506
+ table_removeはテーブルと定義されているカラムを削除します。カラムに付随するインデックスも再帰的に削除されます。
19507
+ .SS Syntax
19508
+ .INDENT 0.0
19509
+ .INDENT 3.5
19510
+ .sp
19511
+ .nf
19512
+ .ft C
19513
+ table_remove name
19514
+ .ft P
19515
+ .fi
19516
+ .UNINDENT
19517
+ .UNINDENT
19518
+ .SS Usage
19481
19519
  .INDENT 0.0
19482
19520
  .INDENT 3.5
19483
19521
  .sp
@@ -19490,6 +19528,30 @@ table_remove Entry
19490
19528
  .fi
19491
19529
  .UNINDENT
19492
19530
  .UNINDENT
19531
+ .SS Parameters
19532
+ .INDENT 0.0
19533
+ .TP
19534
+ .B \fBname\fP
19535
+ 削除対象のカラムが定義されているテーブルの名前を指定します。
19536
+ .UNINDENT
19537
+ .SS Return value
19538
+ .INDENT 0.0
19539
+ .INDENT 3.5
19540
+ .sp
19541
+ .nf
19542
+ .ft C
19543
+ [成功かどうかのフラグ]
19544
+ .ft P
19545
+ .fi
19546
+ .UNINDENT
19547
+ .UNINDENT
19548
+ .sp
19549
+ \fB成功かどうかのフラグ\fP
19550
+ .INDENT 0.0
19551
+ .INDENT 3.5
19552
+ エラーが生じなかった場合にはtrue、エラーが生じた場合にはfalseを返す。
19553
+ .UNINDENT
19554
+ .UNINDENT
19493
19555
  .SS \fBtokenize\fP
19494
19556
  .SS Summary
19495
19557
  .sp
@@ -19509,6 +19571,7 @@ tokenize tokenizer
19509
19571
  string
19510
19572
  [normalizer=null]
19511
19573
  [flags=NONE]
19574
+ [mode=ADD]
19512
19575
  .ft P
19513
19576
  .fi
19514
19577
  .UNINDENT
@@ -20155,16 +20218,198 @@ tokenize TokenDelimit "Full
20155
20218
  # ],
20156
20219
  # [
20157
20220
  # {
20158
- # "position": 0,
20159
- # "value": "full"
20221
+ # "position": 0,
20222
+ # "value": "full"
20223
+ # },
20224
+ # {
20225
+ # "position": 1,
20226
+ # "value": "text sea"
20227
+ # },
20228
+ # {
20229
+ # "position": 2,
20230
+ # "value": "crch"
20231
+ # }
20232
+ # ]
20233
+ # ]
20234
+ .ft P
20235
+ .fi
20236
+ .UNINDENT
20237
+ .UNINDENT
20238
+ .sp
20239
+ \fBTokenDelimit\fP tokenizer is one of tokenized delimiter supported
20240
+ tokenizer. \fBENABLE_TOKENIZED_DELIMITER\fP enables tokenized delimiter.
20241
+ Tokenized delimiter is special character that indicates token
20242
+ border. It is \fBU+FFFE\fP\&. The character is not assigned any
20243
+ character. It means that the character is not appeared in normal
20244
+ string. So the character is good character for this puropose. If
20245
+ \fBENABLE_TOKENIZED_DELIMITER\fP is enabled, the target string is
20246
+ treated as already tokenized string. Tokenizer just tokenizes by
20247
+ tokenized delimiter.
20248
+ .SS \fBmode\fP
20249
+ .sp
20250
+ It specifies a tokenize mode. If the mode is specified \fBADD\fP, the text
20251
+ is tokenized by the rule that adding a document. If the mode is specified
20252
+ \fBGET\fP, the text is tokenized by the rule that searching a document. If
20253
+ the mode is omitted, the text is tokenized by the \fBADD\fP mode.
20254
+ .sp
20255
+ The default mode is \fBADD\fP\&.
20256
+ .sp
20257
+ Here is an example to the \fBADD\fP mode.
20258
+ .sp
20259
+ Execution example:
20260
+ .INDENT 0.0
20261
+ .INDENT 3.5
20262
+ .sp
20263
+ .nf
20264
+ .ft C
20265
+ tokenize TokenBigram "Fulltext Search" \-\-mode ADD
20266
+ # [
20267
+ # [
20268
+ # 0,
20269
+ # 1408017697.66886,
20270
+ # 0.00126171112060547
20271
+ # ],
20272
+ # [
20273
+ # {
20274
+ # "value": "Fu",
20275
+ # "position": 0
20276
+ # },
20277
+ # {
20278
+ # "value": "ul",
20279
+ # "position": 1
20280
+ # },
20281
+ # {
20282
+ # "value": "ll",
20283
+ # "position": 2
20284
+ # },
20285
+ # {
20286
+ # "value": "lt",
20287
+ # "position": 3
20288
+ # },
20289
+ # {
20290
+ # "value": "te",
20291
+ # "position": 4
20292
+ # },
20293
+ # {
20294
+ # "value": "ex",
20295
+ # "position": 5
20296
+ # },
20297
+ # {
20298
+ # "value": "xt",
20299
+ # "position": 6
20300
+ # },
20301
+ # {
20302
+ # "value": "t ",
20303
+ # "position": 7
20304
+ # },
20305
+ # {
20306
+ # "value": " S",
20307
+ # "position": 8
20308
+ # },
20309
+ # {
20310
+ # "value": "Se",
20311
+ # "position": 9
20312
+ # },
20313
+ # {
20314
+ # "value": "ea",
20315
+ # "position": 10
20316
+ # },
20317
+ # {
20318
+ # "value": "ar",
20319
+ # "position": 11
20320
+ # },
20321
+ # {
20322
+ # "value": "rc",
20323
+ # "position": 12
20324
+ # },
20325
+ # {
20326
+ # "value": "ch",
20327
+ # "position": 13
20328
+ # },
20329
+ # {
20330
+ # "value": "h",
20331
+ # "position": 14
20332
+ # }
20333
+ # ]
20334
+ # ]
20335
+ .ft P
20336
+ .fi
20337
+ .UNINDENT
20338
+ .UNINDENT
20339
+ .sp
20340
+ The last alphabet is tokenized by one character.
20341
+ .sp
20342
+ Here is an example to the \fBGET\fP mode.
20343
+ .sp
20344
+ Execution example:
20345
+ .INDENT 0.0
20346
+ .INDENT 3.5
20347
+ .sp
20348
+ .nf
20349
+ .ft C
20350
+ tokenize TokenBigram "Fulltext Search" \-\-mode GET
20351
+ # [
20352
+ # [
20353
+ # 0,
20354
+ # 1408017732.62883,
20355
+ # 0.000665903091430664
20356
+ # ],
20357
+ # [
20358
+ # {
20359
+ # "value": "Fu",
20360
+ # "position": 0
20160
20361
  # },
20161
20362
  # {
20162
- # "position": 1,
20163
- # "value": "text sea"
20363
+ # "value": "ul",
20364
+ # "position": 1
20164
20365
  # },
20165
20366
  # {
20166
- # "position": 2,
20167
- # "value": "crch"
20367
+ # "value": "ll",
20368
+ # "position": 2
20369
+ # },
20370
+ # {
20371
+ # "value": "lt",
20372
+ # "position": 3
20373
+ # },
20374
+ # {
20375
+ # "value": "te",
20376
+ # "position": 4
20377
+ # },
20378
+ # {
20379
+ # "value": "ex",
20380
+ # "position": 5
20381
+ # },
20382
+ # {
20383
+ # "value": "xt",
20384
+ # "position": 6
20385
+ # },
20386
+ # {
20387
+ # "value": "t ",
20388
+ # "position": 7
20389
+ # },
20390
+ # {
20391
+ # "value": " S",
20392
+ # "position": 8
20393
+ # },
20394
+ # {
20395
+ # "value": "Se",
20396
+ # "position": 9
20397
+ # },
20398
+ # {
20399
+ # "value": "ea",
20400
+ # "position": 10
20401
+ # },
20402
+ # {
20403
+ # "value": "ar",
20404
+ # "position": 11
20405
+ # },
20406
+ # {
20407
+ # "value": "rc",
20408
+ # "position": 12
20409
+ # },
20410
+ # {
20411
+ # "value": "ch",
20412
+ # "position": 13
20168
20413
  # }
20169
20414
  # ]
20170
20415
  # ]
@@ -20173,15 +20418,7 @@ tokenize TokenDelimit "Full
20173
20418
  .UNINDENT
20174
20419
  .UNINDENT
20175
20420
  .sp
20176
- \fBTokenDelimit\fP tokenizer is one of tokenized delimiter supported
20177
- tokenizer. \fBENABLE_TOKENIZED_DELIMITER\fP enables tokenized delimiter.
20178
- Tokenized delimiter is special character that indicates token
20179
- border. It is \fBU+FFFE\fP\&. The character is not assigned any
20180
- character. It means that the character is not appeared in normal
20181
- string. So the character is good character for this puropose. If
20182
- \fBENABLE_TOKENIZED_DELIMITER\fP is enabled, the target string is
20183
- treated as already tokenized string. Tokenizer just tokenizes by
20184
- tokenized delimiter.
20421
+ The last alphabet is tokenized by two characters.
20185
20422
  .SS Return value
20186
20423
  .sp
20187
20424
  \fBtokenize\fP command returns tokenized tokens. Each token has some
@@ -20331,7 +20568,7 @@ that contains the name. The attribute will be increased in the feature:
20331
20568
  .sp
20332
20569
  .nf
20333
20570
  .ft C
20334
- [HEADER, tokenizer]
20571
+ [HEADER, tokenizers]
20335
20572
  .ft P
20336
20573
  .fi
20337
20574
  .UNINDENT
@@ -20344,10 +20581,10 @@ See \fB/reference/command/output_format\fP about \fBHEADER\fP\&.
20344
20581
  .UNINDENT
20345
20582
  .UNINDENT
20346
20583
  .sp
20347
- \fBtokenizer\fP
20584
+ \fBtokenizers\fP
20348
20585
  .INDENT 0.0
20349
20586
  .INDENT 3.5
20350
- \fBtokenizer\fP is an array of tokenizer. Tokenizer is an object that has the following
20587
+ \fBtokenizers\fP is an array of tokenizer. Tokenizer is an object that has the following
20351
20588
  attributes.
20352
20589
  .TS
20353
20590
  center;
@@ -26693,119 +26930,474 @@ Point型の値、あるいは座標を示す文字列を指定した場合は、
26693
26930
  .UNINDENT
26694
26931
  .UNINDENT
26695
26932
  .sp
26696
- \fBapproximate_type\fP
26697
- .INDENT 0.0
26698
- .INDENT 3.5
26699
- 半径からの距離を求めるために地形をどのように近似するかを指定します。指定できる値は以下の通りです。
26933
+ \fBapproximate_type\fP
26934
+ .INDENT 0.0
26935
+ .INDENT 3.5
26936
+ 半径からの距離を求めるために地形をどのように近似するかを指定します。指定できる値は以下の通りです。
26937
+ .sp
26938
+ \fB"rectangle"\fP
26939
+ .INDENT 0.0
26940
+ .INDENT 3.5
26941
+ 方形近似で近似します。単純な計算式で距離を求めることができるため高速ですが、極付近では誤差が大きくなります。
26942
+ .sp
26943
+ \fB"rect"\fP と省略して指定することもできます。
26944
+ .sp
26945
+ この近似方法がデフォルト値です。 \fBapproximate_type\fP を省略した場合は方形近似になります。
26946
+ .UNINDENT
26947
+ .UNINDENT
26948
+ .sp
26949
+ \fB"sphere"\fP
26950
+ .INDENT 0.0
26951
+ .INDENT 3.5
26952
+ 球面近似で近似します。 \fB"rectangle"\fP よりも遅くなりますが、誤差は小さいです。
26953
+ .sp
26954
+ \fB"sphr"\fP と省略して指定することもできます。
26955
+ .UNINDENT
26956
+ .UNINDENT
26957
+ .sp
26958
+ \fB"ellipsoid"\fP
26959
+ .INDENT 0.0
26960
+ .INDENT 3.5
26961
+ 楕円体近似で近似します。距離の計算にはヒュベニの距離計算式を用います。 \fB"sphere"\fP よりも遅くなりますが、誤差は小さくなります。
26962
+ .sp
26963
+ \fB"ellip"\fP と省略して指定することもできます。
26964
+ .UNINDENT
26965
+ .UNINDENT
26966
+ .UNINDENT
26967
+ .UNINDENT
26968
+ .SS 返値
26969
+ .sp
26970
+ pointに指定した座標が円の範囲内にあるかどうかをBool型の値で返します。
26971
+ .SS 例
26972
+ .INDENT 0.0
26973
+ .INDENT 3.5
26974
+ .sp
26975
+ .nf
26976
+ .ft C
26977
+ geo_in_circle(pos, "100x100", 100)
26978
+ true
26979
+ .ft P
26980
+ .fi
26981
+ .UNINDENT
26982
+ .UNINDENT
26983
+ 脚注
26984
+ .IP [1] 5
26985
+ TokyoGeoPoint(日本測地系座標)かWGS84GeoPoint(世界測地系座標)のいずれかを指定できます。
26986
+ .SS geo_in_rectangle
26987
+ .SS 名前
26988
+ .sp
26989
+ geo_in_rectangle \- 座標が矩形の範囲内に存在するかどうかを調べます。
26990
+ .SS 書式
26991
+ .INDENT 0.0
26992
+ .INDENT 3.5
26993
+ .sp
26994
+ .nf
26995
+ .ft C
26996
+ geo_in_rectangle(point, top_left, bottom_right)
26997
+ .ft P
26998
+ .fi
26999
+ .UNINDENT
27000
+ .UNINDENT
27001
+ .SS 説明
27002
+ .sp
27003
+ Groonga組込関数の一つであるgeo_in_rectangleについて説明します。組込関数は、script形式のgrn_expr中で呼び出すことができます。
27004
+ .sp
27005
+ geo_in_rectangle() 関数は、pointに指定した座標が、top_leftとbottom_rightがなす矩形の範囲内にあるかどうかを調べます。
27006
+ .SS 引数
27007
+ .sp
27008
+ \fBpoint\fP
27009
+ .INDENT 0.0
27010
+ .INDENT 3.5
27011
+ 矩形の範囲内に存在するかどうかを調べる座標を指定します。Point型の値を指定できます。 [1]
27012
+ .UNINDENT
27013
+ .UNINDENT
27014
+ .sp
27015
+ \fBtop_left\fP
27016
+ .INDENT 0.0
27017
+ .INDENT 3.5
27018
+ 矩形の左上隅となる座標を指定します。Point型の値、あるいは座標を示す文字列を指定できます。
27019
+ .UNINDENT
27020
+ .UNINDENT
27021
+ .sp
27022
+ \fBbottom_right\fP
27023
+ .INDENT 0.0
27024
+ .INDENT 3.5
27025
+ 矩形の右下隅となる座標を指定します。Point型の値、あるいは座標を示す文字列を指定できます。
27026
+ .UNINDENT
27027
+ .UNINDENT
27028
+ .SS 返値
27029
+ .sp
27030
+ pointに指定した座標が矩形の範囲内にあるかどうかをBool型の値で返します。
27031
+ .SS 例
27032
+ .INDENT 0.0
27033
+ .INDENT 3.5
27034
+ .sp
27035
+ .nf
27036
+ .ft C
27037
+ geo_in_rectangle(pos, "150x100", "100x150")
27038
+ true
27039
+ .ft P
27040
+ .fi
27041
+ .UNINDENT
27042
+ .UNINDENT
27043
+ 脚注
27044
+ .IP [1] 5
27045
+ TokyoGeoPoint(日本測地系座標)かWGS84GeoPoint(世界測地系座標)のいずれかを指定できます。
27046
+ .SS highlight_full
27047
+ .sp
27048
+ \fBCAUTION:\fP
27049
+ .INDENT 0.0
27050
+ .INDENT 3.5
27051
+ This feature is experimental. API will be changed.
27052
+ .UNINDENT
27053
+ .UNINDENT
27054
+ .SS Summary
27055
+ .sp
27056
+ \fBhighlight_full\fP tags target text. It can use to highlight the search
27057
+ keyword. It can specify use/not use HTML escape, the normalizer name and
27058
+ change the tag for each keyword.
27059
+ .SS Syntax
27060
+ .sp
27061
+ \fBhighlight_full\fP has required parameter and optional parameter:
27062
+ .INDENT 0.0
27063
+ .INDENT 3.5
27064
+ .sp
27065
+ .nf
27066
+ .ft C
27067
+ highlight_full(column, normalizer_name, use_html_escape,
27068
+ keyword1, open_tag1, close_tag1,
27069
+ ...
27070
+ [keywordN, open_tagN, close_tagN])
27071
+ .ft P
27072
+ .fi
27073
+ .UNINDENT
27074
+ .UNINDENT
27075
+ .SS Usage
27076
+ .sp
27077
+ Here are a schema definition and sample data to show usage.
27078
+ .sp
27079
+ Execution example:
27080
+ .INDENT 0.0
27081
+ .INDENT 3.5
27082
+ .sp
27083
+ .nf
27084
+ .ft C
27085
+ table_create Entries TABLE_NO_KEY
27086
+ # [[0,1407692435.35498,0.0364797115325928],true]
27087
+ column_create Entries body COLUMN_SCALAR ShortText
27088
+ # [[0,1407692435.39156,0.0256640911102295],true]
27089
+ table_create Terms TABLE_PAT_KEY ShortText \-\-default_tokenizer TokenBigram \-\-normalizer NormalizerAuto
27090
+ # [[0,1407692435.423,0.0274741649627686],true]
27091
+ column_create Terms document_index COLUMN_INDEX|WITH_POSITION Entries body
27092
+ # [[0,1407692435.45051,0.0534985065460205],true]
27093
+ load \-\-table Entries
27094
+ [
27095
+ {"body": "Mroonga is a ＭｙＳＱＬ storage engine based on Groonga. <b>Rroonga</b> is a Ruby binding of Groonga."}
27096
+ ]
27097
+ # [[0,1407692435.50406,0.378907442092896],1]
27098
+ .ft P
27099
+ .fi
27100
+ .UNINDENT
27101
+ .UNINDENT
27102
+ .sp
27103
+ \fBhighlight_full\fP can be used in only \fB\-\-output_columns\fP in
27104
+ \fB/reference/commands/select\fP\&.
27105
+ .sp
27106
+ \fBhighlight_full\fP requires Groonga 4.0.5 or later.
27107
+ .sp
27108
+ \fBhighlight_full\fP requires \fB/reference/command/command_version\fP 2
27109
+ or later.
27110
+ .sp
27111
+ The following example uses HTML escape and normalzier is \fBNormalizeAuto\fP\&.
27112
+ It specifies the tags \fB<span class="keyword1">\fP and \fB</span>\fP of the
27113
+ keyword \fBgroonga\fP, and the tags \fB<span class="keyword2">\fP and \fB</span>\fP
27114
+ of the keyword \fBmysql\fP\&.
27115
+ .sp
27116
+ Execution example:
27117
+ .INDENT 0.0
27118
+ .INDENT 3.5
27119
+ .sp
27120
+ .nf
27121
+ .ft C
27122
+ select Entries \-\-output_columns \(aqhighlight_full(body, "NormalizerAuto", true, "Groonga", "<span class=\e\e"keyword1\e\e">", "</span>", "mysql", "<span class=\e\e"keyword2\e\e">", "</span>")\(aq \-\-command_version 2
27123
+ # [
27124
+ # [
27125
+ # 0,
27126
+ # 1407695996.52987,
27127
+ # 0.00151872634887695
27128
+ # ],
27129
+ # [
27130
+ # [
27131
+ # [
27132
+ # 1
27133
+ # ],
27134
+ # [
27135
+ # [
27136
+ # "highlight_full",
27137
+ # "null"
27138
+ # ]
27139
+ # ],
27140
+ # [
27141
+ # "Mroonga is a <span class=\e"keyword2\e">ＭｙＳＱＬ</span> storage engine based on <span class=\e"keyword1\e">Groonga</span>. &lt;b&gt;Rroonga&lt;/b&gt; is a Ruby binding of <span class=\e"keyword1\e">Groonga</span>."
27142
+ # ]
27143
+ # ]
27144
+ # ]
27145
+ # ]
27146
+ .ft P
27147
+ .fi
27148
+ .UNINDENT
27149
+ .UNINDENT
27150
+ .sp
27151
+ The text are scanned by the keywords for tagging after they are normalized
27152
+ by \fBNormalizerAuto\fP normalizer.
27153
+ .sp
27154
+ \fB\-\-query "groonga mysql"\fP matches to the first record\(aqs body.
27155
+ \fBhighight_full\fP surrounds the keywords \fBgroonga\fP contained in the text
27156
+ with \fB<span class="keyword1">\fP and \fB</span>\fP, and the keywords \fBmysql\fP
27157
+ contained in the text with with \fB<span class="keyword2">\fP and \fB</span>\fP\&.
27158
+ .sp
27159
+ Special characters such as \fB<\fP and \fB>\fP are escapsed as \fB&lt;\fP and
27160
+ \fB&gt;\fP\&.
27161
+ .sp
27162
+ You can specify string literal instead of column.
27163
+ .sp
27164
+ Execution example:
27165
+ .INDENT 0.0
27166
+ .INDENT 3.5
27167
+ .sp
27168
+ .nf
27169
+ .ft C
27170
+ select Entries \-\-output_columns \(aqhighlight_full("Groonga is very fast fulltext search engine.", "NormalizerAuto", true, "Groonga", "<span class=\e\e"keyword1\e\e">", "</span>", "mysql", "<span class=\e\e"keyword2\e\e">", "</span>")\(aq \-\-command_version 2 \-\-match_columns body \-\-query "groonga"
27171
+ # [
27172
+ # [
27173
+ # 0,
27174
+ # 1407696157.1849,
27175
+ # 0.00164437294006348
27176
+ # ],
27177
+ # [
27178
+ # [
27179
+ # [
27180
+ # 1
27181
+ # ],
27182
+ # [
27183
+ # [
27184
+ # "highlight_full",
27185
+ # "null"
27186
+ # ]
27187
+ # ],
27188
+ # [
27189
+ # "<span class=\e"keyword1\e">Groonga</span> is very fast fulltext search engine."
27190
+ # ]
27191
+ # ]
27192
+ # ]
27193
+ # ]
27194
+ .ft P
27195
+ .fi
27196
+ .UNINDENT
27197
+ .UNINDENT
27198
+ .SS Parameters
27199
+ .sp
27200
+ There are three required parameters, \fBcolumn\fP, \fBnormalizer_name\fP and \fBuse_html_escape\fP\&.
27201
+ There are three or over optional parameters, \fBkeywordN\fP, \fBopen_tagN\fP and \fBend_tagN\fP\&.
27202
+ .SS \fBcolumn\fP
26700
27203
  .sp
26701
- \fB"rectangle"\fP
26702
- .INDENT 0.0
26703
- .INDENT 3.5
26704
- 方形近似で近似します。単純な計算式で距離を求めることができるため高速ですが、極付近では誤差が大きくなります。
27204
+ It specifies a column of the table.
27205
+ .SS \fBnormalizer_name\fP
26705
27206
  .sp
26706
- \fB"rect"\fP と省略して指定することもできます。
27207
+ It specifies a normalizer name.
27208
+ .SS \fBuse_html_escape\fP
26707
27209
  .sp
26708
- この近似方法がデフォルト値です。 \fBapproximate_type\fP を省略した場合は方形近似になります。
26709
- .UNINDENT
26710
- .UNINDENT
27210
+ It specifies use or not use HTML escape. If it is \fBtrue\fP , use HTML escape.
27211
+ If it is \fBfalse\fP , not use HTML escape.
27212
+ .SS \fBkeywordN\fP
26711
27213
  .sp
26712
- \fB"sphere"\fP
26713
- .INDENT 0.0
26714
- .INDENT 3.5
26715
- 球面近似で近似します。 \fB"rectangle"\fP よりも遅くなりますが、誤差は小さいです。
27214
+ It specifies a keyword for tagging.
27215
+ You can specify multiple keywords for each three arguments.
27216
+ .SS \fBopen_tagN\fP
26716
27217
  .sp
26717
- \fB"sphr"\fP と省略して指定することもできます。
26718
- .UNINDENT
27218
+ It specifies a open tag.
27219
+ You can specify multiple open tags for each three arguments.
27220
+ .SS \fBclose_tagN\fP
27221
+ .sp
27222
+ It specifies a close tag.
27223
+ You can specify multiple close tags for each three arguments.
27224
+ .SS Return value
27225
+ .sp
27226
+ \fBhighlight_full\fP returns a tagged string or \fBnull\fP\&. If
27227
+ \fBhighlight_full\fP can\(aqt find any keywords, it returns \fBnull\fP\&.
27228
+ .SS See also
27229
+ .INDENT 0.0
27230
+ .IP \(bu 2
27231
+ \fB/reference/commands/select\fP
27232
+ .IP \(bu 2
27233
+ \fB/reference/functions/highlight_html\fP
26719
27234
  .UNINDENT
27235
+ .SS highlight_html
26720
27236
  .sp
26721
- \fB"ellipsoid"\fP
27237
+ \fBCAUTION:\fP
26722
27238
  .INDENT 0.0
26723
27239
  .INDENT 3.5
26724
- 楕円体近似で近似します。距離の計算にはヒュベニの距離計算式を用います。 \fB"sphere"\fP よりも遅くなりますが、誤差は小さくなります。
26725
- .sp
26726
- \fB"ellip"\fP と省略して指定することもできます。
26727
- .UNINDENT
26728
- .UNINDENT
27240
+ This feature is experimental. API will be changed.
26729
27241
  .UNINDENT
26730
27242
  .UNINDENT
26731
- .SS 返値
27243
+ .SS Summary
26732
27244
  .sp
26733
- pointに指定した座標が円の範囲内にあるかどうかをBool型の値で返します。
26734
- .SS 例
27245
+ \fBhighlight_html\fP tags target text. It can use to highlight the search
27246
+ keywords. The tagged text are prepared for embedding HTML. Special
27247
+ characters such as \fB<\fP and \fB>\fP are escapsed as \fB&lt;\fP and \fB&gt;\fP\&.
27248
+ Keyword is surrounded with \fB<span class="keyword">\fP and \fB</span>\fP\&.
27249
+ For example, a tagged text of \fBI am a groonga user. <3\fP for keyword
27250
+ \fBgroonga\fP is \fBI am a <span class="keyword">groonga</span> user. &lt;3\fP\&.
27251
+ .SS Syntax
27252
+ .sp
27253
+ \fBhighlight_html\fP has only one parameter:
26735
27254
  .INDENT 0.0
26736
27255
  .INDENT 3.5
26737
27256
  .sp
26738
27257
  .nf
26739
27258
  .ft C
26740
- geo_in_circle(pos, "100x100", 100)
26741
- true
27259
+ highlight_html(column)
26742
27260
  .ft P
26743
27261
  .fi
26744
27262
  .UNINDENT
26745
27263
  .UNINDENT
26746
- 脚注
26747
- .IP [1] 5
26748
- TokyoGeoPoint(日本測地系座標)かWGS84GeoPoint(世界測地系座標)のいずれかを指定できます。
26749
- .SS geo_in_rectangle
26750
- .SS 名前
27264
+ .SS Usage
26751
27265
  .sp
26752
- geo_in_rectangle \- 座標が矩形の範囲内に存在するかどうかを調べます。
26753
- .SS 書式
27266
+ Here are a schema definition and sample data to show usage.
27267
+ .sp
27268
+ Execution example:
26754
27269
  .INDENT 0.0
26755
27270
  .INDENT 3.5
26756
27271
  .sp
26757
27272
  .nf
26758
27273
  .ft C
26759
- geo_in_rectangle(point, top_left, bottom_right)
27274
+ table_create Entries TABLE_NO_KEY
27275
+ # [[0,1407692435.35498,0.0364797115325928],true]
27276
+ column_create Entries body COLUMN_SCALAR ShortText
27277
+ # [[0,1407692435.39156,0.0256640911102295],true]
27278
+ table_create Terms TABLE_PAT_KEY ShortText \-\-default_tokenizer TokenBigram \-\-normalizer NormalizerAuto
27279
+ # [[0,1407692435.423,0.0274741649627686],true]
27280
+ column_create Terms document_index COLUMN_INDEX|WITH_POSITION Entries body
27281
+ # [[0,1407692435.45051,0.0534985065460205],true]
27282
+ load \-\-table Entries
27283
+ [
27284
+ {"body": "Mroonga is a ＭｙＳＱＬ storage engine based on Groonga. <b>Rroonga</b> is a Ruby binding of Groonga."}
27285
+ ]
27286
+ # [[0,1407692435.50406,0.378907442092896],1]
26760
27287
  .ft P
26761
27288
  .fi
26762
27289
  .UNINDENT
26763
27290
  .UNINDENT
26764
- .SS 説明
26765
27291
  .sp
26766
- Groonga組込関数の一つであるgeo_in_rectangleについて説明します。組込関数は、script形式のgrn_expr中で呼び出すことができます。
27292
+ \fBhighlight_html\fP can be used in only \fB\-\-output_columns\fP in
27293
+ \fB/reference/commands/select\fP\&.
26767
27294
  .sp
26768
- geo_in_rectangle() 関数は、pointに指定した座標が、top_leftとbottom_rightがなす矩形の範囲内にあるかどうかを調べます。
26769
- .SS 引数
27295
+ \fBhighlight_html\fP requires Groonga 4.0.5 or later.
26770
27296
  .sp
26771
- \fBpoint\fP
26772
- .INDENT 0.0
26773
- .INDENT 3.5
26774
- 矩形の範囲内に存在するかどうかを調べる座標を指定します。Point型の値を指定できます。 [1]
26775
- .UNINDENT
26776
- .UNINDENT
27297
+ \fBhighlight_html\fP requires \fB/reference/command/command_version\fP 2
27298
+ or later.
26777
27299
  .sp
26778
- \fBtop_left\fP
26779
- .INDENT 0.0
26780
- .INDENT 3.5
26781
- 矩形の左上隅となる座標を指定します。Point型の値、あるいは座標を示す文字列を指定できます。
26782
- .UNINDENT
26783
- .UNINDENT
27300
+ You also need to specify \fB\-\-query\fP and/or \fB\-\-filter\fP\&. Keywords are
27301
+ extracted from \fB\-\-query\fP and \fB\-\-filter\fP arguments.
26784
27302
  .sp
26785
- \fBbottom_right\fP
27303
+ The following example uses \fB\-\-query "groonga mysql"\fP\&. In this case,
27304
+ \fBgroonga\fP and \fBmysql\fP are used as keywords.
27305
+ .sp
27306
+ Execution example:
26786
27307
  .INDENT 0.0
26787
27308
  .INDENT 3.5
26788
- 矩形の右下隅となる座標を指定します。Point型の値、あるいは座標を示す文字列を指定できます。
27309
+ .sp
27310
+ .nf
27311
+ .ft C
27312
+ select Entries \-\-output_columns \-\-match_columns body \-\-query \(aqgroonga mysql\(aq \-\-output_columns \(aqhighlight_html(body)\(aq \-\-command_version 2
27313
+ # [
27314
+ # [
27315
+ # 0,
27316
+ # 1407692444.86092,
27317
+ # 0.00188779830932617
27318
+ # ],
27319
+ # [
27320
+ # [
27321
+ # [
27322
+ # 1
27323
+ # ],
27324
+ # [
27325
+ # [
27326
+ # "highlight_html",
27327
+ # "null"
27328
+ # ]
27329
+ # ],
27330
+ # [
27331
+ # "Mroonga is a <span class=\e"keyword\e">ＭｙＳＱＬ</span> storage engine based on <span class=\e"keyword\e">Groonga</span>. &lt;b&gt;Rroonga&lt;/b&gt; is a Ruby binding of <span class=\e"keyword\e">Groonga</span>."
27332
+ # ]
27333
+ # ]
27334
+ # ]
27335
+ # ]
27336
+ .ft P
27337
+ .fi
26789
27338
  .UNINDENT
26790
27339
  .UNINDENT
26791
- .SS 返値
26792
27340
  .sp
26793
- pointに指定した座標が矩形の範囲内にあるかどうかをBool型の値で返します。
26794
- .SS 例
27341
+ The text are scanned by the keywords for tagging after they are normalized
27342
+ by \fBNormalizerAuto\fP normalizer.
27343
+ .sp
27344
+ \fB\-\-query "groonga mysql"\fP matches to only the first record\(aqs body.
27345
+ \fBhighlight_html(body)\fP surrounds the keywords \fBgroonga\fP or \fBmysql\fP
27346
+ contained in the text with \fB<span class="keyword">\fP and \fB</span>\fP\&.
27347
+ .sp
27348
+ You can specify string literal instead of column.
27349
+ .sp
27350
+ Execution example:
26795
27351
  .INDENT 0.0
26796
27352
  .INDENT 3.5
26797
27353
  .sp
26798
27354
  .nf
26799
27355
  .ft C
26800
- geo_in_rectangle(pos, "150x100", "100x150")
26801
- true
27356
+ select Entries \-\-output_columns \(aqhighlight_html("Groonga is very fast fulltext search engine.")\(aq \-\-command_version 2 \-\-match_columns body \-\-query "groonga"
27357
+ # [
27358
+ # [
27359
+ # 0,
27360
+ # 1407693081.99183,
27361
+ # 0.000126123428344727
27362
+ # ],
27363
+ # [
27364
+ # [
27365
+ # [
27366
+ # 1
27367
+ # ],
27368
+ # [
27369
+ # [
27370
+ # "highlight_html",
27371
+ # "null"
27372
+ # ]
27373
+ # ],
27374
+ # [
27375
+ # "<span class=\e"keyword\e">Groonga</span> is very fast fulltext search engine."
27376
+ # ]
27377
+ # ]
27378
+ # ]
27379
+ # ]
26802
27380
  .ft P
26803
27381
  .fi
26804
27382
  .UNINDENT
26805
27383
  .UNINDENT
26806
- 脚注
26807
- .IP [1] 5
26808
- TokyoGeoPoint(日本測地系座標)かWGS84GeoPoint(世界測地系座標)のいずれかを指定できます。
27384
+ .SS Parameters
27385
+ .sp
27386
+ There is only one parameter \fBcolumn\fP .
27387
+ .SS \fBcolumn\fP
27388
+ .sp
27389
+ It specifies a column of the table.
27390
+ .SS Return value
27391
+ .sp
27392
+ \fBhighlight_html\fP returns a tagged string or \fBnull\fP\&. If
27393
+ \fBhighlight_html\fP can\(aqt find any keywords, it returns \fBnull\fP\&.
27394
+ .SS See also
27395
+ .INDENT 0.0
27396
+ .IP \(bu 2
27397
+ \fB/reference/commands/select\fP
27398
+ .IP \(bu 2
27399
+ \fB/reference/functions/highlight_full\fP
27400
+ .UNINDENT
26809
27401
  .SS html_untag
26810
27402
  .SS Summary
26811
27403
  .sp
@@ -27443,7 +28035,7 @@ select Documents \-\-output_columns "snippet_html(content)" \-\-command_version
27443
28035
  .sp
27444
28036
  \fB\-\-query "fast performance"\fP matches to only the first record\(aqs
27445
28037
  content. \fBsnippet_html(content)\fP extracts two text parts that
27446
- include the keywords \fBfast\fP or \fBperformance\fP and surronds the
28038
+ include the keywords \fBfast\fP or \fBperformance\fP and surrounds the
27447
28039
  keywords with \fB<span class="keyword">\fP and \fB</span>\fP\&.
27448
28040
  .sp
27449
28041
  The max number of text parts is 3. If there are 4 or more text parts
@@ -31180,13 +31772,193 @@ tutorial about it.
31180
31772
  .SS Reference
31181
31773
  .INDENT 0.0
31182
31774
  .TP
31775
+ .B grn_rc GRN_PLUGIN_INIT(grn_ctx\fI\ *ctx\fP)
31776
+ .UNINDENT
31777
+ .INDENT 0.0
31778
+ .TP
31779
+ .B grn_rc GRN_PLUGIN_REGISTER(grn_ctx\fI\ *ctx\fP)
31780
+ .UNINDENT
31781
+ .INDENT 0.0
31782
+ .TP
31783
+ .B grn_rc GRN_PLUGIN_FIN(grn_ctx\fI\ *ctx\fP)
31784
+ .UNINDENT
31785
+ .INDENT 0.0
31786
+ .TP
31787
+ .B GRN_PLUGIN_MALLOC(ctx, size)
31788
+ GRN_PLUGIN_MALLOC() allocates \fIsize\fP bytes and returns a pointer to the
31789
+ allocated memory space. Note that the memory space is associated with \fIctx\fP\&.
31790
+ .UNINDENT
31791
+ .INDENT 0.0
31792
+ .TP
31793
+ .B GRN_PLUGIN_REALLOC(ctx, ptr, size)
31794
+ GRN_PLUGIN_REALLOC() resizes the memory space pointed to by \fIptr\fP or
31795
+ allocates a new memory space of \fIsize\fP bytes. GRN_PLUGIN_REALLOC() returns
31796
+ a pointer to the memory space. The contents is unchanged or copied from the
31797
+ old memory space to the new memory space.
31798
+ .UNINDENT
31799
+ .INDENT 0.0
31800
+ .TP
31801
+ .B GRN_PLUGIN_FREE(ctx, ptr)
31802
+ GRN_PLUGIN_FREE() frees a memory space allocated by GRN_PLUGIN_MALLOC() or
31803
+ GRN_PLUGIN_REALLOC(). This means that \fIptr\fP must be a pointer returned by
31804
+ GRN_PLUGIN_MALLOC() or GRN_PLUGIN_REALLOC().
31805
+ .UNINDENT
31806
+ .INDENT 0.0
31807
+ .TP
31808
+ .B GRN_PLUGIN_LOG(ctx, level, \&...)
31809
+ GRN_PLUGIN_LOG() reports a log of \fIlevel\fP\&. Its error message is generated
31810
+ from the varying number of arguments, in which the first one is the format
31811
+ string and the rest are its arguments. See grn_log_level in "groonga.h" for
31812
+ more details of \fIlevel\fP\&.
31813
+ .UNINDENT
31814
+ .INDENT 0.0
31815
+ .TP
31816
+ .B GRN_PLUGIN_ERROR(ctx, error_code, \&...)
31817
+ GRN_PLUGIN_ERROR() reports an error of \fIerror_code\fP\&. Its error message is
31818
+ generated from the varying number of arguments, in which the first one is the
31819
+ format string and the rest are its arguments. See grn_rc in "groonga.h" for
31820
+ more details of \fIerror_code\fP\&.
31821
+ .UNINDENT
31822
+ .INDENT 0.0
31823
+ .TP
31824
+ .B grn_plugin_mutex
31825
+ grn_plugin_mutex is available to make a critical section. See the
31826
+ following functions.
31827
+ .UNINDENT
31828
+ .INDENT 0.0
31829
+ .TP
31830
+ .B grn_plugin_mutex *grn_plugin_mutex_open(grn_ctx\fI\ *ctx\fP)
31831
+ grn_plugin_mutex_open() returns a pointer to a new object of
31832
+ grn_plugin_mutex. Memory for the new object is obtained with
31833
+ GRN_PLUGIN_MALLOC(). grn_plugin_mutex_open() returns NULL if sufficient
31834
+ memory is not available.
31835
+ .UNINDENT
31836
+ .INDENT 0.0
31837
+ .TP
31838
+ .B void grn_plugin_mutex_close(grn_ctx\fI\ *ctx\fP, grn_plugin_mutex\fI\ *mutex\fP)
31839
+ grn_plugin_mutex_close() finalizes an object of grn_plugin_mutex and then
31840
+ frees memory allocated for that object.
31841
+ .UNINDENT
31842
+ .INDENT 0.0
31843
+ .TP
31844
+ .B void grn_plugin_mutex_lock(grn_ctx\fI\ *ctx\fP, grn_plugin_mutex\fI\ *mutex\fP)
31845
+ grn_plugin_mutex_lock() locks a mutex object. If the object is already
31846
+ locked, the calling thread waits until the object will be unlocked.
31847
+ .UNINDENT
31848
+ .INDENT 0.0
31849
+ .TP
31850
+ .B void grn_plugin_mutex_unlock(grn_ctx\fI\ *ctx\fP, grn_plugin_mutex\fI\ *mutex\fP)
31851
+ grn_plugin_mutex_unlock() unlocks a mutex object. grn_plugin_mutex_unlock()
31852
+ should not be called for an unlocked object.
31853
+ .UNINDENT
31854
+ .INDENT 0.0
31855
+ .TP
31856
+ .B grn_obj *grn_plugin_proc_alloc(grn_ctx\fI\ *ctx\fP, grn_user_data\fI\ *user_data\fP, grn_id\fI\ domain\fP, grn_obj_flags\fI\ flags\fP)
31857
+ grn_plugin_proc_alloc() allocates a \fIgrn_obj\fP object.
31858
+ You can use it in function that is registered as GRN_PROC_FUNCTION.
31859
+ .UNINDENT
31860
+ .INDENT 0.0
31861
+ .TP
31183
31862
  .B grn_obj grn_plugin_proc_get_var(grn_ctx\fI\ *ctx\fP, grn_user_data\fI\ *user_data\fP, const char\fI\ *name\fP, int\fI\ name_size\fP)
31184
- TODO...
31863
+ It gets a variable value from \fIgrn_user_data\fP by specifying the variable name.
31864
+ .INDENT 7.0
31865
+ .TP
31866
+ .B Parameters
31867
+ .INDENT 7.0
31868
+ .IP \(bu 2
31869
+ \fBname\fP \-\- The variable name.
31870
+ .IP \(bu 2
31871
+ \fBname_size\fP \-\- The number of bytes of name. If \fIname_size\fP is negative, \fIname\fP must be NUL\-terminated. \fIname_size\fP is computed by \fIstrlen(name)\fP for the case.
31872
+ .UNINDENT
31873
+ .TP
31874
+ .B Returns
31875
+ A variable value on success, NULL otherwise.
31876
+ .UNINDENT
31185
31877
  .UNINDENT
31186
31878
  .INDENT 0.0
31187
31879
  .TP
31188
- .B grn_obj *grn_plugin_proc_get_var_by_offset(grn_ctx *ctx, grn_user_data *user_data, unsigned int offset);
31189
- TODO...
31880
+ .B grn_obj *grn_plugin_proc_get_var_by_offset(grn_ctx\fI\ *ctx\fP, grn_user_data\fI\ *user_data\fP, unsigned int\fI\ offset\fP)
31881
+ It gets a variable value from \fIgrn_user_data\fP by specifying the offset position of the variable.
31882
+ .INDENT 7.0
31883
+ .TP
31884
+ .B Parameters
31885
+ .INDENT 7.0
31886
+ .IP \(bu 2
31887
+ \fBoffset\fP \-\- The offset position of the variable.
31888
+ .UNINDENT
31889
+ .TP
31890
+ .B Returns
31891
+ A variable value on success, NULL otherwise.
31892
+ .UNINDENT
31893
+ .UNINDENT
31894
+ .INDENT 0.0
31895
+ .TP
31896
+ .B const char *grn_plugin_win32_base_dir(void)
31897
+ grn_plugin_win32_base_dir() returns the groonga install directory.
31898
+ The install directory is computed from the directory that has
31899
+ \fIgroonga.dll\fP\&. You can use the directory to generate install
31900
+ directory aware path.
31901
+ It only works on Windows. It returns \fINULL\fP on other platforms.
31902
+ .UNINDENT
31903
+ .INDENT 0.0
31904
+ .TP
31905
+ .B int grn_plugin_charlen(grn_ctx\fI\ *ctx\fP, const char\fI\ *str_ptr\fP, unsigned int\fI\ str_length\fP, grn_encoding\fI\ encoding\fP)
31906
+ grn_plugin_charlen() returns the length (#bytes) of the first character
31907
+ in the string specified by \fIstr_ptr\fP and \fIstr_length\fP\&. If the starting bytes
31908
+ are invalid as a character, grn_plugin_charlen() returns 0. See
31909
+ grn_encoding in "groonga.h" for more details of \fIencoding\fP\&.
31910
+ .UNINDENT
31911
+ .INDENT 0.0
31912
+ .TP
31913
+ .B int grn_plugin_isspace(grn_ctx\fI\ *ctx\fP, const char\fI\ *str_ptr\fP, unsigned int\fI\ str_length\fP, grn_encoding\fI\ encoding\fP)
31914
+ grn_plugin_isspace() returns the length (#bytes) of the first character
31915
+ in the string specified by \fIstr_ptr\fP and \fIstr_length\fP if it is a space
31916
+ character. Otherwise, grn_plugin_isspace() returns 0.
31917
+ .UNINDENT
31918
+ .INDENT 0.0
31919
+ .TP
31920
+ .B grn_rc grn_plugin_expr_var_init(grn_ctx\fI\ *ctx\fP, grn_expr_var\fI\ *var\fP, const char\fI\ *name\fP, int\fI\ name_size\fP)
31921
+ It initializes a \fIgrn_expr_var\fP\&.
31922
+ .INDENT 7.0
31923
+ .TP
31924
+ .B Parameters
31925
+ .INDENT 7.0
31926
+ .IP \(bu 2
31927
+ \fBvar\fP \-\- The pointer of \fIgrn_expr_var\fP object to be initialized.
31928
+ .IP \(bu 2
31929
+ \fBname\fP \-\- The name of \fIgrn_expr_var\fP object to be initialized.
31930
+ .IP \(bu 2
31931
+ \fBname_size\fP \-\- The number of bytes of name. If \fIname_size\fP is negative, \fIname\fP must be NUL\-terminated. \fIname_size\fP is computed by \fIstrlen(name)\fP for the case.
31932
+ .UNINDENT
31933
+ .TP
31934
+ .B Returns
31935
+ \fBGRN_SUCCESS\fP\&. It doesn\(aqt fail.
31936
+ .UNINDENT
31937
+ .UNINDENT
31938
+ .INDENT 0.0
31939
+ .TP
31940
+ .B grn_obj * grn_plugin_command_create(grn_ctx\fI\ *ctx\fP, const char\fI\ *name\fP, int\fI\ name_size\fP, grn_proc_func\fI\ func\fP, unsigned int\fI\ n_vars\fP, grn_expr_var\fI\ *vars\fP)
31941
+ It creates a command.
31942
+ .INDENT 7.0
31943
+ .TP
31944
+ .B Parameters
31945
+ .INDENT 7.0
31946
+ .IP \(bu 2
31947
+ \fBname\fP \-\- The \fIproc\fP name of the command to be created.
31948
+ .IP \(bu 2
31949
+ \fBname_size\fP \-\- The number of bytes of name. If \fIname_size\fP is negative, \fIname\fP must be NUL\-terminated. \fIname_size\fP is computed by \fIstrlen(name)\fP for the case.
31950
+ .IP \(bu 2
31951
+ \fBfunc\fP \-\- The function name to be called by the created command.
31952
+ .IP \(bu 2
31953
+ \fBn_vars\fP \-\- The number of the variables of the command to create.
31954
+ .IP \(bu 2
31955
+ \fBvars\fP \-\- The pointer of initialized \fIgrn_expr_var\fP object.
31956
+ .UNINDENT
31957
+ .TP
31958
+ .B Returns
31959
+ The created command object if it creates a command successfully,
31960
+ \fINULL\fP otherwise. See \fIctx\fP for error details.
31961
+ .UNINDENT
31190
31962
  .UNINDENT
31191
31963
  .SH SPECIFICATION
31192
31964
  .SS GQTP
@@ -32047,11 +32819,7 @@ database size (16GB) = vm.max_map_count (65536) * memory chunks (256KB)
32047
32819
  .sp
32048
32820
  You can modify vm.max_map_count temporary by sudo sysctl \-w vm.max_map_count=65536.
32049
32821
  .sp
32050
- Then save the configuration value to /etc/sysctl.conf or /etc/sysctl.d/
32051
- .nf
32052
- *
32053
- .fi
32054
- \&.conf.
32822
+ Then save the configuration value to \fB/etc/sysctl.conf\fP or \fB/etc/sysctl.d/*.conf\fP\&.
32055
32823
  .sp
32056
32824
  See \fB/reference/tuning\fP documentation about tuning related parameters.
32057
32825
  .SH DEVELOPMENT