Installing the ClockServer Product

    You will need Zope version 2.7.1 or higher.

    First, unzip and untar the compressed surce file into a place where 
    Zope can find it, namely the "Products" directory.

        $ cp ClockServer-xyz.tgz <zope_instance>/Products
        $ cd <zope_instance>/Products
        $ tar zxvf ClockServer-xyz.tgz
        <watch files being decompressed>

    Then compile the C extension (timeslicemodule.c) that ships with
    the product by running 'make' inside of the newly created
    ClockServer directory.

        $ cd ClockServer
        $ make

    Do not forget to restart Zope afterwards. See README.txt for any other 
    dependencies and requirements.

Configuring Your Zope Instance to Use the ClockServer Product

    In your Zope instance's "zope.conf" file place the following line
    in order to allow you to use the "clock-server" directive::

        %import Products.ClockServer

    Create a "clock-server" directive section anywhere beneath the
    import line, like so::

       <clock-server>
          method /do_stuff
          period 60
          user admin
          password 123
       </clock-server>

    Descriptions of the values within the clock-server section
    follow:

       method -- the traversal path (from the Zope root) to an
       executable Zope method (Python Script, external method, product
       method, etc).  The method must take no arguments.

       period -- the number of seconds between each clock "tick" (and
       thus each call to the above "method").  The lowest number
       providable here is typically 30 (this is the asyncore mainloop
       "timeout" value).

       user -- a zope username.

       password -- the password for the zope username provided above.


