Reorder function docs

Author: kaste

docs/the-functions.rst

@@ -4,19 +4,22 @@
 The functions
 =============
 
-Stable entrypoints are: :func:`when`, :func:`mock`, :func:`unstub`, :func:`verify`, :func:`spy`. New function introduced in v1 are: :func:`when2`, :func:`expect`, :func:`verifyExpectedInteractions`, :func:`verifyStubbedInvocationsAreUsed`, :func:`patch`, :func:`patch_attr`, :func:`patch_dict`
+Stable entrypoints are: :func:`when`, :func:`expect`, :func:`mock`, :func:`unstub`,
+:func:`verify`, :func:`spy`.
+New function introduced in v1 are: :func:`when2`, :func:`verifyExpectedInteractions`, :func:`verifyStubbedInvocationsAreUsed`, :func:`patch`.
+New function introduced in v2 are: :func:`patch_attr`, :func:`patch_dict`
 
 .. autofunction:: when
-.. autofunction:: when2
+.. autofunction:: expect
+.. autofunction:: mock
 .. autofunction:: patch
 .. autofunction:: patch_attr
 .. autofunction:: patch_dict
-.. autofunction:: expect
-.. autofunction:: mock
 .. autofunction:: unstub
 .. autofunction:: forget_invocations
 .. autofunction:: spy
 .. autofunction:: spy2
+.. autofunction:: when2
 
 This looks like a plethora of verification functions, and especially since  you often don't need to `verify` at all.