René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Documentation for git_sort_t needs clarification","articleBody":"Assuming we have this history where commits were created in this numerical order with 1s difference between them:\n\n```\n  0---1----2----4----7 (master)\n       \\         \\\n        3----5----6----8--- (topic)\n```\n\nLibgit2 commit walker API outputs the following depending on the sorting mode:\n- `GIT_SORT_NONE`: 7, 4, 2, 1, 0, 8, 6, 5, 3\n- `GIT_SORT_TIME`: 8, 7, 6, 5, 4, 3, 2, 1, 0\n- `GIT_SORT_TOPOLOGICAL`: 8, 6, 5, 3, 7, 4, 2, 1, 0\n- `GIT_SORT_TOPOLOGICAL | GIT_SORT_TIME`: 7, 8, 6, 4, 2, 5, 3, 1, 0\n\nThe doc for `GIT_SORT_TOPOLOGICAL` however says that parents will come before children which is not the case obviously:\n\n```\n    /**\n     * Sort the repository contents in topological order\n     * (parents before children); this sorting mode\n     * can be combined with time sorting.\n     */\n    GIT_SORT_TOPOLOGICAL = 1 \u003c\u003c 0,\n```\n\nThe doc don't explain either how exactly combining `GIT_SORT_TOPOLOGICAL | GIT_SORT_TIME` works: it just says they can be combined. For instance which mode takes priority over the other? The test above just adds confusion as both `GIT_SORT_TIME` and `GIT_SORT_TOPOLOGICAL` put commit 8 first but combining both modes put commit 7 first.\n\nFor reference, here's how the Git log command help explains the available sorting modes which is easier to understand and less ambiguous IMO:\n\n```\nCommit Ordering\nBy default, the commits are shown in reverse chronological order.\n\n--date-order\nShow no parents before all of its children are shown, but otherwise show commits in the commit timestamp order.\n\n--author-date-order\nShow no parents before all of its children are shown, but otherwise show commits in the author timestamp order.\n\n--topo-order\nShow no parents before all of its children are shown, and avoid showing commits on multiple lines of history intermixed.\n\n--reverse\nOutput the commits in reverse order.\n```\n","author":{"url":"https://github.com/swisspol","@type":"Person","name":"swisspol"},"datePublished":"2014-12-18T18:50:51.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":2},"url":"https://github.com/2765/libgit2/issues/2765"}