Cleans up core docs a bit, removes useless examples.  Changes the return value of removeActor to that of the removed actor.