all parts of issue 951 without being tested
attempt to fix the doctest error
changed the indention to accomodate the rest of the examples
changed some indentions in the examples
added :: at the end of some of the examples

removed leading whitespaces of empty lines