needs two colons `::` to be a quoted code block.

Also, it would be useful to turn these snippets into `.. doctest::` blocks, like in various parts of the manual.