Changeset 4273 for waeup


Ignore:
Timestamp:
13 Jun 2009, 11:35:46 (16 years ago)
Author:
uli
Message:

Make app.txt sphinx-aware.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • waeup/branches/ulif-rewrite/src/waeup/app.txt

    r3933 r4273  
    1 waeup.app
    2 *********
    3 
    4 Base components for a WAeUP portal.
     1:mod:`waeup.app` -- central components for a WAeUP portal
     2*********************************************************
    53
    64:Test-Layer: unit
    75
    8 The main WAeUP application object is given with `University`. It
    9 provides the main containers as faculties, hostels, etc.
     6.. module:: waeup.app
     7
     8.. class:: University
     9
     10  The main WAeUP application object is given with
     11  :class:`University`. It provides the main containers as faculties,
     12  hostels, etc.
     13
     14  .. attribute:: name
     15
     16     A string. The name of a university.
     17
     18  .. attribute:: faculties
     19
     20     An arbitrary object containing "faculties". In the case of
     21     `University` it is a container of type
     22     `waeup.interfaces.IFacultyContainer`.
     23
    1024
    1125Creating `University` instances
    1226===============================
    1327
    14 As `University` instances make use of the Zope Component Architecture
    15 (ZCA), we have to setup the basic component registries, before we can
    16 create instances. We do this by simply grokking the whole `waeup`
    17 package. This way all interfaces, utilities and adapters defined in
    18 the package are looked up and registered with the global registries::
     28As :class:`University` instances make use of the Zope Component
     29Architecture (ZCA), we have to setup the basic component registries,
     30before we can create instances. We do this by simply grokking the
     31whole :mod:`waeup` package. This way all interfaces, utilities and adapters
     32defined in the package are looked up and registered with the global
     33registries:
    1934
    2035    >>> import grok
    2136    >>> grok.testing.grok('waeup')
    2237
    23 Now we can import the `University` class and create an instence::
     38Now we can import the :class:`University` class and create an
     39instance:
    2440
    2541    >>> from waeup.app import University
     
    2945
    3046Instances of `University` comply with the interface
    31 `waeup.interfaces.IUniversity`::
     47`waeup.interfaces.IUniversity`:
    3248
    3349    >>> from zope.interface.verify import verifyClass
     
    3652    True
    3753
    38 University attributes
    39 =====================
    40 
    41 Instances of University provide some attributes as described in the
    42 `IUniversity` interface:
    43 
    44 ``name``
    45    A string. The name of a university.
    46 
    47 ``faculties``
    48    An arbitrary object containing "faculties". In the case of
    49    `University` it is a container of type
    50    `waeup.interfaces.IFacultyContainer`.
    51 
    52 A freshly created instance provides these attributes::
     54A freshly created instance provides the attributes promised by the
     55interface:
    5356
    5457    >>> from waeup.app import University
Note: See TracChangeset for help on using the changeset viewer.