start adding '.. doctest::' directives to manual
some doc/manual fixes found by doctest
Merge pull request #4897 from JuliaLang/mn/doctest

close #52 (run doc example code as a test suite)