rroonga 3.1.1-x86-mingw32 → 3.1.2-x86-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (489) hide show
  1. checksums.yaml +4 -4
  2. data/Rakefile +1 -39
  3. data/bin/grndump +8 -1
  4. data/doc/text/news.textile +21 -1
  5. data/ext/groonga/extconf.rb +1 -6
  6. data/ext/groonga/rb-grn-table.c +20 -0
  7. data/ext/groonga/rb-grn.h +1 -1
  8. data/ext/groonga/rb-groonga.c +42 -0
  9. data/lib/1.9/groonga.so +0 -0
  10. data/lib/2.0/groonga.so +0 -0
  11. data/lib/2.1/groonga.so +0 -0
  12. data/lib/groonga/dumper.rb +7 -3
  13. data/lib/groonga/record.rb +19 -1
  14. data/rroonga-build.rb +5 -5
  15. data/test/test-array.rb +14 -1
  16. data/test/test-database-dumper.rb +68 -83
  17. data/test/test-database.rb +1 -1
  18. data/test/test-double-array-trie.rb +16 -1
  19. data/test/test-hash.rb +16 -1
  20. data/test/test-lock-timeout.rb +29 -0
  21. data/test/test-patricia-trie.rb +16 -1
  22. data/test/test-record.rb +194 -160
  23. data/test/test-variable-size-column.rb +1 -1
  24. data/vendor/local/bin/groonga-benchmark.exe +0 -0
  25. data/vendor/local/bin/groonga.exe +0 -0
  26. data/vendor/local/bin/libgroonga-0.dll +0 -0
  27. data/vendor/local/bin/libmecab-1.dll +0 -0
  28. data/vendor/local/bin/libmsgpack-3.dll +0 -0
  29. data/vendor/local/bin/libmsgpackc-2.dll +0 -0
  30. data/vendor/local/bin/mecab-config +2 -2
  31. data/vendor/local/bin/mecab.exe +0 -0
  32. data/vendor/local/etc/groonga/httpd/groonga-httpd.conf +2 -2
  33. data/vendor/local/include/groonga/groonga.h +15 -1
  34. data/vendor/local/lib/groonga/plugins/query_expanders/tsv.a +0 -0
  35. data/vendor/local/lib/groonga/plugins/query_expanders/tsv.dll +0 -0
  36. data/vendor/local/lib/groonga/plugins/query_expanders/tsv.dll.a +0 -0
  37. data/vendor/local/lib/groonga/plugins/query_expanders/tsv.la +3 -3
  38. data/vendor/local/lib/groonga/plugins/suggest/suggest.a +0 -0
  39. data/vendor/local/lib/groonga/plugins/suggest/suggest.dll +0 -0
  40. data/vendor/local/lib/groonga/plugins/suggest/suggest.dll.a +0 -0
  41. data/vendor/local/lib/groonga/plugins/suggest/suggest.la +3 -3
  42. data/vendor/local/lib/groonga/plugins/table/table.a +0 -0
  43. data/vendor/local/lib/groonga/plugins/table/table.dll +0 -0
  44. data/vendor/local/lib/groonga/plugins/table/table.dll.a +0 -0
  45. data/vendor/local/lib/groonga/plugins/table/table.la +3 -3
  46. data/vendor/local/lib/groonga/plugins/tokenizers/mecab.a +0 -0
  47. data/vendor/local/lib/groonga/plugins/tokenizers/mecab.dll +0 -0
  48. data/vendor/local/lib/groonga/plugins/tokenizers/mecab.dll.a +0 -0
  49. data/vendor/local/lib/groonga/plugins/tokenizers/mecab.la +3 -3
  50. data/vendor/local/lib/libgroonga.a +0 -0
  51. data/vendor/local/lib/libgroonga.dll.a +0 -0
  52. data/vendor/local/lib/libgroonga.la +3 -3
  53. data/vendor/local/lib/libmecab.a +0 -0
  54. data/vendor/local/lib/libmecab.dll.a +0 -0
  55. data/vendor/local/lib/libmecab.la +1 -1
  56. data/vendor/local/lib/libmsgpack.a +0 -0
  57. data/vendor/local/lib/libmsgpack.dll.a +0 -0
  58. data/vendor/local/lib/libmsgpack.la +1 -1
  59. data/vendor/local/lib/libmsgpackc.a +0 -0
  60. data/vendor/local/lib/libmsgpackc.dll.a +0 -0
  61. data/vendor/local/lib/libmsgpackc.la +1 -1
  62. data/vendor/local/lib/pkgconfig/groonga.pc +3 -3
  63. data/vendor/local/libexec/mecab/mecab-cost-train.exe +0 -0
  64. data/vendor/local/libexec/mecab/mecab-dict-gen.exe +0 -0
  65. data/vendor/local/libexec/mecab/mecab-dict-index.exe +0 -0
  66. data/vendor/local/libexec/mecab/mecab-system-eval.exe +0 -0
  67. data/vendor/local/libexec/mecab/mecab-test-gen.exe +0 -0
  68. data/vendor/local/sbin/groonga-httpd-restart +1 -1
  69. data/vendor/local/share/doc/groonga/en/html/.buildinfo +1 -1
  70. data/vendor/local/share/doc/groonga/en/html/_sources/characteristic.txt +1 -0
  71. data/vendor/local/share/doc/groonga/en/html/_sources/community.txt +1 -0
  72. data/vendor/local/share/doc/groonga/en/html/_sources/development.txt +2 -2
  73. data/vendor/local/share/doc/groonga/en/html/_sources/development/travis-ci.txt +6 -6
  74. data/vendor/local/share/doc/groonga/en/html/_sources/install/centos.txt +7 -7
  75. data/vendor/local/share/doc/groonga/en/html/_sources/install/debian.txt +6 -6
  76. data/vendor/local/share/doc/groonga/en/html/_sources/install/fedora.txt +6 -6
  77. data/vendor/local/share/doc/groonga/en/html/_sources/install/mac_os_x.txt +3 -3
  78. data/vendor/local/share/doc/groonga/en/html/_sources/install/others.txt +3 -3
  79. data/vendor/local/share/doc/groonga/en/html/_sources/install/solaris.txt +4 -4
  80. data/vendor/local/share/doc/groonga/en/html/_sources/install/ubuntu.txt +10 -10
  81. data/vendor/local/share/doc/groonga/en/html/_sources/install/windows.txt +10 -9
  82. data/vendor/local/share/doc/groonga/en/html/_sources/limitations.txt +1 -0
  83. data/vendor/local/share/doc/groonga/en/html/_sources/news.txt +32 -1
  84. data/vendor/local/share/doc/groonga/en/html/_sources/reference.txt +1 -0
  85. data/vendor/local/share/doc/groonga/en/html/_sources/reference/api/global_configurations.txt +49 -0
  86. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/cache_limit.txt +1 -0
  87. data/vendor/local/share/doc/groonga/en/html/_sources/reference/executables/grnslap.txt +1 -1
  88. data/vendor/local/share/doc/groonga/en/html/_sources/reference/executables/groonga.txt +2 -2
  89. data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/edit_distance.txt +1 -1
  90. data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/geo_distance.txt +5 -6
  91. data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/geo_in_circle.txt +1 -1
  92. data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/geo_in_rectangle.txt +1 -1
  93. data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/html_untag.txt +1 -1
  94. data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/now.txt +1 -1
  95. data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/rand.txt +1 -1
  96. data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/snippet_html.txt +5 -3
  97. data/vendor/local/share/doc/groonga/en/html/_sources/reference/grn_expr.txt +1 -1
  98. data/vendor/local/share/doc/groonga/en/html/_sources/reference/pseudo_column.txt +1 -1
  99. data/vendor/local/share/doc/groonga/en/html/_sources/reference/query_expanders/tsv.txt +1 -1
  100. data/vendor/local/share/doc/groonga/en/html/_sources/reference/tables.txt +4 -4
  101. data/vendor/local/share/doc/groonga/en/html/_sources/reference/tuning.txt +2 -2
  102. data/vendor/local/share/doc/groonga/en/html/_sources/server.txt +1 -0
  103. data/vendor/local/share/doc/groonga/en/html/_sources/spec.txt +1 -0
  104. data/vendor/local/share/doc/groonga/en/html/_sources/suggest/introduction.txt +2 -2
  105. data/vendor/local/share/doc/groonga/en/html/_sources/troubleshooting.txt +1 -0
  106. data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/drilldown.txt +1 -0
  107. data/vendor/local/share/doc/groonga/en/html/_static/basic.css +19 -0
  108. data/vendor/local/share/doc/groonga/en/html/_static/doctools.js +3 -0
  109. data/vendor/local/share/doc/groonga/en/html/_static/searchtools.js +2 -2
  110. data/vendor/local/share/doc/groonga/en/html/characteristic.html +20 -18
  111. data/vendor/local/share/doc/groonga/en/html/community.html +20 -18
  112. data/vendor/local/share/doc/groonga/en/html/contribution.html +20 -18
  113. data/vendor/local/share/doc/groonga/en/html/contribution/development.html +20 -18
  114. data/vendor/local/share/doc/groonga/en/html/contribution/development/com.html +20 -18
  115. data/vendor/local/share/doc/groonga/en/html/contribution/development/cooperation.html +20 -18
  116. data/vendor/local/share/doc/groonga/en/html/contribution/development/document.html +20 -18
  117. data/vendor/local/share/doc/groonga/en/html/contribution/development/query.html +20 -18
  118. data/vendor/local/share/doc/groonga/en/html/contribution/development/release.html +20 -18
  119. data/vendor/local/share/doc/groonga/en/html/contribution/development/repository.html +20 -18
  120. data/vendor/local/share/doc/groonga/en/html/contribution/development/test.html +20 -18
  121. data/vendor/local/share/doc/groonga/en/html/contribution/documentation.html +20 -18
  122. data/vendor/local/share/doc/groonga/en/html/contribution/documentation/c-api.html +20 -18
  123. data/vendor/local/share/doc/groonga/en/html/contribution/documentation/i18n.html +20 -18
  124. data/vendor/local/share/doc/groonga/en/html/contribution/report.html +20 -18
  125. data/vendor/local/share/doc/groonga/en/html/development.html +22 -20
  126. data/vendor/local/share/doc/groonga/en/html/development/travis-ci.html +26 -24
  127. data/vendor/local/share/doc/groonga/en/html/genindex.html +269 -183
  128. data/vendor/local/share/doc/groonga/en/html/geolocation_search.html +20 -18
  129. data/vendor/local/share/doc/groonga/en/html/index.html +41 -38
  130. data/vendor/local/share/doc/groonga/en/html/install.html +20 -18
  131. data/vendor/local/share/doc/groonga/en/html/install/centos.html +27 -25
  132. data/vendor/local/share/doc/groonga/en/html/install/debian.html +26 -24
  133. data/vendor/local/share/doc/groonga/en/html/install/fedora.html +26 -24
  134. data/vendor/local/share/doc/groonga/en/html/install/mac_os_x.html +23 -21
  135. data/vendor/local/share/doc/groonga/en/html/install/others.html +23 -21
  136. data/vendor/local/share/doc/groonga/en/html/install/solaris.html +24 -22
  137. data/vendor/local/share/doc/groonga/en/html/install/ubuntu.html +30 -28
  138. data/vendor/local/share/doc/groonga/en/html/install/windows.html +29 -27
  139. data/vendor/local/share/doc/groonga/en/html/limitations.html +20 -18
  140. data/vendor/local/share/doc/groonga/en/html/news.html +239 -201
  141. data/vendor/local/share/doc/groonga/en/html/news/0.x.html +20 -18
  142. data/vendor/local/share/doc/groonga/en/html/news/1.0.x.html +20 -18
  143. data/vendor/local/share/doc/groonga/en/html/news/1.1.x.html +20 -18
  144. data/vendor/local/share/doc/groonga/en/html/news/1.2.x.html +20 -18
  145. data/vendor/local/share/doc/groonga/en/html/news/senna.html +20 -18
  146. data/vendor/local/share/doc/groonga/en/html/objects.inv +0 -0
  147. data/vendor/local/share/doc/groonga/en/html/reference.html +41 -38
  148. data/vendor/local/share/doc/groonga/en/html/reference/api.html +46 -43
  149. data/vendor/local/share/doc/groonga/en/html/reference/api/global_configurations.html +205 -0
  150. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_cache.html +55 -53
  151. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_column.html +78 -76
  152. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_command_version.html +48 -46
  153. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_ctx.html +75 -73
  154. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_db.html +54 -52
  155. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_encoding.html +46 -44
  156. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_expr.html +62 -60
  157. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_geo.html +46 -44
  158. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_hook.html +46 -44
  159. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_ii.html +48 -46
  160. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_index_cursor.html +42 -40
  161. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_info.html +46 -44
  162. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_match_escalation.html +44 -42
  163. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_obj.html +117 -115
  164. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_proc.html +48 -46
  165. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_search.html +40 -38
  166. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_table.html +80 -78
  167. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_table_cursor.html +56 -54
  168. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_type.html +40 -38
  169. data/vendor/local/share/doc/groonga/en/html/reference/api/grn_user_data.html +36 -34
  170. data/vendor/local/share/doc/groonga/en/html/reference/cast.html +20 -18
  171. data/vendor/local/share/doc/groonga/en/html/reference/command.html +20 -18
  172. data/vendor/local/share/doc/groonga/en/html/reference/command/command_version.html +20 -18
  173. data/vendor/local/share/doc/groonga/en/html/reference/command/output_format.html +20 -18
  174. data/vendor/local/share/doc/groonga/en/html/reference/command/return_code.html +20 -18
  175. data/vendor/local/share/doc/groonga/en/html/reference/commands/cache_limit.html +20 -18
  176. data/vendor/local/share/doc/groonga/en/html/reference/commands/check.html +21 -19
  177. data/vendor/local/share/doc/groonga/en/html/reference/commands/clearlock.html +20 -18
  178. data/vendor/local/share/doc/groonga/en/html/reference/commands/column_create.html +20 -18
  179. data/vendor/local/share/doc/groonga/en/html/reference/commands/column_list.html +21 -19
  180. data/vendor/local/share/doc/groonga/en/html/reference/commands/column_remove.html +20 -18
  181. data/vendor/local/share/doc/groonga/en/html/reference/commands/column_rename.html +20 -18
  182. data/vendor/local/share/doc/groonga/en/html/reference/commands/define_selector.html +21 -19
  183. data/vendor/local/share/doc/groonga/en/html/reference/commands/defrag.html +20 -18
  184. data/vendor/local/share/doc/groonga/en/html/reference/commands/delete.html +20 -18
  185. data/vendor/local/share/doc/groonga/en/html/reference/commands/dump.html +21 -19
  186. data/vendor/local/share/doc/groonga/en/html/reference/commands/load.html +20 -18
  187. data/vendor/local/share/doc/groonga/en/html/reference/commands/log_level.html +21 -19
  188. data/vendor/local/share/doc/groonga/en/html/reference/commands/log_put.html +20 -18
  189. data/vendor/local/share/doc/groonga/en/html/reference/commands/log_reopen.html +20 -18
  190. data/vendor/local/share/doc/groonga/en/html/reference/commands/normalize.html +20 -18
  191. data/vendor/local/share/doc/groonga/en/html/reference/commands/quit.html +21 -19
  192. data/vendor/local/share/doc/groonga/en/html/reference/commands/register.html +20 -18
  193. data/vendor/local/share/doc/groonga/en/html/reference/commands/ruby_eval.html +20 -18
  194. data/vendor/local/share/doc/groonga/en/html/reference/commands/ruby_load.html +21 -19
  195. data/vendor/local/share/doc/groonga/en/html/reference/commands/select.html +21 -19
  196. data/vendor/local/share/doc/groonga/en/html/reference/commands/shutdown.html +21 -19
  197. data/vendor/local/share/doc/groonga/en/html/reference/commands/status.html +20 -18
  198. data/vendor/local/share/doc/groonga/en/html/reference/commands/suggest.html +20 -18
  199. data/vendor/local/share/doc/groonga/en/html/reference/commands/table_create.html +20 -18
  200. data/vendor/local/share/doc/groonga/en/html/reference/commands/table_list.html +21 -19
  201. data/vendor/local/share/doc/groonga/en/html/reference/commands/table_remove.html +20 -18
  202. data/vendor/local/share/doc/groonga/en/html/reference/commands/tokenize.html +20 -18
  203. data/vendor/local/share/doc/groonga/en/html/reference/commands/truncate.html +21 -19
  204. data/vendor/local/share/doc/groonga/en/html/reference/executables.html +20 -18
  205. data/vendor/local/share/doc/groonga/en/html/reference/executables/grnslap.html +23 -21
  206. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-benchmark.html +26 -24
  207. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-httpd.html +20 -18
  208. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-server-http.html +20 -18
  209. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-create-dataset.html +20 -18
  210. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-httpd.html +26 -24
  211. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-learner.html +20 -18
  212. data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga.html +33 -31
  213. data/vendor/local/share/doc/groonga/en/html/reference/function.html +20 -18
  214. data/vendor/local/share/doc/groonga/en/html/reference/functions/between.html +20 -18
  215. data/vendor/local/share/doc/groonga/en/html/reference/functions/edit_distance.html +21 -19
  216. data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_distance.html +23 -21
  217. data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_in_circle.html +21 -19
  218. data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_in_rectangle.html +21 -19
  219. data/vendor/local/share/doc/groonga/en/html/reference/functions/html_untag.html +21 -19
  220. data/vendor/local/share/doc/groonga/en/html/reference/functions/now.html +21 -19
  221. data/vendor/local/share/doc/groonga/en/html/reference/functions/query.html +20 -18
  222. data/vendor/local/share/doc/groonga/en/html/reference/functions/rand.html +21 -19
  223. data/vendor/local/share/doc/groonga/en/html/reference/functions/snippet_html.html +24 -21
  224. data/vendor/local/share/doc/groonga/en/html/reference/functions/sub_filter.html +20 -18
  225. data/vendor/local/share/doc/groonga/en/html/reference/grn_expr.html +21 -19
  226. data/vendor/local/share/doc/groonga/en/html/reference/grn_expr/query_syntax.html +20 -18
  227. data/vendor/local/share/doc/groonga/en/html/reference/grn_expr/script_syntax.html +20 -18
  228. data/vendor/local/share/doc/groonga/en/html/reference/indexing.html +20 -18
  229. data/vendor/local/share/doc/groonga/en/html/reference/log.html +20 -18
  230. data/vendor/local/share/doc/groonga/en/html/reference/normalizers.html +20 -18
  231. data/vendor/local/share/doc/groonga/en/html/reference/output.html +20 -18
  232. data/vendor/local/share/doc/groonga/en/html/reference/pseudo_column.html +21 -19
  233. data/vendor/local/share/doc/groonga/en/html/reference/query_expanders.html +20 -18
  234. data/vendor/local/share/doc/groonga/en/html/reference/query_expanders/tsv.html +21 -19
  235. data/vendor/local/share/doc/groonga/en/html/reference/tables.html +24 -22
  236. data/vendor/local/share/doc/groonga/en/html/reference/tokenizers.html +20 -18
  237. data/vendor/local/share/doc/groonga/en/html/reference/tuning.html +22 -20
  238. data/vendor/local/share/doc/groonga/en/html/reference/types.html +21 -19
  239. data/vendor/local/share/doc/groonga/en/html/search.html +12 -12
  240. data/vendor/local/share/doc/groonga/en/html/searchindex.js +1 -1
  241. data/vendor/local/share/doc/groonga/en/html/server.html +20 -18
  242. data/vendor/local/share/doc/groonga/en/html/server/gqtp.html +20 -18
  243. data/vendor/local/share/doc/groonga/en/html/server/http.html +20 -18
  244. data/vendor/local/share/doc/groonga/en/html/server/http/comparison.html +20 -18
  245. data/vendor/local/share/doc/groonga/en/html/server/http/groonga-httpd.html +20 -18
  246. data/vendor/local/share/doc/groonga/en/html/server/http/groonga.html +20 -18
  247. data/vendor/local/share/doc/groonga/en/html/server/package.html +20 -18
  248. data/vendor/local/share/doc/groonga/en/html/spec.html +24 -22
  249. data/vendor/local/share/doc/groonga/en/html/spec/gqtp.html +20 -18
  250. data/vendor/local/share/doc/groonga/en/html/spec/search.html +20 -18
  251. data/vendor/local/share/doc/groonga/en/html/suggest.html +20 -18
  252. data/vendor/local/share/doc/groonga/en/html/suggest/completion.html +20 -18
  253. data/vendor/local/share/doc/groonga/en/html/suggest/correction.html +20 -18
  254. data/vendor/local/share/doc/groonga/en/html/suggest/introduction.html +22 -20
  255. data/vendor/local/share/doc/groonga/en/html/suggest/suggestion.html +20 -18
  256. data/vendor/local/share/doc/groonga/en/html/suggest/tutorial.html +20 -18
  257. data/vendor/local/share/doc/groonga/en/html/troubleshooting.html +20 -18
  258. data/vendor/local/share/doc/groonga/en/html/troubleshooting/different_results_with_the_same_keyword.html +20 -18
  259. data/vendor/local/share/doc/groonga/en/html/troubleshooting/mmap_cannot_allocate_memory.html +20 -18
  260. data/vendor/local/share/doc/groonga/en/html/tutorial.html +20 -18
  261. data/vendor/local/share/doc/groonga/en/html/tutorial/data.html +20 -18
  262. data/vendor/local/share/doc/groonga/en/html/tutorial/drilldown.html +20 -18
  263. data/vendor/local/share/doc/groonga/en/html/tutorial/index.html +20 -18
  264. data/vendor/local/share/doc/groonga/en/html/tutorial/introduction.html +20 -18
  265. data/vendor/local/share/doc/groonga/en/html/tutorial/lexicon.html +20 -18
  266. data/vendor/local/share/doc/groonga/en/html/tutorial/match_columns.html +20 -18
  267. data/vendor/local/share/doc/groonga/en/html/tutorial/micro_blog.html +20 -18
  268. data/vendor/local/share/doc/groonga/en/html/tutorial/network.html +20 -18
  269. data/vendor/local/share/doc/groonga/en/html/tutorial/patricia_trie.html +20 -18
  270. data/vendor/local/share/doc/groonga/en/html/tutorial/query_expansion.html +20 -18
  271. data/vendor/local/share/doc/groonga/en/html/tutorial/search.html +20 -18
  272. data/vendor/local/share/doc/groonga/ja/html/.buildinfo +1 -1
  273. data/vendor/local/share/doc/groonga/ja/html/_sources/characteristic.txt +1 -0
  274. data/vendor/local/share/doc/groonga/ja/html/_sources/community.txt +1 -0
  275. data/vendor/local/share/doc/groonga/ja/html/_sources/development.txt +2 -2
  276. data/vendor/local/share/doc/groonga/ja/html/_sources/development/travis-ci.txt +6 -6
  277. data/vendor/local/share/doc/groonga/ja/html/_sources/install/centos.txt +7 -7
  278. data/vendor/local/share/doc/groonga/ja/html/_sources/install/debian.txt +6 -6
  279. data/vendor/local/share/doc/groonga/ja/html/_sources/install/fedora.txt +6 -6
  280. data/vendor/local/share/doc/groonga/ja/html/_sources/install/mac_os_x.txt +3 -3
  281. data/vendor/local/share/doc/groonga/ja/html/_sources/install/others.txt +3 -3
  282. data/vendor/local/share/doc/groonga/ja/html/_sources/install/solaris.txt +4 -4
  283. data/vendor/local/share/doc/groonga/ja/html/_sources/install/ubuntu.txt +10 -10
  284. data/vendor/local/share/doc/groonga/ja/html/_sources/install/windows.txt +10 -9
  285. data/vendor/local/share/doc/groonga/ja/html/_sources/limitations.txt +1 -0
  286. data/vendor/local/share/doc/groonga/ja/html/_sources/news.txt +32 -1
  287. data/vendor/local/share/doc/groonga/ja/html/_sources/reference.txt +1 -0
  288. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/api/global_configurations.txt +49 -0
  289. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/cache_limit.txt +1 -0
  290. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/executables/grnslap.txt +1 -1
  291. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/executables/groonga.txt +2 -2
  292. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/edit_distance.txt +1 -1
  293. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/geo_distance.txt +5 -6
  294. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/geo_in_circle.txt +1 -1
  295. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/geo_in_rectangle.txt +1 -1
  296. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/html_untag.txt +1 -1
  297. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/now.txt +1 -1
  298. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/rand.txt +1 -1
  299. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/snippet_html.txt +5 -3
  300. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/grn_expr.txt +1 -1
  301. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/pseudo_column.txt +1 -1
  302. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/query_expanders/tsv.txt +1 -1
  303. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/tables.txt +4 -4
  304. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/tuning.txt +2 -2
  305. data/vendor/local/share/doc/groonga/ja/html/_sources/server.txt +1 -0
  306. data/vendor/local/share/doc/groonga/ja/html/_sources/spec.txt +1 -0
  307. data/vendor/local/share/doc/groonga/ja/html/_sources/suggest/introduction.txt +2 -2
  308. data/vendor/local/share/doc/groonga/ja/html/_sources/troubleshooting.txt +1 -0
  309. data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/drilldown.txt +1 -0
  310. data/vendor/local/share/doc/groonga/ja/html/_static/basic.css +19 -0
  311. data/vendor/local/share/doc/groonga/ja/html/_static/doctools.js +3 -0
  312. data/vendor/local/share/doc/groonga/ja/html/_static/searchtools.js +2 -2
  313. data/vendor/local/share/doc/groonga/ja/html/characteristic.html +20 -18
  314. data/vendor/local/share/doc/groonga/ja/html/community.html +20 -18
  315. data/vendor/local/share/doc/groonga/ja/html/contribution.html +20 -18
  316. data/vendor/local/share/doc/groonga/ja/html/contribution/development.html +20 -18
  317. data/vendor/local/share/doc/groonga/ja/html/contribution/development/com.html +20 -18
  318. data/vendor/local/share/doc/groonga/ja/html/contribution/development/cooperation.html +20 -18
  319. data/vendor/local/share/doc/groonga/ja/html/contribution/development/document.html +20 -18
  320. data/vendor/local/share/doc/groonga/ja/html/contribution/development/query.html +20 -18
  321. data/vendor/local/share/doc/groonga/ja/html/contribution/development/release.html +20 -18
  322. data/vendor/local/share/doc/groonga/ja/html/contribution/development/repository.html +20 -18
  323. data/vendor/local/share/doc/groonga/ja/html/contribution/development/test.html +20 -18
  324. data/vendor/local/share/doc/groonga/ja/html/contribution/documentation.html +20 -18
  325. data/vendor/local/share/doc/groonga/ja/html/contribution/documentation/c-api.html +20 -18
  326. data/vendor/local/share/doc/groonga/ja/html/contribution/documentation/i18n.html +20 -18
  327. data/vendor/local/share/doc/groonga/ja/html/contribution/report.html +20 -18
  328. data/vendor/local/share/doc/groonga/ja/html/development.html +20 -18
  329. data/vendor/local/share/doc/groonga/ja/html/development/travis-ci.html +20 -18
  330. data/vendor/local/share/doc/groonga/ja/html/genindex.html +274 -183
  331. data/vendor/local/share/doc/groonga/ja/html/geolocation_search.html +20 -18
  332. data/vendor/local/share/doc/groonga/ja/html/index.html +41 -38
  333. data/vendor/local/share/doc/groonga/ja/html/install.html +20 -18
  334. data/vendor/local/share/doc/groonga/ja/html/install/centos.html +23 -21
  335. data/vendor/local/share/doc/groonga/ja/html/install/debian.html +23 -21
  336. data/vendor/local/share/doc/groonga/ja/html/install/fedora.html +23 -21
  337. data/vendor/local/share/doc/groonga/ja/html/install/mac_os_x.html +23 -21
  338. data/vendor/local/share/doc/groonga/ja/html/install/others.html +23 -21
  339. data/vendor/local/share/doc/groonga/ja/html/install/solaris.html +23 -21
  340. data/vendor/local/share/doc/groonga/ja/html/install/ubuntu.html +23 -21
  341. data/vendor/local/share/doc/groonga/ja/html/install/windows.html +29 -27
  342. data/vendor/local/share/doc/groonga/ja/html/limitations.html +20 -18
  343. data/vendor/local/share/doc/groonga/ja/html/news.html +264 -224
  344. data/vendor/local/share/doc/groonga/ja/html/news/0.x.html +20 -18
  345. data/vendor/local/share/doc/groonga/ja/html/news/1.0.x.html +20 -18
  346. data/vendor/local/share/doc/groonga/ja/html/news/1.1.x.html +20 -18
  347. data/vendor/local/share/doc/groonga/ja/html/news/1.2.x.html +27 -25
  348. data/vendor/local/share/doc/groonga/ja/html/news/senna.html +20 -18
  349. data/vendor/local/share/doc/groonga/ja/html/objects.inv +0 -0
  350. data/vendor/local/share/doc/groonga/ja/html/reference.html +41 -38
  351. data/vendor/local/share/doc/groonga/ja/html/reference/api.html +46 -43
  352. data/vendor/local/share/doc/groonga/ja/html/reference/api/global_configurations.html +206 -0
  353. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_cache.html +55 -53
  354. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_column.html +78 -76
  355. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_command_version.html +48 -46
  356. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_ctx.html +74 -72
  357. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_db.html +54 -52
  358. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_encoding.html +46 -44
  359. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_expr.html +62 -60
  360. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_geo.html +46 -44
  361. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_hook.html +46 -44
  362. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_ii.html +48 -46
  363. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_index_cursor.html +42 -40
  364. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_info.html +46 -44
  365. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_match_escalation.html +44 -42
  366. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_obj.html +117 -115
  367. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_proc.html +48 -46
  368. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_search.html +40 -38
  369. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_table.html +80 -78
  370. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_table_cursor.html +56 -54
  371. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_type.html +40 -38
  372. data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_user_data.html +36 -34
  373. data/vendor/local/share/doc/groonga/ja/html/reference/cast.html +20 -18
  374. data/vendor/local/share/doc/groonga/ja/html/reference/command.html +20 -18
  375. data/vendor/local/share/doc/groonga/ja/html/reference/command/command_version.html +20 -18
  376. data/vendor/local/share/doc/groonga/ja/html/reference/command/output_format.html +20 -18
  377. data/vendor/local/share/doc/groonga/ja/html/reference/command/return_code.html +20 -18
  378. data/vendor/local/share/doc/groonga/ja/html/reference/commands/cache_limit.html +20 -18
  379. data/vendor/local/share/doc/groonga/ja/html/reference/commands/check.html +21 -19
  380. data/vendor/local/share/doc/groonga/ja/html/reference/commands/clearlock.html +20 -18
  381. data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_create.html +20 -18
  382. data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_list.html +21 -19
  383. data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_remove.html +20 -18
  384. data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_rename.html +20 -18
  385. data/vendor/local/share/doc/groonga/ja/html/reference/commands/define_selector.html +21 -19
  386. data/vendor/local/share/doc/groonga/ja/html/reference/commands/defrag.html +20 -18
  387. data/vendor/local/share/doc/groonga/ja/html/reference/commands/delete.html +20 -18
  388. data/vendor/local/share/doc/groonga/ja/html/reference/commands/dump.html +21 -19
  389. data/vendor/local/share/doc/groonga/ja/html/reference/commands/load.html +20 -18
  390. data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_level.html +21 -19
  391. data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_put.html +20 -18
  392. data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_reopen.html +20 -18
  393. data/vendor/local/share/doc/groonga/ja/html/reference/commands/normalize.html +20 -18
  394. data/vendor/local/share/doc/groonga/ja/html/reference/commands/quit.html +21 -19
  395. data/vendor/local/share/doc/groonga/ja/html/reference/commands/register.html +20 -18
  396. data/vendor/local/share/doc/groonga/ja/html/reference/commands/ruby_eval.html +20 -18
  397. data/vendor/local/share/doc/groonga/ja/html/reference/commands/ruby_load.html +21 -19
  398. data/vendor/local/share/doc/groonga/ja/html/reference/commands/select.html +21 -19
  399. data/vendor/local/share/doc/groonga/ja/html/reference/commands/shutdown.html +21 -19
  400. data/vendor/local/share/doc/groonga/ja/html/reference/commands/status.html +20 -18
  401. data/vendor/local/share/doc/groonga/ja/html/reference/commands/suggest.html +20 -18
  402. data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_create.html +20 -18
  403. data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_list.html +21 -19
  404. data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_remove.html +20 -18
  405. data/vendor/local/share/doc/groonga/ja/html/reference/commands/tokenize.html +20 -18
  406. data/vendor/local/share/doc/groonga/ja/html/reference/commands/truncate.html +21 -19
  407. data/vendor/local/share/doc/groonga/ja/html/reference/executables.html +20 -18
  408. data/vendor/local/share/doc/groonga/ja/html/reference/executables/grnslap.html +23 -21
  409. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-benchmark.html +26 -24
  410. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-httpd.html +20 -18
  411. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-server-http.html +20 -18
  412. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-create-dataset.html +20 -18
  413. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-httpd.html +26 -24
  414. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-learner.html +20 -18
  415. data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga.html +33 -31
  416. data/vendor/local/share/doc/groonga/ja/html/reference/function.html +20 -18
  417. data/vendor/local/share/doc/groonga/ja/html/reference/functions/between.html +20 -18
  418. data/vendor/local/share/doc/groonga/ja/html/reference/functions/edit_distance.html +21 -19
  419. data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_distance.html +23 -21
  420. data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_in_circle.html +21 -19
  421. data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_in_rectangle.html +21 -19
  422. data/vendor/local/share/doc/groonga/ja/html/reference/functions/html_untag.html +21 -19
  423. data/vendor/local/share/doc/groonga/ja/html/reference/functions/now.html +21 -19
  424. data/vendor/local/share/doc/groonga/ja/html/reference/functions/query.html +20 -18
  425. data/vendor/local/share/doc/groonga/ja/html/reference/functions/rand.html +21 -19
  426. data/vendor/local/share/doc/groonga/ja/html/reference/functions/snippet_html.html +24 -20
  427. data/vendor/local/share/doc/groonga/ja/html/reference/functions/sub_filter.html +20 -18
  428. data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr.html +22 -20
  429. data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr/query_syntax.html +20 -18
  430. data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr/script_syntax.html +21 -19
  431. data/vendor/local/share/doc/groonga/ja/html/reference/indexing.html +22 -20
  432. data/vendor/local/share/doc/groonga/ja/html/reference/log.html +20 -18
  433. data/vendor/local/share/doc/groonga/ja/html/reference/normalizers.html +20 -18
  434. data/vendor/local/share/doc/groonga/ja/html/reference/output.html +22 -20
  435. data/vendor/local/share/doc/groonga/ja/html/reference/pseudo_column.html +21 -19
  436. data/vendor/local/share/doc/groonga/ja/html/reference/query_expanders.html +20 -18
  437. data/vendor/local/share/doc/groonga/ja/html/reference/query_expanders/tsv.html +21 -19
  438. data/vendor/local/share/doc/groonga/ja/html/reference/tables.html +23 -21
  439. data/vendor/local/share/doc/groonga/ja/html/reference/tokenizers.html +20 -18
  440. data/vendor/local/share/doc/groonga/ja/html/reference/tuning.html +22 -20
  441. data/vendor/local/share/doc/groonga/ja/html/reference/types.html +21 -19
  442. data/vendor/local/share/doc/groonga/ja/html/search.html +12 -12
  443. data/vendor/local/share/doc/groonga/ja/html/searchindex.js +1 -1
  444. data/vendor/local/share/doc/groonga/ja/html/server.html +20 -18
  445. data/vendor/local/share/doc/groonga/ja/html/server/gqtp.html +20 -18
  446. data/vendor/local/share/doc/groonga/ja/html/server/http.html +20 -18
  447. data/vendor/local/share/doc/groonga/ja/html/server/http/comparison.html +20 -18
  448. data/vendor/local/share/doc/groonga/ja/html/server/http/groonga-httpd.html +20 -18
  449. data/vendor/local/share/doc/groonga/ja/html/server/http/groonga.html +20 -18
  450. data/vendor/local/share/doc/groonga/ja/html/server/package.html +20 -18
  451. data/vendor/local/share/doc/groonga/ja/html/spec.html +24 -22
  452. data/vendor/local/share/doc/groonga/ja/html/spec/gqtp.html +20 -18
  453. data/vendor/local/share/doc/groonga/ja/html/spec/search.html +20 -18
  454. data/vendor/local/share/doc/groonga/ja/html/suggest.html +21 -19
  455. data/vendor/local/share/doc/groonga/ja/html/suggest/completion.html +22 -20
  456. data/vendor/local/share/doc/groonga/ja/html/suggest/correction.html +22 -20
  457. data/vendor/local/share/doc/groonga/ja/html/suggest/introduction.html +21 -19
  458. data/vendor/local/share/doc/groonga/ja/html/suggest/suggestion.html +22 -20
  459. data/vendor/local/share/doc/groonga/ja/html/suggest/tutorial.html +20 -18
  460. data/vendor/local/share/doc/groonga/ja/html/troubleshooting.html +20 -18
  461. data/vendor/local/share/doc/groonga/ja/html/troubleshooting/different_results_with_the_same_keyword.html +20 -18
  462. data/vendor/local/share/doc/groonga/ja/html/troubleshooting/mmap_cannot_allocate_memory.html +20 -18
  463. data/vendor/local/share/doc/groonga/ja/html/tutorial.html +20 -18
  464. data/vendor/local/share/doc/groonga/ja/html/tutorial/data.html +20 -18
  465. data/vendor/local/share/doc/groonga/ja/html/tutorial/drilldown.html +20 -18
  466. data/vendor/local/share/doc/groonga/ja/html/tutorial/index.html +20 -18
  467. data/vendor/local/share/doc/groonga/ja/html/tutorial/introduction.html +20 -18
  468. data/vendor/local/share/doc/groonga/ja/html/tutorial/lexicon.html +20 -18
  469. data/vendor/local/share/doc/groonga/ja/html/tutorial/match_columns.html +20 -18
  470. data/vendor/local/share/doc/groonga/ja/html/tutorial/micro_blog.html +20 -18
  471. data/vendor/local/share/doc/groonga/ja/html/tutorial/network.html +20 -18
  472. data/vendor/local/share/doc/groonga/ja/html/tutorial/patricia_trie.html +20 -18
  473. data/vendor/local/share/doc/groonga/ja/html/tutorial/query_expansion.html +20 -18
  474. data/vendor/local/share/doc/groonga/ja/html/tutorial/search.html +20 -18
  475. data/vendor/local/share/man/ja/man1/groonga.1 +198 -132
  476. data/vendor/local/share/man/man1/groonga.1 +619 -554
  477. metadata +8 -14
  478. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands_not_implemented/add.txt +0 -104
  479. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands_not_implemented/get.txt +0 -80
  480. data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands_not_implemented/set.txt +0 -105
  481. data/vendor/local/share/doc/groonga/en/html/reference/commands_not_implemented/add.html +0 -199
  482. data/vendor/local/share/doc/groonga/en/html/reference/commands_not_implemented/get.html +0 -180
  483. data/vendor/local/share/doc/groonga/en/html/reference/commands_not_implemented/set.html +0 -201
  484. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands_not_implemented/add.txt +0 -104
  485. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands_not_implemented/get.txt +0 -80
  486. data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands_not_implemented/set.txt +0 -105
  487. data/vendor/local/share/doc/groonga/ja/html/reference/commands_not_implemented/add.html +0 -200
  488. data/vendor/local/share/doc/groonga/ja/html/reference/commands_not_implemented/get.html +0 -181
  489. data/vendor/local/share/doc/groonga/ja/html/reference/commands_not_implemented/set.html +0 -202
