How to install Five
===================

Requirements for Five 1.2
-------------------------

* Zope 2.8.1+ with Python 2.3.x.  Zope 2.8.5+ is recommended as it
  contains a bugfix regarding Zope 3-style skins.

Note that Five 1.0 is already part of Zope 2.8.  This doesn't matter,
though, you can still install Five 1.2 into your Zope 2.8 instances.
It will override Zope's older version of Five.


Compatability matrix
--------------------

The following table shows which Five version can and should be used
with which Zope 2 and Zope 3 versions.

============ ======================= =========== ========
.                    Zope 2.7         Zope 2.8   Zope 2.9
------------ ----------------------- ----------- --------
.            Zope X3 3.0 (not incl.) Zope X3 3.0 Zope 3.2
============ ======================= =========== ========
Five 1.0                X             included
Five 1.1[#]_            X                 X
Five 1.2                                  X
Five 1.3                                         included
============ ======================= =========== ========

.. [#] This branch is no longer actively maintained.


Running the tests
-----------------

For information on how to install the automatic Five tests, please see
``tests/README.txt``.
