start adding '.. doctest::' directives to manual
some doc/manual fixes found by doctest