[Checkins] SVN: zope.component/tseaver-test_cleanup/ Sphinx cleanups.
Tres Seaver
cvs-admin at zope.org
Sun Jun 17 21:37:12 UTC 2012
Log message for revision 126907:
Sphinx cleanups.
Changed:
_U zope.component/tseaver-test_cleanup/
U zope.component/tseaver-test_cleanup/docs/api.rst
-=-
Modified: zope.component/tseaver-test_cleanup/docs/api.rst
===================================================================
--- zope.component/tseaver-test_cleanup/docs/api.rst 2012-06-17 21:37:04 UTC (rev 126906)
+++ zope.component/tseaver-test_cleanup/docs/api.rst 2012-06-17 21:37:08 UTC (rev 126907)
@@ -95,6 +95,10 @@
Utility Registration APIs
-------------------------
+.. autofunction:: zope.component.getUtility
+
+.. autofunction:: zope.component.queryUtility
+
Utilities are components that simply provide an interface. They are
instantiated at the time or before they are registered. Here we test the
simple query interface.
@@ -174,8 +178,12 @@
Querying Multiple Utilities
###########################
+.. autofunction:: zope.component.getUtilitiesFor
+
+.. autofunction:: zope.component.getAllUtilitiesRegisteredFor
+
Sometimes it may be useful to query all utilities, both anonymous and named
-for a given interface. The :function:`~zope.component.getUtilitiesFor` API
+for a given interface. The :func:`~zope.component.getUtilitiesFor` API
returns a sequence of ``(name, utility)`` tuples, where ``name`` is the
empty string for the anonymous utility:
@@ -190,7 +198,7 @@
>>> ('foo', ob2) in tuples
True
-The :function:`~zope.component.getAllUtilitiesRegisteredFor` API returns
+The :func:`~zope.component.getAllUtilitiesRegisteredFor` API returns
utilities that have been registered for a particular interface. Utilities
providing a derived interface are also listed.
@@ -243,6 +251,10 @@
Delegated Utility Lookup
########################
+.. autofunction:: zope.component.getNextUtility
+
+.. autofunction:: zope.component.queryNextUtility
+
It is common for a utility to delegate its answer to a utility
providing the same interface in one of the component registry's
bases. Let's first create a global utility:
@@ -368,12 +380,7 @@
tearDown()
-.. autofunction:: zope.component.getUtility
-.. autofunction:: zope.component.queryUtility
-
-
-
:mod:`zope.component.interfaces`
================================
More information about the checkins
mailing list