)]}'
{
  "commit": "cebfaaa33332f26e40b99322b7d26f72a2ddcabb",
  "tree": "cab7445ad81bcc0359d2cf0abb6ee417b4ddee7f",
  "parents": [
    "43c8a30d150ecede9709c1f2527c8fba92c65f40"
  ],
  "author": {
    "name": "Štěpán Němec",
    "email": "stepnem@smrk.net",
    "time": "Mon Oct 09 19:56:04 2023 +0200"
  },
  "committer": {
    "name": "Junio C Hamano",
    "email": "gitster@pobox.com",
    "time": "Mon Oct 09 12:46:33 2023 -0700"
  },
  "message": "doc/cat-file: make synopsis and description less confusing\n\nThe DESCRIPTION\u0027s \"first form\" is actually the 1st, 2nd, 3rd and 5th\nform in SYNOPSIS, the \"second form\" is the 4th one.\n\nInterestingly, this state of affairs was introduced in\n97fe7250753b (cat-file docs: fix SYNOPSIS and \"-h\" output, 2021-12-28)\nwith the claim of \"Now the two will match again.\" (\"the two\" being\nDESCRIPTION and SYNOPSIS)...\n\nThe description also suffers from other correctness and clarity issues,\ne.g., the \"first form\" paragraph discusses -p, -s and -t, but leaves out\n-e, which is included in the corresponding SYNOPSIS section; the second\nparagraph mentions \u003cformat\u003e, which doesn\u0027t occur in SYNOPSIS at all, and\nof the three batch options, really only describes the behavior of\n--batch-check.  Also the mention of \"drivers\" seems an implementation\ndetail not adding much clarity in a short summary (and isn\u0027t expanded\nupon in the rest of the man page, either).\n\nRather than trying to maintain one-to-one (or N-to-M) correspondence\nbetween the DESCRIPTION and SYNOPSIS forms, creating duplication and\nproviding opportunities for error, shorten the former into a concise\nsummary describing the two general modes of operation: batch and\nnon-batch, leaving details to the subsequent manual sections.\n\nWhile here, fix a grammar error in the description of -e and make the\nfollowing further minor improvements:\n\n  NAME:\n    shorten (\"content or type and size\" isn\u0027t the whole story; say\n    \"details\" and leave the actual details to later sections)\n\n  SYNOPSIS and --help:\n    move the (--textconv | --filters) form before --batch, closer\n    to the other non-batch forms\n\nSigned-off-by: Štěpán Němec \u003cstepnem@smrk.net\u003e\nAcked-by: Jeff King \u003cpeff@peff.net\u003e\nSigned-off-by: Junio C Hamano \u003cgitster@pobox.com\u003e\n",
  "tree_diff": [
    {
      "type": "modify",
      "old_id": "0e4936d182632fb3362376787efd7d633bd623d2",
      "old_mode": 33188,
      "old_path": "Documentation/git-cat-file.txt",
      "new_id": "bd95a6c10a7d0b1ee16b619c4b546c8d9c0b0e13",
      "new_mode": 33188,
      "new_path": "Documentation/git-cat-file.txt"
    },
    {
      "type": "modify",
      "old_id": "694c8538df2ff8200e214351e5e857530d2a1191",
      "old_mode": 33188,
      "old_path": "builtin/cat-file.c",
      "new_id": "ea8ad601ecc0b7ee2d7eb9c3da2bb70bcfc55cf8",
      "new_mode": 33188,
      "new_path": "builtin/cat-file.c"
    }
  ]
}