Fixed typos and updated usage-examples.md; added new utility function in timeutils.py; regenerated docs; updated the egg configuration file (setup.py)