the package itself and make it a doctest.

http://www.zope.org/Documentation/Books/ZDG/current/Acquisition.stx

Clenaup

* Updated svn externals to include Zope 3.2 (currently the Zope3 trunk);
  that includes two new top-level packages, pytz and zodbcode, as well as
  the following new zope.* packages:
  - zope.deprecation
  - zope.dottedname
  - zope.formlib
  - zope.index
  - zope.testbrowser

* Moved to a zpkgutils-based build system, as the Zope 3.2 extension modules
  require to be built with it. If everything goes ahead as planned, the release
  tarball will also be built with zpkgutils (some work has also been done in
  that direction).

* Upgraded Five to the 1.3b release (released today) which is a Zope 3.2-compatible
  version of Five 1.2b (also released today). Biggest implication of this on the
  Zope 2 trunk is that the event work by Florent Guillaume has been folded back
  into the Zope 2 core, i.e. the OFS package.

* A few fixes to the Zope 2 PageTemplate/TAL/TALES implementation to work with the
  new immutable i18n Messages available since Zope 3.1+ (and standard in Zope 3.2).

      - Collector #1879: applied patch by Dieter Maurer to fix a bug in 
        ac_aquire() ignoring the default argument

- added some basic conformance tests

Note that this is just a first step:
- there are still some z2 interfaces that are not bridged to z3 interfaces
- the bridging introduces a dependency on Five, non-dynamic z3 interfaces might be more suitable (but add redundant code)
- 'implements' declarations are not complete
- many interfaces have unresolved XXX coments

Two of the ZClasses tests are disabled here, because they
run afoul of Zope trunk's security machinery.  Jim needs to look
at them.  A blurb also needs to be added to CHANGES.txt.

