Fix up some examples in the tutorial so we don't contradict our own

advice on docstrings.
This fixes SF bug #495601.