replaced docutils with an svn:external definition

lib/python/docutils/BUGS.txt

-================
- Docutils_ Bugs
-================
-
-:Author: David Goodger; open to all Docutils developers
-:Contact: goodger@python.org
-:Date: $Date: 2005/01/07 15:11:43 $
-:Revision: $Revision: 1.1.2.1 $
-:Copyright: This document has been placed in the public domain.
-
-.. _Docutils: http://docutils.sourceforge.net/
-
-
-Bugs in Docutils?!?  Yes, we do have a few.  Some are old-timers that
-tend to stay in the shadows and don't bother anybody.  Once in a while
-new bugs are born.  From time to time some bugs (new and old) crawl
-out into the light and must be dealt with.  Icky.
-
-This document describes how to report a bug, and lists known bugs.
-
-.. contents::
-
-
-How To Report A Bug
-===================
-
-If you think you've discovered a bug, please read through these
-guidelines before reporting it.
-
-First, make sure it's a new bug:
-
-* Please check the list of `known bugs`_ below and the `SourceForge
-  Bug Tracker`_ to see if it has already been reported.
-
-* Are you using the very latest version of Docutils?  The bug may have
-  already been fixed.  Please get the latest version of Docutils from
-  CVS_ or from the `development snapshot`_ and check again.  Even if
-  your bug has not been fixed, others probably have, and you're better
-  off with the most up-to-date code.
-
-  If you don't have time to check the latest snapshot, please report
-  the bug anyway.  We'd rather tell you that it's already fixed than
-  miss reports of unfixed bugs.
-
-* If Docutils does not behave the way you expect, look in the
-  documentation_ (don't forget the FAQ_!) and `mailing list archives`_
-  for evidence that it should behave the way you expect.
-
-If you're not sure, please ask on the
-docutils-users@lists.sourceforge.net [1]_ mailing list first.
-
-If it's a new bug, the most important thing you can do is to write a
-simple description and a recipe that reproduces the bug.  Try to
-create a minimal document that demonstrates the bug.  The easier you
-make it to understand and track down the bug, the more likely a fix
-will be.
-
-Now you're ready to write the bug report.  Please include:
-
-* A clear description of the bug.  Describe how you expected Docutils
-  to behave, and contrast that with how it actually behaved.  While
-  the bug may seem obvious to you, it may not be so obvious to someone
-  else, so it's best to avoid a guessing game.
-
-* A complete description of the environment in which you reproduced
-  the bug:
-
-  - Your operating system & version.
-  - The version of Python (``python -V``).
-  - The version of Docutils (use the "-V" option to most Docutils
-    front-end tools).
-  - Any private modifications you made to Docutils.
-  - Anything else that could possibly be relevant.  Err on the side
-    of too much information, rather than too little.
-
-* A literal transcript of the *exact* command you ran, and the *exact*
-  output.  Use the "--traceback" option to get a complete picture.
-
-* The exact input and output files.  Better to attach complete files
-  to your bug report than to include just a summary or excerpt.
-
-* If you also want to include speculation as to the cause, and even a
-  patch to fix the bug, that would be great!
-
-The best place to send your bug report is to the `SourceForge Bug
-Tracker`_.  That way, it won't be misplaced or forgotten.  In fact, an
-open bug report on SourceForge is a constant irritant that begs to be
-squashed.
-
-Thank you!
-
-(This section was inspired by the `Subversion project's`__ BUGS__
-file.)
-
-.. [1] Due to overwhelming amounts of spam, the
-   docutils-users@lists.sourceforge.net mailing list has been set up
-   for subscriber posting only.  Non-subscribers who post to
-   docutils-users will receive a message with "Subject: Your message
-   to Docutils-users awaits moderator approval".  Legitimate messages
-   are accepted and posted as soon as possible (a list administrator
-   must verify the message manually).  If you'd like to subscribe to
-   docutils-users, please visit
-   <http://lists.sourceforge.net/lists/listinfo/docutils-users>.
-
-__ http://subversion.tigris.org/
-__ http://svn.collab.net/viewcvs/svn/trunk/BUGS?view=markup
-
-.. _CVS: http://sourceforge.net/cvs/?group_id=38414
-.. _development snapshot: http://docutils.sf.net/#development-snapshot
-.. _documentation: docs/
-.. _FAQ: FAQ.html
-.. _mailing list archives: http://docutils.sf.net/#mailing-lists
-.. _SourceForge Bug Tracker:
-   http://sourceforge.net/tracker/?group_id=38414&atid=422030
-
-
-Known Bugs
-==========
-
-Also see the `SourceForge Bug Tracker`_.
-
-* .. _unencoded stylesheet reference:
-
-  ``--stylesheet='foo&bar'`` causes an invalid stylesheet reference to
-  be inserted in an HTML file, because the ``&`` isn't encoded as
-  ``&amp;``.
-
-* ``utils.relative_path()`` sometimes returns absolute _`paths on
-  Windows` (like ``C:/test/foo.css``) where it could have chosen a
-  relative path.
-
-  Furthermore, absolute pathnames are inserted verbatim, like
-  ``href="C:/test/foo.css"`` instead of
-  ``href="file:///C:/test/foo.css"``.
-
-  For details, see `this posting by Alan G. Isaac
-  <http://article.gmane.org/gmane.text.docutils.user/1569>`_.
-
-* .. _empty csv-table:
-
-  When supplying an empty file for the csv-table directive, Docutils
-  crashes with a zero-division error.  Example::
-
-      .. csv-table::
-         :file: empty.txt
-
-* _`Line numbers` in system messages are inconsistent in the parser.
-
-  - In text inserted by the "include" directive, errors are often not
-    reported with the correct "source" or "line" numbers.  Perhaps all
-    Reporter calls need "source" and "line" keyword arguments.
-    Elements' .line assignments should be checked.  (Assign to .source
-    too?  Add a set_info method?  To what?)  There's a test in
-    test/test_parsers/test_rst/test_directives/test_include.py.
-
-  - Some line numbers in elements are not being set properly
-    (explicitly), just implicitly/automatically.  See rev. 1.74 of
-    docutils/parsers/rst/states.py for an example of how to set.
-
-* .. _none source:
-
-  Quite a few nodes are getting a "None" source attribute as well.  In
-  particular, see the bodies of definition lists.
-
-* .. _mislocated targets:
-
-  Explicit targets are sometimes mis-located.  In particular, placing
-  a target before a section header puts the target at the end of the
-  previous section instead of the start of the next section.  The code
-  in docutils.transforms.misc.ClassAttribute could be used to fix
-  this.  (Reported by David Priest.)
-
-* David Abrahams pointed out that _`doubly-indirect substitutions`
-  have a bug, but only when there's multiple references::
-
-      |substitute| my coke for gin
-      |substitute| you for my mum
-      at least I'll get my washing done
-
-      .. |substitute| replace:: |replace|
-      .. |replace| replace:: swap
-
-  This is tricky.  Substitutions have to propagate back completely.
-
-* .. _substitutions and references:
-
-  Another bug from David Abrahams (run with ``rst2html.py --traceback``)::
-
-      |substitution| and again a |substitution|.
-
-      .. |substitution| replace:: ref__
-
-      __ a.html
-      __ b.html
-
-  Change the references.Substitutions tranform's priority from 220 to
-  680, so it happens after reference resolution?  Then we have to deal
-  with multiple IDs.  Perhaps the Substitution transform should remove
-  all IDs from definitions after the first substitution reference is
-  processed.
-
-* Footnote label "5" should be "4"::
-
-      $ rst2pseudoxml.py <<EOF
-      > ref [#abc]_ [#]_ [1]_ [#4]_
-      > 
-      > .. [#abc] footnote
-      > .. [#] two
-      > .. [1] one
-      > .. [#4] four
-      > EOF
-      <document source="<stdin>">
-          <paragraph>
-              ref 
-              <footnote_reference auto="1" id="id1" refid="abc">
-                  2
-               
-              <footnote_reference auto="1" id="id2" refid="id5">
-                  3
-               
-              <footnote_reference id="id3" refid="id6">
-                  1
-               
-              <footnote_reference auto="1" id="id4" refid="id7">
-                  5
-          <footnote auto="1" backrefs="id1" id="abc" name="abc">
-              <label>
-                  2
-              <paragraph>
-                  footnote
-          <footnote auto="1" backrefs="id2" id="id5" name="3">
-              <label>
-                  3
-              <paragraph>
-                  two
-          <footnote backrefs="id3" id="id6" name="1">
-              <label>
-                  1
-              <paragraph>
-                  one
-          <footnote auto="1" backrefs="id4" id="id7" name="4">
-              <label>
-                  5
-              <paragraph>
-                  four
-
-
-..
-   Local Variables:
-   mode: indented-text
-   indent-tabs-mode: nil
-   sentence-end-double-space: t
-   fill-column: 70
-   End:

lib/python/docutils/COPYING.txt

-==================
- Copying Docutils
-==================
-
-:Author: David Goodger
-:Contact: goodger@users.sourceforge.net
-:Date: $Date: 2005/01/07 15:11:43 $
-:Web site: http://docutils.sourceforge.net/
-:Copyright: This document has been placed in the public domain.
-
-Most of the files included in this project have been placed in the
-public domain, and therefore have no license requirements and no
-restrictions on copying or usage; see the `Public Domain Dedication`_
-below.  There are a few exceptions_, listed below.
-
-One goal of the Docutils project is to be included in the Python
-standard library distribution, at which time it is expected that
-copyright will be asserted by the `Python Software Foundation
-<http://www.python.org/psf/>`_.
-
-
-Public Domain Dedication
-========================
-
-The persons who have associated their work with this project (the
-"Dedicator": David Goodger and the many contributors to the Docutils
-project) hereby dedicate the entire copyright, less the exceptions_
-listed below, in the work of authorship known as "Docutils" identified
-below (the "Work") to the public domain.
-
-The primary repository for the Work is the Internet World Wide Web
-site <http://docutils.sourceforge.net/>.  The Work consists of the
-files within the "docutils" module of the Docutils project CVS
-repository (Internet host cvs.sourceforge.net, filesystem path
-/cvsroot/docutils), whose Internet web interface is located at
-<http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/docutils/docutils/>.
-Files dedicated to the public domain may be identified by the
-inclusion, near the beginning of each file, of a declaration of the
-form::
-
-    Copyright: This document/module/DTD/stylesheet/file/etc. has been
-               placed in the public domain.
-
-Dedicator makes this dedication for the benefit of the public at large
-and to the detriment of Dedicator's heirs and successors.  Dedicator
-intends this dedication to be an overt act of relinquishment in
-perpetuity of all present and future rights under copyright law,
-whether vested or contingent, in the Work.  Dedicator understands that
-such relinquishment of all rights includes the relinquishment of all
-rights to enforce (by lawsuit or otherwise) those copyrights in the
-Work.
-
-Dedicator recognizes that, once placed in the public domain, the Work
-may be freely reproduced, distributed, transmitted, used, modified,
-built upon, or otherwise exploited by anyone for any purpose,
-commercial or non-commercial, and in any way, including by methods
-that have not yet been invented or conceived.
-
-(This dedication is derived from the text of the `Creative Commons
-Public Domain Dedication
-<http://creativecommons.org/licenses/publicdomain>`_.)
-
-
-Exceptions
-==========
-
-The exceptions to the `Public Domain Dedication`_ above are:
-
-* extras/optparse.py, copyright by Gregory P. Ward, released under a
-  BSD-style license (which can be found in the module's source code).
-
-* extras/textwrap.py, copyright by Gregory P. Ward and the Python
-  Software Foundation, released under the `Python 2.3 license`_
-  (`local copy`__).
-
-  __ licenses/python-2-3.txt
-
-* extras/roman.py, copyright by Mark Pilgrim, released under the
-  `Python 2.1.1 license`_ (`local copy`__).
-
-  __ licenses/python-2-1-1.txt
-
-* test/docutils_difflib.py, copyright by the Python Software
-  Foundation, released under the `Python 2.2 license`_ (`local
-  copy`__).  This file is included for compatibility with Python
-  versions less than 2.2.  (It's only used to report test failures
-  anyhow; it isn't installed anywhere.  The included file is a
-  pre-generator version of the difflib.py module included in Python
-  2.2.)
-
-  __ licenses/python-2-2.txt
-
-* tools/pep2html.py, copyright by the Python Software Foundation,
-  released under the `Python 2.2 license`_ (`local copy`__).
-
-  __ licenses/python-2-2.txt
-
-* tools/editors/emacs/rst-html.el, copyright by Martin Blais, released
-  under the `GNU General Public License`_ (`local copy`__).
-
-  __ licenses/gpl.txt
-
-* tools/editors/emacs/rst-mode.el, copyright by Stefan Merten,
-  released under the `GNU General Public License`_ (`local copy`__).
-
-  __ licenses/gpl.txt
-
-(Disclaimer: I am not a lawyer.)  The BSD license and the Python
-licenses are OSI-approved_ and GPL-compatible_.  Although complicated
-by multiple owners and lots of legalese, the Python license basically
-lets you copy, use, modify, and redistribute files as long as you keep
-the copyright attribution intact, note any changes you make, and don't
-use the owner's name in vain.  The BSD license is similar.
-
-Plaintext versions of all the linked-to licenses are provided in the
-licenses_ directory.
-
-.. _licenses: licenses/
-.. _Python 2.1.1 license: http://www.python.org/2.1.1/license.html
-.. _Python 2.2 license: http://www.python.org/2.2/license.html
-.. _Python 2.3 license: http://www.python.org/2.3/license.html
-.. _GNU General Public License: http://www.gnu.org/copyleft/gpl.html
-.. _OSI-approved: http://opensource.org/licenses/
-.. _GPL-compatible: http://www.gnu.org/philosophy/license-list.html

lib/python/docutils/PKG-INFO

-Metadata-Version: 1.0
-Name: docutils
-Version: 0.3.7
-Summary: Docutils -- Python Documentation Utilities
-Home-page: http://docutils.sourceforge.net/
-Author: David Goodger
-Author-email: goodger@users.sourceforge.net
-License: public domain, Python, BSD, GPL (see COPYING.txt)
-Description: Docutils is a modular system for processing documentation
-        into useful formats, such as HTML, XML, and LaTeX.  For
-        input Docutils supports reStructuredText, an easy-to-read,
-        what-you-see-is-what-you-get plaintext markup syntax.
-Platform: OS-independent
-Classifier: Development Status :: 3 - Alpha
-Classifier: Environment :: Console
-Classifier: Intended Audience :: End Users/Desktop
-Classifier: Intended Audience :: Other Audience
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: System Administrators
-Classifier: License :: Public Domain
-Classifier: License :: OSI Approved :: Python Software Foundation License
-Classifier: License :: OSI Approved :: BSD License
-Classifier: License :: OSI Approved :: GNU General Public License (GPL)
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python
-Classifier: Topic :: Documentation
-Classifier: Topic :: Software Development :: Documentation
-Classifier: Topic :: Text Processing
-Classifier: Natural Language :: English
-Classifier: Natural Language :: Afrikaans
-Classifier: Natural Language :: Esperanto
-Classifier: Natural Language :: French
-Classifier: Natural Language :: German
-Classifier: Natural Language :: Italian
-Classifier: Natural Language :: Russian
-Classifier: Natural Language :: Slovak
-Classifier: Natural Language :: Spanish
-Classifier: Natural Language :: Swedish

lib/python/docutils/THANKS.txt

-Acknowledgements
-================
-
-:Author: David Goodger
-:Contact: goodger@python.org
-:Date: $Date: 2005/01/07 15:11:43 $
-:Revision: $Revision: 1.1.2.1 $
-:Copyright: This document has been placed in the public domain.
-
-I would like to acknowledge the people who have made a direct impact
-on the Docutils project, knowingly or not, in terms of encouragement,
-suggestions, criticism, bug reports, code contributions, cash
-donations, tasty treats, and related projects:
-
-* Aahz
-* David Abrahams
-* David Ascher
-* Heiko Baumann
-* Eric Bellot
-* Ian Bicking
-* Marek Blaha
-* Martin Blais
-* Stephen Boulet
-* Fred Bremmer
-* Simon Budig
-* Bill Bumgarner
-* Brett Cannon
-* Greg Chapman
-* Nicolas Chauveau
-* Beni Cherniavsky
-* Adam Chodorowski
-* Brent Cook
-* Laura Creighton
-* Artur de Sousa Rocha
-* Stephan Deibel & `Wing IDE <http://wingide.com/>`__
-* Jason Diamond
-* William Dode
-* Fred Drake
-* Reggie Dugard
-* Dethe Elza
-* Marcus Ertl
-* Benja Fallenstein
-* fantasai
-* Stefane Fermigier
-* Jim Fulton
-* Peter Funk
-* Lele Gaifax
-* Dinu C. Gherman
-* Matt Gilbert
-* Jorge Gonzalez
-* Engelbert Gruber
-* Jacob Hallen
-* Simon Hefti
-* Doug Hellmann
-* Marc Herbert
-* Juergen Hermann
-* Jannie Hofmeyr
-* Steve Holden
-* Michael Hudson
-* Marcelo Huerta San Martin
-* Ludger Humbert
-* Jeremy Hylton
-* Tony Ibbs
-* Alan Jaffray
-* Joe YS Jaw
-* Dmitry Jemerov
-* Richard Jones
-* Andreas Jung
-* Garth Kidd
-* Axel Kollmorgen
-* Jeff Kowalczyk
-* Dave Kuhlman
-* Lloyd Kvam
-* Kirill Lapshin
-* Nicola Larosa
-* Daniel Larsson
-* Marc-Andre Lemburg
-* Julien Letessier
-* Wolfgang Lipp
-* Edward Loper
-* Dallas Mahrt
-* Ken Manheimer
-* Bob Marshall
-* Mark McEahern
-* Vincent McIntyre
-* John F Meinel Jr
-* Skip Montanaro
-* Paul Moore
-* Nigel W. Moriarty
-* Mark Nodine
-* Patrick K. O'Brien
-* Michel Pelletier
-* Sam Penrose
-* Tim Peters
-* Pearu Peterson
-* Mark Pilgrim
-* Brett g Porter
-* David Priest
-* Jens Quade
-* Andy Robinson
-* Tavis Rudd
-* Tracy Ruggles
-* Oliver Rutherfurd
-* Luc Saffre
-* Kenichi Sato
-* Ueli Schlaepfer
-* Gunnar Schwant
-* Bill Sconce
-* Frank Siebenlist
-* Bruce Smith
-* Asko Soukka
-* Darek Suchojad
-* Roman Suzi
-* Janet Swisher
-* tav
-* Kent Tenney
-* Bob Tolbert
-* Paul Tremblay
-* Laurence Tratt
-* Adrian van den Dries
-* Guido van Rossum
-* Miroslav Vasko
-* Paul Viren
-* Martin von Loewis
-* Greg Ward
-* Barry Warsaw
-* Edward Welbourne
-* Felix Wiemann
-* Ka-Ping Yee
-* Moshe Zadka
-
-Thank you!
-
-Special thanks to `SourceForge <http://sourceforge.net>`__ and the
-`Python Software Foundation <http://www.python.org/psf/>`__.
-
-Hopefully I haven't forgotten anyone or misspelled any names;
-apologies (and please let me know!) if I have.

lib/python/docutils/__init__.py

-# Author: David Goodger
-# Contact: goodger@python.org
-# Revision: $Revision: 3374 $
-# Date: $Date: 2005-05-26 23:21:48 +0200 (Thu, 26 May 2005) $
-# Copyright: This module has been placed in the public domain.
-
-"""
-This is the Docutils (Python Documentation Utilities) package.
-
-Package Structure
-=================
-
-Modules:
-
-- __init__.py: Contains component base classes, exception classes, and
-  Docutils `__version__`.
-
-- core.py: Contains the ``Publisher`` class and ``publish_*()`` convenience
-  functions.
-
-- frontend.py: Runtime settings (command-line interface, configuration files)
-  processing, for Docutils front-ends.
-
-- io.py: Provides a uniform API for low-level input and output.
-
-- nodes.py: Docutils document tree (doctree) node class library.
-
-- statemachine.py: A finite state machine specialized for
-  regular-expression-based text filters.
-
-- urischemes.py: Contains a complete mapping of known URI addressing
-  scheme names to descriptions.
-
-- utils.py: Contains the ``Reporter`` system warning class and miscellaneous
-  utilities.
-
-Subpackages:
-
-- languages: Language-specific mappings of terms.
-
-- parsers: Syntax-specific input parser modules or packages.
-
-- readers: Context-specific input handlers which understand the data
-  source and manage a parser.
-
-- transforms: Modules used by readers and writers to modify DPS
-  doctrees.
-
-- writers: Format-specific output translators.
-"""
-
-__docformat__ = 'reStructuredText'
-
-__version__ = '0.3.9'
-"""``major.minor.micro`` version number.  The micro number is bumped for API
-changes, for new functionality, and for interim project releases.  The minor
-number is bumped whenever there is a significant project release.  The major
-number will be bumped when the project is feature-complete, and perhaps if
-there is a major change in the design."""
-
-
-class ApplicationError(StandardError): pass
-class DataError(ApplicationError): pass
-
-
-class SettingsSpec:
-
-    """
-    Runtime setting specification base class.
-
-    SettingsSpec subclass objects used by `docutils.frontend.OptionParser`.
-    """
-
-    settings_spec = ()
-    """Runtime settings specification.  Override in subclasses.
-
-    Defines runtime settings and associated command-line options, as used by
-    `docutils.frontend.OptionParser`.  This is a tuple of:
-
-    - Option group title (string or `None` which implies no group, just a list
-      of single options).
-    
-    - Description (string or `None`).
-    
-    - A sequence of option tuples.  Each consists of:
-
-      - Help text (string)
-      
-      - List of option strings (e.g. ``['-Q', '--quux']``).
-      
-      - Dictionary of keyword arguments.  It contains arguments to the
-        OptionParser/OptionGroup ``add_option`` method, possibly with the
-        addition of a 'validator' keyword (see the
-        `docutils.frontend.OptionParser.validators` instance attribute).  Runtime
-        settings names are derived implicitly from long option names
-        ('--a-setting' becomes ``settings.a_setting``) or explicitly from the
-        'dest' keyword argument.  See optparse docs for more details.
-
-    - More triples of group title, description, options, as many times as
-      needed.  Thus, `settings_spec` tuples can be simply concatenated.
-    """
-
-    settings_defaults = None
-    """A dictionary of defaults for settings not in `settings_spec` (internal
-    settings, intended to be inaccessible by command-line and config file).
-    Override in subclasses."""
-
-    settings_default_overrides = None
-    """A dictionary of auxiliary defaults, to override defaults for settings
-    defined in other components.  Override in subclasses."""
-
-    relative_path_settings = ()
-    """Settings containing filesystem paths.  Override in subclasses.
-    Settings listed here are to be interpreted relative to the current working
-    directory."""
-
-    config_section = None
-    """The name of the config file section specific to this component
-    (lowercase, no brackets).  Override in subclasses."""
-
-    config_section_dependencies = None
-    """A list of names of config file sections that are to be applied before
-    `config_section`, in order (from general to specific).  In other words,
-    the settings in `config_section` are to be overlaid on top of the settings
-    from these sections.  The "general" section is assumed implicitly.
-    Override in subclasses."""
-
-
-class TransformSpec:
-
-    """
-    Runtime transform specification base class.
-
-    TransformSpec subclass objects used by `docutils.transforms.Transformer`.
-    """
-
-    default_transforms = ()
-    """Transforms required by this class.  Override in subclasses."""
-    
-    unknown_reference_resolvers = ()
-    """List of functions to try to resolve unknown references.  Unknown
-    references have a 'refname' attribute which doesn't correspond to any
-    target in the document.  Called when FinalCheckVisitor is unable to find a
-    correct target.  The list should contain functions which will try to
-    resolve unknown references, with the following signature::
-
-        def reference_resolver(node):
-            '''Returns boolean: true if resolved, false if not.'''
-
-    If the function is able to resolve the reference, it should also remove
-    the 'refname' attribute and mark the node as resolved::
-
-        del node['refname']
-        node.resolved = 1
-
-    Each function must have a "priority" attribute which will affect the order
-    the unknown_reference_resolvers are run::
-
-        reference_resolver.priority = 100
-
-    Override in subclasses."""
-
-
-class Component(SettingsSpec, TransformSpec):
-
-    """Base class for Docutils components."""
-
-    component_type = None
-    """Name of the component type ('reader', 'parser', 'writer').  Override in
-    subclasses."""
-
-    supported = ()
-    """Names for this component.  Override in subclasses."""
-    
-    def supports(self, format):
-        """
-        Is `format` supported by this component?
-
-        To be used by transforms to ask the dependent component if it supports
-        a certain input context or output format.
-        """
-        return format in self.supported

lib/python/docutils/examples.py

-# Authors: David Goodger
-# Contact: goodger@python.org
-# Revision: $Revision: 3247 $
-# Date: $Date: 2005-04-23 21:23:57 +0200 (Sat, 23 Apr 2005) $
-# Copyright: This module has been placed in the public domain.
-
-"""
-This module contains practical examples of Docutils client code.
-
-Importing this module from client code is not recommended; its contents are
-subject to change in future Docutils releases.  Instead, it is recommended
-that you copy and paste the parts you need into your own code, modifying as
-necessary.
-"""
-
-from docutils import core, io
-
-
-def html_parts(input_string, source_path=None, destination_path=None,
-               input_encoding='unicode', doctitle=1, initial_header_level=1):
-    """
-    Given an input string, returns a dictionary of HTML document parts.
-
-    Dictionary keys are the names of parts, and values are Unicode strings;
-    encoding is up to the client.
-
-    Parameters:
-
-    - `input_string`: A multi-line text string; required.
-    - `source_path`: Path to the source file or object.  Optional, but useful
-      for diagnostic output (system messages).
-    - `destination_path`: Path to the file or object which will receive the
-      output; optional.  Used for determining relative paths (stylesheets,
-      source links, etc.).
-    - `input_encoding`: The encoding of `input_string`.  If it is an encoded
-      8-bit string, provide the correct encoding.  If it is a Unicode string,
-      use "unicode", the default.
-    - `doctitle`: Disable the promotion of a lone top-level section title to
-      document title (and subsequent section title to document subtitle
-      promotion); enabled by default.
-    - `initial_header_level`: The initial level for header elements (e.g. 1
-      for "<h1>").
-    """
-    overrides = {'input_encoding': input_encoding,
-                 'doctitle_xform': doctitle,
-                 'initial_header_level': initial_header_level}
-    parts = core.publish_parts(
-        source=input_string, source_path=source_path,
-        destination_path=destination_path,
-        writer_name='html', settings_overrides=overrides)
-    return parts
-
-def html_fragment(input_string, source_path=None, destination_path=None,
-                  input_encoding='unicode', output_encoding='unicode',
-                  doctitle=1, initial_header_level=1):
-    """
-    Given an input string, returns an HTML fragment as a string.
-
-    The return value is the contents of the <body> tag, less the title,
-    subtitle, and docinfo.
-
-    Parameters (see `html_parts()` for the remainder):
-
-    - `output_encoding`: The desired encoding of the output.  If a Unicode
-      string is desired, use the default value of "unicode" .
-    """
-    parts = html_parts(
-        input_string=input_string, source_path=source_path,
-        destination_path=destination_path,
-        input_encoding=input_encoding, doctitle=doctitle,
-        initial_header_level=initial_header_level)
-    fragment = parts['fragment']
-    if output_encoding != 'unicode':
-        fragment = fragment.encode(output_encoding)
-    return fragment
-
-def internals(input_string, source_path=None, destination_path=None,
-              input_encoding='unicode'):
-    """
-    Return the document tree and publisher, for exploring Docutils internals.
-
-    Parameters: see `html_parts()`.
-    """
-    overrides = {'input_encoding': input_encoding}
-    output, pub = core.publish_programmatically(
-        source_class=io.StringInput, source=input_string,
-        source_path=source_path,
-        destination_class=io.NullOutput, destination=None,
-        destination_path=destination_path,
-        reader=None, reader_name='standalone',
-        parser=None, parser_name='restructuredtext',
-        writer=None, writer_name='null',
-        settings=None, settings_spec=None, settings_overrides=overrides,
-        config_section=None, enable_exit_status=None)
-    return pub.writer.document, pub

lib/python/docutils/languages/__init__.py

-# Author: David Goodger
-# Contact: goodger@users.sourceforge.net
-# Revision: $Revision: 2224 $
-# Date: $Date: 2004-06-05 21:40:46 +0200 (Sat, 05 Jun 2004) $
-# Copyright: This module has been placed in the public domain.
-
-# Internationalization details are documented in
-# <http://docutils.sf.net/docs/howto/i18n.html>.
-
-"""
-This package contains modules for language-dependent features of Docutils.
-"""
-
-__docformat__ = 'reStructuredText'
-
-_languages = {}
-
-def get_language(language_code):
-    if _languages.has_key(language_code):
-        return _languages[language_code]
-    module = __import__(language_code, globals(), locals())
-    _languages[language_code] = module
-    return module

lib/python/docutils/languages/af.py

-# Author: Jannie Hofmeyr
-# Contact: jhsh@sun.ac.za
-# Revision: $Revision: 2224 $
-# Date: $Date: 2004-06-05 21:40:46 +0200 (Sat, 05 Jun 2004) $
-# Copyright: This module has been placed in the public domain.
-
-# New language mappings are welcome.  Before doing a new translation, please
-# read <http://docutils.sf.net/docs/howto/i18n.html>.  Two files must be
-# translated for each language: one in docutils/languages, the other in
-# docutils/parsers/rst/languages.
-
-"""
-Afrikaans-language mappings for language-dependent features of Docutils.
-"""
-
-__docformat__ = 'reStructuredText'
-
-labels = {
-      'author': 'Auteur',
-      'authors': 'Auteurs',
-      'organization': 'Organisasie',
-      'address': 'Adres',
-      'contact': 'Kontak',
-      'version': 'Weergawe',
-      'revision': 'Revisie',
-      'status': 'Status',
-      'date': 'Datum',
-      'copyright': 'Kopiereg',
-      'dedication': 'Opdrag',
-      'abstract': 'Opsomming',
-      'attention': 'Aandag!',
-      'caution': 'Wees versigtig!',
-      'danger': '!GEVAAR!',
-      'error': 'Fout',
-      'hint': 'Wenk',
-      'important': 'Belangrik',
-      'note': 'Nota',
-      'tip': 'Tip', # hint and tip both have the same translation: wenk
-      'warning': 'Waarskuwing',
-      'contents': 'Inhoud'}
-"""Mapping of node class name to label text."""
-
-bibliographic_fields = {
-      'auteur': 'author',
-      'auteurs': 'authors',
-      'organisasie': 'organization',
-      'adres': 'address',
-      'kontak': 'contact',
-      'weergawe': 'version',
-      'revisie': 'revision',
-      'status': 'status',
-      'datum': 'date',
-      'kopiereg': 'copyright',
-      'opdrag': 'dedication',
-      'opsomming': 'abstract'}
-"""Afrikaans (lowcased) to canonical name mapping for bibliographic fields."""
-
-author_separators = [';', ',']
-"""List of separator strings for the 'Authors' bibliographic field. Tried in
-order."""

lib/python/docutils/languages/ca.py

-# Author: Ivan Vilata i Balaguer
-# Contact: ivan@selidor.net
-# Revision: $Revision: 3276 $
-# Date: $Date: 2005-04-30 13:34:52 +0200 (Sat, 30 Apr 2005) $
-# Copyright: This module has been placed in the public domain.
-
-# New language mappings are welcome.  Before doing a new translation, please
-# read <http://docutils.sf.net/docs/howto/i18n.html>.  Two files must be
-# translated for each language: one in docutils/languages, the other in
-# docutils/parsers/rst/languages.
-
-"""
-Catalan-language mappings for language-dependent features of Docutils.
-"""
-
-__docformat__ = 'reStructuredText'
-
-labels = {
-      # fixed: language-dependent
-      'author': u'Autor',
-      'authors': u'Autors',
-      'organization': u'Organitzaci\u00F3',
-      'address': u'Adre\u00E7a',
-      'contact': u'Contacte',
-      'version': u'Versi\u00F3',
-      'revision': u'Revisi\u00F3',
-      'status': u'Estat',
-      'date': u'Data',
-      'copyright': u'Copyright',
-      'dedication': u'Dedicat\u00F2ria',
-      'abstract': u'Resum',
-      'attention': u'Atenci\u00F3!',
-      'caution': u'Compte!',
-      'danger': u'PERILL!',
-      'error': u'Error',
-      'hint': u'Suggeriment',
-      'important': u'Important',
-      'note': u'Nota',
-      'tip': u'Consell',
-      'warning': u'Av\u00EDs',
-      'contents': u'Contingut'}
-"""Mapping of node class name to label text."""
-
-bibliographic_fields = {
-      # language-dependent: fixed
-      u'autor': 'author',
-      u'autors': 'authors',
-      u'organitzaci\u00F3': 'organization',
-      u'adre\u00E7a': 'address',
-      u'contacte': 'contact',
-      u'versi\u00F3': 'version',
-      u'revisi\u00F3': 'revision',
-      u'estat': 'status',
-      u'data': 'date',
-      u'copyright': 'copyright',
-      u'dedicat\u00F2ria': 'dedication',
-      u'resum': 'abstract'}
-"""Catalan (lowcased) to canonical name mapping for bibliographic fields."""
-
-author_separators = [';', ',']
-"""List of separator strings for the 'Authors' bibliographic field. Tried in
-order."""

lib/python/docutils/languages/cs.py

-# Author: Marek Blaha
-# Contact: mb@dat.cz
-# Revision: $Revision: 2224 $
-# Date: $Date: 2004-06-05 21:40:46 +0200 (Sat, 05 Jun 2004) $
-# Copyright: This module has been placed in the public domain.
-
-# New language mappings are welcome.  Before doing a new translation, please
-# read <http://docutils.sf.net/docs/howto/i18n.html>.  Two files must be
-# translated for each language: one in docutils/languages, the other in
-# docutils/parsers/rst/languages.
-
-"""
-Czech-language mappings for language-dependent features of Docutils.
-"""
-
-__docformat__ = 'reStructuredText'
-
-labels = {
-      # fixed: language-dependent
-      'author': u'Autor',
-      'authors': u'Auto\u0159i',
-      'organization': u'Organizace',
-      'address': u'Adresa',
-      'contact': u'Kontakt',
-      'version': u'Verze',
-      'revision': u'Revize',
-      'status': u'Stav',
-      'date': u'Datum',
-      'copyright': u'Copyright',
-      'dedication': u'V\u011Bnov\u00E1n\u00ED',
-      'abstract': u'Abstrakt',
-      'attention': u'Pozor!',
-      'caution': u'Opatrn\u011B!',
-      'danger': u'!NEBEZPE\u010C\u00CD!',
-      'error': u'Chyba',
-      'hint': u'Rada',
-      'important': u'D\u016Fle\u017Eit\u00E9',
-      'note': u'Pozn\u00E1mka',
-      'tip': u'Tip',
-      'warning': u'Varov\u00E1n\u00ED',
-      'contents': u'Obsah'}
-"""Mapping of node class name to label text."""
-
-bibliographic_fields = {
-      # language-dependent: fixed
-      u'autor': 'author',
-      u'auto\u0159i': 'authors',
-      u'organizace': 'organization',
-      u'adresa': 'address',
-      u'kontakt': 'contact',
-      u'verze': 'version',
-      u'revize': 'revision',
-      u'stav': 'status',
-      u'datum': 'date',
-      u'copyright': 'copyright',
-      u'v\u011Bnov\u00E1n\u00ED': 'dedication',
-      u'abstrakt': 'abstract'}
-"""Czech (lowcased) to canonical name mapping for bibliographic fields."""
-
-author_separators = [';', ',']
-"""List of separator strings for the 'Authors' bibliographic field. Tried in
-order."""

lib/python/docutils/languages/de.py

-# Authors:   David Goodger; Gunnar Schwant
-# Contact:   goodger@users.sourceforge.net
-# Revision:  $Revision: 2224 $
-# Date:      $Date: 2004-06-05 21:40:46 +0200 (Sat, 05 Jun 2004) $
-# Copyright: This module has been placed in the public domain.
-
-# New language mappings are welcome.  Before doing a new translation, please
-# read <http://docutils.sf.net/docs/howto/i18n.html>.  Two files must be
-# translated for each language: one in docutils/languages, the other in
-# docutils/parsers/rst/languages.
-
-"""
-German language mappings for language-dependent features of Docutils.
-"""
-
-__docformat__ = 'reStructuredText'
-
-labels = {
-    'author': 'Autor',
-    'authors': 'Autoren',
-    'organization': 'Organisation',
-    'address': 'Adresse',
-    'contact': 'Kontakt',
-    'version': 'Version',
-    'revision': 'Revision',
-    'status': 'Status',
-    'date': 'Datum',
-    'dedication': 'Widmung',
-    'copyright': 'Copyright',
-    'abstract': 'Zusammenfassung',
-    'attention': 'Achtung!',
-    'caution': 'Vorsicht!',
-    'danger': '!GEFAHR!',
-    'error': 'Fehler',
-    'hint': 'Hinweis',
-    'important': 'Wichtig',
-    'note': 'Bemerkung',
-    'tip': 'Tipp',
-    'warning': 'Warnung',
-    'contents': 'Inhalt'}
-"""Mapping of node class name to label text."""
-
-bibliographic_fields = {
-    'autor': 'author',
-    'autoren': 'authors',
-    'organisation': 'organization',
-    'adresse': 'address',
-    'kontakt': 'contact',
-    'version': 'version',
-    'revision': 'revision',
-    'status': 'status',
-    'datum': 'date',
-    'copyright': 'copyright',
-    'widmung': 'dedication',
-    'zusammenfassung': 'abstract'}
-"""German (lowcased) to canonical name mapping for bibliographic fields."""
-
-author_separators = [';', ',']
-"""List of separator strings for the 'Authors' bibliographic field. Tried in
-order."""