rroonga 1.3.0-x86-mingw32 → 1.3.1-x86-mingw32

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

@@ -1,4 +1,4 @@
-.TH "GROONGA" "1" "2011 年 11 月 27 日" "1.2.7" "groonga"
+.TH "GROONGA" "1" "2012 年 01 月 29 日" "1.2.9" "groonga"
 .SH NAME
 groonga \- groongaのドキュメント
 .
@@ -35,42 +35,51 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 \fBnews\fP
 .UNINDENT
 .SH GROONGAの特徴
-.SS 全文検索ライブラリSennaの後継
+.SS groonga の概要
 .sp
-groongaは、広く使われている全文検索ライブラリSennaの後継として開発されています。Sennaの特徴である、高速・高精度・高柔軟性という特徴を引き継ぎつつ、さらにそれらの特徴を追求するために開発が始められました。
-.SS HTTPなどの複数プロトコルに対応したサーバ
+groonga は転置索引を用いた高速・高精度な全文検索エンジンであり、登録された文書をすぐに検索結果に反映できます。また、参照をブロックせずに更新できることから、即時更新の必要なアプリケーションにおいても高い性能を発揮します。
 .sp
-Sennaは、全文検索を行うアプリケーションで用いるための部品でした。groongaでは、全文検索サービスを行うためのサーバが存在します。groongaサーバは、HTTPやmemcached binaryプロトコル、独自プロトコルであるgqtpを用いてクライアントとTCP/IP通信を行うことができます。よって、ライブラリをインストールできないレンタルサーバなどの環境でも利用しやすくなりました。
+全文検索エンジンとして開発された groonga ですが、独自のカラムストアを持つ列指向のデータベースとしての側面も持っています。そのため、MySQL や PostgreSQL など、既存の代表的なデータベースが苦手とする集計クエリを高速に処理できるという特徴があり、組み合わせによって弱点を補うような使い方もできます。
 .sp
-Sennaと同様に、groongaもC言語のライブラリとして利用できます。
-.SS 高速なデータ更新
+groonga の基本機能は C ライブラリとして提供されていますが、MySQL や PostgreSQL と連携させたり、Ruby から呼び出したりすることもできます。そのため、任意のアプリケーションに組み込むことが可能であり、多様な使い方が考えられます。 興味のある方は \fI\%利用例\fP をご覧ください。
+.SS 全文検索と即時更新
 .sp
-groongaの前身であるSennaは、ストレージを持たない全文検索ライブラリでした。そのため、MySQLのMyISAMストレージエンジンと組み合わせて用いるTritonnや、PostgreSQLと組み合わせて用いるLudiaを通じて利用するのが一般的でした。しかし、これらの形態では、全文検索インデックス更新における参照lockが不要というSennaの性能特性を生かすことができませんでした。
+一般的なデータベースにおいては、追加・削除などの操作がすぐに反映されます。一方、全文検索においては、転置索引が逐次更新の難しいデータ構造であることから、文書の追加・削除に対応しないエンジンが少なくありません。
 .sp
-たとえば、MyISAMではレコードが更新される際には、多くの場合テーブルロックが必要となります。このような場合には、いかに全文検索インデックスの更新が速くとも、MyISAMでのデータ更新がボトルネックとなってしまいます。
+これに対し、転置索引を用いた全文検索エンジンでありながら、groonga は文書を短時間で追加・削除することができます。その上、更新しながらでも検索できるという優れた特徴を持っているため、全文検索エンジンとしてはとても柔軟性があります。また、複数の転置索引を統合するような重い処理を必要としないので、安定して高い性能を発揮することが期待できます。
+.SS カラムストアと集計クエリ
 .sp
-より即時性の高い検索サービスを実現するために、groongaでは参照lockが不要なストレージを実装しました。
-.SS 複数プロセス・複数スレッドで共有できるストレージ
+現代は、インターネットを情報源とすれば、いくらでも情報を収集できる時代です。しかし、膨大な情報から有益な情報を引き出すのは困難であり、多面的な分析による試行錯誤が必要となります。たとえば、日付や時間帯により絞り込んでみたり、地域により絞り込んでみたり、性別や年齢により絞り込んでみたりすることでしょう。そして、そのようなときに便利な存在が集計クエリです。
 .sp
-groongaのストレージファイルは、複数プロセスや複数スレッドで共有することができます。明示的なロックなどは必要ありません。
+集計クエリとは、指定したカラムの値によってレコードをグループ化し、各グループに含まれるレコードの数を求めるクエリです。たとえば、地域の ID を格納しているカラムを指定すれば、地域毎のレコード数が求まります。日付のカラムを指定したときの出力をグラフ化すれば、レコード数の時間変化を視覚化することができます。さらに、地域による絞り込みと日付に対する集計クエリを組み合わせれば、特定の地域におけるレコード数の時間変化を視覚化ことも可能です。このように、尺度を自由に選択して絞り込み・集計できることは、膨大な情報を扱う上でとても重要になります。
 .sp
-Tritonnの後継として \fI\%mroonga\fP が開発されています。mroongaはMySQLのプラガブルストレージエンジンとして実装されています。mroongaが開いているgroongaのストレージファイルは他のgroongaサーバも共有することができます。例えば、MySQLプロトコルでデータの更新を行い、HTTPでデータの参照を行うことができます。
-.SS ドリルダウンなどの集計系クエリを高速に実現
+groonga が集計クエリを高速に処理できる理由は、データベースの論理構造にカラムストアを採用しているからです。集計クエリが参照するのは指定されたカラムのみであるため、カラム単位でデータを格納する列指向のデータベースでは、必要なカラムのみを無駄なく読み出せることが利点となります。一方、レコード単位でデータを格納する行指向のデータベースでは、隣接するカラムをまとめて読み出してしまうことが欠点となります。
+.SS 転置索引とトークナイザ
 .sp
-groongaのストレージは、カラムごとにデータを保存するカラム指向データベースを採用しています。カラム指向データベースはOLAPなどの集計クエリを高速に実現するのに向いています。
+転置索引は大規模な全文検索に用いられる伝統的なデータ構造です。転置索引を用いた全文検索エンジンでは、文書を追加するときに索引語を記録しておき、検索するときはクエリを索引語に分割して出現文書を求めます。そのため、文書やクエリから索引語を抜き出す方法が重要になります。
 .sp
-全文検索結果のうち、特定のカラム値ごとにグループ分けをし、それぞれのグループのレコード数を数えるような処理をドリルダウンといいます。groongaはカラム指向データベースを生かして、このような処理を高速に実行します。
-.SS Sennaの転置インデックス実装をさらに改良
+トークナイザは、文字列から索引語を抜き出すモジュールです。日本語を対象とする全文検索においては、形態素を索引語として抜き出す方式と文字 N\-gram を抜き出す方式のいずれか、あるいは両方を用いるのが一般的です。形態素方式は検索時間や索引サイズの面で優れているほか、検索結果に不要な文書が含まれにくいという利点を持っています。一方、N\-gram 方式には検索漏れが発生しにくいという利点があり、状況によって適した方式を選択することが望ましいとされています。
 .sp
-groongaの転置インデックスは、Sennaにおける転置インデックスの実装を改良し、より高速かつ汎用的なものとなりました。
+groonga は形態素方式と N\-gram 方式の両方に対応しています。初期状態で利用できるトークナイザは空白を区切り文字として用いる方式と N\-gram 方式のみですが、形態素解析器 MeCab を組み込んだときは MeCab による分かち書きの結果を用いる形態素方式が有効になります。トークナイザはプラグインとして追加できるため、特徴的なキーワードのみを索引語として採用するなど、独自のトークナイザを開発することが可能です。
+.SS 共有可能なストレージと参照ロックフリー
 .sp
-転置インデックスを生かすことにより、SQLでも実現が難しい複雑なクエリを高速に実行することができます。いわゆるタグ検索やドリルダウンにおいて、転置インデックスを利用した高速な処理を行うことができます。
+CPU のマルチコア化が進んでいるため、同時に複数のクエリを実行したり、一つのクエリを複数のスレッドで実行したりすることの重要性はますます高まっています。
+.sp
+groonga のストレージは、複数のスレッド・プロセスで共有することができます。また、参照ロックフリーなデータ構造を採用しているため、更新クエリを実行している状況でも参照クエリを実行することができます。参照クエリを実行できる状態を維持しながら更新クエリを実行できるので、リアルタイムなシステムに適しています。さらには、MySQL を介して更新クエリを実行している最中に groonga の HTTP サーバを介して参照クエリを実行するなど、多彩な運用が可能となっています。
 .SS 位置情報（緯度・経度）検索
 .sp
