[KSS-checkins] r53941 - in kukit/kss.core/trunk: . docs

[reebalazs at codespeak.net]

Author: reebalazs
Date: Mon Apr 21 01:50:58 2008
New Revision: 53941

Added:
   kukit/kss.core/trunk/docs/INTRO.txt
      - copied unchanged from r53940, kukit/kss.core/branch/1.4/docs/INTRO.txt
Modified:
   kukit/kss.core/trunk/docs/NEWS.txt
   kukit/kss.core/trunk/setup.py
Log:
Forward port -r53937:53940 from 1.4 branch: add long_description to setuptools and fix news.

Modified: kukit/kss.core/trunk/docs/NEWS.txt
==============================================================================
--- kukit/kss.core/trunk/docs/NEWS.txt	(original)
+++ kukit/kss.core/trunk/docs/NEWS.txt	Mon Apr 21 01:50:58 2008
@@ -1,4 +1,72 @@
 
+Deprecated in kss 1.4
+---------------------
+
+form() and currentForm() in normal value providers
+""""""""""""""""""""""""""""""""""""""""""""""""""
+
+currentForm()
+'''''''''''''
+
+ 
+You must change rules that use currentForm() in a normal value provider::
+
+    action-server:                     myServerAction;
+    myServerAction-data:               currentForm();
+
+to::
+
+    action-server:                     myServerAction currentForm();
+
+Or, if you want to keep compatibility with kss 1.2::
+
+    action-server:                     myServerAction;
+    myServerAction-kssSubmitForm:      currentForm();
+
+
+form()
+''''''
+
+Similarly, for form(), you must change the following::
+
+    action-server:                     myServerAction;
+    myServerAction-data:               form();
+
+to::
+
+    action-server:                     myServerAction form();
+
+Or, if you want to keep compatibility with Plone 3.0 (kss 1.2)::
+
+    action-server:                     myServerAction;
+    myServerAction-kssSubmitForm:      form();
+
+
+Necessary server side changes
+'''''''''''''''''''''''''''''
+
+On the server side, the method that received the form as a dictionary in one
+parameter, must define the values directly in the method signature, or access
+them from the form directly.
+
+So the following old code::
+
+    def method(self, data):
+        field1 = data['field1']
+        field2 = data.get('field2', None)
+
+must be changed in one of the two ways shown in the following examples::
+
+    def method(self, field1, field2=None):
+        ...
+
+An alternate way is to get them from the request::
+
+    def method(self):
+        request = self.request 
+        field1 = request.form['field1']
+        field2 = request.form.get('field2', None)
+
 
 New in kss 1.4
 --------------
@@ -9,6 +77,8 @@
   and the core plugin, are added. All are checkable from a single click 
   from any browser.
 
+- New and improved demos
+
 - Base2 is used for css selection, instead of the original cssQuery (if 
   present). Significantly faster page load.
 
@@ -95,10 +165,14 @@
 
 - Implement loglevels based on cookies (also backported to 1.2.)
 
-- Other fixes (also backported to 1.2)::
+- Other fixes (also backported to 1.2):
 
    - Fix error fallback handling
 
    - Fix multiple selection form fields marshalling on Safari and IE
 
+   - Fix setKssAttribute action and command
+
+   - fix action-cancel
+
 

Modified: kukit/kss.core/trunk/setup.py
==============================================================================
--- kukit/kss.core/trunk/setup.py	(original)
+++ kukit/kss.core/trunk/setup.py	Mon Apr 21 01:50:58 2008
@@ -1,13 +1,27 @@
 from setuptools import setup, find_packages
-import sys, os
+import os
 
 version = '1.5'
 
+def read(*rnames):
+    return open(os.path.join(os.path.dirname(__file__), *rnames)).read()
+
+long_description = (
+        read('docs', 'INTRO.txt')
+        + '\n' +
+        'Recently changed\n'
+        '**********************\n'
+        + '\n' +
+        read('docs', 'NEWS.txt')
+        + '\n' +
+        'Download\n'
+        '**********************\n'
+        )
+
 setup(name='kss.core',
       version=version,
       description="KSS (Kinetic Style Sheets) core framework",
-      long_description="""\
-""",
+      long_description = long_description,
       # Get more strings from http://www.python.org/pypi?%3Aaction=list_classifiers
       classifiers=[
         "Framework :: Zope2",