[Checkins] SVN: zopetoolkit/ Generate package information and release information automatically.
Christian Theune
ct at gocept.com
Mon Sep 14 12:18:28 EDT 2009
Log message for revision 103963:
Generate package information and release information automatically.
Changed:
U zopetoolkit/doc/Makefile
U zopetoolkit/doc/buildout.cfg
A zopetoolkit/doc/scripts/
A zopetoolkit/doc/scripts/packages
A zopetoolkit/doc/scripts/update-launchpad.py
A zopetoolkit/doc/scripts/update-releaseinfo.py
U zopetoolkit/doc/source/_static/ztk.css
U zopetoolkit/doc/source/about/index.rst
D zopetoolkit/doc/source/about/packages.rst
U zopetoolkit/doc/source/index.rst
D zopetoolkit/doc/source/migration/
A zopetoolkit/doc/source/releases/
D zopetoolkit/doc/source/releases/34to35.rst
D zopetoolkit/doc/source/releases/index.rst
U zopetoolkit/trunk/index.rst
-=-
Modified: zopetoolkit/doc/Makefile
===================================================================
--- zopetoolkit/doc/Makefile 2009-09-14 16:17:48 UTC (rev 103962)
+++ zopetoolkit/doc/Makefile 2009-09-14 16:18:27 UTC (rev 103963)
@@ -11,9 +11,9 @@
PAPEROPT_letter = -D latex_paper_size=letter
ALLSPHINXOPTS = -d build/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source
-.PHONY: help clean html web pickle htmlhelp latex changes linkcheck all
+.PHONY: help clean html web pickle htmlhelp latex changes linkcheck all releaseinfo
-all: html
+all: releaseinfo html
help:
@echo "Please use \`make <target>' where <target> is one of"
@@ -28,6 +28,9 @@
clean:
-rm -rf build/*
+releaseinfo:
+ bin/py scripts/update-releaseinfo.py
+
html:
mkdir -p build/html build/doctrees
$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) build/html
Modified: zopetoolkit/doc/buildout.cfg
===================================================================
--- zopetoolkit/doc/buildout.cfg 2009-09-14 16:17:48 UTC (rev 103962)
+++ zopetoolkit/doc/buildout.cfg 2009-09-14 16:18:27 UTC (rev 103963)
@@ -1,6 +1,10 @@
[buildout]
-parts = doc
+parts = doc py
+[py]
+recipe = zc.recipe.egg
+interpreter = py
+
[doc]
recipe = zc.recipe.egg
eggs = sphinx
Added: zopetoolkit/doc/scripts/packages
===================================================================
--- zopetoolkit/doc/scripts/packages (rev 0)
+++ zopetoolkit/doc/scripts/packages 2009-09-14 16:18:27 UTC (rev 103963)
@@ -0,0 +1,54 @@
+zope.annotation
+zope.cachedescriptors
+zope.catalog
+zope.component
+zope.configuration
+zope.container
+zope.contentprovider
+zope.contenttype
+zope.copypastemove
+zope.datetime
+zope.deferredimport
+zope.deprecation
+zope.documenttemplate
+zope.dottedname
+zope.dublincore
+zope.error
+zope.event
+zope.exceptions
+zope.file
+zope.filerepresentation
+zope.formlib
+zope.hookable
+zope.html
+zope.i18n
+zope.i18nmessageid
+zope.index
+zope.interface
+zope.intid
+zope.keyreference
+zope.lifecycleevent
+zope.location
+zope.mimetype
+zope.minmax
+zope.pagetemplate
+zope.proxy
+zope.publisher
+zope.rdb
+zope.schema
+zope.security
+zope.securitypolicy
+zope.sendmail
+zope.sequencesort
+zope.server
+zope.session
+zope.site
+zope.size
+zope.structuredtext
+zope.tal
+zope.tales
+zope.testbrowser
+zope.testing
+zope.testrecorder
+zope.traversing
+zope.viewlet
Added: zopetoolkit/doc/scripts/update-launchpad.py
===================================================================
--- zopetoolkit/doc/scripts/update-launchpad.py (rev 0)
+++ zopetoolkit/doc/scripts/update-launchpad.py 2009-09-14 16:18:27 UTC (rev 103963)
@@ -0,0 +1,49 @@
+from launchpadlib.launchpad import Launchpad, EDGE_SERVICE_ROOT
+from launchpadlib.credentials import Credentials
+import os
+import os.path
+
+ZTK = os.path.expanduser(os.path.join('~', '.ztk'))
+CACHEDIR = os.path.join(ZTK, 'cache')
+CREDENTIALS = os.path.join(ZTK, 'credentials')
+
+if not os.path.exists(ZTK):
+ os.mkdir(ZTK)
+
+try:
+ credentials = Credentials()
+ credentials.load(open(CREDENTIALS))
+ launchpad = Launchpad(credentials, EDGE_SERVICE_ROOT, CACHEDIR)
+except:
+ launchpad = Launchpad.get_token_and_login(
+ 'ZTK helper tools', EDGE_SERVICE_ROOT, CACHEDIR)
+ launchpad.credentials.save(open(CREDENTIALS, 'w'))
+
+ztk_group = launchpad.project_groups['zopetoolkit']
+
+# XXX Currently needs a file 'packages' that reflects which packages we
+# manage.
+for project in open('packages'):
+ project = project.strip()
+ print project,
+ try:
+ project = launchpad.projects[project]
+ except KeyError:
+ project = launchpad.projects.new_project(
+ display_name=project,
+ home_page_url='http://pypi.python.org/pypi/%s' % project,
+ name=project,
+ summary='XXX Fill in',
+ title=project)
+ print "created",
+
+ # Ensure project group is ztk
+ print "Updating project data"
+ project.project_group_link = ztk_group
+ project.licenses = [u'Zope Public License']
+ project.programming_language = 'Python'
+ try:
+ project.lp_save()
+ except:
+ print "\tfailed"
+ continue
Property changes on: zopetoolkit/doc/scripts/update-launchpad.py
___________________________________________________________________
Added: svn:mergeinfo
+
Added: zopetoolkit/doc/scripts/update-releaseinfo.py
===================================================================
--- zopetoolkit/doc/scripts/update-releaseinfo.py (rev 0)
+++ zopetoolkit/doc/scripts/update-releaseinfo.py 2009-09-14 16:18:27 UTC (rev 103963)
@@ -0,0 +1,162 @@
+# Generate package list information for trunk and tags of ZTK.
+
+import ConfigParser
+import StringIO
+import os
+import os.path
+import shutil
+import socket
+import urllib2
+import xml.etree.ElementTree
+
+socket.setdefaulttimeout(10)
+
+
+TABLE_HEADER = """\
+.. list-table::
+ :class: packagelist
+ :widths: 25 10 40 25
+ :header-rows: 1
+
+ * - Name
+ - Version
+ - Description
+ - Links\
+"""
+
+PACKAGE_LINE_BASE = """
+ * - `%(name)s <%(homepage)s>`_
+ - %(version)s
+ - %(description)s\
+"""
+
+DEPENDENCY_PACKAGE_LINE = PACKAGE_LINE_BASE + """
+ - \
+"""
+
+PACKAGE_LINE = PACKAGE_LINE_BASE + """
+ - `Bugs <http://bugs.launchpad.net/%(name)s>`_ |
+ `Subversion <http://svn.zope.org/%(name)s>`_ \
+"""
+
+GENERATED_WARNING = """\
+.. This file is generated. Please do not edit manually or check in.
+"""
+
+DOAP_NS = 'http://usefulinc.com/ns/doap#'
+TAGS_DIR = os.path.join(os.pardir, 'tags')
+
+def package_list(packages, config, out,
+ line=PACKAGE_LINE):
+ print >>out, TABLE_HEADER
+ for package in sorted(packages):
+ version = config.get('versions', package)
+ doap_xml = urllib2.urlopen(
+ 'http://pypi.python.org/pypi?:action=doap&name=%s&version=%s' %
+ (package, version)).read()
+ doap_xml = StringIO.StringIO(doap_xml.replace('\f', ''))
+ doap = xml.etree.ElementTree.ElementTree()
+ doap.parse(doap_xml)
+ description = doap.find('//{%s}shortdesc' % DOAP_NS).text
+ homepage = doap.find('//{%s}homepage' % DOAP_NS)
+ if homepage:
+ homepage = doap.find('//{%s}homepage' % DOAP_NS).get(
+ '{http://www.w3.org/1999/02/22-rdf-syntax-ns#}resource', '')
+ else:
+ # Wah.
+ homepage = 'http://pypi.python.org'
+ print >>output, line % dict(
+ name=package, homepage=homepage,
+ description=description, version=version)
+ print >>out
+
+
+def packages(config, key):
+ result = config.get('ztk', key).split('\n')
+ result = filter(None, map(str.strip, result))
+ return result
+
+
+releases = [('trunk', os.path.join(os.pardir, 'trunk'))]
+
+for tag in os.listdir(TAGS_DIR):
+ if tag.startswith('.'):
+ continue
+ releases.append((tag, os.path.join(TAGS_DIR, tag)))
+
+for release, location in releases:
+ print "Writing package list for", release
+ config = ConfigParser.RawConfigParser()
+ config.optionxform = str
+ config.read([os.path.join(location, 'ztk.cfg')])
+
+ output = open(os.path.join('source', 'releases',
+ 'packages-%s.rst' % release), 'w')
+
+ print >>output, GENERATED_WARNING
+
+ heading = 'Zope Toolkit %s packages' % release
+ print >>output, heading
+ print >>output, '=' * len(heading)
+ included = packages(config, 'included')
+ package_list(included, config, output)
+
+ print >>output, 'Under review'
+ print >>output, '------------'
+ review = packages(config, 'under-review')
+ package_list(review, config, output)
+
+ print >>output, 'Dependencies'
+ print >>output, '------------'
+ all = config.options('versions')
+ dependencies = set(all) - (set(included) | set(review))
+ package_list(dependencies, config, output, DEPENDENCY_PACKAGE_LINE)
+
+ output.close()
+
+print "Writing overview"
+
+output = open(os.path.join('source', 'releases', 'index.rst'), 'w')
+print >>output, GENERATED_WARNING
+print >>output, """
+Releases
+========
+
+This area collects release-specific information about the toolkit including a
+list of backward-incompatible changes, new techniques developed, and libraries
+included.
+
+.. toctree::
+ :maxdepth: 1
+
+"""
+
+for release, location in releases:
+ print >>output, """
+ overview-%s\
+""" % release
+
+
+for release, location in releases:
+ overview = open(os.path.join('source', 'releases',
+ 'overview-%s.rst' % release), 'w')
+ print >>overview, GENERATED_WARNING
+ title = "Zope Toolkit %s" % release
+ print >>overview, title
+ print >>overview, "=" * len(title)
+ print >>overview, """
+This document covers major changes in this release that can lead to
+backward-incompatibilities and explains what to look out for when updating.
+
+.. contents::
+ :local:
+
+List of packages
+----------------
+
+See the separate `package list <packages-%s.html>`_ document.
+
+""" % release
+
+ overview.write(open(os.path.join(location, 'index.rst')).read())
+ overview.close()
Property changes on: zopetoolkit/doc/scripts/update-releaseinfo.py
___________________________________________________________________
Added: svn:mergeinfo
+
Modified: zopetoolkit/doc/source/_static/ztk.css
===================================================================
--- zopetoolkit/doc/source/_static/ztk.css 2009-09-14 16:17:48 UTC (rev 103962)
+++ zopetoolkit/doc/source/_static/ztk.css 2009-09-14 16:18:27 UTC (rev 103963)
@@ -5,3 +5,8 @@
div.body li {
text-align:left;
}
+
+
+table.packagelist {
+ width: 100%;
+}
Modified: zopetoolkit/doc/source/about/index.rst
===================================================================
--- zopetoolkit/doc/source/about/index.rst 2009-09-14 16:17:48 UTC (rev 103962)
+++ zopetoolkit/doc/source/about/index.rst 2009-09-14 16:18:27 UTC (rev 103963)
@@ -8,6 +8,5 @@
history
coreextra
concepts
- packages
Deleted: zopetoolkit/doc/source/about/packages.rst
===================================================================
--- zopetoolkit/doc/source/about/packages.rst 2009-09-14 16:17:48 UTC (rev 103962)
+++ zopetoolkit/doc/source/about/packages.rst 2009-09-14 16:18:27 UTC (rev 103963)
@@ -1,161 +0,0 @@
-Libraries
----------
-
-This is the list of libraries that belong to the Zope Toolkit and are governed
-by the ZTK development process.
-
-============================ ========================================================================================================= =========================================================================================================================================================================================================
-Name Description Links
-============================ ========================================================================================================= =========================================================================================================================================================================================================
-zope.annotation Object annotation mechanism `Subversion <http://svn.zope.org/zope.annotation>`_ | `PyPI <http://pypi.python.org/pypi/zope.annotation>`_ | `Bugs <http://bugs.launchpad.net/zope.annotation>`_
-zope.cachedescriptors Method and property caching decorators `Subversion <http://svn.zope.org/zope.cachedescriptors>`_ | `PyPI <http://pypi.python.org/pypi/zope.cachedescriptors>`_ | `Bugs <http://bugs.launchpad.net/zope.cachedescriptors>`_
-zope.catalog Cataloging and Indexing Framework for Zope 3 `Subversion <http://svn.zope.org/zope.catalog>`_ | `PyPI <http://pypi.python.org/pypi/zope.catalog>`_ | `Bugs <http://bugs.launchpad.net/zope.catalog>`_
-zope.component Zope Component Architecture `Subversion <http://svn.zope.org/zope.component>`_ | `PyPI <http://pypi.python.org/pypi/zope.component>`_ | `Bugs <http://bugs.launchpad.net/zope.component>`_
-zope.configuration Zope Configuration Markup Language (ZCML) `Subversion <http://svn.zope.org/zope.configuration>`_ | `PyPI <http://pypi.python.org/pypi/zope.configuration>`_ | `Bugs <http://bugs.launchpad.net/zope.configuration>`_
-zope.container Zope Container `Subversion <http://svn.zope.org/zope.container>`_ | `PyPI <http://pypi.python.org/pypi/zope.container>`_ | `Bugs <http://bugs.launchpad.net/zope.container>`_
-zope.contentprovider Content Provider Framework for Zope Templates `Subversion <http://svn.zope.org/zope.contentprovider>`_ | `PyPI <http://pypi.python.org/pypi/zope.contentprovider>`_ | `Bugs <http://bugs.launchpad.net/zope.contentprovider>`_
-zope.contenttype Zope contenttype `Subversion <http://svn.zope.org/zope.contenttype>`_ | `PyPI <http://pypi.python.org/pypi/zope.contenttype>`_ | `Bugs <http://bugs.launchpad.net/zope.contenttype>`_
-zope.copypastemove Copy, Paste and Move support for content components. `Subversion <http://svn.zope.org/zope.copypastemove>`_ | `PyPI <http://pypi.python.org/pypi/zope.copypastemove>`_ | `Bugs <http://bugs.launchpad.net/zope.copypastemove>`_
-zope.datetime Zope datetime `Subversion <http://svn.zope.org/zope.datetime>`_ | `PyPI <http://pypi.python.org/pypi/zope.datetime>`_ | `Bugs <http://bugs.launchpad.net/zope.datetime>`_
-zope.deferredimport zope.deferredimport allows you to perform imports names that will only be resolved when used in the code. `Subversion <http://svn.zope.org/zope.deferredimport>`_ | `PyPI <http://pypi.python.org/pypi/zope.deferredimport>`_ | `Bugs <http://bugs.launchpad.net/zope.deferredimport>`_
-zope.deprecation Zope 3 Deprecation Infrastructure `Subversion <http://svn.zope.org/zope.deprecation>`_ | `PyPI <http://pypi.python.org/pypi/zope.deprecation>`_ | `Bugs <http://bugs.launchpad.net/zope.deprecation>`_
-zope.documenttemplate Document Templating Markup Language (DTML) `Subversion <http://svn.zope.org/zope.documenttemplate>`_ | `PyPI <http://pypi.python.org/pypi/zope.documenttemplate>`_ | `Bugs <http://bugs.launchpad.net/zope.documenttemplate>`_
-zope.dottedname Resolver for Python dotted names. `Subversion <http://svn.zope.org/zope.dottedname>`_ | `PyPI <http://pypi.python.org/pypi/zope.dottedname>`_ | `Bugs <http://bugs.launchpad.net/zope.dottedname>`_
-zope.dublincore Zope Dublin Core implementation `Subversion <http://svn.zope.org/zope.dublincore>`_ | `PyPI <http://pypi.python.org/pypi/zope.dublincore>`_ | `Bugs <http://bugs.launchpad.net/zope.dublincore>`_
-zope.error An error reporting utility for Zope3 `Subversion <http://svn.zope.org/zope.error>`_ | `PyPI <http://pypi.python.org/pypi/zope.error>`_ | `Bugs <http://bugs.launchpad.net/zope.error>`_
-zope.event Very basic event publishing system `Subversion <http://svn.zope.org/zope.event>`_ | `PyPI <http://pypi.python.org/pypi/zope.event>`_ | `Bugs <http://bugs.launchpad.net/zope.event>`_
-zope.exceptions Zope Exceptions `Subversion <http://svn.zope.org/zope.exceptions>`_ | `PyPI <http://pypi.python.org/pypi/zope.exceptions>`_ | `Bugs <http://bugs.launchpad.net/zope.exceptions>`_
-zope.file Efficient File Implementation for Zope Applications `Subversion <http://svn.zope.org/zope.file>`_ | `PyPI <http://pypi.python.org/pypi/zope.file>`_ | `Bugs <http://bugs.launchpad.net/zope.file>`_
-zope.filerepresentation File-system Representation Interfaces `Subversion <http://svn.zope.org/zope.filerepresentation>`_ | `PyPI <http://pypi.python.org/pypi/zope.filerepresentation>`_ | `Bugs <http://bugs.launchpad.net/zope.filerepresentation>`_
-zope.formlib Form generation and validation library for Zope `Subversion <http://svn.zope.org/zope.formlib>`_ | `PyPI <http://pypi.python.org/pypi/zope.formlib>`_ | `Bugs <http://bugs.launchpad.net/zope.formlib>`_
-zope.hookable Zope hookable `Subversion <http://svn.zope.org/zope.hookable>`_ | `PyPI <http://pypi.python.org/pypi/zope.hookable>`_ | `Bugs <http://bugs.launchpad.net/zope.hookable>`_
-zope.html HTML and XHTML Editing Support `Subversion <http://svn.zope.org/zope.html>`_ | `PyPI <http://pypi.python.org/pypi/zope.html>`_ | `Bugs <http://bugs.launchpad.net/zope.html>`_
-zope.i18n Zope3 Internationalization Support `Subversion <http://svn.zope.org/zope.i18n>`_ | `PyPI <http://pypi.python.org/pypi/zope.i18n>`_ | `Bugs <http://bugs.launchpad.net/zope.i18n>`_
-zope.i18nmessageid Message Identifiers for internationalization `Subversion <http://svn.zope.org/zope.i18nmessageid>`_ | `PyPI <http://pypi.python.org/pypi/zope.i18nmessageid>`_ | `Bugs <http://bugs.launchpad.net/zope.i18nmessageid>`_
-zope.index Indices for using with catalog like text, field, etc. `Subversion <http://svn.zope.org/zope.index>`_ | `PyPI <http://pypi.python.org/pypi/zope.index>`_ | `Bugs <http://bugs.launchpad.net/zope.index>`_
-zope.interface Interfaces for Python `Subversion <http://svn.zope.org/zope.interface>`_ | `PyPI <http://pypi.python.org/pypi/zope.interface>`_ | `Bugs <http://bugs.launchpad.net/zope.interface>`_
-zope.intid Integer Id Utility `Subversion <http://svn.zope.org/zope.intid>`_ | `PyPI <http://pypi.python.org/pypi/zope.intid>`_ | `Bugs <http://bugs.launchpad.net/zope.intid>`_
-zope.keyreference Key References `Subversion <http://svn.zope.org/zope.keyreference>`_ | `PyPI <http://pypi.python.org/pypi/zope.keyreference>`_ | `Bugs <http://bugs.launchpad.net/zope.keyreference>`_
-zope.lifecycleevent Object life-cycle events `Subversion <http://svn.zope.org/zope.lifecycleevent>`_ | `PyPI <http://pypi.python.org/pypi/zope.lifecycleevent>`_ | `Bugs <http://bugs.launchpad.net/zope.lifecycleevent>`_
-zope.location Zope Location `Subversion <http://svn.zope.org/zope.location>`_ | `PyPI <http://pypi.python.org/pypi/zope.location>`_ | `Bugs <http://bugs.launchpad.net/zope.location>`_
-zope.mimetype A simple package for working with MIME content types `Subversion <http://svn.zope.org/zope.mimetype>`_ | `PyPI <http://pypi.python.org/pypi/zope.mimetype>`_ | `Bugs <http://bugs.launchpad.net/zope.mimetype>`_
-zope.minmax Homogeneous values favoring maximum or minimum for ZODB conflict resolution `Subversion <http://svn.zope.org/zope.minmax>`_ | `PyPI <http://pypi.python.org/pypi/zope.minmax>`_ | `Bugs <http://bugs.launchpad.net/zope.minmax>`_
-zope.pagetemplate Zope Page Templates `Subversion <http://svn.zope.org/zope.pagetemplate>`_ | `PyPI <http://pypi.python.org/pypi/zope.pagetemplate>`_ | `Bugs <http://bugs.launchpad.net/zope.pagetemplate>`_
-zope.proxy Generic Transparent Proxies `Subversion <http://svn.zope.org/zope.proxy>`_ | `PyPI <http://pypi.python.org/pypi/zope.proxy>`_ | `Bugs <http://bugs.launchpad.net/zope.proxy>`_
-zope.publisher The Zope publisher publishes Python objects on the web. `Subversion <http://svn.zope.org/zope.publisher>`_ | `PyPI <http://pypi.python.org/pypi/zope.publisher>`_ | `Bugs <http://bugs.launchpad.net/zope.publisher>`_
-zope.rdb Zope RDBMS transaction integration `Subversion <http://svn.zope.org/zope.rdb>`_ | `PyPI <http://pypi.python.org/pypi/zope.rdb>`_ | `Bugs <http://bugs.launchpad.net/zope.rdb>`_
-zope.schema zope.interface extension for defining data schemas `Subversion <http://svn.zope.org/zope.schema>`_ | `PyPI <http://pypi.python.org/pypi/zope.schema>`_ | `Bugs <http://bugs.launchpad.net/zope.schema>`_
-zope.security Zope3 Security Framework `Subversion <http://svn.zope.org/zope.security>`_ | `PyPI <http://pypi.python.org/pypi/zope.security>`_ | `Bugs <http://bugs.launchpad.net/zope.security>`_
-zope.securitypolicy Default security policy for Zope3 `Subversion <http://svn.zope.org/zope.securitypolicy>`_ | `PyPI <http://pypi.python.org/pypi/zope.securitypolicy>`_ | `Bugs <http://bugs.launchpad.net/zope.securitypolicy>`_
-zope.sendmail Zope sendmail `Subversion <http://svn.zope.org/zope.sendmail>`_ | `PyPI <http://pypi.python.org/pypi/zope.sendmail>`_ | `Bugs <http://bugs.launchpad.net/zope.sendmail>`_
-zope.sequencesort Sequence Sorting `Subversion <http://svn.zope.org/zope.sequencesort>`_ | `PyPI <http://pypi.python.org/pypi/zope.sequencesort>`_ | `Bugs <http://bugs.launchpad.net/zope.sequencesort>`_
-zope.server Zope Server (Web and FTP) `Subversion <http://svn.zope.org/zope.server>`_ | `PyPI <http://pypi.python.org/pypi/zope.server>`_ | `Bugs <http://bugs.launchpad.net/zope.server>`_
-zope.session Client identification and sessions for Zope `Subversion <http://svn.zope.org/zope.session>`_ | `PyPI <http://pypi.python.org/pypi/zope.session>`_ | `Bugs <http://bugs.launchpad.net/zope.session>`_
-zope.site Local registries for zope component architecture `Subversion <http://svn.zope.org/zope.site>`_ | `PyPI <http://pypi.python.org/pypi/zope.site>`_ | `Bugs <http://bugs.launchpad.net/zope.site>`_
-zope.size Interfaces and simple adapter that give the size of an object `Subversion <http://svn.zope.org/zope.size>`_ | `PyPI <http://pypi.python.org/pypi/zope.size>`_ | `Bugs <http://bugs.launchpad.net/zope.size>`_
-zope.structuredtext StructuredText parser `Subversion <http://svn.zope.org/zope.structuredtext>`_ | `PyPI <http://pypi.python.org/pypi/zope.structuredtext>`_ | `Bugs <http://bugs.launchpad.net/zope.structuredtext>`_
-zope.tal Zope 3 Template Application Languate (TAL) `Subversion <http://svn.zope.org/zope.tal>`_ | `PyPI <http://pypi.python.org/pypi/zope.tal>`_ | `Bugs <http://bugs.launchpad.net/zope.tal>`_
-zope.tales Zope 3 Template Application Language Expression Syntax (TALES) `Subversion <http://svn.zope.org/zope.tales>`_ | `PyPI <http://pypi.python.org/pypi/zope.tales>`_ | `Bugs <http://bugs.launchpad.net/zope.tales>`_
-zope.testbrowser Programmable browser for functional black-box tests `Subversion <http://svn.zope.org/zope.testbrowser>`_ | `PyPI <http://pypi.python.org/pypi/zope.testbrowser>`_ | `Bugs <http://bugs.launchpad.net/zope.testbrowser>`_
-zope.testing Zope testing framework, including the testrunner script. `Subversion <http://svn.zope.org/zope.testing>`_ | `PyPI <http://pypi.python.org/pypi/zope.testing>`_ | `Bugs <http://bugs.launchpad.net/zope.testing>`_
-zope.testrecorder Test recorder for functional tests `Subversion <http://svn.zope.org/zope.testrecorder>`_ | `PyPI <http://pypi.python.org/pypi/zope.testrecorder>`_ | `Bugs <http://bugs.launchpad.net/zope.testrecorder>`_
-zope.traversing Resolving paths in the object hierarchy `Subversion <http://svn.zope.org/zope.traversing>`_ | `PyPI <http://pypi.python.org/pypi/zope.traversing>`_ | `Bugs <http://bugs.launchpad.net/zope.traversing>`_
-zope.viewlet Zope Viewlets `Subversion <http://svn.zope.org/zope.viewlet>`_ | `PyPI <http://pypi.python.org/pypi/zope.viewlet>`_ | `Bugs <http://bugs.launchpad.net/zope.viewlet>`_
-============================ ========================================================================================================= =========================================================================================================================================================================================================
-
-Under review
-~~~~~~~~~~~~
-
-The following packages are included in the ZTK but are under review for
-continued inclusion or potential deprecation.
-
-============================ ========================================================================================================= =========================================================================================================================================================================================================
-Name Description Links
-============================ ========================================================================================================= =========================================================================================================================================================================================================
-zope.app.apidoc API Documentation and Component Inspection for Zope 3 `Subversion <http://svn.zope.org/zope.app.apidoc>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.apidoc>`_ | `Bugs <http://bugs.launchpad.net/zope.app.apidoc>`_
-zope.app.applicationcontrol Zope applicationcontrol `Subversion <http://svn.zope.org/zope.app.applicationcontrol>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.applicationcontrol>`_ | `Bugs <http://bugs.launchpad.net/zope.app.applicationcontrol>`_
-zope.app.appsetup Zope app setup helper `Subversion <http://svn.zope.org/zope.app.appsetup>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.appsetup>`_ | `Bugs <http://bugs.launchpad.net/zope.app.appsetup>`_
-zope.app.authentication Pluggable Authentication Utility `Subversion <http://svn.zope.org/zope.app.authentication>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.authentication>`_ | `Bugs <http://bugs.launchpad.net/zope.app.authentication>`_
-zope.app.basicskin Zope 3 ZMI Basic Skin `Subversion <http://svn.zope.org/zope.app.basicskin>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.basicskin>`_ | `Bugs <http://bugs.launchpad.net/zope.app.basicskin>`_
-zope.app.boston Boston -- A Zope 3 ZMI Skin `Subversion <http://svn.zope.org/zope.app.boston>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.boston>`_ | `Bugs <http://bugs.launchpad.net/zope.app.boston>`_
-zope.app.broken Zope Broken (ZODB) Object Support `Subversion <http://svn.zope.org/zope.app.broken>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.broken>`_ | `Bugs <http://bugs.launchpad.net/zope.app.broken>`_
-zope.app.cache Zope Caching Framework `Subversion <http://svn.zope.org/zope.app.cache>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.cache>`_ | `Bugs <http://bugs.launchpad.net/zope.app.cache>`_
-zope.app.catalog Management pages for Zope Catalog `Subversion <http://svn.zope.org/zope.app.catalog>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.catalog>`_ | `Bugs <http://bugs.launchpad.net/zope.app.catalog>`_
-zope.app.component Local Zope Component Support `Subversion <http://svn.zope.org/zope.app.component>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.component>`_ | `Bugs <http://bugs.launchpad.net/zope.app.component>`_
-zope.app.content Zope Content Type `Subversion <http://svn.zope.org/zope.app.content>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.content>`_ | `Bugs <http://bugs.launchpad.net/zope.app.content>`_
-zope.app.dav Zope WebDAV Support (Basic) `Subversion <http://svn.zope.org/zope.app.dav>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.dav>`_ | `Bugs <http://bugs.launchpad.net/zope.app.dav>`_
-zope.app.debug Zope Debug Mode `Subversion <http://svn.zope.org/zope.app.debug>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.debug>`_ | `Bugs <http://bugs.launchpad.net/zope.app.debug>`_
-zope.app.debugskin Debug -- A Zope 3 ZMI Skin `Subversion <http://svn.zope.org/zope.app.debugskin>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.debugskin>`_ | `Bugs <http://bugs.launchpad.net/zope.app.debugskin>`_
-zope.app.dependable Simple Dependency API `Subversion <http://svn.zope.org/zope.app.dependable>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.dependable>`_ | `Bugs <http://bugs.launchpad.net/zope.app.dependable>`_
-zope.app.dtmlpage DTML Page -- A Zope 3 Content Component `Subversion <http://svn.zope.org/zope.app.dtmlpage>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.dtmlpage>`_ | `Bugs <http://bugs.launchpad.net/zope.app.dtmlpage>`_
-zope.app.error Error reporting utility management UI for Zope3 `Subversion <http://svn.zope.org/zope.app.error>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.error>`_ | `Bugs <http://bugs.launchpad.net/zope.app.error>`_
-zope.app.exception Zope 3 exception views `Subversion <http://svn.zope.org/zope.app.exception>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.exception>`_ | `Bugs <http://bugs.launchpad.net/zope.app.exception>`_
-zope.app.externaleditor Editing Zope 3 Content with an External Editor `Subversion <http://svn.zope.org/zope.app.externaleditor>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.externaleditor>`_ | `Bugs <http://bugs.launchpad.net/zope.app.externaleditor>`_
-zope.app.file File and Image -- Zope 3 Content Components `Subversion <http://svn.zope.org/zope.app.file>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.file>`_ | `Bugs <http://bugs.launchpad.net/zope.app.file>`_
-zope.app.form The Original Zope 3 Form Framework `Subversion <http://svn.zope.org/zope.app.form>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.form>`_ | `Bugs <http://bugs.launchpad.net/zope.app.form>`_
-zope.app.ftp Zope FTP Support `Subversion <http://svn.zope.org/zope.app.ftp>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.ftp>`_ | `Bugs <http://bugs.launchpad.net/zope.app.ftp>`_
-zope.app.generations Zope Application Schema Generations `Subversion <http://svn.zope.org/zope.app.generations>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.generations>`_ | `Bugs <http://bugs.launchpad.net/zope.app.generations>`_
-zope.app.homefolder User Home Folders for Zope 3 Applications `Subversion <http://svn.zope.org/zope.app.homefolder>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.homefolder>`_ | `Bugs <http://bugs.launchpad.net/zope.app.homefolder>`_
-zope.app.http HTTP Behavior for the Zope Publisher `Subversion <http://svn.zope.org/zope.app.http>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.http>`_ | `Bugs <http://bugs.launchpad.net/zope.app.http>`_
-zope.app.i18n Persistent translation domains and message catalogs `Subversion <http://svn.zope.org/zope.app.i18n>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.i18n>`_ | `Bugs <http://bugs.launchpad.net/zope.app.i18n>`_
-zope.app.i18nfile I18n File and Image -- Zope 3 Content Components `Subversion <http://svn.zope.org/zope.app.i18nfile>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.i18nfile>`_ | `Bugs <http://bugs.launchpad.net/zope.app.i18nfile>`_
-zope.app.interpreter Safe Python Intrepeter Integration into Zope 3 `Subversion <http://svn.zope.org/zope.app.interpreter>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.interpreter>`_ | `Bugs <http://bugs.launchpad.net/zope.app.interpreter>`_
-zope.app.locales Zope locale extraction and management utilities `Subversion <http://svn.zope.org/zope.app.locales>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.locales>`_ | `Bugs <http://bugs.launchpad.net/zope.app.locales>`_
-zope.app.locking Simple Object Locking Framework for Zope 3 applications `Subversion <http://svn.zope.org/zope.app.locking>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.locking>`_ | `Bugs <http://bugs.launchpad.net/zope.app.locking>`_
-zope.app.onlinehelp Framework for Context-Sensitive Help Pages `Subversion <http://svn.zope.org/zope.app.onlinehelp>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.onlinehelp>`_ | `Bugs <http://bugs.launchpad.net/zope.app.onlinehelp>`_
-zope.app.pagetemplate PageTemplate integration for Zope 3 `Subversion <http://svn.zope.org/zope.app.pagetemplate>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.pagetemplate>`_ | `Bugs <http://bugs.launchpad.net/zope.app.pagetemplate>`_
-zope.app.preference User Preferences Framework `Subversion <http://svn.zope.org/zope.app.preference>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.preference>`_ | `Bugs <http://bugs.launchpad.net/zope.app.preference>`_
-zope.app.preview Object Preview Template `Subversion <http://svn.zope.org/zope.app.preview>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.preview>`_ | `Bugs <http://bugs.launchpad.net/zope.app.preview>`_
-zope.app.principalannotation Bootstrap subscriber and browser menu item for zope.principalannotation `Subversion <http://svn.zope.org/zope.app.principalannotation>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.principalannotation>`_ | `Bugs <http://bugs.launchpad.net/zope.app.principalannotation>`_
-zope.app.publication Zope publication `Subversion <http://svn.zope.org/zope.app.publication>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.publication>`_ | `Bugs <http://bugs.launchpad.net/zope.app.publication>`_
-zope.app.publisher Implementations and means for configuration of Zope 3-style views and resources. `Subversion <http://svn.zope.org/zope.app.publisher>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.publisher>`_ | `Bugs <http://bugs.launchpad.net/zope.app.publisher>`_
-zope.app.pythonpage Python Page -- Zope 3 Content Components `Subversion <http://svn.zope.org/zope.app.pythonpage>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.pythonpage>`_ | `Bugs <http://bugs.launchpad.net/zope.app.pythonpage>`_
-zope.app.renderer Text Renderer Framework `Subversion <http://svn.zope.org/zope.app.renderer>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.renderer>`_ | `Bugs <http://bugs.launchpad.net/zope.app.renderer>`_
-zope.app.rotterdam Rotterdam -- A Zope 3 ZMI Skin `Subversion <http://svn.zope.org/zope.app.rotterdam>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.rotterdam>`_ | `Bugs <http://bugs.launchpad.net/zope.app.rotterdam>`_
-zope.app.schema Component Architecture based Vocabulary Registry `Subversion <http://svn.zope.org/zope.app.schema>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.schema>`_ | `Bugs <http://bugs.launchpad.net/zope.app.schema>`_
-zope.app.security ZMI Views For Zope3 Security Components `Subversion <http://svn.zope.org/zope.app.security>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.security>`_ | `Bugs <http://bugs.launchpad.net/zope.app.security>`_
-zope.app.securitypolicy Zope's Default Security Policy ZMI Support `Subversion <http://svn.zope.org/zope.app.securitypolicy>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.securitypolicy>`_ | `Bugs <http://bugs.launchpad.net/zope.app.securitypolicy>`_
-zope.app.server ZServer integration for Zope 3 Applications `Subversion <http://svn.zope.org/zope.app.server>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.server>`_ | `Bugs <http://bugs.launchpad.net/zope.app.server>`_
-zope.app.sqlscript SQL Script -- Zope 3 Content Component `Subversion <http://svn.zope.org/zope.app.sqlscript>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.sqlscript>`_ | `Bugs <http://bugs.launchpad.net/zope.app.sqlscript>`_
-zope.app.testing Zope Application Testing Support `Subversion <http://svn.zope.org/zope.app.testing>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.testing>`_ | `Bugs <http://bugs.launchpad.net/zope.app.testing>`_
-zope.app.tree Static Tree Implementation `Subversion <http://svn.zope.org/zope.app.tree>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.tree>`_ | `Bugs <http://bugs.launchpad.net/zope.app.tree>`_
-zope.app.twisted Twisted Integration for Zope 3 Applications `Subversion <http://svn.zope.org/zope.app.twisted>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.twisted>`_ | `Bugs <http://bugs.launchpad.net/zope.app.twisted>`_
-zope.app.undo Transaction Undo API and UI `Subversion <http://svn.zope.org/zope.app.undo>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.undo>`_ | `Bugs <http://bugs.launchpad.net/zope.app.undo>`_
-zope.app.wsgi WSGI application for the zope.publisher `Subversion <http://svn.zope.org/zope.app.wsgi>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.wsgi>`_ | `Bugs <http://bugs.launchpad.net/zope.app.wsgi>`_
-zope.app.xmlrpcintrospection XML-RPC Method Introspection Support for Zope 3 `Subversion <http://svn.zope.org/zope.app.xmlrpcintrospection>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.xmlrpcintrospection>`_ | `Bugs <http://bugs.launchpad.net/zope.app.xmlrpcintrospection>`_
-zope.app.zcmlfiles Zope application server ZCML files `Subversion <http://svn.zope.org/zope.app.zcmlfiles>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.zcmlfiles>`_ | `Bugs <http://bugs.launchpad.net/zope.app.zcmlfiles>`_
-zope.app.zopeappgenerations Zope Application ZODB Update Generations `Subversion <http://svn.zope.org/zope.app.zopeappgenerations>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.zopeappgenerations>`_ | `Bugs <http://bugs.launchpad.net/zope.app.zopeappgenerations>`_
-zope.app.zptpage ZPT page content component `Subversion <http://svn.zope.org/zope.app.zptpage>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.zptpage>`_ | `Bugs <http://bugs.launchpad.net/zope.app.zptpage>`_
-============================ ========================================================================================================= =========================================================================================================================================================================================================
-
-Deprecated
-~~~~~~~~~~
-
-The following packages used to belong to the ZTK but have been deprecated.
-
-============================ ========================================================================================================= =========================================================================================================================================================================================================
-Name Description Links
-============================ ========================================================================================================= =========================================================================================================================================================================================================
-zodbcode           Allows Python code to live in the ZODB                                   `Subversion <http://svn.zope.org/zodbcode>`_ | `PyPI <http://pypi.python.org/pypi/zodbcode>`_ | `Bugs <http://bugs.launchpad.net/zodbcode>`_
-zope.app.annotation Zope Annotations `Subversion <http://svn.zope.org/zope.app.annotation>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.annotation>`_ | `Bugs <http://bugs.launchpad.net/zope.app.annotation>`_
-zope.app.container Zope Container `Subversion <http://svn.zope.org/zope.app.container>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.container>`_ | `Bugs <http://bugs.launchpad.net/zope.app.container>`_
-zope.app.folder Folder and Site -- Zope 3 Content Components `Subversion <http://svn.zope.org/zope.app.folder>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.folder>`_ | `Bugs <http://bugs.launchpad.net/zope.app.folder>`_
-zope.app.interface Zope Interface Extensions `Subversion <http://svn.zope.org/zope.app.interface>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.interface>`_ | `Bugs <http://bugs.launchpad.net/zope.app.interface>`_
-zope.app.intid ZMI views for Integer Id Utility `Subversion <http://svn.zope.org/zope.app.intid>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.intid>`_ | `Bugs <http://bugs.launchpad.net/zope.app.intid>`_
-zope.app.keyreference Object key references `Subversion <http://svn.zope.org/zope.app.keyreference>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.keyreference>`_ | `Bugs <http://bugs.launchpad.net/zope.app.keyreference>`_
-zope.app.layers Zope 3 Layer Container Package `Subversion <http://svn.zope.org/zope.app.layers>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.layers>`_ | `Bugs <http://bugs.launchpad.net/zope.app.layers>`_
-zope.app.module Zope 3 persistent code/module support `Subversion <http://svn.zope.org/zope.app.module>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.module>`_ | `Bugs <http://bugs.launchpad.net/zope.app.module>`_
-zope.app.pluggableauth Pluggable Authenticatin Mechanism (Obselete) `Subversion <http://svn.zope.org/zope.app.pluggableauth>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.pluggableauth>`_ | `Bugs <http://bugs.launchpad.net/zope.app.pluggableauth>`_
-zope.app.session Zope session `Subversion <http://svn.zope.org/zope.app.session>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.session>`_ | `Bugs <http://bugs.launchpad.net/zope.app.session>`_
-zope.app.skins Zope 3 Skin Container Package `Subversion <http://svn.zope.org/zope.app.skins>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.skins>`_ | `Bugs <http://bugs.launchpad.net/zope.app.skins>`_
-zope.app.traversing Zope Application Traversal Support (Deprectated) `Subversion <http://svn.zope.org/zope.app.traversing>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.traversing>`_ | `Bugs <http://bugs.launchpad.net/zope.app.traversing>`_
-zope.app.workflow Workflow Engine for Zope 3 `Subversion <http://svn.zope.org/zope.app.workflow>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.workflow>`_ | `Bugs <http://bugs.launchpad.net/zope.app.workflow>`_
-zope.app.zapi Zope application programming interface `Subversion <http://svn.zope.org/zope.app.zapi>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.zapi>`_ | `Bugs <http://bugs.launchpad.net/zope.app.zapi>`_
-zope.decorator Zope Decorators `Subversion <http://svn.zope.org/zope.decorator>`_ | `PyPI <http://pypi.python.org/pypi/zope.decorator>`_ | `Bugs <http://bugs.launchpad.net/zope.decorator>`_
-zope.modulealias Zope modulealias `Subversion <http://svn.zope.org/zope.modulealias>`_ | `PyPI <http://pypi.python.org/pypi/zope.modulealias>`_ | `Bugs <http://bugs.launchpad.net/zope.modulealias>`_
-zope.thread Zope3 Thread-Local Storage `Subversion <http://svn.zope.org/zope.thread>`_ | `PyPI <http://pypi.python.org/pypi/zope.thread>`_ | `Bugs <http://bugs.launchpad.net/zope.thread>`_
-zope.ucol Python access to ICU text collation `Subversion <http://svn.zope.org/zope.ucol>`_ | `PyPI <http://pypi.python.org/pypi/zope.ucol>`_ | `Bugs <http://bugs.launchpad.net/zope.ucol>`_
-zope.xmlpickle XML-based Pickling `Subversion <http://svn.zope.org/zope.xmlpickle>`_ | `PyPI <http://pypi.python.org/pypi/zope.xmlpickle>`_ | `Bugs <http://bugs.launchpad.net/zope.xmlpickle>`_
-zope.wfmc Workflow-Management Coalition Workflow Engine `Subversion <http://svn.zope.org/zope.wfmc>`_ | `PyPI <http://pypi.python.org/pypi/zope.wfmc>`_ | `Bugs <http://bugs.launchpad.net/zope.wfmc>`_
-zope.app.wfmc Zope Application integration for ``zope.wfmc`` `Subversion <http://svn.zope.org/zope.app.wfmc>`_ | `PyPI <http://pypi.python.org/pypi/zope.app.wfmc>`_ | `Bugs <http://bugs.launchpad.net/zope.app.wfmc>`_
-============================ ========================================================================================================= =========================================================================================================================================================================================================
Modified: zopetoolkit/doc/source/index.rst
===================================================================
--- zopetoolkit/doc/source/index.rst 2009-09-14 16:17:48 UTC (rev 103962)
+++ zopetoolkit/doc/source/index.rst 2009-09-14 16:18:27 UTC (rev 103963)
@@ -31,7 +31,7 @@
:maxdepth: 2
about/index
+ releases/index
process/index
codingstyle/index
- migration/index
steeringgroup/index
Property changes on: zopetoolkit/doc/source/releases
___________________________________________________________________
Added: svn:ignore
+ index.rst
packages-*.rst
overview-*.rst
Added: svn:mergeinfo
+
Deleted: zopetoolkit/doc/source/releases/34to35.rst
===================================================================
--- zopetoolkit/doc/source/migration/34to35.rst 2009-09-14 12:04:25 UTC (rev 103915)
+++ zopetoolkit/doc/source/releases/34to35.rst 2009-09-14 16:18:27 UTC (rev 103963)
@@ -1,253 +0,0 @@
-Migrating from Zope 3.4 to Zope Toolkit 1.0
-===========================================
-
-Note: this document is out of date. The idea is now to consult the
-CHANGES.txt of the individual releases.
-
-This document covers major changes from the Zope 3.4 release to the
-Zope Toolkit 1.0 release that can lead to backward-incompatibilities.
-
-.. contents::
-
-Introduction
-------------
-
-The Zope Toolkit 1.0 release is the first release of the Zope
-Toolkit. The Zope Toolkit really is just a collection of libraries
-managed together by the Zope developers. We typically treat each
-library independently, so you would like to look at the CHANGES.txt in
-each library for updates. Here we note larger changes, especially ones
-that affect multiple libraries.
-
-The Zope Toolkit cannot be installed directly except as individual
-libraries (such as ``zope.component``). To install it you typically
-would install a toolkit or application that makes use of these
-libraries. The Zope project itself manages Zope 3, Zope 2, or Grok.
-
-The 1.0 release of the Zope Toolkit contains a number of
-refactorings that are aimed to clean up dependencies between pieces of
-code. Many packages in ``zope.app`` have had their code moved to
-existing or newly created packages in the ``zope`` namespace. These
-new packages do generally not contain user interface code (typically
-what's in ``.browser``), and have much clearer dependency
-relationships as a result.
-
-Backwards compatibility imports have been left in place so that your
-existing code should still work. In some cases you will have to
-explicitly add dependencies to a ``zope.app.`` to your code, as due to
-the cleanup they might not come in automatically anymore due to
-indirect dependencies; if you see an import error this is probably the
-case.
-
-We recommend you update your existing code to import from the new
-packages if possible. We list major changes below. We are also working
-on an extension to the Zope testrunner that can indicate indirect
-imports, as well as a tool to upgrade existing ZODBs to make use of
-new import locations.
-
-zope.app.keyreference -> zope.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. Still review your code for any imports coming
-from ``zope.app.keyreference`` and modify it to use
-``zope.keyreference`` instead.
-
-zope.app.intid -> zope.intid
------------------------------
-
-The non-UI functionality of these packages was moved to ``zope.intid``
-with backwards compatibility imports left in place. Review your
-imports from ``zope.app.intid`` to see whether they cannot come
-directly from ``zope.intid`` instead.
-
-zope.app.catalog -> zope.catalog
---------------------------------
-
-The non-UI functionality of these packages was moved to
-``zope.catalog``. Review your imports from ``zope.app.catalog`` to see
-whether they cannot come directly from ``zope.catalog`` instead.
-
-zope.app.container -> zope.container
-------------------------------------
-
-The non-UI functionality of these packages was moved to
-``zope.container``. Review your imports from ``zope.app.container`` to
-see whether they cannot come directly from ``zope.container`` instead.
-
-In addition, the exceptions used by ``zope.container`` were changed,
-so if your code catches them, you need to review it:
-
-* The ``DuplicationError`` in ``setitem`` was changed to ``KeyError``.
-
-* The ``UserError`` in ``NameChooser`` was changed to ``ValueError``.
-
-zope.app.component -> zope.security, zope.site
-----------------------------------------------
-
-The implementation of the ``<class>`` ZCML directive moved from this
-package to ``zope.security``. Packages that relied on
-``zope.app.component`` to obtain this directive should declare a
-direct dependency on ``zope.security``, and it may be possible to lose
-the dependency on ``zope.app.component`` altogether.
-
-Non-UI site related functionality has been moved to the ``zope.site``
-package. with backwards compatibility imports left in place. Review
-your imports from ``zope.app.component`` to see whether they cannot
-come directly from ``zope.site`` instead.
-
-zope.app.folder -> zope.site, zope.container
---------------------------------------------
-
-The implementation of the ``zope.app.folder.Folder`` class has moved
-to ``zope.site.folder`` instead, with backwards compatibility imports
-left in place. Review your imports from ``zope.app.folder`` to see
-whether they cannot come directly from ``zope.site`` instead. In
-addition, ``Folder`` is an ``IContainer`` implementation that also
-mixes in site management functionality. If such site management
-support is not necessary, in some cases your code does not need
-``Folder`` but may be able to rely on a ``Container`` implementation
-from ``zope.container`` instead.
-
-A base class with the implementation of the container-like behavior of
-``Folder`` has moved to ``zope.container`` (and ``zope.site`` uses
-this for its implementation of ``Folder``). This is not normally
-something you should need to retain backwards compatibility.
-
-zc.copy -> zope.copy, zope.copypastemove, zope.location
--------------------------------------------------------
-
-The pluggable object copying mechanism once developed in the ``zc.copy``
-package was merged back into ``zope.location``, ``zope.copypastemove``
-and the new ``zope.copy`` package. The ``zope.copy`` package now provides
-a pluggable mechanism for copying objects from ``zc.copy`` and doesn't
-depend on anything but ``zope.interface``. The ``zope.copypastemove``
-uses the ``copy`` function from ``zope.copy`` in its ``ObjectCopier``.
-
-The ``zope.location`` now provides an ``ICopyHook`` adapter that implements
-conditional copy functionality based on object locations, that old
-``zope.location.pickling.CopyPersistent`` used to provide. Note, that if
-you don't use ZCML configuration of ``zope.location``, you may need to
-register ``zope.location.pickling.LocationCopyHook`` yourself.
-
-The ``zope.location.pickling.locationCopy`` and
-``zope.location.pickling.CopyPersistent`` are now deprecated in favor
-of ``zope.copy`` and were replaced by deprecated imports. See
-``zope.copy`` package documentation for information on how to use the
-new mechanism.
-
-The new version of the ``zc.copy`` package now only contains
-backward-compatibility imports and is deprecated. ``zope.copy`` should
-be preferred for new developments.
-
-zope.app.security refactoring
------------------------------
-
-The ``zope.app.security`` package was finally refactored into a few small parts
-with less dependencies and more clear purpose.
-
-The implementation of the ``<module>`` ZCML directive moved from this
-package to ``zope.security``. Packages that relied on
-``zope.app.security`` to obtain this directive should declare a direct
-dependency on ``zope.security``, and it may be possible to lose the
-dependency on ``zope.app.security`` altogether.
-
-The ``protectclass`` module in this package has moved to
-``zope.security``, with backwards compatibility imports left in
-place. Review your imports from ``zope.app.security`` to see whether
-they cannot come directly from ``zope.security`` instead.
-
-All interfaces (`IAuthentication`, `IUnauthenticatedPrincipal`, `ILoginPassword`
-and so on.) were moved into a new ``zope.authentication`` package, as well as
-several utility things, like `PrincipalSource` and `checkPrincipal` function.
-The new package has much less dependencies and defines an abstract contracts for
-implementing authentication within Zope Framewowk. While backward compatibility
-imports are left in place, it's strongly reccommended to update your imports to
-the ``zope.authentication``.
-
-The `global principal registry` and its ZCML directives are moved into a new
-``zope.principalregistry`` package with backward-compatibility imports left in
-place. If your application uses global principals, review your code and ZCML
-configuration to update it to the new place.
-
-The `local permission` functionality was moved into a new ``zope.app.localpermission``
-package. This functionality is a part of Through-The-Web development pattern that
-seems not to be used and supported much by Zope Toolkit and Application anymore,
-so it can be considered deprecated. However, it can serve as a great example of
-TTW-related component.
-
-The `Permission vocabularies` and standard protections for Message objects and
-`__name__`, `__parent__` attributes as well as some common permissions, like `zope.View`
-and `zope.ManageContent` were merged into `zope.security`.
-
-The adapters from ``zope.publisher``'s `IHTTPCredentials` and `IFTPCredentials`
-to the `ILoginPassword` were moved into ``zope.publisher``, thus making
-``zope.authentication`` a dependency for ``zope.publisher``.
-
-The original ``zope.app.security`` package now only contains several deprecated
-or application-specific permission definitions, python module protections, that
-are only likely to be needed with deprecated Through-The-Web development pattern,
-and ZMI-related browser views (login.html, zope.app.form view for PrincipalSource
-and so on), as well as backward-compatibility imports. So, if you're not using
-TTW and/or standard ZMI browser views, you probably should review update your
-imports to a new places and drop dependency on ``zope.app.security`` to reduce
-package dependencies count.
-
-Other packages, that used ``zope.app.security``, like ``zope.securitypolicy`` are
-either already adapted to the changes or will be adapted soon.
-
-Password managers extracted from zope.app.authentication
---------------------------------------------------------
-
-The `IPasswordManager` interface and its implementations were extracted from
-``zope.app.authentication`` into a new ``zope.password`` package to make them
-usable with other authentication systems, like ``z3c.authenticator`` or
-``zope.principalregistry`` or any custom one.
-
-It basically depends only on ``zope.interface``, so it can be really useful even
-in non-Zope environments, like ``Pylons``, for example.
-
-The `Password Manager Names` vocabulary is also moved into ``zope.password``,
-however, it's only useful with ``zope.schema`` and ``zope.component``, so you
-need them installed to work with them. They're listed in the "vocabulary" extra
-requirement specification.
-
-ZODB 3.9 FileStorage native blob support
-----------------------------------------
-
-The FileStorage component of ZODB 3.9 used in Zope Toolkit 1.0 now
-supports blobs natively, so you don't need to use BlobStorage proxy
-for it anymore.
-
-Thus, you can specify blob directory directly to FileStorage. If you
-use ZConfig, that means something like this::
-
- <filestorage>
- path var/Data.fs
- blob-dir var/blobs
- </filestorage>
-
-instead of::
-
- <blobstorage>
- blob-dir var/blobs
- <filestorage>
- path var/Data.fs
- </filestorage>
- </blobstorage>
-
-If you creating a storage from python, that means something like this:
-
-.. code-block:: python
-
- storage = FileStorage('var/Data.fs', blob_dir='var/blobs')
-
-instead of:
-
-.. code-block:: python
-
- storage = BlobStorage('var/blobs', FileStorage('var/Data.fs'))
-
Deleted: zopetoolkit/doc/source/releases/index.rst
===================================================================
--- zopetoolkit/doc/source/migration/index.rst 2009-09-14 12:04:25 UTC (rev 103915)
+++ zopetoolkit/doc/source/releases/index.rst 2009-09-14 16:18:27 UTC (rev 103963)
@@ -1,10 +0,0 @@
-Migration to newer Zope Toolkit versions
-========================================
-
-This area collects information about the backward-incompatible changes and
-new techniques developed and proposed within new Zope Toolkit releases.
-
-.. toctree::
- :maxdepth: 1
-
- 34to35
Modified: zopetoolkit/trunk/index.rst
===================================================================
--- zopetoolkit/trunk/index.rst 2009-09-14 16:17:48 UTC (rev 103962)
+++ zopetoolkit/trunk/index.rst 2009-09-14 16:18:27 UTC (rev 103963)
@@ -2,18 +2,7 @@
It is intended for automatic inclusion by the ZTK sphinx-based
documentation.
-Zope Toolkit 1.0
-================
-.. XXX
-Note: this document is out of date. The idea is now to consult the
-CHANGES.txt of the individual releases.
-
-This document covers major changes from the Zope 3.4 release to the
-Zope Toolkit 1.0 release that can lead to backward-incompatibilities.
-
-.. contents::
-
Introduction
------------
More information about the checkins
mailing list