BUG: integrate: Fix some bugs and documentation errors in the ode solvers.

This pull request continues https://github.com/scipy/scipy/pull/3206.  Specifically, it fixes the handling of banded Jacobians in the `vode` solver and in the `complex_ode` class, and fixes some documentation mistakes.
Maybe HACKING should have some comment on test generators (comments welcome!): gh-3966