rroonga 0.9.5-x86-mingw32 → 1.0.1-x86-mingw32

data/vendor/local/share/groonga/doc/ja/source/http.txt

@@ -0,0 +1,52 @@
+.. highlightlang:: none
+
+http
+====
+
+名前
+----
+
+groonga httpサービス
+
+書式
+----
+::
+
+ groonga -d --protocol http --document-root /usr/share/groonga/admin_html dest
+
+説明
+----
+
+groongaサーバを起動する時に--protocolオプションにhttpを指定すると、httpで通信可能になります。また、--document-root によって静的ページのパスを指定すると、httpリクエストに指定されたURIに対応する、パス配下に置かれたファイルを出力します。
+
+デフォルトでは/usr/share/groonga/admin_html配下に、データベース管理ツールとなるファイル群がインストールされますので、このパスを指定してgroongaサーバを起動し、ウェブブラウザでhttp://hostname:port/index.htmlにアクセスすると、管理ツールが使用可能になります。
+
+コマンド
+--------
+
+httpを指定して起動したgroongaサーバに対しても、他のモードで起動したgroongaと同じコマンドが使用できます。
+
+コマンドは、複数の引数をとります。引数にはそれぞれ名前があります。また、特殊な引数である「output_type」があります。
+
+スタンドアロンやクライアントモードでは、コマンドは以下のような形式で指定します。
+
+ 形式1: コマンド名 値1 値2,..
+
+ 形式2: コマンド名 --引数名1 値1 --引数名2 値2,..
+
+形式1と形式2は混在させることができます。これらの形式では、output_typeという引数名を用いてoutput_typeを指定します。
+
+httpでgroongaサーバと通信する際には、以下のような形式でコマンドを指定します。::
+
+ 形式: /d/コマンド名.output_type?引数名1=値1&引数名2=値2&...
+
+ただし、コマンド名、引数名、値はURLエンコードが必要です。
+
+GETメソッドのみが使用可能です。
+
+output_typeにはjson, tsv, xmlが指定可能です。
+
+返値
+----
+
+output_typeの指定に従って、コマンドの実行結果を出力します。

data/vendor/local/share/groonga/doc/ja/source/index.txt

