[FE-CVS] r3178 - in FormEncode/trunk: docs formencode

[<sub...@co...>]

Author: ianb
Date: 2007-12-17 12:29:58 -0700 (Mon, 17 Dec 2007)
New Revision: 3178

Modified:
   FormEncode/trunk/docs/news.txt
   FormEncode/trunk/formencode/validators.py
Log:
Updated and categorized news for 0.9; fixed some doctests

Modified: FormEncode/trunk/docs/news.txt
===================================================================
--- FormEncode/trunk/docs/news.txt	2007-12-14 13:28:01 UTC (rev 3177)
+++ FormEncode/trunk/docs/news.txt	2007-12-17 19:29:58 UTC (rev 3178)
@@ -3,9 +3,20 @@
 
 .. contents::
 
-svn trunk
----------
+0.9
+---
 
+Backward incompatible changes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* The notion of "empty" has changed to include empty lists,
+  dictionaries, and tuples.  If you get one of these values passed
+  into (or generated by) a validator with ``not_empty=True`` you can
+  get exceptions where you didn't previously.
+
+Enhancements
+~~~~~~~~~~~~
+
 * Added support for Paste's MultiDict dictionary as input to
   Schema.to_python, by converting it to a normal dict via MultiDict.mixed.
   Previously MultiDicts wouldn't work with CompoundValidators (like
@@ -14,6 +25,22 @@
 * Added encoding parameter to htmlfill, which will handle cases when mixed
   str and unicode objects are used (turning all str objects into unicode)
 
+* Include ``formencode.validators.InternationalPhoneNumber`` from
+  W-Mark Kubacki.
+
+* ``validators.Int`` takes ``min`` and ``max`` options (from Felix
+  Schwarz).
+
+* You can control the missing message (which by default is just
+  "Missing Value") using the message ``"missing"`` in a validator
+  (also from James Gardner).
+
+* Added ``validators.CADR`` (for IP addresses with an optional range)
+  and ``validators.MACAddress`` (from Christoph Haas).
+
+Bug Fixes
+~~~~~~~~~
+
 * Be friendlier when loaded from a zip file (as with py2exe);
   previously only egg zip files would work.
 
@@ -25,11 +52,6 @@
 
 * Fix problem with looking up A records for email addresses.
 
-* Include ``formencode.validators.InternationalPhoneNumber`` from
-  W-Mark Kubacki.
-
-* Treat empty lists/tuples/dicts as "empty".
-
 * ``validators.String`` now always returns strings.  It also converts
   lists to comma-separated strings (no ``[...]``), and can encode
   unicode if an ``encoding`` parameter is given.  Empty values are
@@ -37,22 +59,12 @@
 
 * ``validators.UnicodeString`` properly handles non-Unicode inputs.
 
-* ``validators.Int`` takes ``min`` and ``max`` options (from Felix
-  Schwarz).
+* Make ``validators.DateConverter`` serialize dates properly
+  (from James Gardner).
 
-* Make ``validators.DateConverter`` serialize dates properly (from
-  James Gardner).
-
-* You can control the missing message (which by default is just
-  "Missing Value") using the message ``"missing"`` in a validator
-  (also from James Gardner).
-
 * Minor fix to setup.py to make FormEncode more friendly with
   zc.buildout.
 
-* Added ``validators.CADR`` (for IP addresses with an optional range)
-  and ``validators.MACAddress`` (from Christoph Haas).
-
 0.7.1
 -----
 

Modified: FormEncode/trunk/formencode/validators.py
===================================================================
--- FormEncode/trunk/formencode/validators.py	2007-12-14 13:28:01 UTC (rev 3177)
+++ FormEncode/trunk/formencode/validators.py	2007-12-17 19:29:58 UTC (rev 3178)
@@ -1552,7 +1552,7 @@
 
     ::
 
-        >>> p = IPhoneNumberValidator()
+        >>> p = IPhoneNumberValidator(default_cc=49)
         >>> p.to_python('333-3333')
         Traceback (most recent call last):
             ...
@@ -2366,7 +2366,7 @@
 
     Examples::
 
-        >>> mac = MacAddress()
+        >>> mac = MACAddress()
         >>> mac.to_python('aa:bb:cc:dd:ee:ff')
         'aabbccddeeff'
         >>> mac.to_python('aa:bb:cc:dd:ee:ff:e')
@@ -2377,7 +2377,7 @@
         Traceback (most recent call last):
             ...
         Invalid: MAC addresses may only contain 0-9 and A-F (and optionally :), not 'x'
-        >>> MacAddress(add_colons=True).to_python('aabbccddeeff')
+        >>> MACAddress(add_colons=True).to_python('aabbccddeeff')
         'aa:bb:cc:dd:ee:ff'
     """