implement convergence check control; update tests and documentation

(still need unit tests of convergence check control!)