-日本測地系のみならず、世界測地系にも対応した位置情報での絞込が可能です。位置情報の範囲は、円や矩形を指定することができます。また、任意の２点間の距離も計算可能です。
-.SS 自動クエリキャッシュ機構
+GPS に代表される測位システムを搭載した高機能な携帯端末の普及などによって、位置情報を扱うサービスはますます便利になっています。たとえば、近くにあるレストランを探しているときは、現在地からの距離を基準として検索をおこない、検索結果を地図上に表示してくれるようなサービスが便利です。そのため、位置情報検索を高速に実現できることが重要になっています。
+.sp
+groonga では転置索引を応用して高速な位置情報検索を実現しています。矩形・円による範囲検索に対応しているほか、基準点の近くを優先的に探索させることができます。また、距離計算をサポートしているので、位置情報検索の結果を基準点からの距離によって整列することも可能です。
+.SS groonga ライブラリ
+.sp
+Groonga の基本機能は C ライブラリとして提供されているので、任意のアプリケーションに組み込んで利用することができます。C/C++ 以外については、Ruby から groonga を利用するライブラリなどが関連プロジェクトにおいて提供されています。詳しくは \fI\%関連プロジェクト\fP を参照してください。
+.SS groonga サーバ
 .sp
-参照系のクエリについて、自動的にクエリキャッシュを行います。
+groonga にはサーバ機能があるため、レンタルサーバなどの新しいライブラリをインストールできない環境においても利用できます。対応しているのは HTTP, memcached binary プロトコル、およびに groonga の独自プロトコルである gqtp です。サーバとして利用するときはクエリのキャッシュ機能が有効になるため、同じクエリを受け取ったときは応答時間が短くなるという特徴があります。
+.SS groonga ストレージエンジン
+.sp
+groonga は独自のカラムストアを持つ列指向のデータベースとしての側面を持っていますが、既存の RDBMS のストレージエンジンとして利用することもできます。たとえば、groonga をベースとする MySQL のストレージエンジンとして \fI\%mroonga\fP が開発されています。mroonga は MySQL のプラグインとして動的にロードすることが可能であり、groonga のカラムストアをストレージとして利用したり、全文検索エンジンとして groonga を MyISAM や InnoDB と連携させたりすることができます。groonga 単体での利用、およびに MyISAM, InnoDB との連携には一長一短があるので、用途に応じて適切な組み合わせを選ぶことが大切です。詳しくは \fI\%関連プロジェクト\fP を参照してください。
 .SH インストール
 .sp
 それぞれの環境毎にインストール方法を説明します。
@@ -96,6 +105,16 @@ deb\-src http://packages.groonga.org/debian/ squeeze main
 % sudo aptitude \-V \-D \-y install groonga
 .ft P
 .fi
+.sp
+\fI\%Munin\fP プラグインを提供するパッケージもあります。もし、muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
+.sp
+groonga\-munin\-pluginsパッケージをインストール:
+.sp
+.nf
+.ft C
+% sudo aptitude \-V \-D \-y install groonga\-munin\-plugins
+.ft P
+.fi
 .SS Debian GNU/Linux wheezy
 .sp
 /etc/apt/sources.list.d/groonga.list:
@@ -116,6 +135,14 @@ deb\-src http://packages.groonga.org/debian/ wheezy main
 % sudo aptitude \-V \-D \-y install groonga
 .ft P
 .fi
+.sp
+groonga\-munin\-pluginsパッケージをインストール:
+.sp
+.nf
+.ft C
+% sudo aptitude \-V \-D \-y install groonga\-munin\-plugins
+.ft P
+.fi
 .SS Debian GNU/Linux sid
 .sp
 /etc/apt/sources.list.d/groonga.list:
@@ -136,6 +163,14 @@ deb\-src http://packages.groonga.org/debian/ unstable main
 % sudo aptitude \-V \-D \-y install groonga
 .ft P
 .fi
+.sp
+groonga\-munin\-pluginsパッケージをインストール:
+.sp
+.nf
+.ft C
+% sudo aptitude \-V \-D \-y install groonga\-munin\-plugins
+.ft P
+.fi
 .SS Ubuntu 10.04 LTS Lucid Lynx
 .IP ノート
 Ubuntu本家のuniverseセクションもインストール対象としてください。設定方法は以下で説明しています。
@@ -155,8 +190,16 @@ deb\-src http://packages.groonga.org/ubuntu/ lucid universe
 .nf
 .ft C
 % sudo apt\-key adv \-\-recv\-keys \-\-keyserver keyserver.ubuntu.com 1C837F31
-% sudo aptitude update
-% sudo aptitude \-V \-D \-y install groonga
+% sudo apt\-get update
+% sudo apt\-get \-y install groonga
+.ft P
+.fi
+.sp
+groonga\-munin\-pluginsパッケージをインストール:
+.sp
+.nf
+.ft C
+% sudo apt\-get \-y install groonga\-munin\-plugins
 .ft P
 .fi
 .SS Ubuntu 11.04 Natty Narwhal
@@ -178,8 +221,16 @@ deb\-src http://packages.groonga.org/ubuntu/ natty universe
 .nf
 .ft C
 % sudo apt\-key adv \-\-recv\-keys \-\-keyserver keyserver.ubuntu.com 1C837F31
-% sudo aptitude update
-% sudo aptitude \-V \-D \-y install groonga
+% sudo apt\-get update
+% sudo apt\-get \-y install groonga
+.ft P
+.fi
+.sp
+groonga\-munin\-pluginsパッケージをインストール:
+.sp
+.nf
+.ft C
+% sudo apt\-get \-y install groonga\-munin\-plugins
 .ft P
 .fi
 .SS Ubuntu 11.10 Oneiric Ocelot
@@ -201,8 +252,16 @@ deb\-src http://packages.groonga.org/ubuntu/ oneiric universe
 .nf
 .ft C
 % sudo apt\-key adv \-\-recv\-keys \-\-keyserver keyserver.ubuntu.com 1C837F31
-% sudo aptitude update
-% sudo aptitude \-V \-D \-y install groonga
+% sudo apt\-get update
+% sudo apt\-get \-y install groonga
+.ft P
+.fi
+.sp
+groonga\-munin\-pluginsパッケージをインストール:
+.sp
+.nf
+.ft C
+% sudo apt\-get \-y install groonga\-munin\-plugins
 .ft P
 .fi
 .SS CentOS 5
@@ -216,6 +275,44 @@ deb\-src http://packages.groonga.org/ubuntu/ oneiric universe
 % sudo yum install \-y groonga
 .ft P
 .fi
+.sp
+\fI\%Munin\fP プラグインを提供するパッケージもあります。もし、muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
+.IP ノート
+groonga\-munin\-pluginsパッケージはmunin\-nodeパッケージを必要としますが、munin\-nodeパッケージはCentOSの公式リポジトリには含まれていません。munin\-nodeパッケージをyumでインストールするために \fI\%RPMforge\fP リポジトリか \fI\%EPEL\fP リポジトリを有効にする必要があります。
+.sp
+i386環境でRPMforgeリポジトリを有効にする:
+.sp
+.nf
+.ft C
+% sudo rpm \-ivh http://pkgs.repoforge.org/rpmforge\-release/rpmforge\-release\-0.5.2\-2.el5.rf.i386.rpm
+.ft P
+.fi
+.sp
+x86_64環境でRPMforgeリポジトリを有効にする:
+.sp
+.nf
+.ft C
+% sudo rpm \-ivh http://pkgs.repoforge.org/rpmforge\-release/rpmforge\-release\-0.5.2\-2.el5.rf.x86_64.rpm
+.ft P
+.fi
+.sp
+EPELリポジトリを有効にする（環境非依存）:
+.sp
+.nf
+.ft C
+% sudo rpm \-ivh http://download.fedoraproject.org/pub/epel/5/i386/epel\-release\-5\-4.noarch.rpm
+.ft P
+.fi
+.RE
+.sp
+groonga\-munin\-pluginsパッケージをインストール:
+.sp
+.nf
+.ft C
+% sudo yum update
+% sudo yum install \-y groonga\-munin\-plugins
+.ft P
+.fi
 .SS CentOS 6
 .sp
 インストール:
@@ -227,7 +324,45 @@ deb\-src http://packages.groonga.org/ubuntu/ oneiric universe
 % sudo yum install \-y groonga
 .ft P
 .fi
