Docs: Update (fix) description of GIT_SORT constants

Author: jdavid

src/repository.c

@@ -713,31 +713,33 @@ Repository_cherrypick(Repository *self, PyObject *py_oid)
 }
 
 PyDoc_STRVAR(Repository_walk__doc__,
-  "walk(oid[, sort_mode]) -> iterator\n"
-  "\n"
-  "Generator that traverses the history starting from the given commit.\n"
-  "The following types of sorting could be used to control traversing\n"
-  "direction:\n"
-  "\n"
-  "* GIT_SORT_NONE. This is the default sorting for new walkers.\n"
-  "  Sort the repository contents in no particular ordering\n"
-  "* GIT_SORT_TOPOLOGICAL. Sort the repository contents in topological order\n"
-  "  (parents before children); this sorting mode can be combined with\n"
-  "  time sorting.\n"
-  "* GIT_SORT_TIME. Sort the repository contents by commit time\n"
-  "* GIT_SORT_REVERSE. Iterate through the repository contents in reverse\n"
-  "  order; this sorting mode can be combined with any of the above.\n"
-  "\n"
-  "Example:\n"
-  "\n"
-  "  >>> from pygit2 import Repository\n"
-  "  >>> from pygit2 import GIT_SORT_TOPOLOGICAL, GIT_SORT_REVERSE\n"
-  "  >>> repo = Repository('.git')\n"
-  "  >>> for commit in repo.walk(repo.head.target, GIT_SORT_TOPOLOGICAL):\n"
-  "  ...    print(commit.message)\n"
-  "  >>> for commit in repo.walk(repo.head.target, GIT_SORT_TOPOLOGICAL | GIT_SORT_REVERSE):\n"
-  "  ...    print(commit.message)\n"
-  "  >>>\n");
+    "walk(oid[, sort_mode]) -> iterator\n"
+    "\n"
+    "Generator that traverses the history starting from the given commit.\n"
+    "The following types of sorting could be used to control traversing\n"
+    "direction:\n"
+    "\n"
+    "* GIT_SORT_NONE. Sort the output with the same default method from\n"
+    "  `git`: reverse chronological order. This is the default sorting for\n"
+    "  new walkers.\n"
+    "* GIT_SORT_TOPOLOGICAL. Sort the repository contents in topological order\n"
+    "  (no parents before all of its children are shown); this sorting mode\n"
+    "  can be combined with time sorting to produce `git`'s `--date-order``.\n"
+    "* GIT_SORT_TIME. Sort the repository contents by commit time; this sorting\n"
+    "  mode can be combined with topological sorting.\n"
+    "* GIT_SORT_REVERSE.  Iterate through the repository contents in reverse\n"
+    "  order; this sorting mode can be combined with any of the above.\n"
+    "\n"
+    "Example:\n"
+    "\n"
+    "  >>> from pygit2 import Repository\n"
+    "  >>> from pygit2 import GIT_SORT_TOPOLOGICAL, GIT_SORT_REVERSE\n"
+    "  >>> repo = Repository('.git')\n"
+    "  >>> for commit in repo.walk(repo.head.target, GIT_SORT_TOPOLOGICAL):\n"
+    "  ...    print(commit.message)\n"
+    "  >>> for commit in repo.walk(repo.head.target, GIT_SORT_TOPOLOGICAL | GIT_SORT_REVERSE):\n"
+    "  ...    print(commit.message)\n"
+    "  >>>\n");
 
 PyObject *
 Repository_walk(Repository *self, PyObject *args)