Small changes for better readability

- some docstrings
- some more speaking varnames
- in one case of KeyError while removing an indexed value,
  run a consistency check on the BTree. This would raise
  an AssertionError which is slightly more helpful for the user


git-svn-id: svn://svn.zope.org/repos/main@127872 62d5b8a3-27da-0310-9561-8e5933582275
prepare

git-svn-id: svn://svn.zope.org/repos/main@127873 62d5b8a3-27da-0310-9561-8e5933582275
tagged

git-svn-id: svn://svn.zope.org/repos/main@127874 62d5b8a3-27da-0310-9561-8e5933582275
vb

git-svn-id: svn://svn.zope.org/repos/main@127875 62d5b8a3-27da-0310-9561-8e5933582275
datetime 3.0.1


git-svn-id: svn://svn.zope.org/repos/main@127876 62d5b8a3-27da-0310-9561-8e5933582275
Fixed: When using the meta-recipe parse method, the order that
       resulting sections were added was not=deterministic, due to the
       way ConfigParser works.  Not sections are added to a buildout
       in sortd order, by section name.


git-svn-id: svn://svn.zope.org/repos/main@127877 62d5b8a3-27da-0310-9561-8e5933582275
Fixed: Testing support didn't catch type errors resulting from using
       non-string data (especially unicode) in recipe options.


git-svn-id: svn://svn.zope.org/repos/main@127878 62d5b8a3-27da-0310-9561-8e5933582275
Fixed: Testing support didn't catch type errors resulting from using
       non-string data (especially unicode) in recipe options.


git-svn-id: svn://svn.zope.org/repos/main@127879 62d5b8a3-27da-0310-9561-8e5933582275
Reverted previous change. Decided to address the problem by making it
easier to do the right thing, rather than by catching doing the wrong
thing.


git-svn-id: svn://svn.zope.org/repos/main@127880 62d5b8a3-27da-0310-9561-8e5933582275
When setting option values, unicode and int values will be converted
to strings.  Other non-string values are rejected.  Previously, it
was easy to get errors from buildout when setting options with
values read from ZooKeeper trees, which are unicode due to the use
of JSON.


git-svn-id: svn://svn.zope.org/repos/main@127881 62d5b8a3-27da-0310-9561-8e5933582275
tag

git-svn-id: svn://svn.zope.org/repos/main@127882 62d5b8a3-27da-0310-9561-8e5933582275
version


git-svn-id: svn://svn.zope.org/repos/main@127883 62d5b8a3-27da-0310-9561-8e5933582275
added a TODO

git-svn-id: svn://svn.zope.org/repos/main@127884 62d5b8a3-27da-0310-9561-8e5933582275
Don't test faux zookeeper tests w real zookeeper.


git-svn-id: svn://svn.zope.org/repos/main@127885 62d5b8a3-27da-0310-9561-8e5933582275
- The walk method now provides options to:

- skip ephemeral nodes

- yield a mutable children list, allowing walking to be
    short-circuited.

- Fixed: if nodes were deleted (e.g. by other clients) then the walk
  method could raise ``NoNodeException``.


git-svn-id: svn://svn.zope.org/repos/main@127886 62d5b8a3-27da-0310-9561-8e5933582275
tag

git-svn-id: svn://svn.zope.org/repos/main@127887 62d5b8a3-27da-0310-9561-8e5933582275
version


git-svn-id: svn://svn.zope.org/repos/main@127888 62d5b8a3-27da-0310-9561-8e5933582275
- updated Zope2 versions

git-svn-id: svn://svn.zope.org/repos/main@127889 62d5b8a3-27da-0310-9561-8e5933582275
- updated Zope2 versions

git-svn-id: svn://svn.zope.org/repos/main@127890 62d5b8a3-27da-0310-9561-8e5933582275
- updated Zope2 versions

git-svn-id: svn://svn.zope.org/repos/main@127891 62d5b8a3-27da-0310-9561-8e5933582275