[Checkins] SVN: grokcore.site/trunk/src/grokcore/site/components.py Extend docstring that will be rendered in Grok reference docs.
Uli Fouquet
uli at gnufix.de
Wed Dec 22 20:27:25 EST 2010
Log message for revision 119068:
Extend docstring that will be rendered in Grok reference docs.
Changed:
U grokcore.site/trunk/src/grokcore/site/components.py
-=-
Modified: grokcore.site/trunk/src/grokcore/site/components.py
===================================================================
--- grokcore.site/trunk/src/grokcore/site/components.py 2010-12-23 01:15:38 UTC (rev 119067)
+++ grokcore.site/trunk/src/grokcore/site/components.py 2010-12-23 01:27:24 UTC (rev 119068)
@@ -33,11 +33,12 @@
class Site(BaseSite, SiteManagerContainer):
"""Mixin for creating sites in Grok applications.
- When an application `grok.Model` or `grok.Container` also inherits
- from `grokcore.site.Site`, then it can additionally support the
- registration of local Component Architecture entities like
- `grokcore.site.LocalUtility` and `grok.Indexes` objects; see those
- classes for more information.
+ When an application :class:`grok.Model` or :class:`grok.Container`
+ also inherits from :class:`grokcore.site.Site`, then it can
+ additionally support the registration of local Component
+ Architecture entities like :class:`grokcore.site.LocalUtility` and
+ :class:`grok.Indexes` objects; see those classes for more
+ information.
"""
@@ -45,8 +46,11 @@
class LocalUtility(Contained, Persistent):
"""The base class for local utilities in Grok applications.
+ Defines a utility that will be registered local to a :class:`Site`
+ or :class:`grok.Application`.
+
Although application developers can create local utilies without
- actually subclassing `grokcore.site.LocalUtility`, they gain three
+ actually subclassing :class:`LocalUtility`, they gain three
benefits from doing so. First, their code is more readable
because their classes "look like" local utilities to casual
readers. Second, their utility will know how to persist itself to
More information about the checkins
mailing list