-.SS Fedora 15
+.sp
+\fI\%Munin\fP プラグインを提供するパッケージもあります。もし、muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
+.IP ノート
+groonga\-munin\-pluginsパッケージはmunin\-nodeパッケージを必要としますが、munin\-nodeパッケージはCentOSの公式リポジトリには含まれていません。munin\-nodeパッケージをyumでインストールするために \fI\%RPMforge\fP リポジトリか \fI\%EPEL\fP リポジトリを有効にする必要があります。
+.sp
+i686環境でRPMforgeリポジトリを有効にする:
+.sp
+.nf
+.ft C
+% sudo rpm \-ivh http://pkgs.repoforge.org/rpmforge\-release/rpmforge\-release\-0.5.2\-2.el6.rf.i686.rpm
+.ft P
+.fi
+.sp
+x86_64環境でRPMforgeリポジトリを有効にする:
+.sp
+.nf
+.ft C
+% sudo rpm \-ivh http://pkgs.repoforge.org/rpmforge\-release/rpmforge\-release\-0.5.2\-2.el6.rf.x86_64.rpm
+.ft P
+.fi
+.sp
+EPELリポジトリを有効にする（環境非依存）:
+.sp
+.nf
+.ft C
+% sudo rpm \-ivh http://download.fedoraproject.org/pub/epel/6/i386/epel\-release\-6\-5.noarch.rpm
+.ft P
+.fi
+.RE
+.sp
+groonga\-munin\-pluginsパッケージをインストール:
+.sp
+.nf
+.ft C
+% sudo yum update
+% sudo yum install \-y groonga\-munin\-plugins
+.ft P
+.fi
+.SS Fedora 16
 .sp
 インストール:
 .sp
@@ -238,6 +373,16 @@ deb\-src http://packages.groonga.org/ubuntu/ oneiric universe
 % sudo yum install \-y groonga
 .ft P
 .fi
+.sp
+\fI\%Munin\fP プラグインを提供するパッケージもあります。もし、muninでgroongaの状態をモニターしたい場合は、groonga\-munin\-pluginsパッケージをインストールしてください。
+.sp
+groonga\-munin\-pluginsパッケージをインストール:
+.sp
+.nf
+.ft C
+% sudo yum install \-y groonga\-munin\-plugins
+.ft P
+.fi
 .SS Mac OS X (MacPorts)
 .sp
 インストール:
@@ -268,6 +413,8 @@ deb\-src http://packages.groonga.org/ubuntu/ oneiric universe
 .sp
 \fI\%packages.groonga.org/source/\fP よりtar.gzファイルを取得し、インストール先の環境にファイルを展開して、以下のように実行することでインストールできます。:
 .sp
+インストール:
+.sp
 .nf
 .ft C
 \&./configure \-\-prefix=/usr \-\-localstatedir=/var && make && sudo make install
@@ -275,6 +422,8 @@ deb\-src http://packages.groonga.org/ubuntu/ oneiric universe
 .fi
 .sp
 prefixは、インストール先を指定するパラメータです。prefixを指定しない場合には、/usr/localが指定されたものとみなします。LD_LIBRARY_PATHなどに詳しくない人は、上記のように/usrを指定することをお勧めします。
+.sp
+groongaパッケージには \fI\%Munin\fP プラグインが含まれています。これらをインストールするためには \fI\-\-with\-munin\-plugins\fP オプションを指定する必要があります。
 .SH コミュニティ
 .sp
 groongaに関する情報を共有するための場所がいくつかあります。あなたの参加をお待ちしています！
@@ -283,14 +432,17 @@ groongaに関する情報を共有するための場所がいくつかありま
 groongaに関する話題を扱うメーリングリストがあります。
 .INDENT 0.0
 .TP
-.B For Japanese developers
+.B For English speaker
+\fI\%groonga-talk@lists.sourceforge.net\fP
+.TP
+.B For Japanese speaker
 \fI\%groonga-dev@lists.sourceforge.jp\fP
 .UNINDENT
 .SH チュートリアル
 .SS 基本的な操作
 .sp
-groongaは、Cのライブラリとして使用する方法と、groonga実行ファイルを通して使用する方法があります。本チュートリアルでは、groonga実行ファイルを使用する方法について説明します。groonga実行ファイルを使って、DBの作成・操作・サーバの起動・サーバへの接続などの操作が行えます。
-.SS DBの作成
+groongaには、Cのライブラリとして使用する方法と、groonga実行ファイルを通して使用する方法があります。本チュートリアルでは、groonga実行ファイルを使用する方法について説明します。groonga実行ファイルを使って、データベースの作成・操作・サーバの起動・サーバへの接続などの操作が行えます。
+.SS データベースの作成
 .sp
 以下のようなコマンドを実行すると、データベースを新規に作成することができます。
 .sp
@@ -302,20 +454,20 @@ groonga \-n DB_PATH_NAME
 .ft P
 .fi
 .sp
-\-nオプションは、データベースを作ることを示します。データベースパス名には、新しく作成するデータベースのフルパス名を指定します。
+\-nオプションは、データベースを作ることを指示します。DB_PATH_NAMEには、新しく作成するデータベースのパスを指定します。指定されたパスが既に存在するときはコマンドが失敗するので注意してください。
 .sp
-上記コマンドでデータベースを作成すると、そのまま対話モードと呼ばれるコマンドを受け付けるモードになります。Ctrlキーを押しながらdキーを押すと、対話モードから抜けることができます。
+上記コマンドは、データベースを作成してから、コマンドの入力を受け付ける対話モードに入ります。Ctrlキーを押しながらdキーを押すと、対話モードから抜けることができます。
 .sp
 実行例:
 .sp
 .nf
 .ft C
 % groonga \-n /tmp/tutorial.db
-> ctrl\-d
+> Ctrl\-d
 %
 .ft P
 .fi
-.SS DBの操作
+.SS データベースの操作
 .sp
 書式:
 .sp
@@ -325,50 +477,40 @@ groonga DB_PATH_NAME [COMMAND]
 .ft P
 .fi
 .sp
-既存のデータベースのフルパス名をDBパス名に指定します。コマンドを指定すると、実行結果を返します。
+操作対象のデータベースのパスをDB_PATH_NAMEに指定します。
 .sp
-コマンドを指定しない場合には、対話モードに入ります。対話モードでは、標準入力からコマンドを読み込み、順次実行します。本チュートリアルでは、対話モードを主に使用します。
+COMMAND が指定された場合、COMMAND を実行した後、実行結果を返します。指定されなかった場合には、対話モードに入ります。対話モードでは、標準入力からコマンドを読み込み、順次実行します。本チュートリアルでは、対話モードを主に使用します。
 .sp
-たとえば、statusというコマンドを実行してみましょう。statusコマンドは、groongaの実行状態を返すコマンドです。
+それでは、statusというコマンドを実行してみましょう。statusコマンドは、groongaの実行状態を返すコマンドです。
 .sp
 実行例:
 .sp
 .nf
 .ft C
-> table_create \-\-name Type \-\-flags TABLE_HASH_KEY \-\-key_type ShortText
-[[0,1317212791.02322,0.03942904],true]
-> column_create \-\-table Type \-\-name number \-\-type Int32
-[[0,1317212791.26314,0.124383285],true]
-> column_create \-\-table Type \-\-name float \-\-type Float
-[[0,1317212791.58803,0.027924039],true]
-> column_create \-\-table Type \-\-name string \-\-type ShortText
-[[0,1317212791.81654,0.040399047],true]
-> column_create \-\-table Type \-\-name time \-\-type Time
-[[0,1317212792.05751,0.027354067],true]
-> load \-\-table Type
-> [{"_key":"sample","number":12345,"float":42.195,"string":"GROONGA","time":1234567890.12}]
-[[0,1317212792.28516,0.200775839],1]
-> select \-\-table Type
-[[0,1317212792.68655,0.000199477],[[[1],[["_id","UInt32"],["_key","ShortText"],["time","Time"],["string","ShortText"],["number","Int32"],["float","Float"]],[1,"sample",1234567890.12,"GROONGA",12345,42.195]]]]
+% groonga \-n /tmp/groonga\-databases/introduction.db
+> status
+[[0,1322616280.40348,0.000158121],{"alloc_count":127,"starttime":1322616279,"uptime":1,"version":"1.2.8\-9\-gbf05b82","n_queries":0,"cache_hit_rate":0.0,"command_version":1,"default_command_version":1,"max_command_version":2}]
 .ft P
 .fi
 .sp
