[Zope3-checkins] CVS: Zope3/src/zodbcode - patch.py:1.2

[Fred L. Drake, Jr.]

Update of /cvs-repository/Zope3/src/zodbcode
In directory cvs.zope.org:/tmp/cvs-serv1374

Modified Files:
	patch.py 
Log Message:
be more epydoc friendly


=== Zope3/src/zodbcode/patch.py 1.1 => 1.2 ===
--- Zope3/src/zodbcode/patch.py:1.1	Fri Feb 20 17:02:23 2004
+++ Zope3/src/zodbcode/patch.py	Tue Apr 13 17:52:20 2004
@@ -35,7 +35,8 @@
   in the module, all references must be replaced with references to
   the converted object.
 
-Implementation notes:
+Implementation notes
+--------------------
 
 The conversion operation is implemented using a pickler.  It wasn't
 possible to use the copy module, because it isn't possible to extend
@@ -65,7 +66,8 @@
 method isn't.  Then the bound method can invoke an old method on a new
 object, which may not be legal.  It might sufficient to outlaw this case.
 
-XXX Open issues
+Open issues
+-----------
 
 Can we handle metaclasses within this framework?  That is, what if an
 object's type is not type, but a subclass of type.
@@ -74,12 +76,16 @@
 able to use them, but Python doesn't expose an introspection on them.
 
 What if the same object is bound to two different names in the same
-namespace?  Example:
+namespace?  For example::
+
     x = lambda: 1
     y = x
-If the module is updated to:
+
+If the module is updated to::
+
     x = lambda: 1
     y = lambda: 2
+
 What are the desired semantics?
 """