release notes on Zope

[A Mennucc]

hi

I posted bug 417553 (with CC to this list) into release-notes ,
asking that a paragraph  may be added into the Etch release notes
about Zope

since the diff to SGML is not very readable, here is the  text:

--------------------
5.6 Upgrading Zope and Plone

Zope and all zope related products were updated; sarge shipped Zope 2.7
, that depends on Python 2.3 ; and it shipped CMF 1.4 and Plone 2.0.5 ;
while etch instead ships Zope 2.9, which depends on Python 2.4, CMF 1.6
and Plone 2.5.1. Many products were also dropped from the distribution
(either because they were obsoleted, or incompatible with the newer
Zope, CMF and Plone).

The user wishing to upgrade must beware of a known fact: there is no
easy and guaranteed way to upgrade a complex Zope or Plone server. Even
though Plone contains a migration tool, indeed, due to the complexity of
the Plone server, it has been experienced that the automatic migration
may easily fail.

For this reason, it is recommended that the user willing to upgrade be
able to run both the old (= sarge) and the new (= etch) version of
Debian for as long as needed for the correct migration of his Zope /
Plone services. The easiest and safest way to achieve this is to make a
copy of the O.S. onto another hard disk or hard disk partition, and then
upgrade one of the two copies , and use chroots to run the sarge version
in parallel to the etch version.

In case this is not possible, there is a limited possibility of running
different versions of those products in the same Debian installation: it
is indeed possible to concurrently keep Zope 2.7 and 2.9 , and Python
2.3 and 2.4 installed in Debian , since different versions are in
packages by different names, namely zope2.7, zope2.9, python2.3,
python2.4. But it is very important to notice that etch does not contain
the sarge versions: so, during upgrade, good care must be taken that the
old version not be removed; to this end, package holding (as explained
in Checking packages status, Section 4.2.3) may be helpful. Also, the
above does not apply to Plone, since the zope-cmfplone package is not
similarly versioned, alas.

----------------

a.

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 252 bytes
Desc: OpenPGP digital signature
Url : http://lists.alioth.debian.org/pipermail/pkg-zope-developers/attachments/20070403/b510dac7/signature.pgp