remove utility functions from documentation.

should really only be used internally
[doc] remove outdated information
[doc] update caveats
[doc] minimum python version is 2.6 now