rroonga 3.1.0-x86-mingw32 → 3.1.1-x86-mingw32
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
 - data/README.textile +1 -1
 - data/bin/grndump +5 -4
 - data/bin/grntest-log-analyze +5 -4
 - data/bin/groonga-database-inspect +11 -2
 - data/bin/groonga-index-dump +1 -0
 - data/doc/text/news.textile +21 -0
 - data/ext/groonga/rb-grn-expression.c +3 -3
 - data/ext/groonga/rb-grn.h +1 -1
 - data/lib/1.9/groonga.so +0 -0
 - data/lib/2.0/groonga.so +0 -0
 - data/lib/2.1/groonga.so +0 -0
 - data/lib/groonga/database-inspector.rb +34 -8
 - data/rroonga-build.rb +1 -1
 - data/test/test-database-inspector.rb +55 -5
 - data/test/test-expression.rb +65 -0
 - data/vendor/local/bin/groonga-benchmark.exe +0 -0
 - data/vendor/local/bin/groonga.exe +0 -0
 - data/vendor/local/bin/libgroonga-0.dll +0 -0
 - data/vendor/local/bin/libmecab-1.dll +0 -0
 - data/vendor/local/bin/libmsgpack-3.dll +0 -0
 - data/vendor/local/bin/libmsgpackc-2.dll +0 -0
 - data/vendor/local/bin/mecab-config +0 -0
 - data/vendor/local/bin/mecab.exe +0 -0
 - data/vendor/local/include/groonga/groonga.h +15 -4
 - data/vendor/local/lib/groonga/plugins/query_expanders/tsv.a +0 -0
 - data/vendor/local/lib/groonga/plugins/query_expanders/tsv.dll +0 -0
 - data/vendor/local/lib/groonga/plugins/query_expanders/tsv.dll.a +0 -0
 - data/vendor/local/lib/groonga/plugins/query_expanders/tsv.la +0 -0
 - data/vendor/local/lib/groonga/plugins/suggest/suggest.a +0 -0
 - data/vendor/local/lib/groonga/plugins/suggest/suggest.dll +0 -0
 - data/vendor/local/lib/groonga/plugins/suggest/suggest.dll.a +0 -0
 - data/vendor/local/lib/groonga/plugins/suggest/suggest.la +0 -0
 - data/vendor/local/lib/groonga/plugins/table/table.a +0 -0
 - data/vendor/local/lib/groonga/plugins/table/table.dll +0 -0
 - data/vendor/local/lib/groonga/plugins/table/table.dll.a +0 -0
 - data/vendor/local/lib/groonga/plugins/table/table.la +0 -0
 - data/vendor/local/lib/groonga/plugins/tokenizers/mecab.a +0 -0
 - data/vendor/local/lib/groonga/plugins/tokenizers/mecab.dll +0 -0
 - data/vendor/local/lib/groonga/plugins/tokenizers/mecab.dll.a +0 -0
 - data/vendor/local/lib/groonga/plugins/tokenizers/mecab.la +0 -0
 - data/vendor/local/lib/libgroonga.a +0 -0
 - data/vendor/local/lib/libgroonga.dll.a +0 -0
 - data/vendor/local/lib/libgroonga.la +0 -0
 - data/vendor/local/lib/libmecab.a +0 -0
 - data/vendor/local/lib/libmecab.dll.a +0 -0
 - data/vendor/local/lib/libmecab.la +0 -0
 - data/vendor/local/lib/libmsgpack.a +0 -0
 - data/vendor/local/lib/libmsgpack.dll.a +0 -0
 - data/vendor/local/lib/libmsgpack.la +0 -0
 - data/vendor/local/lib/libmsgpackc.a +0 -0
 - data/vendor/local/lib/libmsgpackc.dll.a +0 -0
 - data/vendor/local/lib/libmsgpackc.la +0 -0
 - data/vendor/local/lib/pkgconfig/groonga.pc +2 -2
 - data/vendor/local/libexec/mecab/mecab-cost-train.exe +0 -0
 - data/vendor/local/libexec/mecab/mecab-dict-gen.exe +0 -0
 - data/vendor/local/libexec/mecab/mecab-dict-index.exe +0 -0
 - data/vendor/local/libexec/mecab/mecab-system-eval.exe +0 -0
 - data/vendor/local/libexec/mecab/mecab-test-gen.exe +0 -0
 - data/vendor/local/sbin/groonga-httpd-restart +0 -0
 - data/vendor/local/share/doc/groonga/en/html/.buildinfo +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/characteristic.txt +11 -11
 - data/vendor/local/share/doc/groonga/en/html/_sources/community.txt +7 -7
 - data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development/com.txt +2 -2
 - data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development/cooperation.txt +5 -5
 - data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development/document.txt +2 -2
 - data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development/query.txt +6 -6
 - data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development/release.txt +39 -39
 - data/vendor/local/share/doc/groonga/en/html/_sources/contribution/development/test.txt +3 -3
 - data/vendor/local/share/doc/groonga/en/html/_sources/contribution.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/development/travis-ci.txt +2 -2
 - data/vendor/local/share/doc/groonga/en/html/_sources/development.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/install/centos.txt +3 -3
 - data/vendor/local/share/doc/groonga/en/html/_sources/install/debian.txt +3 -43
 - data/vendor/local/share/doc/groonga/en/html/_sources/install/fedora.txt +4 -4
 - data/vendor/local/share/doc/groonga/en/html/_sources/install/mac_os_x.txt +3 -3
 - data/vendor/local/share/doc/groonga/en/html/_sources/install/others.txt +3 -3
 - data/vendor/local/share/doc/groonga/en/html/_sources/install/solaris.txt +3 -3
 - data/vendor/local/share/doc/groonga/en/html/_sources/install/ubuntu.txt +3 -50
 - data/vendor/local/share/doc/groonga/en/html/_sources/install/windows.txt +9 -9
 - data/vendor/local/share/doc/groonga/en/html/_sources/news/1.0.x.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/news.txt +39 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/api/grn_column.txt +91 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/api/grn_ctx.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/api/grn_obj.txt +2 -3
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/command/command_version.txt +6 -6
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/check.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/clearlock.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/column_create.txt +2 -3
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/column_list.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/column_remove.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/define_selector.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/defrag.txt +1 -2
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/dump.txt +3 -8
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/log_level.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/log_reopen.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/normalize.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/quit.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/select.txt +5 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/shutdown.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/status.txt +2 -2
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/table_create.txt +5 -3
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/table_list.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/executables/groonga-benchmark.txt +4 -4
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/functions/between.txt +118 -0
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/grn_expr/script_syntax.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/normalizers.txt +11 -11
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/tuning.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/types.txt +5 -5
 - data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/data.txt +5 -5
 - data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/drilldown.txt +76 -14
 - data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/index.txt +3 -3
 - data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/introduction.txt +8 -8
 - data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/lexicon.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/match_columns.txt +8 -8
 - data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/micro_blog.txt +8 -8
 - data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/network.txt +18 -19
 - data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/patricia_trie.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/query_expansion.txt +1 -1
 - data/vendor/local/share/doc/groonga/en/html/_sources/tutorial/search.txt +2 -2
 - data/vendor/local/share/doc/groonga/en/html/characteristic.html +17 -17
 - data/vendor/local/share/doc/groonga/en/html/community.html +12 -12
 - data/vendor/local/share/doc/groonga/en/html/contribution/development/com.html +20 -20
 - data/vendor/local/share/doc/groonga/en/html/contribution/development/cooperation.html +43 -43
 - data/vendor/local/share/doc/groonga/en/html/contribution/development/document.html +30 -30
 - data/vendor/local/share/doc/groonga/en/html/contribution/development/query.html +69 -69
 - data/vendor/local/share/doc/groonga/en/html/contribution/development/release.html +132 -132
 - data/vendor/local/share/doc/groonga/en/html/contribution/development/repository.html +17 -17
 - data/vendor/local/share/doc/groonga/en/html/contribution/development/test.html +43 -53
 - data/vendor/local/share/doc/groonga/en/html/contribution/development.html +23 -23
 - data/vendor/local/share/doc/groonga/en/html/contribution/documentation/c-api.html +17 -17
 - data/vendor/local/share/doc/groonga/en/html/contribution/documentation/i18n.html +46 -36
 - data/vendor/local/share/doc/groonga/en/html/contribution/documentation.html +17 -17
 - data/vendor/local/share/doc/groonga/en/html/contribution/report.html +10 -10
 - data/vendor/local/share/doc/groonga/en/html/contribution.html +73 -73
 - data/vendor/local/share/doc/groonga/en/html/development/travis-ci.html +7 -7
 - data/vendor/local/share/doc/groonga/en/html/development.html +6 -6
 - data/vendor/local/share/doc/groonga/en/html/genindex.html +47 -7
 - data/vendor/local/share/doc/groonga/en/html/geolocation_search.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/index.html +50 -46
 - data/vendor/local/share/doc/groonga/en/html/install/centos.html +8 -8
 - data/vendor/local/share/doc/groonga/en/html/install/debian.html +16 -52
 - data/vendor/local/share/doc/groonga/en/html/install/fedora.html +11 -11
 - data/vendor/local/share/doc/groonga/en/html/install/mac_os_x.html +8 -8
 - data/vendor/local/share/doc/groonga/en/html/install/others.html +8 -8
 - data/vendor/local/share/doc/groonga/en/html/install/solaris.html +8 -8
 - data/vendor/local/share/doc/groonga/en/html/install/ubuntu.html +18 -62
 - data/vendor/local/share/doc/groonga/en/html/install/windows.html +14 -14
 - data/vendor/local/share/doc/groonga/en/html/install.html +19 -21
 - data/vendor/local/share/doc/groonga/en/html/limitations.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/news/0.x.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/news/1.0.x.html +6 -6
 - data/vendor/local/share/doc/groonga/en/html/news/1.1.x.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/news/1.2.x.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/news/senna.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/news.html +225 -179
 - data/vendor/local/share/doc/groonga/en/html/objects.inv +0 -0
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_cache.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_column.html +105 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_command_version.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_ctx.html +6 -6
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_db.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_encoding.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_expr.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_geo.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_hook.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_ii.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_index_cursor.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_info.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_match_escalation.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_obj.html +6 -6
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_proc.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_search.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_table.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_table_cursor.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_type.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/api/grn_user_data.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/api.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/cast.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/command/command_version.html +11 -11
 - data/vendor/local/share/doc/groonga/en/html/reference/command/output_format.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/command/return_code.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/command.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/cache_limit.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/check.html +6 -6
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/clearlock.html +6 -6
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/column_create.html +7 -7
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/column_list.html +6 -6
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/column_remove.html +6 -6
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/column_rename.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/define_selector.html +6 -6
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/defrag.html +6 -6
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/delete.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/dump.html +8 -8
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/load.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/log_level.html +6 -6
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/log_put.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/log_reopen.html +6 -6
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/normalize.html +6 -6
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/quit.html +6 -6
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/register.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/ruby_eval.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/ruby_load.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/select.html +8 -8
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/shutdown.html +6 -6
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/status.html +11 -11
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/suggest.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/table_create.html +9 -9
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/table_list.html +6 -6
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/table_remove.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/tokenize.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/commands/truncate.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/commands_not_implemented/add.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/commands_not_implemented/get.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/commands_not_implemented/set.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/grnslap.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-benchmark.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-httpd.html +9 -9
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-server-http.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-create-dataset.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-httpd.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-learner.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/executables.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/function.html +21 -20
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/between.html +331 -0
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/edit_distance.html +28 -28
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_distance.html +45 -45
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_in_circle.html +27 -27
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_in_rectangle.html +27 -27
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/html_untag.html +29 -29
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/now.html +25 -25
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/query.html +41 -41
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/rand.html +27 -27
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/snippet_html.html +27 -27
 - data/vendor/local/share/doc/groonga/en/html/reference/functions/sub_filter.html +28 -28
 - data/vendor/local/share/doc/groonga/en/html/reference/grn_expr/query_syntax.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/grn_expr/script_syntax.html +6 -6
 - data/vendor/local/share/doc/groonga/en/html/reference/grn_expr.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/indexing.html +9 -9
 - data/vendor/local/share/doc/groonga/en/html/reference/log.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/normalizers.html +17 -17
 - data/vendor/local/share/doc/groonga/en/html/reference/output.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/pseudo_column.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/query_expanders/tsv.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/query_expanders.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/tables.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/tokenizers.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/reference/tuning.html +6 -6
 - data/vendor/local/share/doc/groonga/en/html/reference/types.html +10 -10
 - data/vendor/local/share/doc/groonga/en/html/reference.html +16 -15
 - data/vendor/local/share/doc/groonga/en/html/search.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/searchindex.js +1 -1
 - data/vendor/local/share/doc/groonga/en/html/server/gqtp.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/server/http/comparison.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/server/http/groonga-httpd.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/server/http/groonga.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/server/http.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/server/package.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/server.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/spec/gqtp.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/spec/search.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/spec.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/suggest/completion.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/suggest/correction.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/suggest/introduction.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/suggest/suggestion.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/suggest/tutorial.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/suggest.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/troubleshooting/different_results_with_the_same_keyword.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/troubleshooting/mmap_cannot_allocate_memory.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/troubleshooting.html +5 -5
 - data/vendor/local/share/doc/groonga/en/html/tutorial/data.html +10 -10
 - data/vendor/local/share/doc/groonga/en/html/tutorial/drilldown.html +168 -14
 - data/vendor/local/share/doc/groonga/en/html/tutorial/index.html +12 -12
 - data/vendor/local/share/doc/groonga/en/html/tutorial/introduction.html +15 -15
 - data/vendor/local/share/doc/groonga/en/html/tutorial/lexicon.html +6 -6
 - data/vendor/local/share/doc/groonga/en/html/tutorial/match_columns.html +7 -7
 - data/vendor/local/share/doc/groonga/en/html/tutorial/micro_blog.html +7 -7
 - data/vendor/local/share/doc/groonga/en/html/tutorial/network.html +34 -35
 - data/vendor/local/share/doc/groonga/en/html/tutorial/patricia_trie.html +6 -6
 - data/vendor/local/share/doc/groonga/en/html/tutorial/query_expansion.html +6 -6
 - data/vendor/local/share/doc/groonga/en/html/tutorial/search.html +11 -11
 - data/vendor/local/share/doc/groonga/en/html/tutorial.html +12 -7
 - data/vendor/local/share/doc/groonga/ja/html/.buildinfo +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/characteristic.txt +11 -11
 - data/vendor/local/share/doc/groonga/ja/html/_sources/community.txt +7 -7
 - data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/com.txt +2 -2
 - data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/cooperation.txt +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/document.txt +2 -2
 - data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/query.txt +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/release.txt +39 -39
 - data/vendor/local/share/doc/groonga/ja/html/_sources/contribution/development/test.txt +3 -3
 - data/vendor/local/share/doc/groonga/ja/html/_sources/contribution.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/development/travis-ci.txt +2 -2
 - data/vendor/local/share/doc/groonga/ja/html/_sources/development.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/install/centos.txt +3 -3
 - data/vendor/local/share/doc/groonga/ja/html/_sources/install/debian.txt +3 -43
 - data/vendor/local/share/doc/groonga/ja/html/_sources/install/fedora.txt +4 -4
 - data/vendor/local/share/doc/groonga/ja/html/_sources/install/mac_os_x.txt +3 -3
 - data/vendor/local/share/doc/groonga/ja/html/_sources/install/others.txt +3 -3
 - data/vendor/local/share/doc/groonga/ja/html/_sources/install/solaris.txt +3 -3
 - data/vendor/local/share/doc/groonga/ja/html/_sources/install/ubuntu.txt +3 -50
 - data/vendor/local/share/doc/groonga/ja/html/_sources/install/windows.txt +9 -9
 - data/vendor/local/share/doc/groonga/ja/html/_sources/news/1.0.x.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/news.txt +39 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/api/grn_column.txt +91 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/api/grn_ctx.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/api/grn_obj.txt +2 -3
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/command/command_version.txt +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/check.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/clearlock.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/column_create.txt +2 -3
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/column_list.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/column_remove.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/define_selector.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/defrag.txt +1 -2
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/dump.txt +3 -8
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/log_level.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/log_reopen.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/normalize.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/quit.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/select.txt +5 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/shutdown.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/status.txt +2 -2
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/table_create.txt +5 -3
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/table_list.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/executables/groonga-benchmark.txt +4 -4
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/functions/between.txt +118 -0
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/grn_expr/script_syntax.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/normalizers.txt +11 -11
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/tuning.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/types.txt +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/data.txt +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/drilldown.txt +76 -14
 - data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/index.txt +3 -3
 - data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/introduction.txt +8 -8
 - data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/lexicon.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/match_columns.txt +8 -8
 - data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/micro_blog.txt +8 -8
 - data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/network.txt +18 -19
 - data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/patricia_trie.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/query_expansion.txt +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/_sources/tutorial/search.txt +2 -2
 - data/vendor/local/share/doc/groonga/ja/html/characteristic.html +26 -26
 - data/vendor/local/share/doc/groonga/ja/html/community.html +11 -11
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development/com.html +22 -22
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development/cooperation.html +45 -45
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development/document.html +32 -32
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development/query.html +71 -71
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development/release.html +134 -134
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development/repository.html +21 -21
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development/test.html +45 -55
 - data/vendor/local/share/doc/groonga/ja/html/contribution/development.html +26 -26
 - data/vendor/local/share/doc/groonga/ja/html/contribution/documentation/c-api.html +19 -19
 - data/vendor/local/share/doc/groonga/ja/html/contribution/documentation/i18n.html +54 -44
 - data/vendor/local/share/doc/groonga/ja/html/contribution/documentation.html +20 -20
 - data/vendor/local/share/doc/groonga/ja/html/contribution/report.html +19 -19
 - data/vendor/local/share/doc/groonga/ja/html/contribution.html +76 -76
 - data/vendor/local/share/doc/groonga/ja/html/development/travis-ci.html +14 -14
 - data/vendor/local/share/doc/groonga/ja/html/development.html +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/genindex.html +47 -7
 - data/vendor/local/share/doc/groonga/ja/html/geolocation_search.html +11 -11
 - data/vendor/local/share/doc/groonga/ja/html/index.html +55 -51
 - data/vendor/local/share/doc/groonga/ja/html/install/centos.html +15 -15
 - data/vendor/local/share/doc/groonga/ja/html/install/debian.html +28 -60
 - data/vendor/local/share/doc/groonga/ja/html/install/fedora.html +18 -18
 - data/vendor/local/share/doc/groonga/ja/html/install/mac_os_x.html +9 -9
 - data/vendor/local/share/doc/groonga/ja/html/install/others.html +21 -21
 - data/vendor/local/share/doc/groonga/ja/html/install/solaris.html +10 -10
 - data/vendor/local/share/doc/groonga/ja/html/install/ubuntu.html +33 -73
 - data/vendor/local/share/doc/groonga/ja/html/install/windows.html +15 -15
 - data/vendor/local/share/doc/groonga/ja/html/install.html +20 -22
 - data/vendor/local/share/doc/groonga/ja/html/limitations.html +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/news/0.x.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/news/1.0.x.html +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/news/1.1.x.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/news/1.2.x.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/news/senna.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/news.html +242 -182
 - data/vendor/local/share/doc/groonga/ja/html/objects.inv +0 -0
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_cache.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_column.html +105 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_command_version.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_ctx.html +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_db.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_encoding.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_expr.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_geo.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_hook.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_ii.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_index_cursor.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_info.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_match_escalation.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_obj.html +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_proc.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_search.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_table.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_table_cursor.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_type.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_user_data.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/api.html +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/reference/cast.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/command/command_version.html +11 -11
 - data/vendor/local/share/doc/groonga/ja/html/reference/command/output_format.html +7 -7
 - data/vendor/local/share/doc/groonga/ja/html/reference/command/return_code.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/command.html +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/cache_limit.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/check.html +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/clearlock.html +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_create.html +9 -9
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_list.html +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_remove.html +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_rename.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/define_selector.html +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/defrag.html +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/delete.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/dump.html +8 -8
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/load.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_level.html +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_put.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_reopen.html +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/normalize.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/quit.html +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/register.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/ruby_eval.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/ruby_load.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/select.html +7 -7
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/shutdown.html +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/status.html +11 -11
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/suggest.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_create.html +8 -8
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_list.html +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_remove.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/tokenize.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands/truncate.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands_not_implemented/add.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands_not_implemented/get.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/commands_not_implemented/set.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/grnslap.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-benchmark.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-httpd.html +9 -9
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-server-http.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-create-dataset.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-httpd.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-learner.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/function.html +21 -20
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/between.html +329 -0
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/edit_distance.html +28 -28
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_distance.html +45 -45
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_in_circle.html +27 -27
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_in_rectangle.html +27 -27
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/html_untag.html +29 -29
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/now.html +25 -25
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/query.html +41 -41
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/rand.html +27 -27
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/snippet_html.html +27 -27
 - data/vendor/local/share/doc/groonga/ja/html/reference/functions/sub_filter.html +28 -28
 - data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr/query_syntax.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr/script_syntax.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/indexing.html +9 -9
 - data/vendor/local/share/doc/groonga/ja/html/reference/log.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/normalizers.html +12 -12
 - data/vendor/local/share/doc/groonga/ja/html/reference/output.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/pseudo_column.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/query_expanders/tsv.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/query_expanders.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/tables.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/tokenizers.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/reference/tuning.html +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/reference/types.html +10 -10
 - data/vendor/local/share/doc/groonga/ja/html/reference.html +16 -15
 - data/vendor/local/share/doc/groonga/ja/html/search.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/searchindex.js +1 -1
 - data/vendor/local/share/doc/groonga/ja/html/server/gqtp.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/server/http/comparison.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/server/http/groonga-httpd.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/server/http/groonga.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/server/http.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/server/package.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/server.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/spec/gqtp.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/spec/search.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/spec.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/suggest/completion.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/suggest/correction.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/suggest/introduction.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/suggest/suggestion.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/suggest/tutorial.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/suggest.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/troubleshooting/different_results_with_the_same_keyword.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/troubleshooting/mmap_cannot_allocate_memory.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/troubleshooting.html +5 -5
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/data.html +9 -9
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/drilldown.html +169 -14
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/index.html +8 -8
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/introduction.html +15 -15
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/lexicon.html +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/match_columns.html +7 -7
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/micro_blog.html +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/network.html +33 -34
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/patricia_trie.html +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/query_expansion.html +6 -6
 - data/vendor/local/share/doc/groonga/ja/html/tutorial/search.html +7 -7
 - data/vendor/local/share/doc/groonga/ja/html/tutorial.html +12 -7
 - data/vendor/local/share/groonga/examples/dictionary/edict/edict-import.sh +0 -0
 - data/vendor/local/share/groonga/examples/dictionary/edict/edict2grn.rb +0 -0
 - data/vendor/local/share/groonga/examples/dictionary/eijiro/eijiro-import.sh +0 -0
 - data/vendor/local/share/groonga/examples/dictionary/eijiro/eijiro2grn.rb +0 -0
 - data/vendor/local/share/groonga/examples/dictionary/gene95/gene-import.sh +0 -0
 - data/vendor/local/share/groonga/examples/dictionary/gene95/gene2grn.rb +0 -0
 - data/vendor/local/share/groonga/examples/dictionary/init-db.sh +0 -0
 - data/vendor/local/share/groonga/examples/dictionary/jmdict/jmdict.rb +0 -0
 - data/vendor/local/share/man/ja/man1/groonga.1 +1156 -808
 - data/vendor/local/share/man/man1/groonga.1 +1682 -1337
 - metadata +142 -142
 - data/vendor/local/share/doc/groonga/en/html/_sources/reference/executables/grntest.txt +0 -273
 - data/vendor/local/share/doc/groonga/en/html/reference/executables/grntest.html +0 -410
 - data/vendor/local/share/doc/groonga/ja/html/_sources/reference/executables/grntest.txt +0 -273
 - data/vendor/local/share/doc/groonga/ja/html/reference/executables/grntest.html +0 -411
 
| 
         @@ -1,4 +1,4 @@ 
     | 
|
| 
       1 
     | 
    
         
            -
            .TH "GROONGA" "1" "2013 年  
     | 
| 
      
 1 
     | 
    
         
            +
            .TH "GROONGA" "1" "2013 年 12 月 27 日" "3.1.1" "Groonga"
         
     | 
| 
       2 
2 
     | 
    
         
             
            .SH NAME
         
     | 
| 
       3 
3 
     | 
    
         
             
            groonga \- Groonga documentation
         
     | 
| 
       4 
4 
     | 
    
         
             
            .
         
     | 
| 
         @@ -35,54 +35,54 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] 
     | 
|
| 
       35 
35 
     | 
    
         
             
            \fBnews\fP
         
     | 
| 
       36 
36 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       37 
37 
     | 
    
         
             
            .SH GROONGAの特徴
         
     | 
| 
       38 
     | 
    
         
            -
            .SS  
     | 
| 
      
 38 
     | 
    
         
            +
            .SS Groonga の概要
         
     | 
| 
       39 
39 
     | 
    
         
             
            .sp
         
     | 
| 
       40 
     | 
    
         
            -
             
     | 
| 
      
 40 
     | 
    
         
            +
            Groonga は転置索引を用いた高速・高精度な全文検索エンジンであり、登録された文書をすぐに検索結果に反映できます。また、参照をブロックせずに更新できることから、即時更新の必要なアプリケーションにおいても高い性能を発揮します。
         
     | 
| 
       41 
41 
     | 
    
         
             
            .sp
         
     | 
| 
       42 
     | 
    
         
            -
            全文検索エンジンとして開発された  
     | 
| 
      
 42 
     | 
    
         
            +
            全文検索エンジンとして開発された Groonga ですが、独自のカラムストアを持つ列指向のデータベースとしての側面も持っています。そのため、MySQL や PostgreSQL など、既存の代表的なデータベースが苦手とする集計クエリを高速に処理できるという特徴があり、組み合わせによって弱点を補うような使い方もできます。
         
     | 
| 
       43 
43 
     | 
    
         
             
            .sp
         
     | 
| 
       44 
     | 
    
         
            -
             
     | 
| 
      
 44 
     | 
    
         
            +
            Groonga の基本機能は C ライブラリとして提供されていますが、MySQL や PostgreSQL と連携させたり、Ruby から呼び出したりすることもできます。そのため、任意のアプリケーションに組み込むことが可能であり、多様な使い方が考えられます。 興味のある方は \fI\%利用例\fP をご覧ください。
         
     | 
| 
       45 
45 
     | 
    
         
             
            .SS 全文検索と即時更新
         
     | 
| 
       46 
46 
     | 
    
         
             
            .sp
         
     | 
| 
       47 
47 
     | 
    
         
             
            一般的なデータベースにおいては、追加・削除などの操作がすぐに反映されます。一方、全文検索においては、転置索引が逐次更新の難しいデータ構造であることから、文書の追加・削除に対応しないエンジンが少なくありません。
         
     | 
| 
       48 
48 
     | 
    
         
             
            .sp
         
     | 
| 
       49 
     | 
    
         
            -
            これに対し、転置索引を用いた全文検索エンジンでありながら、 
     | 
| 
      
 49 
     | 
    
         
            +
            これに対し、転置索引を用いた全文検索エンジンでありながら、Groonga は文書を短時間で追加・削除することができます。その上、更新しながらでも検索できるという優れた特徴を持っているため、全文検索エンジンとしてはとても柔軟性があります。また、複数の転置索引を統合するような重い処理を必要としないので、安定して高い性能を発揮することが期待できます。
         
     | 
| 
       50 
50 
     | 
    
         
             
            .SS カラムストアと集計クエリ
         
     | 
| 
       51 
51 
     | 
    
         
             
            .sp
         
     | 
| 
       52 
52 
     | 
    
         
             
            現代は、インターネットを情報源とすれば、いくらでも情報を収集できる時代です。しかし、膨大な情報から有益な情報を引き出すのは困難であり、多面的な分析による試行錯誤が必要となります。たとえば、日付や時間帯により絞り込んでみたり、地域により絞り込んでみたり、性別や年齢により絞り込んでみたりすることでしょう。そして、そのようなときに便利な存在が集計クエリです。
         
     | 
| 
       53 
53 
     | 
    
         
             
            .sp
         
     | 
| 
       54 
54 
     | 
    
         
             
            集計クエリとは、指定したカラムの値によってレコードをグループ化し、各グループに含まれるレコードの数を求めるクエリです。たとえば、地域の ID を格納しているカラムを指定すれば、地域毎のレコード数が求まります。日付のカラムを指定したときの出力をグラフ化すれば、レコード数の時間変化を視覚化することができます。さらに、地域による絞り込みと日付に対する集計クエリを組み合わせれば、特定の地域におけるレコード数の時間変化を視覚化ことも可能です。このように、尺度を自由に選択して絞り込み・集計できることは、膨大な情報を扱う上でとても重要になります。
         
     | 
| 
       55 
55 
     | 
    
         
             
            .sp
         
     | 
| 
       56 
     | 
    
         
            -
             
     | 
| 
      
 56 
     | 
    
         
            +
            Groonga が集計クエリを高速に処理できる理由は、データベースの論理構造にカラムストアを採用しているからです。集計クエリが参照するのは指定されたカラムのみであるため、カラム単位でデータを格納する列指向のデータベースでは、必要なカラムのみを無駄なく読み出せることが利点となります。一方、レコード単位でデータを格納する行指向のデータベースでは、隣接するカラムをまとめて読み出してしまうことが欠点となります。
         
     | 
| 
       57 
57 
     | 
    
         
             
            .SS 転置索引とトークナイザ
         
     | 
| 
       58 
58 
     | 
    
         
             
            .sp
         
     | 
| 
       59 
59 
     | 
    
         
             
            転置索引は大規模な全文検索に用いられる伝統的なデータ構造です。転置索引を用いた全文検索エンジンでは、文書を追加するときに索引語を記録しておき、検索するときはクエリを索引語に分割して出現文書を求めます。そのため、文書やクエリから索引語を抜き出す方法が重要になります。
         
     | 
| 
       60 
60 
     | 
    
         
             
            .sp
         
     | 
| 
       61 
61 
     | 
    
         
             
            トークナイザは、文字列から索引語を抜き出すモジュールです。日本語を対象とする全文検索においては、形態素を索引語として抜き出す方式と文字 N\-gram を抜き出す方式のいずれか、あるいは両方を用いるのが一般的です。形態素方式は検索時間や索引サイズの面で優れているほか、検索結果に不要な文書が含まれにくいという利点を持っています。一方、N\-gram 方式には検索漏れが発生しにくいという利点があり、状況によって適した方式を選択することが望ましいとされています。
         
     | 
| 
       62 
62 
     | 
    
         
             
            .sp
         
     | 
| 
       63 
     | 
    
         
            -
             
     | 
| 
      
 63 
     | 
    
         
            +
            Groonga は形態素方式と N\-gram 方式の両方に対応しています。初期状態で利用できるトークナイザは空白を区切り文字として用いる方式と N\-gram 方式のみですが、形態素解析器 MeCab を組み込んだときは MeCab による分かち書きの結果を用いる形態素方式が有効になります。トークナイザはプラグインとして追加できるため、特徴的なキーワードのみを索引語として採用するなど、独自のトークナイザを開発することが可能です。
         
     | 
| 
       64 
64 
     | 
    
         
             
            .SS 共有可能なストレージと参照ロックフリー
         
     | 
| 
       65 
65 
     | 
    
         
             
            .sp
         
     | 
| 
       66 
66 
     | 
    
         
             
            CPU のマルチコア化が進んでいるため、同時に複数のクエリを実行したり、一つのクエリを複数のスレッドで実行したりすることの重要性はますます高まっています。
         
     | 
| 
       67 
67 
     | 
    
         
             
            .sp
         
     | 
| 
       68 
     | 
    
         
            -
             
     | 
| 
      
 68 
     | 
    
         
            +
            Groonga のストレージは、複数のスレッド・プロセスで共有することができます。また、参照ロックフリーなデータ構造を採用しているため、更新クエリを実行している状況でも参照クエリを実行することができます。参照クエリを実行できる状態を維持しながら更新クエリを実行できるので、リアルタイムなシステムに適しています。さらには、MySQL を介して更新クエリを実行している最中に Groonga の HTTP サーバを介して参照クエリを実行するなど、多彩な運用が可能となっています。
         
     | 
| 
       69 
69 
     | 
    
         
             
            .SS 位置情報(緯度・経度)検索
         
     | 
| 
       70 
70 
     | 
    
         
             
            .sp
         
     | 
| 
       71 
71 
     | 
    
         
             
            GPS に代表される測位システムを搭載した高機能な携帯端末の普及などによって、位置情報を扱うサービスはますます便利になっています。たとえば、近くにあるレストランを探しているときは、現在地からの距離を基準として検索をおこない、検索結果を地図上に表示してくれるようなサービスが便利です。そのため、位置情報検索を高速に実現できることが重要になっています。
         
     | 
| 
       72 
72 
     | 
    
         
             
            .sp
         
     | 
| 
       73 
     | 
    
         
            -
             
     | 
| 
       74 
     | 
    
         
            -
            .SS  
     | 
| 
      
 73 
     | 
    
         
            +
            Groonga では転置索引を応用して高速な位置情報検索を実現しています。矩形・円による範囲検索に対応しているほか、基準点の近くを優先的に探索させることができます。また、距離計算をサポートしているので、位置情報検索の結果を基準点からの距離によって整列することも可能です。
         
     | 
| 
      
 74 
     | 
    
         
            +
            .SS Groonga ライブラリ
         
     | 
| 
       75 
75 
     | 
    
         
             
            .sp
         
     | 
| 
       76 
     | 
    
         
            -
            Groonga の基本機能は C ライブラリとして提供されているので、任意のアプリケーションに組み込んで利用することができます。C/C++ 以外については、Ruby から  
     | 
| 
       77 
     | 
    
         
            -
            .SS  
     | 
| 
      
 76 
     | 
    
         
            +
            Groonga の基本機能は C ライブラリとして提供されているので、任意のアプリケーションに組み込んで利用することができます。C/C++ 以外については、Ruby から Groonga を利用するライブラリなどが関連プロジェクトにおいて提供されています。詳しくは \fI\%関連プロジェクト\fP を参照してください。
         
     | 
| 
      
 77 
     | 
    
         
            +
            .SS Groonga サーバ
         
     | 
| 
       78 
78 
     | 
    
         
             
            .sp
         
     | 
| 
       79 
     | 
    
         
            -
             
     | 
| 
       80 
     | 
    
         
            -
            .SS  
     | 
| 
      
 79 
     | 
    
         
            +
            Groonga にはサーバ機能があるため、レンタルサーバなどの新しいライブラリをインストールできない環境においても利用できます。対応しているのは HTTP, memcached binary プロトコル、およびに Groonga の独自プロトコルである GQTP(Groonga Query Transfer Protocol) です。サーバとして利用するときはクエリのキャッシュ機能が有効になるため、同じクエリを受け取ったときは応答時間が短くなるという特徴があります。
         
     | 
| 
      
 80 
     | 
    
         
            +
            .SS Groonga ストレージエンジン
         
     | 
| 
       81 
81 
     | 
    
         
             
            .sp
         
     | 
| 
       82 
     | 
    
         
            -
             
     | 
| 
      
 82 
     | 
    
         
            +
            Groonga は独自のカラムストアを持つ列指向のデータベースとしての側面を持っていますが、既存の RDBMS のストレージエンジンとして利用することもできます。たとえば、Groonga をベースとする MySQL のストレージエンジンとして \fI\%mroonga\fP が開発されています。mroonga は MySQL のプラグインとして動的にロードすることが可能であり、Groonga のカラムストアをストレージとして利用したり、全文検索エンジンとして Groonga を MyISAM や InnoDB と連携させたりすることができます。Groonga 単体での利用、およびに MyISAM, InnoDB との連携には一長一短があるので、用途に応じて適切な組み合わせを選ぶことが大切です。詳しくは \fI\%関連プロジェクト\fP を参照してください。
         
     | 
| 
       83 
83 
     | 
    
         
             
            .SH インストール
         
     | 
| 
       84 
84 
     | 
    
         
             
            .sp
         
     | 
| 
       85 
     | 
    
         
            -
            このセクションでは 
     | 
| 
      
 85 
     | 
    
         
            +
            このセクションではGroongaのインストール方法を環境毎に説明します。主要なプラットフォームにはパッケージがあります。自分でGroongaをビルドするよりもパッケージを使うことを推奨します。しかし、心配しないでください。ソースからGroongaをビルドするためのドキュメントもあります。
         
     | 
| 
       86 
86 
     | 
    
         
             
            .sp
         
     | 
| 
       87 
87 
     | 
    
         
             
            32\-bit用と64\-bit用のパッケージを配布していますが、サーバ用途には64\-bitパッケージを利用することをオススメします。32\-bit用パッケージはテスト用か開発用にだけ使って下さい。32\-bit用パッケージを使った場合は、中程度のサイズのデータでもメモリ不足エラーになることがあります。
         
     | 
| 
       88 
88 
     | 
    
         
             
            .SS Windows
         
     | 
| 
         @@ -97,7 +97,7 @@ groonga は独自のカラムストアを持つ列指向のデータベースと 
     | 
|
| 
       97 
97 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       98 
98 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       99 
99 
     | 
    
         
             
            .IP \(bu 2
         
     | 
| 
       100 
     | 
    
         
            -
            \fI\%http://packages.groonga.org/windows/groonga/groonga\-3.1. 
     | 
| 
      
 100 
     | 
    
         
            +
            \fI\%http://packages.groonga.org/windows/groonga/groonga\-3.1.1\-x86.exe\fP
         
     | 
| 
       101 
101 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       102 
102 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       103 
103 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
         @@ -109,7 +109,7 @@ groonga は独自のカラムストアを持つ列指向のデータベースと 
     | 
|
| 
       109 
109 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       110 
110 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       111 
111 
     | 
    
         
             
            .IP \(bu 2
         
     | 
| 
       112 
     | 
    
         
            -
            \fI\%http://packages.groonga.org/windows/groonga/groonga\-3.1. 
     | 
| 
      
 112 
     | 
    
         
            +
            \fI\%http://packages.groonga.org/windows/groonga/groonga\-3.1.1\-x64.exe\fP
         
     | 
| 
       113 
113 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       114 
114 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       115 
115 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
         @@ -124,7 +124,7 @@ groonga は独自のカラムストアを持つ列指向のデータベースと 
     | 
|
| 
       124 
124 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       125 
125 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       126 
126 
     | 
    
         
             
            .IP \(bu 2
         
     | 
| 
       127 
     | 
    
         
            -
            \fI\%http://packages.groonga.org/windows/groonga/groonga\-3.1. 
     | 
| 
      
 127 
     | 
    
         
            +
            \fI\%http://packages.groonga.org/windows/groonga/groonga\-3.1.1\-x86.zip\fP
         
     | 
| 
       128 
128 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       129 
129 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       130 
130 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
         @@ -136,7 +136,7 @@ groonga は独自のカラムストアを持つ列指向のデータベースと 
     | 
|
| 
       136 
136 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       137 
137 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       138 
138 
     | 
    
         
             
            .IP \(bu 2
         
     | 
| 
       139 
     | 
    
         
            -
            \fI\%http://packages.groonga.org/windows/groonga/groonga\-3.1. 
     | 
| 
      
 139 
     | 
    
         
            +
            \fI\%http://packages.groonga.org/windows/groonga/groonga\-3.1.1\-x64.zip\fP
         
     | 
| 
       140 
140 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       141 
141 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       142 
142 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
         @@ -163,7 +163,7 @@ zipアーカイブをpackages.groonga.orgからダウンロードしてくださ 
     | 
|
| 
       163 
163 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       164 
164 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       165 
165 
     | 
    
         
             
            .IP \(bu 2
         
     | 
| 
       166 
     | 
    
         
            -
            \fI\%http://packages.groonga.org/source/groonga/groonga\-3.1. 
     | 
| 
      
 166 
     | 
    
         
            +
            \fI\%http://packages.groonga.org/source/groonga/groonga\-3.1.1.zip\fP
         
     | 
| 
       167 
167 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       168 
168 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       169 
169 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
         @@ -176,19 +176,19 @@ Groongaのソースフォルダへと移動します: 
     | 
|
| 
       176 
176 
     | 
    
         
             
            .sp
         
     | 
| 
       177 
177 
     | 
    
         
             
            .nf
         
     | 
| 
       178 
178 
     | 
    
         
             
            .ft C
         
     | 
| 
       179 
     | 
    
         
            -
            > cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-3.1. 
     | 
| 
      
 179 
     | 
    
         
            +
            > cd c:\eUsers\e%USERNAME%\eDownloads\egroonga\-3.1.1
         
     | 
| 
       180 
180 
     | 
    
         
             
            .ft P
         
     | 
| 
       181 
181 
     | 
    
         
             
            .fi
         
     | 
| 
       182 
182 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       183 
183 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       184 
184 
     | 
    
         
             
            .sp
         
     | 
| 
       185 
     | 
    
         
            -
            \fBcmake\fP でビルドオプションを設定します。以下のコマンドラインは64\-bit用の 
     | 
| 
      
 185 
     | 
    
         
            +
            \fBcmake\fP でビルドオプションを設定します。以下のコマンドラインは64\-bit用のGroongaをビルドするためのものです。32\-bit用のGroongaをビルドする場合は代わりに \fB\-G "Visual Studio 10"\fP パラメーターを指定してください:
         
     | 
| 
       186 
186 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       187 
187 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       188 
188 
     | 
    
         
             
            .sp
         
     | 
| 
       189 
189 
     | 
    
         
             
            .nf
         
     | 
| 
       190 
190 
     | 
    
         
             
            .ft C
         
     | 
| 
       191 
     | 
    
         
            -
            groonga\-3.1. 
     | 
| 
      
 191 
     | 
    
         
            +
            groonga\-3.1.1> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\egroonga
         
     | 
| 
       192 
192 
     | 
    
         
             
            .ft P
         
     | 
| 
       193 
193 
     | 
    
         
             
            .fi
         
     | 
| 
       194 
194 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
         @@ -200,7 +200,7 @@ groonga\-3.1.0> cmake . \-G "Visual Studio 10 Win64" \-DCMAKE_INSTALL_PREFIX=C:\ 
     | 
|
| 
       200 
200 
     | 
    
         
             
            .sp
         
     | 
| 
       201 
201 
     | 
    
         
             
            .nf
         
     | 
| 
       202 
202 
     | 
    
         
             
            .ft C
         
     | 
| 
       203 
     | 
    
         
            -
            groonga\-3.1. 
     | 
| 
      
 203 
     | 
    
         
            +
            groonga\-3.1.1> cmake \-\-build . \-\-config Release
         
     | 
| 
       204 
204 
     | 
    
         
             
            .ft P
         
     | 
| 
       205 
205 
     | 
    
         
             
            .fi
         
     | 
| 
       206 
206 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
         @@ -212,7 +212,7 @@ groonga\-3.1.0> cmake \-\-build . \-\-config Release 
     | 
|
| 
       212 
212 
     | 
    
         
             
            .sp
         
     | 
| 
       213 
213 
     | 
    
         
             
            .nf
         
     | 
| 
       214 
214 
     | 
    
         
             
            .ft C
         
     | 
| 
       215 
     | 
    
         
            -
            groonga\-3.1. 
     | 
| 
      
 215 
     | 
    
         
            +
            groonga\-3.1.1> cmake \-\-build . \-\-config Release \-\-target Install
         
     | 
| 
       216 
216 
     | 
    
         
             
            .ft P
         
     | 
| 
       217 
217 
     | 
    
         
             
            .fi
         
     | 
| 
       218 
218 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
         @@ -221,7 +221,7 @@ groonga\-3.1.0> cmake \-\-build . \-\-config Release \-\-target Install 
     | 
|
| 
       221 
221 
     | 
    
         
             
            以上の手順で \fB/reference/executables/groonga\fP が \fBc:\egroonga\ebin\egroonga.exe\fP にインストールされます。
         
     | 
| 
       222 
222 
     | 
    
         
             
            .SS Mac OS X
         
     | 
| 
       223 
223 
     | 
    
         
             
            .sp
         
     | 
| 
       224 
     | 
    
         
            -
            このセクションではMac OS X上で 
     | 
| 
      
 224 
     | 
    
         
            +
            このセクションではMac OS X上でGroongaをインストールする方法を説明します。 \fI\%MacPorts\fP か \fI\%Homebrew\fP を使ってインストールできます。
         
     | 
| 
       225 
225 
     | 
    
         
             
            .sp
         
     | 
| 
       226 
226 
     | 
    
         
             
            32\-bit用と64\-bit用のパッケージを配布していますが、サーバ用途には64\-bitパッケージを利用することをオススメします。32\-bit用パッケージはテスト用か開発用にだけ使って下さい。32\-bit用パッケージを使った場合は、中程度のサイズのデータでもメモリ不足エラーになることがあります。
         
     | 
| 
       227 
227 
     | 
    
         
             
            .SS MacPorts
         
     | 
| 
         @@ -260,9 +260,9 @@ groonga\-3.1.0> cmake \-\-build . \-\-config Release \-\-target Install 
     | 
|
| 
       260 
260 
     | 
    
         
             
            .sp
         
     | 
| 
       261 
261 
     | 
    
         
             
            .nf
         
     | 
| 
       262 
262 
     | 
    
         
             
            .ft C
         
     | 
| 
       263 
     | 
    
         
            -
            % curl \-O http://packages.groonga.org/source/groonga/groonga\-3.1. 
     | 
| 
       264 
     | 
    
         
            -
            % tar xvzf groonga\-3.1. 
     | 
| 
       265 
     | 
    
         
            -
            % cd groonga\-3.1. 
     | 
| 
      
 263 
     | 
    
         
            +
            % curl \-O http://packages.groonga.org/source/groonga/groonga\-3.1.1.tar.gz
         
     | 
| 
      
 264 
     | 
    
         
            +
            % tar xvzf groonga\-3.1.1.tar.gz
         
     | 
| 
      
 265 
     | 
    
         
            +
            % cd groonga\-3.1.1
         
     | 
| 
       266 
266 
     | 
    
         
             
            .ft P
         
     | 
| 
       267 
267 
     | 
    
         
             
            .fi
         
     | 
| 
       268 
268 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
         @@ -305,14 +305,14 @@ configureを実行します( \fBconfigure\fP のオプションについては 
     | 
|
| 
       305 
305 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       306 
306 
     | 
    
         
             
            .SS Debian GNU/Linux
         
     | 
| 
       307 
307 
     | 
    
         
             
            .sp
         
     | 
| 
       308 
     | 
    
         
            -
            このセクションではDebian GNU/Linux上で 
     | 
| 
      
 308 
     | 
    
         
            +
            このセクションではDebian GNU/Linux上でGroonga関連のdebパッケージをインストールする方法を説明します。これらのパッケージは \fBapt\fP でインストールできます。
         
     | 
| 
       309 
309 
     | 
    
         
             
            .sp
         
     | 
| 
       310 
310 
     | 
    
         
             
            32\-bit用と64\-bit用のパッケージを配布していますが、サーバ用途には64\-bitパッケージを利用することをオススメします。32\-bit用パッケージはテスト用か開発用にだけ使って下さい。32\-bit用パッケージを使った場合は、中程度のサイズのデータでもメモリ不足エラーになることがあります。
         
     | 
| 
       311 
311 
     | 
    
         
             
            .sp
         
     | 
| 
       312 
312 
     | 
    
         
             
            \fBノート:\fP
         
     | 
| 
       313 
313 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       314 
314 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       315 
     | 
    
         
            -
            \(aqgroonga\(aqパッケージは全文検索のための最小構成パッケージです。 
     | 
| 
      
 315 
     | 
    
         
            +
            \(aqgroonga\(aqパッケージは全文検索のための最小構成パッケージです。Groongaをサーバー用途で使うなら、設定済みの追加パッケージをインストールすることができます。
         
     | 
| 
       316 
316 
     | 
    
         
             
            .sp
         
     | 
| 
       317 
317 
     | 
    
         
             
            サーバー用途のための3つのパッケージがあります。
         
     | 
| 
       318 
318 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -327,82 +327,9 @@ groonga\-server\-gqtp (GQTPサーバー) 
     | 
|
| 
       327 
327 
     | 
    
         
             
            詳細は \fB/server\fP を参照してください。
         
     | 
| 
       328 
328 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       329 
329 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       330 
     | 
    
         
            -
            .SS squeeze
         
     | 
| 
       331 
     | 
    
         
            -
            .sp
         
     | 
| 
       332 
     | 
    
         
            -
            groongaのaptリポジトリを追加します。
         
     | 
| 
       333 
     | 
    
         
            -
            .sp
         
     | 
| 
       334 
     | 
    
         
            -
            /etc/apt/sources.list.d/groonga.list:
         
     | 
| 
       335 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       336 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       337 
     | 
    
         
            -
            .sp
         
     | 
| 
       338 
     | 
    
         
            -
            .nf
         
     | 
| 
       339 
     | 
    
         
            -
            .ft C
         
     | 
| 
       340 
     | 
    
         
            -
            deb http://packages.groonga.org/debian/ squeeze main
         
     | 
| 
       341 
     | 
    
         
            -
            deb\-src http://packages.groonga.org/debian/ squeeze main
         
     | 
| 
       342 
     | 
    
         
            -
            .ft P
         
     | 
| 
       343 
     | 
    
         
            -
            .fi
         
     | 
| 
       344 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       345 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       346 
     | 
    
         
            -
            .sp
         
     | 
| 
       347 
     | 
    
         
            -
            インストール:
         
     | 
| 
       348 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       349 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       350 
     | 
    
         
            -
            .sp
         
     | 
| 
       351 
     | 
    
         
            -
            .nf
         
     | 
| 
       352 
     | 
    
         
            -
            .ft C
         
     | 
| 
       353 
     | 
    
         
            -
            % sudo aptitude update
         
     | 
| 
       354 
     | 
    
         
            -
            % sudo aptitude \-V \-D \-y \-\-allow\-untrusted install groonga\-keyring
         
     | 
| 
       355 
     | 
    
         
            -
            % sudo aptitude update
         
     | 
| 
       356 
     | 
    
         
            -
            % sudo aptitude \-V \-D \-y install groonga
         
     | 
| 
       357 
     | 
    
         
            -
            .ft P
         
     | 
| 
       358 
     | 
    
         
            -
            .fi
         
     | 
| 
       359 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       360 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       361 
     | 
    
         
            -
            .sp
         
     | 
| 
       362 
     | 
    
         
            -
            \fI\%MeCab\fP をトークナイザーとして使いたいときは、groonga\-tokenizer\-mecabパッケージをインストールしてください。
         
     | 
| 
       363 
     | 
    
         
            -
            .sp
         
     | 
| 
       364 
     | 
    
         
            -
            groonga\-tokenizer\-mecabパッケージのインストール:
         
     | 
| 
       365 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       366 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       367 
     | 
    
         
            -
            .sp
         
     | 
| 
       368 
     | 
    
         
            -
            .nf
         
     | 
| 
       369 
     | 
    
         
            -
            .ft C
         
     | 
| 
       370 
     | 
    
         
            -
            % sudo aptitude \-V \-D \-y install groonga\-tokenizer\-mecab
         
     | 
| 
       371 
     | 
    
         
            -
            .ft P
         
     | 
| 
       372 
     | 
    
         
            -
            .fi
         
     | 
| 
       373 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       374 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       375 
     | 
    
         
            -
            .sp
         
     | 
| 
       376 
     | 
    
         
            -
            \fI\%Munin\fP プラグインを提供するパッケージもあります。Muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
         
     | 
| 
       377 
     | 
    
         
            -
            .sp
         
     | 
| 
       378 
     | 
    
         
            -
            groonga\-munin\-pluginsパッケージのインストール:
         
     | 
| 
       379 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       380 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       381 
     | 
    
         
            -
            .sp
         
     | 
| 
       382 
     | 
    
         
            -
            .nf
         
     | 
| 
       383 
     | 
    
         
            -
            .ft C
         
     | 
| 
       384 
     | 
    
         
            -
            % sudo aptitude \-V \-D \-y install groonga\-munin\-plugins
         
     | 
| 
       385 
     | 
    
         
            -
            .ft P
         
     | 
| 
       386 
     | 
    
         
            -
            .fi
         
     | 
| 
       387 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       388 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       389 
     | 
    
         
            -
            .sp
         
     | 
| 
       390 
     | 
    
         
            -
            MySQL互換のノーマライザーをgroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
         
     | 
| 
       391 
     | 
    
         
            -
            .sp
         
     | 
| 
       392 
     | 
    
         
            -
            groonga\-normalizer\-mysqlパッケージのインストール:
         
     | 
| 
       393 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       394 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       395 
     | 
    
         
            -
            .sp
         
     | 
| 
       396 
     | 
    
         
            -
            .nf
         
     | 
| 
       397 
     | 
    
         
            -
            .ft C
         
     | 
| 
       398 
     | 
    
         
            -
            % sudo aptitude \-V \-D \-y install groonga\-normalizer\-mysql
         
     | 
| 
       399 
     | 
    
         
            -
            .ft P
         
     | 
| 
       400 
     | 
    
         
            -
            .fi
         
     | 
| 
       401 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       402 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       403 
330 
     | 
    
         
             
            .SS wheezy
         
     | 
| 
       404 
331 
     | 
    
         
             
            .sp
         
     | 
| 
       405 
     | 
    
         
            -
             
     | 
| 
      
 332 
     | 
    
         
            +
            Groongaのaptリポジトリを追加します。
         
     | 
| 
       406 
333 
     | 
    
         
             
            .sp
         
     | 
| 
       407 
334 
     | 
    
         
             
            /etc/apt/sources.list.d/groonga.list:
         
     | 
| 
       408 
335 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -446,7 +373,7 @@ groonga\-tokenizer\-mecabパッケージのインストール: 
     | 
|
| 
       446 
373 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       447 
374 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       448 
375 
     | 
    
         
             
            .sp
         
     | 
| 
       449 
     | 
    
         
            -
            \fI\%Munin\fP プラグインを提供するパッケージもあります。Muninで 
     | 
| 
      
 376 
     | 
    
         
            +
            \fI\%Munin\fP プラグインを提供するパッケージもあります。MuninでGroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
         
     | 
| 
       450 
377 
     | 
    
         
             
            .sp
         
     | 
| 
       451 
378 
     | 
    
         
             
            groonga\-munin\-pluginsパッケージのインストール:
         
     | 
| 
       452 
379 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -460,7 +387,7 @@ groonga\-munin\-pluginsパッケージのインストール: 
     | 
|
| 
       460 
387 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       461 
388 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       462 
389 
     | 
    
         
             
            .sp
         
     | 
| 
       463 
     | 
    
         
            -
            MySQL互換のノーマライザーを 
     | 
| 
      
 390 
     | 
    
         
            +
            MySQL互換のノーマライザーをGroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
         
     | 
| 
       464 
391 
     | 
    
         
             
            .sp
         
     | 
| 
       465 
392 
     | 
    
         
             
            groonga\-normalizer\-mysqlパッケージのインストール:
         
     | 
| 
       466 
393 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -475,7 +402,7 @@ groonga\-normalizer\-mysqlパッケージのインストール: 
     | 
|
| 
       475 
402 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       476 
403 
     | 
    
         
             
            .SS jessie
         
     | 
| 
       477 
404 
     | 
    
         
             
            .sp
         
     | 
| 
       478 
     | 
    
         
            -
             
     | 
| 
      
 405 
     | 
    
         
            +
            Groongaのaptリポジトリを追加します。
         
     | 
| 
       479 
406 
     | 
    
         
             
            .sp
         
     | 
| 
       480 
407 
     | 
    
         
             
            /etc/apt/sources.list.d/groonga.list:
         
     | 
| 
       481 
408 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -519,7 +446,7 @@ groonga\-tokenizer\-mecabパッケージのインストール: 
     | 
|
| 
       519 
446 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       520 
447 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       521 
448 
     | 
    
         
             
            .sp
         
     | 
| 
       522 
     | 
    
         
            -
            \fI\%Munin\fP プラグインを提供するパッケージもあります。Muninで 
     | 
| 
      
 449 
     | 
    
         
            +
            \fI\%Munin\fP プラグインを提供するパッケージもあります。MuninでGroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
         
     | 
| 
       523 
450 
     | 
    
         
             
            .sp
         
     | 
| 
       524 
451 
     | 
    
         
             
            groonga\-munin\-pluginsパッケージのインストール:
         
     | 
| 
       525 
452 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -533,7 +460,7 @@ groonga\-munin\-pluginsパッケージのインストール: 
     | 
|
| 
       533 
460 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       534 
461 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       535 
462 
     | 
    
         
             
            .sp
         
     | 
| 
       536 
     | 
    
         
            -
            MySQL互換のノーマライザーを 
     | 
| 
      
 463 
     | 
    
         
            +
            MySQL互換のノーマライザーをGroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
         
     | 
| 
       537 
464 
     | 
    
         
             
            .sp
         
     | 
| 
       538 
465 
     | 
    
         
             
            groonga\-normalizer\-mysqlパッケージのインストール:
         
     | 
| 
       539 
466 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -548,7 +475,7 @@ groonga\-normalizer\-mysqlパッケージのインストール: 
     | 
|
| 
       548 
475 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       549 
476 
     | 
    
         
             
            .SS sid
         
     | 
| 
       550 
477 
     | 
    
         
             
            .sp
         
     | 
| 
       551 
     | 
    
         
            -
             
     | 
| 
      
 478 
     | 
    
         
            +
            Groongaのaptリポジトリを追加します。
         
     | 
| 
       552 
479 
     | 
    
         
             
            .sp
         
     | 
| 
       553 
480 
     | 
    
         
             
            /etc/apt/sources.list.d/groonga.list:
         
     | 
| 
       554 
481 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -592,7 +519,7 @@ groonga\-tokenizer\-mecabパッケージのインストール: 
     | 
|
| 
       592 
519 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       593 
520 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       594 
521 
     | 
    
         
             
            .sp
         
     | 
| 
       595 
     | 
    
         
            -
            \fI\%Munin\fP プラグインを提供するパッケージもあります。Muninで 
     | 
| 
      
 522 
     | 
    
         
            +
            \fI\%Munin\fP プラグインを提供するパッケージもあります。MuninでGroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
         
     | 
| 
       596 
523 
     | 
    
         
             
            .sp
         
     | 
| 
       597 
524 
     | 
    
         
             
            groonga\-munin\-pluginsパッケージのインストール:
         
     | 
| 
       598 
525 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -606,7 +533,7 @@ groonga\-munin\-pluginsパッケージのインストール: 
     | 
|
| 
       606 
533 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       607 
534 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       608 
535 
     | 
    
         
             
            .sp
         
     | 
| 
       609 
     | 
    
         
            -
            MySQL互換のノーマライザーを 
     | 
| 
      
 536 
     | 
    
         
            +
            MySQL互換のノーマライザーをGroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
         
     | 
| 
       610 
537 
     | 
    
         
             
            .sp
         
     | 
| 
       611 
538 
     | 
    
         
             
            groonga\-normalizer\-mysqlパッケージのインストール:
         
     | 
| 
       612 
539 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -621,7 +548,7 @@ groonga\-normalizer\-mysqlパッケージのインストール: 
     | 
|
| 
       621 
548 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       622 
549 
     | 
    
         
             
            .SS ソースからビルド
         
     | 
| 
       623 
550 
     | 
    
         
             
            .sp
         
     | 
| 
       624 
     | 
    
         
            -
             
     | 
| 
      
 551 
     | 
    
         
            +
            Groongaをビルドするために必要なパッケージをインストールします:
         
     | 
| 
       625 
552 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       626 
553 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       627 
554 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -639,9 +566,9 @@ groongaをビルドするために必要なパッケージをインストール 
     | 
|
| 
       639 
566 
     | 
    
         
             
            .sp
         
     | 
| 
       640 
567 
     | 
    
         
             
            .nf
         
     | 
| 
       641 
568 
     | 
    
         
             
            .ft C
         
     | 
| 
       642 
     | 
    
         
            -
            % wget http://packages.groonga.org/source/groonga/groonga\-3.1. 
     | 
| 
       643 
     | 
    
         
            -
            % tar xvzf groonga\-3.1. 
     | 
| 
       644 
     | 
    
         
            -
            % cd groonga\-3.1. 
     | 
| 
      
 569 
     | 
    
         
            +
            % wget http://packages.groonga.org/source/groonga/groonga\-3.1.1.tar.gz
         
     | 
| 
      
 570 
     | 
    
         
            +
            % tar xvzf groonga\-3.1.1.tar.gz
         
     | 
| 
      
 571 
     | 
    
         
            +
            % cd groonga\-3.1.1
         
     | 
| 
       645 
572 
     | 
    
         
             
            .ft P
         
     | 
| 
       646 
573 
     | 
    
         
             
            .fi
         
     | 
| 
       647 
574 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
         @@ -684,14 +611,14 @@ configureを実行します( \fBconfigure\fP のオプションについては 
     | 
|
| 
       684 
611 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       685 
612 
     | 
    
         
             
            .SS Ubuntu
         
     | 
| 
       686 
613 
     | 
    
         
             
            .sp
         
     | 
| 
       687 
     | 
    
         
            -
            このセクションではUbuntu上で 
     | 
| 
      
 614 
     | 
    
         
            +
            このセクションではUbuntu上でGroonga関連のdebパッケージをインストールする方法を説明します。これらのパッケージは \fBapt\fP でインストールできます。
         
     | 
| 
       688 
615 
     | 
    
         
             
            .sp
         
     | 
| 
       689 
616 
     | 
    
         
             
            32\-bit用と64\-bit用のパッケージを配布していますが、サーバ用途には64\-bitパッケージを利用することをオススメします。32\-bit用パッケージはテスト用か開発用にだけ使って下さい。32\-bit用パッケージを使った場合は、中程度のサイズのデータでもメモリ不足エラーになることがあります。
         
     | 
| 
       690 
617 
     | 
    
         
             
            .sp
         
     | 
| 
       691 
618 
     | 
    
         
             
            \fBノート:\fP
         
     | 
| 
       692 
619 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       693 
620 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       694 
     | 
    
         
            -
            \(aqgroonga\(aqパッケージは全文検索のための最小構成パッケージです。 
     | 
| 
      
 621 
     | 
    
         
            +
            \(aqgroonga\(aqパッケージは全文検索のための最小構成パッケージです。Groongaをサーバー用途で使うなら、設定済みの追加パッケージをインストールすることができます。
         
     | 
| 
       695 
622 
     | 
    
         
             
            .sp
         
     | 
| 
       696 
623 
     | 
    
         
             
            サーバー用途のための3つのパッケージがあります。
         
     | 
| 
       697 
624 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -706,103 +633,12 @@ groonga\-server\-gqtp (GQTPサーバー) 
     | 
|
| 
       706 
633 
     | 
    
         
             
            詳細は \fB/server\fP を参照してください。
         
     | 
| 
       707 
634 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       708 
635 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       709 
     | 
    
         
            -
            .SS 10.04 LTS Lucid Lynx
         
     | 
| 
       710 
     | 
    
         
            -
            .sp
         
     | 
| 
       711 
     | 
    
         
            -
            \fBノート:\fP
         
     | 
| 
       712 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       713 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       714 
     | 
    
         
            -
            groongaをインストールするためにuniverseリポジトリを有効にしてください:
         
     | 
| 
       715 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       716 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       717 
     | 
    
         
            -
            .sp
         
     | 
| 
       718 
     | 
    
         
            -
            .nf
         
     | 
| 
       719 
     | 
    
         
            -
            .ft C
         
     | 
| 
       720 
     | 
    
         
            -
            % sudo cp /etc/apt/sources.list /etc/apt/sources.list.d/universe.list
         
     | 
| 
       721 
     | 
    
         
            -
            % sudo sed \-i\(aq\(aq \-e \(aqs/main/universe/\(aq /etc/apt/sources.list.d/universe.list
         
     | 
| 
       722 
     | 
    
         
            -
            .ft P
         
     | 
| 
       723 
     | 
    
         
            -
            .fi
         
     | 
| 
       724 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       725 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       726 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       727 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       728 
     | 
    
         
            -
            .sp
         
     | 
| 
       729 
     | 
    
         
            -
            groongaのaptリポジトリを追加します。
         
     | 
| 
       730 
     | 
    
         
            -
            .sp
         
     | 
| 
       731 
     | 
    
         
            -
            /etc/apt/sources.list.d/groonga.list:
         
     | 
| 
       732 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       733 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       734 
     | 
    
         
            -
            .sp
         
     | 
| 
       735 
     | 
    
         
            -
            .nf
         
     | 
| 
       736 
     | 
    
         
            -
            .ft C
         
     | 
| 
       737 
     | 
    
         
            -
            deb http://packages.groonga.org/ubuntu/ lucid universe
         
     | 
| 
       738 
     | 
    
         
            -
            deb\-src http://packages.groonga.org/ubuntu/ lucid universe
         
     | 
| 
       739 
     | 
    
         
            -
            .ft P
         
     | 
| 
       740 
     | 
    
         
            -
            .fi
         
     | 
| 
       741 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       742 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       743 
     | 
    
         
            -
            .sp
         
     | 
| 
       744 
     | 
    
         
            -
            インストール:
         
     | 
| 
       745 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       746 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       747 
     | 
    
         
            -
            .sp
         
     | 
| 
       748 
     | 
    
         
            -
            .nf
         
     | 
| 
       749 
     | 
    
         
            -
            .ft C
         
     | 
| 
       750 
     | 
    
         
            -
            % sudo apt\-get update
         
     | 
| 
       751 
     | 
    
         
            -
            % sudo apt\-get \-y \-\-allow\-unauthenticated install groonga\-keyring
         
     | 
| 
       752 
     | 
    
         
            -
            % sudo apt\-get update
         
     | 
| 
       753 
     | 
    
         
            -
            % sudo apt\-get \-y install groonga
         
     | 
| 
       754 
     | 
    
         
            -
            .ft P
         
     | 
| 
       755 
     | 
    
         
            -
            .fi
         
     | 
| 
       756 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       757 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       758 
     | 
    
         
            -
            .sp
         
     | 
| 
       759 
     | 
    
         
            -
            \fI\%MeCab\fP をトークナイザーとして使いたいときは、groonga\-tokenizer\-mecabパッケージをインストールしてください。
         
     | 
| 
       760 
     | 
    
         
            -
            .sp
         
     | 
| 
       761 
     | 
    
         
            -
            groonga\-tokenizer\-mecabパッケージのインストール:
         
     | 
| 
       762 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       763 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       764 
     | 
    
         
            -
            .sp
         
     | 
| 
       765 
     | 
    
         
            -
            .nf
         
     | 
| 
       766 
     | 
    
         
            -
            .ft C
         
     | 
| 
       767 
     | 
    
         
            -
            % sudo apt\-get \-y install groonga\-tokenizer\-mecab
         
     | 
| 
       768 
     | 
    
         
            -
            .ft P
         
     | 
| 
       769 
     | 
    
         
            -
            .fi
         
     | 
| 
       770 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       771 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       772 
     | 
    
         
            -
            .sp
         
     | 
| 
       773 
     | 
    
         
            -
            \fI\%Munin\fP プラグインを提供するパッケージもあります。Muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
         
     | 
| 
       774 
     | 
    
         
            -
            .sp
         
     | 
| 
       775 
     | 
    
         
            -
            groonga\-munin\-pluginsパッケージのインストール:
         
     | 
| 
       776 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       777 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       778 
     | 
    
         
            -
            .sp
         
     | 
| 
       779 
     | 
    
         
            -
            .nf
         
     | 
| 
       780 
     | 
    
         
            -
            .ft C
         
     | 
| 
       781 
     | 
    
         
            -
            % sudo apt\-get \-y install groonga\-munin\-plugins
         
     | 
| 
       782 
     | 
    
         
            -
            .ft P
         
     | 
| 
       783 
     | 
    
         
            -
            .fi
         
     | 
| 
       784 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       785 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       786 
     | 
    
         
            -
            .sp
         
     | 
| 
       787 
     | 
    
         
            -
            MySQL互換のノーマライザーをgroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
         
     | 
| 
       788 
     | 
    
         
            -
            .sp
         
     | 
| 
       789 
     | 
    
         
            -
            groonga\-normalizer\-mysqlパッケージのインストール:
         
     | 
| 
       790 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       791 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       792 
     | 
    
         
            -
            .sp
         
     | 
| 
       793 
     | 
    
         
            -
            .nf
         
     | 
| 
       794 
     | 
    
         
            -
            .ft C
         
     | 
| 
       795 
     | 
    
         
            -
            % sudo apt\-get \-y install groonga\-normalizer\-mysql
         
     | 
| 
       796 
     | 
    
         
            -
            .ft P
         
     | 
| 
       797 
     | 
    
         
            -
            .fi
         
     | 
| 
       798 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       799 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       800 
636 
     | 
    
         
             
            .SS 12.04 LTS Precise Pangolin
         
     | 
| 
       801 
637 
     | 
    
         
             
            .sp
         
     | 
| 
       802 
638 
     | 
    
         
             
            \fBノート:\fP
         
     | 
| 
       803 
639 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       804 
640 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       805 
     | 
    
         
            -
             
     | 
| 
      
 641 
     | 
    
         
            +
            Groongaをインストールするためにuniverseリポジトリを有効にしてください:
         
     | 
| 
       806 
642 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       807 
643 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       808 
644 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -817,7 +653,7 @@ groongaをインストールするためにuniverseリポジトリを有効に 
     | 
|
| 
       817 
653 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       818 
654 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       819 
655 
     | 
    
         
             
            .sp
         
     | 
| 
       820 
     | 
    
         
            -
             
     | 
| 
      
 656 
     | 
    
         
            +
            Groongaのaptリポジトリを追加します。
         
     | 
| 
       821 
657 
     | 
    
         
             
            .sp
         
     | 
| 
       822 
658 
     | 
    
         
             
            /etc/apt/sources.list.d/groonga.list:
         
     | 
| 
       823 
659 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -861,7 +697,7 @@ groonga\-tokenizer\-mecabパッケージのインストール: 
     | 
|
| 
       861 
697 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       862 
698 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       863 
699 
     | 
    
         
             
            .sp
         
     | 
| 
       864 
     | 
    
         
            -
            \fI\%Munin\fP プラグインを提供するパッケージもあります。Muninで 
     | 
| 
      
 700 
     | 
    
         
            +
            \fI\%Munin\fP プラグインを提供するパッケージもあります。MuninでGroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
         
     | 
| 
       865 
701 
     | 
    
         
             
            .sp
         
     | 
| 
       866 
702 
     | 
    
         
             
            groonga\-munin\-pluginsパッケージのインストール:
         
     | 
| 
       867 
703 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -875,7 +711,7 @@ groonga\-munin\-pluginsパッケージのインストール: 
     | 
|
| 
       875 
711 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       876 
712 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       877 
713 
     | 
    
         
             
            .sp
         
     | 
| 
       878 
     | 
    
         
            -
            MySQL互換のノーマライザーを 
     | 
| 
      
 714 
     | 
    
         
            +
            MySQL互換のノーマライザーをGroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
         
     | 
| 
       879 
715 
     | 
    
         
             
            .sp
         
     | 
| 
       880 
716 
     | 
    
         
             
            groonga\-normalizer\-mysqlパッケージのインストール:
         
     | 
| 
       881 
717 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -893,7 +729,7 @@ groonga\-normalizer\-mysqlパッケージのインストール: 
     | 
|
| 
       893 
729 
     | 
    
         
             
            \fBノート:\fP
         
     | 
| 
       894 
730 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       895 
731 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       896 
     | 
    
         
            -
             
     | 
| 
      
 732 
     | 
    
         
            +
            Groongaをインストールするためにuniverseリポジトリを有効にしてください:
         
     | 
| 
       897 
733 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       898 
734 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       899 
735 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -908,7 +744,7 @@ groongaをインストールするためにuniverseリポジトリを有効に 
     | 
|
| 
       908 
744 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       909 
745 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       910 
746 
     | 
    
         
             
            .sp
         
     | 
| 
       911 
     | 
    
         
            -
             
     | 
| 
      
 747 
     | 
    
         
            +
            Groongaのaptリポジトリを追加します。
         
     | 
| 
       912 
748 
     | 
    
         
             
            .sp
         
     | 
| 
       913 
749 
     | 
    
         
             
            /etc/apt/sources.list.d/groonga.list:
         
     | 
| 
       914 
750 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -952,7 +788,7 @@ groonga\-tokenizer\-mecabパッケージのインストール: 
     | 
|
| 
       952 
788 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       953 
789 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       954 
790 
     | 
    
         
             
            .sp
         
     | 
| 
       955 
     | 
    
         
            -
            \fI\%Munin\fP プラグインを提供するパッケージもあります。Muninで 
     | 
| 
      
 791 
     | 
    
         
            +
            \fI\%Munin\fP プラグインを提供するパッケージもあります。MuninでGroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
         
     | 
| 
       956 
792 
     | 
    
         
             
            .sp
         
     | 
| 
       957 
793 
     | 
    
         
             
            groonga\-munin\-pluginsパッケージのインストール:
         
     | 
| 
       958 
794 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -966,7 +802,7 @@ groonga\-munin\-pluginsパッケージのインストール: 
     | 
|
| 
       966 
802 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       967 
803 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       968 
804 
     | 
    
         
             
            .sp
         
     | 
| 
       969 
     | 
    
         
            -
            MySQL互換のノーマライザーを 
     | 
| 
      
 805 
     | 
    
         
            +
            MySQL互換のノーマライザーをGroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
         
     | 
| 
       970 
806 
     | 
    
         
             
            .sp
         
     | 
| 
       971 
807 
     | 
    
         
             
            groonga\-normalizer\-mysqlパッケージのインストール:
         
     | 
| 
       972 
808 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -984,7 +820,7 @@ groonga\-normalizer\-mysqlパッケージのインストール: 
     | 
|
| 
       984 
820 
     | 
    
         
             
            \fBノート:\fP
         
     | 
| 
       985 
821 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       986 
822 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       987 
     | 
    
         
            -
             
     | 
| 
      
 823 
     | 
    
         
            +
            Groongaをインストールするためにuniverseリポジトリを有効にしてください:
         
     | 
| 
       988 
824 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       989 
825 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       990 
826 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -999,7 +835,7 @@ groongaをインストールするためにuniverseリポジトリを有効に 
     | 
|
| 
       999 
835 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1000 
836 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1001 
837 
     | 
    
         
             
            .sp
         
     | 
| 
       1002 
     | 
    
         
            -
             
     | 
| 
      
 838 
     | 
    
         
            +
            Groongaのaptリポジトリを追加します。
         
     | 
| 
       1003 
839 
     | 
    
         
             
            .sp
         
     | 
| 
       1004 
840 
     | 
    
         
             
            /etc/apt/sources.list.d/groonga.list:
         
     | 
| 
       1005 
841 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -1043,7 +879,7 @@ groonga\-tokenizer\-mecabパッケージのインストール: 
     | 
|
| 
       1043 
879 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1044 
880 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1045 
881 
     | 
    
         
             
            .sp
         
     | 
| 
       1046 
     | 
    
         
            -
            \fI\%Munin\fP プラグインを提供するパッケージもあります。Muninで 
     | 
| 
      
 882 
     | 
    
         
            +
            \fI\%Munin\fP プラグインを提供するパッケージもあります。MuninでGroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
         
     | 
| 
       1047 
883 
     | 
    
         
             
            .sp
         
     | 
| 
       1048 
884 
     | 
    
         
             
            groonga\-munin\-pluginsパッケージのインストール:
         
     | 
| 
       1049 
885 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -1057,7 +893,7 @@ groonga\-munin\-pluginsパッケージのインストール: 
     | 
|
| 
       1057 
893 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1058 
894 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1059 
895 
     | 
    
         
             
            .sp
         
     | 
| 
       1060 
     | 
    
         
            -
            MySQL互換のノーマライザーを 
     | 
| 
      
 896 
     | 
    
         
            +
            MySQL互換のノーマライザーをGroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
         
     | 
| 
       1061 
897 
     | 
    
         
             
            .sp
         
     | 
| 
       1062 
898 
     | 
    
         
             
            groonga\-normalizer\-mysqlパッケージのインストール:
         
     | 
| 
       1063 
899 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -1145,7 +981,7 @@ groonga\-normalizer\-mysqlパッケージのインストール: 
     | 
|
| 
       1145 
981 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1146 
982 
     | 
    
         
             
            .SS ソースからビルド
         
     | 
| 
       1147 
983 
     | 
    
         
             
            .sp
         
     | 
| 
       1148 
     | 
    
         
            -
             
     | 
| 
      
 984 
     | 
    
         
            +
            Groongaをビルドするために必要なパッケージをインストールします:
         
     | 
| 
       1149 
985 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       1150 
986 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       1151 
987 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -1163,9 +999,9 @@ groongaをビルドするために必要なパッケージをインストール 
     | 
|
| 
       1163 
999 
     | 
    
         
             
            .sp
         
     | 
| 
       1164 
1000 
     | 
    
         
             
            .nf
         
     | 
| 
       1165 
1001 
     | 
    
         
             
            .ft C
         
     | 
| 
       1166 
     | 
    
         
            -
            % wget http://packages.groonga.org/source/groonga/groonga\-3.1. 
     | 
| 
       1167 
     | 
    
         
            -
            % tar xvzf groonga\-3.1. 
     | 
| 
       1168 
     | 
    
         
            -
            % cd groonga\-3.1. 
     | 
| 
      
 1002 
     | 
    
         
            +
            % wget http://packages.groonga.org/source/groonga/groonga\-3.1.1.tar.gz
         
     | 
| 
      
 1003 
     | 
    
         
            +
            % tar xvzf groonga\-3.1.1.tar.gz
         
     | 
| 
      
 1004 
     | 
    
         
            +
            % cd groonga\-3.1.1
         
     | 
| 
       1169 
1005 
     | 
    
         
             
            .ft P
         
     | 
| 
       1170 
1006 
     | 
    
         
             
            .fi
         
     | 
| 
       1171 
1007 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
         @@ -1208,14 +1044,14 @@ configureを実行します( \fBconfigure\fP のオプションについては 
     | 
|
| 
       1208 
1044 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1209 
1045 
     | 
    
         
             
            .SS CentOS
         
     | 
| 
       1210 
1046 
     | 
    
         
             
            .sp
         
     | 
| 
       1211 
     | 
    
         
            -
            このセクションではCentOS上で 
     | 
| 
      
 1047 
     | 
    
         
            +
            このセクションではCentOS上でGroonga関連のPRMパッケージをインストールする方法を説明します。これらのパッケージは \fByum\fP でインストールできます。
         
     | 
| 
       1212 
1048 
     | 
    
         
             
            .sp
         
     | 
| 
       1213 
1049 
     | 
    
         
             
            32\-bit用と64\-bit用のパッケージを配布していますが、サーバ用途には64\-bitパッケージを利用することをオススメします。32\-bit用パッケージはテスト用か開発用にだけ使って下さい。32\-bit用パッケージを使った場合は、中程度のサイズのデータでもメモリ不足エラーになることがあります。
         
     | 
| 
       1214 
1050 
     | 
    
         
             
            .sp
         
     | 
| 
       1215 
1051 
     | 
    
         
             
            \fBノート:\fP
         
     | 
| 
       1216 
1052 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       1217 
1053 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       1218 
     | 
    
         
            -
            \(aqgroonga\(aqパッケージは全文検索のための最小構成パッケージです。 
     | 
| 
      
 1054 
     | 
    
         
            +
            \(aqgroonga\(aqパッケージは全文検索のための最小構成パッケージです。Groongaをサーバー用途で使うなら、設定済みの追加パッケージをインストールすることができます。
         
     | 
| 
       1219 
1055 
     | 
    
         
             
            .sp
         
     | 
| 
       1220 
1056 
     | 
    
         
             
            サーバー用途のための3つのパッケージがあります。
         
     | 
| 
       1221 
1057 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -1286,7 +1122,7 @@ IPA辞書をインストールします: 
     | 
|
| 
       1286 
1122 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1287 
1123 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1288 
1124 
     | 
    
         
             
            .sp
         
     | 
| 
       1289 
     | 
    
         
            -
            \fI\%Munin\fP プラグインを提供するパッケージもあります。Muninで 
     | 
| 
      
 1125 
     | 
    
         
            +
            \fI\%Munin\fP プラグインを提供するパッケージもあります。MuninでGroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
         
     | 
| 
       1290 
1126 
     | 
    
         
             
            .sp
         
     | 
| 
       1291 
1127 
     | 
    
         
             
            \fBノート:\fP
         
     | 
| 
       1292 
1128 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -1346,7 +1182,7 @@ groonga\-munin\-pluginsパッケージのインストール: 
     | 
|
| 
       1346 
1182 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1347 
1183 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1348 
1184 
     | 
    
         
             
            .sp
         
     | 
| 
       1349 
     | 
    
         
            -
            MySQL互換のノーマライザーを 
     | 
| 
      
 1185 
     | 
    
         
            +
            MySQL互換のノーマライザーをGroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
         
     | 
| 
       1350 
1186 
     | 
    
         
             
            .sp
         
     | 
| 
       1351 
1187 
     | 
    
         
             
            groonga\-normalizer\-mysqlパッケージのインストール:
         
     | 
| 
       1352 
1188 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -1415,7 +1251,7 @@ IPA辞書をインストールします: 
     | 
|
| 
       1415 
1251 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1416 
1252 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1417 
1253 
     | 
    
         
             
            .sp
         
     | 
| 
       1418 
     | 
    
         
            -
            \fI\%Munin\fP プラグインを提供するパッケージもあります。Muninで 
     | 
| 
      
 1254 
     | 
    
         
            +
            \fI\%Munin\fP プラグインを提供するパッケージもあります。MuninでGroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
         
     | 
| 
       1419 
1255 
     | 
    
         
             
            .sp
         
     | 
| 
       1420 
1256 
     | 
    
         
             
            \fBノート:\fP
         
     | 
| 
       1421 
1257 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -1448,7 +1284,7 @@ groonga\-munin\-pluginsパッケージのインストール: 
     | 
|
| 
       1448 
1284 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1449 
1285 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1450 
1286 
     | 
    
         
             
            .sp
         
     | 
| 
       1451 
     | 
    
         
            -
            MySQL互換のノーマライザーを 
     | 
| 
      
 1287 
     | 
    
         
            +
            MySQL互換のノーマライザーをGroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
         
     | 
| 
       1452 
1288 
     | 
    
         
             
            .sp
         
     | 
| 
       1453 
1289 
     | 
    
         
             
            groonga\-normalizer\-mysqlパッケージのインストール:
         
     | 
| 
       1454 
1290 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -1463,7 +1299,7 @@ groonga\-normalizer\-mysqlパッケージのインストール: 
     | 
|
| 
       1463 
1299 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1464 
1300 
     | 
    
         
             
            .SS ソースからビルド
         
     | 
| 
       1465 
1301 
     | 
    
         
             
            .sp
         
     | 
| 
       1466 
     | 
    
         
            -
             
     | 
| 
      
 1302 
     | 
    
         
            +
            Groongaをビルドするために必要なパッケージをインストールします:
         
     | 
| 
       1467 
1303 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       1468 
1304 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       1469 
1305 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -1481,9 +1317,9 @@ groongaをビルドするために必要なパッケージをインストール 
     | 
|
| 
       1481 
1317 
     | 
    
         
             
            .sp
         
     | 
| 
       1482 
1318 
     | 
    
         
             
            .nf
         
     | 
| 
       1483 
1319 
     | 
    
         
             
            .ft C
         
     | 
| 
       1484 
     | 
    
         
            -
            % wget http://packages.groonga.org/source/groonga/groonga\-3.1. 
     | 
| 
       1485 
     | 
    
         
            -
            % tar xvzf groonga\-3.1. 
     | 
| 
       1486 
     | 
    
         
            -
            % cd groonga\-3.1. 
     | 
| 
      
 1320 
     | 
    
         
            +
            % wget http://packages.groonga.org/source/groonga/groonga\-3.1.1.tar.gz
         
     | 
| 
      
 1321 
     | 
    
         
            +
            % tar xvzf groonga\-3.1.1.tar.gz
         
     | 
| 
      
 1322 
     | 
    
         
            +
            % cd groonga\-3.1.1
         
     | 
| 
       1487 
1323 
     | 
    
         
             
            .ft P
         
     | 
| 
       1488 
1324 
     | 
    
         
             
            .fi
         
     | 
| 
       1489 
1325 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
         @@ -1526,12 +1362,12 @@ configureを実行します( \fBconfigure\fP のオプションについては 
     | 
|
| 
       1526 
1362 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1527 
1363 
     | 
    
         
             
            .SS Fedora
         
     | 
| 
       1528 
1364 
     | 
    
         
             
            .sp
         
     | 
| 
       1529 
     | 
    
         
            -
            このセクションではFedora上で 
     | 
| 
      
 1365 
     | 
    
         
            +
            このセクションではFedora上でGroonga関連のRPMパッケージをインストールする方法を説明します。これらのパッケージは \fByum\fP でインストールできます。
         
     | 
| 
       1530 
1366 
     | 
    
         
             
            .sp
         
     | 
| 
       1531 
1367 
     | 
    
         
             
            \fBノート:\fP
         
     | 
| 
       1532 
1368 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       1533 
1369 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       1534 
     | 
    
         
            -
            3.0.2のリリースから、 
     | 
| 
      
 1370 
     | 
    
         
            +
            3.0.2のリリースから、Groonga関連のRPMパッケージはFedoraの公式yumリポジトリでリリースしています。GroongaのyumリポジトリのかわりにFedoraの公式リポジトリを使います。ただ、いくつか例外があって、 \fBgroonga\-normalizer\-mysql\fP や MeCabの辞書 ( \fBmecab\-ipadic\fP や \fBmecab\-jumandic\fP )パッケージを使うにはGroongaのyumリポジトリを使います。将来的には \fBgroonga\-normalizer\-mysql\fP もFedora公式のyumリポジトリで提供することを計画しています。
         
     | 
| 
       1535 
1371 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1536 
1372 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1537 
1373 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -1540,7 +1376,7 @@ configureを実行します( \fBconfigure\fP のオプションについては 
     | 
|
| 
       1540 
1376 
     | 
    
         
             
            \fBノート:\fP
         
     | 
| 
       1541 
1377 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       1542 
1378 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       1543 
     | 
    
         
            -
            \(aqgroonga\(aqパッケージは全文検索のための最小構成パッケージです。 
     | 
| 
      
 1379 
     | 
    
         
            +
            \(aqgroonga\(aqパッケージは全文検索のための最小構成パッケージです。Groongaをサーバー用途で使うなら、設定済みの追加パッケージをインストールすることができます。
         
     | 
| 
       1544 
1380 
     | 
    
         
             
            .sp
         
     | 
| 
       1545 
1381 
     | 
    
         
             
            サーバー用途のための3つのパッケージがあります。
         
     | 
| 
       1546 
1382 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -1555,7 +1391,7 @@ groonga\-server\-gqtp (GQTPサーバー) 
     | 
|
| 
       1555 
1391 
     | 
    
         
             
            詳細は \fB/server\fP を参照してください。
         
     | 
| 
       1556 
1392 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1557 
1393 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1558 
     | 
    
         
            -
            .SS Fedora  
     | 
| 
      
 1394 
     | 
    
         
            +
            .SS Fedora 20
         
     | 
| 
       1559 
1395 
     | 
    
         
             
            .sp
         
     | 
| 
       1560 
1396 
     | 
    
         
             
            インストール:
         
     | 
| 
       1561 
1397 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -1569,7 +1405,7 @@ groonga\-server\-gqtp (GQTPサーバー) 
     | 
|
| 
       1569 
1405 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1570 
1406 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1571 
1407 
     | 
    
         
             
            .sp
         
     | 
| 
       1572 
     | 
    
         
            -
            \fBgroonga\-normalizer\-mysql\fP や \fBmecab\-ipadic\fP 、 \fBmecab\-jumandic\fP といったパッケージを使うには  
     | 
| 
      
 1408 
     | 
    
         
            +
            \fBgroonga\-normalizer\-mysql\fP や \fBmecab\-ipadic\fP 、 \fBmecab\-jumandic\fP といったパッケージを使うには Groongaのyumリポジトリを提供する \fBgroonga\-release\fP パッケージをあらかじめインストールします。
         
     | 
| 
       1573 
1409 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       1574 
1410 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       1575 
1411 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -1622,7 +1458,7 @@ IPA辞書をインストールします: 
     | 
|
| 
       1622 
1458 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1623 
1459 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1624 
1460 
     | 
    
         
             
            .sp
         
     | 
| 
       1625 
     | 
    
         
            -
            \fI\%Munin\fP プラグインを提供するパッケージもあります。Muninで 
     | 
| 
      
 1461 
     | 
    
         
            +
            \fI\%Munin\fP プラグインを提供するパッケージもあります。MuninでGroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
         
     | 
| 
       1626 
1462 
     | 
    
         
             
            .sp
         
     | 
| 
       1627 
1463 
     | 
    
         
             
            groonga\-munin\-pluginsパッケージのインストール:
         
     | 
| 
       1628 
1464 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -1636,7 +1472,7 @@ groonga\-munin\-pluginsパッケージのインストール: 
     | 
|
| 
       1636 
1472 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1637 
1473 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1638 
1474 
     | 
    
         
             
            .sp
         
     | 
| 
       1639 
     | 
    
         
            -
            MySQL互換のノーマライザーを 
     | 
| 
      
 1475 
     | 
    
         
            +
            MySQL互換のノーマライザーをGroongaのプラグインとして提供するパッケージがあります。MySQL互換のノーマライザーを使うには \fBgroonga\-normalizer\-mysql\fP パッケージをインストールしてください。
         
     | 
| 
       1640 
1476 
     | 
    
         
             
            .sp
         
     | 
| 
       1641 
1477 
     | 
    
         
             
            groonga\-normalizer\-mysqlパッケージのインストール:
         
     | 
| 
       1642 
1478 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -1651,7 +1487,7 @@ groonga\-normalizer\-mysqlパッケージのインストール: 
     | 
|
| 
       1651 
1487 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1652 
1488 
     | 
    
         
             
            .SS ソースからビルド
         
     | 
| 
       1653 
1489 
     | 
    
         
             
            .sp
         
     | 
| 
       1654 
     | 
    
         
            -
             
     | 
| 
      
 1490 
     | 
    
         
            +
            Groongaをビルドするために必要なパッケージをインストールします:
         
     | 
| 
       1655 
1491 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       1656 
1492 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       1657 
1493 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -1669,9 +1505,9 @@ groongaをビルドするために必要なパッケージをインストール 
     | 
|
| 
       1669 
1505 
     | 
    
         
             
            .sp
         
     | 
| 
       1670 
1506 
     | 
    
         
             
            .nf
         
     | 
| 
       1671 
1507 
     | 
    
         
             
            .ft C
         
     | 
| 
       1672 
     | 
    
         
            -
            % wget http://packages.groonga.org/source/groonga/groonga\-3.1. 
     | 
| 
       1673 
     | 
    
         
            -
            % tar xvzf groonga\-3.1. 
     | 
| 
       1674 
     | 
    
         
            -
            % cd groonga\-3.1. 
     | 
| 
      
 1508 
     | 
    
         
            +
            % wget http://packages.groonga.org/source/groonga/groonga\-3.1.1.tar.gz
         
     | 
| 
      
 1509 
     | 
    
         
            +
            % tar xvzf groonga\-3.1.1.tar.gz
         
     | 
| 
      
 1510 
     | 
    
         
            +
            % cd groonga\-3.1.1
         
     | 
| 
       1675 
1511 
     | 
    
         
             
            .ft P
         
     | 
| 
       1676 
1512 
     | 
    
         
             
            .fi
         
     | 
| 
       1677 
1513 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
         @@ -1714,10 +1550,10 @@ configureを実行します( \fBconfigure\fP のオプションについては 
     | 
|
| 
       1714 
1550 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1715 
1551 
     | 
    
         
             
            .SS Oracle Solaris
         
     | 
| 
       1716 
1552 
     | 
    
         
             
            .sp
         
     | 
| 
       1717 
     | 
    
         
            -
            このセクションではOracle Solaris上で 
     | 
| 
      
 1553 
     | 
    
         
            +
            このセクションではOracle Solaris上でGroongaをソースコードからインストールする方法を説明します。
         
     | 
| 
       1718 
1554 
     | 
    
         
             
            .SS Oracle Solaris 11
         
     | 
| 
       1719 
1555 
     | 
    
         
             
            .sp
         
     | 
| 
       1720 
     | 
    
         
            -
             
     | 
| 
      
 1556 
     | 
    
         
            +
            Groongaをビルドするために必要なパッケージをインストールします:
         
     | 
| 
       1721 
1557 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       1722 
1558 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       1723 
1559 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -1735,9 +1571,9 @@ groongaをビルドするために必要なパッケージをインストール 
     | 
|
| 
       1735 
1571 
     | 
    
         
             
            .sp
         
     | 
| 
       1736 
1572 
     | 
    
         
             
            .nf
         
     | 
| 
       1737 
1573 
     | 
    
         
             
            .ft C
         
     | 
| 
       1738 
     | 
    
         
            -
            % wget http://packages.groonga.org/source/groonga/groonga\-3.1. 
     | 
| 
       1739 
     | 
    
         
            -
            % gtar xvzf groonga\-3.1. 
     | 
| 
       1740 
     | 
    
         
            -
            % cd groonga\-3.1. 
     | 
| 
      
 1574 
     | 
    
         
            +
            % wget http://packages.groonga.org/source/groonga/groonga\-3.1.1.tar.gz
         
     | 
| 
      
 1575 
     | 
    
         
            +
            % gtar xvzf groonga\-3.1.1.tar.gz
         
     | 
| 
      
 1576 
     | 
    
         
            +
            % cd groonga\-3.1.1
         
     | 
| 
       1741 
1577 
     | 
    
         
             
            .ft P
         
     | 
| 
       1742 
1578 
     | 
    
         
             
            .fi
         
     | 
| 
       1743 
1579 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
         @@ -1780,12 +1616,12 @@ groongaをビルドするために必要なパッケージをインストール 
     | 
|
| 
       1780 
1616 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1781 
1617 
     | 
    
         
             
            .SS その他
         
     | 
| 
       1782 
1618 
     | 
    
         
             
            .sp
         
     | 
| 
       1783 
     | 
    
         
            -
            このセクションではUNIX系の環境で 
     | 
| 
      
 1619 
     | 
    
         
            +
            このセクションではUNIX系の環境でGroongaをソースコードからインストールする方法を説明します。
         
     | 
| 
       1784 
1620 
     | 
    
         
             
            .sp
         
     | 
| 
       1785 
1621 
     | 
    
         
             
            \fB/install\fP にある特定環境用のドキュメントに、その環境向けのより詳細な情報があります。特定環境用のドキュメントがある場合は、まずそちらを参照してください。
         
     | 
| 
       1786 
1622 
     | 
    
         
             
            .SS 依存関係
         
     | 
| 
       1787 
1623 
     | 
    
         
             
            .sp
         
     | 
| 
       1788 
     | 
    
         
            -
             
     | 
| 
      
 1624 
     | 
    
         
            +
            Groongaは特別なライブラリを必要としませんが、いくつかビルドに必要なツールがあります。
         
     | 
| 
       1789 
1625 
     | 
    
         
             
            .SS ツール
         
     | 
| 
       1790 
1626 
     | 
    
         
             
            .sp
         
     | 
| 
       1791 
1627 
     | 
    
         
             
            以下が必要なツールです:
         
     | 
| 
         @@ -1817,7 +1653,7 @@ CコンパイラーとC++コンパイラー ( \fBgcc\fP と \fBg++\fP がサ 
     | 
|
| 
       1817 
1653 
     | 
    
         
             
            .IP \(bu 2
         
     | 
| 
       1818 
1654 
     | 
    
         
             
            \fI\%pkg\-config\fP (ライブラリを検出するため)
         
     | 
| 
       1819 
1655 
     | 
    
         
             
            .IP \(bu 2
         
     | 
| 
       1820 
     | 
    
         
            -
            \fI\%sudo\fP (ビルドした 
     | 
| 
      
 1656 
     | 
    
         
            +
            \fI\%sudo\fP (ビルドしたGroongaをインストールするため)
         
     | 
| 
       1821 
1657 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1822 
1658 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1823 
1659 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
         @@ -1849,18 +1685,18 @@ CコンパイラーとC++コンパイラー ( \fBgcc\fP と \fBg++\fP がサ 
     | 
|
| 
       1849 
1685 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1850 
1686 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       1851 
1687 
     | 
    
         
             
            .sp
         
     | 
| 
       1852 
     | 
    
         
            -
            これらのライブラリを使いたい場合は、 
     | 
| 
      
 1688 
     | 
    
         
            +
            これらのライブラリを使いたい場合は、Groongaをインストールする前にライブラリをインストールしてください。
         
     | 
| 
       1853 
1689 
     | 
    
         
             
            .SS ソースからビルド
         
     | 
| 
       1854 
1690 
     | 
    
         
             
            .sp
         
     | 
| 
       1855 
     | 
    
         
            -
             
     | 
| 
      
 1691 
     | 
    
         
            +
            GroongaはGNUビルドシステムを使っています。以下は一番簡単なビルド手順です:
         
     | 
| 
       1856 
1692 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       1857 
1693 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       1858 
1694 
     | 
    
         
             
            .sp
         
     | 
| 
       1859 
1695 
     | 
    
         
             
            .nf
         
     | 
| 
       1860 
1696 
     | 
    
         
             
            .ft C
         
     | 
| 
       1861 
     | 
    
         
            -
            % wget http://packages.groonga.org/source/groonga/groonga\-3.1. 
     | 
| 
       1862 
     | 
    
         
            -
            % tar xvzf groonga\-3.1. 
     | 
| 
       1863 
     | 
    
         
            -
            % cd groonga\-3.1. 
     | 
| 
      
 1697 
     | 
    
         
            +
            % wget http://packages.groonga.org/source/groonga/groonga\-3.1.1.tar.gz
         
     | 
| 
      
 1698 
     | 
    
         
            +
            % tar xvzf groonga\-3.1.1.tar.gz
         
     | 
| 
      
 1699 
     | 
    
         
            +
            % cd groonga\-3.1.1
         
     | 
| 
       1864 
1700 
     | 
    
         
             
            % ./configure
         
     | 
| 
       1865 
1701 
     | 
    
         
             
            % make
         
     | 
| 
       1866 
1702 
     | 
    
         
             
            % sudo make install
         
     | 
| 
         @@ -1871,7 +1707,7 @@ groongaはGNUビルドシステムを使っています。以下は一番簡単 
     | 
|
| 
       1871 
1707 
     | 
    
         
             
            .sp
         
     | 
| 
       1872 
1708 
     | 
    
         
             
            上記の手順を実行すると \fB/usr/local/bin/groonga\fP に \fB/reference/executables/groonga\fP がインストールされます。
         
     | 
| 
       1873 
1709 
     | 
    
         
             
            .sp
         
     | 
| 
       1874 
     | 
    
         
            -
            デフォルトのビルドでもうまく動くでしょうが、 \fBconfigure\fP のときに 
     | 
| 
      
 1710 
     | 
    
         
            +
            デフォルトのビルドでもうまく動くでしょうが、 \fBconfigure\fP のときにGroongaをカスタマイズすることができます。
         
     | 
| 
       1875 
1711 
     | 
    
         
             
            .sp
         
     | 
| 
       1876 
1712 
     | 
    
         
             
            以下、それぞれの手順の詳細を説明します。
         
     | 
| 
       1877 
1713 
     | 
    
         
             
            .SS \fBconfigure\fP
         
     | 
| 
         @@ -1879,11 +1715,11 @@ groongaはGNUビルドシステムを使っています。以下は一番簡単 
     | 
|
| 
       1879 
1715 
     | 
    
         
             
            まず \fBconfigure\fP を実行します。重要な \fBconfigure\fP のオプションは以下の通りです:
         
     | 
| 
       1880 
1716 
     | 
    
         
             
            .SS \fB\-\-prefix=PATH\fP
         
     | 
| 
       1881 
1717 
     | 
    
         
             
            .sp
         
     | 
| 
       1882 
     | 
    
         
            -
            インストール先となるディレクトリを指定します。 
     | 
| 
      
 1718 
     | 
    
         
            +
            インストール先となるディレクトリを指定します。Groonga関連のファイルは  \fB${PATH}/\fP ディレクトリ以下にインストールされます。
         
     | 
| 
       1883 
1719 
     | 
    
         
             
            .sp
         
     | 
| 
       1884 
1720 
     | 
    
         
             
            デフォルトは \fB/usr/local\fP 。デフォルトの場合は \fB/reference/executables/groonga\fP は \fB/usr/local/bin/groonga\fP にインストールされます。
         
     | 
| 
       1885 
1721 
     | 
    
         
             
            .sp
         
     | 
| 
       1886 
     | 
    
         
            -
            以下はシステム全体に 
     | 
| 
      
 1722 
     | 
    
         
            +
            以下はシステム全体にGroongaをインストールするのではなく、ユーザーが個人で使う目的で \fB~/local\fP にインストールする例です:
         
     | 
| 
       1887 
1723 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       1888 
1724 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       1889 
1725 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -2014,7 +1850,7 @@ LZOを使ってカラム値を圧縮する機能を有効にします。 
     | 
|
| 
       2014 
1850 
     | 
    
         
             
            .sp
         
     | 
| 
       2015 
1851 
     | 
    
         
             
            MessagePackがどこにインストールされているかを指定します。MessagePackを \fB\-\-prefix=/usr\fP という \fBconfigure\fP オプションでインストールしていない場合は、MessagePackをビルドするときに指定したパスをこのオプションで指定してください。
         
     | 
| 
       2016 
1852 
     | 
    
         
             
            .sp
         
     | 
| 
       2017 
     | 
    
         
            -
            もし、MessagePackを \fB\-\-prefix=$HOME/local\fP という \fBconfigure\fP オプションでインストールした場合は、 
     | 
| 
      
 1853 
     | 
    
         
            +
            もし、MessagePackを \fB\-\-prefix=$HOME/local\fP という \fBconfigure\fP オプションでインストールした場合は、Groongaの \fBconfigure\fP では \fB\-\-with\-message\-pack=$HOME/local\fP と指定してください。
         
     | 
| 
       2018 
1854 
     | 
    
         
             
            .sp
         
     | 
| 
       2019 
1855 
     | 
    
         
             
            デフォルトは \fB/usr\fP です。
         
     | 
| 
       2020 
1856 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -2031,11 +1867,11 @@ MessagePackがどこにインストールされているかを指定します。 
     | 
|
| 
       2031 
1867 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       2032 
1868 
     | 
    
         
             
            .SS \fB\-\-with\-munin\-plugins\fP
         
     | 
| 
       2033 
1869 
     | 
    
         
             
            .sp
         
     | 
| 
       2034 
     | 
    
         
            -
             
     | 
| 
      
 1870 
     | 
    
         
            +
            Groonga用のMuninプラグインをインストールします。プラグインは \fB${PREFIX}/share/groonga/munin/plugins/\fP 以下にインストールされます。
         
     | 
| 
       2035 
1871 
     | 
    
         
             
            .sp
         
     | 
| 
       2036 
1872 
     | 
    
         
             
            デフォルトではプラグインはインストールされません。
         
     | 
| 
       2037 
1873 
     | 
    
         
             
            .sp
         
     | 
| 
       2038 
     | 
    
         
            -
            以下は 
     | 
| 
      
 1874 
     | 
    
         
            +
            以下はGroonga用のMuninプラグインをインストールする例です:
         
     | 
| 
       2039 
1875 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       2040 
1876 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       2041 
1877 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -2068,7 +1904,7 @@ initスクリプトなどプラットフォーム依存のシステム管理フ 
     | 
|
| 
       2068 
1904 
     | 
    
         
             
            すべての \fBconfigure\fP オプションを表示します。
         
     | 
| 
       2069 
1905 
     | 
    
         
             
            .SS \fBmake\fP
         
     | 
| 
       2070 
1906 
     | 
    
         
             
            .sp
         
     | 
| 
       2071 
     | 
    
         
            -
            \fBconfigure\fP が成功したら \fBmake\fP で 
     | 
| 
      
 1907 
     | 
    
         
            +
            \fBconfigure\fP が成功したら \fBmake\fP でGroongaをビルドします:
         
     | 
| 
       2072 
1908 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       2073 
1909 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       2074 
1910 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -2095,7 +1931,7 @@ initスクリプトなどプラットフォーム依存のシステム管理フ 
     | 
|
| 
       2095 
1931 
     | 
    
         
             
            \fBmake\fP で何かエラーが発生した場合は、そのエラーをレポートしてください: \fB/contribution/report\fP
         
     | 
| 
       2096 
1932 
     | 
    
         
             
            .SS \fBmake install\fP
         
     | 
| 
       2097 
1933 
     | 
    
         
             
            .sp
         
     | 
| 
       2098 
     | 
    
         
            -
            これでビルドした 
     | 
| 
      
 1934 
     | 
    
         
            +
            これでビルドしたGroongaをインストールできます!:
         
     | 
| 
       2099 
1935 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       2100 
1936 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       2101 
1937 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -2120,10 +1956,10 @@ initスクリプトなどプラットフォーム依存のシステム管理フ 
     | 
|
| 
       2120 
1956 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       2121 
1957 
     | 
    
         
             
            .SH コミュニティ
         
     | 
| 
       2122 
1958 
     | 
    
         
             
            .sp
         
     | 
| 
       2123 
     | 
    
         
            -
             
     | 
| 
      
 1959 
     | 
    
         
            +
            Groongaに関する情報を共有するための場所がいくつかあります。あなたの参加をお待ちしています!
         
     | 
| 
       2124 
1960 
     | 
    
         
             
            .SS メーリングリスト
         
     | 
| 
       2125 
1961 
     | 
    
         
             
            .sp
         
     | 
| 
       2126 
     | 
    
         
            -
             
     | 
| 
      
 1962 
     | 
    
         
            +
            Groongaに関する話題を扱うメーリングリストがあります。
         
     | 
| 
       2127 
1963 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       2128 
1964 
     | 
    
         
             
            .TP
         
     | 
| 
       2129 
1965 
     | 
    
         
             
            .B For English speakers
         
     | 
| 
         @@ -2134,21 +1970,21 @@ groongaに関する話題を扱うメーリングリストがあります。 
     | 
|
| 
       2134 
1970 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       2135 
1971 
     | 
    
         
             
            .SS Twitter
         
     | 
| 
       2136 
1972 
     | 
    
         
             
            .sp
         
     | 
| 
       2137 
     | 
    
         
            -
            \fI\%@groonga\fP が 
     | 
| 
      
 1973 
     | 
    
         
            +
            \fI\%@groonga\fP がGroonga関連情報をツイートしています。
         
     | 
| 
       2138 
1974 
     | 
    
         
             
            .sp
         
     | 
| 
       2139 
     | 
    
         
            -
            このアカウントをフォローして最新の 
     | 
| 
      
 1975 
     | 
    
         
            +
            このアカウントをフォローして最新のGroonga関連情報をゲットしてください!
         
     | 
| 
       2140 
1976 
     | 
    
         
             
            .SS Facebook
         
     | 
| 
       2141 
1977 
     | 
    
         
             
            .sp
         
     | 
| 
       2142 
     | 
    
         
            -
            \fI\%Facebookの 
     | 
| 
      
 1978 
     | 
    
         
            +
            \fI\%FacebookのGroongaページ\fP ではGroonga関連情報をシェアしています。
         
     | 
| 
       2143 
1979 
     | 
    
         
             
            .sp
         
     | 
| 
       2144 
     | 
    
         
            -
            このページをいいね!して最新の 
     | 
| 
      
 1980 
     | 
    
         
            +
            このページをいいね!して最新のGroonga関連情報をゲットしてください!
         
     | 
| 
       2145 
1981 
     | 
    
         
             
            .SH チュートリアル
         
     | 
| 
       2146 
1982 
     | 
    
         
             
            .SS 基本的な操作
         
     | 
| 
       2147 
1983 
     | 
    
         
             
            .sp
         
     | 
| 
       2148 
     | 
    
         
            -
             
     | 
| 
      
 1984 
     | 
    
         
            +
            Groongaには、Cのライブラリとして使用する方法と、groonga実行ファイルを通して使用する方法があります。本チュートリアルでは、groonga実行ファイルを使用する方法について説明します。groonga実行ファイルを使って、データベースの作成・操作・サーバの起動・サーバへの接続などの操作が行えます。
         
     | 
| 
       2149 
1985 
     | 
    
         
             
            .SS データベースの作成
         
     | 
| 
       2150 
1986 
     | 
    
         
             
            .sp
         
     | 
| 
       2151 
     | 
    
         
            -
             
     | 
| 
      
 1987 
     | 
    
         
            +
            Groongaユーザへの第一歩はデータベースの作成です。まずは以下の書式をご覧ください。
         
     | 
| 
       2152 
1988 
     | 
    
         
             
            .sp
         
     | 
| 
       2153 
1989 
     | 
    
         
             
            書式:
         
     | 
| 
       2154 
1990 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -2199,7 +2035,7 @@ DB_PATHには操作対象のデータベースを指定します。指定した 
     | 
|
| 
       2199 
2035 
     | 
    
         
             
            .sp
         
     | 
| 
       2200 
2036 
     | 
    
         
             
            COMMAND が指定された場合、COMMAND を実行した後、実行結果を返します。指定されなかった場合には、対話モードに入ります。対話モードでは、標準入力からコマンドを読み込み、順次実行します。本チュートリアルでは、対話モードを主に使用します。
         
     | 
| 
       2201 
2037 
     | 
    
         
             
            .sp
         
     | 
| 
       2202 
     | 
    
         
            -
            それでは、 \fB/reference/commands/status\fP コマンドを実行して、 
     | 
| 
      
 2038 
     | 
    
         
            +
            それでは、 \fB/reference/commands/status\fP コマンドを実行して、Groongaの実行状態を確認してみましょう。
         
     | 
| 
       2203 
2039 
     | 
    
         
             
            .sp
         
     | 
| 
       2204 
2040 
     | 
    
         
             
            実行例:
         
     | 
| 
       2205 
2041 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -2220,10 +2056,10 @@ status 
     | 
|
| 
       2220 
2056 
     | 
    
         
             
            #     "max_command_version": 2,
         
     | 
| 
       2221 
2057 
     | 
    
         
             
            #     "n_queries": 0,
         
     | 
| 
       2222 
2058 
     | 
    
         
             
            #     "cache_hit_rate": 0.0,
         
     | 
| 
       2223 
     | 
    
         
            -
            #     "version": "3.1. 
     | 
| 
       2224 
     | 
    
         
            -
            #     "alloc_count":  
     | 
| 
      
 2059 
     | 
    
         
            +
            #     "version": "3.1.1",
         
     | 
| 
      
 2060 
     | 
    
         
            +
            #     "alloc_count": 160,
         
     | 
| 
       2225 
2061 
     | 
    
         
             
            #     "command_version": 1,
         
     | 
| 
       2226 
     | 
    
         
            -
            #     "starttime":  
     | 
| 
      
 2062 
     | 
    
         
            +
            #     "starttime": 1387938935,
         
     | 
| 
       2227 
2063 
     | 
    
         
             
            #     "default_command_version": 1
         
     | 
| 
       2228 
2064 
     | 
    
         
             
            #   }
         
     | 
| 
       2229 
2065 
     | 
    
         
             
            # ]
         
     | 
| 
         @@ -2262,7 +2098,7 @@ Form_2: COMMAND \-\-NAME_1 VALUE_1 \-\-NAME_2 VALUE_2 .. 
     | 
|
| 
       2262 
2098 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       2263 
2099 
     | 
    
         
             
            .TP
         
     | 
| 
       2264 
2100 
     | 
    
         
             
            .B \fB/reference/commands/status\fP
         
     | 
| 
       2265 
     | 
    
         
            -
             
     | 
| 
      
 2101 
     | 
    
         
            +
            Groongaプロセスの状態を表示します。
         
     | 
| 
       2266 
2102 
     | 
    
         
             
            .TP
         
     | 
| 
       2267 
2103 
     | 
    
         
             
            .B \fB/reference/commands/table_list\fP
         
     | 
| 
       2268 
2104 
     | 
    
         
             
            データベースに定義されているテーブルのリストを表示します。
         
     | 
| 
         @@ -2288,7 +2124,7 @@ groongaプロセスの状態を表示します。 
     | 
|
| 
       2288 
2124 
     | 
    
         
             
            .sp
         
     | 
| 
       2289 
2125 
     | 
    
         
             
            \fB/reference/commands/table_create\fP コマンドを使用してテーブルを作成します。
         
     | 
| 
       2290 
2126 
     | 
    
         
             
            .sp
         
     | 
| 
       2291 
     | 
    
         
            -
             
     | 
| 
      
 2127 
     | 
    
         
            +
            Groongaのテーブルには基本的に主キーが必要であり、テーブルを作成する際には型と格納方法も併せて指定する必要があります。
         
     | 
| 
       2292 
2128 
     | 
    
         
             
            .sp
         
     | 
| 
       2293 
2129 
     | 
    
         
             
            型には数値や文字列などがあります。ここではデータの種類を表しているものという程度に考えてください。詳細は \fB/reference/types\fP に記述されています。主キーの格納方法は、主キーを条件とする検索にかかる時間や、前方一致検索の可否などを左右します。こちらも後で説明します。
         
     | 
| 
       2294 
2130 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -2350,7 +2186,7 @@ select \-\-table Site 
     | 
|
| 
       2350 
2186 
     | 
    
         
             
            .sp
         
     | 
| 
       2351 
2187 
     | 
    
         
             
            \fB/reference/commands/select\fP にテーブル名のみを指定すると、指定したテーブルの中身を10件まで表示します。実行結果の[0]はテーブルに含まれるレコードの数を示しています。今回は何も登録されていないため0件です。レコード数の次に表示されている配列はテーブルの構成を示しています。["_id","Uint32"]はUInt32型の値を持つ_idという名前のカラム、["_key","ShortText"]はShortText型の値を持つ_keyという名前のカラムをそれぞれ表しています。
         
     | 
| 
       2352 
2188 
     | 
    
         
             
            .sp
         
     | 
| 
       2353 
     | 
    
         
            -
            上記の_idカラムと_keyカラムの2つのカラムは必須のカラムです。_idカラムは 
     | 
| 
      
 2189 
     | 
    
         
            +
            上記の_idカラムと_keyカラムの2つのカラムは必須のカラムです。_idカラムはGroongaが自動的に割り当てるIDを格納します。_keyカラムは主キーを格納します。これらのカラム名を変更することはできません。
         
     | 
| 
       2354 
2190 
     | 
    
         
             
            .SS カラムの作成
         
     | 
| 
       2355 
2191 
     | 
    
         
             
            .sp
         
     | 
| 
       2356 
2192 
     | 
    
         
             
            \fB/reference/commands/column_create\fP コマンドを用いて、カラムを作成することができます。
         
     | 
| 
         @@ -2619,7 +2455,7 @@ select \-\-table Site \-\-query \(aq_key:"http://example.org/"\(aq 
     | 
|
| 
       2619 
2455 
     | 
    
         
             
            .sp
         
     | 
| 
       2620 
2456 
     | 
    
         
             
            そろそろ全文検索の使い方について見ていきましょう。
         
     | 
| 
       2621 
2457 
     | 
    
         
             
            .sp
         
     | 
| 
       2622 
     | 
    
         
            -
             
     | 
| 
      
 2458 
     | 
    
         
            +
            Groongaでは転置インデックスを使って高速な全文検索を実現しています。そのため、まずは転置インデックスとして用いるテーブルを作成する必要があります。テーブルの内容は、文書に含まれる単語やN\-gramなどの索引語を主キーとして、各カラムに索引語の位置情報を格納するという構成になります。結果として、主キーのカラムは全文検索における語彙表の役割を果たします。
         
     | 
| 
       2623 
2459 
     | 
    
         
             
            .sp
         
     | 
| 
       2624 
2460 
     | 
    
         
             
            以下の例では、Termsという名前のテーブルを転置インデックスの語彙表として作成しています。索引語を格納するため、主キーの型はShortTextです。
         
     | 
| 
       2625 
2461 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -3271,11 +3107,11 @@ select \-\-table Site \-\-query title:@test \-\-output_columns _id,_score,title 
     | 
|
| 
       3271 
3107 
     | 
    
         
             
            現在のバージョンでは、全文検索インデックスが存在する場合にのみ、 \fImatch_columns\fP 引数を利用することができます。通常のカラムでの絞り込みには利用できません。
         
     | 
| 
       3272 
3108 
     | 
    
         
             
            .SS リモートアクセス
         
     | 
| 
       3273 
3109 
     | 
    
         
             
            .sp
         
     | 
| 
       3274 
     | 
    
         
            -
             
     | 
| 
       3275 
     | 
    
         
            -
            .SS  
     | 
| 
       3276 
     | 
    
         
            -
            .SS  
     | 
| 
      
 3110 
     | 
    
         
            +
            Groongaをサーバとして起動することにより、ネットワークを介してデータベースにアクセスできるようになります。groongaがサポートしているプロトコルは、Groongaの専用プロトコルであるGQTP、memcachedバイナリプロトコル、HTTPの三種類です。
         
     | 
| 
      
 3111 
     | 
    
         
            +
            .SS Groonga専用プロトコル(GQTP)
         
     | 
| 
      
 3112 
     | 
    
         
            +
            .SS GQTPサーバの起動
         
     | 
| 
       3277 
3113 
     | 
    
         
             
            .sp
         
     | 
| 
       3278 
     | 
    
         
            -
             
     | 
| 
      
 3114 
     | 
    
         
            +
            Groongaには、専用のプロトコルであるGQTPが存在します。GQTPを用いることにより、データベースへとリモートアクセスすることができます。以下の書式はGQTPサーバの起動方法を示しています。
         
     | 
| 
       3279 
3115 
     | 
    
         
             
            .sp
         
     | 
| 
       3280 
3116 
     | 
    
         
             
            書式:
         
     | 
| 
       3281 
3117 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -3289,7 +3125,7 @@ groonga [\-p PORT_NUMBER] \-s DB_PATH 
     | 
|
| 
       3289 
3125 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       3290 
3126 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       3291 
3127 
     | 
    
         
             
            .sp
         
     | 
| 
       3292 
     | 
    
         
            -
            \fI\-s\fP オプションは 
     | 
| 
      
 3128 
     | 
    
         
            +
            \fI\-s\fP オプションはGroongaをサーバとして起動するためのオプションです。DB_PATHには既存のデータベースのパスを指定します。 \fI\-p\fP オプションとその引数により、サーバのポート番号を指定することができます。ポート番号を省略した場合は10041が使用されます。
         
     | 
| 
       3293 
3129 
     | 
    
         
             
            .sp
         
     | 
| 
       3294 
3130 
     | 
    
         
             
            以下のコマンドにより、デフォルトのポート番号で待ち受けるサーバを起動することができます。サーバは指定されたデータベースへの操作を受け付けます。
         
     | 
| 
       3295 
3131 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -3306,9 +3142,9 @@ Ctrl\-c 
     | 
|
| 
       3306 
3142 
     | 
    
         
             
            .fi
         
     | 
| 
       3307 
3143 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       3308 
3144 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       3309 
     | 
    
         
            -
            .SS  
     | 
| 
      
 3145 
     | 
    
         
            +
            .SS GQTPデーモンの起動
         
     | 
| 
       3310 
3146 
     | 
    
         
             
            .sp
         
     | 
| 
       3311 
     | 
    
         
            -
             
     | 
| 
      
 3147 
     | 
    
         
            +
            GQTPサーバはデーモンとして起動することができます。オプションとして、 \fI\-s\fP の代わりに \fI\-d\fP を与えてください。
         
     | 
| 
       3312 
3148 
     | 
    
         
             
            .sp
         
     | 
| 
       3313 
3149 
     | 
    
         
             
            書式:
         
     | 
| 
       3314 
3150 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -3322,7 +3158,7 @@ groonga [\-p PORT_NUMBER] \-d DB_PATH 
     | 
|
| 
       3322 
3158 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       3323 
3159 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       3324 
3160 
     | 
    
         
             
            .sp
         
     | 
| 
       3325 
     | 
    
         
            -
             
     | 
| 
      
 3161 
     | 
    
         
            +
            Groongaをデーモンとして起動したときは、デーモンのプロセスIDが表示されます。以下の例では、12345というプロセスIDが表示されています。サーバとして起動した場合と同様に、指定されたデータベースへの操作を受け付けます。
         
     | 
| 
       3326 
3162 
     | 
    
         
             
            .sp
         
     | 
| 
       3327 
3163 
     | 
    
         
             
            実行例:
         
     | 
| 
       3328 
3164 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -3337,9 +3173,9 @@ groongaをデーモンとして起動したときは、デーモンのプロセ 
     | 
|
| 
       3337 
3173 
     | 
    
         
             
            .fi
         
     | 
| 
       3338 
3174 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       3339 
3175 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       3340 
     | 
    
         
            -
            .SS  
     | 
| 
      
 3176 
     | 
    
         
            +
            .SS GQTPサーバへの接続
         
     | 
| 
       3341 
3177 
     | 
    
         
             
            .sp
         
     | 
| 
       3342 
     | 
    
         
            -
             
     | 
| 
      
 3178 
     | 
    
         
            +
            GQTPサーバに接続するクライアントは、以下のように起動します。
         
     | 
| 
       3343 
3179 
     | 
    
         
             
            .sp
         
     | 
| 
       3344 
3180 
     | 
    
         
             
            書式:
         
     | 
| 
       3345 
3181 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -3374,10 +3210,10 @@ status 
     | 
|
| 
       3374 
3210 
     | 
    
         
             
            #     "max_command_version": 2,
         
     | 
| 
       3375 
3211 
     | 
    
         
             
            #     "n_queries": 0,
         
     | 
| 
       3376 
3212 
     | 
    
         
             
            #     "cache_hit_rate": 0.0,
         
     | 
| 
       3377 
     | 
    
         
            -
            #     "version": "3.1. 
     | 
| 
       3378 
     | 
    
         
            -
            #     "alloc_count":  
     | 
| 
      
 3213 
     | 
    
         
            +
            #     "version": "3.1.1",
         
     | 
| 
      
 3214 
     | 
    
         
            +
            #     "alloc_count": 139,
         
     | 
| 
       3379 
3215 
     | 
    
         
             
            #     "command_version": 1,
         
     | 
| 
       3380 
     | 
    
         
            -
            #     "starttime":  
     | 
| 
      
 3216 
     | 
    
         
            +
            #     "starttime": 1387938957,
         
     | 
| 
       3381 
3217 
     | 
    
         
             
            #     "default_command_version": 1
         
     | 
| 
       3382 
3218 
     | 
    
         
             
            #   }
         
     | 
| 
       3383 
3219 
     | 
    
         
             
            # ]
         
     | 
| 
         @@ -3389,9 +3225,9 @@ status 
     | 
|
| 
       3389 
3225 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       3390 
3226 
     | 
    
         
             
            .sp
         
     | 
| 
       3391 
3227 
     | 
    
         
             
            対話モードでは、標準入力からコマンドを読み込んで順次実行します。
         
     | 
| 
       3392 
     | 
    
         
            -
            .SS  
     | 
| 
      
 3228 
     | 
    
         
            +
            .SS GQTPサーバの終了
         
     | 
| 
       3393 
3229 
     | 
    
         
             
            .sp
         
     | 
| 
       3394 
     | 
    
         
            -
             
     | 
| 
      
 3230 
     | 
    
         
            +
            GQTPサーバを終了する安全は方法は、クライアントを起動して \fB/reference/commands/shutdown\fP を発行することです。
         
     | 
| 
       3395 
3231 
     | 
    
         
             
            .sp
         
     | 
| 
       3396 
3232 
     | 
    
         
             
            実行例:
         
     | 
| 
       3397 
3233 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -3408,7 +3244,7 @@ gqtpサーバを終了する安全は方法は、クライアントを起動し 
     | 
|
| 
       3408 
3244 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       3409 
3245 
     | 
    
         
             
            .SS memcachedバイナリプロトコル
         
     | 
| 
       3410 
3246 
     | 
    
         
             
            .sp
         
     | 
| 
       3411 
     | 
    
         
            -
             
     | 
| 
      
 3247 
     | 
    
         
            +
            Groongaはmemcachedバイナリプロトコルをサポートしています。以下の書式はmemcachedバイナリプロトコルのサーバをデーモンとして起動する方法を示しています。
         
     | 
| 
       3412 
3248 
     | 
    
         
             
            .sp
         
     | 
| 
       3413 
3249 
     | 
    
         
             
            書式:
         
     | 
| 
       3414 
3250 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -3426,7 +3262,7 @@ groonga [\-p PORT_NUMBER] \-d \-\-protocol memcached DB_PATH 
     | 
|
| 
       3426 
3262 
     | 
    
         
             
            .SS HTTP
         
     | 
| 
       3427 
3263 
     | 
    
         
             
            .SS HTTPサーバの起動
         
     | 
| 
       3428 
3264 
     | 
    
         
             
            .sp
         
     | 
| 
       3429 
     | 
    
         
            -
             
     | 
| 
      
 3265 
     | 
    
         
            +
            GroongaはHTTPをサポートしています。以下の書式はHTTPサーバをデーモンとして起動する方法を示しています。
         
     | 
| 
       3430 
3266 
     | 
    
         
             
            .sp
         
     | 
| 
       3431 
3267 
     | 
    
         
             
            書式:
         
     | 
| 
       3432 
3268 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -3465,7 +3301,7 @@ groonga [\-p PORT_NUMBER] \-d \-\-protocol http DB_PATH 
     | 
|
| 
       3465 
3301 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       3466 
3302 
     | 
    
         
             
            .SS HTTPサーバへのコマンド送信
         
     | 
| 
       3467 
3303 
     | 
    
         
             
            .sp
         
     | 
| 
       3468 
     | 
    
         
            -
             
     | 
| 
      
 3304 
     | 
    
         
            +
            GroongaがHTTPサーバとして起動されているときは、/d/COMMAND_NAME というURLにアクセスすることにより、コマンドを実行することができます。コマンドの引数は、HTTPのGETパラメータとして渡します。引数の書式は "?NAME_1=VALUE_1&NAME_2=VALUE_2&..." となります。
         
     | 
| 
       3469 
3305 
     | 
    
         
             
            .sp
         
     | 
| 
       3470 
3306 
     | 
    
         
             
            以下の例は、HTTPサーバに対するコマンドの送り方を示しています。
         
     | 
| 
       3471 
3307 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -3489,14 +3325,13 @@ status 
     | 
|
| 
       3489 
3325 
     | 
    
         
             
            #     "max_command_version": 2,
         
     | 
| 
       3490 
3326 
     | 
    
         
             
            #     "n_queries": 0,
         
     | 
| 
       3491 
3327 
     | 
    
         
             
            #     "cache_hit_rate": 0.0,
         
     | 
| 
       3492 
     | 
    
         
            -
            #     "version": "3.1. 
     | 
| 
       3493 
     | 
    
         
            -
            #     "alloc_count":  
     | 
| 
      
 3328 
     | 
    
         
            +
            #     "version": "3.1.1",
         
     | 
| 
      
 3329 
     | 
    
         
            +
            #     "alloc_count": 140,
         
     | 
| 
       3494 
3330 
     | 
    
         
             
            #     "command_version": 1,
         
     | 
| 
       3495 
     | 
    
         
            -
            #     "starttime":  
     | 
| 
      
 3331 
     | 
    
         
            +
            #     "starttime": 1387939627,
         
     | 
| 
       3496 
3332 
     | 
    
         
             
            #     "default_command_version": 1
         
     | 
| 
       3497 
3333 
     | 
    
         
             
            #   }
         
     | 
| 
       3498 
3334 
     | 
    
         
             
            # ]
         
     | 
| 
       3499 
     | 
    
         
            -
             
     | 
| 
       3500 
3335 
     | 
    
         
             
            http://HOST_NAME_OR_IP_ADDRESS[:PORT_NUMBER]/d/select?table=Site&query=title:@this
         
     | 
| 
       3501 
3336 
     | 
    
         
             
            Executed command:
         
     | 
| 
       3502 
3337 
     | 
    
         
             
            select \-\-table Site \-\-query title:@this
         
     | 
| 
         @@ -3568,16 +3403,16 @@ select \-\-table Site \-\-query title:@this 
     | 
|
| 
       3568 
3403 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       3569 
3404 
     | 
    
         
             
            .SS ブラウザベースの管理ツール
         
     | 
| 
       3570 
3405 
     | 
    
         
             
            .sp
         
     | 
| 
       3571 
     | 
    
         
            -
             
     | 
| 
      
 3406 
     | 
    
         
            +
            GroongaをHTTPサーバとして起動しているときは、ブラウザベースの管理ツールを使うことにより、データベースを簡単に管理することができます。管理ツールを使いたいときは、ブラウザを使って \fI\%http://HOST_NAME_OR_IP_ADDRESS[:PORT_NUMBER]/\fP へとアクセスしてください。管理ツールの使用には、JavaScriptの実行が有効になっている必要があります。
         
     | 
| 
       3572 
3407 
     | 
    
         
             
            .SS セキュリティ
         
     | 
| 
       3573 
3408 
     | 
    
         
             
            .sp
         
     | 
| 
       3574 
     | 
    
         
            -
             
     | 
| 
      
 3409 
     | 
    
         
            +
            Groongaのサーバには認証機能がありません。誰でもデータベースの内容を閲覧・修正することができます。iptablesなどを用いてアクセス元IPアドレスを制限することを推奨します。
         
     | 
| 
       3575 
3410 
     | 
    
         
             
            .SS いろいろなデータの保存
         
     | 
| 
       3576 
3411 
     | 
    
         
             
            .sp
         
     | 
| 
       3577 
     | 
    
         
            -
             
     | 
| 
      
 3412 
     | 
    
         
            +
            Groongaは全文検索エンジンを起源として独自のカラムストアを持つに至るわけですが、索引語や文書を保存するだけでなく、数値や文字列、日時や経緯度など、いろいろなデータを保存することができます。本チュートリアルでは、Groongaで保存できるデータの種類、およびに保存の方法を説明します。
         
     | 
| 
       3578 
3413 
     | 
    
         
             
            .SS データの種類
         
     | 
| 
       3579 
3414 
     | 
    
         
             
            .sp
         
     | 
| 
       3580 
     | 
    
         
            -
             
     | 
| 
      
 3415 
     | 
    
         
            +
            Groongaにおいて利用できる基本型は、真偽値、数値、文字列、日時、経緯度の5種類に大別できます。基本型において、数値は整数・浮動小数点数の違い、符号の有無と割り当てるビット数によって細分化できるほか、文字列は長さの上限によって細分化できます。また、経緯度には測地系による分類があります。詳しくは \fB/reference/types\fP を参照してください。
         
     | 
| 
       3581 
3416 
     | 
    
         
             
            .sp
         
     | 
| 
       3582 
3417 
     | 
    
         
             
            拡張型としては、別テーブルを参照するための情報であるテーブル参照を保存することができます。また、基本型もしくはテーブル参照を複数まとめて保存できるように、ベクターカラムをサポートしています。
         
     | 
| 
       3583 
3418 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -3796,7 +3631,7 @@ select \-\-table ToyBox \-\-output_columns _key,name 
     | 
|
| 
       3796 
3631 
     | 
    
         
             
            \fBノート:\fP
         
     | 
| 
       3797 
3632 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       3798 
3633 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       3799 
     | 
    
         
            -
             
     | 
| 
      
 3634 
     | 
    
         
            +
            Groonga内部では経過秒数を整数のペアで保持しています。最初の整数で秒を表現し、もう一方でマイクロ秒を表現します。それゆえGroongaでは小数で経過秒数を表示します。整数部が秒数で、小数部はマイクロ秒の値です。
         
     | 
| 
       3800 
3635 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       3801 
3636 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       3802 
3637 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -3928,7 +3763,7 @@ select \-\-table ToyBox \-\-output_columns _key,location 
     | 
|
| 
       3928 
3763 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       3929 
3764 
     | 
    
         
             
            .SS テーブル参照
         
     | 
| 
       3930 
3765 
     | 
    
         
             
            .sp
         
     | 
| 
       3931 
     | 
    
         
            -
             
     | 
| 
      
 3766 
     | 
    
         
            +
            Groongaでは、テーブル参照のカラム、すなわち関連付けたテーブルを参照するカラムを作成できます。より正確には、カラム作成時に参照先となるテーブルとの関連付けをおこない、参照先テーブルにおけるレコードIDを格納しておくことにより、参照先のレコードにアクセスできるようにします。
         
     | 
| 
       3932 
3767 
     | 
    
         
             
            .sp
         
     | 
| 
       3933 
3768 
     | 
    
         
             
            テーブル参照のカラムがあるときは、 \fBreference/commands/select\fP コマンドの \fIoutput_columns\fP 引数に "参照元カラム.参照先カラム" と指定することにより、参照先カラムの値を取り出すことができます。参照元カラムのみを指定したときは、 "参照元カラム名._key" と同様の扱いとなり、参照先レコードの主キーが取り出されます。テーブル参照が有効なレコードを指していないときは、参照先カラムのデフォルト値が取り出されるようになっています。
         
     | 
| 
       3934 
3769 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -4062,7 +3897,7 @@ select \-\-table Site \-\-output_columns _key,title,links._key,links.title \-\-q 
     | 
|
| 
       4062 
3897 
     | 
    
         
             
            新たなカラムにはSiteテーブルに対する参照の配列を格納するので、 \fItype\fP 引数にSiteを指定するとともに、 \fIflags\fP 引数にCOLUMN_VECTORフラグを指定しています。次に、 \fB/reference/commands/load\fP による更新では、 "\fI\%http://example.org/\fP" から "\fI\%http://example.net/\fP" へのリンクに加えて、 "\fI\%http://example.org/\fP" と "\fI\%http://example.com/\fP" へのリンクも登録しています。そして、最後にリンクの内容を確認しています。この例では、 \fIoutput_columns\fP 引数に links._key と links.title を指定しているので、参照先の主キーとタイトルをそれぞれ配列にしたものが表示されています。
         
     | 
| 
       4063 
3898 
     | 
    
         
             
            .SS さまざまな検索条件の指定
         
     | 
| 
       4064 
3899 
     | 
    
         
             
            .sp
         
     | 
| 
       4065 
     | 
    
         
            -
             
     | 
| 
      
 3900 
     | 
    
         
            +
            Groongaは、JavaScriptに似た文法での条件絞込や、計算した値を用いたソートを行うことができます。また、位置情報(緯度・経度)を用いた絞込・ソートを行うことができます。
         
     | 
| 
       4066 
3901 
     | 
    
         
             
            .SS JavaScriptに似た文法での絞込・全文検索
         
     | 
| 
       4067 
3902 
     | 
    
         
             
            .sp
         
     | 
| 
       4068 
3903 
     | 
    
         
             
            selectコマンドのfilterパラメータは、queryパラメータと同様に、レコードの検索条件を指定します。filterパラメータとqueryパラメータが異なる点は、filterパラメータには、JavaScriptの式に似た文法で条件を指定する点です。
         
     | 
| 
         @@ -4402,7 +4237,7 @@ _score 
     | 
|
| 
       4402 
4237 
     | 
    
         
             
            よって、上記のクエリは実行されるたびに検索結果の並び順がランダムに変わります。
         
     | 
| 
       4403 
4238 
     | 
    
         
             
            .SS 位置情報を用いた絞込・ソート
         
     | 
| 
       4404 
4239 
     | 
    
         
             
            .sp
         
     | 
| 
       4405 
     | 
    
         
            -
             
     | 
| 
      
 4240 
     | 
    
         
            +
            Groongaでは、位置情報(経緯度)を保存することができます。また、保存した経緯度を用いて絞込やソートができます。
         
     | 
| 
       4406 
4241 
     | 
    
         
             
            .sp
         
     | 
| 
       4407 
4242 
     | 
    
         
             
            位置情報を保存するためのカラムの型として、TokyoGeoPoint/WGS84GeoPointの2つの型があります。前者は日本測地系、後者は世界測地系(WGS84相当)の経緯度を保存します。
         
     | 
| 
       4408 
4243 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -4629,9 +4464,22 @@ select \-\-table Site \-\-output_columns _key,location \-\-filter \(aqgeo_in_cir 
     | 
|
| 
       4629 
4464 
     | 
    
         
             
            また、経緯度が指定の矩形領域内であるかどうかを判定する \fB/reference/functions/geo_in_rectangle\fP 関数も存在します。
         
     | 
| 
       4630 
4465 
     | 
    
         
             
            .SS ドリルダウン
         
     | 
| 
       4631 
4466 
     | 
    
         
             
            .sp
         
     | 
| 
       4632 
     | 
    
         
            -
             
     | 
| 
      
 4467 
     | 
    
         
            +
            You learned how to filter search results and sort ones in the previous sections.
         
     | 
| 
      
 4468 
     | 
    
         
            +
            Now that you can search as you likes, but how do you summarize the number of records which has specific value in the column?
         
     | 
| 
      
 4469 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 4470 
     | 
    
         
            +
            As you know, there is a naive solution to execute query by every the value of column, then you can get the number of records as a result. It is a simple way, but it is not reasonable to many records.
         
     | 
| 
      
 4471 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 4472 
     | 
    
         
            +
            If you are familiar with SQL, you will doubt with "Is there a similar SQL functionality to \fBGROUP BY\fP in Groonga?".
         
     | 
| 
      
 4473 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 4474 
     | 
    
         
            +
            Of course, Groonga provides such a functionality. It\(aqs called as \fBdrilldown\fP.
         
     | 
| 
      
 4475 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 4476 
     | 
    
         
            +
            \fBdrilldown\fP enables you to get the number of records which belongs to specific the value of column at once.
         
     | 
| 
      
 4477 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 4478 
     | 
    
         
            +
            To illustrate this feature, imagine the case that classification by domain and grouping by country that domain belongs to.
         
     | 
| 
       4633 
4479 
     | 
    
         
             
            .sp
         
     | 
| 
       4634 
     | 
    
         
            -
             
     | 
| 
      
 4480 
     | 
    
         
            +
            この機能を使った具体的な例を示します。
         
     | 
| 
      
 4481 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 4482 
     | 
    
         
            +
            この例では、 \fBSite\fP テーブルに2つのカラムを追加しています。 \fBdomain\fP カラムはTLD(トップレベルドメイン)に使います。 \fBcountry\fP カラムは国名に使います。これらのカラムの型はドメイン名を主キーとする \fBSiteDomain\fP テーブルと国名を主キーとする \fBSiteCountry\fP テーブルです。
         
     | 
| 
       4635 
4483 
     | 
    
         
             
            .sp
         
     | 
| 
       4636 
4484 
     | 
    
         
             
            実行例:
         
     | 
| 
       4637 
4485 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -4665,7 +4513,7 @@ load \-\-table Site 
     | 
|
| 
       4665 
4513 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       4666 
4514 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       4667 
4515 
     | 
    
         
             
            .sp
         
     | 
| 
       4668 
     | 
    
         
            -
             
     | 
| 
      
 4516 
     | 
    
         
            +
            \fBdomain\fP カラムでドリルダウンする例を示します。 3つの値が \fBdomain\fP カラムでは使われています。".org"、".net"そして".com"です。
         
     | 
| 
       4669 
4517 
     | 
    
         
             
            .sp
         
     | 
| 
       4670 
4518 
     | 
    
         
             
            実行例:
         
     | 
| 
       4671 
4519 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -4754,7 +4602,72 @@ select \-\-table Site \-\-limit 0 \-\-drilldown domain 
     | 
|
| 
       4754 
4602 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       4755 
4603 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       4756 
4604 
     | 
    
         
             
            .sp
         
     | 
| 
       4757 
     | 
    
         
            -
             
     | 
| 
      
 4605 
     | 
    
         
            +
            上記のクエリの集計結果です。
         
     | 
| 
      
 4606 
     | 
    
         
            +
            .SS \fBdomain\fP カラムによるドリルダウン
         
     | 
| 
      
 4607 
     | 
    
         
            +
            .TS
         
     | 
| 
      
 4608 
     | 
    
         
            +
            center;
         
     | 
| 
      
 4609 
     | 
    
         
            +
            |l|l|l|.
         
     | 
| 
      
 4610 
     | 
    
         
            +
            _
         
     | 
| 
      
 4611 
     | 
    
         
            +
            T{
         
     | 
| 
      
 4612 
     | 
    
         
            +
            グループ化するカラムの値
         
     | 
| 
      
 4613 
     | 
    
         
            +
            T}	T{
         
     | 
| 
      
 4614 
     | 
    
         
            +
            グループ化されたレコード数
         
     | 
| 
      
 4615 
     | 
    
         
            +
            T}	T{
         
     | 
| 
      
 4616 
     | 
    
         
            +
            グループ化されたレコードは次のとおり
         
     | 
| 
      
 4617 
     | 
    
         
            +
            T}
         
     | 
| 
      
 4618 
     | 
    
         
            +
            _
         
     | 
| 
      
 4619 
     | 
    
         
            +
            T{
         
     | 
| 
      
 4620 
     | 
    
         
            +
            .org
         
     | 
| 
      
 4621 
     | 
    
         
            +
            T}	T{
         
     | 
| 
      
 4622 
     | 
    
         
            +
            3
         
     | 
| 
      
 4623 
     | 
    
         
            +
            T}	T{
         
     | 
| 
      
 4624 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 4625 
     | 
    
         
            +
            .IP \(bu 2
         
     | 
| 
      
 4626 
     | 
    
         
            +
            \fI\%http://example.org/\fP
         
     | 
| 
      
 4627 
     | 
    
         
            +
            .IP \(bu 2
         
     | 
| 
      
 4628 
     | 
    
         
            +
            \fI\%http://example.org/aba\fP
         
     | 
| 
      
 4629 
     | 
    
         
            +
            .IP \(bu 2
         
     | 
| 
      
 4630 
     | 
    
         
            +
            \fI\%http://example.org/gat\fP
         
     | 
| 
      
 4631 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 4632 
     | 
    
         
            +
            T}
         
     | 
| 
      
 4633 
     | 
    
         
            +
            _
         
     | 
| 
      
 4634 
     | 
    
         
            +
            T{
         
     | 
| 
      
 4635 
     | 
    
         
            +
            .net
         
     | 
| 
      
 4636 
     | 
    
         
            +
            T}	T{
         
     | 
| 
      
 4637 
     | 
    
         
            +
            3
         
     | 
| 
      
 4638 
     | 
    
         
            +
            T}	T{
         
     | 
| 
      
 4639 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 4640 
     | 
    
         
            +
            .IP \(bu 2
         
     | 
| 
      
 4641 
     | 
    
         
            +
            \fI\%http://example.net/\fP
         
     | 
| 
      
 4642 
     | 
    
         
            +
            .IP \(bu 2
         
     | 
| 
      
 4643 
     | 
    
         
            +
            \fI\%http://example.net/afr\fP
         
     | 
| 
      
 4644 
     | 
    
         
            +
            .IP \(bu 2
         
     | 
| 
      
 4645 
     | 
    
         
            +
            \fI\%http://example.net/atv\fP
         
     | 
| 
      
 4646 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 4647 
     | 
    
         
            +
            T}
         
     | 
| 
      
 4648 
     | 
    
         
            +
            _
         
     | 
| 
      
 4649 
     | 
    
         
            +
            T{
         
     | 
| 
      
 4650 
     | 
    
         
            +
            .com
         
     | 
| 
      
 4651 
     | 
    
         
            +
            T}	T{
         
     | 
| 
      
 4652 
     | 
    
         
            +
            3
         
     | 
| 
      
 4653 
     | 
    
         
            +
            T}	T{
         
     | 
| 
      
 4654 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 4655 
     | 
    
         
            +
            .IP \(bu 2
         
     | 
| 
      
 4656 
     | 
    
         
            +
            \fI\%http://example.com/\fP
         
     | 
| 
      
 4657 
     | 
    
         
            +
            .IP \(bu 2
         
     | 
| 
      
 4658 
     | 
    
         
            +
            \fI\%http://example.com/rab\fP
         
     | 
| 
      
 4659 
     | 
    
         
            +
            .IP \(bu 2
         
     | 
| 
      
 4660 
     | 
    
         
            +
            \fI\%http://example.com/vdw\fP
         
     | 
| 
      
 4661 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 4662 
     | 
    
         
            +
            T}
         
     | 
| 
      
 4663 
     | 
    
         
            +
            _
         
     | 
| 
      
 4664 
     | 
    
         
            +
            .TE
         
     | 
| 
      
 4665 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 4666 
     | 
    
         
            +
            ドリルダウン結果は \fB_nsubrecs\fP カラムの値として返ります。この場合は、\fBSite\fP テーブルは ".org"、".net"、".com"ドメインでグループ化されています。 \fB_nsubrecs\fP はグループ化されたドメインが3つのレコードをそれぞれもつことを意味します。
         
     | 
| 
      
 4667 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 4668 
     | 
    
         
            +
            テーブル型を持つカラムに対してドリルダウンを行った場合、参照先のテーブルに存在するカラム値を取得することもできます。ドリルダウンを行ったテーブルには、 \fB_nsubrecs\fP という仮想的なカラムが追加されます。このカラムには、グループ化されたレコード数が入ります。
         
     | 
| 
      
 4669 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 4670 
     | 
    
         
            +
            では、参照されているテーブルの詳細を調べてみましょう。 \fBSite\fP テーブルは \fBSiteDomain\fP テーブルを \fBdomain\fP カラムの型として使っています。 \fB\-\-drilldown_output_columns\fP を参照されているカラムの詳細を知るのに使えます。
         
     | 
| 
       4758 
4671 
     | 
    
         
             
            .sp
         
     | 
| 
       4759 
4672 
     | 
    
         
             
            実行例:
         
     | 
| 
       4760 
4673 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -4850,7 +4763,7 @@ select \-\-table Site \-\-limit 0 \-\-drilldown domain \-\-drilldown_output_colu 
     | 
|
| 
       4850 
4763 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       4851 
4764 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       4852 
4765 
     | 
    
         
             
            .sp
         
     | 
| 
       4853 
     | 
    
         
            -
             
     | 
| 
      
 4766 
     | 
    
         
            +
            これでグループ化されたドメインの詳細がわかります。 \fBdomain\fP の値が".org"であるレコードに対して \fBcountry\fP カラムを使ってドリルダウンしてみましょう。
         
     | 
| 
       4854 
4767 
     | 
    
         
             
            .sp
         
     | 
| 
       4855 
4768 
     | 
    
         
             
            実行例:
         
     | 
| 
       4856 
4769 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -4858,7 +4771,7 @@ select \-\-table Site \-\-limit 0 \-\-drilldown domain \-\-drilldown_output_colu 
     | 
|
| 
       4858 
4771 
     | 
    
         
             
            .sp
         
     | 
| 
       4859 
4772 
     | 
    
         
             
            .nf
         
     | 
| 
       4860 
4773 
     | 
    
         
             
            .ft C
         
     | 
| 
       4861 
     | 
    
         
            -
            select \-\-table Site \-\-limit 0 \-\-drilldown  
     | 
| 
      
 4774 
     | 
    
         
            +
            select \-\-table Site \-\-limit 0 \-\-filter "domain._id == 1" \-\-drilldown country
         
     | 
| 
       4862 
4775 
     | 
    
         
             
            # [
         
     | 
| 
       4863 
4776 
     | 
    
         
             
            #   [
         
     | 
| 
       4864 
4777 
     | 
    
         
             
            #     0,
         
     | 
| 
         @@ -4868,7 +4781,7 @@ select \-\-table Site \-\-limit 0 \-\-drilldown domain,country 
     | 
|
| 
       4868 
4781 
     | 
    
         
             
            #   [
         
     | 
| 
       4869 
4782 
     | 
    
         
             
            #     [
         
     | 
| 
       4870 
4783 
     | 
    
         
             
            #       [
         
     | 
| 
       4871 
     | 
    
         
            -
            #          
     | 
| 
      
 4784 
     | 
    
         
            +
            #         3
         
     | 
| 
       4872 
4785 
     | 
    
         
             
            #       ],
         
     | 
| 
       4873 
4786 
     | 
    
         
             
            #       [
         
     | 
| 
       4874 
4787 
     | 
    
         
             
            #         [
         
     | 
| 
         @@ -4920,27 +4833,117 @@ select \-\-table Site \-\-limit 0 \-\-drilldown domain,country 
     | 
|
| 
       4920 
4833 
     | 
    
         
             
            #         ]
         
     | 
| 
       4921 
4834 
     | 
    
         
             
            #       ],
         
     | 
| 
       4922 
4835 
     | 
    
         
             
            #       [
         
     | 
| 
       4923 
     | 
    
         
            -
            #         " 
     | 
| 
       4924 
     | 
    
         
            -
            #          
     | 
| 
      
 4836 
     | 
    
         
            +
            #         "japan",
         
     | 
| 
      
 4837 
     | 
    
         
            +
            #         1
         
     | 
| 
       4925 
4838 
     | 
    
         
             
            #       ],
         
     | 
| 
       4926 
4839 
     | 
    
         
             
            #       [
         
     | 
| 
       4927 
     | 
    
         
            -
            #         " 
     | 
| 
       4928 
     | 
    
         
            -
            #          
     | 
| 
      
 4840 
     | 
    
         
            +
            #         "korea",
         
     | 
| 
      
 4841 
     | 
    
         
            +
            #         1
         
     | 
| 
       4929 
4842 
     | 
    
         
             
            #       ],
         
     | 
| 
       4930 
4843 
     | 
    
         
             
            #       [
         
     | 
| 
       4931 
     | 
    
         
            -
            #         " 
     | 
| 
       4932 
     | 
    
         
            -
            #          
     | 
| 
      
 4844 
     | 
    
         
            +
            #         "usa",
         
     | 
| 
      
 4845 
     | 
    
         
            +
            #         1
         
     | 
| 
       4933 
4846 
     | 
    
         
             
            #       ]
         
     | 
| 
       4934 
     | 
    
         
            -
            #     ] 
     | 
| 
       4935 
     | 
    
         
            -
            # 
     | 
| 
       4936 
     | 
    
         
            -
            # 
     | 
| 
       4937 
     | 
    
         
            -
             
     | 
| 
       4938 
     | 
    
         
            -
             
     | 
| 
       4939 
     | 
    
         
            -
             
     | 
| 
       4940 
     | 
    
         
            -
             
     | 
| 
       4941 
     | 
    
         
            -
             
     | 
| 
       4942 
     | 
    
         
            -
             
     | 
| 
       4943 
     | 
    
         
            -
             
     | 
| 
      
 4847 
     | 
    
         
            +
            #     ]
         
     | 
| 
      
 4848 
     | 
    
         
            +
            #   ]
         
     | 
| 
      
 4849 
     | 
    
         
            +
            # ]
         
     | 
| 
      
 4850 
     | 
    
         
            +
            .ft P
         
     | 
| 
      
 4851 
     | 
    
         
            +
            .fi
         
     | 
| 
      
 4852 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 4853 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 4854 
     | 
    
         
            +
            .SS 複数のカラムでドリルダウン
         
     | 
| 
      
 4855 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 4856 
     | 
    
         
            +
            ドリルダウンでは複数のカラムをサポートしています。 \fBdrilldown\fP パラメータの引数にカンマ区切りの値を指定します。すると一度にまとめてドリルダウン結果を取得できます。
         
     | 
| 
      
 4857 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 4858 
     | 
    
         
            +
            実行例:
         
     | 
| 
      
 4859 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 4860 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 4861 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 4862 
     | 
    
         
            +
            .nf
         
     | 
| 
      
 4863 
     | 
    
         
            +
            .ft C
         
     | 
| 
      
 4864 
     | 
    
         
            +
            select \-\-table Site \-\-limit 0 \-\-drilldown domain,country
         
     | 
| 
      
 4865 
     | 
    
         
            +
            # [
         
     | 
| 
      
 4866 
     | 
    
         
            +
            #   [
         
     | 
| 
      
 4867 
     | 
    
         
            +
            #     0,
         
     | 
| 
      
 4868 
     | 
    
         
            +
            #     1337566253.89858,
         
     | 
| 
      
 4869 
     | 
    
         
            +
            #     0.000355720520019531
         
     | 
| 
      
 4870 
     | 
    
         
            +
            #   ],
         
     | 
| 
      
 4871 
     | 
    
         
            +
            #   [
         
     | 
| 
      
 4872 
     | 
    
         
            +
            #     [
         
     | 
| 
      
 4873 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 4874 
     | 
    
         
            +
            #         9
         
     | 
| 
      
 4875 
     | 
    
         
            +
            #       ],
         
     | 
| 
      
 4876 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 4877 
     | 
    
         
            +
            #         [
         
     | 
| 
      
 4878 
     | 
    
         
            +
            #           "_id",
         
     | 
| 
      
 4879 
     | 
    
         
            +
            #           "UInt32"
         
     | 
| 
      
 4880 
     | 
    
         
            +
            #         ],
         
     | 
| 
      
 4881 
     | 
    
         
            +
            #         [
         
     | 
| 
      
 4882 
     | 
    
         
            +
            #           "_key",
         
     | 
| 
      
 4883 
     | 
    
         
            +
            #           "ShortText"
         
     | 
| 
      
 4884 
     | 
    
         
            +
            #         ],
         
     | 
| 
      
 4885 
     | 
    
         
            +
            #         [
         
     | 
| 
      
 4886 
     | 
    
         
            +
            #           "country",
         
     | 
| 
      
 4887 
     | 
    
         
            +
            #           "SiteCountry"
         
     | 
| 
      
 4888 
     | 
    
         
            +
            #         ],
         
     | 
| 
      
 4889 
     | 
    
         
            +
            #         [
         
     | 
| 
      
 4890 
     | 
    
         
            +
            #           "domain",
         
     | 
| 
      
 4891 
     | 
    
         
            +
            #           "SiteDomain"
         
     | 
| 
      
 4892 
     | 
    
         
            +
            #         ],
         
     | 
| 
      
 4893 
     | 
    
         
            +
            #         [
         
     | 
| 
      
 4894 
     | 
    
         
            +
            #           "link",
         
     | 
| 
      
 4895 
     | 
    
         
            +
            #           "Site"
         
     | 
| 
      
 4896 
     | 
    
         
            +
            #         ],
         
     | 
| 
      
 4897 
     | 
    
         
            +
            #         [
         
     | 
| 
      
 4898 
     | 
    
         
            +
            #           "links",
         
     | 
| 
      
 4899 
     | 
    
         
            +
            #           "Site"
         
     | 
| 
      
 4900 
     | 
    
         
            +
            #         ],
         
     | 
| 
      
 4901 
     | 
    
         
            +
            #         [
         
     | 
| 
      
 4902 
     | 
    
         
            +
            #           "location",
         
     | 
| 
      
 4903 
     | 
    
         
            +
            #           "WGS84GeoPoint"
         
     | 
| 
      
 4904 
     | 
    
         
            +
            #         ],
         
     | 
| 
      
 4905 
     | 
    
         
            +
            #         [
         
     | 
| 
      
 4906 
     | 
    
         
            +
            #           "title",
         
     | 
| 
      
 4907 
     | 
    
         
            +
            #           "ShortText"
         
     | 
| 
      
 4908 
     | 
    
         
            +
            #         ]
         
     | 
| 
      
 4909 
     | 
    
         
            +
            #       ]
         
     | 
| 
      
 4910 
     | 
    
         
            +
            #     ],
         
     | 
| 
      
 4911 
     | 
    
         
            +
            #     [
         
     | 
| 
      
 4912 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 4913 
     | 
    
         
            +
            #         3
         
     | 
| 
      
 4914 
     | 
    
         
            +
            #       ],
         
     | 
| 
      
 4915 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 4916 
     | 
    
         
            +
            #         [
         
     | 
| 
      
 4917 
     | 
    
         
            +
            #           "_key",
         
     | 
| 
      
 4918 
     | 
    
         
            +
            #           "ShortText"
         
     | 
| 
      
 4919 
     | 
    
         
            +
            #         ],
         
     | 
| 
      
 4920 
     | 
    
         
            +
            #         [
         
     | 
| 
      
 4921 
     | 
    
         
            +
            #           "_nsubrecs",
         
     | 
| 
      
 4922 
     | 
    
         
            +
            #           "Int32"
         
     | 
| 
      
 4923 
     | 
    
         
            +
            #         ]
         
     | 
| 
      
 4924 
     | 
    
         
            +
            #       ],
         
     | 
| 
      
 4925 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 4926 
     | 
    
         
            +
            #         ".org",
         
     | 
| 
      
 4927 
     | 
    
         
            +
            #         3
         
     | 
| 
      
 4928 
     | 
    
         
            +
            #       ],
         
     | 
| 
      
 4929 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 4930 
     | 
    
         
            +
            #         ".net",
         
     | 
| 
      
 4931 
     | 
    
         
            +
            #         3
         
     | 
| 
      
 4932 
     | 
    
         
            +
            #       ],
         
     | 
| 
      
 4933 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 4934 
     | 
    
         
            +
            #         ".com",
         
     | 
| 
      
 4935 
     | 
    
         
            +
            #         3
         
     | 
| 
      
 4936 
     | 
    
         
            +
            #       ]
         
     | 
| 
      
 4937 
     | 
    
         
            +
            #     ],
         
     | 
| 
      
 4938 
     | 
    
         
            +
            #     [
         
     | 
| 
      
 4939 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 4940 
     | 
    
         
            +
            #         5
         
     | 
| 
      
 4941 
     | 
    
         
            +
            #       ],
         
     | 
| 
      
 4942 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 4943 
     | 
    
         
            +
            #         [
         
     | 
| 
      
 4944 
     | 
    
         
            +
            #           "_key",
         
     | 
| 
      
 4945 
     | 
    
         
            +
            #           "ShortText"
         
     | 
| 
      
 4946 
     | 
    
         
            +
            #         ],
         
     | 
| 
       4944 
4947 
     | 
    
         
             
            #         [
         
     | 
| 
       4945 
4948 
     | 
    
         
             
            #           "_nsubrecs",
         
     | 
| 
       4946 
4949 
     | 
    
         
             
            #           "Int32"
         
     | 
| 
         @@ -4973,8 +4976,9 @@ select \-\-table Site \-\-limit 0 \-\-drilldown domain,country 
     | 
|
| 
       4973 
4976 
     | 
    
         
             
            .fi
         
     | 
| 
       4974 
4977 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       4975 
4978 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
      
 4979 
     | 
    
         
            +
            .SS ドリルダウン結果をソートする
         
     | 
| 
       4976 
4980 
     | 
    
         
             
            .sp
         
     | 
| 
       4977 
     | 
    
         
            -
             
     | 
| 
      
 4981 
     | 
    
         
            +
            ドリルダウン結果をソートしたい場合には \fB\-\-drilldown_sortby\fP を使います。指定した \fB_nsubrecs\fP カラムを昇順でソートします。
         
     | 
| 
       4978 
4982 
     | 
    
         
             
            .sp
         
     | 
| 
       4979 
4983 
     | 
    
         
             
            実行例:
         
     | 
| 
       4980 
4984 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -5070,8 +5074,9 @@ select \-\-table Site \-\-limit 0 \-\-drilldown country \-\-drilldown_sortby _ns 
     | 
|
| 
       5070 
5074 
     | 
    
         
             
            .fi
         
     | 
| 
       5071 
5075 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       5072 
5076 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
      
 5077 
     | 
    
         
            +
            .SS ドリルダウン結果の制限
         
     | 
| 
       5073 
5078 
     | 
    
         
             
            .sp
         
     | 
| 
       5074 
     | 
    
         
            -
             
     | 
| 
      
 5079 
     | 
    
         
            +
            ドリルダウン結果はデフォルト10件に制限されています。 \fBdrilldown_limits\fP と \fBdrilldown_offset\fP パラメータをドリルダウン結果をカスタマイズするのに使います。
         
     | 
| 
       5075 
5080 
     | 
    
         
             
            .sp
         
     | 
| 
       5076 
5081 
     | 
    
         
             
            実行例:
         
     | 
| 
       5077 
5082 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -5159,9 +5164,9 @@ select \-\-table Site \-\-limit 0 \-\-drilldown country \-\-drilldown_sortby _ns 
     | 
|
| 
       5159 
5164 
     | 
    
         
             
            文字列型のカラムに対するドリルダウンは、他の型でのドリルダウンに比べて低速です。文字列でのドリルダウンを行いたい場合には、このチュートリアルのように、文字列型を主キーとするテーブルを別途作成し、そのテーブルを型とするカラムを作成します。
         
     | 
| 
       5160 
5165 
     | 
    
         
             
            .SS タグ検索・参照関係の逆引き
         
     | 
| 
       5161 
5166 
     | 
    
         
             
            .sp
         
     | 
| 
       5162 
     | 
    
         
            -
            本チュートリアルで、 
     | 
| 
      
 5167 
     | 
    
         
            +
            本チュートリアルで、Groongaはカラム値として他のテーブルへの参照の配列を持つことができることを紹介いたしました。実は、テーブルへの参照の配列データを用いることによって、いわゆるタグ検索を行うことが可能となります。
         
     | 
| 
       5163 
5168 
     | 
    
         
             
            .sp
         
     | 
| 
       5164 
     | 
    
         
            -
            タグ検索は 
     | 
| 
      
 5169 
     | 
    
         
            +
            タグ検索はGroongaの転置インデックスというデータ構造を用いて高速に行われます。
         
     | 
| 
       5165 
5170 
     | 
    
         
             
            .SS タグ検索
         
     | 
| 
       5166 
5171 
     | 
    
         
             
            .sp
         
     | 
| 
       5167 
5172 
     | 
    
         
             
            動画共有サイトの検索エンジンを作ることを想定します。1つの動画には、その動画の特徴を表す、複数の語句が付与されています。「ある語句が付与されている動画の一覧を取得する」検索を行いたいとします。
         
     | 
| 
         @@ -5325,7 +5330,7 @@ select \-\-table Video \-\-query tags:@Animation \-\-output_columns _key,title 
     | 
|
| 
       5325 
5330 
     | 
    
         
             
            このように、「Variety」、「Sports」、「Animation」のようなタグで検索を行うことができました。
         
     | 
| 
       5326 
5331 
     | 
    
         
             
            .SS 参照関係の逆引き
         
     | 
| 
       5327 
5332 
     | 
    
         
             
            .sp
         
     | 
| 
       5328 
     | 
    
         
            -
             
     | 
| 
      
 5333 
     | 
    
         
            +
            Groongaはテーブル間の参照関係の逆引きを高速に行うためのインデックスを付与することができます。タグ検索は、その1例にすぎません。
         
     | 
| 
       5329 
5334 
     | 
    
         
             
            .sp
         
     | 
| 
       5330 
5335 
     | 
    
         
             
            例えば、ソーシャルネットワーキングサイトにおける友人関係を逆引き検索することができます。
         
     | 
| 
       5331 
5336 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -5653,9 +5658,9 @@ select \-\-table Site \-\-filter \(aqgeo_in_circle(location, "128515259x50318718 
     | 
|
| 
       5653 
5658 
     | 
    
         
             
            .SS match_columnsパラメータ
         
     | 
| 
       5654 
5659 
     | 
    
         
             
            .SS 複数のカラムを対象とした全文検索
         
     | 
| 
       5655 
5660 
     | 
    
         
             
            .sp
         
     | 
| 
       5656 
     | 
    
         
            -
             
     | 
| 
      
 5661 
     | 
    
         
            +
            Groongaでは、複数のカラムを対象とした全文検索を行うことができます。例えば、ブログのテーブルで、タイトルと内容とがそれぞれ別のカラムに入ったものがあるとしましょう。「タイトルもしくは内容に特定の単語を含む」検索を行いたいとします。
         
     | 
| 
       5657 
5662 
     | 
    
         
             
            .sp
         
     | 
| 
       5658 
     | 
    
         
            -
            この場合、2つのインデックス作成方式があります。1つは、それぞれのカラムに1つずつインデックスを付与する方式です。もう1つは、複数のカラムに対して1つのインデックスを付与する方式です。 
     | 
| 
      
 5663 
     | 
    
         
            +
            この場合、2つのインデックス作成方式があります。1つは、それぞれのカラムに1つずつインデックスを付与する方式です。もう1つは、複数のカラムに対して1つのインデックスを付与する方式です。Groongaでは、どちらの形式のインデックスが存在している場合でも、同一の記法で全文検索を行うことができます。
         
     | 
| 
       5659 
5664 
     | 
    
         
             
            .SS カラムごとにインデックスを付与する場合
         
     | 
| 
       5660 
5665 
     | 
    
         
             
            .sp
         
     | 
| 
       5661 
5666 
     | 
    
         
             
            Blog1テーブルを作り、タイトル文字列のtitleカラム、本文のmessageカラムを追加しています。
         
     | 
| 
         @@ -6372,7 +6377,7 @@ select Articles2 \-\-match_columns comment.comment.content \-\-query mroonga \-\ 
     | 
|
| 
       6372 
6377 
     | 
    
         
             
            執筆中です。
         
     | 
| 
       6373 
6378 
     | 
    
         
             
            .SS パトリシア木による前方一致検索
         
     | 
| 
       6374 
6379 
     | 
    
         
             
            .sp
         
     | 
| 
       6375 
     | 
    
         
            -
             
     | 
| 
      
 6380 
     | 
    
         
            +
            Groongaのテーブルは、テーブル作成時にパトリシア木オプションを指定すると、前方一致検索を行うことができます。また、追加のオプションを指定することにより、主キーの後方一致検索をも行うことができます。
         
     | 
| 
       6376 
6381 
     | 
    
         
             
            .SS 主キーによる前方一致検索
         
     | 
| 
       6377 
6382 
     | 
    
         
             
            .sp
         
     | 
| 
       6378 
6383 
     | 
    
         
             
            table_createコマンドのflagsオプションにTABLE_PAT_KEYを指定することで、主キーによる前方一致検索ができるようになります。
         
     | 
| 
         @@ -6550,12 +6555,12 @@ select \-\-table PatSuffix \-\-filter \(aq_key @$ "ゆき" && original == true\( 
     | 
|
| 
       6550 
6555 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       6551 
6556 
     | 
    
         
             
            .SS 全文検索の語彙表に対する追加情報
         
     | 
| 
       6552 
6557 
     | 
    
         
             
            .sp
         
     | 
| 
       6553 
     | 
    
         
            -
             
     | 
| 
      
 6558 
     | 
    
         
            +
            Groongaでは、全文検索に用いるための語意表がテーブルとして扱えます。よって、語彙ごとに複数の情報を保持することができます。例えば、語彙の出現数や検索ストップワードのフラグ、単語の重要度などを保持することができます。
         
     | 
| 
       6554 
6559 
     | 
    
         
             
            .sp
         
     | 
| 
       6555 
6560 
     | 
    
         
             
            この項目については、現在執筆中です。
         
     | 
| 
       6556 
6561 
     | 
    
         
             
            .SS マイクロブログ検索システムの作成
         
     | 
| 
       6557 
6562 
     | 
    
         
             
            .sp
         
     | 
| 
       6558 
     | 
    
         
            -
            これまで学んだ 
     | 
| 
      
 6563 
     | 
    
         
            +
            これまで学んだGroongaの機能を用いて、マイクロブログの検索システムを作成してみましょう。マイクロブログとは、Twitterのような短いメッセージを投稿するブログです。
         
     | 
| 
       6559 
6564 
     | 
    
         
             
            .SS テーブルの作成
         
     | 
| 
       6560 
6565 
     | 
    
         
             
            .sp
         
     | 
| 
       6561 
6566 
     | 
    
         
             
            まずは、テーブルを作成します。
         
     | 
| 
         @@ -7540,7 +7545,7 @@ select Comments \-\-filter \(aqlast_modified<=1268802000\(aq \-\-output_columns 
     | 
|
| 
       7540 
7545 
     | 
    
         
             
            2010/03/17 14:00:00以前に書かれたコメント5件がヒットしました。また、ドリルダウンの結果も返ってきており、「hsiomaneki」が2件、「グニャラくん」が3件ヒットしていることがわかります。
         
     | 
| 
       7541 
7546 
     | 
    
         
             
            .SS クエリ拡張
         
     | 
| 
       7542 
7547 
     | 
    
         
             
            .sp
         
     | 
| 
       7543 
     | 
    
         
            -
             
     | 
| 
      
 7548 
     | 
    
         
            +
            Groongaでは、 \fB/reference/commands/select\fP コマンドにquery_expanderパラメータを指定することによって、ユーザが指定した検索文字列を適宜拡張することが可能です。
         
     | 
| 
       7544 
7549 
     | 
    
         
             
            .sp
         
     | 
| 
       7545 
7550 
     | 
    
         
             
            たとえば、ユーザが\(aqシークヮーサー\(aqという文字列で検索した場合に、\(aqシークヮーサー OR シークァーサー\(aqで検索した場合と同一の結果を返すことによって、本来ユーザが必要とする結果をよりもれなく検索できるようになります。
         
     | 
| 
       7546 
7551 
     | 
    
         
             
            .SS 準備
         
     | 
| 
         @@ -8802,10 +8807,10 @@ load \-\-table event_query \-\-each \(aqsuggest_preparer(_id, type, item, sequen 
     | 
|
| 
       8802 
8807 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       8803 
8808 
     | 
    
         
             
            .SH 位置情報検索
         
     | 
| 
       8804 
8809 
     | 
    
         
             
            .sp
         
     | 
| 
       8805 
     | 
    
         
            -
             
     | 
| 
      
 8810 
     | 
    
         
            +
            Groongaは位置情報検索をサポートしています。検索にはインデックスを使うので全文検索と同様に位置情報も高速に検索できます。
         
     | 
| 
       8806 
8811 
     | 
    
         
             
            .SS 対応している機能
         
     | 
| 
       8807 
8812 
     | 
    
         
             
            .sp
         
     | 
| 
       8808 
     | 
    
         
            -
             
     | 
| 
      
 8813 
     | 
    
         
            +
            Groongaは位置情報データのうち座標データのみサポートしています。線や面などはサポートしています。よってGroongaができることは以下の通りです。
         
     | 
| 
       8809 
8814 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       8810 
8815 
     | 
    
         
             
            .IP 1. 3
         
     | 
| 
       8811 
8816 
     | 
    
         
             
            カラムに座標データを保存できる。
         
     | 
| 
         @@ -8819,7 +8824,7 @@ groongaは位置情報データのうち座標データのみサポートして 
     | 
|
| 
       8819 
8824 
     | 
    
         
             
            指定した座標からの距離が近い順にレコードをソートできる。
         
     | 
| 
       8820 
8825 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       8821 
8826 
     | 
    
         
             
            .sp
         
     | 
| 
       8822 
     | 
    
         
            -
            以下は 
     | 
| 
      
 8827 
     | 
    
         
            +
            以下はGroongaの位置情報検索を利用例です。
         
     | 
| 
       8823 
8828 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       8824 
8829 
     | 
    
         
             
            .IP \(bu 2
         
     | 
| 
       8825 
8830 
     | 
    
         
             
            駅の近くにあるマクドナルドをリストする。
         
     | 
| 
         @@ -8827,15 +8832,15 @@ groongaは位置情報データのうち座標データのみサポートして 
     | 
|
| 
       8827 
8832 
     | 
    
         
             
            現在地から近い順にケンタッキーをソートし、現在地からの距離付きでリストする。
         
     | 
| 
       8828 
8833 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       8829 
8834 
     | 
    
         
             
            .sp
         
     | 
| 
       8830 
     | 
    
         
            -
            以下は 
     | 
| 
      
 8835 
     | 
    
         
            +
            以下はGroongaではできないことです。
         
     | 
| 
       8831 
8836 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       8832 
8837 
     | 
    
         
             
            .IP \(bu 2
         
     | 
| 
       8833 
     | 
    
         
            -
            市内にあるマクドナルドを検索する。( 
     | 
| 
      
 8838 
     | 
    
         
            +
            市内にあるマクドナルドを検索する。(Groongaは四角形と円以外の形状の位置情報検索をサポートしていません。)
         
     | 
| 
       8834 
8839 
     | 
    
         
             
            .IP \(bu 2
         
     | 
| 
       8835 
8840 
     | 
    
         
             
            湖を表すレコードに位置情報として座標ではなく範囲を格納する。(カラムには座標データ以外を格納できません。)
         
     | 
| 
       8836 
8841 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       8837 
8842 
     | 
    
         
             
            .sp
         
     | 
| 
       8838 
     | 
    
         
            -
            以下の図は 
     | 
| 
      
 8843 
     | 
    
         
            +
            以下の図はGroongaの位置情報検索機能を示しています。
         
     | 
| 
       8839 
8844 
     | 
    
         
             
            .sp
         
     | 
| 
       8840 
8845 
     | 
    
         
             
            以下の図はレコードのみがある図です。黒い点がレコードを表しています。以降の図ではレコードがどのように扱われるかを示します。
         
     | 
| 
       8841 
8846 
     | 
    
         
             
            [画像: only records]
         
     | 
| 
         @@ -10487,14 +10492,14 @@ http { 
     | 
|
| 
       10487 
10492 
     | 
    
         
             
                0.000355720520019531
         
     | 
| 
       10488 
10493 
     | 
    
         
             
              ],
         
     | 
| 
       10489 
10494 
     | 
    
         
             
              {
         
     | 
| 
       10490 
     | 
    
         
            -
                "uptime":  
     | 
| 
      
 10495 
     | 
    
         
            +
                "uptime": 0,
         
     | 
| 
       10491 
10496 
     | 
    
         
             
                "max_command_version": 2,
         
     | 
| 
       10492 
10497 
     | 
    
         
             
                "n_queries": 0,
         
     | 
| 
       10493 
10498 
     | 
    
         
             
                "cache_hit_rate": 0.0,
         
     | 
| 
       10494 
     | 
    
         
            -
                "version": "3.1. 
     | 
| 
       10495 
     | 
    
         
            -
                "alloc_count":  
     | 
| 
      
 10499 
     | 
    
         
            +
                "version": "3.1.1",
         
     | 
| 
      
 10500 
     | 
    
         
            +
                "alloc_count": 160,
         
     | 
| 
       10496 
10501 
     | 
    
         
             
                "command_version": 1,
         
     | 
| 
       10497 
     | 
    
         
            -
                "starttime":  
     | 
| 
      
 10502 
     | 
    
         
            +
                "starttime": 1387938911,
         
     | 
| 
       10498 
10503 
     | 
    
         
             
                "default_command_version": 1
         
     | 
| 
       10499 
10504 
     | 
    
         
             
              }
         
     | 
| 
       10500 
10505 
     | 
    
         
             
            ]
         
     | 
| 
         @@ -11451,21 +11456,21 @@ MessagePack形式の出力にする場合は \fBmsgpack\fP 拡張子を指定し 
     | 
|
| 
       11451 
11456 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       11452 
11457 
     | 
    
         
             
            .SS コマンド
         
     | 
| 
       11453 
11458 
     | 
    
         
             
            .sp
         
     | 
| 
       11454 
     | 
    
         
            -
            コマンドはクエリーAPIでもっとも重要な処理単位です。コマンドで 
     | 
| 
      
 11459 
     | 
    
         
            +
            コマンドはクエリーAPIでもっとも重要な処理単位です。コマンドでGroongaに処理をリクエストします。
         
     | 
| 
       11455 
11460 
     | 
    
         
             
            .sp
         
     | 
| 
       11456 
11461 
     | 
    
         
             
            このセクションではコマンドについての説明と組み込みのコマンドについて説明します。
         
     | 
| 
       11457 
11462 
     | 
    
         
             
            .SS コマンドバージョン
         
     | 
| 
       11458 
11463 
     | 
    
         
             
            .SS 概要
         
     | 
| 
       11459 
11464 
     | 
    
         
             
            .sp
         
     | 
| 
       11460 
     | 
    
         
            -
             
     | 
| 
      
 11465 
     | 
    
         
            +
            Groonga1.1からコマンドバージョンという概念が導入されます。コマンドバージョンは、selectやloadなどのGroongaのコマンドの仕様の互換性を表します。Groongaパッケージのバージョンが新しくなったとしても、同一のコマンドバージョンが使用可能であるなら、すべてのコマンドについて互換性が保証されます。コマンドバージョンが異なれば、同じ名前のコマンドであっても、動作に互換性がない可能性があります。
         
     | 
| 
       11461 
11466 
     | 
    
         
             
            .sp
         
     | 
| 
       11462 
     | 
    
         
            -
            あるバージョンの 
     | 
| 
      
 11467 
     | 
    
         
            +
            あるバージョンのGroongaは、二つのコマンドバージョンを同時にサポートするようになります。
         
     | 
| 
       11463 
11468 
     | 
    
         
             
            使用するコマンドバージョンは、groongaを起動する際のコマンドラインオプションないしコンフィグファイルにdefault\-commnad\-versionパラメータを与えることによって指定できます。また、個々のコマンドを実行する際に、command_versionパラメータを与えることによっても指定することができます。
         
     | 
| 
       11464 
11469 
     | 
    
         
             
            .sp
         
     | 
| 
       11465 
     | 
    
         
            -
            コマンドバージョンは1からはじまり、更新されるたびに1ずつ大きくなります。現状の 
     | 
| 
      
 11470 
     | 
    
         
            +
            コマンドバージョンは1からはじまり、更新されるたびに1ずつ大きくなります。現状のGroongaのコマンドの仕様はcommand\-version 1という扱いになります。次回提供するGroongaは、command\-version 1とcommand\-version 2の二つをサポートすることになります。
         
     | 
| 
       11466 
11471 
     | 
    
         
             
            .SS バージョンの位置づけ
         
     | 
| 
       11467 
11472 
     | 
    
         
             
            .sp
         
     | 
| 
       11468 
     | 
    
         
            -
            あるバージョンの 
     | 
| 
      
 11473 
     | 
    
         
            +
            あるバージョンのGroongaにおいてサポートされるコマンドバージョンは、develop, stable,deprecatedのいずれかの位置づけとなります。
         
     | 
| 
       11469 
11474 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       11470 
11475 
     | 
    
         
             
            .TP
         
     | 
| 
       11471 
11476 
     | 
    
         
             
            .B develop
         
     | 
| 
         @@ -11478,9 +11483,9 @@ groonga1.1からコマンドバージョンという概念が導入されます 
     | 
|
| 
       11478 
11483 
     | 
    
         
             
            使用可能であり仕様も安定していますが、廃止予定であり使用が推奨されません。
         
     | 
| 
       11479 
11484 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       11480 
11485 
     | 
    
         
             
            .sp
         
     | 
| 
       11481 
     | 
    
         
            -
            あるバージョンの 
     | 
| 
      
 11486 
     | 
    
         
            +
            あるバージョンのGroongaがサポートする二つのコマンドバージョンのうち、いずれか一つが必ずstableの位置づけとなります。残りの一つは、developないしdeprecatedとなります。
         
     | 
| 
       11482 
11487 
     | 
    
         
             
            .sp
         
     | 
| 
       11483 
     | 
    
         
            -
            たとえば下記のように 
     | 
| 
      
 11488 
     | 
    
         
            +
            たとえば下記のようにGroongaのサポートするコマンドバージョンは推移します。:
         
     | 
| 
       11484 
11489 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       11485 
11490 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       11486 
11491 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -11733,7 +11738,7 @@ JSON形式、MessagePack形式のときは以下のような構造になりま 
     | 
|
| 
       11733 
11738 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       11734 
11739 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       11735 
11740 
     | 
    
         
             
            .sp
         
     | 
| 
       11736 
     | 
    
         
            -
            \fBLOCATION_IN_GROONGA\fP は 
     | 
| 
      
 11741 
     | 
    
         
            +
            \fBLOCATION_IN_GROONGA\fP はGroonga内でエラーが発生したソースコードの場所です。この情報はGroonga開発者には役に立ちますが、ユーザーの役には立ちません。 \fBLOCATION_IN_GROONGA\fP は配列です。 \fBLOCATION_IN_GROONGA\fP には3個の要素があります:
         
     | 
| 
       11737 
11742 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       11738 
11743 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       11739 
11744 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -11751,7 +11756,7 @@ JSON形式、MessagePack形式のときは以下のような構造になりま 
     | 
|
| 
       11751 
11756 
     | 
    
         
             
            .sp
         
     | 
| 
       11752 
11757 
     | 
    
         
             
            \fBFUNCTION_NAME\fP はエラーが発生した関数の名前です。
         
     | 
| 
       11753 
11758 
     | 
    
         
             
            .sp
         
     | 
| 
       11754 
     | 
    
         
            -
            \fBSOURCE_FILE_NAME\fP はエラーが発生した箇所を含んだ 
     | 
| 
      
 11759 
     | 
    
         
            +
            \fBSOURCE_FILE_NAME\fP はエラーが発生した箇所を含んだGroongaのソースコードのファイル名です。
         
     | 
| 
       11755 
11760 
     | 
    
         
             
            .sp
         
     | 
| 
       11756 
11761 
     | 
    
         
             
            \fBLINE_NUMBER\fP はエラーが発生した箇所の \fBSOURCE_FILE_NAME\fP での行番号です。
         
     | 
| 
       11757 
11762 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -12069,7 +12074,7 @@ check obj 
     | 
|
| 
       12069 
12074 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       12070 
12075 
     | 
    
         
             
            .SS 説明
         
     | 
| 
       12071 
12076 
     | 
    
         
             
            .sp
         
     | 
| 
       12072 
     | 
    
         
            -
             
     | 
| 
      
 12077 
     | 
    
         
            +
            Groonga組込コマンドの一つであるcheckについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
         
     | 
| 
       12073 
12078 
     | 
    
         
             
            .sp
         
     | 
| 
       12074 
12079 
     | 
    
         
             
            checkコマンドは、groongaプロセス内の指定したオブジェクトの状態を表示します。主にデータベースが壊れた場合など異常時の問題解決のために使用することを想定しています。デバッグ用のため、返値のフォーマットが安定しているということは保証されません。(フォーマットが変更される可能性が高い)
         
     | 
| 
       12075 
12080 
     | 
    
         
             
            .SS 引数
         
     | 
| 
         @@ -12308,7 +12313,7 @@ clearlock objname 
     | 
|
| 
       12308 
12313 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       12309 
12314 
     | 
    
         
             
            .SS 説明
         
     | 
| 
       12310 
12315 
     | 
    
         
             
            .sp
         
     | 
| 
       12311 
     | 
    
         
            -
             
     | 
| 
      
 12316 
     | 
    
         
            +
            Groonga組込コマンドの一つであるclearlockについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
         
     | 
| 
       12312 
12317 
     | 
    
         
             
            .sp
         
     | 
| 
       12313 
12318 
     | 
    
         
             
            clearlockは、対象となるオブジェクト(データベース,テーブル,インデックス等)を指定し、オブジェクトにかけられたロックを再帰的に解除します。
         
     | 
| 
       12314 
12319 
     | 
    
         
             
            .SS 引数
         
     | 
| 
         @@ -12373,7 +12378,7 @@ clearlock Entry.body 
     | 
|
| 
       12373 
12378 
     | 
    
         
             
            .sp
         
     | 
| 
       12374 
12379 
     | 
    
         
             
            column_create \- カラムの追加
         
     | 
| 
       12375 
12380 
     | 
    
         
             
            .sp
         
     | 
| 
       12376 
     | 
    
         
            -
             
     | 
| 
      
 12381 
     | 
    
         
            +
            Groonga組込コマンドの一つであるcolumn_createについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
         
     | 
| 
       12377 
12382 
     | 
    
         
             
            .sp
         
     | 
| 
       12378 
12383 
     | 
    
         
             
            column_createは、使用しているデータベースのテーブルに対してカラムを追加します。
         
     | 
| 
       12379 
12384 
     | 
    
         
             
            .SS 構文
         
     | 
| 
         @@ -12452,10 +12457,10 @@ column_create Term entry_body COLUMN_INDEX|WITH_POSITION Entry body 
     | 
|
| 
       12452 
12457 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       12453 
12458 
     | 
    
         
             
            .TP
         
     | 
| 
       12454 
12459 
     | 
    
         
             
            .B 16, \fBCOMPRESS_ZLIB\fP
         
     | 
| 
       12455 
     | 
    
         
            -
            予約済み。zlibを使ってカラムの値を圧縮します。このフラグは 
     | 
| 
      
 12460 
     | 
    
         
            +
            予約済み。zlibを使ってカラムの値を圧縮します。このフラグはGroongaを \fB\-\-with\-zlib\fP つきでビルドしても使えません。
         
     | 
| 
       12456 
12461 
     | 
    
         
             
            .TP
         
     | 
| 
       12457 
12462 
     | 
    
         
             
            .B 32, \fBCOMPRESS_LZO\fP
         
     | 
| 
       12458 
     | 
    
         
            -
            予約済み。lzoを使ってカラムの値を圧縮します。このフラグは 
     | 
| 
      
 12463 
     | 
    
         
            +
            予約済み。lzoを使ってカラムの値を圧縮します。このフラグはGroongaを \fB\-\-with\-lzo\fP つきでビルドしても使えません。
         
     | 
| 
       12459 
12464 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       12460 
12465 
     | 
    
         
             
            .sp
         
     | 
| 
       12461 
12466 
     | 
    
         
             
            インデックス型のカラムについては、flagsの値に以下の値を加えることによって、追加の属
         
     | 
| 
         @@ -12477,7 +12482,7 @@ column_create Term entry_body COLUMN_INDEX|WITH_POSITION Entry body 
     | 
|
| 
       12477 
12482 
     | 
    
         
             
            \fBtype\fP
         
     | 
| 
       12478 
12483 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       12479 
12484 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       12480 
     | 
    
         
            -
            値の型を指定します。 
     | 
| 
      
 12485 
     | 
    
         
            +
            値の型を指定します。Groongaの組込型か、同一データベースに定義済みのユーザ定義型、定義済みのテーブルを指定することができます。
         
     | 
| 
       12481 
12486 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       12482 
12487 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       12483 
12488 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -12529,7 +12534,7 @@ column_list table 
     | 
|
| 
       12529 
12534 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       12530 
12535 
     | 
    
         
             
            .SS 説明
         
     | 
| 
       12531 
12536 
     | 
    
         
             
            .sp
         
     | 
| 
       12532 
     | 
    
         
            -
             
     | 
| 
      
 12537 
     | 
    
         
            +
            Groonga組込コマンドの一つであるcolumn_listについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
         
     | 
| 
       12533 
12538 
     | 
    
         
             
            .sp
         
     | 
| 
       12534 
12539 
     | 
    
         
             
            column_listはテーブルに定義されているカラムをリスト表示します。
         
     | 
| 
       12535 
12540 
     | 
    
         
             
            .SS 引数
         
     | 
| 
         @@ -12678,7 +12683,7 @@ column_remove table name 
     | 
|
| 
       12678 
12683 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       12679 
12684 
     | 
    
         
             
            .SS 説明
         
     | 
| 
       12680 
12685 
     | 
    
         
             
            .sp
         
     | 
| 
       12681 
     | 
    
         
            -
             
     | 
| 
      
 12686 
     | 
    
         
            +
            Groonga組込コマンドの一つであるcolumn_removeについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
         
     | 
| 
       12682 
12687 
     | 
    
         
             
            .sp
         
     | 
| 
       12683 
12688 
     | 
    
         
             
            column_removeはテーブルに定義されているカラムを削除します。
         
     | 
| 
       12684 
12689 
     | 
    
         
             
            また、付随するインデックスも削除されます。[1]
         
     | 
| 
         @@ -12936,7 +12941,7 @@ define_selector name table [match_columns [query [filter [scorer [sortby 
     | 
|
| 
       12936 
12941 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       12937 
12942 
     | 
    
         
             
            .SS 説明
         
     | 
| 
       12938 
12943 
     | 
    
         
             
            .sp
         
     | 
| 
       12939 
     | 
    
         
            -
             
     | 
| 
      
 12944 
     | 
    
         
            +
            Groonga組込コマンドの一つであるdefine_selectorについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
         
     | 
| 
       12940 
12945 
     | 
    
         
             
            .sp
         
     | 
| 
       12941 
12946 
     | 
    
         
             
            define_selectorは、検索条件をカスタマイズした新たな検索コマンドを定義します。
         
     | 
| 
       12942 
12947 
     | 
    
         
             
            .SS 引数
         
     | 
| 
         @@ -13098,7 +13103,7 @@ defrag objname threshold 
     | 
|
| 
       13098 
13103 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       13099 
13104 
     | 
    
         
             
            .SS 説明
         
     | 
| 
       13100 
13105 
     | 
    
         
             
            .sp
         
     | 
| 
       13101 
     | 
    
         
            -
             
     | 
| 
      
 13106 
     | 
    
         
            +
            Groonga組込コマンドの一つであるdefragについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
         
     | 
| 
       13102 
13107 
     | 
    
         
             
            .sp
         
     | 
| 
       13103 
13108 
     | 
    
         
             
            defragは、対象となるオブジェクト(データベースか可変長サイズカラム)を指定し、オブジェクトのフラグメンテーションを解消します。
         
     | 
| 
       13104 
13109 
     | 
    
         
             
            .SS 引数
         
     | 
| 
         @@ -13428,11 +13433,11 @@ dump [tables] 
     | 
|
| 
       13428 
13433 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       13429 
13434 
     | 
    
         
             
            .SS 説明
         
     | 
| 
       13430 
13435 
     | 
    
         
             
            .sp
         
     | 
| 
       13431 
     | 
    
         
            -
             
     | 
| 
      
 13436 
     | 
    
         
            +
            Groonga組込コマンドの一つであるdumpについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
         
     | 
| 
       13432 
13437 
     | 
    
         
             
            .sp
         
     | 
| 
       13433 
13438 
     | 
    
         
             
            dumpはデータベースのスキーマとデータを後から読み込めるフォーマットで出力します。dumpの結果は大きくなるため、主にコマンドラインから使うことを想定しています。データベースのバックアップが主な利用方法です。
         
     | 
| 
       13434 
13439 
     | 
    
         
             
            .sp
         
     | 
| 
       13435 
     | 
    
         
            -
            dumpが出力するフォーマットは直接 
     | 
| 
      
 13440 
     | 
    
         
            +
            dumpが出力するフォーマットは直接Groongaが解釈できるフォーマットです。そのため、以下のようにしてデータベースをコピーすることができます。:
         
     | 
| 
       13436 
13441 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       13437 
13442 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       13438 
13443 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -13455,7 +13460,7 @@ dumpが出力するフォーマットは直接groongaが解釈できるフォー 
     | 
|
| 
       13455 
13460 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       13456 
13461 
     | 
    
         
             
            .SS 返値
         
     | 
| 
       13457 
13462 
     | 
    
         
             
            .sp
         
     | 
| 
       13458 
     | 
    
         
            -
            データベースのスキーマとデータを 
     | 
| 
      
 13463 
     | 
    
         
            +
            データベースのスキーマとデータをGroongaの組み込みコマンド呼び出し形式で出力します。output_type指定は無視されます。
         
     | 
| 
       13459 
13464 
     | 
    
         
             
            .SS 例
         
     | 
| 
       13460 
13465 
     | 
    
         
             
            .sp
         
     | 
| 
       13461 
13466 
     | 
    
         
             
            データベース内のすべてのデータを出力:
         
     | 
| 
         @@ -13653,7 +13658,7 @@ log_level level 
     | 
|
| 
       13653 
13658 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       13654 
13659 
     | 
    
         
             
            .SS 説明
         
     | 
| 
       13655 
13660 
     | 
    
         
             
            .sp
         
     | 
| 
       13656 
     | 
    
         
            -
             
     | 
| 
      
 13661 
     | 
    
         
            +
            Groonga組込コマンドの一つであるlog_levelについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
         
     | 
| 
       13657 
13662 
     | 
    
         
             
            .sp
         
     | 
| 
       13658 
13663 
     | 
    
         
             
            log_levelは、ログ出力レベルを設定します。
         
     | 
| 
       13659 
13664 
     | 
    
         
             
            .SS 引数
         
     | 
| 
         @@ -13810,7 +13815,7 @@ log_reopen 
     | 
|
| 
       13810 
13815 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       13811 
13816 
     | 
    
         
             
            .SS 説明
         
     | 
| 
       13812 
13817 
     | 
    
         
             
            .sp
         
     | 
| 
       13813 
     | 
    
         
            -
             
     | 
| 
      
 13818 
     | 
    
         
            +
            Groonga組込コマンドの一つであるlog_reopenについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
         
     | 
| 
       13814 
13819 
     | 
    
         
             
            .sp
         
     | 
| 
       13815 
13820 
     | 
    
         
             
            log_reopenは、ログファイルを再読み込みします。
         
     | 
| 
       13816 
13821 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -14077,7 +14082,7 @@ quit 
     | 
|
| 
       14077 
14082 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       14078 
14083 
     | 
    
         
             
            .SS 説明
         
     | 
| 
       14079 
14084 
     | 
    
         
             
            .sp
         
     | 
| 
       14080 
     | 
    
         
            -
             
     | 
| 
      
 14085 
     | 
    
         
            +
            Groonga組込コマンドの一つであるquitについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
         
     | 
| 
       14081 
14086 
     | 
    
         
             
            .sp
         
     | 
| 
       14082 
14087 
     | 
    
         
             
            quitは、groongaプロセスとのセッションを終了します。クライアントプロセスならばgroongaプロセスとの接続を切ります。
         
     | 
| 
       14083 
14088 
     | 
    
         
             
            .SS 引数
         
     | 
| 
         @@ -16708,7 +16713,7 @@ shutdown 
     | 
|
| 
       16708 
16713 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       16709 
16714 
     | 
    
         
             
            .SS 説明
         
     | 
| 
       16710 
16715 
     | 
    
         
             
            .sp
         
     | 
| 
       16711 
     | 
    
         
            -
             
     | 
| 
      
 16716 
     | 
    
         
            +
            Groonga組込コマンドの一つであるshutdownについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
         
     | 
| 
       16712 
16717 
     | 
    
         
             
            .sp
         
     | 
| 
       16713 
16718 
     | 
    
         
             
            shutdownは、接続しているgroongaサーバプロセスを停止します。
         
     | 
| 
       16714 
16719 
     | 
    
         
             
            .SS 引数
         
     | 
| 
         @@ -16745,7 +16750,7 @@ status 
     | 
|
| 
       16745 
16750 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       16746 
16751 
     | 
    
         
             
            .SS 説明
         
     | 
| 
       16747 
16752 
     | 
    
         
             
            .sp
         
     | 
| 
       16748 
     | 
    
         
            -
             
     | 
| 
      
 16753 
     | 
    
         
            +
            Groonga組込コマンドの一つであるstatusについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
         
     | 
| 
       16749 
16754 
     | 
    
         
             
            .sp
         
     | 
| 
       16750 
16755 
     | 
    
         
             
            statusコマンドは、groongaプロセスの状態を表示します。主にgroongaサーバプロセスに対して使用することを想定しています。
         
     | 
| 
       16751 
16756 
     | 
    
         
             
            .SS 引数
         
     | 
| 
         @@ -16767,7 +16772,7 @@ statusコマンドは、groongaプロセスの状態を表示します。主にg 
     | 
|
| 
       16767 
16772 
     | 
    
         
             
            \fBalloc_count\fP
         
     | 
| 
       16768 
16773 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       16769 
16774 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       16770 
     | 
    
         
            -
            groongaプロセスの内部でアロケートされ、まだ解放されてないメモリブロックの数を示します。 
     | 
| 
      
 16775 
     | 
    
         
            +
            groongaプロセスの内部でアロケートされ、まだ解放されてないメモリブロックの数を示します。Groongaをbuildする際に、configureオプションで \-\-enable\-exact\-alloc\-countが指定されていたならば、正確な値を返します。それ以外の場合は不正確な値を返す場合があります。
         
     | 
| 
       16771 
16776 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       16772 
16777 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       16773 
16778 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -16800,14 +16805,14 @@ status 
     | 
|
| 
       16800 
16805 
     | 
    
         
             
            #     0.000355720520019531
         
     | 
| 
       16801 
16806 
     | 
    
         
             
            #   ],
         
     | 
| 
       16802 
16807 
     | 
    
         
             
            #   {
         
     | 
| 
       16803 
     | 
    
         
            -
            #     "uptime":  
     | 
| 
      
 16808 
     | 
    
         
            +
            #     "uptime": 1,
         
     | 
| 
       16804 
16809 
     | 
    
         
             
            #     "max_command_version": 2,
         
     | 
| 
       16805 
16810 
     | 
    
         
             
            #     "n_queries": 0,
         
     | 
| 
       16806 
16811 
     | 
    
         
             
            #     "cache_hit_rate": 0.0,
         
     | 
| 
       16807 
     | 
    
         
            -
            #     "version": "3.1. 
     | 
| 
       16808 
     | 
    
         
            -
            #     "alloc_count":  
     | 
| 
      
 16812 
     | 
    
         
            +
            #     "version": "3.1.1",
         
     | 
| 
      
 16813 
     | 
    
         
            +
            #     "alloc_count": 291,
         
     | 
| 
       16809 
16814 
     | 
    
         
             
            #     "command_version": 1,
         
     | 
| 
       16810 
     | 
    
         
            -
            #     "starttime":  
     | 
| 
      
 16815 
     | 
    
         
            +
            #     "starttime": 1387938926,
         
     | 
| 
       16811 
16816 
     | 
    
         
             
            #     "default_command_version": 1
         
     | 
| 
       16812 
16817 
     | 
    
         
             
            #   }
         
     | 
| 
       16813 
16818 
     | 
    
         
             
            # ]
         
     | 
| 
         @@ -17411,7 +17416,7 @@ table_create Logs TABLE_NO_KEY 
     | 
|
| 
       17411 
17416 
     | 
    
         
             
            .sp
         
     | 
| 
       17412 
17417 
     | 
    
         
             
            この \fBtable_create\fP コマンドは \fBLogs\fP という名前で \fBTABLE_NO_KEY\fP 型のテーブルを作成します。
         
     | 
| 
       17413 
17418 
     | 
    
         
             
            .sp
         
     | 
| 
       17414 
     | 
    
         
            -
            キーでレコードを検索しないのであれば、 \fBTABLE_NO_KEY\fP 型のテーブルが適切です。なぜなら、 \fBTABLE_NO_KEY\fP はキーをサポートしていませんが、速くて小さいサイズのテーブルだからです。ログを 
     | 
| 
      
 17419 
     | 
    
         
            +
            キーでレコードを検索しないのであれば、 \fBTABLE_NO_KEY\fP 型のテーブルが適切です。なぜなら、 \fBTABLE_NO_KEY\fP はキーをサポートしていませんが、速くて小さいサイズのテーブルだからです。ログをGroongaのデータベースに保存するという使い方はこのケースです。
         
     | 
| 
       17415 
17420 
     | 
    
         
             
            .sp
         
     | 
| 
       17416 
17421 
     | 
    
         
             
            キーでレコードを検索したり、カラムからレコードを参照したりする場合は、 \fBTABLE_NO_KEY\fP 型は適していません。全文検索用の語彙表として使うケースはこのケースです。
         
     | 
| 
       17417 
17422 
     | 
    
         
             
            .SS 語彙表テーブルの作成
         
     | 
| 
         @@ -17582,7 +17587,7 @@ _ 
     | 
|
| 
       17582 
17587 
     | 
    
         
             
            \fBノート:\fP
         
     | 
| 
       17583 
17588 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       17584 
17589 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       17585 
     | 
    
         
            -
             
     | 
| 
      
 17590 
     | 
    
         
            +
            Groonga 2.1.0から \fBKEY_NORMALIZE\fP フラグは非推奨になりました。代わりに、 \fBnormalizer\fP オプションに \fBNormalizerAuto\fP を指定してください。
         
     | 
| 
       17586 
17591 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       17587 
17592 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       17588 
17593 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -17676,7 +17681,7 @@ table_list 
     | 
|
| 
       17676 
17681 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       17677 
17682 
     | 
    
         
             
            .SS 説明
         
     | 
| 
       17678 
17683 
     | 
    
         
             
            .sp
         
     | 
| 
       17679 
     | 
    
         
            -
             
     | 
| 
      
 17684 
     | 
    
         
            +
            Groonga組込コマンドの一つであるtable_listについて説明します。組込コマンドは、groonga実行ファイルの引数、標準入力、またはソケット経由でgroongaサーバにリクエストを送信することによって実行します。
         
     | 
| 
       17680 
17685 
     | 
    
         
             
            .sp
         
     | 
| 
       17681 
17686 
     | 
    
         
             
            table_listは、DBに定義されているテーブルのリストを表示します。
         
     | 
| 
       17682 
17687 
     | 
    
         
             
            .SS 引数
         
     | 
| 
         @@ -18774,14 +18779,14 @@ HEADERのフォーマットは  [0, UNIX_TIME_WHEN_COMMAND_IS_STARTED, ELAPSED_T 
     | 
|
| 
       18774 
18779 
     | 
    
         
             
            .SS データ型
         
     | 
| 
       18775 
18780 
     | 
    
         
             
            .SS 名前
         
     | 
| 
       18776 
18781 
     | 
    
         
             
            .sp
         
     | 
| 
       18777 
     | 
    
         
            -
             
     | 
| 
      
 18782 
     | 
    
         
            +
            Groonga データ型
         
     | 
| 
       18778 
18783 
     | 
    
         
             
            .SS 説明
         
     | 
| 
       18779 
18784 
     | 
    
         
             
            .sp
         
     | 
| 
       18780 
     | 
    
         
            -
             
     | 
| 
      
 18785 
     | 
    
         
            +
            Groonga は、格納するデータの型を区別します。
         
     | 
| 
       18781 
18786 
     | 
    
         
             
            .sp
         
     | 
| 
       18782 
     | 
    
         
            -
             
     | 
| 
      
 18787 
     | 
    
         
            +
            Groongaのデータベースでは、テーブルの主キーや、カラムの値はいずれも何らかの型に属します。また通常は、一つのテーブルの中の全てのレコードについて、カラムの値は共通となります。
         
     | 
| 
       18783 
18788 
     | 
    
         
             
            .sp
         
     | 
| 
       18784 
     | 
    
         
            -
            主キーの型とカラムの型には、 
     | 
| 
      
 18789 
     | 
    
         
            +
            主キーの型とカラムの型には、Groongaで予め定義済みの型か、ユーザが定義する型、またはユーザが定義したテーブルを指定することができます。
         
     | 
| 
       18785 
18790 
     | 
    
         
             
            .sp
         
     | 
| 
       18786 
18791 
     | 
    
         
             
            主キーの型に他のテーブルを指定する場合は、そのテーブルは、主キーの型となるテーブルのサブセットとなります。
         
     | 
| 
       18787 
18792 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -18927,7 +18932,7 @@ IEEE 754形式の詳細については、 \fI\%IEEE 754 \- Wikipedia\fP や \fI\ 
     | 
|
| 
       18927 
18932 
     | 
    
         
             
            Text型とLongText型については、テーブルの主キーに指定することはできません。
         
     | 
| 
       18928 
18933 
     | 
    
         
             
            .SS ベクターとして格納できない型
         
     | 
| 
       18929 
18934 
     | 
    
         
             
            .sp
         
     | 
| 
       18930 
     | 
    
         
            -
             
     | 
| 
      
 18935 
     | 
    
         
            +
            Groongaのカラムは、ある型のベクターを保存することができます。しかし、ShortText, Text, LongTextの3つの型についてはベクターとして保存したり出力したりすることはできますが、検索条件やドリルダウン条件に指定することができません。
         
     | 
| 
       18931 
18936 
     | 
    
         
             
            .sp
         
     | 
| 
       18932 
18937 
     | 
    
         
             
            テーブル型は、ベクターとして格納することができます。よって、ShortTextのベクターを検索条件やドリルダウン条件に使用したい場合には、主キーがShortText型のテーブルを別途作成し、そのテーブルを型として利用します。
         
     | 
| 
       18933 
18938 
     | 
    
         
             
            脚注
         
     | 
| 
         @@ -19161,9 +19166,9 @@ _ 
     | 
|
| 
       19161 
19166 
     | 
    
         
             
            .SS ノーマライザー
         
     | 
| 
       19162 
19167 
     | 
    
         
             
            .SS 概要
         
     | 
| 
       19163 
19168 
     | 
    
         
             
            .sp
         
     | 
| 
       19164 
     | 
    
         
            -
             
     | 
| 
      
 19169 
     | 
    
         
            +
            Groongaには正規化をするノーマライザーモジュールがあります。これはテキストをトークナイズするときとテーブルのキーを保存するときに使われます。例えば、正規化をした後は \fBA\fP と \fBa\fP は同じ文字として扱われます。
         
     | 
| 
       19165 
19170 
     | 
    
         
             
            .sp
         
     | 
| 
       19166 
     | 
    
         
            -
            ノーマライザーモジュールはプラグインとして追加できます。ノーマライザープラグインを 
     | 
| 
      
 19171 
     | 
    
         
            +
            ノーマライザーモジュールはプラグインとして追加できます。ノーマライザープラグインをGroongaに追加することでテキストの正規化方法をカスタマイズできます。
         
     | 
| 
       19167 
19172 
     | 
    
         
             
            .sp
         
     | 
| 
       19168 
19173 
     | 
    
         
             
            ノーマライザーモジュールはテーブルに関連付いています。テーブルは0個か1個のノーマライザーモジュールを持つことができます。 \fB/reference/commands/table_create\fP の \fItable\-create\-normalizer\fP オプションでテーブルにノーマライザーオプションを関連付けることができます。
         
     | 
| 
       19169 
19174 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -19185,9 +19190,9 @@ table_create Dictionary TABLE_HASH_KEY ShortText \-\-normalizer NormalizerAuto 
     | 
|
| 
       19185 
19190 
     | 
    
         
             
            \fBノート:\fP
         
     | 
| 
       19186 
19191 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       19187 
19192 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       19188 
     | 
    
         
            -
             
     | 
| 
      
 19193 
     | 
    
         
            +
            Groonga 2.0.9以前には \fBtable_create\fP に \fB\-\-normalizer\fP オプションはありません。代わりに \fBKEY_NORMALIZE\fP フラグを使っていました。
         
     | 
| 
       19189 
19194 
     | 
    
         
             
            .sp
         
     | 
| 
       19190 
     | 
    
         
            -
             
     | 
| 
      
 19195 
     | 
    
         
            +
            Groonga 2.1.0以降で古いデータベースを開くことができます。ここでいう古いデータベースとはGroonga 2.0.9以前で作ったデータベースということです。しかし、一度新しいGroongaで開いたデータベースを2.0.9以前のGroongaで開くことはできません。一度 Groonga 2.1.0以降のGroongaでデータベースを開くと、 \fBKEY_NORMALIZE\fP フラグ情報がノーマライザー情報に変換されます。そのため、2.0.9以前のGroongaは、一度Groonga 2.1.0以降で開いたデータベース内から \fBKEY_NROMALIZE\fP フラグの情報を見つけることができません。
         
     | 
| 
       19191 
19196 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       19192 
19197 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       19193 
19198 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -19266,7 +19271,7 @@ select Dictionary 
     | 
|
| 
       19266 
19271 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       19267 
19272 
     | 
    
         
             
            .SS \fBNormalizerAuto\fP
         
     | 
| 
       19268 
19273 
     | 
    
         
             
            .sp
         
     | 
| 
       19269 
     | 
    
         
            -
            通常は \fBNormalizerAuto\fP ノーマライザーを使うべきです。 \fBNormalizerAuto\fP は 
     | 
| 
      
 19274 
     | 
    
         
            +
            通常は \fBNormalizerAuto\fP ノーマライザーを使うべきです。 \fBNormalizerAuto\fP はGroonga 2.0.9以前で使っていたノーマライザーと同じものです。2.0.9以前のGroongaの \fBtable_create\fP の \fBKEY_NORMALIZE\fP フラグは、2.1.0以降のGroongaの \fBtable_create\fP の \fB\-\-normalizer NormalizerAuto\fP と同じです。
         
     | 
| 
       19270 
19275 
     | 
    
         
             
            .sp
         
     | 
| 
       19271 
19276 
     | 
    
         
             
            \fBNormalizerAuto\fP はすべてのエンコーディングに対応しています。UTF\-8でエンコードされたテキストにはUnicodeのNFKC(Normalization Form Compatibility Composition)を使います。他のエンコーディング用にはエンコーディング毎に独自の正規化をします。これらの独自の正規化の結果はNFKCでの結果と似たものになります。
         
     | 
| 
       19272 
19277 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -19322,7 +19327,7 @@ table_create NFKC51Lexicon TABLE_HASH_KEY ShortText \-\-normalizer NormalizerNFK 
     | 
|
| 
       19322 
19327 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       19323 
19328 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       19324 
19329 
     | 
    
         
             
            .sp
         
     | 
| 
       19325 
     | 
    
         
            -
            \fBgroonga\-normalizer\-mysql\fP は 
     | 
| 
      
 19330 
     | 
    
         
            +
            \fBgroonga\-normalizer\-mysql\fP はGroongaのプラグインです。MySQL互換のノーマライザーを提供します。ノーマライザー \fBNormalizerMySQLGeneralCI\fP に対応するのは \fButf8mb4_general_ci\fP です。
         
     | 
| 
       19326 
19331 
     | 
    
         
             
            .sp
         
     | 
| 
       19327 
19332 
     | 
    
         
             
            事前に \fBnormalizers/mysql\fP プラグインを登録する必要があります。
         
     | 
| 
       19328 
19333 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -23567,6 +23572,209 @@ select Words \-\-filter \(aq_key *T "Groonga is the successor project to Senna." 
     | 
|
| 
       23567 
23572 
     | 
    
         
             
            このセクションでは関数についての説明と組み込みの関数について説明します。
         
     | 
| 
       23568 
23573 
     | 
    
         
             
            .sp
         
     | 
| 
       23569 
23574 
     | 
    
         
             
            TODO: Add documentations about function.
         
     | 
| 
      
 23575 
     | 
    
         
            +
            .SS between
         
     | 
| 
      
 23576 
     | 
    
         
            +
            .SS 概要
         
     | 
| 
      
 23577 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 23578 
     | 
    
         
            +
            \fBbetween\fP is used for checking the specified value exists in the specific range.
         
     | 
| 
      
 23579 
     | 
    
         
            +
            It is often used for combination with \fIselect\-filter\fP option in \fB/reference/commands/select\fP.
         
     | 
| 
      
 23580 
     | 
    
         
            +
            .SS 構文
         
     | 
| 
      
 23581 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 23582 
     | 
    
         
            +
            \fBbetween\fP には引数が5つあります。
         
     | 
| 
      
 23583 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 23584 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 23585 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 23586 
     | 
    
         
            +
            .nf
         
     | 
| 
      
 23587 
     | 
    
         
            +
            .ft C
         
     | 
| 
      
 23588 
     | 
    
         
            +
            between(column_or_value, min, min_border, max, max_border)
         
     | 
| 
      
 23589 
     | 
    
         
            +
            .ft P
         
     | 
| 
      
 23590 
     | 
    
         
            +
            .fi
         
     | 
| 
      
 23591 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 23592 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 23593 
     | 
    
         
            +
            .SS 使い方
         
     | 
| 
      
 23594 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 23595 
     | 
    
         
            +
            Here are a schema definition and sample data to show usage.:
         
     | 
| 
      
 23596 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 23597 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 23598 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 23599 
     | 
    
         
            +
            .nf
         
     | 
| 
      
 23600 
     | 
    
         
            +
            .ft C
         
     | 
| 
      
 23601 
     | 
    
         
            +
            table_create Users TABLE_HASH_KEY ShortText
         
     | 
| 
      
 23602 
     | 
    
         
            +
            column_create Users age COLUMN_SCALAR Int32
         
     | 
| 
      
 23603 
     | 
    
         
            +
            table_create Ages TABLE_HASH_KEY Int32
         
     | 
| 
      
 23604 
     | 
    
         
            +
            column_create Ages user_age COLUMN_INDEX Users age
         
     | 
| 
      
 23605 
     | 
    
         
            +
            load \-\-table Users
         
     | 
| 
      
 23606 
     | 
    
         
            +
            [
         
     | 
| 
      
 23607 
     | 
    
         
            +
            {"_key": "Alice",  "age": 12},
         
     | 
| 
      
 23608 
     | 
    
         
            +
            {"_key": "Bob",    "age": 13},
         
     | 
| 
      
 23609 
     | 
    
         
            +
            {"_key": "Calros", "age": 15},
         
     | 
| 
      
 23610 
     | 
    
         
            +
            {"_key": "Dave",   "age": 16},
         
     | 
| 
      
 23611 
     | 
    
         
            +
            {"_key": "Eric",   "age": 20}
         
     | 
| 
      
 23612 
     | 
    
         
            +
            {"_key": "Frank",  "age": 21}
         
     | 
| 
      
 23613 
     | 
    
         
            +
            ]
         
     | 
| 
      
 23614 
     | 
    
         
            +
            .ft P
         
     | 
| 
      
 23615 
     | 
    
         
            +
            .fi
         
     | 
| 
      
 23616 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 23617 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 23618 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 23619 
     | 
    
         
            +
            これはPG\-13 (MPAA)のレーティングに該当する人を示すクエリです。
         
     | 
| 
      
 23620 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 23621 
     | 
    
         
            +
            実行例:
         
     | 
| 
      
 23622 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 23623 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 23624 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 23625 
     | 
    
         
            +
            .nf
         
     | 
| 
      
 23626 
     | 
    
         
            +
            .ft C
         
     | 
| 
      
 23627 
     | 
    
         
            +
            select Users \-\-filter \(aqbetween(age, 13, "include", 16, "include")\(aq
         
     | 
| 
      
 23628 
     | 
    
         
            +
            # [
         
     | 
| 
      
 23629 
     | 
    
         
            +
            #   [
         
     | 
| 
      
 23630 
     | 
    
         
            +
            #     0,
         
     | 
| 
      
 23631 
     | 
    
         
            +
            #     1337566253.89858,
         
     | 
| 
      
 23632 
     | 
    
         
            +
            #     0.000355720520019531
         
     | 
| 
      
 23633 
     | 
    
         
            +
            #   ],
         
     | 
| 
      
 23634 
     | 
    
         
            +
            #   [
         
     | 
| 
      
 23635 
     | 
    
         
            +
            #     [
         
     | 
| 
      
 23636 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 23637 
     | 
    
         
            +
            #         3
         
     | 
| 
      
 23638 
     | 
    
         
            +
            #       ],
         
     | 
| 
      
 23639 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 23640 
     | 
    
         
            +
            #         [
         
     | 
| 
      
 23641 
     | 
    
         
            +
            #           "_id",
         
     | 
| 
      
 23642 
     | 
    
         
            +
            #           "UInt32"
         
     | 
| 
      
 23643 
     | 
    
         
            +
            #         ],
         
     | 
| 
      
 23644 
     | 
    
         
            +
            #         [
         
     | 
| 
      
 23645 
     | 
    
         
            +
            #           "_key",
         
     | 
| 
      
 23646 
     | 
    
         
            +
            #           "ShortText"
         
     | 
| 
      
 23647 
     | 
    
         
            +
            #         ],
         
     | 
| 
      
 23648 
     | 
    
         
            +
            #         [
         
     | 
| 
      
 23649 
     | 
    
         
            +
            #           "age",
         
     | 
| 
      
 23650 
     | 
    
         
            +
            #           "Int32"
         
     | 
| 
      
 23651 
     | 
    
         
            +
            #         ]
         
     | 
| 
      
 23652 
     | 
    
         
            +
            #       ],
         
     | 
| 
      
 23653 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 23654 
     | 
    
         
            +
            #         2,
         
     | 
| 
      
 23655 
     | 
    
         
            +
            #         "Bob",
         
     | 
| 
      
 23656 
     | 
    
         
            +
            #         13
         
     | 
| 
      
 23657 
     | 
    
         
            +
            #       ],
         
     | 
| 
      
 23658 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 23659 
     | 
    
         
            +
            #         3,
         
     | 
| 
      
 23660 
     | 
    
         
            +
            #         "Calros",
         
     | 
| 
      
 23661 
     | 
    
         
            +
            #         15
         
     | 
| 
      
 23662 
     | 
    
         
            +
            #       ],
         
     | 
| 
      
 23663 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 23664 
     | 
    
         
            +
            #         4,
         
     | 
| 
      
 23665 
     | 
    
         
            +
            #         "Dave",
         
     | 
| 
      
 23666 
     | 
    
         
            +
            #         16
         
     | 
| 
      
 23667 
     | 
    
         
            +
            #       ]
         
     | 
| 
      
 23668 
     | 
    
         
            +
            #     ]
         
     | 
| 
      
 23669 
     | 
    
         
            +
            #   ]
         
     | 
| 
      
 23670 
     | 
    
         
            +
            # ]
         
     | 
| 
      
 23671 
     | 
    
         
            +
            .ft P
         
     | 
| 
      
 23672 
     | 
    
         
            +
            .fi
         
     | 
| 
      
 23673 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 23674 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 23675 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 23676 
     | 
    
         
            +
            13から16歳までのユーザーを返します。
         
     | 
| 
      
 23677 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 23678 
     | 
    
         
            +
            \fBbetween\fP 関数はテーブルのカラムだけでなく、値も受け付けます。
         
     | 
| 
      
 23679 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 23680 
     | 
    
         
            +
            最初の引数に値を指定した場合、その値が含まれているか否かをチェックします。もし、指定した範囲にマッチしたら、( \fBbetween\fP 関数がtrueを返すので)すべてのレコードを返します。
         
     | 
| 
      
 23681 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 23682 
     | 
    
         
            +
            もし、指定した範囲にマッチしなかった場合、( \fBbetween\fP 関数がfalseを返すので)1件もレコードを返しません。
         
     | 
| 
      
 23683 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 23684 
     | 
    
         
            +
            実行例:
         
     | 
| 
      
 23685 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 23686 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 23687 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 23688 
     | 
    
         
            +
            .nf
         
     | 
| 
      
 23689 
     | 
    
         
            +
            .ft C
         
     | 
| 
      
 23690 
     | 
    
         
            +
            select Users \-\-filter \(aqbetween(14, 13, "include", 16, "include")\(aq
         
     | 
| 
      
 23691 
     | 
    
         
            +
            # [
         
     | 
| 
      
 23692 
     | 
    
         
            +
            #   [
         
     | 
| 
      
 23693 
     | 
    
         
            +
            #     0,
         
     | 
| 
      
 23694 
     | 
    
         
            +
            #     1337566253.89858,
         
     | 
| 
      
 23695 
     | 
    
         
            +
            #     0.000355720520019531
         
     | 
| 
      
 23696 
     | 
    
         
            +
            #   ],
         
     | 
| 
      
 23697 
     | 
    
         
            +
            #   [
         
     | 
| 
      
 23698 
     | 
    
         
            +
            #     [
         
     | 
| 
      
 23699 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 23700 
     | 
    
         
            +
            #         6
         
     | 
| 
      
 23701 
     | 
    
         
            +
            #       ],
         
     | 
| 
      
 23702 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 23703 
     | 
    
         
            +
            #         [
         
     | 
| 
      
 23704 
     | 
    
         
            +
            #           "_id",
         
     | 
| 
      
 23705 
     | 
    
         
            +
            #           "UInt32"
         
     | 
| 
      
 23706 
     | 
    
         
            +
            #         ],
         
     | 
| 
      
 23707 
     | 
    
         
            +
            #         [
         
     | 
| 
      
 23708 
     | 
    
         
            +
            #           "_key",
         
     | 
| 
      
 23709 
     | 
    
         
            +
            #           "ShortText"
         
     | 
| 
      
 23710 
     | 
    
         
            +
            #         ],
         
     | 
| 
      
 23711 
     | 
    
         
            +
            #         [
         
     | 
| 
      
 23712 
     | 
    
         
            +
            #           "age",
         
     | 
| 
      
 23713 
     | 
    
         
            +
            #           "Int32"
         
     | 
| 
      
 23714 
     | 
    
         
            +
            #         ]
         
     | 
| 
      
 23715 
     | 
    
         
            +
            #       ],
         
     | 
| 
      
 23716 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 23717 
     | 
    
         
            +
            #         1,
         
     | 
| 
      
 23718 
     | 
    
         
            +
            #         "Alice",
         
     | 
| 
      
 23719 
     | 
    
         
            +
            #         12
         
     | 
| 
      
 23720 
     | 
    
         
            +
            #       ],
         
     | 
| 
      
 23721 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 23722 
     | 
    
         
            +
            #         2,
         
     | 
| 
      
 23723 
     | 
    
         
            +
            #         "Bob",
         
     | 
| 
      
 23724 
     | 
    
         
            +
            #         13
         
     | 
| 
      
 23725 
     | 
    
         
            +
            #       ],
         
     | 
| 
      
 23726 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 23727 
     | 
    
         
            +
            #         3,
         
     | 
| 
      
 23728 
     | 
    
         
            +
            #         "Calros",
         
     | 
| 
      
 23729 
     | 
    
         
            +
            #         15
         
     | 
| 
      
 23730 
     | 
    
         
            +
            #       ],
         
     | 
| 
      
 23731 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 23732 
     | 
    
         
            +
            #         4,
         
     | 
| 
      
 23733 
     | 
    
         
            +
            #         "Dave",
         
     | 
| 
      
 23734 
     | 
    
         
            +
            #         16
         
     | 
| 
      
 23735 
     | 
    
         
            +
            #       ],
         
     | 
| 
      
 23736 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 23737 
     | 
    
         
            +
            #         5,
         
     | 
| 
      
 23738 
     | 
    
         
            +
            #         "Eric",
         
     | 
| 
      
 23739 
     | 
    
         
            +
            #         20
         
     | 
| 
      
 23740 
     | 
    
         
            +
            #       ],
         
     | 
| 
      
 23741 
     | 
    
         
            +
            #       [
         
     | 
| 
      
 23742 
     | 
    
         
            +
            #         6,
         
     | 
| 
      
 23743 
     | 
    
         
            +
            #         "Frank",
         
     | 
| 
      
 23744 
     | 
    
         
            +
            #         21
         
     | 
| 
      
 23745 
     | 
    
         
            +
            #       ]
         
     | 
| 
      
 23746 
     | 
    
         
            +
            #     ]
         
     | 
| 
      
 23747 
     | 
    
         
            +
            #   ]
         
     | 
| 
      
 23748 
     | 
    
         
            +
            # ]
         
     | 
| 
      
 23749 
     | 
    
         
            +
            .ft P
         
     | 
| 
      
 23750 
     | 
    
         
            +
            .fi
         
     | 
| 
      
 23751 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 23752 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 23753 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 23754 
     | 
    
         
            +
            上記の例では、すべてのレコードを返します。これは、14は指定した範囲である13から16の間にあるからです。この振舞いは指定した値がテーブルに存在するかどうかの確認に使えます。
         
     | 
| 
      
 23755 
     | 
    
         
            +
            .SS 引数
         
     | 
| 
      
 23756 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 23757 
     | 
    
         
            +
            引数は5つあります。 \fBcolumn_or_value\fP と \fBmin\fP と \fBmin_border\fP と \fBmax\fP と \fBmax_border\fP です。
         
     | 
| 
      
 23758 
     | 
    
         
            +
            .SS \fBcolumn_or_value\fP
         
     | 
| 
      
 23759 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 23760 
     | 
    
         
            +
            テーブルのカラムもしくは値を指定します。
         
     | 
| 
      
 23761 
     | 
    
         
            +
            .SS \fBmin\fP
         
     | 
| 
      
 23762 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 23763 
     | 
    
         
            +
            範囲のうち最小値を指定します。値 \fBmin\fP が含まれるかどうかは \fBmin_border\fP 引数で制御することができます。
         
     | 
| 
      
 23764 
     | 
    
         
            +
            .SS \fBmin_border\fP
         
     | 
| 
      
 23765 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 23766 
     | 
    
         
            +
            \fBmin\fP の値を含めた範囲となるかどうかを指定します。 \fBmin_border\fP に指定できるのは "include" または "exclude" のどちらかです。
         
     | 
| 
      
 23767 
     | 
    
         
            +
            "include" を指定すれば、\fBmin\fP が含まれます。 "exclude" を指定すれば \fBmin\fP は含まれません。
         
     | 
| 
      
 23768 
     | 
    
         
            +
            .SS \fBmax\fP
         
     | 
| 
      
 23769 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 23770 
     | 
    
         
            +
            範囲のうち最大値を指定します。値 \fBmax\fP が含まれるかどうかは \fBmax_border\fP 引数で制御することができます。
         
     | 
| 
      
 23771 
     | 
    
         
            +
            .SS \fBmax_border\fP
         
     | 
| 
      
 23772 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 23773 
     | 
    
         
            +
            \fBman\fP の値を含めた範囲となるかどうかを指定します。 \fBmax_border\fP に指定できるのは "include" または "exclude" のどちらかです。
         
     | 
| 
      
 23774 
     | 
    
         
            +
            "include" を指定すれば、\fBmax\fP が含まれます。 "exclude" を指定すれば \fBmax\fP は含まれません。
         
     | 
| 
      
 23775 
     | 
    
         
            +
            .SS 戻り値
         
     | 
| 
      
 23776 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 23777 
     | 
    
         
            +
            \fBbetween\fP は指定した範囲にカラムの値が含まれるかを返します。もし該当するレコードがあれば、 \fBtrue\fP を返します。そうでなければ \fBfalse\fP を返します。
         
     | 
| 
       23570 
23778 
     | 
    
         
             
            .SS edit_distance
         
     | 
| 
       23571 
23779 
     | 
    
         
             
            .SS 名前
         
     | 
| 
       23572 
23780 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -25923,7 +26131,7 @@ can always map database files onto memory. It is no problem until 
     | 
|
| 
       25923 
26131 
     | 
    
         
             
            groonga touch mapped database files that their size is larger than
         
     | 
| 
       25924 
26132 
     | 
    
         
             
            memory and swap. Groonga recommends the configuration.
         
     | 
| 
       25925 
26133 
     | 
    
         
             
            .sp
         
     | 
| 
       25926 
     | 
    
         
            -
            See \fI\%Linux kernel  
     | 
| 
      
 26134 
     | 
    
         
            +
            See \fI\%Linux kernel documentation about overcommit\fP
         
     | 
| 
       25927 
26135 
     | 
    
         
             
            about \fBvm.overcommit_memory\fP parameter details.
         
     | 
| 
       25928 
26136 
     | 
    
         
             
            .sp
         
     | 
| 
       25929 
26137 
     | 
    
         
             
            You can set the configuration by putting a configuration file
         
     | 
| 
         @@ -26009,7 +26217,7 @@ vm.max_map_count = 131072 
     | 
|
| 
       26009 
26217 
     | 
    
         
             
            TODO
         
     | 
| 
       26010 
26218 
     | 
    
         
             
            .SS API
         
     | 
| 
       26011 
26219 
     | 
    
         
             
            .sp
         
     | 
| 
       26012 
     | 
    
         
            -
             
     | 
| 
      
 26220 
     | 
    
         
            +
            Groongaを全文検索ライブラリとして使うことができます。この節ではGroongaが提供しているAPIを示します。
         
     | 
| 
       26013 
26221 
     | 
    
         
             
            .SS \fBgrn_cache\fP
         
     | 
| 
       26014 
26222 
     | 
    
         
             
            .SS 概要
         
     | 
| 
       26015 
26223 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -26186,6 +26394,146 @@ TODO... 
     | 
|
| 
       26186 
26394 
     | 
    
         
             
            .SS リファレンス
         
     | 
| 
       26187 
26395 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       26188 
26396 
     | 
    
         
             
            .TP
         
     | 
| 
      
 26397 
     | 
    
         
            +
            .B GRN_COLUMN_NAME_ID
         
     | 
| 
      
 26398 
     | 
    
         
            +
            It returns the name of \fB/reference/pseudo_column\fP \fB_id\fP.
         
     | 
| 
      
 26399 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 26400 
     | 
    
         
            +
            It is useful to use with \fBGRN_COLUMN_NAME_ID_LEN\fP like
         
     | 
| 
      
 26401 
     | 
    
         
            +
            the following:
         
     | 
| 
      
 26402 
     | 
    
         
            +
            .INDENT 7.0
         
     | 
| 
      
 26403 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 26404 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 26405 
     | 
    
         
            +
            .nf
         
     | 
| 
      
 26406 
     | 
    
         
            +
            .ft C
         
     | 
| 
      
 26407 
     | 
    
         
            +
            grn_obj *id_column;
         
     | 
| 
      
 26408 
     | 
    
         
            +
            id_column = grn_ctx_get(ctx, GRN_COLUMN_NAME_ID, GRN_COLUMN_NAME_ID_LEN);
         
     | 
| 
      
 26409 
     | 
    
         
            +
            .ft P
         
     | 
| 
      
 26410 
     | 
    
         
            +
            .fi
         
     | 
| 
      
 26411 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 26412 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 26413 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 26414 
     | 
    
         
            +
            Since 3.1.1.
         
     | 
| 
      
 26415 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 26416 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 26417 
     | 
    
         
            +
            .TP
         
     | 
| 
      
 26418 
     | 
    
         
            +
            .B GRN_COLUMN_NAME_ID_LEN
         
     | 
| 
      
 26419 
     | 
    
         
            +
            It returns the byte size of \fBGRN_COLUMN_NAME_ID\fP.
         
     | 
| 
      
 26420 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 26421 
     | 
    
         
            +
            Since 3.1.1.
         
     | 
| 
      
 26422 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 26423 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 26424 
     | 
    
         
            +
            .TP
         
     | 
| 
      
 26425 
     | 
    
         
            +
            .B GRN_COLUMN_NAME_KEY
         
     | 
| 
      
 26426 
     | 
    
         
            +
            It returns the name of \fB/reference/pseudo_column\fP \fB_key\fP.
         
     | 
| 
      
 26427 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 26428 
     | 
    
         
            +
            It is useful to use with \fBGRN_COLUMN_NAME_KEY_LEN\fP like
         
     | 
| 
      
 26429 
     | 
    
         
            +
            the following:
         
     | 
| 
      
 26430 
     | 
    
         
            +
            .INDENT 7.0
         
     | 
| 
      
 26431 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 26432 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 26433 
     | 
    
         
            +
            .nf
         
     | 
| 
      
 26434 
     | 
    
         
            +
            .ft C
         
     | 
| 
      
 26435 
     | 
    
         
            +
            grn_obj *key_column;
         
     | 
| 
      
 26436 
     | 
    
         
            +
            key_column = grn_ctx_get(ctx, GRN_COLUMN_NAME_KEY, GRN_COLUMN_NAME_KEY_LEN);
         
     | 
| 
      
 26437 
     | 
    
         
            +
            .ft P
         
     | 
| 
      
 26438 
     | 
    
         
            +
            .fi
         
     | 
| 
      
 26439 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 26440 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 26441 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 26442 
     | 
    
         
            +
            Since 3.1.1.
         
     | 
| 
      
 26443 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 26444 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 26445 
     | 
    
         
            +
            .TP
         
     | 
| 
      
 26446 
     | 
    
         
            +
            .B GRN_COLUMN_NAME_KEY_LEN
         
     | 
| 
      
 26447 
     | 
    
         
            +
            It returns the byte size of \fBGRN_COLUMN_NAME_KEY\fP.
         
     | 
| 
      
 26448 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 26449 
     | 
    
         
            +
            Since 3.1.1.
         
     | 
| 
      
 26450 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 26451 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 26452 
     | 
    
         
            +
            .TP
         
     | 
| 
      
 26453 
     | 
    
         
            +
            .B GRN_COLUMN_NAME_VALUE
         
     | 
| 
      
 26454 
     | 
    
         
            +
            It returns the name of \fB/reference/pseudo_column\fP \fB_value\fP.
         
     | 
| 
      
 26455 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 26456 
     | 
    
         
            +
            It is useful to use with \fBGRN_COLUMN_NAME_VALUE_LEN\fP like
         
     | 
| 
      
 26457 
     | 
    
         
            +
            the following:
         
     | 
| 
      
 26458 
     | 
    
         
            +
            .INDENT 7.0
         
     | 
| 
      
 26459 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 26460 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 26461 
     | 
    
         
            +
            .nf
         
     | 
| 
      
 26462 
     | 
    
         
            +
            .ft C
         
     | 
| 
      
 26463 
     | 
    
         
            +
            grn_obj *value_column;
         
     | 
| 
      
 26464 
     | 
    
         
            +
            value_column = grn_ctx_get(ctx, GRN_COLUMN_NAME_VALUE, GRN_COLUMN_NAME_VALUE_LEN);
         
     | 
| 
      
 26465 
     | 
    
         
            +
            .ft P
         
     | 
| 
      
 26466 
     | 
    
         
            +
            .fi
         
     | 
| 
      
 26467 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 26468 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 26469 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 26470 
     | 
    
         
            +
            Since 3.1.1.
         
     | 
| 
      
 26471 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 26472 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 26473 
     | 
    
         
            +
            .TP
         
     | 
| 
      
 26474 
     | 
    
         
            +
            .B GRN_COLUMN_NAME_VALUE_LEN
         
     | 
| 
      
 26475 
     | 
    
         
            +
            It returns the byte size of \fBGRN_COLUMN_NAME_VALUE\fP.
         
     | 
| 
      
 26476 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 26477 
     | 
    
         
            +
            Since 3.1.1.
         
     | 
| 
      
 26478 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 26479 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 26480 
     | 
    
         
            +
            .TP
         
     | 
| 
      
 26481 
     | 
    
         
            +
            .B GRN_COLUMN_NAME_SCORE
         
     | 
| 
      
 26482 
     | 
    
         
            +
            It returns the name of \fB/reference/pseudo_column\fP \fB_score\fP.
         
     | 
| 
      
 26483 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 26484 
     | 
    
         
            +
            It is useful to use with \fBGRN_COLUMN_NAME_SCORE_LEN\fP like
         
     | 
| 
      
 26485 
     | 
    
         
            +
            the following:
         
     | 
| 
      
 26486 
     | 
    
         
            +
            .INDENT 7.0
         
     | 
| 
      
 26487 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 26488 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 26489 
     | 
    
         
            +
            .nf
         
     | 
| 
      
 26490 
     | 
    
         
            +
            .ft C
         
     | 
| 
      
 26491 
     | 
    
         
            +
            grn_obj *score_column;
         
     | 
| 
      
 26492 
     | 
    
         
            +
            score_column = grn_ctx_get(ctx, GRN_COLUMN_NAME_SCORE, GRN_COLUMN_NAME_SCORE_LEN);
         
     | 
| 
      
 26493 
     | 
    
         
            +
            .ft P
         
     | 
| 
      
 26494 
     | 
    
         
            +
            .fi
         
     | 
| 
      
 26495 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 26496 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 26497 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 26498 
     | 
    
         
            +
            Since 3.1.1.
         
     | 
| 
      
 26499 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 26500 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 26501 
     | 
    
         
            +
            .TP
         
     | 
| 
      
 26502 
     | 
    
         
            +
            .B GRN_COLUMN_NAME_SCORE_LEN
         
     | 
| 
      
 26503 
     | 
    
         
            +
            It returns the byte size of \fBGRN_COLUMN_NAME_SCORE\fP.
         
     | 
| 
      
 26504 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 26505 
     | 
    
         
            +
            Since 3.1.1.
         
     | 
| 
      
 26506 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 26507 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 26508 
     | 
    
         
            +
            .TP
         
     | 
| 
      
 26509 
     | 
    
         
            +
            .B GRN_COLUMN_NAME_NSUBRECS
         
     | 
| 
      
 26510 
     | 
    
         
            +
            It returns the name of \fB/reference/pseudo_column\fP \fB_nsubrecs\fP.
         
     | 
| 
      
 26511 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 26512 
     | 
    
         
            +
            It is useful to use with \fBGRN_COLUMN_NAME_NSUBRECS_LEN\fP like
         
     | 
| 
      
 26513 
     | 
    
         
            +
            the following:
         
     | 
| 
      
 26514 
     | 
    
         
            +
            .INDENT 7.0
         
     | 
| 
      
 26515 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 26516 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 26517 
     | 
    
         
            +
            .nf
         
     | 
| 
      
 26518 
     | 
    
         
            +
            .ft C
         
     | 
| 
      
 26519 
     | 
    
         
            +
            grn_obj *nsubrecs_column;
         
     | 
| 
      
 26520 
     | 
    
         
            +
            nsubrecs_column = grn_ctx_get(ctx, GRN_COLUMN_NAME_NSUBRECS, GRN_COLUMN_NAME_NSUBRECS_LEN);
         
     | 
| 
      
 26521 
     | 
    
         
            +
            .ft P
         
     | 
| 
      
 26522 
     | 
    
         
            +
            .fi
         
     | 
| 
      
 26523 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 26524 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 26525 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 26526 
     | 
    
         
            +
            Since 3.1.1.
         
     | 
| 
      
 26527 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 26528 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 26529 
     | 
    
         
            +
            .TP
         
     | 
| 
      
 26530 
     | 
    
         
            +
            .B GRN_COLUMN_NAME_NSUBRECS_LEN
         
     | 
| 
      
 26531 
     | 
    
         
            +
            It returns the byte size of \fBGRN_COLUMN_NAME_NSUBRECS\fP.
         
     | 
| 
      
 26532 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 26533 
     | 
    
         
            +
            Since 3.1.1.
         
     | 
| 
      
 26534 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 26535 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 26536 
     | 
    
         
            +
            .TP
         
     | 
| 
       26189 
26537 
     | 
    
         
             
            .B grn_obj *grn_column_create(grn_ctx\fI\ *ctx\fP, grn_obj\fI\ *table\fP, const char\fI\ *name\fP, unsigned int\fI\ name_size\fP, const char\fI\ *path\fP, grn_obj_flags\fI\ flags\fP, grn_obj\fI\ *type\fP)
         
     | 
| 
       26190 
26538 
     | 
    
         
             
            tableに新たなカラムを定義します。nameは省略できません。一つのtableに同一のnameのcolumnを複数定義することはできません。
         
     | 
| 
       26191 
26539 
     | 
    
         
             
            .INDENT 7.0
         
     | 
| 
         @@ -26435,7 +26783,7 @@ If \fBctx\fP is initialized by \fBgrn_ctx_open()\fP not \fBgrn_ctx_init()\fP. Yo 
     | 
|
| 
       26435 
26783 
     | 
    
         
             
            .B grn_ctx *grn_ctx_open(int\fI\ flags\fP)
         
     | 
| 
       26436 
26784 
     | 
    
         
             
            初期化された \fBgrn_ctx\fP オブジェクトを返します。
         
     | 
| 
       26437 
26785 
     | 
    
         
             
            .sp
         
     | 
| 
       26438 
     | 
    
         
            -
            \fBgrn_ctx_init()\fP で初期化された \fBgrn_ctx\fP オブジェクトは構造体の実体をAPIの呼び元で確保するのに対して、 \fBgrn_ctx_open()\fP では 
     | 
| 
      
 26786 
     | 
    
         
            +
            \fBgrn_ctx_init()\fP で初期化された \fBgrn_ctx\fP オブジェクトは構造体の実体をAPIの呼び元で確保するのに対して、 \fBgrn_ctx_open()\fP ではGroongaライブラリの内部で、実体を確保します。
         
     | 
| 
       26439 
26787 
     | 
    
         
             
            どちらで初期化された \fBgrn_ctx\fP も、 \fBgrn_ctx_fin()\fP で解放できます。
         
     | 
| 
       26440 
26788 
     | 
    
         
             
            \fBgrn_ctx_open()\fP で確保した \fBgrn_ctx\fP 構造体に関しては、\fBgrn_ctx_fin()\fP で解放した後に、その \fBgrn_ctx\fP で作成した \fBgrn_obj\fP を \fBgrn_obj_close()\fP によって解放しても問題ありません。
         
     | 
| 
       26441 
26789 
     | 
    
         
             
            .INDENT 7.0
         
     | 
| 
         @@ -27280,7 +27628,7 @@ nameはアクセサ文字列の場合、それに対応するaccessorを返し 
     | 
|
| 
       27280 
27628 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       27281 
27629 
     | 
    
         
             
            .TP
         
     | 
| 
       27282 
27630 
     | 
    
         
             
            .B grn_bool grn_obj_is_builtin(grn_ctx\fI\ *ctx\fP, grn_obj\fI\ *obj\fP)
         
     | 
| 
       27283 
     | 
    
         
            -
            Check whether  
     | 
| 
      
 27631 
     | 
    
         
            +
            Check whether Groonga built\-in object.
         
     | 
| 
       27284 
27632 
     | 
    
         
             
            .INDENT 7.0
         
     | 
| 
       27285 
27633 
     | 
    
         
             
            .TP
         
     | 
| 
       27286 
27634 
     | 
    
         
             
            .B パラメタ
         
     | 
| 
         @@ -28954,7 +29302,7 @@ select Shops \-\-filter \(aq"point > 3 && description @ \e"スープカレー\e" 
     | 
|
| 
       28954 
29302 
     | 
    
         
             
            そのため、descriptionに「スープカレーライス」が含まれていても、「スープカレーライス」は「スープカレー」に完全一致しないのでヒットしません。
         
     | 
| 
       28955 
29303 
     | 
    
         
             
            .SH 制限事項
         
     | 
| 
       28956 
29304 
     | 
    
         
             
            .sp
         
     | 
| 
       28957 
     | 
    
         
            -
             
     | 
| 
      
 29305 
     | 
    
         
            +
            Groongaにはいくつか制限事項があります。
         
     | 
| 
       28958 
29306 
     | 
    
         
             
            .SS テーブルの制限
         
     | 
| 
       28959 
29307 
     | 
    
         
             
            .sp
         
     | 
| 
       28960 
29308 
     | 
    
         
             
            テーブルには以下の制限があります。
         
     | 
| 
         @@ -29262,15 +29610,15 @@ sudo sysctl \-w vm.max_map_count=65536 で一時的に vm.max_map_count を調 
     | 
|
| 
       29262 
29610 
     | 
    
         
             
            チューニング関連のパラメータについては、 \fB/reference/tuning\fP のドキュメントを参照してください。
         
     | 
| 
       29263 
29611 
     | 
    
         
             
            .SH 開発
         
     | 
| 
       29264 
29612 
     | 
    
         
             
            .sp
         
     | 
| 
       29265 
     | 
    
         
            -
            このセクションでは 
     | 
| 
      
 29613 
     | 
    
         
            +
            このセクションではGroongaを使った開発について説明します。例えば、Groongaをデータベースとして使ったアプリケーション、libgroongaを使ったライブラリ、libgroongaの言語バインディングなどを開発することがあるでしょう。
         
     | 
| 
       29266 
29614 
     | 
    
         
             
            .SS Travis CI
         
     | 
| 
       29267 
29615 
     | 
    
         
             
            .sp
         
     | 
| 
       29268 
     | 
    
         
            -
            このセクションでは \fI\%Travis CI\fP 上で 
     | 
| 
      
 29616 
     | 
    
         
            +
            このセクションでは \fI\%Travis CI\fP 上でGroongaを使う方法について説明します。Travis CIはオープンソースコミュニティ用の継続的インテグレーション(CI)サービスです。
         
     | 
| 
       29269 
29617 
     | 
    
         
             
            .sp
         
     | 
| 
       29270 
     | 
    
         
            -
            オープンソースソフトウェアを開発しているならTravis CIを使えます。このセクションでは 
     | 
| 
      
 29618 
     | 
    
         
            +
            オープンソースソフトウェアを開発しているならTravis CIを使えます。このセクションではGroonga関連の設定のみ説明します。Travis CI一般については \fI\%Travis CI: Documentation\fP を読んでください。
         
     | 
| 
       29271 
29619 
     | 
    
         
             
            .SS 設定
         
     | 
| 
       29272 
29620 
     | 
    
         
             
            .sp
         
     | 
| 
       29273 
     | 
    
         
            -
            Travis CIは 
     | 
| 
      
 29621 
     | 
    
         
            +
            Travis CIは64\-bit版のUbuntu 12.04 LTS サーバ版を使っています。( \fI\%Travis CI: About Travis CI Environment\fP 参照。)Travis CIにGroongaをインストールするために、Groongaプロジェクトが提供しているUbuntu 12.04 LTS用のapt\-lineを使えます。
         
     | 
| 
       29274 
29622 
     | 
    
         
             
            .sp
         
     | 
| 
       29275 
29623 
     | 
    
         
             
            \fB.travis.yml\fP でビルド方法を変更することができます。( \fI\%Travis CI: Conifugration your Travis CI build with .travis.yml\fP 参照。) \fBbefore_install\fP フックまたは \fBinstall\fP フックを使います。もし、Travis CIがサポートしている言語(例えばRuby)を使ったソフトウェアの場合は \fBbefore_install\fP を使います。そうでない場合は \fBinstall\fP を使います。
         
     | 
| 
       29276 
29624 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -29289,10 +29637,10 @@ before_install: 
     | 
|
| 
       29289 
29637 
     | 
    
         
             
            .sp
         
     | 
| 
       29290 
29638 
     | 
    
         
             
            \fBbefore_install\fP フックではなく \fBinstall\fP フックを使わなければいけない場合は、単に \fBbefore_install:\fP を \fBinstall:\fP に書き換えてください。
         
     | 
| 
       29291 
29639 
     | 
    
         
             
            .sp
         
     | 
| 
       29292 
     | 
    
         
            -
            上記の設定でビルド中に 
     | 
| 
      
 29640 
     | 
    
         
            +
            上記の設定でビルド中にGroongaを使えるようになります。
         
     | 
| 
       29293 
29641 
     | 
    
         
             
            .SS 例
         
     | 
| 
       29294 
29642 
     | 
    
         
             
            .sp
         
     | 
| 
       29295 
     | 
    
         
            -
            Travis CI上で 
     | 
| 
      
 29643 
     | 
    
         
            +
            Travis CI上でGroongaを使っているオープンソースソフトウェアは以下の通りです
         
     | 
| 
       29296 
29644 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       29297 
29645 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       29298 
29646 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -29325,14 +29673,14 @@ Travis CI上でgroongaを使っているオープンソースソフトウェア 
     | 
|
| 
       29325 
29673 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       29326 
29674 
     | 
    
         
             
            .SH GROONGAへのコントリビュート方法
         
     | 
| 
       29327 
29675 
     | 
    
         
             
            .sp
         
     | 
| 
       29328 
     | 
    
         
            -
             
     | 
| 
      
 29676 
     | 
    
         
            +
            Groongaプロジェクトではみなさんからのコントリビュートを歓迎します!コントリビュートの方法はいくつもあります。Groongaを使ったり誰かに紹介することもコントリビュートですし、バグレポートを送ったり、Groonga本体やGroonga関連の開発に参加することもコントリビュートです。プログラムではなく、ドキュメントでのコントリビュートも歓迎します!
         
     | 
| 
       29329 
29677 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       29330 
29678 
     | 
    
         
             
            .TP
         
     | 
| 
       29331 
29679 
     | 
    
         
             
            .B ユーザーの立場で:
         
     | 
| 
       29332 
29680 
     | 
    
         
             
            このドキュメントを読んでください。
         
     | 
| 
       29333 
29681 
     | 
    
         
             
            .TP
         
     | 
| 
       29334 
29682 
     | 
    
         
             
            .B 布教する立場で:
         
     | 
| 
       29335 
     | 
    
         
            -
             
     | 
| 
      
 29683 
     | 
    
         
            +
            Groongaについてまわりの人に話してください。
         
     | 
| 
       29336 
29684 
     | 
    
         
             
            .TP
         
     | 
| 
       29337 
29685 
     | 
    
         
             
            .B 開発者の立場で: 不具合報告や開発、ドキュメント
         
     | 
| 
       29338 
29686 
     | 
    
         
             
            これらについてはこのセクションで説明します。
         
     | 
| 
         @@ -29354,202 +29702,450 @@ groongaについてまわりの人に話してください。 
     | 
|
| 
       29354 
29702 
     | 
    
         
             
            どちらのやり方でも大丈夫です。
         
     | 
| 
       29355 
29703 
     | 
    
         
             
            .SS 課題追跡システムへ登録する
         
     | 
| 
       29356 
29704 
     | 
    
         
             
            .sp
         
     | 
| 
       29357 
     | 
    
         
            -
             
     | 
| 
      
 29705 
     | 
    
         
            +
            Groonga用の課題追跡システム(ITS, Issue Tracking System)が2つあります。1つは \fI\%Redmine\fP でもう1つは \fI\%GitHub issue tracker\fP です。Redmineは日本語で、GitHub issue trackerは英語を使っています。どちらにバグレポートをしても大丈夫です。
         
     | 
| 
       29358 
29706 
     | 
    
         
             
            .SS メーリングリストへ報告する
         
     | 
| 
       29359 
29707 
     | 
    
         
             
            .sp
         
     | 
| 
       29360 
     | 
    
         
            -
             
     | 
| 
       29361 
     | 
    
         
            -
            .SS  
     | 
| 
       29362 
     | 
    
         
            -
            .SS リポジトリ
         
     | 
| 
       29363 
     | 
    
         
            -
            .sp
         
     | 
| 
       29364 
     | 
    
         
            -
            groongaのリポジトリは \fI\%GitHub\fP 上にあります。次のコマンドでcloneできます。
         
     | 
| 
       29365 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       29366 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
      
 29708 
     | 
    
         
            +
            GroongaプロジェクトではGroongaについて議論するための \fB/community\fP があります。バグを説明したメールを送ってください。
         
     | 
| 
      
 29709 
     | 
    
         
            +
            .SS ドキュメント関連のコントリビュート方法
         
     | 
| 
       29367 
29710 
     | 
    
         
             
            .sp
         
     | 
| 
       29368 
     | 
    
         
            -
             
     | 
| 
       29369 
     | 
    
         
            -
            . 
     | 
| 
       29370 
     | 
    
         
            -
            % git clone git://github.com/groonga/groonga.git
         
     | 
| 
       29371 
     | 
    
         
            -
            .ft P
         
     | 
| 
       29372 
     | 
    
         
            -
            .fi
         
     | 
| 
       29373 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       29374 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
      
 29711 
     | 
    
         
            +
            ドキュメントツールとして \fI\%Sphinx\fP を使います。
         
     | 
| 
      
 29712 
     | 
    
         
            +
            .SS C API
         
     | 
| 
       29375 
29713 
     | 
    
         
             
            .sp
         
     | 
| 
       29376 
     | 
    
         
            -
             
     | 
| 
       29377 
     | 
    
         
            -
            .SS groonga 通信アーキテクチャ
         
     | 
| 
       29378 
     | 
    
         
            -
            .SS gqtpでのアーキテクチャ
         
     | 
| 
       29379 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       29380 
     | 
    
         
            -
            .IP \(bu 2
         
     | 
| 
       29381 
     | 
    
         
            -
            comが外部からの接続を受け付ける。
         
     | 
| 
       29382 
     | 
    
         
            -
            .IP \(bu 2
         
     | 
| 
       29383 
     | 
    
         
            -
            comは1スレッド。
         
     | 
| 
       29384 
     | 
    
         
            -
            .IP \(bu 2
         
     | 
| 
       29385 
     | 
    
         
            -
            comがedgeを作る。
         
     | 
| 
       29386 
     | 
    
         
            -
            .IP \(bu 2
         
     | 
| 
       29387 
     | 
    
         
            -
            edgeは接続と1対1対応。
         
     | 
| 
       29388 
     | 
    
         
            -
            .IP \(bu 2
         
     | 
| 
       29389 
     | 
    
         
            -
            edgeはctxを含む。
         
     | 
| 
       29390 
     | 
    
         
            -
            .IP \(bu 2
         
     | 
| 
       29391 
     | 
    
         
            -
            workerはthreadと1対1対応。
         
     | 
| 
       29392 
     | 
    
         
            -
            .IP \(bu 2
         
     | 
| 
       29393 
     | 
    
         
            -
            workerは上限が個定数。
         
     | 
| 
       29394 
     | 
    
         
            -
            .IP \(bu 2
         
     | 
| 
       29395 
     | 
    
         
            -
            workerは、1つのedgeと結びつくことができる。
         
     | 
| 
       29396 
     | 
    
         
            -
            .IP \(bu 2
         
     | 
| 
       29397 
     | 
    
         
            -
            edgeごとにqueueを持つ。
         
     | 
| 
       29398 
     | 
    
         
            -
            .IP \(bu 2
         
     | 
| 
       29399 
     | 
    
         
            -
            msgはcomによって、edgeのqueueにenqueueされる。
         
     | 
| 
       29400 
     | 
    
         
            -
            edgeがworkerに結びついていないときは、同時に、ctx_newというqueueに、msgをenqueueした対象のedgeをenqueueする。
         
     | 
| 
       29401 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       29402 
     | 
    
         
            -
            .SS ユーザーと協力して開発をうまく進めていくための指針
         
     | 
| 
      
 29714 
     | 
    
         
            +
            今のところ、C APIのドキュメントはinclude/groonga.hにありますが、これをdoc/source/c\-api/*.txtに移動したいと思っています。C APIのドキュメントを移動して、パッチを送ってくれるととても喜びます。
         
     | 
| 
       29403 
29715 
     | 
    
         
             
            .sp
         
     | 
| 
       29404 
     | 
    
         
            -
             
     | 
| 
       29405 
     | 
    
         
            -
             
     | 
| 
       29406 
     | 
    
         
            -
            まとめておくと、新しく開発に加わる人とも共有することができます。
         
     | 
| 
       29407 
     | 
    
         
            -
            .SS twitter編
         
     | 
| 
      
 29716 
     | 
    
         
            +
            Sphinxの \fI\%the C domain markup\fP を使う予定です。
         
     | 
| 
      
 29717 
     | 
    
         
            +
            .SS 国際化
         
     | 
| 
       29408 
29718 
     | 
    
         
             
            .sp
         
     | 
| 
       29409 
     | 
    
         
            -
             
     | 
| 
       29410 
     | 
    
         
            -
            日々、リリースの案内をしたり、ユーザーサポートをしたりしています。
         
     | 
| 
      
 29719 
     | 
    
         
            +
            今のところ、Groongaには日本語でのドキュメントしかありません。1.2.2からgettextベースの \fI\%Sphinx I18N feature\fP を使ってドキュメントの国際化対応を始めました。この仕組みではベースの言語として英語を使い、日本語などの他の言語には英語からその言語に翻訳します。すべてのドキュメントはdoc/source/以下において、それをSphinxで処理します。
         
     | 
| 
       29411 
29720 
     | 
    
         
             
            .sp
         
     | 
| 
       29412 
     | 
    
         
            -
             
     | 
| 
       29413 
     | 
    
         
            -
             
     | 
| 
       29414 
     | 
    
         
            -
            良いのか/どうしてそうするのかという共通認識を持っていないと一貫性のないサポートとなってしま
         
     | 
| 
       29415 
     | 
    
         
            -
            います。
         
     | 
| 
      
 29721 
     | 
    
         
            +
            しかし、今のところ、doc/source/では日本語を使っています。そのため、まずは、doc/source/以下にある日本語のドキュメントを英語に翻訳する必要があります。ドキュメントを翻訳して、パッチを送ってくれるととても喜びます。
         
     | 
| 
      
 29722 
     | 
    
         
            +
            .SS 翻訳の流れ
         
     | 
| 
       29416 
29723 
     | 
    
         
             
            .sp
         
     | 
| 
       29417 
     | 
    
         
            -
             
     | 
| 
       29418 
     | 
    
         
            -
            ことができるようにサポートの際に気をつけることをまとめます。
         
     | 
| 
       29419 
     | 
    
         
            -
            .SS 過去のツイートはおさらいしておく
         
     | 
| 
       29420 
     | 
    
         
            -
            .SS 理由
         
     | 
| 
      
 29724 
     | 
    
         
            +
            doc/source/*.txtを更新したら、翻訳を始めます。
         
     | 
| 
       29421 
29725 
     | 
    
         
             
            .sp
         
     | 
| 
       29422 
     | 
    
         
            -
             
     | 
| 
       29423 
     | 
    
         
            -
            . 
     | 
| 
      
 29726 
     | 
    
         
            +
            これが翻訳の流れです:
         
     | 
| 
      
 29727 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 29728 
     | 
    
         
            +
            .IP 1. 3
         
     | 
| 
      
 29729 
     | 
    
         
            +
            Groongaのリポジトリをcloneします。
         
     | 
| 
      
 29730 
     | 
    
         
            +
            .IP 2. 3
         
     | 
| 
      
 29731 
     | 
    
         
            +
            .poファイルを更新します。
         
     | 
| 
      
 29732 
     | 
    
         
            +
            .IP 3. 3
         
     | 
| 
      
 29733 
     | 
    
         
            +
            .poファイルを編集します。
         
     | 
| 
      
 29734 
     | 
    
         
            +
            .IP 4. 3
         
     | 
| 
      
 29735 
     | 
    
         
            +
            HTMLファイルを生成します。
         
     | 
| 
      
 29736 
     | 
    
         
            +
            .IP 5. 3
         
     | 
| 
      
 29737 
     | 
    
         
            +
            HTMLの出力を確認します。
         
     | 
| 
      
 29738 
     | 
    
         
            +
            .IP 6. 3
         
     | 
| 
      
 29739 
     | 
    
         
            +
            翻訳が完了するまで、2.\-4.を繰り返します。
         
     | 
| 
      
 29740 
     | 
    
         
            +
            .IP 7. 3
         
     | 
| 
      
 29741 
     | 
    
         
            +
            翻訳作業の成果をGroongaプロジェクトに送ってください!
         
     | 
| 
      
 29742 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
       29424 
29743 
     | 
    
         
             
            .sp
         
     | 
| 
       29425 
     | 
    
         
            -
             
     | 
| 
      
 29744 
     | 
    
         
            +
            上記の流れを実行するコマンドラインです。詳細は以降のセクションで説明します。
         
     | 
| 
       29426 
29745 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       29427 
29746 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       29428 
29747 
     | 
    
         
             
            .sp
         
     | 
| 
       29429 
29748 
     | 
    
         
             
            .nf
         
     | 
| 
       29430 
29749 
     | 
    
         
             
            .ft C
         
     | 
| 
       29431 
     | 
    
         
            -
             
     | 
| 
      
 29750 
     | 
    
         
            +
            # Please fork https://github.com/groonga/groonga on GitHub
         
     | 
| 
      
 29751 
     | 
    
         
            +
            % git clone https://github.com/${YOUR_GITHUB_ACCOUNT}/groonga.git
         
     | 
| 
      
 29752 
     | 
    
         
            +
            % ./autogen.sh
         
     | 
| 
      
 29753 
     | 
    
         
            +
            % ./configure
         
     | 
| 
      
 29754 
     | 
    
         
            +
            % cd doc/locale/${LANGUAGE}/LC_MESSAGES # ${LANGUAGE} is language code such as \(aqja\(aq.
         
     | 
| 
      
 29755 
     | 
    
         
            +
            % make update # *.po are updated
         
     | 
| 
      
 29756 
     | 
    
         
            +
            % editor *.po # translate *.po # you can use your favorite editor
         
     | 
| 
      
 29757 
     | 
    
         
            +
            % cd ..
         
     | 
| 
      
 29758 
     | 
    
         
            +
            % make html
         
     | 
| 
      
 29759 
     | 
    
         
            +
            % browser html/index.html # confirm translation
         
     | 
| 
      
 29760 
     | 
    
         
            +
            % git add LC_MESSAGES/*.po
         
     | 
| 
      
 29761 
     | 
    
         
            +
            % git commit
         
     | 
| 
      
 29762 
     | 
    
         
            +
            % git push
         
     | 
| 
       29432 
29763 
     | 
    
         
             
            .ft P
         
     | 
| 
       29433 
29764 
     | 
    
         
             
            .fi
         
     | 
| 
       29434 
29765 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       29435 
29766 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       29436 
     | 
    
         
            -
            .SS  
     | 
| 
       29437 
     | 
    
         
            -
            .SS 理由
         
     | 
| 
       29438 
     | 
    
         
            -
            .sp
         
     | 
| 
       29439 
     | 
    
         
            -
            困っているユーザーが複数回ツイートして限られたなかで情報を提供してくれていることがあります。
         
     | 
| 
       29440 
     | 
    
         
            -
            その限られたツイートから解決方法が見つかればユーザーにとって余計な手間が少なくて済みます。
         
     | 
| 
       29441 
     | 
    
         
            -
            あれこれ情報提供を要求すると、ユーザーはそのぶん確認する作業が必要になります。
         
     | 
| 
       29442 
     | 
    
         
            -
            .SS 対応
         
     | 
| 
      
 29767 
     | 
    
         
            +
            .SS Groongaリポジトリのcloneの仕方
         
     | 
| 
       29443 
29768 
     | 
    
         
             
            .sp
         
     | 
| 
       29444 
     | 
    
         
            -
             
     | 
| 
      
 29769 
     | 
    
         
            +
            はじめに、GitHub上のGroongaリポジトリをforkしてください。 \fI\%https://github.com/groonga/groonga\fP にアクセスして \fIFork\fP ボタンを押すだけです。これで自分のGroongaリポジトリをcloneすることができます。:
         
     | 
| 
       29445 
29770 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       29446 
29771 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       29447 
29772 
     | 
    
         
             
            .sp
         
     | 
| 
       29448 
29773 
     | 
    
         
             
            .nf
         
     | 
| 
       29449 
29774 
     | 
    
         
             
            .ft C
         
     | 
| 
       29450 
     | 
    
         
            -
             
     | 
| 
      
 29775 
     | 
    
         
            +
            % git clone https://github.com/${YOUR_GITHUB_ACCOUNT}/groonga.git
         
     | 
| 
       29451 
29776 
     | 
    
         
             
            .ft P
         
     | 
| 
       29452 
29777 
     | 
    
         
             
            .fi
         
     | 
| 
       29453 
29778 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       29454 
29779 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       29455 
     | 
    
         
            -
            .SS twitterでのやりとりはできるだけ他の場所(例えばredmine)へと誘導しない
         
     | 
| 
       29456 
     | 
    
         
            -
            .SS 理由
         
     | 
| 
       29457 
     | 
    
         
            -
            .sp
         
     | 
| 
       29458 
     | 
    
         
            -
            twitterは気軽につぶやけることが重要なので、気軽にできないことを相手に要求すると萎縮されてしまう可能性があります。
         
     | 
| 
       29459 
29780 
     | 
    
         
             
            .sp
         
     | 
| 
       29460 
     | 
    
         
            -
             
     | 
| 
      
 29781 
     | 
    
         
            +
            cloneした後はconfigureする必要があります。:
         
     | 
| 
       29461 
29782 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       29462 
29783 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       29463 
29784 
     | 
    
         
             
            .sp
         
     | 
| 
       29464 
29785 
     | 
    
         
             
            .nf
         
     | 
| 
       29465 
29786 
     | 
    
         
             
            .ft C
         
     | 
| 
       29466 
     | 
    
         
            -
             
     | 
| 
      
 29787 
     | 
    
         
            +
            % cd groonga
         
     | 
| 
      
 29788 
     | 
    
         
            +
            % ./autogen.sh
         
     | 
| 
      
 29789 
     | 
    
         
            +
            % ./configure
         
     | 
| 
       29467 
29790 
     | 
    
         
             
            .ft P
         
     | 
| 
       29468 
29791 
     | 
    
         
             
            .fi
         
     | 
| 
       29469 
29792 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       29470 
29793 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       29471 
29794 
     | 
    
         
             
            .sp
         
     | 
| 
       29472 
     | 
    
         
            -
             
     | 
| 
       29473 
     | 
    
         
            -
            てしまいます。
         
     | 
| 
       29474 
     | 
    
         
            -
            .SS 対応
         
     | 
| 
      
 29795 
     | 
    
         
            +
            この作業は初回セットアップ時のみだけの作業です。
         
     | 
| 
       29475 
29796 
     | 
    
         
             
            .sp
         
     | 
| 
       29476 
     | 
    
         
            -
             
     | 
| 
       29477 
     | 
    
         
            -
            .SS  
     | 
| 
       29478 
     | 
    
         
            -
            .SS Sphinxのインストール
         
     | 
| 
      
 29797 
     | 
    
         
            +
            以上の作業で問題があった場合は、 \fI\%http://packages.groonga.org/source/groonga/\fP にあるソースファイルを利用してもよいです。
         
     | 
| 
      
 29798 
     | 
    
         
            +
            .SS .poファイルの更新の仕方
         
     | 
| 
       29479 
29799 
     | 
    
         
             
            .sp
         
     | 
| 
       29480 
     | 
    
         
            -
             
     | 
| 
      
 29800 
     | 
    
         
            +
            doc/locale/${LANGUAGE}/LC_MESSAGESディレクトリで \fImake update\fP を実行すると.poファイルを更新できます。(\fI${LANGUAGE}\fP は\(aqja\(aqなど自分の言語の言語コードに置き換えてください。):
         
     | 
| 
       29481 
29801 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       29482 
29802 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       29483 
29803 
     | 
    
         
             
            .sp
         
     | 
| 
       29484 
29804 
     | 
    
         
             
            .nf
         
     | 
| 
       29485 
29805 
     | 
    
         
             
            .ft C
         
     | 
| 
       29486 
     | 
    
         
            -
             
     | 
| 
       29487 
     | 
    
         
            -
             
     | 
| 
      
 29806 
     | 
    
         
            +
            % cd doc/locale/ja/LC_MESSAGES
         
     | 
| 
      
 29807 
     | 
    
         
            +
            % make update
         
     | 
| 
       29488 
29808 
     | 
    
         
             
            .ft P
         
     | 
| 
       29489 
29809 
     | 
    
         
             
            .fi
         
     | 
| 
       29490 
29810 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       29491 
29811 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       29492 
     | 
    
         
            -
            .SS  
     | 
| 
      
 29812 
     | 
    
         
            +
            .SS .poの編集の仕方
         
     | 
| 
       29493 
29813 
     | 
    
         
             
            .sp
         
     | 
| 
       29494 
     | 
    
         
            -
             
     | 
| 
      
 29814 
     | 
    
         
            +
            .poファイルを編集するためのツールがあります。.poファイルは単なるテキストなので好きなエディタで編集できます。以下は.poファイルの編集に特化したエディタのリストです。
         
     | 
| 
      
 29815 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 29816 
     | 
    
         
            +
            .TP
         
     | 
| 
      
 29817 
     | 
    
         
            +
            .B Emacs\(aqs \fI\%po\-mode\fP
         
     | 
| 
      
 29818 
     | 
    
         
            +
            gettextに同梱されています。
         
     | 
| 
      
 29819 
     | 
    
         
            +
            .TP
         
     | 
| 
      
 29820 
     | 
    
         
            +
            .B \fI\%Poedit\fP
         
     | 
| 
      
 29821 
     | 
    
         
            +
            .po専用エディタです。たくさんのプラットフォームで動作します。
         
     | 
| 
      
 29822 
     | 
    
         
            +
            .TP
         
     | 
| 
      
 29823 
     | 
    
         
            +
            .B gted
         
     | 
| 
      
 29824 
     | 
    
         
            +
            これも.po専用エディタです。Eclipseプラグインとして実装されています。
         
     | 
| 
      
 29825 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 29826 
     | 
    
         
            +
            .SS HTMLファイルの生成方法
         
     | 
| 
      
 29827 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 29828 
     | 
    
         
            +
            doc/locale/${LANGUAGE}ディレクトリで \fImake html\fP を実行すると更新した.poファイルを使ってHTMLファイルを生成できます。(\fI${LANGUAGE}\fP は\(aqja\(aqなど自分の言語の言語コードに置き換えてください。):
         
     | 
| 
       29495 
29829 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       29496 
29830 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       29497 
29831 
     | 
    
         
             
            .sp
         
     | 
| 
       29498 
29832 
     | 
    
         
             
            .nf
         
     | 
| 
       29499 
29833 
     | 
    
         
             
            .ft C
         
     | 
| 
      
 29834 
     | 
    
         
            +
            % cd doc/locale/ja/
         
     | 
| 
       29500 
29835 
     | 
    
         
             
            % make html
         
     | 
| 
       29501 
29836 
     | 
    
         
             
            .ft P
         
     | 
| 
       29502 
29837 
     | 
    
         
             
            .fi
         
     | 
| 
       29503 
29838 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       29504 
29839 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       29505 
29840 
     | 
    
         
             
            .sp
         
     | 
| 
       29506 
     | 
    
         
            -
             
     | 
| 
       29507 
     | 
    
         
            -
            .SS pdfの作成
         
     | 
| 
       29508 
     | 
    
         
            -
            .sp
         
     | 
| 
       29509 
     | 
    
         
            -
            groongaのドキュメントは、pdf出力することもできます。rst2pdfと、IPAフォント(IPA Gothic/IPAexGothic)が必要となります。
         
     | 
| 
       29510 
     | 
    
         
            -
            .SS rst2pdfのインストール
         
     | 
| 
       29511 
     | 
    
         
            -
            .sp
         
     | 
| 
       29512 
     | 
    
         
            -
            以下のようにしてインストールできます。:
         
     | 
| 
      
 29841 
     | 
    
         
            +
            全ての言語のHTMLファイルを生成するにはdoc/locale/ディレクトリで \fImake html\fP を実行します。:
         
     | 
| 
       29513 
29842 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       29514 
29843 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       29515 
29844 
     | 
    
         
             
            .sp
         
     | 
| 
       29516 
29845 
     | 
    
         
             
            .nf
         
     | 
| 
       29517 
29846 
     | 
    
         
             
            .ft C
         
     | 
| 
       29518 
     | 
    
         
            -
             
     | 
| 
      
 29847 
     | 
    
         
            +
            % cd doc/locale
         
     | 
| 
      
 29848 
     | 
    
         
            +
            % make html
         
     | 
| 
       29519 
29849 
     | 
    
         
             
            .ft P
         
     | 
| 
       29520 
29850 
     | 
    
         
             
            .fi
         
     | 
| 
       29521 
29851 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       29522 
29852 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       29523 
     | 
    
         
            -
            .SS pdfの作成
         
     | 
| 
       29524 
29853 
     | 
    
         
             
            .sp
         
     | 
| 
       29525 
     | 
    
         
            -
             
     | 
| 
      
 29854 
     | 
    
         
            +
            \fBノート:\fP
         
     | 
| 
      
 29855 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 29856 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 29857 
     | 
    
         
            +
            .moファイルは \fImake html\fP で自動的に更新されるので、.moファイルのことを気にする必要はありません。
         
     | 
| 
      
 29858 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 29859 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 29860 
     | 
    
         
            +
            .SS HTML出力の確認の仕方
         
     | 
| 
      
 29861 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 29862 
     | 
    
         
            +
            HTMLファイルはdoc/locale/${LANGUAGE}/html/以下に出力されます。(\fI${LANGUAGE}\fP は\(aqja\(aqなど自分の言語の言語コードに置き換えてください。)好きなブラウザで出力されたHTMLを確認してください。:
         
     | 
| 
       29526 
29863 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       29527 
29864 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       29528 
29865 
     | 
    
         
             
            .sp
         
     | 
| 
       29529 
29866 
     | 
    
         
             
            .nf
         
     | 
| 
       29530 
29867 
     | 
    
         
             
            .ft C
         
     | 
| 
       29531 
     | 
    
         
            -
            %  
     | 
| 
      
 29868 
     | 
    
         
            +
            % firefox doc/locale/ja/html/index.html
         
     | 
| 
       29532 
29869 
     | 
    
         
             
            .ft P
         
     | 
| 
       29533 
29870 
     | 
    
         
             
            .fi
         
     | 
| 
       29534 
29871 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       29535 
29872 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       29536 
     | 
    
         
            -
            .SS  
     | 
| 
      
 29873 
     | 
    
         
            +
            .SS 翻訳の成果の送り方
         
     | 
| 
       29537 
29874 
     | 
    
         
             
            .sp
         
     | 
| 
       29538 
     | 
    
         
            -
             
     | 
| 
       29539 
     | 
    
         
            -
            .SS  
     | 
| 
      
 29875 
     | 
    
         
            +
            翻訳の成果はGitHubのpull requestかメールで送ってください。メールで送る場合はパッチでも.poファイルそのものでも構いません。
         
     | 
| 
      
 29876 
     | 
    
         
            +
            .SS pull requestの送り方
         
     | 
| 
      
 29877 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 29878 
     | 
    
         
            +
            pull requestを送るためのコマンドライン:
         
     | 
| 
      
 29879 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 29880 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 29881 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 29882 
     | 
    
         
            +
            .nf
         
     | 
| 
      
 29883 
     | 
    
         
            +
            .ft C
         
     | 
| 
      
 29884 
     | 
    
         
            +
            % git add doc/locale/ja/LC_MESSAGES/*.po
         
     | 
| 
      
 29885 
     | 
    
         
            +
            % git commit
         
     | 
| 
      
 29886 
     | 
    
         
            +
            % git push
         
     | 
| 
      
 29887 
     | 
    
         
            +
            .ft P
         
     | 
| 
      
 29888 
     | 
    
         
            +
            .fi
         
     | 
| 
      
 29889 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 29890 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 29891 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 29892 
     | 
    
         
            +
            これでGitHub上でpull requestを送る準備ができました。あとは、GitHub上の自分のリポジトリのページへアクセスして \fIPull Request\fP ボタンを押すだけです。
         
     | 
| 
      
 29893 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 29894 
     | 
    
         
            +
            \fB参考:\fP
         
     | 
| 
      
 29895 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 29896 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 29897 
     | 
    
         
            +
            pull requestの送り方
         
     | 
| 
      
 29898 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 29899 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 29900 
     | 
    
         
            +
            .SS パッチの送り方
         
     | 
| 
      
 29901 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 29902 
     | 
    
         
            +
            パッチを作るためのコマンドライン
         
     | 
| 
      
 29903 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 29904 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 29905 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 29906 
     | 
    
         
            +
            .nf
         
     | 
| 
      
 29907 
     | 
    
         
            +
            .ft C
         
     | 
| 
      
 29908 
     | 
    
         
            +
            % git add doc/locale/ja/LC_MESSAGES/*.po
         
     | 
| 
      
 29909 
     | 
    
         
            +
            % git commit
         
     | 
| 
      
 29910 
     | 
    
         
            +
            % git format\-patch origin/master
         
     | 
| 
      
 29911 
     | 
    
         
            +
            .ft P
         
     | 
| 
      
 29912 
     | 
    
         
            +
            .fi
         
     | 
| 
      
 29913 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 29914 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 29915 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 29916 
     | 
    
         
            +
            カレントディレクトリに000X\-YYY.patchという名前のファイルができていると思います。これをGroongaプロジェクトに送ってください!
         
     | 
| 
      
 29917 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 29918 
     | 
    
         
            +
            \fB参考:\fP
         
     | 
| 
      
 29919 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 29920 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 29921 
     | 
    
         
            +
            \fB/community\fP に連絡先の情報があります。
         
     | 
| 
      
 29922 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 29923 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 29924 
     | 
    
         
            +
            .SS .poファイルの送り方
         
     | 
| 
      
 29925 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 29926 
     | 
    
         
            +
            doc/locale/${LANGUAGE}/LC_MESSAGES/以下を.tar.gzや.zipなどでアーカイブにしてGroongaプロジェクトに送ってください!(\fI${LANGUAGE}\fP は\(aqja\(aqなど自分の言語の言語コードに置き換えてください。)こちらでアーカイブの中の内容をマージします。
         
     | 
| 
      
 29927 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 29928 
     | 
    
         
            +
            \fB参考:\fP
         
     | 
| 
      
 29929 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 29930 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 29931 
     | 
    
         
            +
            \fB/community\fP に連絡先の情報があります。
         
     | 
| 
      
 29932 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 29933 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 29934 
     | 
    
         
            +
            .SS 新しい言語の追加方法
         
     | 
| 
      
 29935 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 29936 
     | 
    
         
            +
            新しい翻訳対象の言語を追加するコマンドライン:
         
     | 
| 
      
 29937 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 29938 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 29939 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 29940 
     | 
    
         
            +
            .nf
         
     | 
| 
      
 29941 
     | 
    
         
            +
            .ft C
         
     | 
| 
      
 29942 
     | 
    
         
            +
            % cd doc/locale
         
     | 
| 
      
 29943 
     | 
    
         
            +
            % make add LOCALE=${LANGUAGE} # specify your language code such as \(aqde\(aq.
         
     | 
| 
      
 29944 
     | 
    
         
            +
            .ft P
         
     | 
| 
      
 29945 
     | 
    
         
            +
            .fi
         
     | 
| 
      
 29946 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 29947 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 29948 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 29949 
     | 
    
         
            +
            \fI${LANGUAGE}\fP は\(aqja\(aqなどの自分の言語の言語コードに置き換えてください。
         
     | 
| 
      
 29950 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 29951 
     | 
    
         
            +
            \fB参考:\fP
         
     | 
| 
      
 29952 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 29953 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 29954 
     | 
    
         
            +
            言語名を表記するためのコード
         
     | 
| 
      
 29955 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 29956 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 29957 
     | 
    
         
            +
            .SS groonga開発者向け情報
         
     | 
| 
      
 29958 
     | 
    
         
            +
            .SS リポジトリ
         
     | 
| 
      
 29959 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 29960 
     | 
    
         
            +
            Groongaのリポジトリは \fI\%GitHub\fP 上にあります。次のコマンドでcloneできます。
         
     | 
| 
      
 29961 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 29962 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 29963 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 29964 
     | 
    
         
            +
            .nf
         
     | 
| 
      
 29965 
     | 
    
         
            +
            .ft C
         
     | 
| 
      
 29966 
     | 
    
         
            +
            % git clone git://github.com/groonga/groonga.git
         
     | 
| 
      
 29967 
     | 
    
         
            +
            .ft P
         
     | 
| 
      
 29968 
     | 
    
         
            +
            .fi
         
     | 
| 
      
 29969 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 29970 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 29971 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 29972 
     | 
    
         
            +
            \fI\%Groonga関係のプロジェクト(grntest, fluent\-plugin\-groongaなど)\fP のリストはリンク先をごらんください。
         
     | 
| 
      
 29973 
     | 
    
         
            +
            .SS Groonga 通信アーキテクチャ
         
     | 
| 
      
 29974 
     | 
    
         
            +
            .SS GQTPでのアーキテクチャ
         
     | 
| 
      
 29975 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 29976 
     | 
    
         
            +
            .IP \(bu 2
         
     | 
| 
      
 29977 
     | 
    
         
            +
            comが外部からの接続を受け付ける。
         
     | 
| 
      
 29978 
     | 
    
         
            +
            .IP \(bu 2
         
     | 
| 
      
 29979 
     | 
    
         
            +
            comは1スレッド。
         
     | 
| 
      
 29980 
     | 
    
         
            +
            .IP \(bu 2
         
     | 
| 
      
 29981 
     | 
    
         
            +
            comがedgeを作る。
         
     | 
| 
      
 29982 
     | 
    
         
            +
            .IP \(bu 2
         
     | 
| 
      
 29983 
     | 
    
         
            +
            edgeは接続と1対1対応。
         
     | 
| 
      
 29984 
     | 
    
         
            +
            .IP \(bu 2
         
     | 
| 
      
 29985 
     | 
    
         
            +
            edgeはctxを含む。
         
     | 
| 
      
 29986 
     | 
    
         
            +
            .IP \(bu 2
         
     | 
| 
      
 29987 
     | 
    
         
            +
            workerはthreadと1対1対応。
         
     | 
| 
      
 29988 
     | 
    
         
            +
            .IP \(bu 2
         
     | 
| 
      
 29989 
     | 
    
         
            +
            workerは上限が個定数。
         
     | 
| 
      
 29990 
     | 
    
         
            +
            .IP \(bu 2
         
     | 
| 
      
 29991 
     | 
    
         
            +
            workerは、1つのedgeと結びつくことができる。
         
     | 
| 
      
 29992 
     | 
    
         
            +
            .IP \(bu 2
         
     | 
| 
      
 29993 
     | 
    
         
            +
            edgeごとにqueueを持つ。
         
     | 
| 
      
 29994 
     | 
    
         
            +
            .IP \(bu 2
         
     | 
| 
      
 29995 
     | 
    
         
            +
            msgはcomによって、edgeのqueueにenqueueされる。
         
     | 
| 
      
 29996 
     | 
    
         
            +
            edgeがworkerに結びついていないときは、同時に、ctx_newというqueueに、msgをenqueueした対象のedgeをenqueueする。
         
     | 
| 
      
 29997 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 29998 
     | 
    
         
            +
            .SS ユーザーと協力して開発をうまく進めていくための指針
         
     | 
| 
      
 29999 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30000 
     | 
    
         
            +
            Groongaを使ってくれているユーザーと協力して
         
     | 
| 
      
 30001 
     | 
    
         
            +
            開発をうまく進めていくためにこうするといい、という事柄をまとめました。
         
     | 
| 
      
 30002 
     | 
    
         
            +
            まとめておくと、新しく開発に加わる人とも共有することができます。
         
     | 
| 
      
 30003 
     | 
    
         
            +
            .SS twitter編
         
     | 
| 
      
 30004 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30005 
     | 
    
         
            +
            Groongaを使ってもらえるようにtwitterのアカウントGroongaを取得して
         
     | 
| 
      
 30006 
     | 
    
         
            +
            日々、リリースの案内をしたり、ユーザーサポートをしたりしています。
         
     | 
| 
      
 30007 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30008 
     | 
    
         
            +
            リリースの案内に利用する場合には、やりとりを考えなくて良いですが、
         
     | 
| 
      
 30009 
     | 
    
         
            +
            複数人によるサポートをGroongaで行う場合に、どうサポートするのが
         
     | 
| 
      
 30010 
     | 
    
         
            +
            良いのか/どうしてそうするのかという共通認識を持っていないと一貫性のないサポートとなってしま
         
     | 
| 
      
 30011 
     | 
    
         
            +
            います。
         
     | 
| 
      
 30012 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30013 
     | 
    
         
            +
            twitterでサポートされている安心感からGroongaユーザーの拡大に繋げる
         
     | 
| 
      
 30014 
     | 
    
         
            +
            ことができるようにサポートの際に気をつけることをまとめます。
         
     | 
| 
      
 30015 
     | 
    
         
            +
            .SS 過去のツイートはおさらいしておく
         
     | 
| 
      
 30016 
     | 
    
         
            +
            .SS 理由
         
     | 
| 
      
 30017 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30018 
     | 
    
         
            +
            自分がツイートした内容を把握していない返信をされたら普通いい気はしません。
         
     | 
| 
      
 30019 
     | 
    
         
            +
            .SS 対応
         
     | 
| 
      
 30020 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30021 
     | 
    
         
            +
            過去のツイートをおさらいし、こうすれば良いという提案をできるのが望ましいです。:
         
     | 
| 
      
 30022 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 30023 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 30024 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30025 
     | 
    
         
            +
            .nf
         
     | 
| 
      
 30026 
     | 
    
         
            +
            .ft C
         
     | 
| 
      
 30027 
     | 
    
         
            +
            良い例: ○○だと原因は□□ですね。××すると大丈夫です。
         
     | 
| 
      
 30028 
     | 
    
         
            +
            .ft P
         
     | 
| 
      
 30029 
     | 
    
         
            +
            .fi
         
     | 
| 
      
 30030 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 30031 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 30032 
     | 
    
         
            +
            .SS こちらから情報を提供する
         
     | 
| 
      
 30033 
     | 
    
         
            +
            .SS 理由
         
     | 
| 
      
 30034 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30035 
     | 
    
         
            +
            困っているユーザーが複数回ツイートして限られたなかで情報を提供してくれていることがあります。
         
     | 
| 
      
 30036 
     | 
    
         
            +
            その限られたツイートから解決方法が見つかればユーザーにとって余計な手間が少なくて済みます。
         
     | 
| 
      
 30037 
     | 
    
         
            +
            あれこれ情報提供を要求すると、ユーザーはそのぶん確認する作業が必要になります。
         
     | 
| 
      
 30038 
     | 
    
         
            +
            .SS 対応
         
     | 
| 
      
 30039 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30040 
     | 
    
         
            +
            最初に声をかけるときに解決策を1つか2つ提案できると望ましいです。ユーザーにあまり負担を感じさせないようにすると良いです。:
         
     | 
| 
      
 30041 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 30042 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 30043 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30044 
     | 
    
         
            +
            .nf
         
     | 
| 
      
 30045 
     | 
    
         
            +
            .ft C
         
     | 
| 
      
 30046 
     | 
    
         
            +
            良い例: ○○の場合は□□の可能性があるので、××を試してもらえますか?
         
     | 
| 
      
 30047 
     | 
    
         
            +
            .ft P
         
     | 
| 
      
 30048 
     | 
    
         
            +
            .fi
         
     | 
| 
      
 30049 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 30050 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 30051 
     | 
    
         
            +
            .SS twitterでのやりとりはできるだけ他の場所(例えばredmine)へと誘導しない
         
     | 
| 
      
 30052 
     | 
    
         
            +
            .SS 理由
         
     | 
| 
      
 30053 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30054 
     | 
    
         
            +
            twitterは気軽につぶやけることが重要なので、気軽にできないことを相手に要求すると萎縮されてしまう可能性があります。
         
     | 
| 
      
 30055 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30056 
     | 
    
         
            +
            いきなりredmineでバグ報告をお願いすると、しりごみしてしまうかも知れません。:
         
     | 
| 
      
 30057 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 30058 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 30059 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30060 
     | 
    
         
            +
            .nf
         
     | 
| 
      
 30061 
     | 
    
         
            +
            .ft C
         
     | 
| 
      
 30062 
     | 
    
         
            +
            駄目な例: 再現手順をMLかredmineに報告してもらえますか?
         
     | 
| 
      
 30063 
     | 
    
         
            +
            .ft P
         
     | 
| 
      
 30064 
     | 
    
         
            +
            .fi
         
     | 
| 
      
 30065 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 30066 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 30067 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30068 
     | 
    
         
            +
            Groonga関連で気軽につぶやけないとなると開発者は困っている人を見つけられないし、利用者は困ったままとなるので、双方にとって嬉しくない状態になっ
         
     | 
| 
      
 30069 
     | 
    
         
            +
            てしまいます。
         
     | 
| 
      
 30070 
     | 
    
         
            +
            .SS 対応
         
     | 
| 
      
 30071 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30072 
     | 
    
         
            +
            twitterでやりとりを完結できるようにします。
         
     | 
| 
      
 30073 
     | 
    
         
            +
            .SS ドキュメント作成
         
     | 
| 
      
 30074 
     | 
    
         
            +
            .SS Sphinxのインストール
         
     | 
| 
      
 30075 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30076 
     | 
    
         
            +
            Groongaのドキュメントは、Sphinxというツールを用いて作成されています。Sphinxは以下のように導入します。:
         
     | 
| 
      
 30077 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 30078 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 30079 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30080 
     | 
    
         
            +
            .nf
         
     | 
| 
      
 30081 
     | 
    
         
            +
            .ft C
         
     | 
| 
      
 30082 
     | 
    
         
            +
            # aptitude install python\-setuptools
         
     | 
| 
      
 30083 
     | 
    
         
            +
            # easy_install \-U sphinx
         
     | 
| 
      
 30084 
     | 
    
         
            +
            .ft P
         
     | 
| 
      
 30085 
     | 
    
         
            +
            .fi
         
     | 
| 
      
 30086 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 30087 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 30088 
     | 
    
         
            +
            .SS htmlの作成
         
     | 
| 
      
 30089 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30090 
     | 
    
         
            +
            以下のコマンドでhtmlが作成されます。:
         
     | 
| 
      
 30091 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 30092 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 30093 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30094 
     | 
    
         
            +
            .nf
         
     | 
| 
      
 30095 
     | 
    
         
            +
            .ft C
         
     | 
| 
      
 30096 
     | 
    
         
            +
            % make html
         
     | 
| 
      
 30097 
     | 
    
         
            +
            .ft P
         
     | 
| 
      
 30098 
     | 
    
         
            +
            .fi
         
     | 
| 
      
 30099 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 30100 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 30101 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30102 
     | 
    
         
            +
            このドキュメントはソースアーカイブの形式で配布され、随時更新しています。最新のドキュメントをソース形式で参照したいなら、GitHubのリポジトリブラウザ経由で閲覧できます。(\fI\%https://github.com/groonga/groonga/tree/master/doc/source\fP)
         
     | 
| 
      
 30103 
     | 
    
         
            +
            .SS pdfの作成
         
     | 
| 
      
 30104 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30105 
     | 
    
         
            +
            Groongaのドキュメントは、pdf出力することもできます。rst2pdfと、IPAフォント(IPA Gothic/IPAexGothic)が必要となります。
         
     | 
| 
      
 30106 
     | 
    
         
            +
            .SS rst2pdfのインストール
         
     | 
| 
      
 30107 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30108 
     | 
    
         
            +
            以下のようにしてインストールできます。:
         
     | 
| 
      
 30109 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 30110 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 30111 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30112 
     | 
    
         
            +
            .nf
         
     | 
| 
      
 30113 
     | 
    
         
            +
            .ft C
         
     | 
| 
      
 30114 
     | 
    
         
            +
            # easy_install rst2pdf
         
     | 
| 
      
 30115 
     | 
    
         
            +
            .ft P
         
     | 
| 
      
 30116 
     | 
    
         
            +
            .fi
         
     | 
| 
      
 30117 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 30118 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 30119 
     | 
    
         
            +
            .SS pdfの作成
         
     | 
| 
      
 30120 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30121 
     | 
    
         
            +
            以下のコマンドでpdfが作成されます。:
         
     | 
| 
      
 30122 
     | 
    
         
            +
            .INDENT 0.0
         
     | 
| 
      
 30123 
     | 
    
         
            +
            .INDENT 3.5
         
     | 
| 
      
 30124 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30125 
     | 
    
         
            +
            .nf
         
     | 
| 
      
 30126 
     | 
    
         
            +
            .ft C
         
     | 
| 
      
 30127 
     | 
    
         
            +
            % make pdf
         
     | 
| 
      
 30128 
     | 
    
         
            +
            .ft P
         
     | 
| 
      
 30129 
     | 
    
         
            +
            .fi
         
     | 
| 
      
 30130 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 30131 
     | 
    
         
            +
            .UNINDENT
         
     | 
| 
      
 30132 
     | 
    
         
            +
            .SS クエリの実現
         
     | 
| 
      
 30133 
     | 
    
         
            +
            .sp
         
     | 
| 
      
 30134 
     | 
    
         
            +
            Groongaのデータベースには大量のデータを格納し、その中から必要な部分を高速に取り出すことができます。必要な部分をGroongaのデータベースに問い合わせるためのクエリの表現と実行に関して、Groongaは複数の手段を用意しています。
         
     | 
| 
      
 30135 
     | 
    
         
            +
            .SS クエリ実行のためのインタフェース
         
     | 
| 
       29540 
30136 
     | 
    
         
             
            .sp
         
     | 
| 
       29541 
     | 
    
         
            -
             
     | 
| 
      
 30137 
     | 
    
         
            +
            Groongaは低機能で単純なライブラリインタフェースから、高機能で複雑なコマンドインタフェースまでいくつかの階層的なインタフェースをユーザプログラムに提供しています。
         
     | 
| 
       29542 
30138 
     | 
    
         
             
            .sp
         
     | 
| 
       29543 
30139 
     | 
    
         
             
            クエリ実行のためのインタフェースも階層的なインタフェースのそれぞれに対応する形で用意されています。以下に低レイヤなインタフェースから順に説明します。
         
     | 
| 
       29544 
30140 
     | 
    
         
             
            .SS DB_API
         
     | 
| 
       29545 
30141 
     | 
    
         
             
            .sp
         
     | 
| 
       29546 
     | 
    
         
            -
            DB_APIは、 
     | 
| 
      
 30142 
     | 
    
         
            +
            DB_APIは、Groongaデータベースを操作するための一群のC言語向けAPI関数を提供します。DB_APIはデータベースを構成する個々の部分に対する単純な操作関数を提供します。DB_APIの機能を組み合わせることによって複雑なクエリを実行することができます。後述のすべてのクエリインタフェースはDB_APIの機能を組み合わせることによって実現されています。
         
     | 
| 
       29547 
30143 
     | 
    
         
             
            .SS grn_expr
         
     | 
| 
       29548 
30144 
     | 
    
         
             
            .sp
         
     | 
| 
       29549 
     | 
    
         
            -
            grn_exprは、 
     | 
| 
       29550 
     | 
    
         
            -
            .SS  
     | 
| 
      
 30145 
     | 
    
         
            +
            grn_exprは、Groongaデータベースに対する検索処理や更新処理のための条件を表現するためのデータ構造で、複数の条件を再帰的に組み合わせてより複雑な条件を表現することができます。grn_exprによって表現されたクエリを実行するためには、grn_table_select()関数を使用します。
         
     | 
| 
      
 30146 
     | 
    
         
            +
            .SS Groonga実行ファイル
         
     | 
| 
       29551 
30147 
     | 
    
         
             
            .sp
         
     | 
| 
       29552 
     | 
    
         
            -
             
     | 
| 
      
 30148 
     | 
    
         
            +
            Groongaデータベースを操作するためのコマンドインタープリタです。渡されたコマンドを解釈し、実行結果を返します。コマンドの実処理はC言語で記述されます。ユーザがC言語で定義した関数を新たなコマンドとしてGroonga実行ファイルに組み込むことができます。各コマンドはいくつかの文字列引数を受け取り、これをクエリとして解釈して実行します。引数をgrn_exprとして解釈するか、別の形式として解釈してDB_APIを使ってデータベースを操作するかはコマンド毎に自由に決めることができます。
         
     | 
| 
       29553 
30149 
     | 
    
         
             
            .SS grn_exprで表現できるクエリ
         
     | 
| 
       29554 
30150 
     | 
    
         
             
            .sp
         
     | 
| 
       29555 
30151 
     | 
    
         
             
            grn_exprは代入や関数呼び出しのような様々な操作を表現できますが、この中で検索クエリを表現するgrn_exprのことを特に条件式とよびます。条件式を構成する個々の要素を関係式と呼びます。条件式は一個以上の関係式か、あるいは条件式を論理演算子で結合したものです。
         
     | 
| 
         @@ -29787,7 +30383,7 @@ CUTTER_SOURCE_PATH=$HOME/work/cutter/cutter 
     | 
|
| 
       29787 
30383 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       29788 
30384 
     | 
    
         
             
            .SS ビルド環境の準備
         
     | 
| 
       29789 
30385 
     | 
    
         
             
            .sp
         
     | 
| 
       29790 
     | 
    
         
            -
            以下に 
     | 
| 
      
 30386 
     | 
    
         
            +
            以下にGroongaのリリース作業を行うために事前にインストール
         
     | 
| 
       29791 
30387 
     | 
    
         
             
            しておくべきパッケージを示します。
         
     | 
| 
       29792 
30388 
     | 
    
         
             
            .sp
         
     | 
| 
       29793 
30389 
     | 
    
         
             
            なお、ビルド環境としては Ubuntu 12.04 LTS(Precise Pangolin)を前提として説明しているため、その他の環境では適宜読み替えて下さい。:
         
     | 
| 
         @@ -29832,7 +30428,7 @@ rinseのバージョンが古いとCentOS 5/6パッケージのビルドを行 
     | 
|
| 
       29832 
30428 
     | 
    
         
             
            リリース作業ではRPMパッケージに対する署名を行います。
         
     | 
| 
       29833 
30429 
     | 
    
         
             
            その際、パッケージ署名用の鍵が必要です。
         
     | 
| 
       29834 
30430 
     | 
    
         
             
            .sp
         
     | 
| 
       29835 
     | 
    
         
            -
             
     | 
| 
      
 30431 
     | 
    
         
            +
            Groongaプロジェクトでは署名用の鍵をリリース担当者の公開鍵で暗号化してリポジトリのpackages/ディレクトリ以下へと登録しています。
         
     | 
| 
       29836 
30432 
     | 
    
         
             
            .sp
         
     | 
| 
       29837 
30433 
     | 
    
         
             
            リリース担当者はリポジトリに登録された秘密鍵を復号した後に鍵のインポートを以下のコマンドにて行います。:
         
     | 
| 
       29838 
30434 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -29849,7 +30445,7 @@ groongaプロジェクトでは署名用の鍵をリリース担当者の公開 
     | 
|
| 
       29849 
30445 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       29850 
30446 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       29851 
30447 
     | 
    
         
             
            .sp
         
     | 
| 
       29852 
     | 
    
         
            -
            鍵のインポートが正常終了すると gpg \-\-list\-keys で 
     | 
| 
      
 30448 
     | 
    
         
            +
            鍵のインポートが正常終了すると gpg \-\-list\-keys でGroongaの署名用の鍵を確認することができます。:
         
     | 
| 
       29853 
30449 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       29854 
30450 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       29855 
30451 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -29885,7 +30481,7 @@ gpg> quit 
     | 
|
| 
       29885 
30481 
     | 
    
         
             
            この作業は、新規にリリースを行うことになった担当者やパッケージに署名する鍵に変更があった場合などに行います。
         
     | 
| 
       29886 
30482 
     | 
    
         
             
            .SS リリース作業用ディレクトリの作成
         
     | 
| 
       29887 
30483 
     | 
    
         
             
            .sp
         
     | 
| 
       29888 
     | 
    
         
            -
             
     | 
| 
      
 30484 
     | 
    
         
            +
            Groongaのリリース作業ではリリース専用の環境下(コンパイルフラグ)でビルドする必要があります。
         
     | 
| 
       29889 
30485 
     | 
    
         
             
            .sp
         
     | 
| 
       29890 
30486 
     | 
    
         
             
            リリース時と開発時でディレクトリを分けずに作業することもできますが、誤ったコンパイルフラグでリリースしてしまう危険があります。
         
     | 
| 
       29891 
30487 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -29936,13 +30532,13 @@ groongaのリリース作業ではリリース専用の環境下(コンパイル 
     | 
|
| 
       29936 
30532 
     | 
    
         
             
            .IP \(bu 2
         
     | 
| 
       29937 
30533 
     | 
    
         
             
            内部的な変更(変数名の変更やらリファクタリング)
         
     | 
| 
       29938 
30534 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       29939 
     | 
    
         
            -
            .SS  
     | 
| 
      
 30535 
     | 
    
         
            +
            .SS Groongaのウェブサイトの取得
         
     | 
| 
       29940 
30536 
     | 
    
         
             
            .sp
         
     | 
| 
       29941 
     | 
    
         
            -
             
     | 
| 
      
 30537 
     | 
    
         
            +
            GroongaのウェブサイトのソースはGroonga同様にgithubにリポジトリを置いています。
         
     | 
| 
       29942 
30538 
     | 
    
         
             
            .sp
         
     | 
| 
       29943 
30539 
     | 
    
         
             
            リリース作業では後述するコマンド(make update\-latest\-release)にてトップページのバージョンを置き換えることができるようになっています。
         
     | 
| 
       29944 
30540 
     | 
    
         
             
            .sp
         
     | 
| 
       29945 
     | 
    
         
            -
             
     | 
| 
      
 30541 
     | 
    
         
            +
            Groongaのウェブサイトのソースコードを$GROONGA_GITHUB_COM_PATHとして取得するためには、$GROONGA_DIRにて以下のコマンドを実行します。:
         
     | 
| 
       29946 
30542 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       29947 
30543 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       29948 
30544 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -29957,7 +30553,7 @@ groongaのウェブサイトのソースコードを$GROONGA_GITHUB_COM_PATHと 
     | 
|
| 
       29957 
30553 
     | 
    
         
             
            これで、$GROONGA_GITHUB_COM_PATHにgroonga.github.comのソースを取得できます。
         
     | 
| 
       29958 
30554 
     | 
    
         
             
            .SS cutterのソースコード取得
         
     | 
| 
       29959 
30555 
     | 
    
         
             
            .sp
         
     | 
| 
       29960 
     | 
    
         
            -
             
     | 
| 
      
 30556 
     | 
    
         
            +
            Groongaのリリース作業では、cutterに含まれるスクリプトを使用しています。
         
     | 
| 
       29961 
30557 
     | 
    
         
             
            .sp
         
     | 
| 
       29962 
30558 
     | 
    
         
             
            そこであらかじめ用意しておいた$HOME/work/cutterディレクトリにてcutterのソースコードを以下のコマンドにて取得します。:
         
     | 
| 
       29963 
30559 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -29974,7 +30570,7 @@ groongaのリリース作業では、cutterに含まれるスクリプトを使 
     | 
|
| 
       29974 
30570 
     | 
    
         
             
            これで、$CUTTER_SOURCE_PATHディレクトリにcutterのソースを取得できます。
         
     | 
| 
       29975 
30571 
     | 
    
         
             
            .SS configureスクリプトの生成
         
     | 
| 
       29976 
30572 
     | 
    
         
             
            .sp
         
     | 
| 
       29977 
     | 
    
         
            -
             
     | 
| 
      
 30573 
     | 
    
         
            +
            Groongaのソースコードをcloneした時点ではconfigureスクリプトが含まれておらず、そのままmakeコマンドにてビルドすることができません。
         
     | 
| 
       29978 
30574 
     | 
    
         
             
            .sp
         
     | 
| 
       29979 
30575 
     | 
    
         
             
            $GROONGA_CLONE_DIRにてautogen.shを以下のように実行します。:
         
     | 
| 
       29980 
30576 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -30005,11 +30601,11 @@ Makefileを生成するためにconfigureスクリプトを実行します。 
     | 
|
| 
       30005 
30601 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       30006 
30602 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       30007 
30603 
     | 
    
         
             
            .sp
         
     | 
| 
       30008 
     | 
    
         
            -
            configureオプションである\-\-with\-groonga\-github\-com\-pathには 
     | 
| 
      
 30604 
     | 
    
         
            +
            configureオプションである\-\-with\-groonga\-github\-com\-pathにはGroongaのウェブサイトのリポジトリをcloneした場所を指定します。
         
     | 
| 
       30009 
30605 
     | 
    
         
             
            .sp
         
     | 
| 
       30010 
30606 
     | 
    
         
             
            configureオプションである\-\-with\-cutter\-source\-pathにはcutterのソースをcloneした場所を指定します。
         
     | 
| 
       30011 
30607 
     | 
    
         
             
            .sp
         
     | 
| 
       30012 
     | 
    
         
            -
            以下のように 
     | 
| 
      
 30608 
     | 
    
         
            +
            以下のようにGroongaのソースコードをcloneした先からの相対パスを指定することもできます。:
         
     | 
| 
       30013 
30609 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       30014 
30610 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       30015 
30611 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -30050,7 +30646,7 @@ make update\-latest\-releaseコマンドでは、OLD_RELEASE_DATEに前回のリ 
     | 
|
| 
       30050 
30646 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       30051 
30647 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       30052 
30648 
     | 
    
         
             
            .sp
         
     | 
| 
       30053 
     | 
    
         
            -
            これにより、clone済みの 
     | 
| 
      
 30649 
     | 
    
         
            +
            これにより、clone済みのGroongaのWebサイトのトップページのソース(index.html,ja/index.html)やRPMパッケージのspecファイルのバージョン表記などが更新されます。
         
     | 
| 
       30054 
30650 
     | 
    
         
             
            .SS make update\-filesの実行
         
     | 
| 
       30055 
30651 
     | 
    
         
             
            .sp
         
     | 
| 
       30056 
30652 
     | 
    
         
             
            ロケールメッセージの更新や変更されたファイルのリスト等を更新するために以下のコマンドを実行します。:
         
     | 
| 
         @@ -30183,7 +30779,7 @@ rpmパッケージのビルドに必要なパッケージをダウンロード 
     | 
|
| 
       30183 
30779 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       30184 
30780 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       30185 
30781 
     | 
    
         
             
            .sp
         
     | 
| 
       30186 
     | 
    
         
            -
            これにより、 
     | 
| 
      
 30782 
     | 
    
         
            +
            これにより、GroongaやMySQLのRPM/SRPMパッケージなどがカレントディレクトリ以下へとダウンロードされます。
         
     | 
| 
       30187 
30783 
     | 
    
         
             
            .sp
         
     | 
| 
       30188 
30784 
     | 
    
         
             
            windowsパッケージのビルドに必要なパッケージをダウンロードするには以下のコマンドを実行します。:
         
     | 
| 
       30189 
30785 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -30198,7 +30794,7 @@ windowsパッケージのビルドに必要なパッケージをダウンロー 
     | 
|
| 
       30198 
30794 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       30199 
30795 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       30200 
30796 
     | 
    
         
             
            .sp
         
     | 
| 
       30201 
     | 
    
         
            -
            これにより、 
     | 
| 
      
 30797 
     | 
    
         
            +
            これにより、Groongaのインストーラやzipアーカイブがカレントディレクトリ以下へとダウンロードされます。
         
     | 
| 
       30202 
30798 
     | 
    
         
             
            .sp
         
     | 
| 
       30203 
30799 
     | 
    
         
             
            sourceパッケージに必要なものをダウンロードするには以下のコマンドを実行します。:
         
     | 
| 
       30204 
30800 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -30217,7 +30813,7 @@ sourceパッケージに必要なものをダウンロードするには以下 
     | 
|
| 
       30217 
30813 
     | 
    
         
             
            packages/source/filesディレクトリ以下へとダウンロードされます。
         
     | 
| 
       30218 
30814 
     | 
    
         
             
            .SS Debian系パッケージのビルド
         
     | 
| 
       30219 
30815 
     | 
    
         
             
            .sp
         
     | 
| 
       30220 
     | 
    
         
            -
             
     | 
| 
      
 30816 
     | 
    
         
            +
            Groongaのpackages/aptサブディレクトリに移動して、以下のコマンドを実行します。:
         
     | 
| 
       30221 
30817 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       30222 
30818 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       30223 
30819 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -30294,7 +30890,7 @@ make build ではまとめてビルドできないこともあります。 
     | 
|
| 
       30294 
30890 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       30295 
30891 
     | 
    
         
             
            .SS Red Hat系パッケージのビルド
         
     | 
| 
       30296 
30892 
     | 
    
         
             
            .sp
         
     | 
| 
       30297 
     | 
    
         
            -
             
     | 
| 
      
 30893 
     | 
    
         
            +
            Groongaのpackages/yumサブディレクトリに移動して、以下のコマンドを実行します。:
         
     | 
| 
       30298 
30894 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       30299 
30895 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       30300 
30896 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -30403,9 +30999,9 @@ Debian系もしくはRed Hat系の場合には本番環境へとアップロー 
     | 
|
| 
       30403 
30999 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       30404 
31000 
     | 
    
         
             
            .SS grntestの準備
         
     | 
| 
       30405 
31001 
     | 
    
         
             
            .sp
         
     | 
| 
       30406 
     | 
    
         
            -
            grntestを実行するためには 
     | 
| 
      
 31002 
     | 
    
         
            +
            grntestを実行するためにはGroongaのテストデータとgrntestのソースが必要です。
         
     | 
| 
       30407 
31003 
     | 
    
         
             
            .sp
         
     | 
| 
       30408 
     | 
    
         
            -
            まず 
     | 
| 
      
 31004 
     | 
    
         
            +
            まずGroongaのソースを任意のディレクトリへと展開します。:
         
     | 
| 
       30409 
31005 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       30410 
31006 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       30411 
31007 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -30417,7 +31013,7 @@ grntestを実行するためにはgroongaのテストデータとgrntestのソ 
     | 
|
| 
       30417 
31013 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       30418 
31014 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       30419 
31015 
     | 
    
         
             
            .sp
         
     | 
| 
       30420 
     | 
    
         
            -
            次に 
     | 
| 
      
 31016 
     | 
    
         
            +
            次にGroongaのtest/functionディレクトリ以下にgrntestのソースを展開します。
         
     | 
| 
       30421 
31017 
     | 
    
         
             
            つまりtest/function/grntestという名前でgrntestのソースを配置します。:
         
     | 
| 
       30422 
31018 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       30423 
31019 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
         @@ -30432,7 +31028,7 @@ README.md  binlib  license  test 
     | 
|
| 
       30432 
31028 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       30433 
31029 
     | 
    
         
             
            .SS grntestの実行方法
         
     | 
| 
       30434 
31030 
     | 
    
         
             
            .sp
         
     | 
| 
       30435 
     | 
    
         
            -
            grntestでは 
     | 
| 
      
 31031 
     | 
    
         
            +
            grntestではGroongaコマンドを明示的にしていすることができます。
         
     | 
| 
       30436 
31032 
     | 
    
         
             
            後述のパッケージごとのgrntestによる動作確認では以下のようにして実行します。:
         
     | 
| 
       30437 
31033 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       30438 
31034 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
         @@ -30509,7 +31105,7 @@ grntestの正常終了を確認する 
     | 
|
| 
       30509 
31105 
     | 
    
         
             
            zipアーカイブも同様にしてgrntestを実行し動作確認を行います。
         
     | 
| 
       30510 
31106 
     | 
    
         
             
            .SS リリースアナウンスの作成
         
     | 
| 
       30511 
31107 
     | 
    
         
             
            .sp
         
     | 
| 
       30512 
     | 
    
         
            -
            リリースの際にはリリースアナウンスを流して、 
     | 
| 
      
 31108 
     | 
    
         
            +
            リリースの際にはリリースアナウンスを流して、Groongaを広く通知します。
         
     | 
| 
       30513 
31109 
     | 
    
         
             
            .sp
         
     | 
| 
       30514 
31110 
     | 
    
         
             
            news.txtに変更点をまとめましたが、それを元にリリースアナウンスを作成します。
         
     | 
| 
       30515 
31111 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -30525,14 +31121,14 @@ news.txtに変更点をまとめましたが、それを元にリリースアナ 
     | 
|
| 
       30525 
31121 
     | 
    
         
             
            リリース変更点(news.txtの内容)
         
     | 
| 
       30526 
31122 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       30527 
31123 
     | 
    
         
             
            .sp
         
     | 
| 
       30528 
     | 
    
         
            -
            リリースのトピック紹介では、これから 
     | 
| 
      
 31124 
     | 
    
         
            +
            リリースのトピック紹介では、これからGroongaを使う人へアピールする点や既存のバージョンを利用している人がアップグレードする際に必要な情報を提供します。
         
     | 
| 
       30529 
31125 
     | 
    
         
             
            .sp
         
     | 
| 
       30530 
31126 
     | 
    
         
             
            非互換な変更が含まれるのであれば、回避方法等の案内を載せることも重要です。
         
     | 
| 
       30531 
31127 
     | 
    
         
             
            .sp
         
     | 
| 
       30532 
31128 
     | 
    
         
             
            参考までに過去のリリースアナウンスへのリンクを以下に示します。
         
     | 
| 
       30533 
31129 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       30534 
31130 
     | 
    
         
             
            .IP \(bu 2
         
     | 
| 
       30535 
     | 
    
         
            -
            [Groonga\-talk] [ANN]  
     | 
| 
      
 31131 
     | 
    
         
            +
            [Groonga\-talk] [ANN] Groonga 2.0.2
         
     | 
| 
       30536 
31132 
     | 
    
         
             
            .INDENT 2.0
         
     | 
| 
       30537 
31133 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       30538 
31134 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -30542,7 +31138,7 @@ news.txtに変更点をまとめましたが、それを元にリリースアナ 
     | 
|
| 
       30542 
31138 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       30543 
31139 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       30544 
31140 
     | 
    
         
             
            .IP \(bu 2
         
     | 
| 
       30545 
     | 
    
         
            -
            [groonga\-dev,00794] [ANN]  
     | 
| 
      
 31141 
     | 
    
         
            +
            [groonga\-dev,00794] [ANN] Groonga 2.0.2
         
     | 
| 
       30546 
31142 
     | 
    
         
             
            .INDENT 2.0
         
     | 
| 
       30547 
31143 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       30548 
31144 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -30693,16 +31289,16 @@ doc/source以下のドキュメントを更新、翻訳まで完了している 
     | 
|
| 
       30693 
31289 
     | 
    
         
             
            .sp
         
     | 
| 
       30694 
31290 
     | 
    
         
             
            OS Xでのパッケージ管理方法として \fI\%Homebrew\fP があります。
         
     | 
| 
       30695 
31291 
     | 
    
         
             
            .sp
         
     | 
| 
       30696 
     | 
    
         
            -
             
     | 
| 
      
 31292 
     | 
    
         
            +
            Groongaを簡単にインストールできるようにするために、Homebrewへpull requestを送ります。
         
     | 
| 
       30697 
31293 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       30698 
31294 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       30699 
31295 
     | 
    
         
             
            \fI\%https://github.com/mxcl/homebrew\fP
         
     | 
| 
       30700 
31296 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       30701 
31297 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       30702 
31298 
     | 
    
         
             
            .sp
         
     | 
| 
       30703 
     | 
    
         
            -
            すでに 
     | 
| 
      
 31299 
     | 
    
         
            +
            すでにGroongaのFormulaは取り込まれているので、リリースのたびにFormulaの内容を更新する作業を実施します。
         
     | 
| 
       30704 
31300 
     | 
    
         
             
            .sp
         
     | 
| 
       30705 
     | 
    
         
            -
             
     | 
| 
      
 31301 
     | 
    
         
            +
            Groonga 3.0.6のときは以下のように更新してpull requestを送りました。
         
     | 
| 
       30706 
31302 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       30707 
31303 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       30708 
31304 
     | 
    
         
             
            \fI\%https://github.com/mxcl/homebrew/pull/21456/files\fP
         
     | 
| 
         @@ -30721,7 +31317,7 @@ Groonga\-talk \fI\%groonga\-talk@lists.sourceforge.net\fP 
     | 
|
| 
       30721 
31317 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       30722 
31318 
     | 
    
         
             
            .SS freecode.comへリリース情報を登録
         
     | 
| 
       30723 
31319 
     | 
    
         
             
            .sp
         
     | 
| 
       30724 
     | 
    
         
            -
             
     | 
| 
      
 31320 
     | 
    
         
            +
            Groongaプロジェクトではfreecode.comでもリリース情報を発信しています。
         
     | 
| 
       30725 
31321 
     | 
    
         
             
            .sp
         
     | 
| 
       30726 
31322 
     | 
    
         
             
            freecode.comのプロジェクトページは以下の通りです。
         
     | 
| 
       30727 
31323 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -30759,14 +31355,14 @@ blogroongaのリリースエントリには「リンクをあなたのフォロ 
     | 
|
| 
       30759 
31355 
     | 
    
         
             
            リリースアナウンスを流し終えたら、次期バージョンの開発が始まります。
         
     | 
| 
       30760 
31356 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       30761 
31357 
     | 
    
         
             
            .IP \(bu 2
         
     | 
| 
       30762 
     | 
    
         
            -
             
     | 
| 
      
 31358 
     | 
    
         
            +
            Groonga プロジェクトの新規バージョン追加
         
     | 
| 
       30763 
31359 
     | 
    
         
             
            .IP \(bu 2
         
     | 
| 
       30764 
     | 
    
         
            -
             
     | 
| 
      
 31360 
     | 
    
         
            +
            Groonga のbase_versionの更新
         
     | 
| 
       30765 
31361 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       30766 
     | 
    
         
            -
            .SS  
     | 
| 
      
 31362 
     | 
    
         
            +
            .SS Groonga プロジェクトの新規バージョン追加
         
     | 
| 
       30767 
31363 
     | 
    
         
             
            .sp
         
     | 
| 
       30768 
     | 
    
         
            -
            \fI\% 
     | 
| 
       30769 
     | 
    
         
            -
            .SS  
     | 
| 
      
 31364 
     | 
    
         
            +
            \fI\%Groonga プロジェクトの設定ページ\fP にて新規バージョンを追加します。(例: release\-2.0.6)
         
     | 
| 
      
 31365 
     | 
    
         
            +
            .SS Groonga バージョン更新
         
     | 
| 
       30770 
31366 
     | 
    
         
             
            .sp
         
     | 
| 
       30771 
31367 
     | 
    
         
             
            $GROONGA_CLONE_DIRにて以下のコマンドを実行します。:
         
     | 
| 
       30772 
31368 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
         @@ -30851,7 +31447,7 @@ centosの場合、CENTOS_VERSIONSを指定することで特定のバージョ 
     | 
|
| 
       30851 
31447 
     | 
    
         
             
            .SS テスト環境の構築
         
     | 
| 
       30852 
31448 
     | 
    
         
             
            .SS Cutterのインストール
         
     | 
| 
       30853 
31449 
     | 
    
         
             
            .sp
         
     | 
| 
       30854 
     | 
    
         
            -
             
     | 
| 
      
 31450 
     | 
    
         
            +
            Groongaは、テストのフレームワークとして \fI\%Cutter\fP を用いています。
         
     | 
| 
       30855 
31451 
     | 
    
         
             
            .sp
         
     | 
| 
       30856 
31452 
     | 
    
         
             
            Cutterのインストール方法は \fI\%プラットフォーム毎のCutterのインストール方法\fP をご覧下さい。
         
     | 
| 
       30857 
31453 
     | 
    
         
             
            .SS lcovのインストール
         
     | 
| 
         @@ -30895,7 +31491,7 @@ memcachedのバイナリプロトコルのテストを動作させるために 
     | 
|
| 
       30895 
31491 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       30896 
31492 
     | 
    
         
             
            .SS テストの動作
         
     | 
| 
       30897 
31493 
     | 
    
         
             
            .sp
         
     | 
| 
       30898 
     | 
    
         
            -
             
     | 
| 
      
 31494 
     | 
    
         
            +
            Groongaのトップディレクトリで、以下のコマンドを実行します。:
         
     | 
| 
       30899 
31495 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       30900 
31496 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       30901 
31497 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -30908,7 +31504,7 @@ make check 
     | 
|
| 
       30908 
31504 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       30909 
31505 
     | 
    
         
             
            .SS カバレッジ情報
         
     | 
| 
       30910 
31506 
     | 
    
         
             
            .sp
         
     | 
| 
       30911 
     | 
    
         
            -
             
     | 
| 
      
 31507 
     | 
    
         
            +
            Groongaのトップディレクトリで、以下のコマンドを実行します。:
         
     | 
| 
       30912 
31508 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       30913 
31509 
     | 
    
         
             
            .INDENT 3.5
         
     | 
| 
       30914 
31510 
     | 
    
         
             
            .sp
         
     | 
| 
         @@ -31009,254 +31605,6 @@ scan\-buildを用いて、ソースコードの静的解析を行うことがで 
     | 
|
| 
       31009 
31605 
     | 
    
         
             
            .UNINDENT
         
     | 
| 
       31010 
31606 
     | 
    
         
             
            .sp
         
     | 
| 
       31011 
31607 
     | 
    
         
             
            configureは1度のみ実行する必要があります。
         
     | 
| 
       31012 
     | 
    
         
            -
            .SS ドキュメント関連のコントリビュート方法
         
     | 
| 
       31013 
     | 
    
         
            -
            .sp
         
     | 
| 
       31014 
     | 
    
         
            -
            ドキュメントツールとして \fI\%Sphinx\fP を使います。
         
     | 
| 
       31015 
     | 
    
         
            -
            .SS C API
         
     | 
| 
       31016 
     | 
    
         
            -
            .sp
         
     | 
| 
       31017 
     | 
    
         
            -
            今のところ、C APIのドキュメントはinclude/groonga.hにありますが、これをdoc/source/c\-api/*.txtに移動したいと思っています。C APIのドキュメントを移動して、パッチを送ってくれるととても喜びます。
         
     | 
| 
       31018 
     | 
    
         
            -
            .sp
         
     | 
| 
       31019 
     | 
    
         
            -
            Sphinxの \fI\%the C domain markup\fP を使う予定です。
         
     | 
| 
       31020 
     | 
    
         
            -
            .SS 国際化
         
     | 
| 
       31021 
     | 
    
         
            -
            .sp
         
     | 
| 
       31022 
     | 
    
         
            -
            今のところ、groongaには日本語でのドキュメントしかありません。1.2.2からgettextベースの \fI\%Sphinx I18N feature\fP を使ってドキュメントの国際化対応を始めました。この仕組みではベースの言語として英語を使い、日本語などの他の言語には英語からその言語に翻訳します。すべてのドキュメントはdoc/source/以下において、それをSphinxで処理します。
         
     | 
| 
       31023 
     | 
    
         
            -
            .sp
         
     | 
| 
       31024 
     | 
    
         
            -
            しかし、今のところ、doc/source/では日本語を使っています。そのため、まずは、doc/source/以下にある日本語のドキュメントを英語に翻訳する必要があります。ドキュメントを翻訳して、パッチを送ってくれるととても喜びます。
         
     | 
| 
       31025 
     | 
    
         
            -
            .SS 翻訳の流れ
         
     | 
| 
       31026 
     | 
    
         
            -
            .sp
         
     | 
| 
       31027 
     | 
    
         
            -
            doc/source/*.txtを更新したら、翻訳を始めます。
         
     | 
| 
       31028 
     | 
    
         
            -
            .sp
         
     | 
| 
       31029 
     | 
    
         
            -
            これが翻訳の流れです:
         
     | 
| 
       31030 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       31031 
     | 
    
         
            -
            .IP 1. 3
         
     | 
| 
       31032 
     | 
    
         
            -
            groongaのリポジトリをcloneします。
         
     | 
| 
       31033 
     | 
    
         
            -
            .IP 2. 3
         
     | 
| 
       31034 
     | 
    
         
            -
            .poファイルを更新します。
         
     | 
| 
       31035 
     | 
    
         
            -
            .IP 3. 3
         
     | 
| 
       31036 
     | 
    
         
            -
            .poファイルを編集します。
         
     | 
| 
       31037 
     | 
    
         
            -
            .IP 4. 3
         
     | 
| 
       31038 
     | 
    
         
            -
            HTMLファイルを生成します。
         
     | 
| 
       31039 
     | 
    
         
            -
            .IP 5. 3
         
     | 
| 
       31040 
     | 
    
         
            -
            HTMLの出力を確認します。
         
     | 
| 
       31041 
     | 
    
         
            -
            .IP 6. 3
         
     | 
| 
       31042 
     | 
    
         
            -
            翻訳が完了するまで、2.\-4.を繰り返します。
         
     | 
| 
       31043 
     | 
    
         
            -
            .IP 7. 3
         
     | 
| 
       31044 
     | 
    
         
            -
            翻訳作業の成果をgroongaプロジェクトに送ってください!
         
     | 
| 
       31045 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31046 
     | 
    
         
            -
            .sp
         
     | 
| 
       31047 
     | 
    
         
            -
            上記の流れを実行するコマンドラインです。詳細は以降のセクションで説明します。
         
     | 
| 
       31048 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       31049 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       31050 
     | 
    
         
            -
            .sp
         
     | 
| 
       31051 
     | 
    
         
            -
            .nf
         
     | 
| 
       31052 
     | 
    
         
            -
            .ft C
         
     | 
| 
       31053 
     | 
    
         
            -
            # Please fork https://github.com/groonga/groonga on GitHub
         
     | 
| 
       31054 
     | 
    
         
            -
            % git clone https://github.com/${YOUR_GITHUB_ACCOUNT}/groonga.git
         
     | 
| 
       31055 
     | 
    
         
            -
            % ./autogen.sh
         
     | 
| 
       31056 
     | 
    
         
            -
            % ./configure
         
     | 
| 
       31057 
     | 
    
         
            -
            % cd doc/locale/${LANGUAGE}/LC_MESSAGES # ${LANGUAGE} is language code such as \(aqja\(aq.
         
     | 
| 
       31058 
     | 
    
         
            -
            % make update # *.po are updated
         
     | 
| 
       31059 
     | 
    
         
            -
            % editor *.po # translate *.po # you can use your favorite editor
         
     | 
| 
       31060 
     | 
    
         
            -
            % cd ..
         
     | 
| 
       31061 
     | 
    
         
            -
            % make html
         
     | 
| 
       31062 
     | 
    
         
            -
            % browser html/index.html # confirm translation
         
     | 
| 
       31063 
     | 
    
         
            -
            % git add LC_MESSAGES/*.po
         
     | 
| 
       31064 
     | 
    
         
            -
            % git commit
         
     | 
| 
       31065 
     | 
    
         
            -
            % git push
         
     | 
| 
       31066 
     | 
    
         
            -
            .ft P
         
     | 
| 
       31067 
     | 
    
         
            -
            .fi
         
     | 
| 
       31068 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31069 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31070 
     | 
    
         
            -
            .SS groongaリポジトリのcloneの仕方
         
     | 
| 
       31071 
     | 
    
         
            -
            .sp
         
     | 
| 
       31072 
     | 
    
         
            -
            はじめに、GitHub上のgroongaリポジトリをforkしてください。 \fI\%https://github.com/groonga/groonga\fP にアクセスして \fIFork\fP ボタンを押すだけです。これで自分のgroongaリポジトリをcloneすることができます。:
         
     | 
| 
       31073 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       31074 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       31075 
     | 
    
         
            -
            .sp
         
     | 
| 
       31076 
     | 
    
         
            -
            .nf
         
     | 
| 
       31077 
     | 
    
         
            -
            .ft C
         
     | 
| 
       31078 
     | 
    
         
            -
            % git clone https://github.com/${YOUR_GITHUB_ACCOUNT}/groonga.git
         
     | 
| 
       31079 
     | 
    
         
            -
            .ft P
         
     | 
| 
       31080 
     | 
    
         
            -
            .fi
         
     | 
| 
       31081 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31082 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31083 
     | 
    
         
            -
            .sp
         
     | 
| 
       31084 
     | 
    
         
            -
            cloneした後はconfigureする必要があります。:
         
     | 
| 
       31085 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       31086 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       31087 
     | 
    
         
            -
            .sp
         
     | 
| 
       31088 
     | 
    
         
            -
            .nf
         
     | 
| 
       31089 
     | 
    
         
            -
            .ft C
         
     | 
| 
       31090 
     | 
    
         
            -
            % cd groonga
         
     | 
| 
       31091 
     | 
    
         
            -
            % ./autogen.sh
         
     | 
| 
       31092 
     | 
    
         
            -
            % ./configure
         
     | 
| 
       31093 
     | 
    
         
            -
            .ft P
         
     | 
| 
       31094 
     | 
    
         
            -
            .fi
         
     | 
| 
       31095 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31096 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31097 
     | 
    
         
            -
            .sp
         
     | 
| 
       31098 
     | 
    
         
            -
            この作業は初回セットアップ時のみだけの作業です。
         
     | 
| 
       31099 
     | 
    
         
            -
            .sp
         
     | 
| 
       31100 
     | 
    
         
            -
            以上の作業で問題があった場合は、 \fI\%http://packages.groonga.org/source/groonga/\fP にあるソースファイルを利用してもよいです。
         
     | 
| 
       31101 
     | 
    
         
            -
            .SS .poファイルの更新の仕方
         
     | 
| 
       31102 
     | 
    
         
            -
            .sp
         
     | 
| 
       31103 
     | 
    
         
            -
            doc/locale/${LANGUAGE}/LC_MESSAGESディレクトリで \fImake update\fP を実行すると.poファイルを更新できます。(\fI${LANGUAGE}\fP は\(aqja\(aqなど自分の言語の言語コードに置き換えてください。):
         
     | 
| 
       31104 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       31105 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       31106 
     | 
    
         
            -
            .sp
         
     | 
| 
       31107 
     | 
    
         
            -
            .nf
         
     | 
| 
       31108 
     | 
    
         
            -
            .ft C
         
     | 
| 
       31109 
     | 
    
         
            -
            % cd doc/locale/ja/LC_MESSAGES
         
     | 
| 
       31110 
     | 
    
         
            -
            % make update
         
     | 
| 
       31111 
     | 
    
         
            -
            .ft P
         
     | 
| 
       31112 
     | 
    
         
            -
            .fi
         
     | 
| 
       31113 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31114 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31115 
     | 
    
         
            -
            .SS .poの編集の仕方
         
     | 
| 
       31116 
     | 
    
         
            -
            .sp
         
     | 
| 
       31117 
     | 
    
         
            -
            .poファイルを編集するためのツールがあります。.poファイルは単なるテキストなので好きなエディタで編集できます。以下は.poファイルの編集に特化したエディタのリストです。
         
     | 
| 
       31118 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       31119 
     | 
    
         
            -
            .TP
         
     | 
| 
       31120 
     | 
    
         
            -
            .B Emacs\(aqs \fI\%po\-mode\fP
         
     | 
| 
       31121 
     | 
    
         
            -
            gettextに同梱されています。
         
     | 
| 
       31122 
     | 
    
         
            -
            .TP
         
     | 
| 
       31123 
     | 
    
         
            -
            .B \fI\%Poedit\fP
         
     | 
| 
       31124 
     | 
    
         
            -
            .po専用エディタです。たくさんのプラットフォームで動作します。
         
     | 
| 
       31125 
     | 
    
         
            -
            .TP
         
     | 
| 
       31126 
     | 
    
         
            -
            .B gted
         
     | 
| 
       31127 
     | 
    
         
            -
            これも.po専用エディタです。Eclipseプラグインとして実装されています。
         
     | 
| 
       31128 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31129 
     | 
    
         
            -
            .SS HTMLファイルの生成方法
         
     | 
| 
       31130 
     | 
    
         
            -
            .sp
         
     | 
| 
       31131 
     | 
    
         
            -
            doc/locale/${LANGUAGE}ディレクトリで \fImake html\fP を実行すると更新した.poファイルを使ってHTMLファイルを生成できます。(\fI${LANGUAGE}\fP は\(aqja\(aqなど自分の言語の言語コードに置き換えてください。):
         
     | 
| 
       31132 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       31133 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       31134 
     | 
    
         
            -
            .sp
         
     | 
| 
       31135 
     | 
    
         
            -
            .nf
         
     | 
| 
       31136 
     | 
    
         
            -
            .ft C
         
     | 
| 
       31137 
     | 
    
         
            -
            % cd doc/locale/ja/
         
     | 
| 
       31138 
     | 
    
         
            -
            % make html
         
     | 
| 
       31139 
     | 
    
         
            -
            .ft P
         
     | 
| 
       31140 
     | 
    
         
            -
            .fi
         
     | 
| 
       31141 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31142 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31143 
     | 
    
         
            -
            .sp
         
     | 
| 
       31144 
     | 
    
         
            -
            全ての言語のHTMLファイルを生成するにはdoc/locale/ディレクトリで \fImake html\fP を実行します。:
         
     | 
| 
       31145 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       31146 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       31147 
     | 
    
         
            -
            .sp
         
     | 
| 
       31148 
     | 
    
         
            -
            .nf
         
     | 
| 
       31149 
     | 
    
         
            -
            .ft C
         
     | 
| 
       31150 
     | 
    
         
            -
            % cd doc/locale
         
     | 
| 
       31151 
     | 
    
         
            -
            % make html
         
     | 
| 
       31152 
     | 
    
         
            -
            .ft P
         
     | 
| 
       31153 
     | 
    
         
            -
            .fi
         
     | 
| 
       31154 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31155 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31156 
     | 
    
         
            -
            .sp
         
     | 
| 
       31157 
     | 
    
         
            -
            \fBノート:\fP
         
     | 
| 
       31158 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       31159 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       31160 
     | 
    
         
            -
            .moファイルは \fImake html\fP で自動的に更新されるので、.moファイルのことを気にする必要はありません。
         
     | 
| 
       31161 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31162 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31163 
     | 
    
         
            -
            .SS HTML出力の確認の仕方
         
     | 
| 
       31164 
     | 
    
         
            -
            .sp
         
     | 
| 
       31165 
     | 
    
         
            -
            HTMLファイルはdoc/locale/${LANGUAGE}/html/以下に出力されます。(\fI${LANGUAGE}\fP は\(aqja\(aqなど自分の言語の言語コードに置き換えてください。)好きなブラウザで出力されたHTMLを確認してください。:
         
     | 
| 
       31166 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       31167 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       31168 
     | 
    
         
            -
            .sp
         
     | 
| 
       31169 
     | 
    
         
            -
            .nf
         
     | 
| 
       31170 
     | 
    
         
            -
            .ft C
         
     | 
| 
       31171 
     | 
    
         
            -
            % firefox doc/locale/ja/html/index.html
         
     | 
| 
       31172 
     | 
    
         
            -
            .ft P
         
     | 
| 
       31173 
     | 
    
         
            -
            .fi
         
     | 
| 
       31174 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31175 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31176 
     | 
    
         
            -
            .SS 翻訳の成果の送り方
         
     | 
| 
       31177 
     | 
    
         
            -
            .sp
         
     | 
| 
       31178 
     | 
    
         
            -
            翻訳の成果はGitHubのpull requestかメールで送ってください。メールで送る場合はパッチでも.poファイルそのものでも構いません。
         
     | 
| 
       31179 
     | 
    
         
            -
            .SS pull requestの送り方
         
     | 
| 
       31180 
     | 
    
         
            -
            .sp
         
     | 
| 
       31181 
     | 
    
         
            -
            pull requestを送るためのコマンドライン:
         
     | 
| 
       31182 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       31183 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       31184 
     | 
    
         
            -
            .sp
         
     | 
| 
       31185 
     | 
    
         
            -
            .nf
         
     | 
| 
       31186 
     | 
    
         
            -
            .ft C
         
     | 
| 
       31187 
     | 
    
         
            -
            % git add doc/locale/ja/LC_MESSAGES/*.po
         
     | 
| 
       31188 
     | 
    
         
            -
            % git commit
         
     | 
| 
       31189 
     | 
    
         
            -
            % git push
         
     | 
| 
       31190 
     | 
    
         
            -
            .ft P
         
     | 
| 
       31191 
     | 
    
         
            -
            .fi
         
     | 
| 
       31192 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31193 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31194 
     | 
    
         
            -
            .sp
         
     | 
| 
       31195 
     | 
    
         
            -
            これでGitHub上でpull requestを送る準備ができました。あとは、GitHub上の自分のリポジトリのページへアクセスして \fIPull Request\fP ボタンを押すだけです。
         
     | 
| 
       31196 
     | 
    
         
            -
            .sp
         
     | 
| 
       31197 
     | 
    
         
            -
            \fB参考:\fP
         
     | 
| 
       31198 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       31199 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       31200 
     | 
    
         
            -
            pull requestの送り方
         
     | 
| 
       31201 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31202 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31203 
     | 
    
         
            -
            .SS パッチの送り方
         
     | 
| 
       31204 
     | 
    
         
            -
            .sp
         
     | 
| 
       31205 
     | 
    
         
            -
            パッチを作るためのコマンドライン
         
     | 
| 
       31206 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       31207 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       31208 
     | 
    
         
            -
            .sp
         
     | 
| 
       31209 
     | 
    
         
            -
            .nf
         
     | 
| 
       31210 
     | 
    
         
            -
            .ft C
         
     | 
| 
       31211 
     | 
    
         
            -
            % git add doc/locale/ja/LC_MESSAGES/*.po
         
     | 
| 
       31212 
     | 
    
         
            -
            % git commit
         
     | 
| 
       31213 
     | 
    
         
            -
            % git format\-patch origin/master
         
     | 
| 
       31214 
     | 
    
         
            -
            .ft P
         
     | 
| 
       31215 
     | 
    
         
            -
            .fi
         
     | 
| 
       31216 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31217 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31218 
     | 
    
         
            -
            .sp
         
     | 
| 
       31219 
     | 
    
         
            -
            カレントディレクトリに000X\-YYY.patchという名前のファイルができていると思います。これをgroongaプロジェクトに送ってください!
         
     | 
| 
       31220 
     | 
    
         
            -
            .sp
         
     | 
| 
       31221 
     | 
    
         
            -
            \fB参考:\fP
         
     | 
| 
       31222 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       31223 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       31224 
     | 
    
         
            -
            \fB/community\fP に連絡先の情報があります。
         
     | 
| 
       31225 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31226 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31227 
     | 
    
         
            -
            .SS .poファイルの送り方
         
     | 
| 
       31228 
     | 
    
         
            -
            .sp
         
     | 
| 
       31229 
     | 
    
         
            -
            doc/locale/${LANGUAGE}/LC_MESSAGES/以下を.tar.gzや.zipなどでアーカイブにしてgroongaプロジェクトに送ってください!(\fI${LANGUAGE}\fP は\(aqja\(aqなど自分の言語の言語コードに置き換えてください。)こちらでアーカイブの中の内容をマージします。
         
     | 
| 
       31230 
     | 
    
         
            -
            .sp
         
     | 
| 
       31231 
     | 
    
         
            -
            \fB参考:\fP
         
     | 
| 
       31232 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       31233 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       31234 
     | 
    
         
            -
            \fB/community\fP に連絡先の情報があります。
         
     | 
| 
       31235 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31236 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31237 
     | 
    
         
            -
            .SS 新しい言語の追加方法
         
     | 
| 
       31238 
     | 
    
         
            -
            .sp
         
     | 
| 
       31239 
     | 
    
         
            -
            新しい翻訳対象の言語を追加するコマンドライン:
         
     | 
| 
       31240 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       31241 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       31242 
     | 
    
         
            -
            .sp
         
     | 
| 
       31243 
     | 
    
         
            -
            .nf
         
     | 
| 
       31244 
     | 
    
         
            -
            .ft C
         
     | 
| 
       31245 
     | 
    
         
            -
            % cd doc/locale
         
     | 
| 
       31246 
     | 
    
         
            -
            % make add LOCALE=${LANGUAGE} # specify your language code such as \(aqde\(aq.
         
     | 
| 
       31247 
     | 
    
         
            -
            .ft P
         
     | 
| 
       31248 
     | 
    
         
            -
            .fi
         
     | 
| 
       31249 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31250 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31251 
     | 
    
         
            -
            .sp
         
     | 
| 
       31252 
     | 
    
         
            -
            \fI${LANGUAGE}\fP は\(aqja\(aqなどの自分の言語の言語コードに置き換えてください。
         
     | 
| 
       31253 
     | 
    
         
            -
            .sp
         
     | 
| 
       31254 
     | 
    
         
            -
            \fB参考:\fP
         
     | 
| 
       31255 
     | 
    
         
            -
            .INDENT 0.0
         
     | 
| 
       31256 
     | 
    
         
            -
            .INDENT 3.5
         
     | 
| 
       31257 
     | 
    
         
            -
            言語名を表記するためのコード
         
     | 
| 
       31258 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31259 
     | 
    
         
            -
            .UNINDENT
         
     | 
| 
       31260 
31608 
     | 
    
         
             
            .INDENT 0.0
         
     | 
| 
       31261 
31609 
     | 
    
         
             
            .IP \(bu 2
         
     | 
| 
       31262 
31610 
     | 
    
         
             
            \fIgenindex\fP
         
     |