Merged trunk to branch. I still ahve 4 ftests failing, but I suspect, it

will be fixed once I merge the changes of the last three days (hopefully).

__init__.py

@@ -0,0 +1,34 @@
+##############################################################################
+#
+# Copyright (c) 2001 Zope Corporation and Contributors. All Rights Reserved.
+#
+# This software is subject to the provisions of the Zope Public License,
+# Version 2.1 (ZPL).  A copy of the ZPL should accompany this distribution.
+# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
+# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
+# FOR A PARTICULAR PURPOSE
+#
+##############################################################################
+"""
+Consider the following example::
+
+  >>> from structuredtext.stng import structurize
+  >>> from structuredtext.document import DocumentWithImages
+  >>> from structuredtext.html import HTMLWithImages
+  >>> from structuredtext.docbook import DocBook
+
+  We first need to structurize the string and make a full-blown
+  document out of it:
+
+  >>> struct = structurize(structured_string)
+  >>> doc = DocumentWithImages()(struct)
+
+  Now feed it to some output generator, in this case HTML or DocBook:
+  
+  >>> output = HTMLWithImages()(doc, level=1)
+  >>> output = DocBook()(doc, level=1)
+
+$Id$
+"""
+__docformat__ = 'restructuredtext'