[KSS-checkins] r53940 - kukit/kss.core/branch/1.4/docs

[reebalazs at codespeak.net]

Author: reebalazs
Date: Mon Apr 21 01:48:25 2008
New Revision: 53940

Modified:
   kukit/kss.core/branch/1.4/docs/NEWS.txt
Log:
Add deprecation manual to NEWS.txt

Modified: kukit/kss.core/branch/1.4/docs/NEWS.txt
==============================================================================
--- kukit/kss.core/branch/1.4/docs/NEWS.txt	(original)
+++ kukit/kss.core/branch/1.4/docs/NEWS.txt	Mon Apr 21 01:48:25 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
+