-以上のように、コマンドの実行結果は基本的にjson形式で返却されます。jsonの配列の0番目の要素に、エラーコードや実行時間などの情報が入ります。jsonの配列の1番目の様子に、コマンドの実行結果が入ります。
-.SS コマンド
+以上のように、コマンドの実行結果は基本的にjson形式の配列として返却されます。配列の先頭には、エラーコードや実行時間などの情報が入ります。2番目の要素には、コマンドによって指定された操作の実行結果が入ります。
+.SS コマンドの書式
 .sp
-groonga実行ファイルやgroongaサーバを介して様々なコマンドを実行して、DBを操作することができます。コマンドは以下の書式のうちいずれかで与えることができます。
+データベースを操作するコマンドには、以下の書式で引数を与えます。:
 .sp
 .nf
 .ft C
-Form1: COMMAND ARGUMENT1 ARGUMENT2 ..
+Form_1: COMMAND VALUE_1 VALUE_2 ..
 
-Form2: COMMAND \-\-ARAGUMENT1 VALUE1 \-\-ARGUMENT2 VALUE2 ..
+Form_2: COMMAND \-\-NAME_1 VALUE_1 \-\-NAME_2 VALUE_2 ..
 .ft P
 .fi
 .sp
-書式1と2は混ぜて使うことができます。
+書式1では値を適切な順番で渡す必要があります。このような引数は、位置によって値の意味が決まるため、位置固定引数などと呼ばれることもあります。
+.sp
+書式2では値を名前と一緒に渡します。そのため、任意の順序で引数を指定することができます。このような引数は、名前付き引数やキーワード引数と呼ばれることもあります。
 .sp
-書式2において、空白や、記号「"\(aq()」のうちいずれかを含む値を指定したい場合は、シングルクォート(\(aq)かダブルクォート(")で値を囲みます。
+空白や特殊な記号「"\(aq()」を含む値を指定したいときは、シングルクォート(\(aq)かダブルクォート(")で値を囲むようにしてください。
 .sp
 詳しくは、 \fB/executables/groonga\fP のコマンドの項を参考にしてください。
 .SS 主なコマンド
@@ -380,13 +522,13 @@ Form2: COMMAND \-\-ARAGUMENT1 VALUE1 \-\-ARGUMENT2 VALUE2 ..
 groongaプロセスの状態を表示します。
 .TP
 .B \fB/commands/table_list\fP
-DBに定義されているテーブルのリストを表示します。
+データベースに定義されているテーブルのリストを表示します。
 .TP
 .B \fB/commands/column_list\fP
 テーブルに定義されているカラムのリストを表示します。
 .TP
 .B \fB/commands/table_create\fP
-DBにテーブルを追加します。
+データベースにテーブルを追加します。
 .TP
 .B \fB/commands/column_create\fP
 テーブルにカラムを追加します。
@@ -403,26 +545,21 @@ DBにテーブルを追加します。
 .sp
 \fB/commands/table_create\fP コマンドを使用してテーブルを作成します。
 .sp
-groongaでは、多くの場合テーブルを作成する際に主キーが必要となります。また、主キーには型と、その格納方法を指定する必要があります。
+groongaのテーブルには基本的に主キーが必要であり、テーブルを作成する際には型と格納方法も併せて指定する必要があります。
 .sp
-型については、のちのチュートリアルで触れます。データの種類をあらわしているもの、とイメージしてください。主キーの格納方法によって、主キーでの検索速度や、前方一致検索の可否が決まります。これも、のちのチュートリアルで触れます。
+型については後で説明するので、ここではデータの種類を表しているものという程度に考えてください。主キーの格納方法は、主キーを条件とする検索にかかる時間や、前方一致検索の可否などを左右します。こちらも後で説明します。
 .sp