@@ -1,4 +1,6 @@
1
- .TH "GROONGA" "1" "December 27, 2013" "3.1.1" "Groonga"
1
+ .\" Man page generated from reStructuredText.
2
+ .
3
+ .TH "GROONGA" "1" "January 27, 2014" "3.1.2" "Groonga"
2
4
  .SH NAME
3
5
  groonga \- Groonga documentation
4
6
  .
@@ -28,8 +30,6 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
28
30
  .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
29
31
  .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
30
32
  ..
31
- .\" Man page generated from reStructuredText.
32
- .
33
33
  .INDENT 0.0
34
34
  .IP \(bu 2
35
35
  \fBnews\fP
@@ -41,7 +41,7 @@ Groonga is a fast and accurate full text search engine based on inverted index.
41
41
  .sp
42
42
  Groonga is also a column\-oriented database management system (DBMS). Compared with well\-known row\-oriented systems, such as MySQL and PostgreSQL, column\-oriented systems are more suited for aggregate queries. Due to this advantage, Groonga can cover weakness of row\-oriented systems.
43
43
  .sp
44
- The basic functions of Groonga are provided in a C library. Also, libraries for using Groonga in other languages, such as Ruby, are provided by related projects. In addition, groonga\-based storage engines are provided for MySQL and PostgreSQL. These libraries and storage engines allow any application to use Groonga. See \fI\%usage examples\fP.
44
+ The basic functions of Groonga are provided in a C library. Also, libraries for using Groonga in other languages, such as Ruby, are provided by related projects. In addition, groonga\-based storage engines are provided for MySQL and PostgreSQL. These libraries and storage engines allow any application to use Groonga. See \fI\%usage examples\fP\&.
45
45
  .SS Full text search and Instant update
46
46
  .sp
47
47
  In widely used DBMSs, updates are immediately processed, for example, a newly registered record appears in the result of the next query. In contrast, some full text search engines do not support instant updates, because it is difficult to dynamically update inverted indexes, the underlying data structure.
@@ -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\-3.1.1\-x86.exe\fP
113
+ \fI\%http://packages.groonga.org/windows/groonga/groonga\-3.1.2\-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\-3.1.1\-x64.exe\fP
126
+ \fI\%http://packages.groonga.org/windows/groonga/groonga\-3.1.2\-x64.exe\fP
127
127
  .UNINDENT
128
128
  .UNINDENT
129
129
  .UNINDENT
@@ -131,7 +131,7 @@ packages.goronga.org:
131
131
  Then run it.
132
132
  .sp
133
133
  Use command prompt in start menu to run
134
- \fB/reference/executables/groonga\fP.
134
+ \fB/reference/executables/groonga\fP\&.
135
135
  .SS zip
136
136
  .sp
137
137
  For 32\-bit environment, download x86 zip archive from
@@ -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\-3.1.1\-x86.zip\fP
143
+ \fI\%http://packages.groonga.org/windows/groonga/groonga\-3.1.2\-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\-3.1.1\-x64.zip\fP
156
+ \fI\%http://packages.groonga.org/windows/groonga/groonga\-3.1.2\-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\-3.1.1.zip\fP
184
+ \fI\%http://packages.groonga.org/source/groonga/groonga\-3.1.2.zip\fP
185
185
  .UNINDENT
186
186
  .UNINDENT
187
187
  .UNINDENT
@@ -194,13 +194,13 @@ 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\-3.1.1
197
+ > cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-3.1.2
198
198
  .ft P
199
199
  .fi
200
200
  .UNINDENT
201
201
  .UNINDENT
202
202
  .sp
203
- Configure by \fBcmake\fP. The following commnad line is for 64\-bit
203
+ Configure by \fBcmake\fP\&. The following commnad line is for 64\-bit
204
204
  version. To build 32\-bit version, use \fB\-G "Visual Studio 10"\fP
205
205
  parameter instead:
206
206
  .INDENT 0.0
@@ -208,7 +208,7 @@ parameter instead:
208
208
  .sp
209
209
  .nf
210
210
  .ft C
211
- groonga\-3.1.1> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\egroonga
211
+ groonga\-3.1.2> 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\-3.1.1> cmake \-\-build . \-\-config Release
223
+ groonga\-3.1.2> cmake \-\-build . \-\-config Release
224
224
  .ft P
225
225
  .fi
226
226
  .UNINDENT
@@ -232,18 +232,18 @@ Install:
232
232
  .sp
233
233
  .nf
234
234
  .ft C
235
- groonga\-3.1.1> cmake \-\-build . \-\-config Release \-\-target Install
235
+ groonga\-3.1.2> cmake \-\-build . \-\-config Release \-\-target Install
236
236
  .ft P
237
237
  .fi
238
238
  .UNINDENT
239
239
  .UNINDENT
240
240
  .sp
241
241
  After the above steps, \fB/reference/executables/groonga\fP is found in
242
- \fBc:\egroonga\ebin\egroonga.exe\fP.
242
+ \fBc:\egroonga\ebin\egroonga.exe\fP\&.
243
243
  .SS Mac OS X
244
244
  .sp
245
245
  This section describes how to install groonga on Mac OS X. You can
246
- install groonga by \fI\%MacPorts\fP or \fI\%Homebrew\fP.
246
+ install groonga by \fI\%MacPorts\fP or \fI\%Homebrew\fP\&.
247
247
  .sp
248
248
  We distribute both 32\-bit and 64\-bit packages but we strongly
249
249
  recommend a 64\-bit package for server. You should use a 32\-bit package
@@ -278,7 +278,7 @@ Install:
278
278
  .UNINDENT
279
279
  .SS Build from source
280
280
  .sp
281
- Install \fI\%Xcode\fP.
281
+ Install \fI\%Xcode\fP\&.
282
282
  .sp
283
283
  Download source:
284
284
  .INDENT 0.0
@@ -286,9 +286,9 @@ Download source:
286
286
  .sp
287
287
  .nf
288
288
  .ft C
289
- % curl \-O http://packages.groonga.org/source/groonga/groonga\-3.1.1.tar.gz
290
- % tar xvzf groonga\-3.1.1.tar.gz
291
- % cd groonga\-3.1.1
289
+ % curl \-O http://packages.groonga.org/source/groonga/groonga\-3.1.2.tar.gz
290
+ % tar xvzf groonga\-3.1.2.tar.gz
291
+ % cd groonga\-3.1.2
292
292
  .ft P
293
293
  .fi
294
294
  .UNINDENT
@@ -331,8 +331,8 @@ Install:
331
331
  .UNINDENT
332
332
  .SS Debian GNU/Linux
333
333
  .sp
334
- This section describes how to install groonga related deb packages on
335
- Debian GNU/Linux. You can install them by \fBapt\fP.
334
+ This section describes how to install Groonga related deb packages on
335
+ Debian GNU/Linux. You can install them by \fBapt\fP\&.
336
336
  .sp
337
337
  We distribute both 32\-bit and 64\-bit packages but we strongly
338
338
  recommend a 64\-bit package for server. You should use a 32\-bit package
@@ -362,7 +362,7 @@ See \fB/server\fP section about details.
362
362
  .UNINDENT
363
363
  .SS wheezy
364
364
  .sp
365
- Add the groonga apt repository.
365
+ Add the Groonga apt repository.
366
366
  .sp
367
367
  /etc/apt/sources.list.d/groonga.list:
368
368
  .INDENT 0.0
@@ -500,7 +500,7 @@ Install groonga\-munin\-plugins package:
500
500
  .UNINDENT
501
501
  .sp
502
502
  There is a package that provides MySQL compatible normalizer as
503
- groonga plugins.
503
+ Groonga plugins.
504
504
  If you want to use that one, install groonga\-normalizer\-mysql package.
505
505
  .sp
506
506
  Install groonga\-normalizer\-mysql package:
@@ -611,9 +611,9 @@ Download source:
611
611
  .sp
612
612
  .nf
613
613
  .ft C
614
- % wget http://packages.groonga.org/source/groonga/groonga\-3.1.1.tar.gz
615
- % tar xvzf groonga\-3.1.1.tar.gz
616
- % cd groonga\-3.1.1
614
+ % wget http://packages.groonga.org/source/groonga/groonga\-3.1.2.tar.gz
615
+ % tar xvzf groonga\-3.1.2.tar.gz
616
+ % cd groonga\-3.1.2
617
617
  .ft P
618
618
  .fi
619
619
  .UNINDENT
@@ -656,8 +656,8 @@ Install:
656
656
  .UNINDENT
657
657
  .SS Ubuntu
658
658
  .sp
659
- This section describes how to install groonga related deb packages on
660
- Ubuntu. You can install them by \fBapt\fP.
659
+ This section describes how to install Groonga related deb packages on
660
+ Ubuntu. You can install them by \fBapt\fP\&.
661
661
  .sp
662
662
  We distribute both 32\-bit and 64\-bit packages but we strongly
663
663
  recommend a 64\-bit package for server. You should use a 32\-bit package
@@ -705,7 +705,7 @@ Enable the universe repository to install groonga:
705
705
  .UNINDENT
706
706
  .UNINDENT
707
707
  .sp
708
- Add the groonga apt repository.
708
+ Add the Groonga apt repository.
709
709
  .sp
710
710
  /etc/apt/sources.list.d/groonga.list:
711
711
  .INDENT 0.0
@@ -766,7 +766,7 @@ Install groonga\-munin\-plugins package:
766
766
  .UNINDENT
767
767
  .sp
768
768
  There is a package that provides MySQL compatible normalizer as
769
- groonga plugins.
769
+ Groonga plugins.
770
770
  If you want to use that one, install groonga\-normalizer\-mysql package.
771
771
  .sp
772
772
  Install groonga\-normalizer\-mysql package:
@@ -800,7 +800,7 @@ Enable the universe repository to install groonga:
800
800
  .UNINDENT
801
801
  .UNINDENT
802
802
  .sp
803
- Add the groonga apt repository.
803
+ Add the Groonga apt repository.
804
804
  .sp
805
805
  /etc/apt/sources.list.d/groonga.list:
806
806
  .INDENT 0.0
@@ -846,7 +846,7 @@ Install groonga\-tokenizer\-mecab package:
846
846
  .UNINDENT
847
847
  .sp
848
848
  There is a package that provides \fI\%Munin\fP plugins. If you want to monitor
849
- groonga status by Munin, install groonga\-munin\-plugins package.
849
+ Groonga status by Munin, install groonga\-munin\-plugins package.
850
850
  .sp
851
851
  Install groonga\-munin\-plugins package:
852
852
  .INDENT 0.0
@@ -861,7 +861,7 @@ Install groonga\-munin\-plugins package:
861
861
  .UNINDENT
862
862
  .sp
863
863
  There is a package that provides MySQL compatible normalizer as
864
- groonga plugins.
864
+ Groonga plugins.
865
865
  If you want to use that one, install groonga\-normalizer\-mysql package.
866
866
  .sp
867
867
  Install groonga\-normalizer\-mysql package:
@@ -895,7 +895,7 @@ Enable the universe repository to install groonga:
895
895
  .UNINDENT
896
896
  .UNINDENT
897
897
  .sp
898
- Add the groonga apt repository.
898
+ Add the Groonga apt repository.
899
899
  .sp
900
900
  /etc/apt/sources.list.d/groonga.list:
901
901
  .INDENT 0.0
@@ -1067,9 +1067,9 @@ Download source:
1067
1067
  .sp
1068
1068
  .nf
1069
1069
  .ft C
1070
- % wget http://packages.groonga.org/source/groonga/groonga\-3.1.1.tar.gz
1071
- % tar xvzf groonga\-3.1.1.tar.gz
1072
- % cd groonga\-3.1.1
1070
+ % wget http://packages.groonga.org/source/groonga/groonga\-3.1.2.tar.gz
1071
+ % tar xvzf groonga\-3.1.2.tar.gz
1072
+ % cd groonga\-3.1.2
1073
1073
  .ft P
1074
1074
  .fi
1075
1075
  .UNINDENT
@@ -1113,7 +1113,7 @@ Install:
1113
1113
  .SS CentOS
1114
1114
  .sp
1115
1115
  This section describes how to install groonga related RPM packages on
1116
- CentOS. You can install them by \fByum\fP.
1116
+ CentOS. You can install them by \fByum\fP\&.
1117
1117
  .sp
1118
1118
  We distribute both 32\-bit and 64\-bit packages but we strongly
1119
1119
  recommend a 64\-bit package for server. You should use a 32\-bit package
@@ -1199,7 +1199,7 @@ Or install Juman dictionary:
1199
1199
  .UNINDENT
1200
1200
  .sp
1201
1201
  There is a package that provides \fI\%Munin\fP plugins. If you want to monitor
1202
- groonga status by Munin, install groonga\-munin\-plugins package.
1202
+ Groonga status by Munin, install groonga\-munin\-plugins package.
1203
1203
  .sp
1204
1204
  \fBNOTE:\fP
1205
1205
  .INDENT 0.0
@@ -1208,7 +1208,7 @@ Groonga\-munin\-plugins package requires munin\-node package that
1208
1208
  isn\(aqt included in the official CentOS repository. You need to
1209
1209
  enable \fI\%Repoforge (RPMforge)\fP repository
1210
1210
  or \fI\%EPEL\fP repository to
1211
- install it by \fByum\fP.
1211
+ install it by \fByum\fP\&.
1212
1212
  .sp
1213
1213
  Enable Repoforge (RPMforge) repository on i386 environment:
1214
1214
  .INDENT 0.0
@@ -1264,7 +1264,7 @@ Install groonga\-munin\-plugins package:
1264
1264
  .UNINDENT
1265
1265
  .sp
1266
1266
  There is a package that provides MySQL compatible normalizer as
1267
- groonga plugins.
1267
+ Groonga plugins.
1268
1268
  If you want to use that one, install groonga\-normalizer\-mysql package.
1269
1269
  .sp
1270
1270
  Install groonga\-normalizer\-mysql package:
@@ -1336,7 +1336,7 @@ Or install Juman dictionary:
1336
1336
  .UNINDENT
1337
1337
  .sp
1338
1338
  There is a package that provides \fI\%Munin\fP plugins. If you want to monitor
1339
- groonga status by Munin, install groonga\-munin\-plugins package.
1339
+ Groonga status by Munin, install groonga\-munin\-plugins package.
1340
1340
  .sp
1341
1341
  \fBNOTE:\fP
1342
1342
  .INDENT 0.0
@@ -1344,7 +1344,7 @@ groonga status by Munin, install groonga\-munin\-plugins package.
1344
1344
  Groonga\-munin\-plugins package requires munin\-node package that
1345
1345
  isn\(aqt included in the official CentOS repository. You need to
1346
1346
  enable \fI\%EPEL\fP repository to
1347
- install it by \fByum\fP.
1347
+ install it by \fByum\fP\&.
1348
1348
  .sp
1349
1349
  Enable EPEL repository on any environment:
1350
1350
  .INDENT 0.0
@@ -1373,7 +1373,7 @@ Install groonga\-munin\-plugins package:
1373
1373
  .UNINDENT
1374
1374
  .sp
1375
1375
  There is a package that provides MySQL compatible normalizer as
1376
- groonga plugins.
1376
+ Groonga plugins.
1377
1377
  If you want to use that one, install groonga\-normalizer\-mysql package.
1378
1378
  .sp
1379
1379
  Install groonga\-normalizer\-mysql package:
@@ -1407,9 +1407,9 @@ Download source:
1407
1407
  .sp
1408
1408
  .nf
1409
1409
  .ft C
1410
- % wget http://packages.groonga.org/source/groonga/groonga\-3.1.1.tar.gz
1411
- % tar xvzf groonga\-3.1.1.tar.gz
1412
- % cd groonga\-3.1.1
1410
+ % wget http://packages.groonga.org/source/groonga/groonga\-3.1.2.tar.gz
1411
+ % tar xvzf groonga\-3.1.2.tar.gz
1412
+ % cd groonga\-3.1.2
1413
1413
  .ft P
1414
1414
  .fi
1415
1415
  .UNINDENT
@@ -1453,12 +1453,12 @@ Install:
1453
1453
  .SS Fedora
1454
1454
  .sp
1455
1455
  This section describes how to install groonga related RPM packages on
1456
- Fedora. You can install them by \fByum\fP.
1456
+ Fedora. You can install them by \fByum\fP\&.
1457
1457
  .sp
1458
1458
  \fBNOTE:\fP
1459
1459
  .INDENT 0.0
1460
1460
  .INDENT 3.5
1461
- Since groonga 3.0.2 release, Groonga related RPM pakcages are in the official
1461
+ Since Groonga 3.0.2 release, Groonga related RPM pakcages are in the official
1462
1462
  Fedora yum repository (Fedora 18). So you can use them instead of the groonga yum
1463
1463
  repository now. There is some exceptions to use the groonga yum
1464
1464
  repository because \fBgroonga\-normalizer\-mysql\fP and mecab dictionaries
@@ -1565,7 +1565,7 @@ Or install Juman dictionary:
1565
1565
  .UNINDENT
1566
1566
  .sp
1567
1567
  There is a package that provides \fI\%Munin\fP plugins. If you want to monitor
1568
- groonga status by Munin, install groonga\-munin\-plugins package.
1568
+ Groonga status by Munin, install groonga\-munin\-plugins package.
1569
1569
  .sp
1570
1570
  Install groonga\-munin\-plugins package:
1571
1571
  .INDENT 0.0
@@ -1580,7 +1580,7 @@ Install groonga\-munin\-plugins package:
1580
1580
  .UNINDENT
1581
1581
  .sp
1582
1582
  There is a package that provides MySQL compatible normalizer as
1583
- groonga plugins.
1583
+ Groonga plugins.
1584
1584
  If you want to use that one, install groonga\-normalizer\-mysql package.
1585
1585
  .sp
1586
1586
  Install groonga\-normalizer\-mysql package:
@@ -1614,9 +1614,9 @@ Download source:
1614
1614
  .sp
1615
1615
  .nf
1616
1616
  .ft C
1617
- % wget http://packages.groonga.org/source/groonga/groonga\-3.1.1.tar.gz
1618
- % tar xvzf groonga\-3.1.1.tar.gz
1619
- % cd groonga\-3.1.1
1617
+ % wget http://packages.groonga.org/source/groonga/groonga\-3.1.2.tar.gz
1618
+ % tar xvzf groonga\-3.1.2.tar.gz
1619
+ % cd groonga\-3.1.2
1620
1620
  .ft P
1621
1621
  .fi
1622
1622
  .UNINDENT
@@ -1659,7 +1659,7 @@ Install:
1659
1659
  .UNINDENT
1660
1660
  .SS Oracle Solaris
1661
1661
  .sp
1662
- This section describes how to install groonga from source on Oracle
1662
+ This section describes how to install Groonga from source on Oracle
1663
1663
  Solaris.
1664
1664
  .SS Oracle Solaris 11
1665
1665
  .sp
@@ -1681,9 +1681,9 @@ Download source:
1681
1681
  .sp
1682
1682
  .nf
1683
1683
  .ft C
1684
- % wget http://packages.groonga.org/source/groonga/groonga\-3.1.1.tar.gz
1685
- % gtar xvzf groonga\-3.1.1.tar.gz
1686
- % cd groonga\-3.1.1
1684
+ % wget http://packages.groonga.org/source/groonga/groonga\-3.1.2.tar.gz
1685
+ % gtar xvzf groonga\-3.1.2.tar.gz
1686
+ % cd groonga\-3.1.2
1687
1687
  .ft P
1688
1688
  .fi
1689
1689
  .UNINDENT
@@ -1734,7 +1734,7 @@ environment.
1734
1734
  .sp
1735
1735
  To get more detail about installing groonga from source on the
1736
1736
  specific environment, find the document for the specific environment
1737
- from \fB/install\fP.
1737
+ from \fB/install\fP\&.
1738
1738
  .SS Dependencies
1739
1739
  .sp
1740
1740
  Groonga doesn\(aqt require any special libraries but requires some tools
@@ -1823,9 +1823,9 @@ steps:
1823
1823
  .sp
1824
1824
  .nf
1825
1825
  .ft C
1826
- % wget http://packages.groonga.org/source/groonga/groonga\-3.1.1.tar.gz
1827
- % tar xvzf groonga\-3.1.1.tar.gz
1828
- % cd groonga\-3.1.1
1826
+ % wget http://packages.groonga.org/source/groonga/groonga\-3.1.2.tar.gz
1827
+ % tar xvzf groonga\-3.1.2.tar.gz
1828
+ % cd groonga\-3.1.2
1829
1829
  % ./configure
1830
1830
  % make
1831
1831
  % sudo make install
@@ -1835,7 +1835,7 @@ steps:
1835
1835
  .UNINDENT
1836
1836
  .sp
1837
1837
  After the above steps, \fB/reference/executables/groonga\fP is found in
1838
- \fB/usr/local/bin/groonga\fP.
1838
+ \fB/usr/local/bin/groonga\fP\&.
1839
1839
  .sp
1840
1840
  The default build will work well but you can customize groonga at
1841
1841
  \fBconfigure\fP step.
@@ -1843,15 +1843,15 @@ The default build will work well but you can customize groonga at
1843
1843
  The following describes details about each step.
1844
1844
  .SS \fBconfigure\fP
1845
1845
  .sp
1846
- First, you need to run \fBconfigure\fP. Here are important \fBconfigure\fP
1846
+ First, you need to run \fBconfigure\fP\&. Here are important \fBconfigure\fP
1847
1847
  options:
1848
1848
  .SS \fB\-\-prefix=PATH\fP
1849
1849
  .sp
1850
1850
  Specifies the install base directory. Groonga related files are
1851
1851
  installed under \fB${PATH}/\fP directory.
1852
1852
  .sp
1853
- The default is \fB/usr/local\fP. In this case, \fB/reference/executables/groonga\fP is
1854
- installed into \fB/usr/local/bin/groonga\fP.
1853
+ The default is \fB/usr/local\fP\&. In this case, \fB/reference/executables/groonga\fP is
1854
+ installed into \fB/usr/local/bin/groonga\fP\&.
1855
1855
  .sp
1856
1856
  Here is an example that installs groonga into \fB~/local\fP for an user
1857
1857
  use instead of system wide use:
@@ -1869,9 +1869,9 @@ use instead of system wide use:
1869
1869
  .sp
1870
1870
  Specifies the base directory to place modifiable file such as log
1871
1871
  file, PID file and database files. For example, log file is placed at
1872
- \fB${PATH}/log/groonga.log\fP.
1872
+ \fB${PATH}/log/groonga.log\fP\&.
1873
1873
  .sp
1874
- The default is \fB/usr/local/var\fP.
1874
+ The default is \fB/usr/local/var\fP\&.
1875
1875
  .sp
1876
1876
  Here is an example that system wide \fB/var\fP is used for modifiable
1877
1877
  files:
@@ -1892,7 +1892,7 @@ path is \fB/reference/executables/groonga\fP command\(aqs \fB\-\-log\-path\fP
1892
1892
  command line option. So this option is not critical build option. It\(aqs
1893
1893
  just for convenient.
1894
1894
  .sp
1895
- The default is \fB/usr/local/var/log/groonga.log\fP. The
1895
+ The default is \fB/usr/local/var/log/groonga.log\fP\&. The
1896
1896
  \fB/usr/local/var\fP part is changed by \fB\-\-localestatedir\fP option.
1897
1897
  .sp
1898
1898
  Here is an example that log file is placed into shared NFS directory
@@ -1910,9 +1910,9 @@ Here is an example that log file is placed into shared NFS directory
1910
1910
  .SS \fB\-\-with\-default\-encoding=ENCODING\fP
1911
1911
  .sp
1912
1912
  Specifies the default encoding. Available encodings are \fBeuc_jp\fP,
1913
- \fBsjis\fP, \fButf8\fP, \fBlatin1\fP, \fBkoi8r\fP and \fBnone\fP.
1913
+ \fBsjis\fP, \fButf8\fP, \fBlatin1\fP, \fBkoi8r\fP and \fBnone\fP\&.
1914
1914
  .sp
1915
- The default is \fButf\-8\fP.
1915
+ The default is \fButf\-8\fP\&.
1916
1916
  .sp
1917
1917
  Here is an example that Shift_JIS is used as the default encoding:
1918
1918
  .INDENT 0.0
@@ -1966,7 +1966,7 @@ Here is an example that enables column value compression by zlib:
1966
1966
  .INDENT 0.0
1967
1967
  .INDENT 3.5
1968
1968
  The disabled reason is that memory leak occurs when it refers column value.
1969
- This is already known issue as \fI\%GitHub#6\fP.
1969
+ This is already known issue as \fI\%GitHub#6\fP\&.
1970
1970
  This issue is not nothing to do with updating column value.
1971
1971
  .UNINDENT
1972
1972
  .UNINDENT
@@ -1992,7 +1992,7 @@ Here is an example that enables column value compression by LZO:
1992
1992
  .INDENT 0.0
1993
1993
  .INDENT 3.5
1994
1994
  The disabled reason is that memory leak occurs when it refers column value.
1995
- This is already known issue as \fI\%GitHub#6\fP.
1995
+ This is already known issue as \fI\%GitHub#6\fP\&.
1996
1996
  This issue is not nothing to do with updating column value.
1997
1997
  .UNINDENT
1998
1998
  .UNINDENT
@@ -2004,9 +2004,9 @@ path that you use for building MessagePack.
2004
2004
  .sp
2005
2005
  If you installed MessagePack with \fB\-\-prefix=$HOME/local\fP option, you
2006
2006
  sholud specify \fB\-\-with\-message\-pack=$HOME/local\fP to groonga\(aqs
2007
- \fBconfigure\fP.
2007
+ \fBconfigure\fP\&.
2008
2008
  .sp
2009
- The default is \fB/usr\fP.
2009
+ The default is \fB/usr\fP\&.
2010
2010
  .sp
2011
2011
  Here is an example that uses MessagePack built with
2012
2012
  \fB\-\-prefix=$HOME/local\fP option:
@@ -2023,7 +2023,7 @@ Here is an example that uses MessagePack built with
2023
2023
  .SS \fB\-\-with\-munin\-plugins\fP
2024
2024
  .sp
2025
2025
  Installs Munin plugins for groonga. They are installed into
2026
- \fB${PREFIX}/share/groonga/munin/plugins/\fP.
2026
+ \fB${PREFIX}/share/groonga/munin/plugins/\fP\&.
2027
2027
  .sp
2028
2028
  Those plugins are not installed by default.
2029
2029
  .sp
@@ -2041,7 +2041,7 @@ Here is an example that installs Munin plugins for groonga:
2041
2041
  .SS \fB\-\-with\-package\-platform=PLATFORM\fP
2042
2042
  .sp
2043
2043
  Installs platform specific system management files such as init
2044
- script. Available platforms are \fBredhat\fP and \fBfedora\fP. \fBredhat\fP
2044
+ script. Available platforms are \fBredhat\fP and \fBfedora\fP\&. \fBredhat\fP
2045
2045
  is for Red Hat and Red Hat clone distributions such as
2046
2046
  CentOS. \fBfedora\fP is for Fedora.
2047
2047
  .sp
@@ -2106,7 +2106,7 @@ Now, you can install built groonga!:
2106
2106
  .UNINDENT
2107
2107
  .sp
2108
2108
  If you have write permission for \fB${PREFIX}\fP, you don\(aqt need to use
2109
- \fBsudo\fP. e.g. \fB\-\-prefix=$HOME/local\fP case. In this case, use \fBmake
2109
+ \fBsudo\fP\&. e.g. \fB\-\-prefix=$HOME/local\fP case. In this case, use \fBmake
2110
2110
  install\fP:
2111
2111
  .INDENT 0.0
2112
2112
  .INDENT 3.5
@@ -2259,7 +2259,7 @@ In the second form, you can specify a parameter name with its value. So, the ord
2259
2259
  .sp
2260
2260
  If you want to specify a value which contains white\-spaces or special characters, such as quotes and parentheses, please enclose the value with single\-quotes or double\-quotes.
2261
2261
  .sp
2262
- For details, see also the paragraph of "command" in \fB/reference/executables/groonga\fP.
2262
+ For details, see also the paragraph of "command" in \fB/reference/executables/groonga\fP\&.
2263
2263
  .SS Basic commands
2264
2264
  .INDENT 0.0
2265
2265
  .INDENT 3.5
@@ -3572,7 +3572,7 @@ select \-\-table Site \-\-query title:@this
3572
3572
  .UNINDENT
3573
3573
  .SS Administration tool (HTTP)
3574
3574
  .sp
3575
- An HTTP server of Groonga provides a browser based administration tool that makes database management easy. After starting an HTTP server, you can use the administration tool by accessing \fI\%http://HOST_NAME_OR_IP_ADDRESS[:PORT_NUMBER]/\fP. Note that Javascript must be enabled for the tool to work properly.
3575
+ An HTTP server of Groonga provides a browser based administration tool that makes database management easy. After starting an HTTP server, you can use the administration tool by accessing \fI\%http://HOST_NAME_OR_IP_ADDRESS[:PORT_NUMBER]/\fP\&. Note that Javascript must be enabled for the tool to work properly.
3576
3576
  .SS Security issues
3577
3577
  .sp
3578
3578
  Groonga servers don\(aqt support user authentication. Everyone can view and modify databases hosted by Groonga servers. You are recommended to restrict IP addresses that can access Groonga servers. You can use iptables or similar for this purpose.
@@ -3581,7 +3581,7 @@ Groonga servers don\(aqt support user authentication. Everyone can view and modi
3581
3581
  Groonga is a full text search engine but also serves as a column\-oriented data store. Groonga supports various data types, such as numeric types, string types, date and time type, longitude and latitude types, etc. This tutorial shows a list of data types and explains how to use them.
3582
3582
  .SS Overview
3583
3583
  .sp
3584
- The basic data types of Groonga are roughly divided into 5 groups \-\-\- boolean type, numeric types, string types, date/time type and longitude/latitude types. The numeric types are further divided according to whether integer or floating point number, signed or unsigned and the number of bits allocated to each integer. The string types are further divided according to the maximum length. The longitude/latitude types are further divided according to the geographic coordinate system. For more details, see \fB/reference/types\fP.
3584
+ The basic data types of Groonga are roughly divided into 5 groups \-\-\- boolean type, numeric types, string types, date/time type and longitude/latitude types. The numeric types are further divided according to whether integer or floating point number, signed or unsigned and the number of bits allocated to each integer. The string types are further divided according to the maximum length. The longitude/latitude types are further divided according to the geographic coordinate system. For more details, see \fB/reference/types\fP\&.
3585
3585
  .sp
3586
3586
  In addition, Groonga supports reference types and vector types. Reference types are designed for accessing other tables. Vector types are designed for storing a variable number of values in one element.
3587
3587
  .sp
@@ -3663,7 +3663,7 @@ select \-\-table ToyBox \-\-output_columns _key,is_animal
3663
3663
  .UNINDENT
3664
3664
  .SS Numeric types
3665
3665
  .sp
3666
- The numeric types are divided into integer types and a floating point number type. The integer types are further divided into the signed integer types and unsigned integer types. In addition, you can choose the number of bits allocated to each integer. For more details, see \fB/reference/types\fP. The default value of the numeric types is 0.
3666
+ The numeric types are divided into integer types and a floating point number type. The integer types are further divided into the signed integer types and unsigned integer types. In addition, you can choose the number of bits allocated to each integer. For more details, see \fB/reference/types\fP\&. The default value of the numeric types is 0.
3667
3667
  .sp
3668
3668
  The following example creates an Int8 column and a Float column, and then updates existing records. The \fB/reference/commands/load\fP command updates the weight column as expected. On the other hand, the price column values are different from the specified values because 15.9 is not an integer and 200 is too large. 15.9 is converted to 15 by removing the fractional part. 200 causes an overflow and the result becomes \-56. Note that the result of an overflow/underflow is undefined.
3669
3669
  .sp
@@ -3734,7 +3734,7 @@ select \-\-table ToyBox \-\-output_columns _key,price,weight
3734
3734
  .UNINDENT
3735
3735
  .SS String types
3736
3736
  .sp
3737
- The string types are divided according to the maximum length. For more details, see \fB/reference/types\fP. The default value is the zero\-length string.
3737
+ The string types are divided according to the maximum length. For more details, see \fB/reference/types\fP\&. The default value is the zero\-length string.
3738
3738
  .sp
3739
3739
  The following example creates a ShortText column and updates existing records. The third record has the default value because not updated.
3740
3740
  .sp
@@ -3864,7 +3864,7 @@ select \-\-table ToyBox \-\-output_columns _key,time
3864
3864
  .UNINDENT
3865
3865
  .SS Longitude and latitude types
3866
3866
  .sp
3867
- The longitude and latitude types are divided according to the geographic coordinate system. For more details, see \fB/reference/types\fP. To represent a longitude and latitude, Groonga uses a string formatted as follows:
3867
+ The longitude and latitude types are divided according to the geographic coordinate system. For more details, see \fB/reference/types\fP\&. To represent a longitude and latitude, Groonga uses a string formatted as follows:
3868
3868
  .INDENT 0.0
3869
3869
  .IP \(bu 2
3870
3870
  "longitude x latitude" in milliseconds (e.g.: "128452975x503157902")
@@ -4641,7 +4641,7 @@ As you know, there is a naive solution to execute query by every the value of co
4641
4641
  .sp
4642
4642
  If you are familiar with SQL, you will doubt with "Is there a similar SQL functionality to \fBGROUP BY\fP in Groonga?".
4643
4643
  .sp
4644
- Of course, Groonga provides such a functionality. It\(aqs called as \fBdrilldown\fP.
4644
+ Of course, Groonga provides such a functionality. It\(aqs called as \fBdrilldown\fP\&.
4645
4645
  .sp
4646
4646
  \fBdrilldown\fP enables you to get the number of records which belongs to specific the value of column at once.
4647
4647
  .sp
@@ -4787,7 +4787,7 @@ Group records means following records
4787
4787
  T}
4788
4788
  _
4789
4789
  T{
4790
- .org
4790
+ \&.org
4791
4791
  T} T{
4792
4792
  3
4793
4793
  T} T{
@@ -4802,7 +4802,7 @@ T} T{
4802
4802
  T}
4803
4803
  _
4804
4804
  T{
4805
- .net
4805
+ \&.net
4806
4806
  T} T{
4807
4807
  3
4808
4808
  T} T{
@@ -4817,7 +4817,7 @@ T} T{
4817
4817
  T}
4818
4818
  _
4819
4819
  T{
4820
- .com
4820
+ \&.com
4821
4821
  T} T{
4822
4822
  3
4823
4823
  T} T{
@@ -7951,7 +7951,7 @@ select Doc \-\-match_columns body \-\-query "シークヮーサー" \-\-query_ex
7951
7951
  Groonga has the suggest feature. This section describes how to use it and how it works.
7952
7952
  .SS Introduction
7953
7953
  .sp
7954
- The suggest feature in groonga provides the following features:
7954
+ The suggest feature in Groonga provides the following features:
7955
7955
  .INDENT 0.0
7956
7956
  .IP \(bu 2
7957
7957
  Completion
@@ -7963,7 +7963,7 @@ Suggestion
7963
7963
  .SS Completion
7964
7964
  .sp
7965
7965
  Completion helps user input. If user inputs a partial word,
7966
- groonga can return complete words from registered
7966
+ Groonga can return complete words from registered
7967
7967
  words.
7968
7968
  .sp
7969
7969
  For example, there are registered words:
@@ -9165,7 +9165,7 @@ If you use \fBgroonga\-httpd\fP package, you can also take benefits of nginx fun
9165
9165
  .sp
9166
9166
  We recommend to use \fBgroonga\-server\-http\fP at first, then if you want to use more
9167
9167
  fullfilling functionality, use \fBgroonga\-httpd\fP package. If you have performance issues which
9168
- is derived from protocol overheads, consider to use \fBgroonga\-server\-gqtp\fP.
9168
+ is derived from protocol overheads, consider to use \fBgroonga\-server\-gqtp\fP\&.
9169
9169
  .INDENT 0.0
9170
9170
  .INDENT 3.5
9171
9171
  .sp
@@ -9580,7 +9580,7 @@ Restarting groonga HTTP server(Fedora):
9580
9580
  .sp
9581
9581
  TODO
9582
9582
  .sp
9583
- See \fB/reference/executables/groonga\fP.
9583
+ See \fB/reference/executables/groonga\fP\&.
9584
9584
  .SS HTTP
9585
9585
  .sp
9586
9586
  Groonga provides two HTTP server implementations.
@@ -9607,7 +9607,7 @@ implementation. It is also fast and has many HTTP features.
9607
9607
  .SS Comparison
9608
9608
  .sp
9609
9609
  There are many differences between \fBgroonga\fP and
9610
- \fBgroonga\-httpd\fP. Here is a comparison table.
9610
+ \fBgroonga\-httpd\fP\&. Here is a comparison table.
9611
9611
  .TS
9612
9612
  center;
9613
9613
  |l|l|l|.
@@ -9795,8 +9795,8 @@ http {
9795
9795
  .SS Custom prefix path
9796
9796
  .sp
9797
9797
  \fBgroonga\fP accepts a path that starts with \fB/d/\fP as command URL
9798
- such as \fBhttp://localhost:10041/d/status\fP. You cannot change the
9799
- prefix path \fB/d/\fP.
9798
+ such as \fBhttp://localhost:10041/d/status\fP\&. You cannot change the
9799
+ prefix path \fB/d/\fP\&.
9800
9800
  .sp
9801
9801
  \fBgroonga\-httpd\fP can custom prefix path. For example, you can use
9802
9802
  \fBhttp://localhost:10041/api/status\fP as command URL. Here is a sample
@@ -9915,7 +9915,7 @@ http {
9915
9915
  .sp
9916
9916
  HTTP supports authentications such as basic authentication and digest
9917
9917
  authentication. It can be used for restricting use of danger command such
9918
- as \fB/reference/commands/shutdown\fP.
9918
+ as \fB/reference/commands/shutdown\fP\&.
9919
9919
  .sp
9920
9920
  \fBgroonga\fP doesn\(aqt support any authentications. To restrict use of
9921
9921
  danger command, other tools such as iptables and reverse proxy are
@@ -9994,7 +9994,7 @@ Note that \fIgzip_types *\fP is specified. It\(aqs one of the important
9994
9994
  configuration. \fIgzip_types\fP specifies gzip target data formats by MIME
9995
9995
  types. \fBgroonga\-httpd\fP returns one of JSON, XML or MessagePack
9996
9996
  format data. But those formats aren\(aqt included in the default value of
9997
- \fIgzip_types\fP. The default value of \fIgzip_types\fP is \fItext/html\fP.
9997
+ \fIgzip_types\fP\&. The default value of \fIgzip_types\fP is \fItext/html\fP\&.
9998
9998
  .sp
9999
9999
  To compress response data from \fBgroonga\-httpd\fP by gzip, you need
10000
10000
  to specify \fIgzip_types *\fP or \fIgzip_types application/json text/xml
@@ -10008,11 +10008,11 @@ You can load your data by POST JSON data. You need follow the
10008
10008
  following rules to use loading by POST.
10009
10009
  .INDENT 0.0
10010
10010
  .IP \(bu 2
10011
- \fIContent\-Type\fP header value must be \fIapplication/json\fP.
10011
+ \fIContent\-Type\fP header value must be \fIapplication/json\fP\&.
10012
10012
  .IP \(bu 2
10013
10013
  JSON data is sent as body.
10014
10014
  .IP \(bu 2
10015
- Table name is specified by query parameter such as \fBtable=NAME\fP.
10015
+ Table name is specified by query parameter such as \fBtable=NAME\fP\&.
10016
10016
  .UNINDENT
10017
10017
  .sp
10018
10018
  Here is an example curl command line that loads two users \fIalice\fP and
@@ -10065,7 +10065,7 @@ grnslap [options] [dest]
10065
10065
  .sp
10066
10066
  grnslapは、groongaプロセスに対してリクエストを多重に行い、パフォーマンスをチェックするためのツールです。
10067
10067
  .sp
10068
- groonga独自プロトコルであるgqtpと、httpの両プロトコルでリクエストを行うことができます。また、リクエストの多重度を指定することができます。
10068
+ Groonga独自プロトコルであるGQTPと、httpの両プロトコルでリクエストを行うことができます。また、リクエストの多重度を指定することができます。
10069
10069
  .sp
10070
10070
  クエリの内容を標準入力から与えることができます。実稼動環境でのクエリパタンに近いクエリを標準入力に与えることによって、実稼動環境に近い状態での検証を行うことができます。
10071
10071
  .sp
@@ -10133,8 +10133,8 @@ groonga [options] [dest] [command [args]]
10133
10133
  .UNINDENT
10134
10134
  .SS 説明
10135
10135
  .sp
10136
- groongaは列指向のデータベース機能を持つ高速でスケーラブルな全文検索エンジンです。
10137
- groongaのデータベースは、groongaコマンドかCライブラリインタフェースを通して操作することができます。このマニュアルページでは、groongaコマンドの使い方について説明します。
10136
+ Groongaは列指向のデータベース機能を持つ高速でスケーラブルな全文検索エンジンです。
10137
+ Groongaのデータベースは、groongaコマンドかCライブラリインタフェースを通して操作することができます。このマニュアルページでは、groongaコマンドの使い方について説明します。
10138
10138
  .SS オプション
10139
10139
  .INDENT 0.0
10140
10140
  .TP
@@ -10777,13 +10777,13 @@ groonga サーバが動作していないか? groonga\-benchmarkは、\-i, \
10777
10777
  .sp
10778
10778
  groonga\-httpd is a program to communicate with a groonga server using
10779
10779
  the HTTP protocol. It functions as same as
10780
- \fBgroonga\-server\-http\fP. Although \fBgroonga\-server\-http\fP has
10780
+ \fBgroonga\-server\-http\fP\&. Although \fBgroonga\-server\-http\fP has
10781
10781
  limited support for HTTP with a minimal built\-in HTTP server,
10782
- groonga\-httpd has full support for HTTP with an embedded \fI\%nginx\fP. All standards\-compliance and features provided
10782
+ groonga\-httpd has full support for HTTP with an embedded \fI\%nginx\fP\&. All standards\-compliance and features provided
10783
10783
  by nginx is also available in groonga\-httpd.
10784
10784
  .sp
10785
10785
  groonga\-httpd has an Web\-based administration tool implemented with HTML and
10786
- JavaScript. You can access to it from \fI\%http://hostname:port/\fP.
10786
+ JavaScript. You can access to it from \fI\%http://hostname:port/\fP\&.
10787
10787
  .SS Synopsis
10788
10788
  .INDENT 0.0
10789
10789
  .INDENT 3.5
@@ -10873,7 +10873,7 @@ Execution example:
10873
10873
  .UNINDENT
10874
10874
  .SS Browse the administration tool
10875
10875
  .sp
10876
- Also, you can browse Web\-based administration tool at \fI\%http://localhost:10041/\fP.
10876
+ Also, you can browse Web\-based administration tool at \fI\%http://localhost:10041/\fP\&.
10877
10877
  .SS Shut down
10878
10878
  .sp
10879
10879
  Finally, to terminate the running groonga\-httpd daemon, run this:
@@ -10921,7 +10921,7 @@ groonga on | off;
10921
10921
  .UNINDENT
10922
10922
  .sp
10923
10923
  Specifies whether groonga is enabled in the \fBlocation\fP block. The
10924
- default is \fBoff\fP. You need to specify \fBon\fP to enable groonga.
10924
+ default is \fBoff\fP\&. You need to specify \fBon\fP to enable groonga.
10925
10925
  .sp
10926
10926
  Examples:
10927
10927
  .INDENT 0.0
@@ -10995,7 +10995,7 @@ nothing.
10995
10995
  If parent directory doesn\(aqt exist, parent directory is also created
10996
10996
  recursively.
10997
10997
  .sp
10998
- The default value is \fBon\fP. Normally, the value doesn\(aqt need to be
10998
+ The default value is \fBon\fP\&. Normally, the value doesn\(aqt need to be
10999
10999
  changed.
11000
11000
  .SS \fBgroonga_base_path\fP
11001
11001
  .sp
@@ -11020,7 +11020,7 @@ The same value as \fBlocation\fP name.
11020
11020
  .UNINDENT
11021
11021
  .sp
11022
11022
  Specifies the base path in URI. groonga uses
11023
- \fB/d/command?parameter1=value1&...\fP path to run \fBcommand\fP. The form
11023
+ \fB/d/command?parameter1=value1&...\fP path to run \fBcommand\fP\&. The form
11024
11024
  of path in used in groonga\-httpd but groonga\-httpd also supports
11025
11025
  \fB/other\-prefix/command?parameter1=value1&...\fP form. To support the
11026
11026
  form, groonga\-httpd removes the base path from the head of request URI
@@ -11083,8 +11083,8 @@ groonga_log_path path | off;
11083
11083
  .UNINDENT
11084
11084
  .sp
11085
11085
  Specifies groonga log path in the \fBhttp\fP, \fBserver\fP or \fBlocation\fP block. The
11086
- default is \fB/var/log/groonga/httpd/groonga.log\fP.
11087
- You can disable logging to specify \fBoff\fP.
11086
+ default is \fB/var/log/groonga/httpd/groonga.log\fP\&.
11087
+ You can disable logging to specify \fBoff\fP\&.
11088
11088
  .sp
11089
11089
  Examples:
11090
11090
  .INDENT 0.0
@@ -11124,7 +11124,7 @@ groonga_log_level none | emergency | alert | ciritical | error | warning | notic
11124
11124
  .UNINDENT
11125
11125
  .sp
11126
11126
  Specifies groonga log level in the \fBhttp\fP, \fBserver\fP or \fBlocation\fP block. The
11127
- default is \fBnotice\fP. You can disable logging by specifying \fBnone\fP as log level.
11127
+ default is \fBnotice\fP\&. You can disable logging by specifying \fBnone\fP as log level.
11128
11128
  .sp
11129
11129
  Examples:
11130
11130
  .INDENT 0.0
@@ -11165,8 +11165,8 @@ groonga_query_log_path path | off;
11165
11165
  .sp
11166
11166
  Specifies groonga\(aqs query log path in the \fBhttp\fP, \fBserver\fP or
11167
11167
  \fBlocation\fP block. The default is
11168
- \fB/var/log/groonga/httpd/groonga\-query.log\fP. You can disable logging
11169
- to specify \fBoff\fP.
11168
+ \fB/var/log/groonga/httpd/groonga\-query.log\fP\&. You can disable logging
11169
+ to specify \fBoff\fP\&.
11170
11170
  .sp
11171
11171
  Examples:
11172
11172
  .INDENT 0.0
@@ -11196,7 +11196,7 @@ Debugging.
11196
11196
  .UNINDENT
11197
11197
  .UNINDENT
11198
11198
  .sp
11199
- You can analyze your query log by \fI\%groonga\-query\-log package\fP. The package provides
11199
+ You can analyze your query log by \fI\%groonga\-query\-log package\fP\&. The package provides
11200
11200
  useful tools.
11201
11201
  .sp
11202
11202
  For example, there is a tool that analyzing your query log. It can
@@ -11213,7 +11213,7 @@ many cases, groonga queries may be CPU\-intensive work, so to fully utilize
11213
11213
  multi\-CPU/core systems, it\(aqs essential to set this accordingly.
11214
11214
  .sp
11215
11215
  This isn\(aqt a groonga\-httpd specific directive, but an nginx\(aqs one. For details,
11216
- see \fI\%http://wiki.nginx.org/CoreModule#worker_processes\fP.
11216
+ see \fI\%http://wiki.nginx.org/CoreModule#worker_processes\fP\&.
11217
11217
  .sp
11218
11218
  By default, this is set to 1. It is nginx\(aqs default.
11219
11219
  .SS \fBgroonga_cache_limit\fP
@@ -11432,7 +11432,7 @@ cache by hand. It is done automatically.
11432
11432
  All standard HTTP modules are available. HttpRewriteModule is
11433
11433
  disabled when you don\(aqt have PCRE (Perl Compatible Regular
11434
11434
  Expressions). For the list of standard HTTP modules, see
11435
- \fI\%http://wiki.nginx.org/Modules\fP.
11435
+ \fI\%http://wiki.nginx.org/Modules\fP\&.
11436
11436
  .SS groonga HTTPサーバー
11437
11437
  .SS 名前
11438
11438
  .sp
@@ -11509,9 +11509,9 @@ groonga\-suggest\-create\-dataset [options] DATABASE DATASET
11509
11509
  .UNINDENT
11510
11510
  .SS DESCTIPION
11511
11511
  .sp
11512
- groonga\-suggest\-create\-dataset creates a dataset for \fB/suggest\fP. A database has many datasets. This command just defines schema for a suggestion dataset.
11512
+ groonga\-suggest\-create\-dataset creates a dataset for \fB/suggest\fP\&. A database has many datasets. This command just defines schema for a suggestion dataset.
11513
11513
  .sp
11514
- This command generates some tables and columns for \fB/suggest\fP.
11514
+ This command generates some tables and columns for \fB/suggest\fP\&.
11515
11515
  .sp
11516
11516
  Here is the list of such tables. If you specify \(aqquery\(aq as dataset name, following \(aq_DATASET\(aq suffix are replaced. Thus, \(aqitem_query\(aq, \(aqpair_query\(aq, \(aqsequence_query\(aq, \(aqevent_query\(aq tables are generated.
11517
11517
  .INDENT 0.0
@@ -11610,7 +11610,7 @@ Specify this option to disable checking max fd on start.
11610
11610
  .UNINDENT
11611
11611
  .SS Parameters
11612
11612
  .sp
11613
- There is one required parameter \- \fBdatabase_path\fP.
11613
+ There is one required parameter \- \fBdatabase_path\fP\&.
11614
11614
  .SS \fBdatabase_path\fP
11615
11615
  .sp
11616
11616
  Specifies the path to a groonga database.
@@ -11637,7 +11637,7 @@ TODO
11637
11637
  TODO
11638
11638
  .SS Parameters
11639
11639
  .sp
11640
- There is one required parameter \- \fBdatabase_path\fP.
11640
+ There is one required parameter \- \fBdatabase_path\fP\&.
11641
11641
  .SS \fBdatabase_path\fP
11642
11642
  .sp
11643
11643
  Specifies the path to a groonga database.
@@ -11678,7 +11678,7 @@ They provides different ways to change output format type.
11678
11678
  .SS Command line
11679
11679
  .sp
11680
11680
  You can use command line query interface by \fBgroonga
11681
- DB_PATH\fP or \fBgroonga \-c\fP. Those groonga commands shows
11681
+ DB_PATH\fP or \fBgroonga \-c\fP\&. Those groonga commands shows
11682
11682
  \fB> \(ga\(ga prompt. In this query interface, you can specify
11683
11683
  output format type by \(ga\(gaoutput_type\fP option.
11684
11684
  .sp
@@ -11785,7 +11785,7 @@ get a result in MessagePack format:
11785
11785
  .SS HTTP
11786
11786
  .sp
11787
11787
  You can use HTTP query interface by \fBgroonga \-\-protocol
11788
- http \-s DB_PATH\fP. Groonga HTTP server starts on port 10041
11788
+ http \-s DB_PATH\fP\&. Groonga HTTP server starts on port 10041
11789
11789
  by default. In this query interface, you can specify
11790
11790
  output format type by extension.
11791
11791
  .sp
@@ -12133,7 +12133,7 @@ The following part is \fBBODY\fP:
12133
12133
  .UNINDENT
12134
12134
  .UNINDENT
12135
12135
  .sp
12136
- The first element is always \fB0\fP.
12136
+ The first element is always \fB0\fP\&.
12137
12137
  .sp
12138
12138
  \fBUNIX_TIME_WHEN_COMMAND_IS_STARTED\fP is the number of seconds
12139
12139
  since 1970\-01\-01 00:00:00 UTC when the command is started
@@ -12242,7 +12242,7 @@ array. \fBLOCATION_IN_GROONGA\fP has three elements:
12242
12242
  is occurred.
12243
12243
  .sp
12244
12244
  \fBLINE_CONTENT\fP is the content at \fBLINE_NUMBER\fP in
12245
- \fBINPUT_FILE_NAME\fP.
12245
+ \fBINPUT_FILE_NAME\fP\&.
12246
12246
  .SS \fBBODY\fP
12247
12247
  .sp
12248
12248
  \fBBODY\fP content depends on the executed command. It may be omitted.
@@ -12525,7 +12525,7 @@ max number of query cache entries.
12525
12525
  \fBHEADER\fP
12526
12526
  .INDENT 0.0
12527
12527
  .INDENT 3.5
12528
- See \fB/reference/command/output_format\fP about \fBHEADER\fP.
12528
+ See \fB/reference/command/output_format\fP about \fBHEADER\fP\&.
12529
12529
  .UNINDENT
12530
12530
  .UNINDENT
12531
12531
  .sp
@@ -12941,10 +12941,10 @@ There are two flags to compress the value of column, but you can\(aqt specify th
12941
12941
  .INDENT 0.0
12942
12942
  .TP
12943
12943
  .B 16, \fBCOMPRESS_ZLIB\fP
12944
- Reserved. Compress the value of column by using zlib. This flag is disabled feature even if you build groonga with \fB\-\-with\-zlib\fP.
12944
+ Reserved. Compress the value of column by using zlib. This flag is disabled feature even if you build groonga with \fB\-\-with\-zlib\fP\&.
12945
12945
  .TP
12946
12946
  .B 32, \fBCOMPRESS_LZO\fP
12947
- Reserved. Compress the value of column by using lzo. This flag is disabled feature even if you build groonga with \fB\-\-with\-lzo\fP.
12947
+ Reserved. Compress the value of column by using lzo. This flag is disabled feature even if you build groonga with \fB\-\-with\-lzo\fP\&.
12948
12948
  .UNINDENT
12949
12949
  .sp
12950
12950
  インデックス型のカラムについては、flagsの値に以下の値を加えることによって、追加の属
@@ -13372,10 +13372,10 @@ select Users
13372
13372
  .UNINDENT
13373
13373
  .SS Parameters
13374
13374
  .sp
13375
- This section describes parameters of \fBcolumn_rename\fP.
13375
+ This section describes parameters of \fBcolumn_rename\fP\&.
13376
13376
  .SS Required parameter
13377
13377
  .sp
13378
- There are required parameters, \fBtable_name\fP and \fBcolumn_name\fP.
13378
+ There are required parameters, \fBtable_name\fP and \fBcolumn_name\fP\&.
13379
13379
  .SS \fBtable_name\fP
13380
13380
  .sp
13381
13381
  It specifies the name of table.
@@ -14044,7 +14044,7 @@ If you specify "json" as \fBinput_type\fP, you can choose a format from below:
14044
14044
  .sp
14045
14045
  \fB[COLUMN_NAME1, COLUMN_NAME2,..]\fP format in \fBFormat 1\fP is effective only when \fBcolumn\fP parameter isn\(aqt specified.
14046
14046
  .sp
14047
- When a target table contains primary key, you must specify \fB_key\fP column (pseudo column associated primary key) as the one of \fBCOLUMN_NAME\fP.
14047
+ When a target table contains primary key, you must specify \fB_key\fP column (pseudo column associated primary key) as the one of \fBCOLUMN_NAME\fP\&.
14048
14048
  .sp
14049
14049
  If \fBvalues\fP isn\(aqt specified any values, they are read from the standard input until all opened parenthes match their closed ones.
14050
14050
  You don\(aqt have to enclose them with single\-quotes or double\-quotes, but if you specified values with \fBvalues\fP parameter, you should do.
@@ -14081,7 +14081,7 @@ column) columns is updated.
14081
14081
  \fBinput_type\fP
14082
14082
  .INDENT 0.0
14083
14083
  .INDENT 3.5
14084
- It specifies an input format for \fBvalues\fP. It supports JSON only.
14084
+ It specifies an input format for \fBvalues\fP\&. It supports JSON only.
14085
14085
  .UNINDENT
14086
14086
  .UNINDENT
14087
14087
  .SS Usage
@@ -14383,7 +14383,7 @@ It is useful for you to check the results of normalizer.
14383
14383
  .SS Syntax
14384
14384
  .sp
14385
14385
  \fBnormalize\fP commands has two required parameters. They are
14386
- \fBnormalizer\fP and \fBstring\fP.
14386
+ \fBnormalizer\fP and \fBstring\fP\&.
14387
14387
  .INDENT 0.0
14388
14388
  .INDENT 3.5
14389
14389
  .sp
@@ -14424,14 +14424,14 @@ normalize NormalizerAuto "aBcDe 123"
14424
14424
  .UNINDENT
14425
14425
  .SS Parameters
14426
14426
  .sp
14427
- This section describes parameters of \fBnormalizer\fP.
14427
+ This section describes parameters of \fBnormalizer\fP\&.
14428
14428
  .SS Required parameter
14429
14429
  .sp
14430
- There are required parameters, \fBnormalizer\fP and \fBstring\fP.
14430
+ There are required parameters, \fBnormalizer\fP and \fBstring\fP\&.
14431
14431
  .SS \fBnormalizer\fP
14432
14432
  .sp
14433
14433
  It specifies the normalizer name. \fBnormalize\fP command uses the
14434
- normalizer that is named \fBnormalizer\fP.
14434
+ normalizer that is named \fBnormalizer\fP\&.
14435
14435
  .sp
14436
14436
  See \fB/reference/normalizers\fP about built\-in normalizers.
14437
14437
  .sp
@@ -14441,7 +14441,7 @@ TODO
14441
14441
  .sp
14442
14442
  If you want to use other normalizers, you need to register additional
14443
14443
  normalizer plugin by \fBregister\fP command. For example, you can use
14444
- MySQL compatible normalizer by registering \fI\%groonga\-normalizer\-mysql\fP.
14444
+ MySQL compatible normalizer by registering \fI\%groonga\-normalizer\-mysql\fP\&.
14445
14445
  .SS \fBstring\fP
14446
14446
  .sp
14447
14447
  It specifies any string which you want to normalize.
@@ -14449,7 +14449,7 @@ It specifies any string which you want to normalize.
14449
14449
  If you want to include spaces in \fBstring\fP, you need to quote
14450
14450
  \fBstring\fP by single quotation (\fB\(aq\fP) or double quotation (\fB"\fP).
14451
14451
  .sp
14452
- Here is an example to use spaces in \fBstring\fP.
14452
+ Here is an example to use spaces in \fBstring\fP\&.
14453
14453
  .sp
14454
14454
  TODO
14455
14455
  .SS Optional parameters
@@ -14459,7 +14459,7 @@ There are optional parameters.
14459
14459
  .sp
14460
14460
  It specifies a normalization customize options. You can specify
14461
14461
  multiple options separated by "\fB|\fP". For example,
14462
- \fBREMOVE_BLANK|WITH_TYPES\fP.
14462
+ \fBREMOVE_BLANK|WITH_TYPES\fP\&.
14463
14463
  .sp
14464
14464
  Here are available flags.
14465
14465
  .TS
@@ -14504,15 +14504,15 @@ T}
14504
14504
  _
14505
14505
  .TE
14506
14506
  .sp
14507
- Here is an example that uses \fBREMOVE_BLANK\fP.
14507
+ Here is an example that uses \fBREMOVE_BLANK\fP\&.
14508
14508
  .sp
14509
14509
  TODO
14510
14510
  .sp
14511
- Here is an example that uses \fBWITH_TYPES\fP.
14511
+ Here is an example that uses \fBWITH_TYPES\fP\&.
14512
14512
  .sp
14513
14513
  TODO
14514
14514
  .sp
14515
- Here is an example that uses \fBREMOVE_TOKENIZED_DELIMITER\fP.
14515
+ Here is an example that uses \fBREMOVE_TOKENIZED_DELIMITER\fP\&.
14516
14516
  .sp
14517
14517
  TODO
14518
14518
  .SS Return value
@@ -14559,7 +14559,7 @@ T{
14559
14559
  \fBtypes\fP
14560
14560
  T} T{
14561
14561
  An array of types of the normalized text. The N\-th \fBtypes\fP shows
14562
- the type of the N\-th character in \fBnormalized\fP.
14562
+ the type of the N\-th character in \fBnormalized\fP\&.
14563
14563
  T}
14564
14564
  _
14565
14565
  .TE
@@ -14626,7 +14626,7 @@ Registered plugins can\(aqt be removed for now.
14626
14626
  .UNINDENT
14627
14627
  .SS Syntax
14628
14628
  .sp
14629
- \fBregister\fP has a parameter \fBpath\fP. It is required parameter:
14629
+ \fBregister\fP has a parameter \fBpath\fP\&. It is required parameter:
14630
14630
  .INDENT 0.0
14631
14631
  .INDENT 3.5
14632
14632
  .sp
@@ -14641,7 +14641,7 @@ register path
14641
14641
  .sp
14642
14642
  Here is a sample that registers \fBQueryExpanderTSV\fP query expander
14643
14643
  that is included in
14644
- \fB${PREFIX}/lib/groonga/plugins/query_expanders/tsv.so\fP.
14644
+ \fB${PREFIX}/lib/groonga/plugins/query_expanders/tsv.so\fP\&.
14645
14645
  .sp
14646
14646
  Execution example:
14647
14647
  .INDENT 0.0
@@ -14656,11 +14656,11 @@ register query_expanders/tsv
14656
14656
  .UNINDENT
14657
14657
  .UNINDENT
14658
14658
  .sp
14659
- You can omit \fB${PREFIX}/lib/groonga/plugins/\fP and suffix (\fB.so\fP).
14659
+ You can omit \fB${PREFIX}/lib/groonga/plugins/\fP and suffix (\fB\&.so\fP).
14660
14660
  They are completed automatically.
14661
14661
  .sp
14662
14662
  You can specify absolute path such as \fBregister
14663
- /usr/lib/groonga/plugins/query_expanders/tsv.so\fP.
14663
+ /usr/lib/groonga/plugins/query_expanders/tsv.so\fP\&.
14664
14664
  .SS Return value
14665
14665
  .sp
14666
14666
  \fBregister\fP returns \fBtrue\fP as body on success such as:
@@ -14675,9 +14675,9 @@ You can specify absolute path such as \fBregister
14675
14675
  .UNINDENT
14676
14676
  .UNINDENT
14677
14677
  .sp
14678
- If \fBregister\fP fails, error details are in \fBHEADER\fP.
14678
+ If \fBregister\fP fails, error details are in \fBHEADER\fP\&.
14679
14679
  .sp
14680
- See \fB/reference/command/output_format\fP for \fBHEADER\fP.
14680
+ See \fB/reference/command/output_format\fP for \fBHEADER\fP\&.
14681
14681
  .SS \fBruby_eval\fP
14682
14682
  .SS Summary
14683
14683
  .sp
@@ -14697,7 +14697,7 @@ ruby_eval script
14697
14697
  .UNINDENT
14698
14698
  .SS Usage
14699
14699
  .sp
14700
- You can execute any scripts which mruby supports by calling \fBruby_eval\fP.
14700
+ You can execute any scripts which mruby supports by calling \fBruby_eval\fP\&.
14701
14701
  .sp
14702
14702
  Here is an example that just calculate \fB1 + 2\fP as Ruby script.
14703
14703
  .sp
@@ -14744,14 +14744,14 @@ exception information (Including metadata isn\(aqt implemented yet):
14744
14744
  \fBHEADER\fP
14745
14745
  .INDENT 0.0
14746
14746
  .INDENT 3.5
14747
- See \fB/reference/command/output_format\fP about \fBHEADER\fP.
14747
+ See \fB/reference/command/output_format\fP about \fBHEADER\fP\&.
14748
14748
  .UNINDENT
14749
14749
  .UNINDENT
14750
14750
  .sp
14751
14751
  \fBEVALUATED_VALUE\fP
14752
14752
  .INDENT 0.0
14753
14753
  .INDENT 3.5
14754
- \fBEVALUATED_VALUE\fP is the evaludated value of \fBruby_script\fP.
14754
+ \fBEVALUATED_VALUE\fP is the evaludated value of \fBruby_script\fP\&.
14755
14755
  .sp
14756
14756
  \fBruby_eval\fP supports only a number for evaluated value for now.
14757
14757
  Supported types will be increased in the future.
@@ -14777,7 +14777,7 @@ ruby_load path
14777
14777
  .UNINDENT
14778
14778
  .SS Usage
14779
14779
  .sp
14780
- You can load any script file which mruby supports by calling \fBruby_load\fP.
14780
+ You can load any script file which mruby supports by calling \fBruby_load\fP\&.
14781
14781
  .sp
14782
14782
  Here is an example that just load \fBexpression.rb\fP as Ruby script.
14783
14783
  .sp
@@ -14824,7 +14824,7 @@ exception information (Including metadata isn\(aqt implemented yet):
14824
14824
  \fBHEADER\fP
14825
14825
  .INDENT 0.0
14826
14826
  .INDENT 3.5
14827
- See \fB/reference/command/output_format\fP about \fBHEADER\fP.
14827
+ See \fB/reference/command/output_format\fP about \fBHEADER\fP\&.
14828
14828
  .UNINDENT
14829
14829
  .UNINDENT
14830
14830
  .sp
@@ -14930,7 +14930,7 @@ load \-\-table Entries
14930
14930
  .sp
14931
14931
  There is a table, \fBEntries\fP, for blog entries. An entry has title,
14932
14932
  content and the number of likes for the entry. Title is key of
14933
- \fBEntries\fP. Content is value of \fBEntries.content\fP column. The
14933
+ \fBEntries\fP\&. Content is value of \fBEntries.content\fP column. The
14934
14934
  number of likes is value of \fBEntries.n_likes\fP column.
14935
14935
  .sp
14936
14936
  \fBEntries._key\fP column and \fBEntries.content\fP column are indexed
@@ -15025,15 +15025,15 @@ command outputs 10 records at a maximum by default. There are only 5
15025
15025
  records. It is less than 10. So the command outputs all records.
15026
15026
  .SS Search conditions
15027
15027
  .sp
15028
- Search conditions are specified by \fBquery\fP or \fBfilter\fP. You can
15029
- also specify both \fBquery\fP and \fBfilter\fP. It means that selected
15030
- records must be matched against both \fBquery\fP and \fBfilter\fP.
15028
+ Search conditions are specified by \fBquery\fP or \fBfilter\fP\&. You can
15029
+ also specify both \fBquery\fP and \fBfilter\fP\&. It means that selected
15030
+ records must be matched against both \fBquery\fP and \fBfilter\fP\&.
15031
15031
  .SS Search condition: \fBquery\fP
15032
15032
  .sp
15033
15033
  \fBquery\fP is designed for search box in Web page. Imagine a search box
15034
15034
  in google.com. You specify search conditions for \fBquery\fP as space
15035
15035
  separated keywords. For example, \fBsearch engine\fP means a matched
15036
- record should contain two words, \fBsearch\fP and \fBengine\fP.
15036
+ record should contain two words, \fBsearch\fP and \fBengine\fP\&.
15037
15037
  .sp
15038
15038
  Normally, \fBquery\fP parameter is used for specifying fulltext search
15039
15039
  conditions. It can be used for non fulltext search conditions but
@@ -15042,7 +15042,7 @@ conditions. It can be used for non fulltext search conditions but
15042
15042
  \fBquery\fP parameter is used with \fBmatch_columns\fP parameter when
15043
15043
  \fBquery\fP parameter is used for specifying fulltext search
15044
15044
  conditions. \fBmatch_columns\fP specifies which columnes and indexes are
15045
- matched against \fBquery\fP.
15045
+ matched against \fBquery\fP\&.
15046
15046
  .sp
15047
15047
  Here is a simple \fBquery\fP usage example.
15048
15048
  .sp
@@ -15167,7 +15167,7 @@ select Entries \-\-filter \(aqcontent @ "fast" && _key == "Groonga"\(aq
15167
15167
  The \fBselect\fP command searches records that contain a word \fBfast\fP
15168
15168
  in \fBcontent\fP column value and has \fBGroonga\fP as \fB_key\fP from
15169
15169
  \fBEntries\fP table. There are three operators in the command, \fB@\fP,
15170
- \fB&&\fP and \fB==\fP. \fB@\fP is fulltext search operator. \fB&&\fP and
15170
+ \fB&&\fP and \fB==\fP\&. \fB@\fP is fulltext search operator. \fB&&\fP and
15171
15171
  \fB==\fP are the same as ECMAScript. \fB&&\fP is logical AND operator and
15172
15172
  \fB==\fP is equality operator.
15173
15173
  .sp
@@ -15176,7 +15176,7 @@ its deatils aren\(aqt described here. See \fB/reference/grn_expr/script_syntax\f
15176
15176
  datails.
15177
15177
  .SS Paging
15178
15178
  .sp
15179
- You can specify range of outputted records by \fBoffset\fP and \fBlimit\fP.
15179
+ You can specify range of outputted records by \fBoffset\fP and \fBlimit\fP\&.
15180
15180
  Here is an example to output only the 2nd record.
15181
15181
  .sp
15182
15182
  Execution example:
@@ -15291,7 +15291,7 @@ records.
15291
15291
  This section describes all parameters. Parameters are categorized.
15292
15292
  .SS Required parameter
15293
15293
  .sp
15294
- There is a required parameter, \fBtable\fP.
15294
+ There is a required parameter, \fBtable\fP\&.
15295
15295
  .SS \fBtable\fP
15296
15296
  .sp
15297
15297
  It specifies a table to be searched. \fBtable\fP must be specified.
@@ -15332,7 +15332,7 @@ box. \fBfilter\fP parameters is used for implementing complex search
15332
15332
  feature.
15333
15333
  .sp
15334
15334
  If both \fBquery\fP and \fBfilter\fP are specified, selected records must
15335
- be matched against both \fBquery\fP and \fBfilter\fP. If both \fBquery\fP
15335
+ be matched against both \fBquery\fP and \fBfilter\fP\&. If both \fBquery\fP
15336
15336
  and \fBfilter\fP aren\(aqt specified, all records are selected.
15337
15337
  .SS \fBmatch_columns\fP
15338
15338
  .sp
@@ -15400,7 +15400,7 @@ records.
15400
15400
  .sp
15401
15401
  Pay attention to \fB_score\fP value. \fB_score\fP value is the number of
15402
15402
  matched counts against \fBquery\fP parameter value. In the example,
15403
- \fBquery\fP parameter value is \fBfast\fP. The fact that \fB_score\fP value
15403
+ \fBquery\fP parameter value is \fBfast\fP\&. The fact that \fB_score\fP value
15404
15404
  is 1 means that \fBfast\fP appers in \fBcontent\fP column only once. The
15405
15405
  fact that \fB_score\fP value is 2 means that \fBfast\fP appears in
15406
15406
  \fBcontent\fP column twice.
@@ -15520,11 +15520,11 @@ of blog entry is more important rather thatn content of blog entry.
15520
15520
  It specifies the query text. Normally, it is used for fulltext search
15521
15521
  with \fBmatch_columns\fP parameter. \fBquery\fP parameter is designed for
15522
15522
  a fulltext search form in a Web page. A query text should be formatted
15523
- in \fB/reference/grn_expr/query_syntax\fP. The syntax is similar to common search
15523
+ in \fB/reference/grn_expr/query_syntax\fP\&. The syntax is similar to common search
15524
15524
  form like Google\(aqs search form. For example, \fBword1 word2\fP means
15525
15525
  that groonga searches records that contain both \fBword1\fP and
15526
- \fBword2\fP. \fBword1 OR word2\fP means that groogna searches records that
15527
- contain either \fBword1\fP or \fBword2\fP.
15526
+ \fBword2\fP\&. \fBword1 OR word2\fP means that groogna searches records that
15527
+ contain either \fBword1\fP or \fBword2\fP\&.
15528
15528
  .sp
15529
15529
  Here is a simple logical and search example.
15530
15530
  .sp
@@ -15648,8 +15648,8 @@ See \fB/reference/grn_expr/query_syntax\fP for other syntax.
15648
15648
  .sp
15649
15649
  It can be used for not only fulltext search but also other
15650
15650
  conditions. For example, \fBcolumn:value\fP means the value of
15651
- \fBcolumn\fP column is equal to \fBvalue\fP. \fBcolumn:<value\fP means the
15652
- value of \fBcolumn\fP column is less than \fBvalue\fP.
15651
+ \fBcolumn\fP column is equal to \fBvalue\fP\&. \fBcolumn:<value\fP means the
15652
+ value of \fBcolumn\fP column is less than \fBvalue\fP\&.
15653
15653
  .sp
15654
15654
  Here is a simple equality operator search example.
15655
15655
  .sp
@@ -15786,14 +15786,14 @@ It specifies the filter text. Normally, it is used for complex search
15786
15786
  conditions. \fBfilter\fP can be used with \fBquery\fP parameter. If both
15787
15787
  \fBfilter\fP and \fBquery\fP are specified, there are conbined with
15788
15788
  logical and. It means that matched records should be matched against
15789
- both \fBfilter\fP and \fBquery\fP.
15789
+ both \fBfilter\fP and \fBquery\fP\&.
15790
15790
  .sp
15791
15791
  \fBfilter\fP parameter is designed for complex conditions. A filter text
15792
- should be formated in \fB/reference/grn_expr/script_syntax\fP. The syntax is
15792
+ should be formated in \fB/reference/grn_expr/script_syntax\fP\&. The syntax is
15793
15793
  similar to ECMAScript. For example, \fBcolumn == "value"\fP means that
15794
- the value of \fBcolumn\fP column is equal to \fB"value"\fP. \fBcolumn <
15794
+ the value of \fBcolumn\fP column is equal to \fB"value"\fP\&. \fBcolumn <
15795
15795
  value\fP means that the value of \fBcolumn\fP column is less than
15796
- \fBvalue\fP.
15796
+ \fBvalue\fP\&.
15797
15797
  .sp
15798
15798
  Here is a simple equality operator search example.
15799
15799
  .sp
@@ -16042,9 +16042,9 @@ select Entries \-\-match_columns content \-\-query groo \-\-match_escalation_thr
16042
16042
  The first \fBselect\fP command searches records that contain a word
16043
16043
  \fBgroo\fP in \fBcontent\fP column value from \fBEntries\fP table. But no
16044
16044
  records are matched because the \fBTokenBigram\fP tokenizer tokenizes
16045
- \fBgroonga\fP to \fBgroonga\fP not \fBgr|ro|oo|on|ng|ga\fP. (The
16045
+ \fBgroonga\fP to \fBgroonga\fP not \fBgr|ro|oo|on|ng|ga\fP\&. (The
16046
16046
  \fBTokenBigramSplitSymbolAlpha\fP tokenizer tokenizes \fBgroonga\fP to
16047
- \fBgr|ro|oo|on|ng|ga\fP. See \fB/reference/tokenizers\fP for details.)
16047
+ \fBgr|ro|oo|on|ng|ga\fP\&. See \fB/reference/tokenizers\fP for details.)
16048
16048
  It means that \fBgroonga\fP is indexed but \fBgroo\fP isn\(aqt indexed. So no
16049
16049
  records are matched against \fBgroo\fP by exact match. In the case, the
16050
16050
  search storategy escalation is used because the number of matched
@@ -16065,7 +16065,7 @@ Deprecated. Use \fIquery\-expander\fP instead.
16065
16065
  It customs \fBquery\fP parameter syntax. You cannot update column value
16066
16066
  by \fBquery\fP parameter by default. But if you specify
16067
16067
  \fBALLOW_COLUMN|ALLOW_UPDATE\fP as \fBquery_flags\fP, you can update
16068
- column value by \fBquery\fP.
16068
+ column value by \fBquery\fP\&.
16069
16069
  .sp
16070
16070
  Here are available values:
16071
16071
  .INDENT 0.0
@@ -16081,11 +16081,11 @@ Here are available values:
16081
16081
  \fBNONE\fP
16082
16082
  .UNINDENT
16083
16083
  .sp
16084
- \fBALLOW_PRAGMA\fP enables pragma at the head of \fBquery\fP. This is not
16084
+ \fBALLOW_PRAGMA\fP enables pragma at the head of \fBquery\fP\&. This is not
16085
16085
  implemented yet.
16086
16086
  .sp
16087
16087
  \fBALLOW_COLUMN\fP enables search againt columns that are not included
16088
- in \fBmatch_columns\fP. To specify column, there are \fBCOLUMN:...\fP
16088
+ in \fBmatch_columns\fP\&. To specify column, there are \fBCOLUMN:...\fP
16089
16089
  syntaxes.
16090
16090
  .sp
16091
16091
  \fBALLOW_UPDATE\fP enables column update by \fBquery\fP with
@@ -16094,18 +16094,18 @@ update column because the column update syntax specifies column.
16094
16094
  .sp
16095
16095
  \fBALLOW_LEADING_NOT\fP enables leading NOT condition with \fB\-WORD\fP
16096
16096
  syntax. The query searches records that doesn\(aqt match
16097
- \fBWORD\fP. Leading NOT condition query is heavy query in many cases
16097
+ \fBWORD\fP\&. Leading NOT condition query is heavy query in many cases
16098
16098
  because it matches many records. So this flag is disabled by
16099
16099
  default. Be careful about it when you use the flag.
16100
16100
  .sp
16101
16101
  \fBNONE\fP is just ignores. You can use \fBNONE\fP for specifying no flags.
16102
16102
  .sp
16103
16103
  They can be combined by separated \fB|\fP such as
16104
- \fBALLOW_COLUMN|ALLOW_UPDATE\fP.
16104
+ \fBALLOW_COLUMN|ALLOW_UPDATE\fP\&.
16105
16105
  .sp
16106
- The default value is \fBALLOW_PRAGMA|ALLOW_COLUMN\fP.
16106
+ The default value is \fBALLOW_PRAGMA|ALLOW_COLUMN\fP\&.
16107
16107
  .sp
16108
- Here is a usage example of \fBALLOW_COLUMN\fP.
16108
+ Here is a usage example of \fBALLOW_COLUMN\fP\&.
16109
16109
  .sp
16110
16110
  Execution example:
16111
16111
  .INDENT 0.0
@@ -16160,7 +16160,7 @@ select Entries \-\-query content:@mroonga \-\-query_flags ALLOW_COLUMN
16160
16160
  The \fBselect\fP command searches records that contain \fBmroonga\fP in
16161
16161
  \fBcontent\fP column value from \fBEntries\fP table.
16162
16162
  .sp
16163
- Here is a usage example of \fBALLOW_UPDATE\fP.
16163
+ Here is a usage example of \fBALLOW_UPDATE\fP\&.
16164
16164
  .sp
16165
16165
  Execution example:
16166
16166
  .INDENT 0.0
@@ -16262,10 +16262,10 @@ select Users
16262
16262
  .UNINDENT
16263
16263
  .sp
16264
16264
  The first \fBselect\fP command sets \fBage\fP column value of all records
16265
- to \fB19\fP. The second \fBselect\fP command outputs updated \fBage\fP
16265
+ to \fB19\fP\&. The second \fBselect\fP command outputs updated \fBage\fP
16266
16266
  column values.
16267
16267
  .sp
16268
- Here is a usage example of \fBALLOW_LEADING_NOT\fP.
16268
+ Here is a usage example of \fBALLOW_LEADING_NOT\fP\&.
16269
16269
  .sp
16270
16270
  Execution example:
16271
16271
  .INDENT 0.0
@@ -16338,7 +16338,7 @@ select Entries \-\-match_columns content \-\-query \-mroonga \-\-query_flags ALL
16338
16338
  The \fBselect\fP command searches records that don\(aqt contain \fBmroonga\fP
16339
16339
  in \fBcontent\fP column value from \fBEntries\fP table.
16340
16340
  .sp
16341
- Here is a usage example of \fBNONE\fP.
16341
+ Here is a usage example of \fBNONE\fP\&.
16342
16342
  .sp
16343
16343
  Execution example:
16344
16344
  .INDENT 0.0
@@ -16393,10 +16393,10 @@ select Entries \-\-match_columns content \-\-query \(aqmroonga OR _key:Groonga\(
16393
16393
  The \fBselect\fP command searches records that contain one of two words
16394
16394
  \fBmroonga\fP or \fB_key:Groonga\fP in \fBcontent\fP from \fBEntries\fP table.
16395
16395
  Note that \fB_key:Groonga\fP doesn\(aqt mean that the value of \fB_key\fP
16396
- column is equal to \fBGroonga\fP. Because \fBALLOW_COLUMN\fP flag is not
16396
+ column is equal to \fBGroonga\fP\&. Because \fBALLOW_COLUMN\fP flag is not
16397
16397
  specified.
16398
16398
  .sp
16399
- See also \fB/reference/grn_expr/query_syntax\fP.
16399
+ See also \fB/reference/grn_expr/query_syntax\fP\&.
16400
16400
  .SS \fBquery_expander\fP
16401
16401
  .sp
16402
16402
  It\(aqs for query expansion. Query expansion substitutes specific words
@@ -16408,13 +16408,13 @@ value. The format of this parameter value is
16408
16408
  \fBsynonym\fP column in \fBTerms\fP table.
16409
16409
  .sp
16410
16410
  Table for query expansion is called "substitution table". Substitution
16411
- table\(aqs key must be \fBShortText\fP. So array table (\fBTABLE_NO_KEY\fP)
16411
+ table\(aqs key must be \fBShortText\fP\&. So array table (\fBTABLE_NO_KEY\fP)
16412
16412
  can\(aqt be used for query expansion. Because array table doesn\(aqt have
16413
16413
  key.
16414
16414
  .sp
16415
16415
  Column for query expansion is called "substitution
16416
16416
  column". Substitution column\(aqs value type must be
16417
- \fBShortText\fP. Column type must be vector (\fBCOLUMN_VECTOR\fP).
16417
+ \fBShortText\fP\&. Column type must be vector (\fBCOLUMN_VECTOR\fP).
16418
16418
  .sp
16419
16419
  Query expansion substitutes key of substitution table in query with
16420
16420
  values in substitution column. If a word in \fBquery\fP is a key of
@@ -16448,15 +16448,15 @@ load \-\-table Thesaurus
16448
16448
  .UNINDENT
16449
16449
  .sp
16450
16450
  \fBThesaurus\fP substitution table has two synonyms, \fB"mroonga"\fP and
16451
- \fB"groonga"\fP. If an user searches with \fB"mroonga"\fP, groonga
16452
- searches with \fB"((mroonga) OR (tritonn) OR (groonga mysql))"\fP. If an
16451
+ \fB"groonga"\fP\&. If an user searches with \fB"mroonga"\fP, groonga
16452
+ searches with \fB"((mroonga) OR (tritonn) OR (groonga mysql))"\fP\&. If an
16453
16453
  user searches with \fB"groonga"\fP, groonga searches with \fB"((groonga)
16454
- OR (senna))"\fP. Nomrally, it\(aqs good idea that substitution table has
16454
+ OR (senna))"\fP\&. Nomrally, it\(aqs good idea that substitution table has
16455
16455
  \fBKEY_NORMALIZE\fP flag. If the flag is used, substitute target word is
16456
16456
  matched in case insensitive manner.
16457
16457
  .sp
16458
16458
  Note that those synonym values include the key value such as
16459
- \fB"mroonga"\fP and \fB"groonga"\fP. It\(aqs recommended that you include the
16459
+ \fB"mroonga"\fP and \fB"groonga"\fP\&. It\(aqs recommended that you include the
16460
16460
  key value. If you don\(aqt include key value, substituted value doesn\(aqt
16461
16461
  include the original substitute target value. Normally, including the
16462
16462
  original value is better search result. If you have a word that you
@@ -16613,7 +16613,7 @@ third \fBselect\fP command doesn\(aqt use query expansion but it is same as
16613
16613
  the second \fBselect\fP command. The third one uses expanded query.
16614
16614
  .sp
16615
16615
  Each substitute value can contain any \fB/reference/grn_expr/query_syntax\fP syntax
16616
- such as \fB(...)\fP and \fBOR\fP. You can use complex substitution by
16616
+ such as \fB(...)\fP and \fBOR\fP\&. You can use complex substitution by
16617
16617
  using those syntax.
16618
16618
  .sp
16619
16619
  Here is a complex substitution usage example that uses query syntax.
@@ -16679,8 +16679,8 @@ select Entries \-\-match_columns content \-\-query "popular" \-\-query_expander
16679
16679
  .UNINDENT
16680
16680
  .UNINDENT
16681
16681
  .sp
16682
- The \fBload\fP command registers a new synonym \fB"popular"\fP. It is
16683
- substituted with \fB((popular) OR (n_likes:>=10))\fP. The substituted
16682
+ The \fBload\fP command registers a new synonym \fB"popular"\fP\&. It is
16683
+ substituted with \fB((popular) OR (n_likes:>=10))\fP\&. The substituted
16684
16684
  query means that "popular" is containing the word "popular" or 10 or
16685
16685
  more liked entries.
16686
16686
  .sp
@@ -16689,7 +16689,7 @@ is equal to or more than \fB10\fP from \fBEntries\fP table.
16689
16689
  .SS Output related parameters
16690
16690
  .SS \fBoutput_columns\fP
16691
16691
  .sp
16692
- It specifies output columns separated by \fB,\fP.
16692
+ It specifies output columns separated by \fB,\fP\&.
16693
16693
  .sp
16694
16694
  Here is a simple \fBoutput_columns\fP usage example.
16695
16695
  .sp
@@ -16737,7 +16737,7 @@ The \fBselect\fP command just outputs \fB_id\fP and \fB_key\fP column
16737
16737
  values.
16738
16738
  .sp
16739
16739
  \fB*\fP is a special value. It means that all columns that are not
16740
- \fB/reference/pseudo_column\fP.
16740
+ \fB/reference/pseudo_column\fP\&.
16741
16741
  .sp
16742
16742
  Here is a \fB*\fP usage example.
16743
16743
  .sp
@@ -16790,11 +16790,11 @@ The \fBselect\fP command outputs \fB_key\fP pseudo column, \fBcontent\fP
16790
16790
  column and \fBn_likes\fP column values but doesn\(aqt output \fB_id\fP pseudo
16791
16791
  column value.
16792
16792
  .sp
16793
- The default value is \fB_id, _key, *\fP. It means that all column
16793
+ The default value is \fB_id, _key, *\fP\&. It means that all column
16794
16794
  values except \fB_score\fP are outputted.
16795
16795
  .SS \fBsortby\fP
16796
16796
  .sp
16797
- It specifies sort keys separated by \fB,\fP. Each sort key is column
16797
+ It specifies sort keys separated by \fB,\fP\&. Each sort key is column
16798
16798
  name.
16799
16799
  .sp
16800
16800
  Here is a simple \fBsortby\fP usage example.
@@ -16957,7 +16957,7 @@ select Entries \-\-sortby \(aq\-n_likes, _id\(aq
16957
16957
  .UNINDENT
16958
16958
  .sp
16959
16959
  The \fBselect\fP command sorts by \fBn_likes\fP column value in descending
16960
- order. But ascending order is used for sorting by \fB_id\fP.
16960
+ order. But ascending order is used for sorting by \fB_id\fP\&.
16961
16961
  .sp
16962
16962
  You can use \fB_score\fP pseudo column in \fBsortby\fP if you use
16963
16963
  \fBquery\fP or \fBfilter\fP parameter.
@@ -17058,7 +17058,7 @@ select Entries \-\-sortby _id \-\-offset 3 \-\-output_columns _key
17058
17058
  The \fBselect\fP command outputs from the 4th record.
17059
17059
  .sp
17060
17060
  You can specify negative value. It means that \fBthe number of matched
17061
- records + offset\fP. If you have 3 matched records and specify
17061
+ records + offset\fP\&. If you have 3 matched records and specify
17062
17062
  \fB\-\-offset \-2\fP, you get records from the 1st (\fB3 + \-2 = 1\fP) record
17063
17063
  to the 3rd record.
17064
17064
  .sp
@@ -17101,9 +17101,9 @@ select Entries \-\-sortby _id \-\-offset \-2 \-\-output_columns _key
17101
17101
  .UNINDENT
17102
17102
  .sp
17103
17103
  The \fBselect\fP command outputs from the 4th record because the total
17104
- number of records is \fB5\fP.
17104
+ number of records is \fB5\fP\&.
17105
17105
  .sp
17106
- The default value is \fB0\fP.
17106
+ The default value is \fB0\fP\&.
17107
17107
  .SS \fBlimit\fP
17108
17108
  .sp
17109
17109
  It specifies the max number of output records. If the number of
@@ -17155,7 +17155,7 @@ select Entries \-\-sortby _id \-\-offset 2 \-\-limit 3 \-\-output_columns _key
17155
17155
  The \fBselect\fP command outputs the 3rd, the 4th and the 5th records.
17156
17156
  .sp
17157
17157
  You can specify negative value. It means that \fBthe number of matched
17158
- records + limit + 1\fP. For example, \fB\-\-limit \-1\fP outputs all
17158
+ records + limit + 1\fP\&. For example, \fB\-\-limit \-1\fP outputs all
17159
17159
  records. It\(aqs very useful value to show all records.
17160
17160
  .sp
17161
17161
  Here is a simple negative \fBlimit\fP value usage example.
@@ -17236,7 +17236,7 @@ select Entries \-\-limit \-1
17236
17236
  .sp
17237
17237
  The \fBselect\fP command outputs all records.
17238
17238
  .sp
17239
- The default value is \fB10\fP.
17239
+ The default value is \fB10\fP\&.
17240
17240
  .SS \fBscorer\fP
17241
17241
  .sp
17242
17242
  TODO: write in English and add example.
@@ -17599,7 +17599,7 @@ The suggest command does suggestion.
17599
17599
  .UNINDENT
17600
17600
  .UNINDENT
17601
17601
  .sp
17602
- You can specify one or more types separated by \fB|\fP.
17602
+ You can specify one or more types separated by \fB|\fP\&.
17603
17603
  Here are examples:
17604
17604
  .INDENT 7.0
17605
17605
  .INDENT 3.5
@@ -17698,7 +17698,7 @@ It specifies number of returned records.
17698
17698
  .TP
17699
17699
  .B \fBfrequency_threshold\fP
17700
17700
  It specifies threshold for item frequency. Returned records must have
17701
- \fB_score\fP that is greater than or equal to \fBfrequency_threshold\fP.
17701
+ \fB_score\fP that is greater than or equal to \fBfrequency_threshold\fP\&.
17702
17702
  .INDENT 7.0
17703
17703
  .TP
17704
17704
  .B Default:
@@ -17714,7 +17714,7 @@ probability. Conditional probability is used for learned
17714
17714
  data. It is probability of query submission when \fBquery\fP
17715
17715
  is occurred. Returned records must have conditional
17716
17716
  probability that is greater than or equal to
17717
- \fBconditional_probability_threshold\fP.
17717
+ \fBconditional_probability_threshold\fP\&.
17718
17718
  .INDENT 0.0
17719
17719
  .TP
17720
17720
  .B Default:
@@ -17802,7 +17802,7 @@ Here is a returned JSON format:
17802
17802
  \fBtype\fP
17803
17803
  .INDENT 0.0
17804
17804
  .INDENT 3.5
17805
- A type specified by \fBtypes\fP.
17805
+ A type specified by \fBtypes\fP\&.
17806
17806
  .UNINDENT
17807
17807
  .UNINDENT
17808
17808
  .sp
@@ -17816,7 +17816,7 @@ A candidate for completion, correction or suggestion.
17816
17816
  \fBscore of candidate\fP
17817
17817
  .INDENT 0.0
17818
17818
  .INDENT 3.5
17819
- A score of corresponding \fBcandidate\fP. It means that
17819
+ A score of corresponding \fBcandidate\fP\&. It means that
17820
17820
  higher score candidate is more likely candidate for
17821
17821
  completion, correction or suggestion. Returned candidates
17822
17822
  are sorted by \fBscore of candidate\fP descending by
@@ -18200,7 +18200,7 @@ table_create Lexicon TABLE_PAT_KEY ShortText \-\-default_tokenizer TokenBigram \
18200
18200
  The \fBtable_create\fP command creates the following table:
18201
18201
  .INDENT 0.0
18202
18202
  .IP \(bu 2
18203
- The table is named \fBLexicon\fP.
18203
+ The table is named \fBLexicon\fP\&.
18204
18204
  .IP \(bu 2
18205
18205
  The table is \fBTABLE_PAT_KEY\fP type table.
18206
18206
  .IP \(bu 2
@@ -18217,14 +18217,14 @@ table is used for fulltext search.
18217
18217
  .sp
18218
18218
  In fulltext search, predictive search may be used for fuzzy
18219
18219
  search. Predictive search is supported by \fBTABLE_PAT_KEY\fP and
18220
- \fBTABLE_DAT_KEY\fP.
18220
+ \fBTABLE_DAT_KEY\fP\&.
18221
18221
  .sp
18222
18222
  Lexicon table has many keys because a fulltext target text has many
18223
18223
  tokens. Table that has many keys should consider table size because
18224
18224
  large table requires large memory. Requiring large memory causes disk
18225
18225
  I/O. It blocks fast search. So table size is important for a table
18226
18226
  that has many keys. \fBTABLE_PAT_KEY\fP is less table size than
18227
- \fBTABLE_DAT_KEY\fP.
18227
+ \fBTABLE_DAT_KEY\fP\&.
18228
18228
  .sp
18229
18229
  Because of the above reasons, \fBTABLE_PAT_KEY\fP is suitable table type
18230
18230
  for lexicon table.
@@ -18294,7 +18294,7 @@ suitable. Index for age is the case in the above example. Index for
18294
18294
  age will have only 0\-100 items because human doesn\(aqt live so long.
18295
18295
  .sp
18296
18296
  If you have many indexed items, \fBTABLE_PAT_KEY\fP is suitable. Because
18297
- \fBTABLE_PAT_KEY\fP is smaller than \fBTABLE_DAT_KEY\fP.
18297
+ \fBTABLE_PAT_KEY\fP is smaller than \fBTABLE_DAT_KEY\fP\&.
18298
18298
  .SS Parameters
18299
18299
  .sp
18300
18300
  This section describes all parameters.
@@ -18323,7 +18323,7 @@ character.)
18323
18323
  .sp
18324
18324
  You need to create a name with one or more the above chracters. Note
18325
18325
  that you cannot use \fB_\fP as the first character such as
18326
- \fB_name\fP.
18326
+ \fB_name\fP\&.
18327
18327
  .SS \fBflags\fP
18328
18328
  .sp
18329
18329
  It specifies a table type and table customize options.
@@ -18367,7 +18367,7 @@ T{
18367
18367
  \fBKEY_WITH_SIS\fP
18368
18368
  T} T{
18369
18369
  Enable Semi Infinite String.
18370
- Require \fBTABLE_PAT_KEY\fP.
18370
+ Require \fBTABLE_PAT_KEY\fP\&.
18371
18371
  T}
18372
18372
  _
18373
18373
  .TE
@@ -18385,11 +18385,11 @@ or more \fBTABLE_${TYPE}\fP flags. For example,
18385
18385
  \fBTABLE_NO_KEY|TABLE_HASH_KEY\fP is invalid.
18386
18386
  .sp
18387
18387
  You can combine flags with \fB|\fP (vertical bar) such as
18388
- \fBTABLE_PAT_KEY|KEY_WITH_SIS\fP.
18388
+ \fBTABLE_PAT_KEY|KEY_WITH_SIS\fP\&.
18389
18389
  .sp
18390
18390
  See \fB/reference/tables\fP for difference between table types.
18391
18391
  .sp
18392
- The default flags are \fBTABLE_HASH_KEY\fP.
18392
+ The default flags are \fBTABLE_HASH_KEY\fP\&.
18393
18393
  .SS \fBkey_type\fP
18394
18394
  .sp
18395
18395
  It specifies key type.
@@ -18449,9 +18449,9 @@ The default value is none.
18449
18449
  .UNINDENT
18450
18450
  .UNINDENT
18451
18451
  .sp
18452
- If \fBtable_create\fP fails, error details are in \fBHEADER\fP.
18452
+ If \fBtable_create\fP fails, error details are in \fBHEADER\fP\&.
18453
18453
  .sp
18454
- See \fB/reference/command/output_format\fP for \fBHEADER\fP.
18454
+ See \fB/reference/command/output_format\fP for \fBHEADER\fP\&.
18455
18455
  .SS See also
18456
18456
  .INDENT 0.0
18457
18457
  .IP \(bu 2
@@ -18829,19 +18829,19 @@ tokenize TokenBigram "Fulltext Search"
18829
18829
  .UNINDENT
18830
18830
  .sp
18831
18831
  It has only required parameters. \fBtokenizer\fP is \fBTokenBigram\fP and
18832
- \fBstring\fP is \fB"Fulltext Search"\fP. It returns tokens that is
18832
+ \fBstring\fP is \fB"Fulltext Search"\fP\&. It returns tokens that is
18833
18833
  generated by tokenizing \fB"Fulltext Search"\fP with \fBTokenBigram\fP
18834
- tokenizer. It doesn\(aqt normalize \fB"Fulltext Search"\fP.
18834
+ tokenizer. It doesn\(aqt normalize \fB"Fulltext Search"\fP\&.
18835
18835
  .SS Parameters
18836
18836
  .sp
18837
18837
  This section describes all parameters. Parameters are categorized.
18838
18838
  .SS Required parameters
18839
18839
  .sp
18840
- There are required parameters, \fBtokenizer\fP and \fBstring\fP.
18840
+ There are required parameters, \fBtokenizer\fP and \fBstring\fP\&.
18841
18841
  .SS \fBtokenizer\fP
18842
18842
  .sp
18843
18843
  It specifies the tokenizer name. \fBtokenize\fP command uses the
18844
- tokenizer that is named \fBtokenizer\fP.
18844
+ tokenizer that is named \fBtokenizer\fP\&.
18845
18845
  .sp
18846
18846
  See \fB/reference/tokenizers\fP about built\-in tokenizers.
18847
18847
  .sp
@@ -18931,7 +18931,7 @@ tokenize TokenTrigram "Fulltext Search"
18931
18931
  If you want to use other tokenizers, you need to register additional
18932
18932
  tokenizer plugin by \fBregister\fP command. For example, you can use
18933
18933
  \fI\%KyTea\fP based tokenizer by
18934
- registering \fBtokenizers/kytea\fP.
18934
+ registering \fBtokenizers/kytea\fP\&.
18935
18935
  .SS \fBstring\fP
18936
18936
  .sp
18937
18937
  It specifies any string which you want to tokenize.
@@ -18939,7 +18939,7 @@ It specifies any string which you want to tokenize.
18939
18939
  If you want to include spaces in \fBstring\fP, you need to quote
18940
18940
  \fBstring\fP by single quotation (\fB\(aq\fP) or double quotation (\fB"\fP).
18941
18941
  .sp
18942
- Here is an example to use spaces in \fBstring\fP.
18942
+ Here is an example to use spaces in \fBstring\fP\&.
18943
18943
  .sp
18944
18944
  Execution example:
18945
18945
  .INDENT 0.0
@@ -19127,8 +19127,8 @@ There are optional parameters.
19127
19127
  .SS \fBnormalizer\fP
19128
19128
  .sp
19129
19129
  It specifies the normalizer name. \fBtokenize\fP command uses the
19130
- normalizer that is named \fBnormalizer\fP. Normalizer is important for
19131
- N\-gram family tokenizers such as \fBTokenBigram\fP.
19130
+ normalizer that is named \fBnormalizer\fP\&. Normalizer is important for
19131
+ N\-gram family tokenizers such as \fBTokenBigram\fP\&.
19132
19132
  .sp
19133
19133
  Normalizer detects character type for each character while
19134
19134
  normalizing. N\-gram family tokenizers use character types while
@@ -19255,7 +19255,7 @@ Continuous alphabets are tokenized as one token. For example,
19255
19255
  \fBfulltext\fP is a token.
19256
19256
  .sp
19257
19257
  If you want to tokenize by two characters with noramlizer, use
19258
- \fBTokenBigramSplitSymbolAlpha\fP.
19258
+ \fBTokenBigramSplitSymbolAlpha\fP\&.
19259
19259
  .sp
19260
19260
  Execution example:
19261
19261
  .INDENT 0.0
@@ -19340,7 +19340,7 @@ to lower case characters. For example, \fBfu\fP is a token.
19340
19340
  .sp
19341
19341
  It specifies a tokenization customize options. You can specify
19342
19342
  multiple options separated by "\fB|\fP". For example,
19343
- \fBNONE|ENABLE_TOKENIZED_DELIMITER\fP.
19343
+ \fBNONE|ENABLE_TOKENIZED_DELIMITER\fP\&.
19344
19344
  .sp
19345
19345
  Here are available flags.
19346
19346
  .TS
@@ -19368,7 +19368,7 @@ T}
19368
19368
  _
19369
19369
  .TE
19370
19370
  .sp
19371
- Here is an example that uses \fBENABLE_TOKENIZED_DELIMITER\fP.
19371
+ Here is an example that uses \fBENABLE_TOKENIZED_DELIMITER\fP\&.
19372
19372
  .sp
19373
19373
  Execution example:
19374
19374
  .INDENT 0.0
@@ -19406,7 +19406,7 @@ tokenize TokenDelimit "Full
19406
19406
  \fBTokenDelimit\fP tokenizer is one of tokenized delimiter supported
19407
19407
  tokenizer. \fBENABLE_TOKENIZED_DELIMITER\fP enables tokenized delimiter.
19408
19408
  Tokenized delimiter is special character that indicates token
19409
- border. It is \fBU+FFFE\fP. The character is not assigned any
19409
+ border. It is \fBU+FFFE\fP\&. The character is not assigned any
19410
19410
  character. It means that the character is not appeared in normal
19411
19411
  string. So the character is good character for this puropose. If
19412
19412
  \fBENABLE_TOKENIZED_DELIMITER\fP is enabled, the target string is
@@ -19431,7 +19431,7 @@ the feature:
19431
19431
  \fBHEADER\fP
19432
19432
  .INDENT 0.0
19433
19433
  .INDENT 3.5
19434
- See \fB/reference/command/output_format\fP about \fBHEADER\fP.
19434
+ See \fB/reference/command/output_format\fP about \fBHEADER\fP\&.
19435
19435
  .UNINDENT
19436
19436
  .UNINDENT
19437
19437
  .sp
@@ -19578,10 +19578,10 @@ select Users
19578
19578
  .UNINDENT
19579
19579
  .SS Parameters
19580
19580
  .sp
19581
- This section describes parameters of \fBtruncate\fP.
19581
+ This section describes parameters of \fBtruncate\fP\&.
19582
19582
  .SS Required parameter
19583
19583
  .sp
19584
- There is required parameter, \fBtable_name\fP.
19584
+ There is required parameter, \fBtable_name\fP\&.
19585
19585
  .SS \fBtable_name\fP
19586
19586
  .sp
19587
19587
  It specifies the name of table.
@@ -19776,9 +19776,9 @@ Object型はv1.2でサポートされます。
19776
19776
  .SS Tables
19777
19777
  .SS Summary
19778
19778
  .sp
19779
- Table in groonga manages relation between ID and key. Groonga provides
19779
+ Table in Groonga manages relation between ID and key. Groonga provides
19780
19780
  four table types. They are \fBTABLE_NO_KEY\fP, \fBTABLE_HASH_KEY\fP,
19781
- \fBTABLE_PAT_KEY\fP and \fBTABLE_DAT_KEY\fP.
19781
+ \fBTABLE_PAT_KEY\fP and \fBTABLE_DAT_KEY\fP\&.
19782
19782
  .sp
19783
19783
  All tables except \fBTABLE_NO_KEY\fP provides both fast ID search by key
19784
19784
  and fast key search by ID. \fBTABLE_NO_KEY\fP doesn\(aqt support
@@ -19786,7 +19786,7 @@ key. \fBTABLE_NO_KEY\fP only manages ID. So \fBTABLE_NO_KEY\fP doesn\(aqt
19786
19786
  provides ID search and key search.
19787
19787
  .SS Characteristics
19788
19788
  .sp
19789
- Here is a chracteristic table of all tables in groonga. (\fBTABLE_\fP
19789
+ Here is a chracteristic table of all tables in Groonga. (\fBTABLE_\fP
19790
19790
  prefix is omitted in the table.)
19791
19791
  .TS
19792
19792
  center;
@@ -19994,10 +19994,10 @@ index for range search.
19994
19994
  is not suitable for storing many records. \fBTABLE_DAT_KEY\fP is a only
19995
19995
  table that supports key update.
19996
19996
  .sp
19997
- \fBTABLE_DAT_KEY\fP is used in groonga database. Groonga database needs
19997
+ \fBTABLE_DAT_KEY\fP is used in Groonga database. Groonga database needs
19998
19998
  to convert object name such as \fBShortText\fP, \fBTokenBigram\fP and
19999
- table names to object ID. And groonga database needs to rename object
20000
- name. Those features are implemented by \fBTABLE_DAT_KEY\fP. The number
19999
+ table names to object ID. And Groonga database needs to rename object
20000
+ name. Those features are implemented by \fBTABLE_DAT_KEY\fP\&. The number
20001
20001
  of objects is small. So large data size demerit of \fBTABLE_DAT_KEY\fP
20002
20002
  can be ignored.
20003
20003
  .SS Record ID
@@ -20057,7 +20057,7 @@ normalization by registering your normalizer plugins to Groonga.
20057
20057
  A normalizer module is attached to a table. A table can have zero or
20058
20058
  one normalizer module. You can attach a normalizer module to a table
20059
20059
  by \fItable\-create\-normalizer\fP option in
20060
- \fB/reference/commands/table_create\fP.
20060
+ \fB/reference/commands/table_create\fP\&.
20061
20061
  .sp
20062
20062
  Here is an example \fBtable_create\fP that uses \fBNormalizerAuto\fP
20063
20063
  normalizer module:
@@ -20079,7 +20079,7 @@ table_create Dictionary TABLE_HASH_KEY ShortText \-\-normalizer NormalizerAuto
20079
20079
  .INDENT 0.0
20080
20080
  .INDENT 3.5
20081
20081
  Groonga 2.0.9 or earlier doesn\(aqt have \fB\-\-normalizer\fP option in
20082
- \fBtable_create\fP. \fBKEY_NORMALIZE\fP flag was used instead.
20082
+ \fBtable_create\fP\&. \fBKEY_NORMALIZE\fP flag was used instead.
20083
20083
  .sp
20084
20084
  You can open an old database by Groonga 2.1.0 or later. An old
20085
20085
  database means that the database is created by Groonga 2.0.9 or
@@ -20152,7 +20152,7 @@ select Dictionary
20152
20152
  \fBNormalizerAuto\fP normalizer normalizes a text as a downcased text.
20153
20153
  For example, \fB"Apple"\fP is normalized to \fB"apple"\fP, \fB"black"\fP is
20154
20154
  normalized to \fB"blank"\fP and \fB"COLOR"\fP is normalized to
20155
- \fB"color"\fP.
20155
+ \fB"color"\fP\&.
20156
20156
  .sp
20157
20157
  If a table is a lexicon for fulltext search, tokenized tokens are
20158
20158
  normalized. Because tokens are stored as table keys. Table keys are
@@ -20245,7 +20245,7 @@ Here is a list of additional normalizers provided by \fBgroonga\-normalizer\-mys
20245
20245
  .sp
20246
20246
  \fBgroonga\-normalizer\-mysql\fP is a Groonga plugin.
20247
20247
  It provides MySQL compatible normalizers to Groonga.
20248
- \fBNormalizerMySQLGeneralCI\fP corresponds to \fButf8mb4_general_ci\fP.
20248
+ \fBNormalizerMySQLGeneralCI\fP corresponds to \fButf8mb4_general_ci\fP\&.
20249
20249
  .sp
20250
20250
  You need to register \fBnormalizers/mysql\fP plugin in advance.
20251
20251
  .sp
@@ -20322,7 +20322,7 @@ feature than the embedded query expansion feature. For example, it
20322
20322
  doesn\(aqt support word normalization. But it may be easy to use because
20323
20323
  you can manage your synonyms by TSV file. You can edit your synonyms
20324
20324
  by spreadsheet application such as Excel. With the embedded query
20325
- expansion feature, you manage your synonyms by groonga\(aqs table.
20325
+ expansion feature, you manage your synonyms by Groonga\(aqs table.
20326
20326
  .SS Install
20327
20327
  .sp
20328
20328
  You need to register \fBquery_expanders/tsv\fP as a plugin before you
@@ -20385,9 +20385,9 @@ _
20385
20385
  .TE
20386
20386
  .sp
20387
20387
  The table means that \fBsynonym 1\fP and \fBsynonym 2\fP are synonyms of
20388
- \fBword\fP. For example, \fBgroonga\fP and \fBSenna\fP are synonyms of
20389
- \fBgroonga\fP. And \fBmroonga\fP and \fBgroonga MySQL\fP are synonyms of
20390
- \fBmroonga\fP.
20388
+ \fBword\fP\&. For example, \fBgroonga\fP and \fBSenna\fP are synonyms of
20389
+ \fBgroonga\fP\&. And \fBmroonga\fP and \fBgroonga MySQL\fP are synonyms of
20390
+ \fBmroonga\fP\&.
20391
20391
  .sp
20392
20392
  Here is an example of query expnasion that uses \fBgroonga\fP as query:
20393
20393
  .INDENT 0.0
@@ -20526,12 +20526,12 @@ With the above command, \fB/tmp/synonyms.tsv\fP file is used.
20526
20526
  You can define zero or more synonyms in a TSV file. You define a
20527
20527
  \fBword\fP and \fBsynonyms\fP pair by a line. \fBword\fP is expanded to
20528
20528
  \fBsynonyms\fP in \fB\-\-query\fP value. \fBSynonyms\fP are combined by
20529
- \fBOR\fP. For example, \fBgroonga\fP and \fBSenna\fP synonyms are expanded
20530
- as \fBgroonga OR Senna\fP.
20529
+ \fBOR\fP\&. For example, \fBgroonga\fP and \fBSenna\fP synonyms are expanded
20530
+ as \fBgroonga OR Senna\fP\&.
20531
20531
  .sp
20532
20532
  The first column is \fBword\fP and the rest columns are \fBsynonyms\fP of
20533
- the \fBword\fP. Here is a sample line for \fBword\fP is \fBgroonga\fP and
20534
- \fBsynonyms\fP are \fBgroonga\fP and \fBSenna\fP. \fB(TAB)\fP means a tab
20533
+ the \fBword\fP\&. Here is a sample line for \fBword\fP is \fBgroonga\fP and
20534
+ \fBsynonyms\fP are \fBgroonga\fP and \fBSenna\fP\&. \fB(TAB)\fP means a tab
20535
20535
  character (\fBU+0009\fP):
20536
20536
  .INDENT 0.0
20537
20537
  .INDENT 3.5
@@ -20577,7 +20577,7 @@ loaded only at the plugin load time.
20577
20577
  疑似カラム
20578
20578
  .SS 説明
20579
20579
  .sp
20580
- groongaのデータベースで作成したテーブルには、いくつかのカラムが自動的に定義されます。
20580
+ Groongaのデータベースで作成したテーブルには、いくつかのカラムが自動的に定義されます。
20581
20581
  .sp
20582
20582
  これらのカラムはいずれもアンダースコア(\(aq_\(aq)で始まる名前が付与されます。定義される疑似カラムは、テーブルの種類によって異なります。
20583
20583
  .sp
@@ -20620,12 +20620,12 @@ groongaのデータベースで作成したテーブルには、いくつかの
20620
20620
  .SS grn_expr
20621
20621
  .sp
20622
20622
  Grn_expr is an object that searches records with specified conditions
20623
- and manipulates a database. It\(aqs pronounced as \fBgurun expression\fP.
20623
+ and manipulates a database. It\(aqs pronounced as \fBgurun expression\fP\&.
20624
20624
  .sp
20625
20625
  Conditions for searching records from a database can be represented by
20626
20626
  conbining condition expressions such as \fBequal condition expression\fP
20627
20627
  and \fBless than condition expression\fP with set operations such as
20628
- \fBAND\fP, \fBOR\fP and \fBNOT\fP. Grn_expr executes those conditions to
20628
+ \fBAND\fP, \fBOR\fP and \fBNOT\fP\&. Grn_expr executes those conditions to
20629
20629
  search records. You can also use advanced searches such as similar
20630
20630
  search and near search by grn_expr. You can also use flexible full
20631
20631
  text search. For example, you can control hit scores for specified
@@ -20650,40 +20650,40 @@ Calling grn_expr related APIs.
20650
20650
  \fB/reference/grn_expr/query_syntax\fP is for common search form in
20651
20651
  Internet search site. It\(aqs simple and easy to use but it has a
20652
20652
  limitation. You can not use all condition expressions and set
20653
- operations in \fB/reference/grn_expr/query_syntax\fP. You can use
20653
+ operations in \fB/reference/grn_expr/query_syntax\fP\&. You can use
20654
20654
  \fB/reference/grn_expr/query_syntax\fP with \fBquery\fP option in
20655
- \fB/reference/commands/select\fP.
20655
+ \fB/reference/commands/select\fP\&.
20656
20656
  .sp
20657
20657
  \fB/reference/grn_expr/script_syntax\fP is ECMAScript like
20658
20658
  syntax. You can use all condition expresssions and set operations in
20659
- \fB/reference/grn_expr/script_syntax\fP. You can use
20659
+ \fB/reference/grn_expr/script_syntax\fP\&. You can use
20660
20660
  \fB/reference/grn_expr/script_syntax\fP with \fBfilter\fP option and
20661
- \fBscorer\fP option in \fB/reference/commands/select\fP.
20661
+ \fBscorer\fP option in \fB/reference/commands/select\fP\&.
20662
20662
  .sp
20663
20663
  You can use groonga as a library and create a grn_expr by calling
20664
20664
  grn_expr related APIs. You can use full features with calling APIs
20665
- like \fB/reference/grn_expr/script_syntax\fP. Calling APIs is useful
20665
+ like \fB/reference/grn_expr/script_syntax\fP\&. Calling APIs is useful
20666
20666
  creating a custom syntax to create grn_expr. They are used in \fI\%rroonga\fP that is Ruby bindings
20667
- of groonga. Rroonga can create a grn_expr by Ruby\(aqs syntax instead of
20667
+ of Groonga. Rroonga can create a grn_expr by Ruby\(aqs syntax instead of
20668
20668
  parsing string.
20669
20669
  .SS Query syntax
20670
20670
  .sp
20671
20671
  Query syntax is a syntax to specify search condition for common Web
20672
20672
  search form. It is similar to the syntax of Google\(aqs search form. For
20673
20673
  example, \fBword1 word2\fP means that groonga searches records that
20674
- contain both \fBword1\fP and \fBword2\fP. \fBword1 OR word2\fP means that
20675
- groogna searches records that contain either \fBword1\fP or \fBword2\fP.
20674
+ contain both \fBword1\fP and \fBword2\fP\&. \fBword1 OR word2\fP means that
20675
+ groogna searches records that contain either \fBword1\fP or \fBword2\fP\&.
20676
20676
  .sp
20677
20677
  Query syntax consists of \fBconditional expression\fP, \fBcombind
20678
- expression\fP and \fBassignment expression\fP. Nomrally \fBassignment
20678
+ expression\fP and \fBassignment expression\fP\&. Nomrally \fBassignment
20679
20679
  expression\fP can be ignored. Because \fBassignment expression\fP is
20680
- disabled in \fB\-\-query\fP option of \fB/reference/commands/select\fP. You can use
20680
+ disabled in \fB\-\-query\fP option of \fB/reference/commands/select\fP\&. You can use
20681
20681
  it if you use groonga as library and customize query syntax parser
20682
20682
  options.
20683
20683
  .sp
20684
20684
  \fBConditinal expression\fP specifies an condition. \fBCombinded
20685
20685
  expression\fP consists of one or more \fBconditional expression\fP,
20686
- \fBcombined expression\fP or \fBassignment expression\fP. \fBAssignment
20686
+ \fBcombined expression\fP or \fBassignment expression\fP\&. \fBAssignment
20687
20687
  expression\fP can assigns a column to a value.
20688
20688
  .SS Sample data
20689
20689
  .sp
@@ -20733,7 +20733,7 @@ load \-\-table Entries
20733
20733
  .sp
20734
20734
  There is a table, \fBEntries\fP, for blog entries. An entry has title,
20735
20735
  content and the number of likes for the entry. Title is key of
20736
- \fBEntries\fP. Content is value of \fBEntries.content\fP column. The
20736
+ \fBEntries\fP\&. Content is value of \fBEntries.content\fP column. The
20737
20737
  number of likes is value of \fBEntries.n_likes\fP column.
20738
20738
  .sp
20739
20739
  \fBEntries._key\fP column and \fBEntries.content\fP column are indexed
@@ -20744,8 +20744,8 @@ OK. The schema and data for examples are ready.
20744
20744
  .SS Escape
20745
20745
  .sp
20746
20746
  There are special characters in query syntax. To use a special
20747
- character as itself, it should be escaped by prepending \fB\e\fP. For
20748
- example, \fB"\fP is a special character. It is escaped as \fB\e"\fP.
20747
+ character as itself, it should be escaped by prepending \fB\e\fP\&. For
20748
+ example, \fB"\fP is a special character. It is escaped as \fB\e"\fP\&.
20749
20749
  .sp
20750
20750
  Here is a special character list:
20751
20751
  .INDENT 0.0
@@ -20754,7 +20754,7 @@ Here is a special character list:
20754
20754
  .IP \(bu 2
20755
20755
  \fB[space]\fP (escaped as \fB[backslash][space]\fP) (You should
20756
20756
  substitute \fB[space]\fP with a white space character that is 0x20
20757
- in ASCII and \fB[backslash]\fP with \fB\e\e\fP.)
20757
+ in ASCII and \fB[backslash]\fP with \fB\e\e\fP\&.)
20758
20758
  .IP \(bu 2
20759
20759
  \fB"\fP (escaped as \fB\e"\fP)
20760
20760
  .IP \(bu 2
@@ -20770,10 +20770,10 @@ in ASCII and \fB[backslash]\fP with \fB\e\e\fP.)
20770
20770
  .UNINDENT
20771
20771
  .sp
20772
20772
  You can use quote instead of escape. Quote syntax is \fB"..."\fP or
20773
- \fB\(aq...\(aq\fP. You need escape \fB"\fP as \fB\e"\fP in \fB"..."\fP quote syntax.
20773
+ \fB\(aq...\(aq\fP\&. You need escape \fB"\fP as \fB\e"\fP in \fB"..."\fP quote syntax.
20774
20774
  You need escape \fB\(aq\fP as \fB\e\(aq\fP in \fB\(aq...\(aq\fP quote syntax. For
20775
20775
  example, \fBAlice\(aqs brother (Bob)\fP can be quoted \fB"Alice\(aqs brother
20776
- (Bob)"\fP or \fB\(aqAlice\e\(aqs brother (Bob)\(aq\fP.
20776
+ (Bob)"\fP or \fB\(aqAlice\e\(aqs brother (Bob)\(aq\fP\&.
20777
20777
  .sp
20778
20778
  \fBNOTE:\fP
20779
20779
  .INDENT 0.0
@@ -20792,7 +20792,7 @@ special character is escaped properly.
20792
20792
  Here is available conditional expression list.
20793
20793
  .SS Full text search condition
20794
20794
  .sp
20795
- Its syntax is \fBkeyword\fP.
20795
+ Its syntax is \fBkeyword\fP\&.
20796
20796
  .sp
20797
20797
  \fBFull text search condition\fP specifies a full text search condition
20798
20798
  against the default match columns. Match columns are full text search
@@ -20800,13 +20800,13 @@ target columns.
20800
20800
  .sp
20801
20801
  You should specify the default match columns for full text
20802
20802
  search. They can be specified by \fB\-\-match_columns\fP option of
20803
- \fB/reference/commands/select\fP. If you don\(aqt specify the default match
20803
+ \fB/reference/commands/select\fP\&. If you don\(aqt specify the default match
20804
20804
  columns, this conditional expression fails.
20805
20805
  .sp
20806
20806
  This conditional expression does full text search with
20807
- \fBkeyword\fP. \fBkeyword\fP should not contain any spaces. If \fBkeyword\fP
20807
+ \fBkeyword\fP\&. \fBkeyword\fP should not contain any spaces. If \fBkeyword\fP
20808
20808
  contains a space such as \fBsearch keyword\fP, it means two full text
20809
- search conditions; \fBsearch\fP and \fBkeyword\fP. If you want to
20809
+ search conditions; \fBsearch\fP and \fBkeyword\fP\&. If you want to
20810
20810
  specifies a keyword that contains one or more spaces, you can use
20811
20811
  \fBphrase search condition\fP that is described below.
20812
20812
  .sp
@@ -20874,18 +20874,18 @@ The expression matches records that contain a word \fBfast\fP in
20874
20874
  \fBcontent\fP column is the default match column.
20875
20875
  .SS Phrase search condition
20876
20876
  .sp
20877
- Its syntax is \fB"search keyword"\fP.
20877
+ Its syntax is \fB"search keyword"\fP\&.
20878
20878
  .sp
20879
20879
  \fBPhrase search condition\fP specifies a phrase search condition
20880
20880
  against the default match columns.
20881
20881
  .sp
20882
20882
  You should specify the default match columns for full text
20883
20883
  search. They can be specified by \fB\-\-match_columns\fP option of
20884
- \fB/reference/commands/select\fP. If you don\(aqt specify the default match
20884
+ \fB/reference/commands/select\fP\&. If you don\(aqt specify the default match
20885
20885
  columns, this conditional expression fails.
20886
20886
  .sp
20887
20887
  This conditional expression does phrase search with \fBsearch
20888
- keyword\fP. Phrase search searches records that contain \fBsearch\fP and
20888
+ keyword\fP\&. Phrase search searches records that contain \fBsearch\fP and
20889
20889
  \fBkeyword\fP and those terms are appeared in the same order and
20890
20890
  adjacent. Thus, \fBPut a search keyword in the form\fP is matched but
20891
20891
  \fBSearch by the keyword\fP and \fBThere is a keyword. Search by it!\fP
@@ -20950,12 +20950,12 @@ The expression matches records that contain a phrase \fBI started\fP in
20950
20950
  \fBcontent\fP column is the default match column.
20951
20951
  .SS Full text search condition (with explicit match column)
20952
20952
  .sp
20953
- Its syntax is \fBcolumn:@keyword\fP.
20953
+ Its syntax is \fBcolumn:@keyword\fP\&.
20954
20954
  .sp
20955
20955
  It\(aqs similar to \fBfull text search condition\fP but it doesn\(aqt require
20956
20956
  the default match columns. You need to specify match column for the
20957
20957
  full text search condition by \fBcolumn:\fP instead of
20958
- \fB\-\-match_columns\fP option of \fB/reference/commands/select\fP.
20958
+ \fB\-\-match_columns\fP option of \fB/reference/commands/select\fP\&.
20959
20959
  .sp
20960
20960
  This condtional expression is useful when you want to use two or more
20961
20961
  full text search against different columns. The default match columns
@@ -21047,17 +21047,17 @@ The expression matches records that contain a word \fBfast\fP in
21047
21047
  \fBcontent\fP column value.
21048
21048
  .SS Phrase search condition (with explicit match column)
21049
21049
  .sp
21050
- Its syntax is \fBcolumn:@"search keyword"\fP.
21050
+ Its syntax is \fBcolumn:@"search keyword"\fP\&.
21051
21051
  .sp
21052
21052
  It\(aqs similar to \fBphrase search condition\fP but it doesn\(aqt require the
21053
21053
  default match columns. You need to specify match column for the phrase
21054
21054
  search condition by \fBcolumn:\fP instead of \fB\-\-match_columns\fP option
21055
- of \fB/reference/commands/select\fP.
21055
+ of \fB/reference/commands/select\fP\&.
21056
21056
  .sp
21057
21057
  The different between \fBphrase search condition\fP and \fBphrase search
21058
21058
  condition (with explicit match column)\fP is similar to between \fBfull
21059
21059
  text search condition\fP and \fBfull text search condition (with
21060
- explicit match column)\fP. \fBPhrase search condition\fP supports
21060
+ explicit match column)\fP\&. \fBPhrase search condition\fP supports
21061
21061
  advanced match columns but \fBphrase search condition (with explicit
21062
21062
  match column)\fP isn\(aqt supported. See description of \fBfull text search
21063
21063
  condition (with explicit match column)\fP about advanced match columns.
@@ -21119,24 +21119,24 @@ The expression matches records that contain a phrase \fBI started\fP in
21119
21119
  \fBI\fP and \fBstarted\fP aren\(aqt adjacent.
21120
21120
  .SS Prefix search condition
21121
21121
  .sp
21122
- Its syntax is \fBcolumn:^value\fP or \fBvalue*\fP.
21122
+ Its syntax is \fBcolumn:^value\fP or \fBvalue*\fP\&.
21123
21123
  .sp
21124
- This conditional expression does prefix search with \fBvalue\fP. Prefix
21125
- search searches records that contain a word that starts with \fBvalue\fP.
21124
+ This conditional expression does prefix search with \fBvalue\fP\&. Prefix
21125
+ search searches records that contain a word that starts with \fBvalue\fP\&.
21126
21126
  .sp
21127
21127
  You can use fast prefix search against a column. The column must be
21128
21128
  indexed and index table must be patricia trie table
21129
21129
  (\fBTABLE_PAT_KEY\fP) or double array trie table
21130
21130
  (\fBTABLE_DAT_KEY\fP). You can also use fast prefix search against
21131
21131
  \fB_key\fP pseudo column of patricia trie table or double array trie
21132
- table. You don\(aqt need to index \fB_key\fP.
21132
+ table. You don\(aqt need to index \fB_key\fP\&.
21133
21133
  .sp
21134
21134
  Prefix search can be used with other table types but it causes all
21135
21135
  records scan. It\(aqs not problem for small records but it spends more
21136
21136
  time for large records.
21137
21137
  .sp
21138
21138
  It doesn\(aqt require the default match columns such as \fBfull text
21139
- search condition\fP and \fBphrase search condition\fP.
21139
+ search condition\fP and \fBphrase search condition\fP\&.
21140
21140
  .sp
21141
21141
  Here is a simple exmaple.
21142
21142
  .sp
@@ -21201,17 +21201,17 @@ The expression matches records that contain a word that starts with
21201
21201
  \fBGood\-bye Tritonn\fP are matched with the expression.
21202
21202
  .SS Suffix search condition
21203
21203
  .sp
21204
- Its syntax is \fBcolumn:$value\fP.
21204
+ Its syntax is \fBcolumn:$value\fP\&.
21205
21205
  .sp
21206
- This conditional expression does suffix search with \fBvalue\fP. Suffix
21207
- search searches records that contain a word that ends with \fBvalue\fP.
21206
+ This conditional expression does suffix search with \fBvalue\fP\&. Suffix
21207
+ search searches records that contain a word that ends with \fBvalue\fP\&.
21208
21208
  .sp
21209
21209
  You can use fast suffix search against a column. The column must be
21210
21210
  indexed and index table must be patricia trie table
21211
21211
  (\fBTABLE_PAT_KEY\fP) with \fBKEY_WITH_SIS\fP flag. You can also use fast
21212
21212
  suffix search against \fB_key\fP pseudo column of patricia trie table
21213
21213
  (\fBTABLE_PAT_KEY\fP) with \fBKEY_WITH_SIS\fP flag. You don\(aqt need to
21214
- index \fB_key\fP. We recommended that you use index column based fast
21214
+ index \fB_key\fP\&. We recommended that you use index column based fast
21215
21215
  suffix search instead of \fB_key\fP based fast suffix search. \fB_key\fP
21216
21216
  based fast suffix search returns automatically registered
21217
21217
  substrings. (TODO: write document about suffix search and link to it
@@ -21232,7 +21232,7 @@ scan. It\(aqs not problem for small records but it spends more time for
21232
21232
  large records.
21233
21233
  .sp
21234
21234
  It doesn\(aqt require the default match columns such as \fBfull text
21235
- search condition\fP and \fBphrase search condition\fP.
21235
+ search condition\fP and \fBphrase search condition\fP\&.
21236
21236
  .sp
21237
21237
  Here is a simple exmaple. It uses fast suffix search for hiragana in
21238
21238
  Japanese that is one of non\-ASCII characters.
@@ -21302,12 +21302,12 @@ in \fBcontent\fP column value. \fBぐるんが\fP and \fBむるんが\fP are mat
21302
21302
  with the expression.
21303
21303
  .SS Equal condition
21304
21304
  .sp
21305
- Its syntax is \fBcolumn:value\fP.
21305
+ Its syntax is \fBcolumn:value\fP\&.
21306
21306
  .sp
21307
- It matches records that \fBcolumn\fP value is equal to \fBvalue\fP.
21307
+ It matches records that \fBcolumn\fP value is equal to \fBvalue\fP\&.
21308
21308
  .sp
21309
21309
  It doesn\(aqt require the default match columns such as \fBfull text
21310
- search condition\fP and \fBphrase search condition\fP.
21310
+ search condition\fP and \fBphrase search condition\fP\&.
21311
21311
  .sp
21312
21312
  Here is a simple exmaple.
21313
21313
  .sp
@@ -21362,15 +21362,15 @@ select Entries \-\-query _key:Groonga
21362
21362
  .UNINDENT
21363
21363
  .sp
21364
21364
  The expression matches records that \fB_key\fP column value is
21365
- equal to \fBGroonga\fP.
21365
+ equal to \fBGroonga\fP\&.
21366
21366
  .SS Not equal condition
21367
21367
  .sp
21368
- Its syntax is \fBcolumn:!value\fP.
21368
+ Its syntax is \fBcolumn:!value\fP\&.
21369
21369
  .sp
21370
- It matches records that \fBcolumn\fP value isn\(aqt equal to \fBvalue\fP.
21370
+ It matches records that \fBcolumn\fP value isn\(aqt equal to \fBvalue\fP\&.
21371
21371
  .sp
21372
21372
  It doesn\(aqt require the default match columns such as \fBfull text
21373
- search condition\fP and \fBphrase search condition\fP.
21373
+ search condition\fP and \fBphrase search condition\fP\&.
21374
21374
  .sp
21375
21375
  Here is a simple exmaple.
21376
21376
  .sp
@@ -21443,12 +21443,12 @@ select Entries \-\-query _key:!Groonga
21443
21443
  .UNINDENT
21444
21444
  .sp
21445
21445
  The expression matches records that \fB_key\fP column value is not equal
21446
- to \fBGroonga\fP.
21446
+ to \fBGroonga\fP\&.
21447
21447
  .SS Less than condition
21448
21448
  .sp
21449
- Its syntax is \fBcolumn:<value\fP.
21449
+ Its syntax is \fBcolumn:<value\fP\&.
21450
21450
  .sp
21451
- It matches records that \fBcolumn\fP value is less than \fBvalue\fP.
21451
+ It matches records that \fBcolumn\fP value is less than \fBvalue\fP\&.
21452
21452
  .sp
21453
21453
  If \fBcolumn\fP type is numerical type such as \fBInt32\fP, \fBcolumn\fP
21454
21454
  value and \fBvalue\fP are compared as number. If \fBcolumn\fP type is text
@@ -21456,7 +21456,7 @@ type such as \fBShortText\fP, \fBcolumn\fP value and \fBvalue\fP are
21456
21456
  compared as bit sequence.
21457
21457
  .sp
21458
21458
  It doesn\(aqt require the default match columns such as \fBfull text
21459
- search condition\fP and \fBphrase search condition\fP.
21459
+ search condition\fP and \fBphrase search condition\fP\&.
21460
21460
  .sp
21461
21461
  Here is a simple exmaple.
21462
21462
  .sp
@@ -21523,12 +21523,12 @@ select Entries \-\-query n_likes:<10
21523
21523
  .UNINDENT
21524
21524
  .sp
21525
21525
  The expression matches records that \fBn_likes\fP column value is less
21526
- than \fB10\fP.
21526
+ than \fB10\fP\&.
21527
21527
  .SS Greater than condition
21528
21528
  .sp
21529
- Its syntax is \fBcolumn:>value\fP.
21529
+ Its syntax is \fBcolumn:>value\fP\&.
21530
21530
  .sp
21531
- It matches records that \fBcolumn\fP value is greater than \fBvalue\fP.
21531
+ It matches records that \fBcolumn\fP value is greater than \fBvalue\fP\&.
21532
21532
  .sp
21533
21533
  If \fBcolumn\fP type is numerical type such as \fBInt32\fP, \fBcolumn\fP
21534
21534
  value and \fBvalue\fP are compared as number. If \fBcolumn\fP type is text
@@ -21536,7 +21536,7 @@ type such as \fBShortText\fP, \fBcolumn\fP value and \fBvalue\fP are
21536
21536
  compared as bit sequence.
21537
21537
  .sp
21538
21538
  It doesn\(aqt require the default match columns such as \fBfull text
21539
- search condition\fP and \fBphrase search condition\fP.
21539
+ search condition\fP and \fBphrase search condition\fP\&.
21540
21540
  .sp
21541
21541
  Here is a simple exmaple.
21542
21542
  .sp
@@ -21591,13 +21591,13 @@ select Entries \-\-query n_likes:>10
21591
21591
  .UNINDENT
21592
21592
  .sp
21593
21593
  The expression matches records that \fBn_likes\fP column value is greater
21594
- than \fB10\fP.
21594
+ than \fB10\fP\&.
21595
21595
  .SS Less than or equal to condition
21596
21596
  .sp
21597
- Its syntax is \fBcolumn:<=value\fP.
21597
+ Its syntax is \fBcolumn:<=value\fP\&.
21598
21598
  .sp
21599
21599
  It matches records that \fBcolumn\fP value is less than or equal to
21600
- \fBvalue\fP.
21600
+ \fBvalue\fP\&.
21601
21601
  .sp
21602
21602
  If \fBcolumn\fP type is numerical type such as \fBInt32\fP, \fBcolumn\fP
21603
21603
  value and \fBvalue\fP are compared as number. If \fBcolumn\fP type is text
@@ -21605,7 +21605,7 @@ type such as \fBShortText\fP, \fBcolumn\fP value and \fBvalue\fP are
21605
21605
  compared as bit sequence.
21606
21606
  .sp
21607
21607
  It doesn\(aqt require the default match columns such as \fBfull text
21608
- search condition\fP and \fBphrase search condition\fP.
21608
+ search condition\fP and \fBphrase search condition\fP\&.
21609
21609
  .sp
21610
21610
  Here is a simple exmaple.
21611
21611
  .sp
@@ -21678,13 +21678,13 @@ select Entries \-\-query n_likes:<=10
21678
21678
  .UNINDENT
21679
21679
  .sp
21680
21680
  The expression matches records that \fBn_likes\fP column value is less
21681
- than or equal to \fB10\fP.
21681
+ than or equal to \fB10\fP\&.
21682
21682
  .SS Greater than or equal to condition
21683
21683
  .sp
21684
- Its syntax is \fBcolumn:>=value\fP.
21684
+ Its syntax is \fBcolumn:>=value\fP\&.
21685
21685
  .sp
21686
21686
  It matches records that \fBcolumn\fP value is greater than or equal to
21687
- \fBvalue\fP.
21687
+ \fBvalue\fP\&.
21688
21688
  .sp
21689
21689
  If \fBcolumn\fP type is numerical type such as \fBInt32\fP, \fBcolumn\fP
21690
21690
  value and \fBvalue\fP are compared as number. If \fBcolumn\fP type is text
@@ -21692,7 +21692,7 @@ type such as \fBShortText\fP, \fBcolumn\fP value and \fBvalue\fP are
21692
21692
  compared as bit sequence.
21693
21693
  .sp
21694
21694
  It doesn\(aqt require the default match columns such as \fBfull text
21695
- search condition\fP and \fBphrase search condition\fP.
21695
+ search condition\fP and \fBphrase search condition\fP\&.
21696
21696
  .sp
21697
21697
  Here is a simple exmaple.
21698
21698
  .sp
@@ -21753,13 +21753,13 @@ select Entries \-\-query n_likes:>=10
21753
21753
  .UNINDENT
21754
21754
  .sp
21755
21755
  The expression matches records that \fBn_likes\fP column value is
21756
- greater than or equal to \fB10\fP.
21756
+ greater than or equal to \fB10\fP\&.
21757
21757
  .SS Combined expression
21758
21758
  .sp
21759
21759
  Here is available combined expression list.
21760
21760
  .SS Logical OR
21761
21761
  .sp
21762
- Its syntax is \fBa OR b\fP.
21762
+ Its syntax is \fBa OR b\fP\&.
21763
21763
  .sp
21764
21764
  \fBa\fP and \fBb\fP are conditional expressions, conbinded expressions or
21765
21765
  assignment expressions.
@@ -21829,14 +21829,14 @@ greater than \fB10\fP or contain a word \fBsenna\fP in \fBcontent\fP column
21829
21829
  value.
21830
21830
  .SS Logical AND
21831
21831
  .sp
21832
- Its syntax is \fBa + b\fP or just \fBa b\fP.
21832
+ Its syntax is \fBa + b\fP or just \fBa b\fP\&.
21833
21833
  .sp
21834
21834
  \fBa\fP and \fBb\fP are conditional expressions, conbinded expressions or
21835
21835
  assignment expressions.
21836
21836
  .sp
21837
21837
  If both \fBa\fP and \fBb\fP are matched, \fBa + b\fP is matched.
21838
21838
  .sp
21839
- You can specify \fB+\fP the first expression such as \fB+a\fP. The \fB+\fP
21839
+ You can specify \fB+\fP the first expression such as \fB+a\fP\&. The \fB+\fP
21840
21840
  is just ignored.
21841
21841
  .sp
21842
21842
  Here is a simple exmaple.
@@ -21896,14 +21896,14 @@ greater than or equal to \fB10\fP and contain a word \fBgroonga\fP in
21896
21896
  \fBcontent\fP column value.
21897
21897
  .SS Logical NOT
21898
21898
  .sp
21899
- Its syntax is \fBa \- b\fP.
21899
+ Its syntax is \fBa \- b\fP\&.
21900
21900
  .sp
21901
21901
  \fBa\fP and \fBb\fP are conditional expressions, conbinded expressions or
21902
21902
  assignment expressions.
21903
21903
  .sp
21904
21904
  If \fBa\fP is matched and \fBb\fP is not matched, \fBa \- b\fP is matched.
21905
21905
  .sp
21906
- You can not specify \fB\-\fP the first expression such as \fB\-a\fP. It\(aqs
21906
+ You can not specify \fB\-\fP the first expression such as \fB\-a\fP\&. It\(aqs
21907
21907
  syntax error.
21908
21908
  .sp
21909
21909
  Here is a simple exmaple.
@@ -21963,7 +21963,7 @@ greater than or equal to \fB10\fP and don\(aqt contain a word \fBgroonga\fP in
21963
21963
  \fBcontent\fP column value.
21964
21964
  .SS Grouping
21965
21965
  .sp
21966
- Its syntax is \fB(...)\fP. \fB...\fP is space separated expression list.
21966
+ Its syntax is \fB(...)\fP\&. \fB\&...\fP is space separated expression list.
21967
21967
  .sp
21968
21968
  \fB(...)\fP groups one ore more expressions and they can be
21969
21969
  processed as an expression. \fBa b OR c\fP means that \fBa\fP and \fBb\fP
@@ -22091,9 +22091,9 @@ Assignment expression in query syntax has some limitations. So you
22091
22091
  should use \fB/reference/grn_expr/script_syntax\fP instead of query syntax for
22092
22092
  assignment.
22093
22093
  .sp
22094
- There is only one syntax for assignment expression. It\(aqs \fBcolumn:=value\fP.
22094
+ There is only one syntax for assignment expression. It\(aqs \fBcolumn:=value\fP\&.
22095
22095
  .sp
22096
- \fBvalue\fP is assigend to \fBcolumn\fP. \fBvalue\fP is always processed as
22096
+ \fBvalue\fP is assigend to \fBcolumn\fP\&. \fBvalue\fP is always processed as
22097
22097
  string in query syntax. \fBvalue\fP is casted to the type of \fBcolumn\fP
22098
22098
  automatically. It causes some limitations. For example, you cannot use
22099
22099
  boolean literal such as \fBtrue\fP and \fBfalse\fP for \fBBool\fP type
@@ -22105,7 +22105,7 @@ See \fB/reference/cast\fP about cast.
22105
22105
  .sp
22106
22106
  Script syntax is a syntax to specify complex search condition. It is
22107
22107
  similar to ECMAScript. For example, \fB_key == "book"\fP means that
22108
- groonga searches records that \fB_key\fP value is \fB"book"\fP. All values
22108
+ groonga searches records that \fB_key\fP value is \fB"book"\fP\&. All values
22109
22109
  are string in \fBquery_syntax\fP but its own type in script
22110
22110
  syntax. For example, \fB"book"\fP is string, \fB1\fP is integer,
22111
22111
  \fBTokenBigram\fP is the object whose name is \fBTokenBigram\fP and so on.
@@ -22164,7 +22164,7 @@ load \-\-table Entries
22164
22164
  .sp
22165
22165
  There is a table, \fBEntries\fP, for blog entries. An entry has title,
22166
22166
  content and the number of likes for the entry. Title is key of
22167
- \fBEntries\fP. Content is value of \fBEntries.content\fP column. The
22167
+ \fBEntries\fP\&. Content is value of \fBEntries.content\fP column. The
22168
22168
  number of likes is value of \fBEntries.n_likes\fP column.
22169
22169
  .sp
22170
22170
  \fBEntries._key\fP column and \fBEntries.content\fP column are indexed
@@ -22176,8 +22176,8 @@ OK. The schema and data for examples are ready.
22176
22176
  .SS Integer
22177
22177
  .sp
22178
22178
  Integer literal is sequence of \fB0\fP to \fB9\fP such as
22179
- \fB1234567890\fP. \fB+\fP or \fB\-\fP can be prepended as sign such as
22180
- \fB+29\fP and \fB\-29\fP. Integer literal must be decimal. Octal notation,
22179
+ \fB1234567890\fP\&. \fB+\fP or \fB\-\fP can be prepended as sign such as
22180
+ \fB+29\fP and \fB\-29\fP\&. Integer literal must be decimal. Octal notation,
22181
22181
  hex and so on can\(aqt be used.
22182
22182
  .sp
22183
22183
  The maximum value of integer literal is \fB9223372036854775807\fP (\fB= 2
@@ -22185,15 +22185,15 @@ The maximum value of integer literal is \fB9223372036854775807\fP (\fB= 2
22185
22185
  \fB\-9223372036854775808\fP (\fB= \-(2 ** 63)\fP).
22186
22186
  .SS Float
22187
22187
  .sp
22188
- Float literal is sequence of \fB0\fP to \fB9\fP, \fB.\fP and \fB0\fP to \fB9\fP
22189
- such as \fB3.14\fP. \fB+\fP or \fB\-\fP can be prepended as sign such as
22190
- \fB+3.14\fP and \fB\-3.14\fP. \fB${RADIX}e${EXPORNENTIAL}\fP and
22188
+ Float literal is sequence of \fB0\fP to \fB9\fP, \fB\&.\fP and \fB0\fP to \fB9\fP
22189
+ such as \fB3.14\fP\&. \fB+\fP or \fB\-\fP can be prepended as sign such as
22190
+ \fB+3.14\fP and \fB\-3.14\fP\&. \fB${RADIX}e${EXPORNENTIAL}\fP and
22191
22191
  \fB${RADIX}E${EXPORNENTIAL}\fP formats are also supported. For example,
22192
- \fB314e\-2\fP is the same as \fB3.14\fP.
22192
+ \fB314e\-2\fP is the same as \fB3.14\fP\&.
22193
22193
  .SS String
22194
22194
  .sp
22195
- String literal is \fB"..."\fP. You need to escape \fB"\fP in literal by
22196
- prepending \fB\e\e\(aq\(aq such as \(ga\(ga\e"\fP. For example, \fB"Say \e"Hello!\e"."\fP is
22195
+ String literal is \fB"..."\fP\&. You need to escape \fB"\fP in literal by
22196
+ prepending \fB\e\e\(aq\(aq such as \(ga\(ga\e"\fP\&. For example, \fB"Say \e"Hello!\e"."\fP is
22197
22197
  a literal for \fBSay "Hello!".\fP string.
22198
22198
  .sp
22199
22199
  String encoding must be the same as encoding of database. The default
@@ -22202,11 +22202,11 @@ configure option, \fB\-\-encodiong\fP \fB/reference/executables/groonga\fP optio
22202
22202
  and so on.
22203
22203
  .SS Boolean
22204
22204
  .sp
22205
- Boolean literal is \fBtrue\fP and \fBfalse\fP. \fBtrue\fP means true and
22205
+ Boolean literal is \fBtrue\fP and \fBfalse\fP\&. \fBtrue\fP means true and
22206
22206
  \fBfalse\fP means false.
22207
22207
  .SS Null
22208
22208
  .sp
22209
- Null literal is \fBnull\fP. Groonga doesn\(aqt support null value but null
22209
+ Null literal is \fBnull\fP\&. Groonga doesn\(aqt support null value but null
22210
22210
  literal is supported.
22211
22211
  .SS Time
22212
22212
  .sp
@@ -22221,7 +22221,7 @@ Time literal doesn\(aqt exit. There are string time notation, integer
22221
22221
  time notation and float time notation.
22222
22222
  .sp
22223
22223
  String time notation is \fB"YYYY/MM/DD hh:mm:ss.uuuuuu"\fP or
22224
- \fB"YYYY\-MM\-DD hh:mm:ss.uuuuuu"\fP. \fBYYYY\fP is year, \fBMM\fP is month,
22224
+ \fB"YYYY\-MM\-DD hh:mm:ss.uuuuuu"\fP\&. \fBYYYY\fP is year, \fBMM\fP is month,
22225
22225
  \fBDD\fP is day, \fBhh\fP is hour, \fBmm\fP is minute, \fBss\fP is second and
22226
22226
  \fBuuuuuu\fP is micro second. It is local time. For example,
22227
22227
  \fB"2012/07/23 02:41:10.436218"\fP is \fB2012\-07\-23T02:41:10.436218\fP in
@@ -22266,15 +22266,15 @@ String geo point notation has the following patterns:
22266
22266
  be represented in milliseconds or degree.
22267
22267
  .SS Array
22268
22268
  .sp
22269
- Array literal is \fB[element1, element2, ...]\fP.
22269
+ Array literal is \fB[element1, element2, ...]\fP\&.
22270
22270
  .SS Object literal
22271
22271
  .sp
22272
- Object literal is \fB{name1: value1, name2: value2, ...}\fP. Groonga
22272
+ Object literal is \fB{name1: value1, name2: value2, ...}\fP\&. Groonga
22273
22273
  doesn\(aqt support object literal yet.
22274
22274
  .SS Control syntaxes
22275
22275
  .sp
22276
22276
  Script syntax doesn\(aqt support statement. So you cannot use control
22277
- statement such as \fBif\fP. You can only use \fBA ? B : C\fP expression as
22277
+ statement such as \fBif\fP\&. You can only use \fBA ? B : C\fP expression as
22278
22278
  control syntax.
22279
22279
  .sp
22280
22280
  \fBA ? B : C\fP returns \fBB\fP if \fBA\fP is true, \fBC\fP otherwise.
@@ -22345,10 +22345,10 @@ select Entries \-\-filter \(aqn_likes == (_id == 1 ? 5 : 3)\(aq
22345
22345
  .sp
22346
22346
  The expression matches records that \fB_id\fP column value is equal to \fB1\fP
22347
22347
  and \fBn_likes\fP column value is equal to \fB5\fP or \fB_id\fP column value is
22348
- not equal to 1 and \fBn_likes\fP column value is equal to \fB3\fP.
22348
+ not equal to 1 and \fBn_likes\fP column value is equal to \fB3\fP\&.
22349
22349
  .SS Grouping
22350
22350
  .sp
22351
- Its syntax is \fB(...)\fP. \fB...\fP is comma separated expression list.
22351
+ Its syntax is \fB(...)\fP\&. \fB\&...\fP is comma separated expression list.
22352
22352
  .sp
22353
22353
  \fB(...)\fP groups one ore more expressions and they can be processed as
22354
22354
  an expression. \fBa && b || c\fP means that \fBa\fP and \fBb\fP are matched
@@ -22467,10 +22467,10 @@ The second expression uses grouping. It matches records that \fBn_likes
22467
22467
  matched.
22468
22468
  .SS Function call
22469
22469
  .sp
22470
- Its syntax is \fBname(arugment1, argument2, ...)\fP.
22470
+ Its syntax is \fBname(arugment1, argument2, ...)\fP\&.
22471
22471
  .sp
22472
22472
  \fBname(argument1, argument2, ...)\fP calls a function that is named
22473
- \fBname\fP with arguments \fBargument1\fP, \fBargument2\fP and \fB...\fP.
22473
+ \fBname\fP with arguments \fBargument1\fP, \fBargument2\fP and \fB\&...\fP\&.
22474
22474
  .sp
22475
22475
  See \fB/reference/function\fP for available functin list.
22476
22476
  .sp
@@ -22532,9 +22532,9 @@ select Entries \-\-filter \(aqedit_distance(_key, "Groonga") <= 1\(aq
22532
22532
  .UNINDENT
22533
22533
  .UNINDENT
22534
22534
  .sp
22535
- The expression uses \fB/reference/functions/edit_distance\fP. It
22535
+ The expression uses \fB/reference/functions/edit_distance\fP\&. It
22536
22536
  matches records that \fB_key\fP column value is similar to
22537
- \fB"Groonga"\fP. Similality of \fB"Groonga"\fP is computed as edit
22537
+ \fB"Groonga"\fP\&. Similality of \fB"Groonga"\fP is computed as edit
22538
22538
  distance. If edit distance is less than or equal to 1, the value is
22539
22539
  treated as similar. In this case, \fB"Groonga"\fP and \fB"Mroonga"\fP are
22540
22540
  treated as similar.
@@ -22546,7 +22546,7 @@ Groonga supports operators defined in ECMAScript.
22546
22546
  Here are arithmetic operators.
22547
22547
  .SS Addition operator
22548
22548
  .sp
22549
- Its syntax is \fBnumber1 + number2\fP.
22549
+ Its syntax is \fBnumber1 + number2\fP\&.
22550
22550
  .sp
22551
22551
  The operator adds \fBnumber1\fP and \fBnumber2\fP and returns the result.
22552
22552
  .sp
@@ -22606,7 +22606,7 @@ The expression matches records that \fBn_likes\fP column value is equal
22606
22606
  to \fB15\fP (= \fB10 + 5\fP).
22607
22607
  .SS Subtraction operator
22608
22608
  .sp
22609
- Its syntax is \fBnumber1 \- number2\fP.
22609
+ Its syntax is \fBnumber1 \- number2\fP\&.
22610
22610
  .sp
22611
22611
  The operator subtracts \fBnumber2\fP from \fBnumber1\fP and returns the result.
22612
22612
  .sp
@@ -22666,7 +22666,7 @@ The expression matches records that \fBn_likes\fP column value is equal
22666
22666
  to \fB15\fP (= \fB20 \- 5\fP).
22667
22667
  .SS Multiplication operator
22668
22668
  .sp
22669
- Its syntax is \fBnumber1 * number2\fP.
22669
+ Its syntax is \fBnumber1 * number2\fP\&.
22670
22670
  .sp
22671
22671
  The operator multiplies \fBnumber1\fP and \fBnumber2\fP and returns the result.
22672
22672
  .sp
@@ -22726,9 +22726,9 @@ The expression matches records that \fBn_likes\fP column value is equal
22726
22726
  to \fB15\fP (= \fB3 * 5\fP).
22727
22727
  .SS Division operator
22728
22728
  .sp
22729
- Its syntax is \fBnumber1 / number2\fP and \fBnumber1 % number2\fP.
22729
+ Its syntax is \fBnumber1 / number2\fP and \fBnumber1 % number2\fP\&.
22730
22730
  .sp
22731
- The operator divides \fBnumber2\fP by \fBnumber1\fP. \fB/\fP returns the
22731
+ The operator divides \fBnumber2\fP by \fBnumber1\fP\&. \fB/\fP returns the
22732
22732
  quotient of result. \fB%\fP returns the remainder of result.
22733
22733
  .sp
22734
22734
  Here is simple examples.
@@ -22849,9 +22849,9 @@ to \fB5\fP (= \fB26 % 7\fP).
22849
22849
  Here are logical operators.
22850
22850
  .SS Logical NOT operator
22851
22851
  .sp
22852
- Its syntax is \fB!condition\fP.
22852
+ Its syntax is \fB!condition\fP\&.
22853
22853
  .sp
22854
- The operator inverts boolean value of \fBcondition\fP.
22854
+ The operator inverts boolean value of \fBcondition\fP\&.
22855
22855
  .sp
22856
22856
  Here is a simple example.
22857
22857
  .sp
@@ -22924,10 +22924,10 @@ select Entries \-\-filter \(aq!(n_likes == 5)\(aq
22924
22924
  .UNINDENT
22925
22925
  .sp
22926
22926
  The expression matches records that \fBn_likes\fP column value is not
22927
- equal to \fB5\fP.
22927
+ equal to \fB5\fP\&.
22928
22928
  .SS Logical AND operator
22929
22929
  .sp
22930
- Its syntax is \fBcondition1 && condition2\fP.
22930
+ Its syntax is \fBcondition1 && condition2\fP\&.
22931
22931
  .sp
22932
22932
  The operator returns true if both of \fBcondition1\fP and
22933
22933
  \fBcondition2\fP are true, false otherwise.
@@ -22992,10 +22992,10 @@ select Entries \-\-filter \(aqcontent @ "fast" && n_likes >= 10\(aq
22992
22992
  .sp
22993
22993
  The expression matches records that \fBcontent\fP column value has the
22994
22994
  word \fBfast\fP and \fBn_likes\fP column value is greater or equal to
22995
- \fB10\fP.
22995
+ \fB10\fP\&.
22996
22996
  .SS Logical OR operator
22997
22997
  .sp
22998
- Its syntax is \fBcondition1 || condition2\fP.
22998
+ Its syntax is \fBcondition1 || condition2\fP\&.
22999
22999
  .sp
23000
23000
  The operator returns true if either \fBcondition1\fP or \fBcondition2\fP is
23001
23001
  true, false otherwise.
@@ -23059,10 +23059,10 @@ select Entries \-\-filter \(aqn_likes == 5 || n_likes == 10\(aq
23059
23059
  .UNINDENT
23060
23060
  .sp
23061
23061
  The expression matches records that \fBn_likes\fP column value is equal
23062
- to \fB5\fP or \fB10\fP.
23062
+ to \fB5\fP or \fB10\fP\&.
23063
23063
  .SS Logical AND NOT operator
23064
23064
  .sp
23065
- Its syntax is \fBcondition1 &! condition2\fP.
23065
+ Its syntax is \fBcondition1 &! condition2\fP\&.
23066
23066
  .sp
23067
23067
  The operator returns true if \fBcondition1\fP is true but \fBcondition2\fP
23068
23068
  is false, false otherwise. It returns difference set.
@@ -23120,15 +23120,15 @@ select Entries \-\-filter \(aqcontent @ "fast" &! content @ "mroonga"\(aq
23120
23120
  .UNINDENT
23121
23121
  .sp
23122
23122
  The expression matches records that \fBcontent\fP column value has the
23123
- word \fBfast\fP but doesn\(aqt have the word \fBmroonga\fP.
23123
+ word \fBfast\fP but doesn\(aqt have the word \fBmroonga\fP\&.
23124
23124
  .SS Bitwise operators
23125
23125
  .sp
23126
23126
  Here are bitwise operators.
23127
23127
  .SS Bitwise NOT operator
23128
23128
  .sp
23129
- Its syntax is \fB~number\fP.
23129
+ Its syntax is \fB~number\fP\&.
23130
23130
  .sp
23131
- The operator returns bitwise NOT of \fBnumber\fP.
23131
+ The operator returns bitwise NOT of \fBnumber\fP\&.
23132
23132
  .sp
23133
23133
  Here is a simple example.
23134
23134
  .sp
@@ -23183,12 +23183,12 @@ select Entries \-\-filter \(aq~n_likes == \-6\(aq
23183
23183
  .UNINDENT
23184
23184
  .sp
23185
23185
  The expression matches records that \fBn_likes\fP column value is equal
23186
- to \fB5\fP because bitwise NOT of \fB5\fP is equal to \fB\-6\fP.
23186
+ to \fB5\fP because bitwise NOT of \fB5\fP is equal to \fB\-6\fP\&.
23187
23187
  .SS Bitwise AND operator
23188
23188
  .sp
23189
- Its syntax is \fBnumber1 & number2\fP.
23189
+ Its syntax is \fBnumber1 & number2\fP\&.
23190
23190
  .sp
23191
- The operator returns bitwise AND between \fBnumber1\fP and \fBnumber2\fP.
23191
+ The operator returns bitwise AND between \fBnumber1\fP and \fBnumber2\fP\&.
23192
23192
  .sp
23193
23193
  Here is a simple example.
23194
23194
  .sp
@@ -23263,12 +23263,12 @@ select Entries \-\-filter \(aq(n_likes & 1) == 1\(aq
23263
23263
  The expression matches records that \fBn_likes\fP column value is even
23264
23264
  number because bitwise AND between an even number and \fB1\fP is equal
23265
23265
  to \fB1\fP and bitwise AND between an odd number and \fB1\fP is equal to
23266
- \fB0\fP.
23266
+ \fB0\fP\&.
23267
23267
  .SS Bitwise OR operator
23268
23268
  .sp
23269
- Its syntax is \fBnumber1 | number2\fP.
23269
+ Its syntax is \fBnumber1 | number2\fP\&.
23270
23270
  .sp
23271
- The operator returns bitwise OR between \fBnumber1\fP and \fBnumber2\fP.
23271
+ The operator returns bitwise OR between \fBnumber1\fP and \fBnumber2\fP\&.
23272
23272
  .sp
23273
23273
  Here is a simple example.
23274
23274
  .sp
@@ -23326,9 +23326,9 @@ The expression matches records that \fBn_likes\fP column value is equal
23326
23326
  to \fB5\fP (= \fB1 | 4\fP).
23327
23327
  .SS Bitwise XOR operator
23328
23328
  .sp
23329
- Its syntax is \fBnumber1 ^ number2\fP.
23329
+ Its syntax is \fBnumber1 ^ number2\fP\&.
23330
23330
  .sp
23331
- The operator returns bitwise XOR between \fBnumber1\fP and \fBnumber2\fP.
23331
+ The operator returns bitwise XOR between \fBnumber1\fP and \fBnumber2\fP\&.
23332
23332
  .sp
23333
23333
  Here is a simple example.
23334
23334
  .sp
@@ -23389,10 +23389,10 @@ to \fB5\fP (= \fB10 ^ 15\fP).
23389
23389
  Here are shift operators.
23390
23390
  .SS Left shift operator
23391
23391
  .sp
23392
- Its syntax is \fBnumber1 << number2\fP.
23392
+ Its syntax is \fBnumber1 << number2\fP\&.
23393
23393
  .sp
23394
23394
  The operator performs a bitwise left shift operation on \fBnumber1\fP by
23395
- \fBnumber2\fP.
23395
+ \fBnumber2\fP\&.
23396
23396
  .sp
23397
23397
  Here is a simple example.
23398
23398
  .sp
@@ -23450,10 +23450,10 @@ The expression matches records that \fBn_likes\fP column value is equal
23450
23450
  to \fB10\fP (= \fB5 << 1\fP).
23451
23451
  .SS Signed right shift operator
23452
23452
  .sp
23453
- Its syntax is \fBnumber1 >> number2\fP.
23453
+ Its syntax is \fBnumber1 >> number2\fP\&.
23454
23454
  .sp
23455
- The operator shifts bits of \fBnumber1\fP to right by \fBnumber2\fP. The sign
23456
- of the result is the same as \fBnumber1\fP.
23455
+ The operator shifts bits of \fBnumber1\fP to right by \fBnumber2\fP\&. The sign
23456
+ of the result is the same as \fBnumber1\fP\&.
23457
23457
  .sp
23458
23458
  Here is a simple example.
23459
23459
  .sp
@@ -23511,10 +23511,10 @@ The expression matches records that \fBn_likes\fP column value is equal
23511
23511
  to \fB5\fP (= \fB\-(\-10 >> 1)\fP = \fB\-(\-5)\fP).
23512
23512
  .SS Unsigned right shift operator
23513
23513
  .sp
23514
- Its syntax is \fBnumber1 >>> number2\fP.
23514
+ Its syntax is \fBnumber1 >>> number2\fP\&.
23515
23515
  .sp
23516
- The operator shifts bits of \fBnumber1\fP to right by \fBnumber2\fP. The
23517
- leftmost \fBnumber2\fP bits are filled by \fB0\fP.
23516
+ The operator shifts bits of \fBnumber1\fP to right by \fBnumber2\fP\&. The
23517
+ leftmost \fBnumber2\fP bits are filled by \fB0\fP\&.
23518
23518
  .sp
23519
23519
  Here is a simple example.
23520
23520
  .sp
@@ -23575,7 +23575,7 @@ to \fB5\fP (= \fB2147483648 \- (\-10 >>> 1)\fP = \fB2147483648 \- 2147483643\fP)
23575
23575
  Here are comparison operators.
23576
23576
  .SS Equal operator
23577
23577
  .sp
23578
- Its syntax is \fBobject1 == object2\fP.
23578
+ Its syntax is \fBobject1 == object2\fP\&.
23579
23579
  .sp
23580
23580
  The operator returns true if \fBobject1\fP equals to \fBobject2\fP, false
23581
23581
  otherwise.
@@ -23633,10 +23633,10 @@ select Entries \-\-filter \(aqn_likes == 5\(aq
23633
23633
  .UNINDENT
23634
23634
  .sp
23635
23635
  The expression matches records that \fBn_likes\fP column value is equal
23636
- to \fB5\fP.
23636
+ to \fB5\fP\&.
23637
23637
  .SS Not equal operator
23638
23638
  .sp
23639
- Its syntax is \fBobject1 != object2\fP.
23639
+ Its syntax is \fBobject1 != object2\fP\&.
23640
23640
  .sp
23641
23641
  The operator returns true if \fBobject1\fP does not equal to
23642
23642
  \fBobject2\fP, false otherwise.
@@ -23712,7 +23712,7 @@ select Entries \-\-filter \(aqn_likes != 5\(aq
23712
23712
  .UNINDENT
23713
23713
  .sp
23714
23714
  The expression matches records that \fBn_likes\fP column value is not
23715
- equal to \fB5\fP.
23715
+ equal to \fB5\fP\&.
23716
23716
  .SS Less than operator
23717
23717
  .sp
23718
23718
  TODO: ...
@@ -23728,7 +23728,7 @@ TODO: ...
23728
23728
  .SS Assignment operators
23729
23729
  .SS Addition assignment operator
23730
23730
  .sp
23731
- Its syntax is \fBcolumn1 += column2\fP.
23731
+ Its syntax is \fBcolumn1 += column2\fP\&.
23732
23732
  .sp
23733
23733
  The operator performs addition assginment operation on column1 by column2.
23734
23734
  .sp
@@ -23806,7 +23806,7 @@ is 3.
23806
23806
  So the expression \fB1 + 3\fP is evaluated and stored to \fB_score\fP column as the execution result.
23807
23807
  .SS Subtraction assignment operator
23808
23808
  .sp
23809
- Its syntax is \fBcolumn1 \-= column2\fP.
23809
+ Its syntax is \fBcolumn1 \-= column2\fP\&.
23810
23810
  .sp
23811
23811
  The operator performs subtraction assginment operation on column1 by column2.
23812
23812
  .sp
@@ -23884,7 +23884,7 @@ is 3.
23884
23884
  So the expression \fB1 \- 3\fP is evaluated and stored to \fB_score\fP column as the execution result.
23885
23885
  .SS Multiplication assignment operator
23886
23886
  .sp
23887
- Its syntax is \fBcolumn1 *= column2\fP.
23887
+ Its syntax is \fBcolumn1 *= column2\fP\&.
23888
23888
  .sp
23889
23889
  The operator performs multiplication assginment operation on column1 by column2.
23890
23890
  .sp
@@ -23962,7 +23962,7 @@ is 3.
23962
23962
  So the expression \fB1 * 3\fP is evaluated and stored to \fB_score\fP column as the execution result.
23963
23963
  .SS Division assignment operator
23964
23964
  .sp
23965
- Its syntax is \fBcolumn1 /= column2\fP.
23965
+ Its syntax is \fBcolumn1 /= column2\fP\&.
23966
23966
  .sp
23967
23967
  The operator performs division assginment operation on column1 by column2.
23968
23968
  .sp
@@ -24040,7 +24040,7 @@ is 3.
24040
24040
  So the expression \fB1 / 3\fP is evaluated and stored to \fB_score\fP column as the execution result.
24041
24041
  .SS Modulo assignment operator
24042
24042
  .sp
24043
- Its syntax is \fBcolumn1 %= column2\fP.
24043
+ Its syntax is \fBcolumn1 %= column2\fP\&.
24044
24044
  .sp
24045
24045
  The operator performs modulo assginment operation on column1 by column2.
24046
24046
  .sp
@@ -24118,7 +24118,7 @@ is 3.
24118
24118
  So the expression \fB1 % 3\fP is evaluated and stored to \fB_score\fP column as the execution result.
24119
24119
  .SS Bitwise left shift assignment operator
24120
24120
  .sp
24121
- Its syntax is \fBcolumn1 <<= column2\fP.
24121
+ Its syntax is \fBcolumn1 <<= column2\fP\&.
24122
24122
  .sp
24123
24123
  The operator performs left shift assginment operation on column1 by column2.
24124
24124
  .sp
@@ -24196,17 +24196,17 @@ is 3.
24196
24196
  So the expression \fB1 << 3\fP is evaluated and stored to \fB_score\fP column as the execution result.
24197
24197
  .SS Bitwise signed right shift assignment operator
24198
24198
  .sp
24199
- Its syntax is \fBcolumn2 >>= column2\fP.
24199
+ Its syntax is \fBcolumn2 >>= column2\fP\&.
24200
24200
  .sp
24201
24201
  The operator performs signed right shift assginment operation on column1 by column2.
24202
24202
  .SS Bitwise unsigned right shift assignment operator
24203
24203
  .sp
24204
- Its syntax is \fBcolumn1 >>>= column2\fP.
24204
+ Its syntax is \fBcolumn1 >>>= column2\fP\&.
24205
24205
  .sp
24206
24206
  The operator performs unsigned right shift assginment operation on column1 by column2.
24207
24207
  .SS Bitwise AND assignment operator
24208
24208
  .sp
24209
- Its syntax is \fBcolumn1 &= column2\fP.
24209
+ Its syntax is \fBcolumn1 &= column2\fP\&.
24210
24210
  .sp
24211
24211
  The operator performs bitwise AND assignment operation on column1 by column2.
24212
24212
  .sp
@@ -24284,7 +24284,7 @@ is 10.
24284
24284
  So the expression \fB1 & 10\fP is evaluated and stored to \fB_score\fP column as the execution result.
24285
24285
  .SS Bitwise OR assignment operator
24286
24286
  .sp
24287
- Its syntax is \fBcolumn1 |= column2\fP.
24287
+ Its syntax is \fBcolumn1 |= column2\fP\&.
24288
24288
  .sp
24289
24289
  The operator performs bitwise OR assignment operation on column1 by column2.
24290
24290
  .sp
@@ -24362,7 +24362,7 @@ is 10.
24362
24362
  So the expression \fB1 | 10\fP is evaluated and stored to \fB_score\fP column as the execution result.
24363
24363
  .SS Bitwise XOR assignment operator
24364
24364
  .sp
24365
- Its syntax is \fBcolumn1 ^= column2\fP.
24365
+ Its syntax is \fBcolumn1 ^= column2\fP\&.
24366
24366
  .sp
24367
24367
  The operator performs bitwise XOR assginment operation on column1 by column2.
24368
24368
  .sp
@@ -24442,12 +24442,12 @@ So the expression \fB1 ^ 3\fP is evaluated and stored to \fB_score\fP column as
24442
24442
  .sp
24443
24443
  Script syntax adds the original binary opearators to ECMAScript
24444
24444
  syntax. They operate search specific operations. They are starts with
24445
- \fB@\fP or \fB*\fP.
24445
+ \fB@\fP or \fB*\fP\&.
24446
24446
  .SS Match operator
24447
24447
  .sp
24448
- Its syntax is \fBcolumn @ value\fP.
24448
+ Its syntax is \fBcolumn @ value\fP\&.
24449
24449
  .sp
24450
- The operator searches \fBvalue\fP by inverted index of \fBcolumn\fP.
24450
+ The operator searches \fBvalue\fP by inverted index of \fBcolumn\fP\&.
24451
24451
  Normally, full text search is operated but tag search can be operated.
24452
24452
  Because tag search is also implemented by inverted index.
24453
24453
  .sp
@@ -24497,17 +24497,17 @@ The expression matches records that contain a word \fBfast\fP in
24497
24497
  \fBcontent\fP column value.
24498
24498
  .SS Prefix search operator
24499
24499
  .sp
24500
- Its syntax is \fBcolumn @^ value\fP.
24500
+ Its syntax is \fBcolumn @^ value\fP\&.
24501
24501
  .sp
24502
- The operator does prefix search with \fBvalue\fP. Prefix search searches
24503
- records that contain a word that starts with \fBvalue\fP.
24502
+ The operator does prefix search with \fBvalue\fP\&. Prefix search searches
24503
+ records that contain a word that starts with \fBvalue\fP\&.
24504
24504
  .sp
24505
24505
  You can use fast prefix search against a column. The column must be
24506
24506
  indexed and index table must be patricia trie table
24507
24507
  (\fBTABLE_PAT_KEY\fP) or double array trie table
24508
24508
  (\fBTABLE_DAT_KEY\fP). You can also use fast prefix search against
24509
24509
  \fB_key\fP pseudo column of patricia trie table or double array trie
24510
- table. You don\(aqt need to index \fB_key\fP.
24510
+ table. You don\(aqt need to index \fB_key\fP\&.
24511
24511
  .sp
24512
24512
  Prefix search can be used with other table types but it causes all
24513
24513
  records scan. It\(aqs not problem for small records but it spends more
@@ -24558,17 +24558,17 @@ The expression matches records that contain a word that starts with
24558
24558
  \fBGood\-bye Tritonn\fP are matched with the expression.
24559
24559
  .SS Suffix search operator
24560
24560
  .sp
24561
- Its syntax is \fBcolumn @$ value\fP.
24561
+ Its syntax is \fBcolumn @$ value\fP\&.
24562
24562
  .sp
24563
- This operator does suffix search with \fBvalue\fP. Suffix search
24564
- searches records that contain a word that ends with \fBvalue\fP.
24563
+ This operator does suffix search with \fBvalue\fP\&. Suffix search
24564
+ searches records that contain a word that ends with \fBvalue\fP\&.
24565
24565
  .sp
24566
24566
  You can use fast suffix search against a column. The column must be
24567
24567
  indexed and index table must be patricia trie table
24568
24568
  (\fBTABLE_PAT_KEY\fP) with \fBKEY_WITH_SIS\fP flag. You can also use fast
24569
24569
  suffix search against \fB_key\fP pseudo column of patricia trie table
24570
24570
  (\fBTABLE_PAT_KEY\fP) with \fBKEY_WITH_SIS\fP flag. You don\(aqt need to
24571
- index \fB_key\fP. We recommended that you use index column based fast
24571
+ index \fB_key\fP\&. We recommended that you use index column based fast
24572
24572
  suffix search instead of \fB_key\fP based fast suffix search. \fB_key\fP
24573
24573
  based fast suffix search returns automatically registered
24574
24574
  substrings. (TODO: write document about suffix search and link to it
@@ -24656,9 +24656,9 @@ in \fBcontent\fP column value. \fBぐるんが\fP and \fBむるんが\fP are mat
24656
24656
  with the expression.
24657
24657
  .SS Near search operator
24658
24658
  .sp
24659
- Its syntax is \fBcolumn *N "word1 word2 ..."\fP.
24659
+ Its syntax is \fBcolumn *N "word1 word2 ..."\fP\&.
24660
24660
  .sp
24661
- The operator does near search with words \fBword1 word2 ...\fP. Near
24661
+ The operator does near search with words \fBword1 word2 ...\fP\&. Near
24662
24662
  search searches records that contain the words and the words are
24663
24663
  appeared in the near distance. Near distance is always \fB10\fP for
24664
24664
  now. The unit of near distance is the number of characters in N\-gram
@@ -24671,7 +24671,7 @@ only word into tokens. So the unit for ASCII words with
24671
24671
  N\-gram family tokenizer.)
24672
24672
  .sp
24673
24673
  Note that an index column for full text search must be defined for
24674
- \fBcolumn\fP.
24674
+ \fBcolumn\fP\&.
24675
24675
  .sp
24676
24676
  Here is a simple exmaple.
24677
24677
  .sp
@@ -24755,14 +24755,14 @@ also very fast! Really fast!\fP is matched. The number of words between
24755
24755
  \fBalso\fP and \fBReally\fP is 10.
24756
24756
  .SS Similar search
24757
24757
  .sp
24758
- Its syntax is \fBcolumn *S "document"\fP.
24758
+ Its syntax is \fBcolumn *S "document"\fP\&.
24759
24759
  .sp
24760
- The operator does similar search with document \fBdocument\fP. Similar
24760
+ The operator does similar search with document \fBdocument\fP\&. Similar
24761
24761
  search searches records that have similar content to
24762
- \fBdocument\fP.
24762
+ \fBdocument\fP\&.
24763
24763
  .sp
24764
24764
  Note that an index column for full text search must be defined for
24765
- \fBcolumn\fP.
24765
+ \fBcolumn\fP\&.
24766
24766
  .sp
24767
24767
  Here is a simple exmaple.
24768
24768
  .sp
@@ -24805,14 +24805,14 @@ select Entries \-\-filter \(aqcontent *S "I migrated all Solr system!"\(aq \-\-o
24805
24805
  .UNINDENT
24806
24806
  .sp
24807
24807
  The expression matches records that have similar content to \fBI
24808
- migrated all Solr system!\fP. In this case, records that have \fBI
24808
+ migrated all Solr system!\fP\&. In this case, records that have \fBI
24809
24809
  migrated all XXX system!\fP content are matched.
24810
24810
  .SS Term extract operator
24811
24811
  .sp
24812
- Its syntax is \fB_key *T "document"\fP.
24812
+ Its syntax is \fB_key *T "document"\fP\&.
24813
24813
  .sp
24814
- The operator extracts terms from \fBdocument\fP. Terms must be
24815
- registered as keys of the table of \fB_key\fP.
24814
+ The operator extracts terms from \fBdocument\fP\&. Terms must be
24815
+ registered as keys of the table of \fB_key\fP\&.
24816
24816
  .sp
24817
24817
  Note that the table must be patricia trie (\fBTABLE_PAT_KEY\fP) or
24818
24818
  double array trie (\fBTABLE_DAT_KEY\fP). You can\(aqt use hash table
@@ -24871,9 +24871,9 @@ select Words \-\-filter \(aq_key *T "Groonga is the successor project to Senna."
24871
24871
  .UNINDENT
24872
24872
  .sp
24873
24873
  The expression extrcts terms that included in document \fBGroonga is
24874
- the successor project to Senna.\fP. In this case, \fBKEY_NORMALIZE\fP
24875
- flag is specified to \fBWords\fP. So \fBGroonga\fP can be extracted even
24876
- if it is loaded as \fBgroonga\fP into \fBWords\fP. All of extracted terms
24874
+ the successor project to Senna.\fP\&. In this case, \fBKEY_NORMALIZE\fP
24875
+ flag is specified to \fBWords\fP\&. So \fBGroonga\fP can be extracted even
24876
+ if it is loaded as \fBgroonga\fP into \fBWords\fP\&. All of extracted terms
24877
24877
  are also normalized.
24878
24878
  .SS See also
24879
24879
  .INDENT 0.0
@@ -24888,7 +24888,7 @@ are also normalized.
24888
24888
  .sp
24889
24889
  Function can be used in some commands. For example, you can use
24890
24890
  function in \fB\-\-filter\fP, \fB\-\-scorer\fP and \fBoutput_columns\fP
24891
- options of \fBcommands/select\fP.
24891
+ options of \fBcommands/select\fP\&.
24892
24892
  .sp
24893
24893
  This section describes about function and built\-in functions.
24894
24894
  .sp
@@ -24897,7 +24897,7 @@ TODO: Add documentations about function.
24897
24897
  .SS Summary
24898
24898
  .sp
24899
24899
  \fBbetween\fP is used for checking the specified value exists in the specific range.
24900
- It is often used for combination with \fIselect\-filter\fP option in \fB/reference/commands/select\fP.
24900
+ It is often used for combination with \fIselect\-filter\fP option in \fB/reference/commands/select\fP\&.
24901
24901
  .SS Syntax
24902
24902
  .sp
24903
24903
  \fBbetween\fP has five parameters:
@@ -25076,7 +25076,7 @@ In the above case, it returns all the records, because 14 exists in between 13 a
25076
25076
  This behavior is used for checking the specified value exists or not in the table.
25077
25077
  .SS Parameters
25078
25078
  .sp
25079
- There are five required parameters, \fBcolumn_or_value\fP, and \fBmin\fP, \fBmin_border\fP, \fBmax\fP and \fBmax_border\fP.
25079
+ There are five required parameters, \fBcolumn_or_value\fP, and \fBmin\fP, \fBmin_border\fP, \fBmax\fP and \fBmax_border\fP\&.
25080
25080
  .SS \fBcolumn_or_value\fP
25081
25081
  .sp
25082
25082
  It specifies a column of the table or the value.
@@ -25116,7 +25116,7 @@ edit_distance(string1, string2)
25116
25116
  .UNINDENT
25117
25117
  .SS 説明
25118
25118
  .sp
25119
- groonga組込関数の一つであるedit_distanceについて説明します。組込関数は、script形式のgrn_expr中で呼び出すことができます。
25119
+ Groonga組込関数の一つであるedit_distanceについて説明します。組込関数は、script形式のgrn_expr中で呼び出すことができます。
25120
25120
  .sp
25121
25121
  edit_distance() 関数は、string1に指定した文字列とstring2に指定した文字列の間の編集距離を求めます。
25122
25122
  .SS 引数
@@ -25169,27 +25169,27 @@ geo_distance(point1, point2, approximate_type)
25169
25169
  .UNINDENT
25170
25170
  .UNINDENT
25171
25171
  .sp
25172
- The default value of \fBapproximate_type\fP is \fB"rectangle"\fP.
25172
+ The default value of \fBapproximate_type\fP is \fB"rectangle"\fP\&.
25173
25173
  If you omit \fBapproximate_type\fP, \fBgeo_distance\fP calculates the value of
25174
25174
  distance as if \fB"rectangle"\fP was specified.
25175
25175
  .SS Usage
25176
25176
  .sp
25177
- \fBgeo_distance\fP is one of the groonga builtin functions.
25177
+ \fBgeo_distance\fP is one of the Groonga builtin functions.
25178
25178
  .sp
25179
25179
  You can call a builtin function in \fB/reference/grn_expr\fP
25180
25180
  .sp
25181
25181
  \fBgeo_distance\fP function calculates the value of distance (approximate value)
25182
- between the coordinate of \fBpoint1\fP and the coordinate of \fBpoint2\fP.
25182
+ between the coordinate of \fBpoint1\fP and the coordinate of \fBpoint2\fP\&.
25183
25183
  .sp
25184
25184
  \fBNOTE:\fP
25185
25185
  .INDENT 0.0
25186
25186
  .INDENT 3.5
25187
- groonga provides three built in functions for calculating the value of distance.
25188
- There are \fBgeo_distance()\fP, \fBgeo_distance2()\fP and \fBgeo_distance3()\fP.
25187
+ Groonga provides three built in functions for calculating the value of distance.
25188
+ There are \fBgeo_distance()\fP, \fBgeo_distance2()\fP and \fBgeo_distance3()\fP\&.
25189
25189
  The difference of them is the algorithm of calculating distance.
25190
25190
  \fBgeo_distance2()\fP and \fBgeo_distance3()\fP were deprecated since version 1.2.9.
25191
- Use \fBgeo_distance(point1, point2, "sphere")\fP instead of \fBgeo_distance2(point1, point2)\fP.
25192
- Use \fBgeo_distance(point1, point2, "ellipsoid")\fP instead of \fBgeo_distance3(point1, point2)\fP.
25191
+ Use \fBgeo_distance(point1, point2, "sphere")\fP instead of \fBgeo_distance2(point1, point2)\fP\&.
25192
+ Use \fBgeo_distance(point1, point2, "ellipsoid")\fP instead of \fBgeo_distance3(point1, point2)\fP\&.
25193
25193
  .UNINDENT
25194
25194
  .UNINDENT
25195
25195
  .sp
@@ -25253,7 +25253,7 @@ load \-\-table Cities
25253
25253
  .UNINDENT
25254
25254
  .UNINDENT
25255
25255
  .sp
25256
- This execution example creates a table named \fBCities\fP which has one column named \fBlocation\fP.
25256
+ This execution example creates a table named \fBCities\fP which has one column named \fBlocation\fP\&.
25257
25257
  \fBlocation\fP column stores the value of coordinate.
25258
25258
  The coordinate of Tokyo is stored as sample data.
25259
25259
  .sp
@@ -25340,7 +25340,7 @@ load \-\-table Geo
25340
25340
  .UNINDENT
25341
25341
  .UNINDENT
25342
25342
  .sp
25343
- This execution example creates a table named \fBGeo\fP which has one column named \fBdistance\fP.
25343
+ This execution example creates a table named \fBGeo\fP which has one column named \fBdistance\fP\&.
25344
25344
  \fBdistance\fP column stores the value of distance.
25345
25345
  .sp
25346
25346
  Execution example:
@@ -25383,7 +25383,7 @@ and the coordinate of New York to calculate distance.
25383
25383
  .SS Parameters
25384
25384
  .SS Required parameter
25385
25385
  .sp
25386
- There are two required parameter, \fBpoint1\fP and \fBpoint2\fP.
25386
+ There are two required parameter, \fBpoint1\fP and \fBpoint2\fP\&.
25387
25387
  .SS \fBpoint1\fP
25388
25388
  .sp
25389
25389
  It specifies the start point that
@@ -25403,7 +25403,7 @@ the string indicating the coordinate.
25403
25403
  See \fB/reference/types\fP about GeoPoint and the coordinate.
25404
25404
  .SS Optional parameter
25405
25405
  .sp
25406
- There is a optional parameter, \fBapproximate_type\fP.
25406
+ There is a optional parameter, \fBapproximate_type\fP\&.
25407
25407
  .SS \fBapproximate_type\fP
25408
25408
  .sp
25409
25409
  It specifies how to approximate the geographical features for calculating
@@ -25426,11 +25426,11 @@ You can specify the value of \fBapproximate_type\fP by one of the followings.
25426
25426
  \fBNOTE:\fP
25427
25427
  .INDENT 0.0
25428
25428
  .INDENT 3.5
25429
- There is a limitation about \fBgeo_distance\fP. \fBgeo_distance\fP can not
25429
+ There is a limitation about \fBgeo_distance\fP\&. \fBgeo_distance\fP can not
25430
25430
  calculate the value of distance between two points across meridian,
25431
25431
  equator or the date line if you use \fBsphere\fP or \fBellipsoid\fP as
25432
- approximate type. There is not such a limitation for \fBrectangle\fP.
25433
- This is temporary limitation according to the implementation of groonga,
25432
+ approximate type. There is not such a limitation for \fBrectangle\fP\&.
25433
+ This is temporary limitation according to the implementation of Groonga,
25434
25434
  but it will be fixed in the future release.
25435
25435
  .UNINDENT
25436
25436
  .UNINDENT
@@ -25647,7 +25647,7 @@ The return value of \fBgeo_distance("143660000x419009000", "135960000x\-44076000
25647
25647
  .INDENT 3.5
25648
25648
  \fBgeo_distance\fP accepts the string indicating the coordinate as
25649
25649
  the value of \fBpoint1\fP when the value of \fBapproximate_type\fP is
25650
- \fB"rectangle"\fP.
25650
+ \fB"rectangle"\fP\&.
25651
25651
  If you specified the string indicating the coordinate as the value
25652
25652
  of \fBpoint1\fP with \fBsphere\fP or \fBellipsoid\fP, \fBgeo_distance\fP
25653
25653
  returns 0 as the value of distance.
@@ -25659,7 +25659,7 @@ This parameter require to approximate the geographical features
25659
25659
  by spherical approximation for calculating the distance.
25660
25660
  .sp
25661
25661
  It is slower than \fBrectangle\fP, but the error of distance becomes
25662
- smaller than \fBrectangle\fP.
25662
+ smaller than \fBrectangle\fP\&.
25663
25663
  .sp
25664
25664
  You can also specify \fBsphr\fP as abbrev expression.
25665
25665
  .sp
@@ -25706,7 +25706,7 @@ by ellipsoid approximation for calculating the distance.
25706
25706
  .sp
25707
25707
  It uses the calculation of distance by the formula of Hubeny.
25708
25708
  It is slower than \fBsphere\fP, but the error of distance becomes
25709
- smaller than \fBsphere\fP.
25709
+ smaller than \fBsphere\fP\&.
25710
25710
  .sp
25711
25711
  You can also specify \fBellip\fP as abbrev expression.
25712
25712
  .sp
@@ -25770,7 +25770,7 @@ geo_in_circle(point, center, radious_or_point[, approximate_type])
25770
25770
  .UNINDENT
25771
25771
  .SS 説明
25772
25772
  .sp
25773
- groonga組込関数の一つであるgeo_in_circleについて説明します。組込関数は、script形式のgrn_expr中で呼び出すことができます。
25773
+ Groonga組込関数の一つであるgeo_in_circleについて説明します。組込関数は、script形式のgrn_expr中で呼び出すことができます。
25774
25774
  .sp
25775
25775
  geo_in_circle() 関数は、pointに指定した座標が、centerに指定した座標を中心とする円の範囲内にあるかどうかを調べます。
25776
25776
  .SS 引数
@@ -25867,7 +25867,7 @@ geo_in_rectangle(point, top_left, bottom_right)
25867
25867
  .UNINDENT
25868
25868
  .SS 説明
25869
25869
  .sp
25870
- groonga組込関数の一つであるgeo_in_rectangleについて説明します。組込関数は、script形式のgrn_expr中で呼び出すことができます。
25870
+ Groonga組込関数の一つであるgeo_in_rectangleについて説明します。組込関数は、script形式のgrn_expr中で呼び出すことができます。
25871
25871
  .sp
25872
25872
  geo_in_rectangle() 関数は、pointに指定した座標が、top_leftとbottom_rightがなす矩形の範囲内にあるかどうかを調べます。
25873
25873
  .SS 引数
@@ -25915,10 +25915,10 @@ TokyoGeoPoint(日本測地系座標)かWGS84GeoPoint(世界測地系座標)の
25915
25915
  .sp
25916
25916
  \fBhtml_untag\fP strips HTML tags from HTML and outputs plain text.
25917
25917
  .sp
25918
- \fBhtml_untag\fP is used in \fB\-\-output_columns\fP described at \fIoutput_columns\fP.
25918
+ \fBhtml_untag\fP is used in \fB\-\-output_columns\fP described at \fIoutput_columns\fP\&.
25919
25919
  .SS Syntax
25920
25920
  .sp
25921
- \fBhtml_untag\fP requires only one argument. It is \fBhtml\fP.
25921
+ \fBhtml_untag\fP requires only one argument. It is \fBhtml\fP\&.
25922
25922
  .INDENT 0.0
25923
25923
  .INDENT 3.5
25924
25924
  .sp
@@ -25931,7 +25931,7 @@ html_untag(html)
25931
25931
  .UNINDENT
25932
25932
  .SS Requirements
25933
25933
  .sp
25934
- \fBhtml_untag\fP requires groonga 3.0.5 or later.
25934
+ \fBhtml_untag\fP requires Groonga 3.0.5 or later.
25935
25935
  .sp
25936
25936
  \fBhtml_untag\fP requires \fB/reference/command/command_version\fP 2 or
25937
25937
  later.
@@ -26019,7 +26019,7 @@ When executing the above query, you can see "span" tag with "class" attribute is
26019
26019
  Note that you must specify \fB\-\-command_version 2\fP to use \fBhtml_untag\fP function.
26020
26020
  .SS Parameters
26021
26021
  .sp
26022
- There is one required parameter, \fBhtml\fP.
26022
+ There is one required parameter, \fBhtml\fP\&.
26023
26023
  .SS \fBhtml\fP
26024
26024
  .sp
26025
26025
  It specifies HTML text to be untagged.
@@ -26043,7 +26043,7 @@ now()
26043
26043
  .UNINDENT
26044
26044
  .SS 説明
26045
26045
  .sp
26046
- groonga組込関数の一つであるnowについて説明します。組込関数は、script形式のgrn_expr中で呼び出すことができます。
26046
+ Groonga組込関数の一つであるnowについて説明します。組込関数は、script形式のgrn_expr中で呼び出すことができます。
26047
26047
  .sp
26048
26048
  now() 関数は現在時刻に対応するTime型の値を返します。
26049
26049
  .SS 返値
@@ -26067,16 +26067,16 @@ now()
26067
26067
  \fBquery\fP provides \fB\-\-match_columns\fP and \fB\-\-query\fP parameters of
26068
26068
  \fB/reference/commands/select\fP feature as function. You can specify
26069
26069
  multiple \fBquery\fP functions in \fB\-\-filter\fP parameter in
26070
- \fB/reference/commands/select\fP.
26070
+ \fB/reference/commands/select\fP\&.
26071
26071
  .sp
26072
26072
  Because of such flexibility, you can control full text search behavior
26073
26073
  by combination of multiple \fBquery\fP functions.
26074
26074
  .sp
26075
26075
  \fBquery\fP can be used in only \fB\-\-filter\fP in
26076
- \fB/reference/commands/select\fP.
26076
+ \fB/reference/commands/select\fP\&.
26077
26077
  .SS Syntax
26078
26078
  .sp
26079
- \fBquery\fP requires two arguments \- \fBmatch_columns\fP and \fBquery_string\fP.
26079
+ \fBquery\fP requires two arguments \- \fBmatch_columns\fP and \fBquery_string\fP\&.
26080
26080
  .sp
26081
26081
  The parameter \fBquery_expander\fP or \fBsubstitution_table\fP is optional.
26082
26082
  .INDENT 0.0
@@ -26154,7 +26154,7 @@ load \-\-table Users
26154
26154
  .sp
26155
26155
  Here is the simple usage of \fBquery\fP function which execute full text
26156
26156
  search by keyword \(aqalice\(aq without using \fB\-\-match_columns\fP and
26157
- \fB\-\-query\fP arguments in \fB\-\-filter\fP.
26157
+ \fB\-\-query\fP arguments in \fB\-\-filter\fP\&.
26158
26158
  .sp
26159
26159
  Execution example:
26160
26160
  .INDENT 0.0
@@ -26199,7 +26199,7 @@ select Users \-\-output_columns name,_score \-\-filter \(aqquery("name * 10", "a
26199
26199
  When executing above query, the keyword \(aqalice\(aq is weighted to the value \-
26200
26200
  \(aq10\(aq.
26201
26201
  .sp
26202
- Here are the contrasting examples with/without \fBquery\fP.
26202
+ Here are the contrasting examples with/without \fBquery\fP\&.
26203
26203
  .sp
26204
26204
  Execution example:
26205
26205
  .INDENT 0.0
@@ -26343,20 +26343,20 @@ keywords on your purpose.
26343
26343
  .SS Parameters
26344
26344
  .SS Required parameter
26345
26345
  .sp
26346
- There are two required parameter, \fBmatch_columns\fP and \fBquery_string\fP.
26346
+ There are two required parameter, \fBmatch_columns\fP and \fBquery_string\fP\&.
26347
26347
  .SS \fBmatch_columns\fP
26348
26348
  .sp
26349
26349
  It specifies the default target column for fulltext search by
26350
26350
  \fBquery_string\fP parameter value. It is the same role as
26351
- \fIselect\-match\-columns\fP parameter in \fBselect\fP.
26351
+ \fIselect\-match\-columns\fP parameter in \fBselect\fP\&.
26352
26352
  .SS \fBquery_string\fP
26353
26353
  .sp
26354
26354
  It specifies the search condition in
26355
- \fB/reference/grn_expr/query_syntax\fP. It is the same role as
26356
- \fBquery\fP parameter in \fBselect\fP.
26355
+ \fB/reference/grn_expr/query_syntax\fP\&. It is the same role as
26356
+ \fBquery\fP parameter in \fBselect\fP\&.
26357
26357
  .sp
26358
26358
  See \fIselect\-match\-columns\fP about \fBquery\fP parameter in
26359
- \fBselect\fP.
26359
+ \fBselect\fP\&.
26360
26360
  .SS Optional parameter
26361
26361
  .sp
26362
26362
  There are some optional parameters.
@@ -26364,7 +26364,7 @@ There are some optional parameters.
26364
26364
  .sp
26365
26365
  It specifies the plugin name for query expansion.
26366
26366
  .sp
26367
- There is one plugin bundled in official release \- \fB/reference/query_expanders/tsv\fP.
26367
+ There is one plugin bundled in official release \- \fB/reference/query_expanders/tsv\fP\&.
26368
26368
  .sp
26369
26369
  See \fB/reference/query_expanders/tsv\fP about details.
26370
26370
  .SS \fBsubstitution_table\fP
@@ -26376,8 +26376,8 @@ See \fIquery\-expander\fP about details.
26376
26376
  .SS Return value
26377
26377
  .sp
26378
26378
  \fBquery\fP returns whether any record is matched or not. If one or more
26379
- records are matched, it returns \fBtrue\fP. Otherwise, it returns
26380
- \fBfalse\fP.
26379
+ records are matched, it returns \fBtrue\fP\&. Otherwise, it returns
26380
+ \fBfalse\fP\&.
26381
26381
  .SS TODO
26382
26382
  .INDENT 0.0
26383
26383
  .IP \(bu 2
@@ -26405,7 +26405,7 @@ rand([max])
26405
26405
  .UNINDENT
26406
26406
  .SS 説明
26407
26407
  .sp
26408
- groonga組込関数の一つであるrandについて説明します。組込関数は、script形式のgrn_expr中で呼び出すことができます。
26408
+ Groonga組込関数の一つであるrandについて説明します。組込関数は、script形式のgrn_expr中で呼び出すことができます。
26409
26409
  .sp
26410
26410
  rand() 関数は 0 から max の間の疑似乱数整数を返します。
26411
26411
  .SS 引数
@@ -26442,12 +26442,12 @@ This feature is experimental. API will be changed.
26442
26442
  .SS Summary
26443
26443
  .sp
26444
26444
  \fBsnippet_html\fP extracts snippets of target text around search
26445
- keywords (\fBKWIC\fP. \fBKeyWord In Context\fP). The snippets are prepared
26445
+ keywords (\fBKWIC\fP\&. \fBKeyWord In Context\fP). The snippets are prepared
26446
26446
  for embedding HTML. Special characters such as \fB<\fP and \fB>\fP are
26447
- escapsed as \fB&lt;\fP and \fB&gt;\fP. Keyword is surrounded with \fB<span
26448
- class="keyword">\fP and \fB</span>\fP. For example, a snippet of \fBI am a
26447
+ escapsed as \fB&lt;\fP and \fB&gt;\fP\&. Keyword is surrounded with \fB<span
26448
+ class="keyword">\fP and \fB</span>\fP\&. For example, a snippet of \fBI am a
26449
26449
  groonga user. <3\fP for keyword \fBgroonga\fP is \fBI am a <span
26450
- class="keyword">groonga</span> user. &lt;3\fP.
26450
+ class="keyword">groonga</span> user. &lt;3\fP\&.
26451
26451
  .SS Syntax
26452
26452
  .sp
26453
26453
  \fBsnippet_html\fP has only one parameter:
@@ -26495,16 +26495,16 @@ load \-\-table Documents
26495
26495
  .UNINDENT
26496
26496
  .sp
26497
26497
  \fBsnippet_html\fP can be used in only \fB\-\-output_columns\fP in
26498
- \fB/reference/commands/select\fP.
26498
+ \fB/reference/commands/select\fP\&.
26499
26499
  .sp
26500
26500
  You need to specify \fB\-\-command_version 2\fP argument explicitly
26501
26501
  because function call in \fB\-\-output_columns\fP is experimental feature
26502
- in groonga 2.0.9. It will be enabled by default soon.
26502
+ in Groonga 2.0.9. It will be enabled by default soon.
26503
26503
  .sp
26504
- You also need to specify \fB\-\-query\fP and/or \fB\-\-filter\fP. Keywords are
26504
+ You also need to specify \fB\-\-query\fP and/or \fB\-\-filter\fP\&. Keywords are
26505
26505
  extracted from \fB\-\-query\fP and \fB\-\-filter\fP arguments.
26506
26506
  .sp
26507
- The following example uses \fB\-\-query "fast performance"\fP. In this
26507
+ The following example uses \fB\-\-query "fast performance"\fP\&. In this
26508
26508
  case, \fBfast\fP and \fBperformance\fP are used as keywords.
26509
26509
  .sp
26510
26510
  Execution example:
@@ -26548,14 +26548,14 @@ select Documents \-\-output_columns "snippet_html(content)" \-\-command_version
26548
26548
  \fB\-\-query "fast performance"\fP matches to only the first record\(aqs
26549
26549
  content. \fBsnippet_html(content)\fP extracts two text parts that
26550
26550
  include the keywords \fBfast\fP or \fBperformance\fP and surronds the
26551
- keywords with \fB<span class="keyword">\fP and \fB</span>\fP.
26551
+ keywords with \fB<span class="keyword">\fP and \fB</span>\fP\&.
26552
26552
  .sp
26553
26553
  The max number of text parts is 3. If there are 4 or more text parts
26554
26554
  that include the keywords, only the leading 3 parts are only used.
26555
26555
  .sp
26556
26556
  The max size of a text part is 200byte. The unit is bytes not
26557
26557
  chracters. The size doesn\(aqt include inserted \fB<span keyword="keyword">\fP
26558
- and \fB</span>\fP.
26558
+ and \fB</span>\fP\&.
26559
26559
  .sp
26560
26560
  Both the max number of text parts and the max size of a text part
26561
26561
  aren\(aqt customizable.
@@ -26600,8 +26600,10 @@ select Documents \-\-output_columns \(aqsnippet_html("Groonga is very fast fullt
26600
26600
  .UNINDENT
26601
26601
  .SS Return value
26602
26602
  .sp
26603
- \fBsnippet_html\fP returns an array of string. An element of array is a
26604
- snippet:
26603
+ \fBsnippet_html\fP returns an array of string or \fBnull\fP\&. If
26604
+ \fBsnippet_html\fP can\(aqt find any snippets, it returns \fBnull\fP\&.
26605
+ .sp
26606
+ An element of array is a snippet:
26605
26607
  .INDENT 0.0
26606
26608
  .INDENT 3.5
26607
26609
  .sp
@@ -26645,11 +26647,11 @@ Support options by object literal.
26645
26647
  \fBsub_filter\fP evaluates \fBfilter_string\fP in \fBscope\fP context.
26646
26648
  .sp
26647
26649
  \fBsub_filter\fP can be used in only \fB\-\-filter\fP in
26648
- \fB/reference/commands/select\fP.
26650
+ \fB/reference/commands/select\fP\&.
26649
26651
  .SS Syntax
26650
26652
  .sp
26651
26653
  \fBsub_filter\fP requires two arguments. They are \fBscope\fP and
26652
- \fBfilter_string\fP.
26654
+ \fBfilter_string\fP\&.
26653
26655
  .INDENT 0.0
26654
26656
  .INDENT 3.5
26655
26657
  .sp
@@ -26828,32 +26830,32 @@ There are the records that user "A" mentions about "groonga".
26828
26830
  .UNINDENT
26829
26831
  .SS Parameters
26830
26832
  .sp
26831
- There are two required parameter, \fBscope\fP and \fBfilter_string\fP.
26833
+ There are two required parameter, \fBscope\fP and \fBfilter_string\fP\&.
26832
26834
  .SS \fBscope\fP
26833
26835
  .sp
26834
26836
  It specifies a column of the table that is specified by \fBtable\fP
26835
- parameter in \fBselect\fP. The column has a limitation. The limitation
26837
+ parameter in \fBselect\fP\&. The column has a limitation. The limitation
26836
26838
  is described later. \fBfilter_string\fP is evaluated in the column
26837
26839
  context. It means that \fBfilter_string\fP is evaluated like
26838
- \fBselect \-\-table TYPE_OF_THE_COLUMN \-\-filter FILTER_STRING\fP.
26840
+ \fBselect \-\-table TYPE_OF_THE_COLUMN \-\-filter FILTER_STRING\fP\&.
26839
26841
  .sp
26840
26842
  The specified column type must be a table. In other words, the column
26841
26843
  type must be reference type.
26842
26844
  .sp
26843
26845
  You can chain columns by \fBCOLUMN_1.COLUMN_2.COLUMN_3...COLUMN_N\fP
26844
- syntax. For example, \fBuser.group.name\fP.
26846
+ syntax. For example, \fBuser.group.name\fP\&.
26845
26847
  .sp
26846
- See \fIselect\-table\fP about \fBtable\fP parameter in \fBselect\fP.
26848
+ See \fIselect\-table\fP about \fBtable\fP parameter in \fBselect\fP\&.
26847
26849
  .SS \fBfilter_string\fP
26848
26850
  .sp
26849
26851
  It specifies a search condition in
26850
- \fB/reference/grn_expr/script_syntax\fP. It is evaluated in \fBscope\fP
26852
+ \fB/reference/grn_expr/script_syntax\fP\&. It is evaluated in \fBscope\fP
26851
26853
  context.
26852
26854
  .SS Return value
26853
26855
  .sp
26854
26856
  \fBsub_filter\fP returns whether any record is matched or not. If one or
26855
- more records are matched, it returns \fBtrue\fP. Otherwise, it returns
26856
- \fBfalse\fP.
26857
+ more records are matched, it returns \fBtrue\fP\&. Otherwise, it returns
26858
+ \fBfalse\fP\&.
26857
26859
  .SS See also
26858
26860
  .INDENT 0.0
26859
26861
  .IP \(bu 2
@@ -26977,7 +26979,7 @@ select Tweets \-\-match_columns content \-\-query \(aqgood nice\(aq
26977
26979
  .UNINDENT
26978
26980
  .UNINDENT
26979
26981
  .sp
26980
- We create index for \fBTweets.content\fP. Already registered
26982
+ We create index for \fBTweets.content\fP\&. Already registered
26981
26983
  data in \fBTweets.content\fP are indexed by offline index
26982
26984
  construction:
26983
26985
  .sp
@@ -27112,7 +27114,7 @@ Process log is enabled by default. Log path can be
27112
27114
  customized by \fI\-\-log\-path\fP option. Each log has its
27113
27115
  log level. If a log is smaller than groonga process\(aq log
27114
27116
  level, it\(aqs not logged. Log level can be customized by
27115
- \fI\-l\fP or \fBcommands/log_level\fP.
27117
+ \fI\-l\fP or \fBcommands/log_level\fP\&.
27116
27118
  .SS Format
27117
27119
  .sp
27118
27120
  Process log uses the following format:
@@ -27449,7 +27451,7 @@ Example:
27449
27451
  .SS Tuning
27450
27452
  .SS Summary
27451
27453
  .sp
27452
- There are some tuning parameters for improving groonga performance or
27454
+ There are some tuning parameters for improving Groonga performance or
27453
27455
  handling a large database.
27454
27456
  .SS Parameters
27455
27457
  .sp
@@ -27570,7 +27572,7 @@ or re\-login as your groonga user.
27570
27572
  .sp
27571
27573
  This is \fItuning\-memory\-usage\fP related parameter. You can handle a
27572
27574
  database that is larger than your memory and swap by setting
27573
- \fBvm.overcommit_memory\fP kernel parameter to 1. 1 means that groonga
27575
+ \fBvm.overcommit_memory\fP kernel parameter to 1. 1 means that Groonga
27574
27576
  can always map database files onto memory. It is no problem until
27575
27577
  groonga touch mapped database files that their size is larger than
27576
27578
  memory and swap. Groonga recommends the configuration.
@@ -27615,7 +27617,7 @@ than 16GiB, groonga reaches the limitation. (\fB256KiB * 65536 = 16GiB\fP)
27615
27617
  .sp
27616
27618
  You needs to increase the value of the kernel parameter to handle
27617
27619
  16GiB or more larger size database. For example, you can handle almost
27618
- 32GiB size database by \fB65536 * 2 = 131072\fP. You can set the
27620
+ 32GiB size database by \fB65536 * 2 = 131072\fP\&. You can set the
27619
27621
  configuration by putting a configuration file
27620
27622
  \fB/etc/sysctl.d/groonga.conf\fP that has the following content:
27621
27623
  .INDENT 0.0
@@ -27665,6 +27667,69 @@ TODO
27665
27667
  .sp
27666
27668
  Groonga can be used as a fulltext search library. This section
27667
27669
  describes APIs that are provided by groonga.
27670
+ .SS Global configurations
27671
+ .SS Summary
27672
+ .sp
27673
+ Groonga has the global configurations. You can access them by API.
27674
+ .SS Reference
27675
+ .INDENT 0.0
27676
+ .TP
27677
+ .B int grn_get_lock_timeout(void)
27678
+ Returns the lock timeout.
27679
+ .sp
27680
+ \fBgrn_ctx\fP acquires a lock for updating a shared value. If
27681
+ other \fBgrn_ctx\fP is already updating the same value,
27682
+ \fBgrn_ctx\fP that try to acquire a lock can\(aqt acquires a lock.
27683
+ The \fBgrn_ctx\fP that can\(aqt acquires a lock waits 1
27684
+ millisecond and try to acquire a lock again. The try is done
27685
+ \fBtimeout\fP times. If the \fBgrn_ctx\fP that can\(aqt acquires a
27686
+ lock until \fBtimeout\fP times, the tries are failed.
27687
+ .sp
27688
+ The default lock timeout is \fB10000000\fP\&. It means that Groonga
27689
+ doesn\(aqt report a lock failure until about 3 hours. (1 * 10000000
27690
+ [msec] = 10000 [sec] = 166.666... [min] = 2.777... [hour])
27691
+ .INDENT 7.0
27692
+ .TP
27693
+ .B Returns
27694
+ The lock timeout.
27695
+ .UNINDENT
27696
+ .UNINDENT
27697
+ .INDENT 0.0
27698
+ .TP
27699
+ .B grn_rc grn_set_lock_timeout(int\fI\ timeout\fP)
27700
+ Sets the lock timeout.
27701
+ .sp
27702
+ See
27703
+ .nf
27704
+ :c:function:\(gagrn_get_lock_timeout\(ga
27705
+ .fi
27706
+ about lock timeout.
27707
+ .sp
27708
+ There are some special values for \fBtimeout\fP\&.
27709
+ .INDENT 7.0
27710
+ .INDENT 3.5
27711
+ .INDENT 0.0
27712
+ .IP \(bu 2
27713
+ \fB0\fP: It means that Groonga doesn\(aqt retry acquiring a lock.
27714
+ Groonga reports a failure after one lock acquirement failure.
27715
+ .IP \(bu 2
27716
+ negative value: It means that Groonga retries acquiring a lock
27717
+ until Groonga can acquire a lock.
27718
+ .UNINDENT
27719
+ .UNINDENT
27720
+ .UNINDENT
27721
+ .INDENT 7.0
27722
+ .TP
27723
+ .B Parameters
27724
+ .INDENT 7.0
27725
+ .IP \(bu 2
27726
+ \fBtimeuot\fP \-\- The new lock timeout.
27727
+ .UNINDENT
27728
+ .TP
27729
+ .B Returns
27730
+ \fBGRN_SUCCESS\fP\&. It doesn\(aqt fail.
27731
+ .UNINDENT
27732
+ .UNINDENT
27668
27733
  .SS \fBgrn_cache\fP
27669
27734
  .SS Summary
27670
27735
  .sp
@@ -27680,7 +27745,7 @@ This API is experimental.
27680
27745
  object. It is only for \fB/reference/commands/select\fP command.
27681
27746
  .sp
27682
27747
  You can just change the current cache object by
27683
- \fBgrn_cache_current_set()\fP. \fB/reference/commands/select\fP
27748
+ \fBgrn_cache_current_set()\fP\&. \fB/reference/commands/select\fP
27684
27749
  command response cache is done internally.
27685
27750
  .sp
27686
27751
  \fB/reference/commands/select\fP command uses one global cache
@@ -27718,7 +27783,7 @@ grn_cache_current_set(ctx, cache_previous);
27718
27783
  .B grn_cache
27719
27784
  It is an opaque cache object. You can create a \fBgrn_cache\fP by
27720
27785
  \fBgrn_cache_open()\fP and free the created object by
27721
- \fBgrn_cache_close()\fP.
27786
+ \fBgrn_cache_close()\fP\&.
27722
27787
  .UNINDENT
27723
27788
  .INDENT 0.0
27724
27789
  .TP
@@ -27726,7 +27791,7 @@ It is an opaque cache object. You can create a \fBgrn_cache\fP by
27726
27791
  Creates a new cache object.
27727
27792
  .sp
27728
27793
  If memory allocation for the new cache object is failed, \fBNULL\fP
27729
- is returned. Error information is stored into the \fBctx\fP.
27794
+ is returned. Error information is stored into the \fBctx\fP\&.
27730
27795
  .INDENT 7.0
27731
27796
  .TP
27732
27797
  .B Parameters
@@ -27738,13 +27803,13 @@ is returned. Error information is stored into the \fBctx\fP.
27738
27803
  .B Returns
27739
27804
  A newly allocated cache object on success, \fBNULL\fP
27740
27805
  otherwise. The returned cache object must be freed by
27741
- \fBgrn_cache_close()\fP.
27806
+ \fBgrn_cache_close()\fP\&.
27742
27807
  .UNINDENT
27743
27808
  .UNINDENT
27744
27809
  .INDENT 0.0
27745
27810
  .TP
27746
27811
  .B grn_rc grn_cache_close(grn_ctx\fI\ *ctx\fP, grn_cache\fI\ *cache\fP)
27747
- Frees resourses of the \fBcache\fP.
27812
+ Frees resourses of the \fBcache\fP\&.
27748
27813
  .INDENT 7.0
27749
27814
  .TP
27750
27815
  .B Parameters
@@ -27794,7 +27859,7 @@ Gets the cache object that is used in
27794
27859
  .TP
27795
27860
  .B Returns
27796
27861
  The cache object that is used in
27797
- \fB/reference/commands/select\fP command. It may be \fBNULL\fP.
27862
+ \fB/reference/commands/select\fP command. It may be \fBNULL\fP\&.
27798
27863
  .UNINDENT
27799
27864
  .UNINDENT
27800
27865
  .INDENT 0.0
@@ -27846,7 +27911,7 @@ TODO...
27846
27911
  .INDENT 0.0
27847
27912
  .TP
27848
27913
  .B GRN_COLUMN_NAME_ID
27849
- It returns the name of \fB/reference/pseudo_column\fP \fB_id\fP.
27914
+ It returns the name of \fB/reference/pseudo_column\fP \fB_id\fP\&.
27850
27915
  .sp
27851
27916
  It is useful to use with \fBGRN_COLUMN_NAME_ID_LEN\fP like
27852
27917
  the following:
@@ -27867,14 +27932,14 @@ Since 3.1.1.
27867
27932
  .INDENT 0.0
27868
27933
  .TP
27869
27934
  .B GRN_COLUMN_NAME_ID_LEN
27870
- It returns the byte size of \fBGRN_COLUMN_NAME_ID\fP.
27935
+ It returns the byte size of \fBGRN_COLUMN_NAME_ID\fP\&.
27871
27936
  .sp
27872
27937
  Since 3.1.1.
27873
27938
  .UNINDENT
27874
27939
  .INDENT 0.0
27875
27940
  .TP
27876
27941
  .B GRN_COLUMN_NAME_KEY
27877
- It returns the name of \fB/reference/pseudo_column\fP \fB_key\fP.
27942
+ It returns the name of \fB/reference/pseudo_column\fP \fB_key\fP\&.
27878
27943
  .sp
27879
27944
  It is useful to use with \fBGRN_COLUMN_NAME_KEY_LEN\fP like
27880
27945
  the following:
@@ -27895,14 +27960,14 @@ Since 3.1.1.
27895
27960
  .INDENT 0.0
27896
27961
  .TP
27897
27962
  .B GRN_COLUMN_NAME_KEY_LEN
27898
- It returns the byte size of \fBGRN_COLUMN_NAME_KEY\fP.
27963
+ It returns the byte size of \fBGRN_COLUMN_NAME_KEY\fP\&.
27899
27964
  .sp
27900
27965
  Since 3.1.1.
27901
27966
  .UNINDENT
27902
27967
  .INDENT 0.0
27903
27968
  .TP
27904
27969
  .B GRN_COLUMN_NAME_VALUE
27905
- It returns the name of \fB/reference/pseudo_column\fP \fB_value\fP.
27970
+ It returns the name of \fB/reference/pseudo_column\fP \fB_value\fP\&.
27906
27971
  .sp
27907
27972
  It is useful to use with \fBGRN_COLUMN_NAME_VALUE_LEN\fP like
27908
27973
  the following:
@@ -27923,14 +27988,14 @@ Since 3.1.1.
27923
27988
  .INDENT 0.0
27924
27989
  .TP
27925
27990
  .B GRN_COLUMN_NAME_VALUE_LEN
27926
- It returns the byte size of \fBGRN_COLUMN_NAME_VALUE\fP.
27991
+ It returns the byte size of \fBGRN_COLUMN_NAME_VALUE\fP\&.
27927
27992
  .sp
27928
27993
  Since 3.1.1.
27929
27994
  .UNINDENT
27930
27995
  .INDENT 0.0
27931
27996
  .TP
27932
27997
  .B GRN_COLUMN_NAME_SCORE
27933
- It returns the name of \fB/reference/pseudo_column\fP \fB_score\fP.
27998
+ It returns the name of \fB/reference/pseudo_column\fP \fB_score\fP\&.
27934
27999
  .sp
27935
28000
  It is useful to use with \fBGRN_COLUMN_NAME_SCORE_LEN\fP like
27936
28001
  the following:
@@ -27951,14 +28016,14 @@ Since 3.1.1.
27951
28016
  .INDENT 0.0
27952
28017
  .TP
27953
28018
  .B GRN_COLUMN_NAME_SCORE_LEN
27954
- It returns the byte size of \fBGRN_COLUMN_NAME_SCORE\fP.
28019
+ It returns the byte size of \fBGRN_COLUMN_NAME_SCORE\fP\&.
27955
28020
  .sp
27956
28021
  Since 3.1.1.
27957
28022
  .UNINDENT
27958
28023
  .INDENT 0.0
27959
28024
  .TP
27960
28025
  .B GRN_COLUMN_NAME_NSUBRECS
27961
- It returns the name of \fB/reference/pseudo_column\fP \fB_nsubrecs\fP.
28026
+ It returns the name of \fB/reference/pseudo_column\fP \fB_nsubrecs\fP\&.
27962
28027
  .sp
27963
28028
  It is useful to use with \fBGRN_COLUMN_NAME_NSUBRECS_LEN\fP like
27964
28029
  the following:
@@ -27979,7 +28044,7 @@ Since 3.1.1.
27979
28044
  .INDENT 0.0
27980
28045
  .TP
27981
28046
  .B GRN_COLUMN_NAME_NSUBRECS_LEN
27982
- It returns the byte size of \fBGRN_COLUMN_NAME_NSUBRECS\fP.
28047
+ It returns the byte size of \fBGRN_COLUMN_NAME_NSUBRECS\fP\&.
27983
28048
  .sp
27984
28049
  Since 3.1.1.
27985
28050
  .UNINDENT
@@ -28220,7 +28285,7 @@ ctxを初期化します。
28220
28285
  .B grn_rc grn_ctx_fin(grn_ctx\fI\ *ctx\fP)
28221
28286
  ctxの管理するメモリを解放し、使用を終了します。
28222
28287
  .sp
28223
- If \fBctx\fP is initialized by \fBgrn_ctx_open()\fP not \fBgrn_ctx_init()\fP. You need also to call \fBgrn_ctx_close()\fP.
28288
+ If \fBctx\fP is initialized by \fBgrn_ctx_open()\fP not \fBgrn_ctx_init()\fP\&. You need also to call \fBgrn_ctx_close()\fP\&.
28224
28289
  .INDENT 7.0
28225
28290
  .TP
28226
28291
  .B Parameters
@@ -28256,13 +28321,13 @@ If \fBctx\fP is initialized by \fBgrn_ctx_open()\fP not \fBgrn_ctx_init()\fP. Yo
28256
28321
  .INDENT 0.0
28257
28322
  .TP
28258
28323
  .B grn_rc grn_ctx_close(grn_ctx\fI\ *ctx\fP)
28259
- It calls \fBgrn_ctx_fin()\fP and frees allocated memory for \fBctx\fP by \fBgrn_ctx_open()\fP.
28324
+ It calls \fBgrn_ctx_fin()\fP and frees allocated memory for \fBctx\fP by \fBgrn_ctx_open()\fP\&.
28260
28325
  .INDENT 7.0
28261
28326
  .TP
28262
28327
  .B Parameters
28263
28328
  .INDENT 7.0
28264
28329
  .IP \(bu 2
28265
- \fBctx\fP \-\- no longer needed \fBgrn_ctx\fP.
28330
+ \fBctx\fP \-\- no longer needed \fBgrn_ctx\fP\&.
28266
28331
  .UNINDENT
28267
28332
  .TP
28268
28333
  .B Returns
@@ -28371,7 +28436,7 @@ TODO...
28371
28436
  .INDENT 0.0
28372
28437
  .TP
28373
28438
  .B grn_db_create_optarg
28374
- It is used for specifying options for \fBgrn_db_create()\fP.
28439
+ It is used for specifying options for \fBgrn_db_create()\fP\&.
28375
28440
  .UNINDENT
28376
28441
  .INDENT 0.0
28377
28442
  .TP
@@ -28519,7 +28584,7 @@ is a list of what expression can do:
28519
28584
  .INDENT 0.0
28520
28585
  .IP \(bu 2
28521
28586
  Expression can apply some operations to a record by
28522
- \fBgrn_expr_exec()\fP.
28587
+ \fBgrn_expr_exec()\fP\&.
28523
28588
  .IP \(bu 2
28524
28589
  Expression can represents search condition. \fBgrn_table_select()\fP
28525
28590
  can select records that match against the search condition represented
@@ -28585,31 +28650,31 @@ TODO...
28585
28650
  .INDENT 0.0
28586
28651
  .TP
28587
28652
  .B grn_rc grn_expr_syntax_escape(grn_ctx\fI\ *ctx\fP, const char\fI\ *string\fP, int\fI\ string_size\fP, const char\fI\ *target_characters\fP, char\fI\ escape_character\fP, grn_obj\fI\ *escaped_string\fP)
28588
- Escapes \fBtarget_characters\fP in \fBstring\fP by \fBescape_character\fP.
28653
+ Escapes \fBtarget_characters\fP in \fBstring\fP by \fBescape_character\fP\&.
28589
28654
  .INDENT 7.0
28590
28655
  .TP
28591
28656
  .B Parameters
28592
28657
  .INDENT 7.0
28593
28658
  .IP \(bu 2
28594
- \fBctx\fP \-\- Its encoding must be the same encoding of \fBstring\fP.
28595
- It is used for allocating buffer for \fBescaped_string\fP.
28659
+ \fBctx\fP \-\- Its encoding must be the same encoding of \fBstring\fP\&.
28660
+ It is used for allocating buffer for \fBescaped_string\fP\&.
28596
28661
  .IP \(bu 2
28597
28662
  \fBstring\fP \-\- String expression representation.
28598
28663
  .IP \(bu 2
28599
- \fBstring_size\fP \-\- The byte size of \fBstring\fP. \fB\-1\fP means \fBstring\fP
28664
+ \fBstring_size\fP \-\- The byte size of \fBstring\fP\&. \fB\-1\fP means \fBstring\fP
28600
28665
  is NULL terminated string.
28601
28666
  .IP \(bu 2
28602
28667
  \fBtarget_characters\fP \-\- NULL terminated escape target characters.
28603
28668
  For example, \fB"+\-><~*()\e"\e\e:"\fP is
28604
28669
  \fBtarget_characters\fP for
28605
- \fB/reference/grn_expr/query_syntax\fP.
28670
+ \fB/reference/grn_expr/query_syntax\fP\&.
28606
28671
  .IP \(bu 2
28607
28672
  \fBescape_character\fP \-\- The character to use escape a character in
28608
- \fBtarget_characters\fP. For example, \fB\e\e\fP
28673
+ \fBtarget_characters\fP\&. For example, \fB\e\e\fP
28609
28674
  (backslash) is \fBescaped_character\fP for
28610
- \fB/reference/grn_expr/query_syntax\fP.
28675
+ \fB/reference/grn_expr/query_syntax\fP\&.
28611
28676
  .IP \(bu 2
28612
- \fBescaped_string\fP \-\- The output of escaped \fBstring\fP. It should be
28677
+ \fBescaped_string\fP \-\- The output of escaped \fBstring\fP\&. It should be
28613
28678
  text typed bulk.
28614
28679
  .UNINDENT
28615
28680
  .TP
@@ -28621,22 +28686,22 @@ text typed bulk.
28621
28686
  .TP
28622
28687
  .B grn_rc grn_expr_syntax_escape_query(grn_ctx\fI\ *ctx\fP, const char\fI\ *query\fP, int\fI\ query_size\fP, grn_obj\fI\ *escaped_query\fP)
28623
28688
  Escapes special characters in
28624
- \fB/reference/grn_expr/query_syntax\fP.
28689
+ \fB/reference/grn_expr/query_syntax\fP\&.
28625
28690
  .INDENT 7.0
28626
28691
  .TP
28627
28692
  .B Parameters
28628
28693
  .INDENT 7.0
28629
28694
  .IP \(bu 2
28630
- \fBctx\fP \-\- Its encoding must be the same encoding of \fBquery\fP.
28631
- It is used for allocating buffer for \fBescaped_query\fP.
28695
+ \fBctx\fP \-\- Its encoding must be the same encoding of \fBquery\fP\&.
28696
+ It is used for allocating buffer for \fBescaped_query\fP\&.
28632
28697
  .IP \(bu 2
28633
28698
  \fBquery\fP \-\- String expression representation in
28634
- \fB/reference/grn_expr/query_syntax\fP.
28699
+ \fB/reference/grn_expr/query_syntax\fP\&.
28635
28700
  .IP \(bu 2
28636
- \fBquery_size\fP \-\- The byte size of \fBquery\fP. \fB\-1\fP means \fBquery\fP
28701
+ \fBquery_size\fP \-\- The byte size of \fBquery\fP\&. \fB\-1\fP means \fBquery\fP
28637
28702
  is NULL terminated string.
28638
28703
  .IP \(bu 2
28639
- \fBescaped_query\fP \-\- The output of escaped \fBquery\fP. It should be
28704
+ \fBescaped_query\fP \-\- The output of escaped \fBquery\fP\&. It should be
28640
28705
  text typed bulk.
28641
28706
  .UNINDENT
28642
28707
  .TP
@@ -31075,37 +31140,37 @@ Then save the configuration value to /etc/sysctl.conf or /etc/sysctl.d/
31075
31140
  .nf
31076
31141
  *
31077
31142
  .fi
31078
- .conf.
31143
+ \&.conf.
31079
31144
  .sp
31080
31145
  See \fB/reference/tuning\fP documentation about tuning related parameters.
31081
31146
  .SH DEVELOPMENT
31082
31147
  .sp
31083
- This section describes about developing with groonga. You may develop
31084
- an application that uses groonga as its database, a library that uses
31148
+ This section describes about developing with Groonga. You may develop
31149
+ an application that uses Groonga as its database, a library that uses
31085
31150
  libgroonga, language bindings of libgroonga and so on.
31086
31151
  .SS Travis CI
31087
31152
  .sp
31088
- This section describes about using groonga on \fI\%Travis CI\fP. Travis CI is a hosted continuous
31153
+ This section describes about using Groonga on \fI\%Travis CI\fP\&. Travis CI is a hosted continuous
31089
31154
  integration service for the open source community.
31090
31155
  .sp
31091
31156
  You can use Travis CI for your open source software. This section only
31092
- describes about groonga related configuration. See \fI\%Travis CI:
31157
+ describes about Groonga related configuration. See \fI\%Travis CI:
31093
31158
  Documentation\fP about general
31094
31159
  Travis CI.
31095
31160
  .SS Configuration
31096
31161
  .sp
31097
31162
  Travis CI is running on 64\-bit Ubuntu 12.04 LTS Server Edition. (See \fI\%Travis CI: About
31098
- Travis CI Environment\fP.) You can
31099
- use apt\-line for Ubuntu 12.04 LTS provided by groonga project to install
31100
- groonga on Travis CI.
31163
+ Travis CI Environment\fP\&.) You can
31164
+ use apt\-line for Ubuntu 12.04 LTS provided by Groonga project to install
31165
+ Groonga on Travis CI.
31101
31166
  .sp
31102
- You can custom build lifecycle by \fB.travis.yml\fP. (See \fI\%Travis CI:
31103
- Conifugration your Travis CI build with .travis.yml\fP.) You
31167
+ You can custom build lifecycle by \fB\&.travis.yml\fP\&. (See \fI\%Travis CI:
31168
+ Conifugration your Travis CI build with .travis.yml\fP\&.) You
31104
31169
  can use \fBbefore_install\fP hook or \fBinstall\fP hook. You should use
31105
31170
  \fBbefore_install\fP if your software uses a language that is supported
31106
31171
  by Travis CI such as Ruby. You should use \fBinstall\fP otherwise.
31107
31172
  .sp
31108
- Add the following \fBbefore_install\fP configuration to \fB.travis.yml\fP:
31173
+ Add the following \fBbefore_install\fP configuration to \fB\&.travis.yml\fP:
31109
31174
  .INDENT 0.0
31110
31175
  .INDENT 3.5
31111
31176
  .sp
@@ -31119,12 +31184,12 @@ before_install:
31119
31184
  .UNINDENT
31120
31185
  .sp
31121
31186
  If you need to use \fBinstall\fP hook instead of \fBbefore_install\fP, you
31122
- just substitute \fBbefore_install:\fP with \fBinstall:\fP.
31187
+ just substitute \fBbefore_install:\fP with \fBinstall:\fP\&.
31123
31188
  .sp
31124
- With the above configuration, you can use groonga for your build.
31189
+ With the above configuration, you can use Groonga for your build.
31125
31190
  .SS Examples
31126
31191
  .sp
31127
- Here are open source softwares that use groonga on Travis CI:
31192
+ Here are open source softwares that use Groonga on Travis CI:
31128
31193
  .INDENT 0.0
31129
31194
  .INDENT 3.5
31130
31195
  .INDENT 0.0
@@ -31134,7 +31199,7 @@ Here are open source softwares that use groonga on Travis CI:
31134
31199
  .IP \(bu 2
31135
31200
  \fI\%rroonga on Travis CI\fP
31136
31201
  .IP \(bu 2
31137
- \fI\%.travis.yml for rroonga\fP
31202
+ \fI\%\&.travis.yml for rroonga\fP
31138
31203
  .UNINDENT
31139
31204
  .IP \(bu 2
31140
31205
  \fI\%nroonga\fP (node.js bindings)
@@ -31142,7 +31207,7 @@ Here are open source softwares that use groonga on Travis CI:
31142
31207
  .IP \(bu 2
31143
31208
  \fI\%nroonga on Travis CI\fP
31144
31209
  .IP \(bu 2
31145
- \fI\%.travis.yml for nroonga\fP
31210
+ \fI\%\&.travis.yml for nroonga\fP
31146
31211
  .UNINDENT
31147
31212
  .IP \(bu 2
31148
31213
  \fI\%logaling\-command\fP (A glossary management command line tool)
@@ -31150,7 +31215,7 @@ Here are open source softwares that use groonga on Travis CI:
31150
31215
  .IP \(bu 2
31151
31216
  \fI\%logaling\-command on Travis CI\fP
31152
31217
  .IP \(bu 2
31153
- \fI\%.travis.yml for logaling\-command\fP
31218
+ \fI\%\&.travis.yml for logaling\-command\fP
31154
31219
  .UNINDENT
31155
31220
  .UNINDENT
31156
31221
  .UNINDENT
@@ -31191,7 +31256,7 @@ You can use either way It makes no difference to us.
31191
31256
  .SS Submit a bug to the issue tracker
31192
31257
  .sp
31193
31258
  Groonga project has two issue tracking systems, \fI\%Redmine\fP and \fI\%GitHub
31194
- issue tracker\fP. Redmine
31259
+ issue tracker\fP\&. Redmine
31195
31260
  is for Japanese and GitHub issue tracker is for English. You can use
31196
31261
  one of them to report a bug.
31197
31262
  .SS Report a bug to the mailing list
@@ -31211,7 +31276,7 @@ We will use \fI\%the C domain markup\fP of Sphinx.
31211
31276
  .SS I18N
31212
31277
  .sp
31213
31278
  We only had documentation in Japanese. We start to support
31214
- I18N documentation by gettext based \fI\%Sphinx I18N feature\fP.
31279
+ I18N documentation by gettext based \fI\%Sphinx I18N feature\fP\&.
31215
31280
  We\(aqll use English as base language and translate
31216
31281
  English into other languages such as Japanese. We\(aqll put
31217
31282
  all documentations into doc/source/ and process them by
@@ -31368,7 +31433,7 @@ running \fImake html\fP on doc/locale:
31368
31433
  \fBNOTE:\fP
31369
31434
  .INDENT 0.0
31370
31435
  .INDENT 3.5
31371
- .mo files are updated automatically by \fImake html\fP. So
31436
+ \&.mo files are updated automatically by \fImake html\fP\&. So
31372
31437
  you don\(aqt care about .mo files.
31373
31438
  .UNINDENT
31374
31439
  .UNINDENT
@@ -31415,7 +31480,7 @@ button.
31415
31480
  \fBSEE ALSO:\fP
31416
31481
  .INDENT 0.0
31417
31482
  .INDENT 3.5
31418
- \fI\%Help.GitHub \- Sending pull requests\fP.
31483
+ \fI\%Help.GitHub \- Sending pull requests\fP\&.
31419
31484
  .UNINDENT
31420
31485
  .UNINDENT
31421
31486
  .SS How to send patch
@@ -31477,13 +31542,13 @@ as \(aqja\(aq.
31477
31542
  \fBSEE ALSO:\fP
31478
31543
  .INDENT 0.0
31479
31544
  .INDENT 3.5
31480
- \fI\%Codes for the Representation of Names of Languages\fP.
31545
+ \fI\%Codes for the Representation of Names of Languages\fP\&.
31481
31546
  .UNINDENT
31482
31547
  .UNINDENT
31483
31548
  .SS groonga開発者向け情報
31484
31549
  .SS Repository
31485
31550
  .sp
31486
- There is \fI\%the repository of groonga on GitHub\fP. If you want to check\-out groonga, type the below command:
31551
+ There is \fI\%the repository of groonga on GitHub\fP\&. If you want to check\-out groonga, type the below command:
31487
31552
  .INDENT 0.0
31488
31553
  .INDENT 3.5
31489
31554
  .sp
@@ -33143,6 +33208,6 @@ configureは1度のみ実行する必要があります。
33143
33208
  .SH AUTHOR
33144
33209
  Groonga Project
33145
33210
  .SH COPYRIGHT
33146
- 2009-2013, Brazil, Inc
33211
+ 2009-2014, Brazil, Inc
33147
33212
  .\" Generated by docutils manpage writer.
33148
33213
  .