RubyGems - rroonga - Versions diffs - 1.0.1-x86-mingw32 → 1.1.0-x86-mingw32 - Mend

rroonga 1.0.1-x86-mingw32 → 1.1.0-x86-mingw32

Files changed (387) hide show

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

@@ -1,52 +0,0 @@
-.. 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 DELETED Viewed

@@ -1,21 +0,0 @@
-.. 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 DELETED Viewed

@@ -1,114 +0,0 @@
-.. 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 DELETED Viewed

@@ -1,199 +0,0 @@
-.. 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 DELETED Viewed

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

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

@@ -1,38 +0,0 @@
-.. 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 DELETED Viewed

@@ -1,762 +0,0 @@
-# -*- 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)