Update doc strings to ReST

__init__.py

@@ -15,6 +15,8 @@
 
 $Id$
 """
+__docformat__ = 'restructuredtext'
+
 from interfaces import IDependable
 from zope.app.annotation.interfaces import IAnnotations
 from zope.app.traversing.api import getParent, canonicalPath, getPath
@@ -25,7 +27,7 @@ class PathSetAnnotation(object):
     """Abstract base class for annotations that are sets of paths.
 
     To make this into a concrete class, a subclass must set the class
-    attribute 'key' to a unique annotation key.  A subclass may also
+    attribute `key` to a unique annotation key.  A subclass may also
     choose to rename the methods.
     """
 
@@ -90,7 +92,7 @@ def _make_absolute(self, path):
 
 
 class Dependable(PathSetAnnotation):
-    """See IDependable."""
+    """See `IDependable`."""
 
     implements(IDependable)
 

interfaces.py

@@ -15,13 +15,15 @@
 
 $Id$
 """
+__docformat__ = 'restructuredtext'
+
 from zope.interface import Interface
 from zope.app.exception.interfaces import UserError
 
 class IDependable(Interface):
     """Objects that other objects depend on.
 
-    Note that IDependable will normally be implemented by an adapter.
+    Note that `IDependable` will normally be implemented by an adapter.
     """
 
     def addDependent(location):