[Zope-Checkins] CVS: Zope2 - dtml-sequence.stx:1.3

Amos Latteier amos@digicool.com
Fri, 25 May 2001 13:19:39 -0400 (EDT)


Update of /cvs-repository/Zope2/lib/python/Products/OFSP/help
In directory korak.digicool.com:/tmp/cvs-serv21864

Modified Files:
	dtml-sequence.stx 
Log Message:
Minor formatting tweaks.



--- Updated File dtml-sequence.stx in package Zope2 --
--- dtml-sequence.stx	2001/05/23 14:42:14	1.2
+++ dtml-sequence.stx	2001/05/25 17:19:38	1.3
@@ -1,34 +1,40 @@
 sequence: DTML Sequence Functions
 
-  The 'sequence' module provides sequence sorting function.
+  The 'sequence' module provides a sequence sorting function.
 
   Functions
 
-    sort(seq,(sort)) -- Sort the sequence *seq* of objects by the optional 
-    sort schema *sort*.  *sort* is a sequence of tuples (key,func,direction) 
-    that describe the sort order. 
+    sort(seq,(sort)) -- Sort the sequence *seq* of objects by the
+    optional sort schema *sort*.  *sort* is a sequence of tuples
+    '(key, func, direction)' that describe the sort order.
 
-
-      - *key* --  attribute of the object to be sorted.
+      - key -- Attribute of the object to be sorted.
  
-      - *func* -- defines the compare function (optional).  Allowed values:
-
+      - func -- Defines the compare function (optional).  Allowed values:
      
-         - "cmp" -- the standard comparison function
+         - "cmp" -- Standard Python comparison function
 
-         - "nocase" -- case-insensitive comparison
+         - "nocase" -- Case-insensitive comparison
 
-         - "strcoll" or "locale" -- locale-aware string comparison
+         - "strcoll" or "locale" -- Locale-aware string comparison
 
-         - "strcoll_nocase" or "locale_nocase" -- locale-aware 
+         - "strcoll_nocase" or "locale_nocase" -- Locale-aware 
            case-insensitive string comparison
         
-         - "xxx" -- a user-defined comparison function
+         - other -- A specified, user-defined comparison function,
+           should return 1, 0, -1.
 
-      - *direction* -- defines the sort direction for the key (optional).
+      - direction -- defines the sort direction for the key (optional).
         (allowed values: "asc", "desc") 
 
+  Examples
  
-    
+    XXX
+
+  See Also
+
+    "Python cmp function":http://www.python.org/doc/lib/built-in-funcs.html
+
+