Here are checkin msgs from the branch relating to Zope code
(the msgs relating to ZODB code were reproduced in the
ZODB 3.4 branch checkin):

    ------------------------------------------------------------------------
    r29869 | jim | 2005-04-04 07:04:21 -0400 (Mon, 04 Apr 2005) | 6 lines
    Changed paths:
       M /Zope/branches/jim-fix-zclasses/lib/python/ZClasses/ZClass.txt

    Added configuration of class factory.

    Use explicit tm for second connection rather than separate thread.

    Added copy test

    ------------------------------------------------------------------------
    r29868 | jim | 2005-04-04 07:03:57 -0400 (Mon, 04 Apr 2005) | 2 lines
    Changed paths:
       M /Zope/branches/jim-fix-zclasses/lib/python/ZClasses/_pmc.txt

    Added configuration of class factory.

    ------------------------------------------------------------------------
    r29776 | jim | 2005-04-01 06:24:31 -0500 (Fri, 01 Apr 2005) | 3 lines
    Changed paths:
       M /Zope/branches/jim-fix-zclasses/lib/python/OFS/tests/testProductInit.py

    Added clean-up code to remove non-exixtent directoris from products
    path.

    ------------------------------------------------------------------------
    r29775 | jim | 2005-04-01 06:24:29 -0500 (Fri, 01 Apr 2005) | 2 lines
    Changed paths:
       M /Zope/branches/jim-fix-zclasses/lib/python/ZClasses/tests.py

    Added missing abourt to tear-down code

    ------------------------------------------------------------------------
    r29772 | jim | 2005-04-01 06:24:22 -0500 (Fri, 01 Apr 2005) | 2 lines
    Changed paths:
       M /Zope/branches/jim-fix-zclasses/lib/python/App/ApplicationManager.py
       M /Zope/branches/jim-fix-zclasses/lib/python/ZClasses/Basic.py
       M /Zope/branches/jim-fix-zclasses/lib/python/ZClasses/ZClass.py
       M /Zope/branches/jim-fix-zclasses/lib/python/Zope2/App/startup.py

    Removed BoboPOS compatibility code.

    ------------------------------------------------------------------------
    r29201 | jim | 2005-02-18 07:18:05 -0500 (Fri, 18 Feb 2005) | 3 lines
    Changed paths:
       A /Zope/branches/jim-fix-zclasses/lib/python/ZClasses/27.fs
       A /Zope/branches/jim-fix-zclasses/lib/python/ZClasses/27.txt
       M /Zope/branches/jim-fix-zclasses/lib/python/ZClasses/tests.py

    Added a test for reading ZClasses and their instances from Zope 2.7
    databases.

    ------------------------------------------------------------------------
    r29149 | jim | 2005-02-15 07:24:49 -0500 (Tue, 15 Feb 2005) | 2 lines
    Changed paths:
       M /Zope/branches/jim-fix-zclasses/lib/python/ZClasses/ZClass.txt
       M /Zope/branches/jim-fix-zclasses/lib/python/ZClasses/tests.py

    Made the tests a bit more thorough.

    ------------------------------------------------------------------------
    r29148 | jim | 2005-02-15 07:24:44 -0500 (Tue, 15 Feb 2005) | 3 lines
    Changed paths:
       M /Zope/branches/jim-fix-zclasses/lib/python/OFS/tests/testAppInitializer.py

    Made the test cleanup more robust by cleaning up any non-existent
    directories found in Products.__path__.

    ------------------------------------------------------------------------
    r29147 | jim | 2005-02-15 07:24:37 -0500 (Tue, 15 Feb 2005) | 3 lines
    Changed paths:
       M /Zope/branches/jim-fix-zclasses/lib/python/ExtensionClass/ExtensionClass.h
       M /Zope/branches/jim-fix-zclasses/lib/python/ExtensionClass/_ExtensionClass.c

    Fixed code that assumed that there weren't subclasses of the
    ExtensionClass meta class.

    ------------------------------------------------------------------------
    r29136 | jim | 2005-02-13 11:37:33 -0500 (Sun, 13 Feb 2005) | 3 lines
    Changed paths:
       M /Zope/branches/jim-fix-zclasses/lib/python/ZClasses/ZClass.py
       M /Zope/branches/jim-fix-zclasses/lib/python/ZClasses/ZClass.txt
       M /Zope/branches/jim-fix-zclasses/lib/python/ZClasses/_pmc.py
       M /Zope/branches/jim-fix-zclasses/lib/python/ZClasses/tests.py

    Integrated persistent metaclass with ZClasses and got basic ZClass
    test to pass.

    ------------------------------------------------------------------------
    r29135 | jim | 2005-02-13 11:15:15 -0500 (Sun, 13 Feb 2005) | 3 lines
    Changed paths:
       M /Zope/branches/jim-fix-zclasses/lib/python/ExtensionClass/_ExtensionClass.c
       M /Zope/branches/jim-fix-zclasses/lib/python/ExtensionClass/tests.py

    Fixed bug in Base __getattro__ that caused __of__ to be missed in
    instances of instances of subclasses (meta classes) of ExtensionClass.

    ------------------------------------------------------------------------
    r29072 | jim | 2005-02-07 07:36:07 -0500 (Mon, 07 Feb 2005) | 5 lines
    Changed paths:
       M /Zope/branches/jim-fix-zclasses/lib/python/ZClasses/Property.py
       M /Zope/branches/jim-fix-zclasses/lib/python/ZClasses/ZClass.py

    Fixed some code for registering class changes to avoid the
    registration of data managers that are None.  This code will,
    eventually, go away, since new persistent classes will
    take care of their own registration.

    ------------------------------------------------------------------------
    r29070 | jim | 2005-02-07 07:36:03 -0500 (Mon, 07 Feb 2005) | 3 lines
    Changed paths:
       A /Zope/branches/jim-fix-zclasses/lib/python/ZClasses/ZClass.txt

    Created a basic ZClass test. It still isn't used, because the
    persistent meta class hasn't been integrated yet.

    ------------------------------------------------------------------------
    r29069 | jim | 2005-02-07 07:36:01 -0500 (Mon, 07 Feb 2005) | 3 lines
    Changed paths:
       A /Zope/branches/jim-fix-zclasses/lib/python/ZClasses/_pmc.py
       A /Zope/branches/jim-fix-zclasses/lib/python/ZClasses/_pmc.txt
       A /Zope/branches/jim-fix-zclasses/lib/python/ZClasses/tests.py

    Created a meta class for persistent classes.  This is based very
    loosly on the experimental persistent class code from Zope 3.

    ------------------------------------------------------------------------
    r29068 | jim | 2005-02-07 07:35:58 -0500 (Mon, 07 Feb 2005) | 2 lines
    Changed paths:
       M /Zope/branches/jim-fix-zclasses/lib/python/ExtensionClass/_ExtensionClass.c

    Made the ExtensionClass meta class subclassible.

    ------------------------------------------------------------------------
    r29065 | jim | 2005-02-07 07:35:52 -0500 (Mon, 07 Feb 2005) | 3 lines
    Changed paths:
       M /Zope/branches/jim-fix-zclasses/lib/python/OFS/tests/testAppInitializer.py

    Added missing cleanup code to return Products.__path__ to it's
    original state.

     - Collector #1406: fixed segmentation fault by acquisition

  - replaced old CVS expansion with a clean $Id$
  - set the svn:keywords property to "Id"

When you check-in files in the future and want $Id$ to be expanded,
make sure it reads "$Id$" in that file; then set svn:keywords to "Id".

ZODB, ZEO, Persistence and similar packages were not modified since they
are really maintained elsewhere. Right now, we use a copy of them in our
Zope/Zope3 trees. We should go back to the module sharing (using
svn:externals).