- added over_the_wire.txt to long_desription

- fixed headline types for consistent table of contents

README.txt

@@ -3,9 +3,11 @@ Extensions for the Zope 3 testbrowser
 =====================================
 
 This package is intended to provide extended versions of the Zope 3
-testbrowser. Especially those extensions that introduce dependencies to more
+testbrowser_. Especially those extensions that introduce dependencies to more
 external products, like lxml.
 
+.. _testbrowser: http://pypi.python.org/pypi/zope.testbrowser
+
 .. contents::
 
 Extension: lxml-support

setup.py

@@ -31,6 +31,8 @@ def read(*rnames):
           + '\n\n' +
           read('src', 'z3c', 'etestbrowser', 'README.txt')
           + '\n\n' +
+          read('src', 'z3c', 'etestbrowser', 'over_the_wire.txt')
+          + '\n\n' +
           read('CHANGES.txt')
           ),
       keywords = "zope3 testbrowser lxml",

src/z3c/etestbrowser/README.txt

@@ -1,20 +1,19 @@
-====================
 Extended testbrowser
-====================
+--------------------
 
 This package provides some extensions to Zope 3's testbrowser. It is intended
 for extensions that have dependencies that we do not want to rely on in the
 Zope 3 core e.g. lxml.
 
 
 Requirements
-============
+~~~~~~~~~~~~
 
  - lxml
 
 
 etree support
-=============
+~~~~~~~~~~~~~
 
 The extended test browser allows parsing of the result of a request into an
 etree using lxml (if the content type is text/html or text/xml).
@@ -38,7 +37,7 @@ Example:
 
 
 Strict XML
-----------
+++++++++++
 
 It is possible to force the test browser to use the xml parser:
 
@@ -53,7 +52,7 @@ It is possible to force the test browser to use the xml parser:
   [<Element {http://www.w3.org/1999/xhtml}body at ...>]
 
 LXML unicode support
---------------------
+++++++++++++++++++++
 
 A couple of variations of libxml2 might interpret UTF-8 encoded strings
 incorrectly. We have a workaround for that. Let's have a look at a view that
@@ -65,7 +64,7 @@ contains a German umlaut:
   u'K\xfcgelblitz.'
 
 Invalid XML/HTML responses
---------------------------
+++++++++++++++++++++++++++
 
 Responses that contain a body with invalid XML/HTML will cause an error when
 accessing the etree or normalized_contents attribute, but will load fine for
@@ -83,7 +82,7 @@ general TestBrowser use:
 
 
 Pretty printing
-===============
+~~~~~~~~~~~~~~~
 
 Sometimes a normal `print` of the browsers contents is hard to read for
 debugging:
@@ -103,7 +102,7 @@ the HTML (using htmllib internally):
   Loading... ... Name Title Created Modified ...
 
 HTML/XML normalization
-======================
+~~~~~~~~~~~~~~~~~~~~~~
 
 The extended test browser allows normalized output of HTML and XML which makes
 testing examples with HTML or XML a bit easier when unimportant details like

src/z3c/etestbrowser/over_the_wire.txt

@@ -1,9 +1,8 @@
-=================================
-Using testbrowser On the Internet
-=================================
+Using testbrowser on the internet
+---------------------------------
 
-The ``z3c.etestbrowser`` module exposes an ``ExtendedTestBrowser`` class that
-simulates a web browser similar to Mozilla Firefox or IE.
+The ``z3c.etestbrowser.browser`` module exposes an ``ExtendedTestBrowser``
+class that simulates a web browser similar to Mozilla Firefox or IE.
 
     >>> from z3c.etestbrowser.browser import ExtendedTestBrowser
     >>> browser = ExtendedTestBrowser()