-ここでは、ShortText型の主キー値を持ち、主キーの格納方法はHASHである、\(aqSite\(aqという名前のテーブルを作成します。
+それでは、\(aqSite\(aqという名前のテーブルを作成してみましょう。主キーについては、型がShortTextで格納方法はHASHとしています。
 .sp
 実行例:
 .sp
 .nf
 .ft C
-> column_create \-\-table Site \-\-name link \-\-type Site
-[[0,1317212792.88872,0.060705006],true]
-> load \-\-table Site
-> [{"_key":"http://example.org/","link":"http://example.net/"}]
-[[0,1317212793.14984,0.200481934],1]
-> select \-\-table Site \-\-output_columns _key,title,link._key,link.title \-\-query title:@this
-[[0,1317212793.55084,0.000485897],[[[1],[["_key","ShortText"],["title","ShortText"],["link._key","ShortText"],["link.title","ShortText"]],["http://example.org/","This is test record 1!","http://example.net/","test record 2."]]]]
+> table_create \-\-name Site \-\-flags TABLE_HASH_KEY \-\-key_type ShortText
+[[0,1322616280.60791,0.01234375],true]
 .ft P
 .fi
-.SS 検索
+.SS テーブルの表示
 .sp
 \fB/commands/select\fP コマンドを用いて、テーブルの中身を表示することができます。
 .sp
@@ -430,24 +567,19 @@ groongaでは、多くの場合テーブルを作成する際に主キーが必
 .sp
 .nf
 .ft C
-> column_create \-\-table Site \-\-name links \-\-flags COLUMN_VECTOR \-\-type Site
-[[0,1317212793.75262,0.049658904],true]
-> load \-\-table Site
-> [{"_key":"http://example.org/","links":["http://example.net/","http://example.org/","http://example.com/"]}]
-[[0,1317212794.00274,0.200473621],1]
-> select \-\-table Site \-\-output_columns _key,title,links._key,links.title \-\-query title:@this
-[[0,1317212794.40349,0.000384272],[[[1],[["_key","ShortText"],["title","ShortText"],["links._key","ShortText"],["links.title","ShortText"]],["http://example.org/","This is test record 1!",["http://example.net/","http://example.org/","http://example.com/"],["test record 2.","This is test record 1!","test test record three."]]]]]
+> select \-\-table Site
+[[0,1322616280.82196,0.000451873],[[[0],[["_id","UInt32"],["_key","ShortText"]]]]]
 .ft P
 .fi
 .sp
-selectにテーブル名を指定すると、指定したテーブルの中身を10件表示します。[0]は検索されたレコードの件数、["_id","Uint32"]は値がUInt32型である"_id\(aqという名前のカラム、["_key","ShortText"]は値がShortText型である\(aq_key\(aqという名前のカラムを示しています。
+selectにテーブル名のみを指定すると、指定したテーブルの中身を10件まで表示します。実行結果の[0]はテーブルに含まれるレコードの数を示しています。今回は何も登録されていないため0件です。レコード数の次に表示されている配列はテーブルの構成を示しています。["_id","Uint32"]はUInt32型の値を持つ\(aq_id\(aqという名前のカラム、["_key","ShortText"]はShortText型の値を持つ\(aq_key\(aqという名前のカラムをそれぞれ表しています。
 .sp
-table_createコマンドで作成したテーブルには、最初から\(aq_id\(aq/\(aq_key\(aqという２つのカラムがあります。\(aq_id\(aqはgroongaが自動的に付与するID番号が格納されるカラムです。\(aq_key\(aqは主キーが格納されるカラムです。これらのカラム名を変更することはできません。
+table_createコマンドで作成したテーブルには、最初から\(aq_id\(aq, \(aq_key\(aqという2つのカラムがあります。\(aq_id\(aqはgroongaが自動的に付与するID番号が格納されるカラムです。\(aq_key\(aqは主キーが格納されるカラムです。これらのカラム名を変更することはできません。
 .SS カラムの作成
 .sp
 \fB/commands/column_create\fP コマンドを用いて、カラムを作成することができます。
 .sp
-ShortText型の値を持つ、\(aqcomment\(aqという名前のカラムを\(aqSite\(aqテーブルに追加しましょう。
+ここでは、ShortText型の値を持つ\(aqtitle\(aqという名前のカラムを\(aqSite\(aqテーブルに追加してみましょう。
 .sp
 実行例:
 .sp
@@ -460,12 +592,14 @@ ShortText型の値を持つ、\(aqcomment\(aqという名前のカラムを\(aqS
 .ft P
 .fi
 .sp
-COLUMN_SCALARについては、通常のカラムであることを示しています。
+COLUMN_SCALAR は\(aqcomment\(aqを通常のカラムとして作成することを指示しています。
 .SS 全文検索用の語彙表の作成
 .sp
-このチュートリアルでは、groongaに登録したデータを用いた全文検索を行います。
+そろそろ全文検索の使い方について見ていきましょう。
+.sp
+groongaでは転置インデックスを使って高速な全文検索を実現しています。そのため、まずは転置インデックスとして用いるテーブルを作成する必要があります。テーブルの内容は、文書に含まれる単語やN\-gramなどの索引語を主キーとして、各カラムに索引語の位置情報を格納するという構成になります。結果として、主キーのカラムは全文検索における語彙表の役割を果たします。
 .sp
-全文検索を行う場合は、まず語彙表を作成する必要があります。語彙表とは、文書の中にある単語が主キーとなるテーブルです。ここでは、ShortText型の主キー値を持つ、\(aqTerms\(aqという名前のテーブルを作成しました。
+以下の例では、\(aqTerms\(aqという名前のテーブルを転置インデックスとして作成しています。索引語を格納するため、主キーの型はShortTextです。
 .sp
 実行例:
 .sp
@@ -478,10 +612,12 @@ COLUMN_SCALARについては、通常のカラムであることを示してい
 .sp
 この実行例には、多くのパラメータが指定されています。本チュートリアルでは、これらをすべて理解する必要はありません。以下に簡単な説明を記しますが、読み飛ばしてもらってかまいません。
 .sp
-実行例にある、TABLE_PAT_KEY|KEY_NORMALIZEという値は、主キー値をパトリシア木に格納し、各語彙を正規化して登録することを示しています。実行例にある、TokenBigramという値は、 語彙表として使用するテーブルは、対象の文書をトークナイズする方式を、default_tokenizerパラメータで与えます。この例ではTokenBigramを指定しています。よって、一般的にN\-gramと呼ばれるようなインデックス方式を選択しています。
+実行例にあるTABLE_PAT_KEY|KEY_NORMALIZEという値は、主キー値をパトリシア木に格納することと、各索引語を正規化して登録することを示しています。また、default_tokenizerというパラメータには、検索の対象となる文書をトークナイズする方式を与えるようになっています。この例では、一般的にN\-gramと呼ばれるインデックス方式に対応するTokenBigramを指定しています。
 .SS 全文検索用のインデックスカラムの作成
 .sp
-Siteテーブルのtitleカラムを全文検索の対象としたいとしましょう。その場合には、語彙表にインデックス型のカラムを作成します。
+次に必要なのは、インデックス型のカラムを作成することです。このカラムは、関連付けられたカラムに対する全文検索に利用されます。つまり、全文検索を行いたいカラムに対してインデックスを作成することに相当します。
+.sp
+それでは、Siteテーブルのtitleカラムを全文検索の対象とするべく、インデックス型のカラムを作成してみましょう。
 .sp
 実行例:
 .sp
@@ -492,10 +628,12 @@ Siteテーブルのtitleカラムを全文検索の対象としたいとしま
 .ft P
 .fi
 .sp
-Siteテーブルのtitleカラムを検索対象とする、\(aqblog_title\(aqという名前のインデックス型カラムをTermsテーブルに作成しました。インデックス対象となるテーブルをtypeに、インデックス対象となるカラムをsourceに指定します。実行例のflagsのCOLUMN_INDEX|WITH_POSITIONという値は、語彙の位置情報を格納するインデックス型のカラムであることを示しています。通常の全文検索インデックスでは、COLUMN_INDEX|WITH_POSITIONを指定してください。語彙の位置情報を格納する意味については、本チュートリアルでは触れません。
+Siteテーブルのtitleカラムを検索対象とする、\(aqblog_title\(aqという名前のインデックス型カラムをTermsテーブルに作成しました。インデックス対象となるテーブルをtypeに、インデックス対象となるカラムをsourceに指定します。実行例のflagsのCOLUMN_INDEX|WITH_POSITIONという値は、索引語の位置情報を格納するインデックス型のカラムであることを示しています。通常の全文検索インデックスでは、COLUMN_INDEX|WITH_POSITIONを指定してください。索引語の位置情報を格納する意味については、本チュートリアルでは触れません。
 .SS データのロード
 .sp
-\fB/commands/load\fP コマンドを使用します。loadコマンドでは、jsonで受け取ったデータをテーブルに格納します。
+\fB/commands/load\fP コマンドを使用します。loadコマンドでは、json形式で受け取ったデータをテーブルに格納します。
+.sp
+以下の例では9つのレコードをSiteテーブルに格納します。
 .sp
 実行例:
 .sp
@@ -529,7 +667,7 @@ selectコマンドで、データが入っていることを確認しましょ
 .fi
 .SS データの検索
 .sp
-groongaでは、\(aq_id\(aqカラムと\(aq_key\(aqカラムの値はテーブル中で一意です。よって、それを用いて検索してみましょう。
+データの準備もできたので全文検索を試してみたいところですが、その前に、\(aq_id\(aqカラムと\(aq_key\(aqカラムを用いた検索を行ってみましょう。これらのカラムは値を指定すればレコードが一意に決まります。
 .sp
 selectコマンドにおいて、queryパラメータを用いるとデータの検索を行うことができます。
 .sp
@@ -569,13 +707,9 @@ queryパラメータでは、インデックスを用いた全文検索を行う
 .ft P
 .fi
 .sp
-titleカラムに対して、\(aqthis\(aqという文字列で全文検索を行った結果を返します。
+queryパラメータに与えた「title:@this」は、\(aqtitle\(aqという名前のカラムに\(aqthis\(aqという文字列が含まれているレコードを検索する、という意味を持ちます。この例では1つのレコードが検索条件に該当しています。転置インデックスを作成するときにKEY_NORMALIZEという値を指定したため、大文字と小文字の違いが吸収されていることに注意してください。
 .sp
-queryパラメータに与えた「title:@this」というのが、\(aqtitle\(aqという名前のカラムに\(aqthis\(aqという文字列が含まれているレコードを検索する、という意味です。
-.sp
-selectコマンドには、match_columnsというパラメータが存在します。
-.sp
-これを指定すると、query内にカラム名を指定しない条件があった場合、match_columnsで指定されたカラムに対しての検索であることを示します。[1]_
+selectコマンドには、match_columnsというパラメータが存在します。このパラメータはデフォルトで検索対象にするカラムを指定するもので、カラム名を指定しない検索条件にのみ適用されます。[1]_
 .sp
 match_columnsパラメータに\(aqtitle\(aq、queryパラメータに\(aqthis\(aqという文字列を指定すると、上記のクエリと同じ結果を得ることができます。
 .sp
@@ -589,9 +723,7 @@ match_columnsパラメータに\(aqtitle\(aq、queryパラメータに\(aqthis\(
 .fi
 .SS 出力カラムの指定
 .sp
-selectコマンドにおいて、output_columnsパラメータを用いることで、検索結果で表示するカラムを指定することが出来ます。
-.sp
-複数のカラムを指定する場合は、カンマ(,)区切りで指定します。
+selectコマンドにおいて、output_columnsパラメータを用いることで、検索結果に含めるカラムを指定することができます。複数のカラムを指定する場合は、カンマ(,)区切りで指定します。
 .sp
 実行例:
 .sp
@@ -602,14 +734,12 @@ selectコマンドにおいて、output_columnsパラメータを用いること
 .ft P
 .fi
 .sp
-groongaの検索結果には、「_score」という名前のカラムが追加されています。このカラムは、全文検索の条件が合致する文書ほど高い数値が入ります。
+この例では、「_score」という名前のカラムを含む3つのカラムを指定しています。「_score」という名前のカラムはgroongaの検索結果に含まれるカラムです。このカラムには、全文検索の条件に合致する文書ほど高い数値が入ります。
 .SS 表示範囲指定
 .sp
-selectコマンドにおいて、offset,limitパラメータを用いることで、検索結果から指定された範囲のみを表示することが出来ます。大量の検索結果をページで分けて、1ページ分のみを表示したい場合に有用です。
+selectコマンドにおいて、offset,limitパラメータを用いることで、検索結果から指定された範囲のみを表示することができます。大量の検索結果をページで分けて、1ページ分のみを表示したい場合に有用です。
 .sp
-offsetパラメータには、検索結果を返す始点を指定します。1件目から結果を返す場合には、0を指定します。
-.sp
-limitパラメータには、検索結果を何件表示するのかを指定します。
+offsetパラメータには、検索結果を返す始点を指定します。1件目から結果を返す場合には、0を指定します。limitパラメータには、検索結果の表示件数を指定します。
 .sp
 実行例:
 .sp
@@ -625,9 +755,9 @@ limitパラメータには、検索結果を何件表示するのかを指定し
 .fi
 .SS 並び替え
 .sp
-selectコマンドにおいて、sortbyパラメータを用いることで、検索結果を並び替えることが出来ます。
+selectコマンドにおいて、sortbyパラメータを用いることで、検索結果を並び替えることができます。
 .sp
-sortbyパラメータにカラム名を指定することで、そのカラムの値で昇順にソートします。また、カラム名の前にハイフン（\-）を付けることで、降順にソートすることも出来ます。
+sortbyパラメータにカラム名を指定することで、そのカラムの値で昇順にソートします。また、カラム名の前にハイフン（\-）を付けることで、降順にソートすることもできます。
 .sp
 実行例:
 .sp
@@ -747,7 +877,7 @@ protocolオプションで、groongaが受け付けるプロトコルを指定
 コマンド実行後、http://[IPアドレスまたはホスト名]:[ポート番号]/ というURLにブラウザからアクセスすると、HTML管理ツールが表示されます。ブラウザは、JavaScriptの実行が有効になっている必要があります。
 .SS HTTPでのコマンド実行
 .sp
-groongaがHTTPプロトコルモードで起動されているとき、「/d/コマンド名」というURLにアクセスすると、コマンドを実行することが出来ます。
+groongaがHTTPプロトコルモードで起動されているとき、「/d/コマンド名」というURLにアクセスすると、コマンドを実行することができます。
 .sp
 コマンドのオプションは、HTTPのGETパラメータで渡します。つまり、「?オプション=値&オプション=値 …」という書式になります。
 .sp
@@ -785,20 +915,20 @@ groongaでは、数値（整数・小数）や文字列や時刻や経緯度な
 .nf
 .ft C
 > table_create \-\-name Type \-\-flags TABLE_HASH_KEY \-\-key_type ShortText
-[[0,1317212791.02322,0.03942904],true]
+[[0,1322616293.7274,0.012551106],true]
 > column_create \-\-table Type \-\-name number \-\-type Int32
-[[0,1317212791.26314,0.124383285],true]
+[[0,1322616293.94115,0.008619605],true]
 > column_create \-\-table Type \-\-name float \-\-type Float
-[[0,1317212791.58803,0.027924039],true]
+[[0,1322616294.15095,0.004959989],true]
 > column_create \-\-table Type \-\-name string \-\-type ShortText
-[[0,1317212791.81654,0.040399047],true]
+[[0,1322616294.35693,0.005551818],true]
 > column_create \-\-table Type \-\-name time \-\-type Time
-[[0,1317212792.05751,0.027354067],true]
+[[0,1322616294.56333,0.006356953],true]
 > load \-\-table Type
 > [{"_key":"sample","number":12345,"float":42.195,"string":"GROONGA","time":1234567890.12}]
-[[0,1317212792.28516,0.200775839],1]
+[[0,1322616294.77086,0.202357708],1]
 > select \-\-table Type
-[[0,1317212792.68655,0.000199477],[[[1],[["_id","UInt32"],["_key","ShortText"],["time","Time"],["string","ShortText"],["number","Int32"],["float","Float"]],[1,"sample",1234567890.12,"GROONGA",12345,42.195]]]]
+[[0,1322616295.1744,0.000340057],[[[1],[["_id","UInt32"],["_key","ShortText"],["float","Float"],["number","Int32"],["string","ShortText"],["time","Time"]],[1,"sample",42.195,12345,"GROONGA",1234567890.12]]]]
 .ft P
 .fi
 .SS テーブル型
@@ -816,12 +946,12 @@ table_createで作成したテーブルを、カラムの型として使うこ
 .nf
 .ft C
 > column_create \-\-table Site \-\-name link \-\-type Site
-[[0,1317212792.88872,0.060705006],true]
+[[0,1322616295.37864,0.005674045],true]
 > load \-\-table Site
 > [{"_key":"http://example.org/","link":"http://example.net/"}]
-[[0,1317212793.14984,0.200481934],1]
+[[0,1322616295.5854,0.200879317],1]
 > select \-\-table Site \-\-output_columns _key,title,link._key,link.title \-\-query title:@this
-[[0,1317212793.55084,0.000485897],[[[1],[["_key","ShortText"],["title","ShortText"],["link._key","ShortText"],["link.title","ShortText"]],["http://example.org/","This is test record 1!","http://example.net/","test record 2."]]]]
+[[0,1322616295.98732,0.000872177],[[[1],[["_key","ShortText"],["title","ShortText"],["link._key","ShortText"],["link.title","ShortText"]],["http://example.org/","This is test record 1!","http://example.net/","test record 2."]]]]
 .ft P
 .fi
 .sp
@@ -841,12 +971,12 @@ column_createコマンドでカラムを作成するとき、\-\-flagsオプシ
 .nf
 .ft C
 > column_create \-\-table Site \-\-name links \-\-flags COLUMN_VECTOR \-\-type Site
-[[0,1317212793.75262,0.049658904],true]
+[[0,1322616296.19238,0.007598942],true]
 > load \-\-table Site
 > [{"_key":"http://example.org/","links":["http://example.net/","http://example.org/","http://example.com/"]}]
-[[0,1317212794.00274,0.200473621],1]
+[[0,1322616296.40092,0.201036234],1]
 > select \-\-table Site \-\-output_columns _key,title,links._key,links.title \-\-query title:@this
-[[0,1317212794.40349,0.000384272],[[[1],[["_key","ShortText"],["title","ShortText"],["links._key","ShortText"],["links.title","ShortText"]],["http://example.org/","This is test record 1!",["http://example.net/","http://example.org/","http://example.com/"],["test record 2.","This is test record 1!","test test record three."]]]]]
+[[0,1322616296.80305,0.000899975],[[[1],[["_key","ShortText"],["title","ShortText"],["links._key","ShortText"],["links.title","ShortText"]],["http://example.org/","This is test record 1!",["http://example.net/","http://example.org/","http://example.com/"],["test record 2.","This is test record 1!","test test record three."]]]]]
 .ft P
 .fi
 .sp
@@ -1805,6 +1935,8 @@ groongaでは、 \fB/commands/select\fP コマンドにquery_expansionパラメ
 .sp
 クエリ拡張機能を使用するためには、検索対象となる文書を格納するテーブル(ここでは文書テーブルと呼びます)以外に、ユーザの指定した検索文字列を置換するためのテーブル(ここでは置換テーブルと呼びます)を準備します。置換テーブルでは、その主キーが置換前の文字列となり、文字列型(ShortText)のカラムの値が置換後の文字列となります。
 .sp
+TODO: 文字列型のベクターカラムでも可能であり、その場合は各要素をORでつなげたものに置換されるということを記述する。
+.sp
 実際に文書テーブルと置換テーブルを作成してみましょう。
 .sp
 実行例:
@@ -1869,9 +2001,6 @@ groongaでは、 \fB/commands/select\fP コマンドにquery_expansionパラメ
 .sp
 どちらのクエリ文字列も、"(シークァーサー OR シークヮーサー)"という文字列に置換されてから検索されるため、表記の揺れを吸収して検索できるようになりました。
 .SH サジェスト
-.IP ノート
-サジェスト機能の仕様はまだ確定していません。仕様は変更される可能性があります。
-.RE
 .sp
 groongaにはサジェスト機能があります。このセクションではこの機能の使い方とどのように動作しているかを説明します。
 .SS はじめに
@@ -2584,7 +2713,7 @@ groongaは位置情報データのうち座標データのみサポートして
 .sp
 以下の図はレコードのみがある図です。黒い点がレコードを表しています。以降の図ではレコードがどのように扱われるかを示します。
 [image: only records]
-[image]
+[画像]
 .sp
 執筆中。。。 （ \fI\%下書き\fP ）
 .SH リファレンスマニュアル
@@ -3313,6 +3442,198 @@ TODO
 \fB/suggest\fP
 .. : doc:\fIgroonga\-suggest\-httpd\fP
 .. : doc:\fIgroonga\-suggest\-learner\fP
+.SS 出力
+.sp
+groongaは以下の出力形式をサポートしています。
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.IP \(bu 2
+\fI\%JSON\fP
+.IP \(bu 2
+\fI\%XML\fP
+.IP \(bu 2
+TSV（タブ区切り形式）
+.IP \(bu 2
+\fI\%MessagePack\fP
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.sp
+JSONがデフォルトの出力形式です。
+.SS 使い方
+.sp
+groongaには以下のクエリインターフェイスがあります。
+.INDENT 0.0
+.INDENT 3.5
+.INDENT 0.0
+.IP \(bu 2
+コマンドライン
+.IP \(bu 2
+HTTP
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.sp
+それぞれのインターフェイスで出力形式を変更する方法は異なります。
+.SS コマンドライン
+.sp
+\fBgroonga DB_PATH\fP または \fBgroonga \-c\fP でコマンドラインクエリインターフェイスを使うことができます。これらのgroongaコマンドでは \fB> \(ga\(ga というプロンプトが表示されます。クエリインターフェイスでは \(ga\(gaoutput_type\fP オプションで出力形式を指定できます。
+.sp
+\fBoutput_type\fP オプションを指定しない場合はJSON形式の出力になります:
+.sp
+.nf
+.ft C
+> status
+[[0,1327721628.10738,0.000131845474243164],{"alloc_count":142,"starttime":1327721626,"uptime":2,"version":"1.2.9\-92\-gb87d9f8","n_queries":0,"cache_hit_rate":0.0,"command_version":1,"default_command_version":1,"max_command_version":2}]
+.ft P
+.fi
+.sp
+明示的に \fBoutput_type\fP に \fBjson\fP を指定することもできます。この場合はJSON形式の出力になります:
+.sp
+.nf
+.ft C
+> status \-\-output_type json
+[[0,1327721639.08321,7.93933868408203e\-05],{"alloc_count":144,"starttime":1327721626,"uptime":13,"version":"1.2.9\-92\-gb87d9f8","n_queries":0,"cache_hit_rate":0.0,"command_version":1,"default_command_version":1,"max_command_version":2}]
+.ft P
+.fi
+.sp
+XML形式の出力にする場合は \fBoutput_type\fP に \fBxml\fP を指定します:
+.sp
+.nf
+.ft C
+> status \-\-output_type xml
+<?xml version="1.0" encoding="utf\-8"?>
+<RESULT CODE="0" UP="1327721649.61095" ELAPSED="0.000126361846923828">
+<RESULT>
+<TEXT>alloc_count</TEXT>
+<INT>146</INT>
+<TEXT>starttime</TEXT>
+<INT>1327721626</INT>
+<TEXT>uptime</TEXT>
+<INT>23</INT>
+<TEXT>version</TEXT>
+<TEXT>1.2.9\-92\-gb87d9f8</TEXT>
+<TEXT>n_queries</TEXT>
+<INT>0</INT>
+<TEXT>cache_hit_rate</TEXT>
+<FLOAT>0.0</FLOAT>
+<TEXT>command_version</TEXT>
+<INT>1</INT>
+<TEXT>default_command_version</TEXT>
+<INT>1</INT>
+<TEXT>max_command_version</TEXT>
+<INT>2</INT></RESULT>
+</RESULT>
+.ft P
+.fi
+.sp
+TSV形式の出力にする場合は \fBoutput_type\fP に \fBtsv\fP を指定します::<
+.sp
+.nf
+.ft C
+> status \-\-output_type tsv
+0     1327721664.82675        0.000113964080810547
+"alloc_count" 146
+"starttime"   1327721626
+"uptime"      38
+"version"     "1.2.9\-92\-gb87d9f8"
+"n_queries"   0
+"cache_hit_rate"      0.0
+"command_version"     1
+"default_command_version"     1
+"max_command_version" 2
+END
+.ft P
+.fi
+.sp
+MessagePack形式の出力にする場合は \fBoutput_type\fP に \fBmsgpack\fP を指定します::<
+.sp
+.nf
+.ft C
+> status \-\-output_type msgpack
+(... omitted because MessagePack is binary data format. ...)
+.ft P
+.fi
+.SS HTTP
+.sp
+\fBgroonga \-\-protocol http \-s DB_PATH\fP でHTTPクエリインターフェイスを使うことができます。groonga HTTPサーバーはデフォルトで10041番ポートで起動します。このクエリインターフェイスでは拡張子で出力形式を指定します。
+.sp
+拡張子を指定しない場合はJSON形式の出力になります:
+.sp
+.nf
+.ft C
+% curl http://localhost:10041/d/status
+[[0,1327809294.54311,0.00082087516784668],{"alloc_count":155,"starttime":1327809282,"uptime":12,"version":"1.2.9\-92\-gb87d9f8","n_queries":0,"cache_hit_rate":0.0,"command_version":1,"default_command_version":1,"max_command_version":2}]
+.ft P
+.fi
+.sp
+明示的に \fBjson\fP 拡張子を指定することもできます。この場合はJSON形式の出力になります:
+.sp
+.nf
+.ft C
+% curl http://localhost:10041/d/status.json
+[[0,1327809319.01929,9.5367431640625e\-05],{"alloc_count":157,"starttime":1327809282,"uptime":37,"version":"1.2.9\-92\-gb87d9f8","n_queries":0,"cache_hit_rate":0.0,"command_version":1,"default_command_version":1,"max_command_version":2}]
+.ft P
+.fi
+.sp
+XML形式の出力にする場合は \fBxml\fP 拡張子を指定します:
+.sp
+.nf
+.ft C
+% curl http://localhost:10041/d/status.xml
+<?xml version="1.0" encoding="utf\-8"?>
+<RESULT CODE="0" UP="1327809339.5782" ELAPSED="9.56058502197266e\-05">
+<RESULT>
+<TEXT>alloc_count</TEXT>
+<INT>159</INT>
+<TEXT>starttime</TEXT>
+<INT>1327809282</INT>
+<TEXT>uptime</TEXT>
+<INT>57</INT>
+<TEXT>version</TEXT>
+<TEXT>1.2.9\-92\-gb87d9f8</TEXT>
+<TEXT>n_queries</TEXT>
+<INT>0</INT>
+<TEXT>cache_hit_rate</TEXT>
+<FLOAT>0.0</FLOAT>
+<TEXT>command_version</TEXT>
+<INT>1</INT>
+<TEXT>default_command_version</TEXT>
+<INT>1</INT>
+<TEXT>max_command_version</TEXT>
+<INT>2</INT></RESULT>
+</RESULT>
+.ft P
+.fi
+.sp
+TSV形式の出力にする場合は \fBtsv\fP 拡張子を指定します:
+.sp
+.nf
+.ft C
+% curl http://localhost:10041/d/status.tsv
+0     1327809366.84187        8.44001770019531e\-05
+"alloc_count" 159
+"starttime"   1327809282
+"uptime"      84
+"version"     "1.2.9\-92\-gb87d9f8"
+"n_queries"   0
+"cache_hit_rate"      0.0
+"command_version"     1
+"default_command_version"     1
+"max_command_version" 2
+END
+.ft P
+.fi
+.sp
+MessagePack形式の出力にする場合は \fBmsgpack\fP 拡張子を指定します:
+.sp
+.nf
+.ft C
+% curl http://localhost:10041/d/status.msgpack
+(... omitted because MessagePack is binary data format. ...)
+.ft P
+.fi
 .SS コマンド
 .sp
 まず、すべてのコマンドに関係するコマンドバージョンについて説明します。その後、組み込みのコマンドを順に説明します。
@@ -4166,7 +4487,7 @@ delete \- 一件のレコードの削除
 .sp
 .nf
 .ft C
-delete table [key [id]]
+delete table [key [id [filter]]]
 .ft P
 .fi
 .SS 説明
@@ -4197,6 +4518,13 @@ deleteは、使用しているデータベースのテーブルに1件のレコ
 .UNINDENT
 .UNINDENT
 .sp
+\fBfilter\fP
+.INDENT 0.0
+.INDENT 3.5
+script形式のgrn_expr文字列によってレコードを指定します。filterパラメータを指定する場合は、id及びkeyパラメータを指定してはいけません。
+.UNINDENT
+.UNINDENT
+.sp
 返値
 \-\-\-
 .SS json形式
@@ -5437,10 +5765,13 @@ table_createコマンドは、使用しているデータベースに対して
 .INDENT 0.0
 .TP
 .B 0, \fBTABLE_HASH_KEY\fP
-主キー値をハッシュ表で管理するテーブルを作成します。ハッシュ表を使用したテーブルでは、主キー値に完全一致するレコードを高速に検索することができます。
+主キー値をハッシュ表で管理するテーブルを作成します。ハッシュ表を使用したテーブルでは、主キー値に完全一致するレコードを非常に高速に検索することができます。
 .TP
 .B 1, \fBTABLE_PAT_KEY\fP
-主キー値をパトリシア木で管理するテーブルを作成します。パトリシア木を使用したテーブルでは、主キー値に完全一致するレコード、前方一致するレコード、および最長共通接頭辞となるレコードを高速に検索することができます。また、キー値の昇降順でレコードを取り出したり、キー値の範囲での検索を行うことができます。また、flagsの値に64を加えることによって、後方一致検索も可能となります。
+主キー値をパトリシア木で管理するテーブルを作成します。パトリシア木を使用したテーブルでは、主キー値に完全一致するレコードを検索することができるとともに、前方一致するレコード、および最長共通接頭辞となるレコードを高速に検索することができます。また、キー値の昇降順でレコードを取り出したり、キー値の範囲での検索を行うことができます。また、flagsの値に64を加えることによって、後方一致検索も可能となります。
+.TP
+.B 2, \fBTABLE_DAT_KEY\fP
+主キー値をダブル配列で管理するテーブルを作成します。ダブル配列を使用したテーブルでは、主キー値に完全一致するレコードを高速に検索することができるとともに、前方一致するレコード、および最長共通接頭辞となるレコードを検索することができます。また、キー値の昇降順でレコードを取り出したり、キー値の範囲での検索を行うことができます。
 .TP
 .B 3, \fBTABLE_NO_KEY\fP
 主キーを持たないテーブルを作成します。各レコードはIDのみによって特定することができます。
@@ -5891,11 +6222,11 @@ ieee754形式の64bit浮動小数点数。
 .SS テーブルの主キーに指定できない型
 .sp
 Text型とLongText型については、テーブルの主キーに指定することはできません。
-.SS ベクトルとして格納できない型
+.SS ベクターとして格納できない型
 .sp
-groongaのカラムは、ある型のベクトルを保存することができます。しかし、ShortText, Text, LongTextの３つの型についてはベクトルとして保存することはできません。
+groongaのカラムは、ある型のベクターを保存することができます。しかし、ShortText, Text, LongTextの３つの型についてはベクターとして保存したり出力したりすることはできますが、検索条件やドリルダウン条件に指定することができません。
 .sp
-テーブル型は、ベクトルとして格納することができます。よって、ShortTextのベクトルを保存したい場合には、主キーがShortText型のテーブルを別途作成し、そのテーブルを型として利用します。
+テーブル型は、ベクターとして格納することができます。よって、ShortTextのベクターを検索条件やドリルダウン条件に使用したい場合には、主キーがShortText型のテーブルを別途作成し、そのテーブルを型として利用します。
 脚注
 .IP [1] 5
 Object型はv1.2でサポートされます。
@@ -6031,7 +6362,7 @@ geo_distance \- 指定した2点の距離を計算する
 .sp
 .nf
 .ft C
-geo_distance(point1, point2)
+geo_distance(point1, point2[, approximate_type])
 .ft P
 .fi
 .SS 説明
@@ -6039,7 +6370,14 @@ geo_distance(point1, point2)
 groonga組込関数の一つであるgeo_distanceについて説明します。組込関数は、script形式のgrn_expr中で呼び出すことができます。
 .sp
 geo_distance() 関数は、point1に指定した座標とpoint2に指定した座標の間の距離(近似値)を求めます。
-geo_distance()の他に、距離計算アルゴリズムの異なる、geo_distance2()、geo_distance3()が使用できます。それぞれ、長方形近似、球面近似、ヒュベニの距離計算式によって距離を算出します。
+.sp
+... note:
+.sp
+.nf
+.ft C
+geo_distance()の他に、距離計算アルゴリズムの異なる、geo_distance2()、geo_distance3()がありましたが、1.2.9から非推奨になりました。 \(ga\(gageo_distance2()\(ga\(ga の代わりに \(ga\(gageo_distance(point1, point2, "sphere")\(ga\(ga を、 \(ga\(gageo_distance3()\(ga\(ga の代わりに \(ga\(gageo_distance(point1, point2, "ellipsoid")\(ga\(ga を使ってください。
+.ft P
+.fi
 .SS 引数
 .sp
 \fBpoint1\fP
@@ -6055,6 +6393,42 @@ geo_distance()の他に、距離計算アルゴリズムの異なる、geo_dista
 距離を求める2点のうちもう一つを指定します。GeoPoint型の値、あるいは座標を示す文字列を指定できます。
 .UNINDENT
 .UNINDENT
+.sp
+\fBapproximate_type\fP
+.INDENT 0.0
+.INDENT 3.5
+距離を求めるために地形をどのように近似するかを指定します。指定できる値は以下の通りです。
+.sp
+\fB"rectangle"\fP
+.INDENT 0.0
+.INDENT 3.5
+方形近似で近似します。単純な計算式で距離を求めることができるため高速ですが、極付近では誤差が大きくなります。
+.sp
+\fB"rect"\fP と省略して指定することもできます。
+.sp
+この近似方法がデフォルト値です。 \fBapproximate_type\fP を省略した場合は方形近似になります。
+.UNINDENT
+.UNINDENT
+.sp
+\fB"sphere"\fP
+.INDENT 0.0
+.INDENT 3.5
+球面近似で近似します。 \fB"rectangle"\fP よりも遅くなりますが、誤差は小さいです。
+.sp
+\fB"sphr"\fP と省略して指定することもできます。
+.UNINDENT
+.UNINDENT
+.sp
+\fB"ellipsoid"\fP
+.INDENT 0.0
+.INDENT 3.5
+楕円体近似で近似します。距離の計算にはヒュベニの距離計算式を用います。 \fB"sphere"\fP よりも遅くなりますが、誤差は小さくなります。
+.sp
+\fB"ellip"\fP と省略して指定することもできます。
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.UNINDENT
 .SS 返値
 .sp
 指定した2点の距離をFloat型の値(単位:メートル)として返します。
@@ -6063,7 +6437,19 @@ geo_distance()の他に、距離計算アルゴリズムの異なる、geo_dista
 .nf
 .ft C
 geo_distance(pos, "150x150")
-100
+100.0
+
+# 方形近似を利用
+geo_distance(pos, "150x150", "rectangle")
+100.0
+
+# 球面近似を利用
+geo_distance(pos, "150x150", "sphere")
+100.0
+
+# 楕円体近似を利用
+geo_distance(pos, "150x150", "ellipsoid")
+100.0
 .ft P
 .fi
 脚注
@@ -6077,7 +6463,7 @@ geo_in_circle \- 座標が円の範囲内に存在するかどうかを調べま
 .sp
 .nf
 .ft C
-geo_in_circle(point, center, radious_or_point)
+geo_in_circle(point, center, radious_or_point[, approximate_type])
 .ft P
 .fi
 .SS 説明
@@ -6108,6 +6494,42 @@ geo_in_circle() 関数は、pointに指定した座標が、centerに指定し
 Point型の値、あるいは座標を示す文字列を指定した場合は、円周上の点の一つの座標が指定されたものとみなします。
 .UNINDENT
 .UNINDENT
+.sp
+\fBapproximate_type\fP
+.INDENT 0.0
+.INDENT 3.5
+半径からの距離を求めるために地形をどのように近似するかを指定します。指定できる値は以下の通りです。
+.sp
+\fB"rectangle"\fP
+.INDENT 0.0
+.INDENT 3.5
+方形近似で近似します。単純な計算式で距離を求めることができるため高速ですが、極付近では誤差が大きくなります。
+.sp
+\fB"rect"\fP と省略して指定することもできます。
+.sp
+この近似方法がデフォルト値です。 \fBapproximate_type\fP を省略した場合は方形近似になります。
+.UNINDENT
+.UNINDENT
+.sp
+\fB"sphere"\fP
+.INDENT 0.0
+.INDENT 3.5
+球面近似で近似します。 \fB"rectangle"\fP よりも遅くなりますが、誤差は小さいです。
+.sp
+\fB"sphr"\fP と省略して指定することもできます。
+.UNINDENT
+.UNINDENT
+.sp
+\fB"ellipsoid"\fP
+.INDENT 0.0
+.INDENT 3.5
+楕円体近似で近似します。距離の計算にはヒュベニの距離計算式を用います。 \fB"sphere"\fP よりも遅くなりますが、誤差は小さくなります。
+.sp
+\fB"ellip"\fP と省略して指定することもできます。
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.UNINDENT
 .SS 返値
 .sp
 pointに指定した座標が円の範囲内にあるかどうかをBool型の値で返します。
@@ -6668,7 +7090,7 @@ groongaにはいくつか制限事項があります。
 最大インデックスサイズ: 256GByte
 .UNINDENT
 .sp
-(実際には他の諸条件の制約により上記の値まで到達しない場合もあります)
+実際には他の諸条件の制約により上記の値まで到達しない場合もあります。
 .SH トラブルシューティング
 .SS 同じ検索キーワードなのに全文検索結果が異なる
 .sp
@@ -7462,7 +7884,7 @@ doc/locale/${LANGUAGE}/LC_MESSAGES/以下を.tar.gzや.zipなどでアーカイ
 .SH AUTHOR
 groonga project
 .SH COPYRIGHT
-2009-2011, Brazil, Inc
+2009-2012, Brazil, Inc
 .\" Generated by docutils manpage writer.
 .\" 
 .