Docutils: Documentation Utilities

Fred L. Drake, Jr. wrote:
> The Node class defines both __nonzero__() and __len__(),

Actually, Node only defines __nonzero__().  The Element class defines 
__len__(), and I've just added __len__() to the Text class for completeness.

> but returns true from __nonzero__() even when __len__() returns 0.
> There should be a comment explaining why; this is very confusing.

Does this make sense? ::

     def __nonzero__(self):
         """
         Node instances are always true, even if they're empty.

         Use `len()` to check node length.  Use `None` to represent a
         boolean false value.
         """

Checked in.

-- 
David Goodger    http://starship.python.net/~goodger

Programmer/sysadmin for hire: http://starship.python.net/~goodger/cv