)]}'
{
  "commit": "136f86abc052ef6186d9985fc26833ffc0484888",
  "tree": "7dc7244fbcdba12c4513806cefcb162605336c1f",
  "parents": [
    "b31ab939fe8e3cbe8be48dddd1c6ac0265991f45"
  ],
  "author": {
    "name": "Elijah Newren",
    "email": "newren@gmail.com",
    "time": "Sat Nov 29 04:44:24 2025 +0000"
  },
  "committer": {
    "name": "Junio C Hamano",
    "email": "gitster@pobox.com",
    "time": "Fri Nov 28 23:06:46 2025 -0800"
  },
  "message": "Documentation/git-replay.adoc: fix errors around revision range\n\nThere was significant confusion in the git-replay manual about what\nconstitutes a revision range.  As noted in f302c1e4aa09 (revisions(7):\nclarify that most commands take a single revision range, 2021-05-18):\n\n   Commands that are specifically designed to take two distinct ranges\n   (e.g. \"git range-diff R1 R2\" to compare two ranges) do exist, but they\n   are exceptions. Unless otherwise noted, all \"git\" commands that operate\n   on a set of commits work on a single revision range.\n\n`git replay` is not an exception, but a few places in the manual were\nwritten as though it were.  These appear to have come in revisions to\nthe original series, between v3-\u003ev4 (see\nhttps://lore.kernel.org/git/CAP8UFD3bpLrVW97DH7j\u003dV9H2GsTSAkksC9L3QujQERFk_kLnZA@mail.gmail.com/\n, \"More than one \u003crevision-range\u003e can be passed\") and between v6-\u003ev7\n(https://lore.kernel.org/git/20231115143327.2441397-1-christian.couder@gmail.com/,\n\"Takes ranges of commits\"), and I missed both of these revisions when\nreviewing.  Fix them now.\n\nThere was also a reference to the \"Commit Limiting options below\", but\nthis page has no such section of options; strike the misleading\nreference.\n\nIt is worth noting that we are documenting existing behavior, rather\nthan optimal behavior.  Junio has multiple times suggested introducing\nalternative ways to walk revisions and use them in `git replay\n--advance`, e.g. at\n  * https://lore.kernel.org/git/xmqqy1mqo6kv.fsf@gitster.g/\n  * https://lore.kernel.org/git/xmqq8rb3is8c.fsf@gitster.g/\n  * https://lore.kernel.org/git/xmqqtsydj2zk.fsf@gitster.g/ (item (2))\nIf/when we introduce some new revision walking flag that implements one\nof these alternate types of revision walks, we can update the --advance\noption and this manual appropriately.\n\nSigned-off-by: Elijah Newren \u003cnewren@gmail.com\u003e\nSigned-off-by: Junio C Hamano \u003cgitster@pobox.com\u003e\n",
  "tree_diff": [
    {
      "type": "modify",
      "old_id": "dcb26e8a8e88cac30fb04293c8b941b80ef2acc2",
      "old_mode": 33188,
      "old_path": "Documentation/git-replay.adoc",
      "new_id": "d03235cca0c66840a90d4249e109e5bafe06bbe9",
      "new_mode": 33188,
      "new_path": "Documentation/git-replay.adoc"
    },
    {
      "type": "modify",
      "old_id": "6606a2c94bc67168c2b43e86f24717eb408e6f38",
      "old_mode": 33188,
      "old_path": "builtin/replay.c",
      "new_id": "e6d6d2823969e5389683f3c319f35b892e3ce7f5",
      "new_mode": 33188,
      "new_path": "builtin/replay.c"
    }
  ]
}