Expanded the run() docstring to explain why this method exists.
Authored by: bugman 2010-01-13
Parent: [r10197]
Child: [r10199]
