[Checkins] SVN: groktoolkit/trunk/doc/ only generate the package list for the current release

Jan-Wijbrand Kolman janwijbrand at gmail.com
Mon Feb 7 11:10:08 EST 2011


Log message for revision 120184:
  only generate the package list for the current release

Changed:
  _U  groktoolkit/trunk/doc/
  U   groktoolkit/trunk/doc/docindex.template
  A   groktoolkit/trunk/doc/releases.rst
  U   groktoolkit/trunk/doc/scripts/update-releaseinfo.py

-=-

Property changes on: groktoolkit/trunk/doc
___________________________________________________________________
Added: svn:ignore
   + packages.rst


Modified: groktoolkit/trunk/doc/docindex.template
===================================================================
--- groktoolkit/trunk/doc/docindex.template	2011-02-07 15:21:16 UTC (rev 120183)
+++ groktoolkit/trunk/doc/docindex.template	2011-02-07 16:10:07 UTC (rev 120184)
@@ -24,7 +24,7 @@
         <span class="linkdescr">How to name your stuff correctly.</span></p>
 
     </td><td width="50%">
-	  <p class="biglink"><a class="biglink" href="{{ pathto("packages") }}">Grok Packages</a><br>
+	  <p class="biglink"><a class="biglink" href="{{ pathto("packages") }}">Packages</a><br>
 	    <span class="linkdescr">How to upgrade your project to a new version of Grok.</span></p>
 
 	  <p class="biglink"><a class="biglink" href="{{ pathto("upgrade") }}">Upgrade notes</a><br>
@@ -33,7 +33,7 @@
       <p class="biglink"><a class="biglink" href="{{ pathto("developing_grok") }}">Developing Grok</a><br>
         <span class="linkdescr">Notes for developers <strong>of</strong> Grok.</span></p>
 
-      <p class="biglink"><a class="biglink" href="{{ pathto("releases") }}">Grok Releases</a><br>
+      <p class="biglink"><a class="biglink" href="{{ pathto("releases") }}">Releases</a><br>
 	    <span class="linkdescr">A history of Grok releases.</span></p>
 
     </td></tr>

Added: groktoolkit/trunk/doc/releases.rst
===================================================================
--- groktoolkit/trunk/doc/releases.rst	                        (rev 0)
+++ groktoolkit/trunk/doc/releases.rst	2011-02-07 16:10:07 UTC (rev 120184)
@@ -0,0 +1,79 @@
+.. _releases:
+
+============================
+An overview of Grok releases
+============================
+
+Information about new features, changes and bug fixes for releases of Grok.
+
+`Grok 1.3.1 <http://grok.zope.org/doc/1.3.1>`_
+  Grok 1.3 is a bugfix release of Grok based on the Zope Toolkit 1.1.
+
+`Grok 1.3 <http://grok.zope.org/doc/1.3>`_
+  Grok 1.3 is a feature release of Grok based on the Zope Toolkit 1.1c1.
+
+Grok 1.2
+  Grok 1.2 is a feature release of Grok based on the Zope Toolkit 1.0,
+  zc.buildout-1.5.2. A very large number of zope.app.* dependencies have been
+  removed to have a smaller, more manageable footprint.
+
+Grok 1.1
+  Grok 1.1 is a feature release of Grok preparing for the Zope Toolkit.
+
+Grok 1.1rc1
+  Grok 1.1rc1!
+
+Grok 1.1a2
+  Grok 1.1a2!
+
+Grok 1.1a1
+  Grok 1.1a1!
+
+Grok 1.0
+  Grok 1.0!
+
+Grok 1.0b2
+  Grok 1.0 beta 2!
+
+Grok 1.0a4
+  The third step on the way to Grok 1.0!
+
+Grok 1.0a3
+  The third step on the way to Grok 1.0!
+
+Grok 1.0a2
+  The second step on the way to Grok 1.0!
+
+Grok 1.0a1
+  A feature release and a first step on the way to Grok 1.0!
+
+Grok 0.14.1
+  A security fix release for Grok 0.14.
+
+Grok 0.14
+  Feature release: spin-off of grokcore.view, grokcore.formlib and
+  grokcore.security
+
+Grok 0.13
+  Feature release: improved directives, martian, grokcore.component. many
+  other improvements and bugfixes
+
+Grok 0.12.1
+  bugfix release
+
+Grok 0.12
+  Feature release: viewlets, auto-inclusion of dependencies. Also a lot of
+  bugfixes.
+
+Grok 0.11.1
+  Maintenance release with bug fixes only
+
+Grok 0.11
+  Feature release: Layers and skinning, REST web services, pluggable template
+  languages, and improved Permissions.
+
+Grok 0.10.2
+  Maintenance release with bug fixes only
+
+Grok 0.10.1
+  Release to fix the dependency problems of the versions of installed packges.

Modified: groktoolkit/trunk/doc/scripts/update-releaseinfo.py
===================================================================
--- groktoolkit/trunk/doc/scripts/update-releaseinfo.py	2011-02-07 15:21:16 UTC (rev 120183)
+++ groktoolkit/trunk/doc/scripts/update-releaseinfo.py	2011-02-07 16:10:07 UTC (rev 120184)
@@ -88,11 +88,20 @@
     print >>output, heading
     print >>output, '=' * len(heading)
 
+    print >>output, """
+Release yadda yadda.
+"""
+
     ztk_version = '1.1'
     print >>output, 'Zope Toolkit %s' % ztk_version
     print >>output, '------------------------------'
-    print >>output, '`Overview of ZTK-%s <http://docs.zope.org/zopetoolkit/releases/overview-%s.html>`' % (ztk_version, ztk_version)
+    print >>output, """
+This Grok released is based on Zope Toolkit %s.
 
+`Overview <http://docs.zope.org/zopetoolkit/releases/overview-%s.html>`_ of the
+ZTK. List of the ZTK `packages <http://docs.zope.org/zopetoolkit/releases/packages-%s.html>`_
+""" % (ztk_version, ztk_version, ztk_version)
+
     print >>output, 'Packages'
     print >>output, '--------'
     included = packages(config, 'included')
@@ -111,50 +120,6 @@
     package_list(dependencies, config, output)
     output.close()
 
-def write_overview(releases, path):
-    print "Writing overview"
-
-    output = open(os.path.join(path, '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(path, 'overview-%s.rst' % release), 'w')
-        print >>overview, GENERATED_WARNING
-        title = "Grok %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((location/'README.txt').read())
-        overview.close()
-
 if __name__ == '__main__':
     path = os.path.abspath(os.path.join('packages.rst'))
     dist = pkg_resources.get_distribution('groktoolkit')
@@ -162,5 +127,3 @@
     if dist.precedence <= pkg_resources.DEVELOP_DIST:
         use_trunk = True
     write_package_list(path, dist.version, use_trunk=use_trunk)
-
-    #write_overview(releases, path)



More information about the checkins mailing list