Merge pull request #66 from zopefoundation/41-document-adapter-registry-api

Document API for adapter registry.

3 files changed, 25 insertions, 0 deletions

diff --git a/docs/adapter.rst b/docs/adapter.rst
index c5c65e5..b1caee3 100644
--- a/docs/adapter.rst
+++ b/docs/adapter.rst
@@ -1,3 +1,5 @@
+.. _adapter-registry:
+
 ================
 Adapter Registry
 ================
diff --git a/docs/api.rst b/docs/api.rst
index c51624f..2ff65a1 100644
--- a/docs/api.rst
+++ b/docs/api.rst
@@ -1059,3 +1059,22 @@ For example:
 When registering an adapter or utility component, the registry looks for the
 ``__component_name__`` attribute and uses it, if no name was explicitly
 provided.
+
+
+:class:`zope.interface.adapter.AdapterRegistry`
+-----------------------------------------------
+
+API
++++
+
+The adapter registry's API is defined by
+:class:`zope.interface.interfaces.IAdapterRegistry`:
+
+.. autointerface:: zope.interface.adapter.IAdapterRegistry
+   :members:
+   :member-order: bysource
+
+Usage
++++++
+
+See :ref:`adapter-registry`.
diff --git a/src/zope/interface/adapter.py b/src/zope/interface/adapter.py
index db2a49b..f8fdb00 100644
--- a/src/zope/interface/adapter.py
+++ b/src/zope/interface/adapter.py
@@ -15,9 +15,11 @@
 """
 import weakref
 
+from zope.interface import implementer
 from zope.interface import providedBy
 from zope.interface import Interface
 from zope.interface import ro
+from zope.interface.interfaces import IAdapterRegistry
 
 from zope.interface._compat import _normalize_name
 
@@ -605,6 +607,7 @@ class AdapterLookupBase(object):
 class AdapterLookup(AdapterLookupBase, LookupBase):
     pass
 
+@implementer(IAdapterRegistry)
 class AdapterRegistry(BaseAdapterRegistry):
 
     LookupClass = AdapterLookup
@@ -644,6 +647,7 @@ class AdapterRegistry(BaseAdapterRegistry):
 class VerifyingAdapterLookup(AdapterLookupBase, VerifyingBase):
     pass
 
+@implementer(IAdapterRegistry)
 class VerifyingAdapterRegistry(BaseAdapterRegistry):
 
     LookupClass = VerifyingAdapterLookup