[Zope3-checkins] SVN: Zope3/trunk/doc/CHANGES.txt I started ReStifying the Changes.

Stephan Richter srichter at cosmos.phy.tufts.edu
Fri Apr 22 11:07:31 EDT 2005


Log message for revision 30106:
  I started ReStifying the Changes.
  

Changed:
  U   Zope3/trunk/doc/CHANGES.txt

-=-
Modified: Zope3/trunk/doc/CHANGES.txt
===================================================================
--- Zope3/trunk/doc/CHANGES.txt	2005-04-22 15:01:46 UTC (rev 30105)
+++ Zope3/trunk/doc/CHANGES.txt	2005-04-22 15:07:30 UTC (rev 30106)
@@ -75,30 +75,31 @@
         Added a layer argument to the menu directives and made sure that all
         browser directives specify the layer for the menu directives.
 
-      - Implemented issue 292: Add factory to browser:resource directive
+      - Implemented issue 292: Add factory to ``browser:resource`` directive
 
-      - Implemented issue 309: <schemadisplay> should support <widget>
+      - Implemented issue 309: ``<schemadisplay>`` should support ``<widget>``
 
-      - Developed a generic browser:form directive. It is pretty much the same
-        as the browser:editform directive, except that the data is not stored
-        on some context or adapted context but sent as a dictionary to special
-        method (by default). By default these methods are named `getData()` and
-        `setData(data)`.
+      - Developed a generic ``browser:form`` directive. It is pretty much the
+        same as the ``browser:editform`` directive, except that the data is
+        not stored on some context or adapted context but sent as a dictionary
+        to special method (by default). By default these methods are named
+        ``getData()`` and ``setData(data)``.
 
       - When raising the Unauthorized exception, the security checker
         now passes the object in question in addition to the attribute
-        name and missing permission.  This should make debugging easier.
+        name and missing permission. This should make debugging easier.
 
       - You can declare "features" provided by your package with the new
-        <meta:provides feature="name" /> ZCML directive.  The presence of these
-        features can be tested with the new zcml:condition attribute.
+        ``<meta:provides feature="name" />`` ZCML directive. The presence of
+        these features can be tested with the new ``zcml:condition``
+        attribute.
 
       - ZCML supports conditional directives using the zcml:condition
         attribute. The value of the attribute is an expression of the
         form "verb arguments". The following verbs are recognized:
 
         * `have` -- It takes a single name of a feature as an
-          argument. Features can be registed via the 'zcml:feature' directive.
+          argument.
 
         * `installed` -- It's argument is a single package name. If the
           package is importable, return true.
@@ -114,9 +115,9 @@
         * A new `bookmodule` compiles all our README.txt and other text
           documentation files to a nice book-like format.
 
-        * A new `typemodule` lists all interface types (such as
-          `IContentType`) and then let's you see all interfaces providing this
-          type (for example `IFile`)
+        * A new ``typemodule`` lists all interface types (such as
+          ``IContentType``) and then let's you see all interfaces providing
+          this type (for example ``IFile``)
 
         * Views are now shown in the Interface details screen.
 
@@ -130,16 +131,16 @@
           want to see by default in the interface details screen.
 
       - Zope 3 can now listen on specified network interfaces only.  Example
-        of a server section in zope.conf:
+        of a server section in `zope.conf`::
 
             <server>
               type HTTP
               address 127.0.0.1:8080
             </server>
 
-      - Improvements to zope.i18n.format.
+      - Improvements to ``zope.i18n.format``.
 
-        * Support for parsing and formatting timezones based on pytz.
+        * Support for parsing and formatting timezones based on ``pytz``.
 
         * Reinterpretation of of ICU documentation, revealed that any number
           of formatting fields should be accepted by the formatter and parser.
@@ -147,8 +148,8 @@
         * Implemented formatting of several missing formatting fields. Now all
           fields are correctly implemented.
 
-      - Added pytz to the repository. Stuart Bishop licensed it for us under
-        ZPL 2.1. Thanks!
+      - Added ``pytz`` to the repository. Stuart Bishop licensed it for us
+        under ZPL 2.1. Thanks!
 
       - New schema field: Timedelta.
 
@@ -174,13 +175,13 @@
 
       - It is no longer necessary to supply a for attribute in adapter
         directives if the factory declares the interfaces or classes that it
-        adapts using zope.component.adapts.
+        adapts using ``zope.component.adapts``.
 
       - It is no longer necessary to specify a provides attribute in
         an adapter or utility directive if the factory/component
         implements/provides a single interface.
 
-      - Added `zope.security.canAccess` and `zope.security.canWrite`
+      - Added ``zope.security.canAccess`` and ``zope.security.canWrite``
         convenience methods.  Often code wants to check if a certain option is
         open to a user before presenting it.  If the code relies on a certain
         permission, the Zope 3 goal of keeping knowledge of security
@@ -191,8 +192,8 @@
 
       - Added lazy properties. (See zope/cachedescriptors/README.txt)
 
