improving the Manual

Looks good. Maybe it would be helpful to add in a little section explaining how to determine whether the slowdown is really caused by a too large amount of geoms or polygons, and whether or not animations are the bottleneck; both of which can be analysed using PStats.

You need to highlight Python code. So yes, all Python code should be enclosed in tags and not

 tags.