class PeekingIterator(Iterator):
- """An iterator that lets you peek() at the next item on deck.
+ """An iterator that lets you :meth:`peek` at the next item on deck.
Returns None when there is no next item (i.e. when
- __next__() will produce a StopIteration exception).
+ :meth:`__next__` will produce a StopIteration exception).
>>> p = PeekingIterator(iter(range(3)))
>>> p.__next__()