That sounds fine to me. You're more than welcome to try the suppress, of course. It may work now. I can't remember the status - I think I covered all the decorators, but I'm just not sure if there was also a plotting issue. I just remember fiddling with this before the SciPy conference this summer when I wrote this.  You can run tools/examples_rst.py over the example script to see what kind of rst it'll generate. May be more trouble than it's worth though.