-      - Added new `getNextUtility()`, `queryNextUtility()`, and
-        `testingNextUtility()` functions to make it easier to find and test
+      - Added new ``getNextUtility()``, ``queryNextUtility()``, and
+        ``testingNextUtility()`` functions to make it easier to find and test
         for utilities in higher-up sites. These mimic their service-based
         equivalents.
 
@@ -315,11 +316,12 @@
       - Schemas are now copied before they are appended to content type or
         instance. This should probably become a policy later.
 
-      - Implemented ICacheable view's current_cache_url() method, so that a
-        link to the cache utility can be provided.
+      - Implemented ``ICacheable`` view's ``current_cache_url()`` method, so
+        that a link to the cache utility can be provided.
 
-      - Added ++debug++ traversal adapter that allows you to turn on debugging
-        flags in request.debug.  Currently the following flags are defined:
+      - Added '++debug++' traversal adapter that allows you to turn on
+        debugging flags in request.debug.  Currently the following flags are
+        defined:
 
         + "source" adds HTML comments to rendered page templates showing
            where each code snippet came from.
@@ -332,17 +334,18 @@
         Try e.g. http://localhost:8080/++debug++source,tal/@@contents.html
         and view the source of the resulting page.
 
-      - Added 'url' adapter for IPathAdapter. It provides quoting mechanisms
-        to strings (and string-like objects) from within ZPT, e.g:
+      - Added 'url' adapter for ``IPathAdapter``. It provides quoting
+        mechanisms to strings (and string-like objects) from within ZPT, e.g::
 
         tal:attributes="href string:login.html?nextURL=${request/URL/url:quote}
 
-        Other functions available are quote_plus, unquote, unquote_plus.
+        Other functions available are ``quote_plus``, ``unquote``,
+        ``unquote_plus``.
 
       - Added basic cataloging functionality.
 
-      - Added functions (zope.app.container.constraints.contains and
-        zope.app.container.constraints.containers) that greatly simplify
+      - Added functions (``zope.app.container.constraints.contains`` and
+        ``zope.app.container.constraints.containers``) that greatly simplify
         expressing containment constraints.
 
       - Added a view 'failsafelogin.html' that always uses HTTP basic auth
@@ -361,7 +364,7 @@
 
       - Applied changes suggested in issue 339: Improvements to generated forms
 
-      - Deprecated `zope.app.introspector`. You should use the public apidoc
+      - Deprecated ``zope.app.introspector``. You should use the public apidoc
         utilities isntead. A new "Introspector" tab was implemented that
         redirects you to the correct code browser documentation screen.
 
@@ -372,16 +375,17 @@
 
       - Addressed issue 295: Sort out defaultView.
 
-        Deprecated `zope:defaultView` directive and removed unused default
-        view handler in `zope.app.publisher.browser.viewmeta`. Added a `layer`
-        attribute to the `browser:defaultView` directive.
+        Deprecated ``zope:defaultView`` directive and removed unused default
+        view handler in ``zope.app.publisher.browser.viewmeta``. Added a
+        ``layer`` attribute to the `browser:defaultView` directive.
 
-      - zope.component.createObject no longer accepts a positional
+      - ``zope.component.createObject`` no longer accepts a positional
         context argument.  A context can be provided as a keyword argument.
 
-      - Deprecated _configureCopy in zope.app.copypastemove.ObjectCopier. To
-        configure a recently copied object, suscribe to IObjectCopiedEvent for
-        the type of object you're interested in configuring.
+      - Deprecated ``_configureCopy`` in
+        ``zope.app.copypastemove.ObjectCopier``. To configure a recently
+        copied object, suscribe to IObjectCopiedEvent for the type of object
+        you're interested in configuring.
 
       - Several changes have been made to the API doc tool:
 
@@ -397,21 +401,21 @@
 
         + Converted most tests to text files.
 
-        + Moved code from `__init__.py` files to modules.
+        + Moved code from ``__init__.py`` files to modules.
 
-        + Removed `viewmodule`, since its functionality has been merged into
+        + Removed ``viewmodule``, since its functionality has been merged into
           the interface details view.
 
       - Changed the test-counting mechanism for doctests.  Now a
         doctest count a test for every example that is preceeded by
         prose. (Although a doctest will never count less than 1 test.)
 
-      - Moved reusable test setups/APIs from `zope.app.tests` to
-        `zope.app.testing`. No reusable testing code should be in a `tests`
+      - Moved reusable test setups/APIs from ``zope.app.tests`` to
+        ``zope.app.testing``. No reusable testing code should be in a ``tests``
         package or module.
 
       - Removal of Services. You can now access the adapter and utiliy
-        registry directly via the site manager's `adapters` and `utilities`
+        registry directly via the site manager's ``adapters`` and ``utilities``
         attribute, respecitvely.
 
         + Converted Error Reporting Service to a utility. Added database



More information about the Zope3-Checkins mailing list