necessary for pt_edit() calls where the encoding should not be changed
by sniffing inside the content (used by pt_editAction(), ZMI and by
the constructor)

- moved the encoding detection into pt_edit() to make it available in a single place

as encoding if the encoding could not be determined from the body text

(should be fixed in Zope 3)

the PUT factory now tries to detect the encoding of uploaded contenthe PUT factory now tries to detect the encoding of uploaded contentt

- PUT() now uses pt_edit() in order to play nicely
  with encoded text. We *except* the the encoding of the uploaded
  text is the same as the original encoding (self.output_encoding)

- add pt_render() in order to convert result of PageTemplate.pt_render()  - returned as unicode - 
  to the output_encoding
- __call__() sets the charset property of the conent-type header according to the output encoding

Collector #2187: PUT_factory broken.

- test.py lives in ZOPE_HOME for checkouts and ZOPE_HOME/bin for
  installations.
- Comparing abspaths does not fly when symlinks are involved; use
  realpaths instead.

"don't want to see Z2 interfaces anymore".

Extended DateTime parser for better support to the ISO8601 specification. Normalized docstrings. Fixes http://www.zope.org/Collectors/Zope/2191.

revert ZCatalog.getobject() semantics not to mask traversal errors and not to fallback to .resolve_url() when the traversal result is None

      - Reworking of _cached_result in Shared.DC.ZRDB.DA.DA:

        - fixed KeyError reported in Collector #2212

        - fixed two memory leaks that occurred under high load

        - fixed broken cache keys for people using the obscure 
          Shared.DC.ZRDB.DA.DA.connection_hook

        - fixed incorrect cache ordering resulting in newer results
          being dumped when the cache became too large.

- remove the pointless check for cache time being enabled inside _cached_result - _cached_result isn't actually called if caching isn't enabled
- slight code tidy in DA.py
- lots of comments in the test_caching.py and DA.py's _cached_result method

- actively remove entries from the cache when they are found to be stale. This removes the possible causes of both the KeyError bug that Brian patched in Dec 2000 and the KeyError bug reported in #2212
- remove arbitary "divide by 2" on when we start checking to empty the cache and tcache, it looks like this may have once made sense when the tcache could grow without the cache growing, but I still can't really see how it made sense :-S
- fix of-by-one errors on cache size

- document the slim chances of remaining memory leaks
- remove pointless import try/except, it always fails now
- adjust tests to make sure we still generate pathalogical dict orderings

- document 2 memory leaks, one in cache and one in tcache
- test coverage for the patch Brian applied in Dec 2000

- replace nasty and ineffective hack for dynamic connections ids in ZSQL Method cache which is tested and works
- simplify tests as a result
- make sure full chain of DA.__call__ and DA._cached_result is execercised

The tests pass but XXX marks stuff that needs fixing.