[Checkins] SVN: zope3docs/source/ Add some migration documentation.

[Dan Korostelev]

Log message for revision 96183:
  Add some migration documentation.

Changed:
  U   zope3docs/source/index.rst
  A   zope3docs/source/migration/
  A   zope3docs/source/migration/34to35.rst
  A   zope3docs/source/migration/index.rst

-=-
Modified: zope3docs/source/index.rst
===================================================================
--- zope3docs/source/index.rst	2009-02-06 10:39:48 UTC (rev 96182)
+++ zope3docs/source/index.rst	2009-02-06 10:58:19 UTC (rev 96183)
@@ -11,6 +11,7 @@
    :maxdepth: 2
 
    process/index
+   migration/index
 
 Indices and tables
 ==================

Added: zope3docs/source/migration/34to35.rst
===================================================================
--- zope3docs/source/migration/34to35.rst	                        (rev 0)
+++ zope3docs/source/migration/34to35.rst	2009-02-06 10:58:19 UTC (rev 96183)
@@ -0,0 +1,36 @@
+Migrating from Zope 3.4 to Zope 3.5
+===================================
+
+This document covers major changes since Zope 3.4 release that can lead to
+backward-incompatibilities.
+
+.. contents::
+
+zope.app.keyreference
+---------------------
+
+This package was renamed to ``zope.keyreference`` and all its functionality
+was moved to the new one. The new package contains a little workaround for
+making old persistent keyrerefences loadable without ``zope.app.keyreference``
+installed, so the latter one is not needed at all anymore.
+
+zope.app.intid and zope.app.catalog
+-----------------------------------
+
+The non-browser functionality of these packages was moved to ``zope.intid``
+and ``zope.catalog`` respectively. While backward-compatibility imports are
+maintained, you may want to use use imports from zope.* packages to get less
+dependencies, as the zope.app.* packages contains ZMI-specific browser views.
+
+zope.app.container
+------------------
+
+The exceptions used was changed, so if you code catches them, you need to
+review it.
+
+  * The DuplicationError in ``setitem`` was changed to KeyError.
+  * The UserError in ``NameChooser`` was changed to ValueError.
+
+The non-browser part of code was also splitted off to ``zope.container`` package
+but all backward-compatibility imports are maintained, so that should not be
+a problem.

Added: zope3docs/source/migration/index.rst
===================================================================
--- zope3docs/source/migration/index.rst	                        (rev 0)
+++ zope3docs/source/migration/index.rst	2009-02-06 10:58:19 UTC (rev 96183)
@@ -0,0 +1,10 @@
+Migration to newer Zope versions
+================================
+
+This area collects information about the backward-incompatible changes and
+new techniques developed and proposed within new Zope 3 releases.
+
+.. toctree::
+    :maxdepth: 1
+
+    34to35