update documentation to reflect recent developments and optimizations.  also cleaned up performance measuring scripts so they are presentable as part of the distro