)]}'
{
  "commit": "effcf7b14467fba7eb36ea2be1b3422eb03d9240",
  "tree": "c487373304661919e7851f460bdd7cf823e6a4b4",
  "parents": [
    "8b1a24e546fb68d3ea59e10939b32328947cdb99"
  ],
  "author": {
    "name": "Philippe Waroquiers",
    "email": "philippe.waroquiers@skynet.be",
    "time": "Mon Apr 18 11:21:09 2022 +0200"
  },
  "committer": {
    "name": "Philippe Waroquiers",
    "email": "philippe.waroquiers@skynet.be",
    "time": "Thu Aug 25 18:57:25 2022 +0200"
  },
  "message": "Allow to document user-defined aliases.\n\nCompared to the previous version, this version fixes the comments reported by\nTom Tromey and ensures that the \u0027help some-user-documented-alias\u0027\nshows the alias definition to ensure the user understands this is an\nalias even if specifically documented.\n\nWhen using \u0027help ALIASNAME\u0027, GDB shows the help of the aliased command.\nThis is a good default behaviour.\n\nHowever, GDB alias command allows to define aliases with arguments\npossibly changing or tuning significantly the behaviour of\nthe aliased command.  In such a case, showing the help of the aliased\ncommand might not be ideal.\n\nThis is particularly true when defining an alias as a set of\nnested \u0027with\u0027 followed by a last command to launch, such as:\n  (gdb) alias pp10 \u003d with print pretty -- with print elements 10 -- print\nAsking \u0027help pp10\u0027 shows the help of the \u0027with\u0027 command, which is\nnot particularly useful:\n  (gdb) help pp10\n  with, pp10, w\n    alias pp10 \u003d with print pretty -- with print elements 10 -- print\n  Temporarily set SETTING to VALUE, run COMMAND, and restore SETTING.\n  Usage: with SETTING [VALUE] [-- COMMAND]\n  ....\n\nSuch an alias can now be documented by the user:\n  (gdb) document pp10\n  \u003ePretty printing an expressiong, printing 10 elements.\n  \u003eUsage: pp10 [PRINT-COMMAND-OPTIONS] EXP\n  \u003eSee \u0027help print\u0027 for more information.\n  \u003eend\n  (gdb) help pp10\n    alias pp10 \u003d with print pretty -- with print elements 10 -- print\n  Pretty printing an expressiong, printing 10 elements.\n  Usage: pp10 [PRINT-COMMAND-OPTIONS] EXP\n  See \u0027help print\u0027 for more information.\n  (gdb)\n\nWhen a user-defined alias is documented specifically, help and apropos\nuse the provided alias documentation instead of the documentation of\nthe aliased command.\n\nSuch a documented alias is also not shown anymore in the help of the\naliased command, and the alias is not listed anymore in the help\nof the aliased command.  In particular for cases such as pp10 example above,\nindicating that pp10 is an alias of the \u0027with\u0027 command is confusing.\n",
  "tree_diff": [
    {
      "type": "modify",
      "old_id": "25b771b84f2f4ffaef0c96dd139a17855259f7e9",
      "old_mode": 33188,
      "old_path": "gdb/NEWS",
      "new_id": "dee0ac2ecd8727f84f55d358702bd354d01c4f58",
      "new_mode": 33188,
      "new_path": "gdb/NEWS"
    },
    {
      "type": "modify",
      "old_id": "fde554c7e6cf0a20b8bed67f8e03f7805aa78750",
      "old_mode": 33188,
      "old_path": "gdb/cli/cli-decode.c",
      "new_id": "7c98029f9f4ab65ccb28d7111a484ae329e2c9df",
      "new_mode": 33188,
      "new_path": "gdb/cli/cli-decode.c"
    },
    {
      "type": "modify",
      "old_id": "5f81db418bcd2b859baf92b3c9592929651bd88a",
      "old_mode": 33188,
      "old_path": "gdb/cli/cli-script.c",
      "new_id": "6c67b60e721b843678ed781a407f1f089126e18b",
      "new_mode": 33188,
      "new_path": "gdb/cli/cli-script.c"
    },
    {
      "type": "modify",
      "old_id": "33a56e0ead59537517ede4dc4c7cb0467be5f634",
      "old_mode": 33188,
      "old_path": "gdb/doc/gdb.texinfo",
      "new_id": "238a49b027d104a11290e4ad885a725031ec2e83",
      "new_mode": 33188,
      "new_path": "gdb/doc/gdb.texinfo"
    },
    {
      "type": "modify",
      "old_id": "74da29e3d36676882db8a6522bad2c979851a41f",
      "old_mode": 33188,
      "old_path": "gdb/testsuite/gdb.base/help.exp",
      "new_id": "5ee8ce0726d9f1fab406214653635f43a0987e16",
      "new_mode": 33188,
      "new_path": "gdb/testsuite/gdb.base/help.exp"
    }
  ]
}