Tidied up some of the docstrings. Have also changed some of the default keyword args to get rid of empty lists and dicts. This is because they get evaluated ONCE and can then create some unpredictable behaviour.
Authored by: scaryclam 2011-12-29
Parent: [r34]
Child: [r36]