@@ -0,0 +1,21 @@
+.. groonga documentation master file, created by
+   sphinx-quickstart on Thu Oct 22 15:42:37 2009.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+groonga ドキュメント
+====================
+
+.. toctree::
+   :maxdepth: 3
+   :numbered:
+
+   characteristic
+   install
+   tutorial
+   reference
+   developer
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`

data/vendor/local/share/groonga/doc/ja/source/install.txt

@@ -0,0 +1,114 @@
+.. highlightlang:: none
+
+インストール
+============
+
+それぞれの環境毎にインストール方法を説明します。
+
+Debian GNU/Linux lenny
+----------------------
+
+/etc/apt/sources.list.d/groonga.list::
+
+  deb http://packages.groonga.org/debian/ lenny main
+  deb-src http://packages.groonga.org/debian/ lenny main
+
+インストール::
+
+  % sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 1C837F31
+  % sudo aptitude update
+  % sudo aptitude -V -D -y install groonga libgroonga-dev
+
+Debian GNU/Linux squeeze
+------------------------
+
+/etc/apt/sources.list.d/groonga.list::
+
+  deb http://packages.groonga.org/debian/ squeeze main
+  deb-src http://packages.groonga.org/debian/ squeeze main
+
+インストール::
+
+  % sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 1C837F31
+  % sudo aptitude update
+  % sudo aptitude -V -D -y install groonga libgroonga-dev
+
+Debian GNU/Linux sid
+--------------------
+
+/etc/apt/sources.list.d/groonga.list::
+
+  deb http://packages.groonga.org/debian/ unstable main
+  deb-src http://packages.groonga.org/debian/ unstable main
+
+インストール::
+
+  % sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 1C837F31
+  % sudo aptitude update
+  % sudo aptitude -V -D -y install groonga libgroonga-dev
+
+Ubuntu 8.04 LTS Hardy Heron
+---------------------------
+
+注: Ubuntu本家のuniverseセクションもインストール対象としておくこと
+
+/etc/apt/sources.list.d/groonga.list::
+
+  deb http://packages.groonga.org/ubuntu/ hardy universe
+  deb-src http://packages.groonga.org/ubuntu/ hardy universe
+
+インストール::
+
+  % sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 1C837F31
+  % sudo aptitude update
+  % sudo aptitude -V -D -y install groonga libgroonga-dev
+
+Ubuntu 10.04 Lucid Lynx
+-----------------------
+
+注: Ubuntu本家のuniverseセクションもインストール対象としておくこと
+
+/etc/apt/sources.list.d/groonga.list::
+
+  deb http://packages.groonga.org/ubuntu/ karmic universe
+  deb-src http://packages.groonga.org/ubuntu/ karmic universe
+
+インストール::
+
+  % sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 1C837F31
+  % sudo aptitude update
+  % sudo aptitude -V -D -y install groonga libgroonga-dev
+
+CentOS 5
+--------
+
+インストール::
+
+  % sudo rpm -ivh http://packages.groonga.org/centos/groonga-repository-1.0.0-0.noarch.rpm
+  % sudo yum update
+  % sudo yum install -y groonga groonga-tokenizer-mecab groonga-devel
+
+Fedora 13
+---------
+
+インストール::
+
+  % sudo rpm -ivh http://packages.groonga.org/fedora/groonga-repository-1.0.0-0.noarch.rpm
+  % sudo yum update
+  % sudo yum install -y groonga groonga-tokenizer-mecab groonga-devel
+
+その他
+------
+
+形態素単位でトークナイズした全文検索索引を使用したい場合は、
+groongaのインストール前にMeCab
+(http://mecab.sourceforge.net/)をインストールしてください。
+
+http://groonga.org/download/よりtar.gzファイルを取得し、
+インストール先の環境にファイルを展開して、 ::
+
+ ./configure --prefix=/usr --localstatedir=/var && make && sudo make install
+
+のように実行することでインストールできます。
+
+prefixは、インストール先を指定するパラメータです。prefixを指定しない場合には、/usr/localが指定されたものとみなします。LD_LIBRARY_PATHなどに詳しくない人は、上記のように/usrを指定することをお勧めします。

data/vendor/local/share/groonga/doc/ja/source/news.txt

@@ -0,0 +1,199 @@
+.. highlightlang:: none
+
+お知らせ
+========
+
+1.0.2リリース - 2010/09/09
+--------------------------
+
+改良
+++++
+
+* :ref:`suggest` コマンドのサンプルを追加。（examples/dictionary/）
+
+変更
+++++
+
+* HTTPで公開するディレクトリを指定する--admin-html-pathを--document-rootに変更。
+* :ref:`select` コマンドのデフォルトの--output_columnsから_valueを削除。
+
+修正
+++++
+
+* パッケージミスを修正。 （OBATA Akioさんが報告）
+* GeoPointの度表記の解釈を修正。 #460
+
+感謝
+++++
+
+* OBATA Akioさん
+
+
+1.0.1リリース - 2010/09/06
+--------------------------
+
+改良
+++++
+
+* CentOS 5/Fedora 13用RPMの提供。（Daiki Uenoさん作成のspecがベース）
+
+* ログパスのデフォルト値に--localstatedirを使用。（OBATA Akioさんが提案）
+
+* BOM付きUTF-8に対応。
+
+修正
+++++
+
+* JSON JQueryプラグインが同梱されていない問題の修正。
+
+* テストが失敗する問題の修正。（OBATA Akioさんが報告）
+
+感謝
+++++
+
+* Daiki Uenoさん
+* OBATA Akioさん
+
+1.0.0リリース - 2010/08/29
+--------------------------
+
+改良
+++++
+
+* 指定したクエリに対する補完・修正・提案を行う :ref:`suggest` コマンドを追加。
+
+* :ref:`deelte` コマンドが失敗したらfalseを返すように変更。（Itagaki Takahiroさんが提案）
+
+修正
+++++
+
+* 関数もコマンドとして呼び出してしまう問題を修正。#431
+
+* 索引付きカラムを等価条件で検索できない問題を修正。
+
+* :ref:`delete` コマンドでキーがShortText以外のレコードを削除できない問題の修正。（Itagaki Takahiroさんが報告）
+
+感謝
+++++
+
+* Itagaki Takahiroさん
+
+0.7.7リリース - 2010/08/25
+--------------------------
+
+改良
+++++
+
+* 編集距離（レーベンシュタイン距離）を計算する
+  :ref:`edit_distance` ()関数の追加。
+
+* manを追加。
+
+* :ref:`delete` コマンドでデータの整合性が壊れる場合はエラー
+  を返すようにした。
+
+* MeCabの辞書のエンコーディング検出処理を改善。
+
+* デフォルトの設定ファイルを追加。
+
+修正
+++++
+
+* :ref:`geo_in_rectangle` ()関数が引数を「左上」と「右下」で
+  はなく、「左下」と「右上」と扱っていた問題を修正。
+
+* 前方一致検索がマッチしない問題を修正。
+
+
+0.7.6リリース - 2010/08/19
+--------------------------
+
+改良
+++++
+
+* デーモンになるときは標準出力を閉じるようにした。
+
+* PIDファイルを指定する``--pid-path``オプションを追加。
+
+* 設定ファイルを指定する``--config-path``オプションを追加。
+
+* 最大キャッシュ数を指定する``--cache-limit``オプションを追加。
+
+* 設定値を表示する``--show-config``オプションを追加。
+
+* 指定したファイルからコマンドを読み込む``--file``オプションを追加。
+
+* groongaとMeCabの辞書のエンコーディングが同じかどうかを確
+  認するようにした。
+
+* Web管理画面:
+
+  - データロード機能を追加。
+  - uptimeの表示形式を読みやすい形式に変更。
+
+* Muninプラグインの追加。
+
+  - クエリパフォーマンス計測用
+  - ディスク使用量計測用
+
+* libedit対応。
+
+* 存在しないデータベースを指定したときのエラーメッセージを改善。
+
+* loadコマンド:
+
+  - 不正な文字を見つけた場合はログに出力。
+  - 必要な項目がない場合はログに出力。
+  - true/false/nullリテラルをサポート。
+  - GeoPointの度での指定をサポート。
+    （例: "35.6954581363924,139.564207350021"）
+  - NO_KEYテーブルを参照しているカラム値をサポート。
+  - 数値のベクタをサポート。
+
+* selectコマンド
+
+  - 索引を用いた高速なGeoPointの検索機能を追加。
+  - 索引を用いた高速なGeoPointのソート機能を追加。
+    （ただし複数のソートキーと一緒に使うことはできない。）
+  - ベクタのGeoPointの出力に対応。
+  - 不正な入力値に対してエラーを出力するようにした。
+
+* dumpコマンド:
+
+  - フラグを数値ではなくキーワードで出力するように変更。
+
+* column_listコマンド:
+
+  - _keyカラムの出力に対応。
+
+* deleteコマンド:
+
+  - データに不整合が発生する場合はデータを削除しないように変更。
+
+* statusコマンド:
+
+  - キャッシュ情報を追加。
+
+* データの整合性を確認するcheckコマンドの追加。
+
+* 強制的にロックを解除するclearlockコマンドの追加。
+
+* 最大キャッシュ数を指定するcache_limitコマンドの追加。
+
+* フラグメンテーションを解消するdefragコマンドの追加。
+
+* データ投入後のインデックスカラム作成に対応。
+
+修正
+++++
+
+* 不正なsortキーを指定された場合はSEGVする問題の修正。
+* selectの出力に不正なカラムを指定された時にSEGVする問題を修正。
+* 空のベクタをloadするとSEGVする問題の修正。
+* メモリリークの修正。
+* drilldown時に参照先が存在しない場合にSEGVする問題の修正。
+
+感謝
+++++
+
+* おばたさん

data/vendor/local/share/groonga/doc/ja/source/process.txt

@@ -0,0 +1,12 @@
+.. highlightlang:: none
+
+実行環境
+========
+
+.. toctree::
+   :maxdepth: 1
+
+   execfile
+   http
+   grnslap
+   grntest

data/vendor/local/share/groonga/doc/ja/source/pseudo_column.txt

@@ -0,0 +1,38 @@
+.. highlightlang:: none
+
+疑似カラム (pseudo_column)
+==========================
+
+名前
+----
+
+疑似カラム
+
+説明
+----
+
+groongaのデータベースで作成したテーブルには、いくつかのカラムが自動的に定義されます。
+
+これらのカラムはいずれもアンダースコア('_')で始まる名前が付与されます。定義される疑似カラムは、テーブルの種類によって異なります。
+
+``_id``
+
+  レコードに付与される一意な番号です。全てのテーブルに定義されます。値の範囲は1〜1073741824の整数で、通常はレコードを追加した順に1ずつ加算されます。_idの値は不変で、レコードが存在する限り変更することはできません。ただし、削除されたレコードの_idの値は再利用されます。
+
+``_key``
+
+  レコードの主キー値を表します。主キーを持つテーブルのみに定義されます。主キー値はテーブルの中で一意であり、変更することはできません。
+
+``_value``
+
+  レコードの値を表します。value_typeを指定したテーブルのみに定義されます。自由に変更可能です。
+
+``_score``
+
+  各レコードのスコア値を表します。検索結果として生成されたテーブルのみに定義されます。
+
+  検索処理を実行する過程で値が設定されますが、自由に変更可能です。
+
+``_nsubrecs``
+
+  主キーの値が同一であったレコードの件数を表します。検索結果として生成されたテーブルのみに定義されます。グループ化(drilldown)処理を実行すると、グループ化前のテーブルにおいて、グループ化キーの値が同一であったレコードの件数が、グループ化処理の結果を格納するテーブルの_nsubrecsに記録されます。

data/vendor/local/share/groonga/doc/ja/source/rdoc.py

@@ -0,0 +1,762 @@
+# -*- coding: utf-8 -*-
+"""
+    source.rdoc
+    ~~~~~~~~~~~
+
+    RDoc Sphinx builder.
+
+    Derived from Sphinx's plain-text sphinx builder.
+
+    :copyright: Copyright 2007-2009 by the Sphinx team, see Sphinx's AUTHORS.
+                Copyright 2009 by Kouhei Sutou.
+    :license: BSD, see LICENSE for details.
+"""
+
+from os import path
+import codecs
+import textwrap
+
+from docutils import nodes, writers
+from docutils.io import StringOutput
+
+from sphinx.util import ensuredir, os_path
+from sphinx.builders import Builder
+
+class RDocWriter(writers.Writer):
+    supported = ('rdoc',)
+    settings_spec = ('No options here.', '', ())
+    settings_defaults = {}
+
+    output = None
+
+    def __init__(self, builder):
+        writers.Writer.__init__(self)
+        self.builder = builder
+
+    def translate(self):
+        visitor = RDocTranslator(self.document, self.builder)
+        self.document.walkabout(visitor)
+        self.output = visitor.body
+
+MAXWIDTH = 70
+STDINDENT = 2
+
+class RDocTranslator(nodes.NodeVisitor):
+    sectionchars = '*=-~"+'
+
+    def __init__(self, document, builder):
+        nodes.NodeVisitor.__init__(self, document)
+
+        self.states = [[]]
+        self.stateindent = [0]
+        self.sectionlevel = 0
+        self.table = None
+
+    def add_text(self, text):
+        self.states[-1].append((-1, text))
+    def new_state(self, indent=STDINDENT):
+        self.states.append([])
+        self.stateindent.append(indent)
+    def end_state(self, wrap=True, end=[''], first=None):
+        content = self.states.pop()
+        maxindent = sum(self.stateindent)
+        indent = self.stateindent.pop()
+        result = []
+        toformat = []
+        def do_format():
+            if not toformat:
+                return
+            if wrap:
+                res = textwrap.wrap(''.join(toformat), width=MAXWIDTH-maxindent)
+            else:
+                res = ''.join(toformat).splitlines()
+            if end:
+                res += end
+            result.append((indent, res))
+        for itemindent, item in content:
+            if itemindent == -1:
+                toformat.append(item)
+            else:
+                do_format()
+                result.append((indent + itemindent, item))
+                toformat = []
+        do_format()
+        if first is not None and result:
+            itemindent, item = result[0]
+            if item:
+                result.insert(0, (itemindent - indent, [first + item[0]]))
+                result[1] = (itemindent, item[1:])
+        self.states[-1].extend(result)
+
+    def visit_document(self, node):
+        self.new_state(0)
+    def depart_document(self, node):
+        self.end_state()
+        self.body = '\n'.join(line and (' '*indent + line)
+                              for indent, lines in self.states[0]
+                              for line in lines)
+        # XXX header/footer?
+
+    def visit_highlightlang(self, node):
+        raise nodes.SkipNode
+
+    def visit_section(self, node):
+        self._title_char = self.sectionchars[self.sectionlevel]
+        self.sectionlevel += 1
+    def depart_section(self, node):
+        self.sectionlevel -= 1
+
+    def visit_topic(self, node):
+        self.new_state(0)
+    def depart_topic(self, node):
+        self.end_state()
+
+    visit_sidebar = visit_topic
+    depart_sidebar = depart_topic
+
+    def visit_rubric(self, node):
+        self.new_state(0)
+        self.add_text('-[ ')
+    def depart_rubric(self, node):
+        self.add_text(' ]-')
+        self.end_state()
+
+    def visit_compound(self, node):
+        pass
+    def depart_compound(self, node):
+        pass
+
+    def visit_glossary(self, node):
+        pass
+    def depart_glossary(self, node):
+        pass
+
+    def visit_title(self, node):
+        if isinstance(node.parent, nodes.Admonition):
+            self.add_text(node.astext()+': ')
+            raise nodes.SkipNode
+        self.new_state(0)
+    def depart_title(self, node):
+        text = ''.join(x[1] for x in self.states.pop() if x[0] == -1)
+        text = ("=" * self.sectionlevel) + " " + text
+        self.stateindent.pop()
+        self.states[-1].append((0, ['', text, '']))
+
+    def visit_subtitle(self, node):
+        pass
+    def depart_subtitle(self, node):
+        pass
+
+    def visit_attribution(self, node):
+        self.add_text('-- ')
+    def depart_attribution(self, node):
+        pass
+
+    def visit_module(self, node):
+        if node.has_key('platform'):
+            self.new_state(0)
+            self.add_text(_('Platform: %s') % node['platform'])
+            self.end_state()
+        raise nodes.SkipNode
+
+    def visit_desc(self, node):
+        pass
+    def depart_desc(self, node):
+        pass
+
+    def visit_desc_signature(self, node):
+        self.new_state(0)
+        if node.parent['desctype'] in ('class', 'exception'):
+            self.add_text('%s ' % node.parent['desctype'])
+    def depart_desc_signature(self, node):
+        # XXX: wrap signatures in a way that makes sense
+        self.end_state(wrap=False, end=None)
+
+    def visit_desc_name(self, node):
+        pass
+    def depart_desc_name(self, node):
+        pass
+
+    def visit_desc_addname(self, node):
+        pass
+    def depart_desc_addname(self, node):
+        pass
+
+    def visit_desc_type(self, node):
+        pass
+    def depart_desc_type(self, node):
+        pass
+
+    def visit_desc_returns(self, node):
+        self.add_text(' -> ')
+    def depart_desc_returns(self, node):
+        pass
+
+    def visit_desc_parameterlist(self, node):
+        self.add_text('(')
+        self.first_param = 1
+    def depart_desc_parameterlist(self, node):
+        self.add_text(')')
+
+    def visit_desc_parameter(self, node):
+        if not self.first_param:
+            self.add_text(', ')
+        else:
+            self.first_param = 0
+        self.add_text(node.astext())
+        raise nodes.SkipNode
+
+    def visit_desc_optional(self, node):
+        self.add_text('[')
+    def depart_desc_optional(self, node):
+        self.add_text(']')
+
+    def visit_desc_annotation(self, node):
+        pass
+    def depart_desc_annotation(self, node):
+        pass
+
+    def visit_refcount(self, node):
+        pass
+    def depart_refcount(self, node):
+        pass
+
+    def visit_desc_content(self, node):
+        self.new_state()
+        self.add_text('\n')
+    def depart_desc_content(self, node):
+        self.end_state()
+
+    def visit_figure(self, node):
+        self.new_state()
+    def depart_figure(self, node):
+        self.end_state()
+
+    def visit_caption(self, node):
+        pass
+    def depart_caption(self, node):
+        pass
+
+    def visit_productionlist(self, node):
+        self.new_state()
+        names = []
+        for production in node:
+            names.append(production['tokenname'])
+        maxlen = max(len(name) for name in names)
+        for production in node:
+            if production['tokenname']:
+                self.add_text(production['tokenname'].ljust(maxlen) + ' ::=')
+                lastname = production['tokenname']
+            else:
+                self.add_text('%s    ' % (' '*len(lastname)))
+            self.add_text(production.astext() + '\n')
+        self.end_state(wrap=False)
+        raise nodes.SkipNode
+
+    def visit_seealso(self, node):
+        self.new_state()
+    def depart_seealso(self, node):
+        self.end_state(first='')
+
+    def visit_footnote(self, node):
+        self._footnote = node.children[0].astext().strip()
+        self.new_state(len(self._footnote) + 3)
+    def depart_footnote(self, node):
+        self.end_state(first='[%s] ' % self._footnote)
+
+    def visit_citation(self, node):
+        if len(node) and isinstance(node[0], nodes.label):
+            self._citlabel = node[0].astext()
+        else:
+            self._citlabel = ''
+        self.new_state(len(self._citlabel) + 3)
+    def depart_citation(self, node):
+        self.end_state(first='[%s] ' % self._citlabel)
+
+    def visit_label(self, node):
+        raise nodes.SkipNode
+
+    # XXX: option list could use some better styling
+
+    def visit_option_list(self, node):
+        pass
+    def depart_option_list(self, node):
+        pass
+
+    def visit_option_list_item(self, node):
+        self.new_state(0)
+    def depart_option_list_item(self, node):
+        self.end_state()
+
+    def visit_option_group(self, node):
+        self._firstoption = True
+    def depart_option_group(self, node):
+        self.add_text('     ')
+
+    def visit_option(self, node):
+        if self._firstoption:
+            self._firstoption = False
+        else:
+            self.add_text(', ')
+    def depart_option(self, node):
+        pass
+
+    def visit_option_string(self, node):
+        pass
+    def depart_option_string(self, node):
+        pass
+
+    def visit_option_argument(self, node):
+        self.add_text(node['delimiter'])
+    def depart_option_argument(self, node):
+        pass
+
+    def visit_description(self, node):
+        pass
+    def depart_description(self, node):
+        pass
+
+    def visit_tabular_col_spec(self, node):
+        raise nodes.SkipNode
+
+    def visit_colspec(self, node):
+        self.table[0].append(node['colwidth'])
+        raise nodes.SkipNode
+
+    def visit_tgroup(self, node):
+        pass
+    def depart_tgroup(self, node):
+        pass
+
+    def visit_thead(self, node):
+        pass
+    def depart_thead(self, node):
+        pass
+
+    def visit_tbody(self, node):
+        self.table.append('sep')
+    def depart_tbody(self, node):
+        pass
+
+    def visit_row(self, node):
+        self.table.append([])
+    def depart_row(self, node):
+        pass
+
+    def visit_entry(self, node):
+        if node.has_key('morerows') or node.has_key('morecols'):
+            raise NotImplementedError('Column or row spanning cells are '
+                                      'not implemented.')
+        self.new_state(0)
+    def depart_entry(self, node):
+        text = '\n'.join('\n'.join(x[1]) for x in self.states.pop())
+        self.stateindent.pop()
+        self.table[-1].append(text)
+
+    def visit_table(self, node):
+        if self.table:
+            raise NotImplementedError('Nested tables are not supported.')
+        self.new_state(0)
+        self.table = [[]]
+    def depart_table(self, node):
+        lines = self.table[1:]
+        fmted_rows = []
+        colwidths = self.table[0]
+        realwidths = colwidths[:]
+        separator = 0
+        # don't allow paragraphs in table cells for now
+        for line in lines:
+            if line == 'sep':
+                separator = len(fmted_rows)
+            else:
+                cells = []
+                for i, cell in enumerate(line):
+                    par = textwrap.wrap(cell, width=colwidths[i])
+                    if par:
+                        maxwidth = max(map(len, par))
+                    else:
+                        maxwidth = 0
+                    realwidths[i] = max(realwidths[i], maxwidth)
+                    cells.append(par)
+                fmted_rows.append(cells)
+
+        def writesep(char='-'):
+            out = ['+']
+            for width in realwidths:
+                out.append(char * (width+2))
+                out.append('+')
+            self.add_text(''.join(out) + '\n')
+
+        def writerow(row):
+            lines = map(None, *row)
+            for line in lines:
+                out = ['|']
+                for i, cell in enumerate(line):
+                    if cell:
+                        out.append(' ' + cell.ljust(realwidths[i]+1))
+                    else:
+                        out.append(' ' * (realwidths[i] + 2))
+                    out.append('|')
+                self.add_text(''.join(out) + '\n')
+
+        for i, row in enumerate(fmted_rows):
+            if separator and i == separator:
+                writesep('=')
+            else:
+                writesep('-')
+            writerow(row)
+        writesep('-')
+        self.table = None
+        self.end_state(wrap=False)
+
+    def visit_acks(self, node):
+        self.new_state(0)
+        self.add_text(', '.join(n.astext() for n in node.children[0].children)
+                      + '.')
+        self.end_state()
+        raise nodes.SkipNode
+
+    def visit_image(self, node):
+        self.add_text(_('[image]'))
+        raise nodes.SkipNode
+
+    def visit_transition(self, node):
+        indent = sum(self.stateindent)
+        self.new_state(0)
+        self.add_text('=' * (MAXWIDTH - indent))
+        self.end_state()
+        raise nodes.SkipNode
+
+    def visit_bullet_list(self, node):
+        self._list_counter = -1
+    def depart_bullet_list(self, node):
+        pass
+
+    def visit_enumerated_list(self, node):
+        self._list_counter = 0
+    def depart_enumerated_list(self, node):
+        pass
+
+    def visit_definition_list(self, node):
+        self._list_counter = -2
+    def depart_definition_list(self, node):
+        pass
+
+    def visit_list_item(self, node):
+        if self._list_counter == -1:
+            # bullet list
+            self.new_state(2)
+        elif self._list_counter == -2:
+            # definition list
+            pass
+        else:
+            # enumerated list
+            self._list_counter += 1
+            self.new_state(len(str(self._list_counter)) + 2)
+    def depart_list_item(self, node):
+        if self._list_counter == -1:
+            self.end_state(first='* ', end=None)
+        elif self._list_counter == -2:
+            pass
+        else:
+            self.end_state(first='%s. ' % self._list_counter, end=None)
+
+    def visit_definition_list_item(self, node):
+        self._li_has_classifier = len(node) >= 2 and \
+                                  isinstance(node[1], nodes.classifier)
+    def depart_definition_list_item(self, node):
+        pass
+
+    def visit_term(self, node):
+        self.new_state(0)
+    def depart_term(self, node):
+        if not self._li_has_classifier:
+            self.add_text("]")
+            self.end_state(first="[", end=None)
+
+    def visit_classifier(self, node):
+        self.add_text(' : ')
+    def depart_classifier(self, node):
+        self.end_state(end=None)
+
+    def visit_definition(self, node):
+        self.new_state()
+    def depart_definition(self, node):
+        self.end_state()
+
+    def visit_field_list(self, node):
+        pass
+    def depart_field_list(self, node):
+        pass
+
+    def visit_field(self, node):
+        pass
+    def depart_field(self, node):
+        pass
+
+    def visit_field_name(self, node):
+        self.new_state(0)
+    def depart_field_name(self, node):
+        self.add_text(':')
+        self.end_state(end=None)
+
+    def visit_field_body(self, node):
+        self.new_state()
+    def depart_field_body(self, node):
+        self.end_state()
+
+    def visit_centered(self, node):
+        pass
+    def depart_centered(self, node):
+        pass
+
+    def visit_hlist(self, node):
+        pass
+    def depart_hlist(self, node):
+        pass
+
+    def visit_hlistcol(self, node):
+        pass
+    def depart_hlistcol(self, node):
+        pass
+
+    def visit_admonition(self, node):
+        self.new_state(0)
+    def depart_admonition(self, node):
+        self.end_state()
+
+    def _visit_admonition(self, node):
+        self.new_state(2)
+    def _make_depart_admonition(name):
+        def depart_admonition(self, node):
+            self.end_state(first=admonitionlabels[name] + ': ')
+        return depart_admonition
+
+    visit_attention = _visit_admonition
+    depart_attention = _make_depart_admonition('attention')
+    visit_caution = _visit_admonition
+    depart_caution = _make_depart_admonition('caution')
+    visit_danger = _visit_admonition
+    depart_danger = _make_depart_admonition('danger')
+    visit_error = _visit_admonition
+    depart_error = _make_depart_admonition('error')
+    visit_hint = _visit_admonition
+    depart_hint = _make_depart_admonition('hint')
+    visit_important = _visit_admonition
+    depart_important = _make_depart_admonition('important')
+    visit_note = _visit_admonition
+    depart_note = _make_depart_admonition('note')
+    visit_tip = _visit_admonition
+    depart_tip = _make_depart_admonition('tip')
+    visit_warning = _visit_admonition
+    depart_warning = _make_depart_admonition('warning')
+
+    def visit_versionmodified(self, node):
+        self.new_state(0)
+        if node.children:
+            self.add_text(versionlabels[node['type']] % node['version'] + ': ')
+        else:
+            self.add_text(versionlabels[node['type']] % node['version'] + '.')
+    def depart_versionmodified(self, node):
+        self.end_state()
+
+    def visit_literal_block(self, node):
+        self.new_state()
+    def depart_literal_block(self, node):
+        self.end_state(wrap=False)
+
+    def visit_doctest_block(self, node):
+        self.new_state(0)
+    def depart_doctest_block(self, node):
+        self.end_state(wrap=False)
+
+    def visit_line_block(self, node):
+        self.new_state(0)
+    def depart_line_block(self, node):
+        self.end_state(wrap=False)
+
+    def visit_line(self, node):
+        pass
+    def depart_line(self, node):
+        pass
+
+    def visit_block_quote(self, node):
+        self.new_state(0)
+    def depart_block_quote(self, node):
+        self.end_state()
+
+    def visit_compact_paragraph(self, node):
+        pass
+    def depart_compact_paragraph(self, node):
+        pass
+
+    def visit_paragraph(self, node):
+        if not isinstance(node.parent, nodes.Admonition) or \
+               isinstance(node.parent, addnodes.seealso):
+            self.new_state(0)
+    def depart_paragraph(self, node):
+        if not isinstance(node.parent, nodes.Admonition) or \
+               isinstance(node.parent, addnodes.seealso):
+            self.end_state()
+
+    def visit_target(self, node):
+        raise nodes.SkipNode
+
+    def visit_index(self, node):
+        raise nodes.SkipNode
+
+    def visit_substitution_definition(self, node):
+        raise nodes.SkipNode
+
+    def visit_pending_xref(self, node):
+        pass
+    def depart_pending_xref(self, node):
+        pass
+
+    def visit_reference(self, node):
+        pass
+    def depart_reference(self, node):
+        pass
+
+    def visit_download_reference(self, node):
+        pass
+    def depart_download_reference(self, node):
+        pass
+
+    def visit_emphasis(self, node):
+        self.add_text('*')
+    def depart_emphasis(self, node):
+        self.add_text('*')
+
+    def visit_literal_emphasis(self, node):
+        self.add_text('*')
+    def depart_literal_emphasis(self, node):
+        self.add_text('*')
+
+    def visit_strong(self, node):
+        self.add_text('**')
+    def depart_strong(self, node):
+        self.add_text('**')
+
+    def visit_abbreviation(self, node):
+        self.add_text('')
+    def depart_abbreviation(self, node):
+        if node.hasattr('explanation'):
+            self.add_text(' (%s)' % node['explanation'])
+
+    def visit_title_reference(self, node):
+        self.add_text('*')
+    def depart_title_reference(self, node):
+        self.add_text('*')
+
+    def visit_literal(self, node):
+        self.add_text('``')
+    def depart_literal(self, node):
+        self.add_text('``')
+
+    def visit_subscript(self, node):
+        self.add_text('_')
+    def depart_subscript(self, node):
+        pass
+
+    def visit_superscript(self, node):
+        self.add_text('^')
+    def depart_superscript(self, node):
+        pass
+
+    def visit_footnote_reference(self, node):
+        self.add_text('[%s]' % node.astext())
+        raise nodes.SkipNode
+
+    def visit_citation_reference(self, node):
+        self.add_text('[%s]' % node.astext())
+        raise nodes.SkipNode
+
+    def visit_Text(self, node):
+        self.add_text(node.astext())
+    def depart_Text(self, node):
+        pass
+
+    def visit_generated(self, node):
+        pass
+    def depart_generated(self, node):
+        pass
+
+    def visit_inline(self, node):
+        pass
+    def depart_inline(self, node):
+        pass
+
+    def visit_problematic(self, node):
+        self.add_text('>>')
+    def depart_problematic(self, node):
+        self.add_text('<<')
+
+    def visit_system_message(self, node):
+        self.new_state(0)
+        self.add_text('<SYSTEM MESSAGE: %s>' % node.astext())
+        self.end_state()
+        raise nodes.SkipNode
+
+    def visit_comment(self, node):
+        raise nodes.SkipNode
+
+    def visit_meta(self, node):
+        # only valid for HTML
+        raise nodes.SkipNode
+
+    def unknown_visit(self, node):
+        raise NotImplementedError('Unknown node: ' + node.__class__.__name__)
+
+class RDocBuilder(Builder):
+    name = 'rdoc'
+    format = 'rdoc'
+    out_suffix = '.rdoc'
+
+    def init(self):
+        pass
+
+    def get_outdated_docs(self):
+        for docname in self.env.found_docs:
+            if docname not in self.env.all_docs:
+                yield docname
+                continue
+            targetname = self.env.doc2path(docname, self.outdir,
+                                           self.out_suffix)
+            try:
+                targetmtime = path.getmtime(targetname)
+            except Exception:
+                targetmtime = 0
+            try:
+                srcmtime = path.getmtime(self.env.doc2path(docname))
+                if srcmtime > targetmtime:
+                    yield docname
+            except EnvironmentError:
+                # source doesn't exist anymore
+                pass
+
+    def get_target_uri(self, docname, typ=None):
+        return ''
+
+    def prepare_writing(self, docnames):
+        self.writer = RDocWriter(self)
+
+    def write_doc(self, docname, doctree):
+        destination = StringOutput(encoding='utf-8')
+        self.writer.write(doctree, destination)
+        outfilename = path.join(self.outdir, os_path(docname) + self.out_suffix)
+        ensuredir(path.dirname(outfilename))
+        try:
+            f = codecs.open(outfilename, 'w', 'utf-8')
+            try:
+                f.write(self.writer.output)
+            finally:
+                f.close()
+        except (IOError, OSError), err:
+            self.warn("error writing file %s: %s" % (outfilename, err))
+
+    def finish(self):
+        pass
+
+def setup(app):
+    app.add_builder(RDocBuilder)