)]}'
{
  "commit": "b59698aef38e2541299323be50bbde93fa5ea314",
  "tree": "2ac52838f0cdb1c3f0b37846e1d9c423536ce6b7",
  "parents": [
    "4010f1d1b782eb7585e0e0abcefa794bd5ff29a0"
  ],
  "author": {
    "name": "Junio C Hamano",
    "email": "gitster@pobox.com",
    "time": "Wed Oct 11 11:21:03 2017 +0900"
  },
  "committer": {
    "name": "Junio C Hamano",
    "email": "gitster@pobox.com",
    "time": "Wed Oct 11 14:55:36 2017 +0900"
  },
  "message": "checkout doc: clarify command line args for \"checkout paths\" mode\n\nThere are \"git checkout [-p][\u003ctree-ish\u003e][--][\u003cpaths\u003e...]\" in the\nSYNOPSIS section, and \"git checkout [-p][\u003ctree-ish\u003e][--]\u003cpaths\u003e...\"\nas the header for the section that explains the \"check out paths\nfrom index/tree-ish\" mode.  It is unclear if we require at least one\npath, or it is entirely optional.\n\nActually, both are wrong.  Without the \"-p(atch)\" option, you must\nhave \u003cpathspec\u003e (otherwise, with a commit that is a \u003ctree-ish\u003e, you\nwould be checking out that commit to build a new history on top of\nit).  With it, it is already clear that you are checking out paths,\nit is optional.  In other words, you cannot omit both.\n\nThe source of the confusion is that -p(atch) is described as if it\nis just another \"optional\" part and its description is lumped\ntogether with the non patch mode, even though the actual end user\nexperience is vastly different.\n\nLet\u0027s split the entry into two, and describe the regular mode and\nthe patch mode separately.  This allows us to make it clear that the\nregular mode MUST be given at least one pathspec, that the patch\nmode can be invoked with either \u0027-p\u0027 or \u0027--patch\u0027 but one of these\nmust be given, and that the pathspec is entirely optional in the\npatch mode.\n\nAlso, revamp the explanation of \"checkout paths\" by removing\nextraneous description at the beginning, that says \"checking out\npaths is not checking out a branch\".  Explaining what it is for and\nwhen the user wants to use it upfront is the most direct way to help\nthe readers.\n\nNoticed-by: Robert P J Day\nHelped-by: Jonathan Nieder \u003cjrnieder@gmail.com\u003e\nSigned-off-by: Junio C Hamano \u003cgitster@pobox.com\u003e\n",
  "tree_diff": [
    {
      "type": "modify",
      "old_id": "d6399c0af86bb84cd86b82500ce706cbcd93cd93",
      "old_mode": 33188,
      "old_path": "Documentation/git-checkout.txt",
      "new_id": "236f324698911c1cc198d4d61f0d8696b132d8d0",
      "new_mode": 33188,
      "new_path": "Documentation/git-checkout.txt"
    }
  ]
}