)]}'
{
  "commit": "acbfae32a31180d781357028af9aff8928672d4b",
  "tree": "bc737ce26e99375e3f6adbc5cbb0093f35ed906b",
  "parents": [
    "4da9e99e6eaab24ef86c44642b0692669adacfeb"
  ],
  "author": {
    "name": "Damien Robert",
    "email": "damien.olivier.robert@gmail.com",
    "time": "Mon Apr 06 15:57:09 2020 +0200"
  },
  "committer": {
    "name": "Junio C Hamano",
    "email": "gitster@pobox.com",
    "time": "Mon Apr 06 13:42:43 2020 -0700"
  },
  "message": "doc: --recurse-submodules mostly applies to active submodules\n\nThe documentation refers to \"initialized\" or \"populated\" submodules,\nto explain which submodules are affected by \u0027--recurse-submodules\u0027, but\nthe real terminology here is \u0027active\u0027 submodules. Update the\ndocumentation accordingly.\n\nSome terminology:\n- Active is defined in gitsubmodules(7), it only involves the\n  configuration variables \u0027submodule.active\u0027, \u0027submodule.\u003cname\u003e.active\u0027\n  and \u0027submodule.\u003cname\u003e.url\u0027. The function\n  submodule.c::is_submodule_active checks that a submodule is active.\n- Populated means that the submodule\u0027s working tree is present (and the\n  gitfile correctly points to the submodule repository), i.e. either the\n  superproject was cloned with ` --recurse-submodules`, or the user ran\n  `git submodule update --init`, or `git submodule init [\u003cpath\u003e]` and\n  `git submodule update [\u003cpath\u003e]` separately which populated the\n  submodule working tree. This does not involve the 3 configuration\n  variables above.\n- Initialized (at least in the context of the man pages involved in this\n  patch) means both \"populated\" and \"active\" as defined above, i.e. what\n  `git submodule update --init` does.\n\nThe --recurse-submodules option mostly affects active submodules. An\nexception is `git fetch` where the option affects populated submodules.\nAs a consequence, in `git pull --recurse-submodules` the fetch affects\npopulated submodules, but the resulting working tree update only affects\nactive submodules.\n\nIn the documentation of `git-pull`, let\u0027s distinguish between the\nfetching part which affects populated submodules, and the updating of\nworktrees, which only affects active submodules.\n\nSigned-off-by: Damien Robert \u003cdamien.olivier.robert+git@gmail.com\u003e\nHelped-by: Philippe Blain \u003clevraiphilippeblain@gmail.com\u003e\nSigned-off-by: Junio C Hamano \u003cgitster@pobox.com\u003e\n",
  "tree_diff": [
    {
      "type": "modify",
      "old_id": "140bd3eabbf83c2f068880ac55080b40ed82f421",
      "old_mode": 33188,
      "old_path": "Documentation/git-checkout.txt",
      "new_id": "5b697eee1b7632a046b48d488b3c3af75ad7fa45",
      "new_mode": 33188,
      "new_path": "Documentation/git-checkout.txt"
    },
    {
      "type": "modify",
      "old_id": "ddb6acc0257ef25c415de9e63e4fb9bacd1728ea",
      "old_mode": 33188,
      "old_path": "Documentation/git-grep.txt",
      "new_id": "cdf8e26b479ef644696c67cd384e9802efd834c8",
      "new_mode": 33188,
      "new_path": "Documentation/git-grep.txt"
    },
    {
      "type": "modify",
      "old_id": "8461c0e83e9d535b25755be1d5045cdc30145cb4",
      "old_mode": 33188,
      "old_path": "Documentation/git-ls-files.txt",
      "new_id": "3cb2ebb4380e28e8e4b4e1bb5e3f4ae511960b7a",
      "new_mode": 33188,
      "new_path": "Documentation/git-ls-files.txt"
    },
    {
      "type": "modify",
      "old_id": "47bc4a7061dec0c11cd95a3215dc790dc4dadda7",
      "old_mode": 33188,
      "old_path": "Documentation/git-pull.txt",
      "new_id": "b336df00c7e6903a73992bd6a51018c69cd6d08e",
      "new_mode": 33188,
      "new_path": "Documentation/git-pull.txt"
    },
    {
      "type": "modify",
      "old_id": "501f2ec375d6909d134e290a4a6a7c46c139951e",
      "old_mode": 33188,
      "old_path": "Documentation/git-read-tree.txt",
      "new_id": "5fa8bab64c2d0bb80f88ace023b5eafc898b05f1",
      "new_mode": 33188,
      "new_path": "Documentation/git-read-tree.txt"
    },
    {
      "type": "modify",
      "old_id": "79dbc9624ddffe88210a594ff9b66a1048c7a310",
      "old_mode": 33188,
      "old_path": "Documentation/git-switch.txt",
      "new_id": "3759c3a265b5b9761a9df4d8e6b9d733d29aee04",
      "new_mode": 33188,
      "new_path": "Documentation/git-switch.txt"
    }
  ]
}