{"thread":{"id":"48370","subject":"Missing --relative documentation","startedAt":"2018-04-27T17:25:12Z","lastAt":"2018-05-10T14:22:47Z","messageCount":2,"participants":["kelly elton","Jeff King"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"345965","messageId":"CALVfKe9K+qoDNXf1PbnvXWdYn-Vtv8xUJF-1PctC8uN1p4gyiA@mail.gmail.com","threadId":"48370","inReplyTo":null,"subject":"Missing --relative documentation","fromName":"kelly elton","fromEmail":"its.the.doc@gmail.com","sentAt":"2018-04-27T17:24:26Z","receivedAt":"2018-04-27T17:25:12Z","isPatch":false,"sender":{"key":"its.the.doc@gmail.com","avatar":null},"body":"git format-patch is missing documentation for --relative.\nThere is also no auto complete(or tab complete, whatever it's called)\nfor the --relative switch/argument.\n\nhttps://stackoverflow.com/a/16309416/222054\n\nThanks,\nKelly Elton\nhttp://www.kellyelton.com\n"},{"id":"347241","messageId":"20180510142242.GA25617@sigill.intra.peff.net","threadId":"48370","inReplyTo":"CALVfKe9K+qoDNXf1PbnvXWdYn-Vtv8xUJF-1PctC8uN1p4gyiA@mail.gmail.com","subject":"Re: Missing --relative documentation","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2018-05-10T14:22:42Z","receivedAt":"2018-05-10T14:22:47Z","isPatch":false,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"On Fri, Apr 27, 2018 at 12:24:26PM -0500, kelly elton wrote:\n\n> git format-patch is missing documentation for --relative.\n> There is also no auto complete(or tab complete, whatever it's called)\n> for the --relative switch/argument.\n\nThe missing documentation is due to the ancient d4cb003fff (format-patch\ndocumentation: Remove diff options that are not useful, 2009-11-07).\nUnfortunately I couldn't find any discussion on why those options were\nthought to be useless.\n\nI assume the notion was that the point of format-patch is to generate\nfull text patches for somebody else to apply, and thus something like\n--relative usually wouldn't make sense. I could see it being useful if\nyou are doing something funny, though, like generating patches for a\nsubset of the repository as if they were at the top level.\n\nI'm not sure if it would make sense to add the option back to the\ndocumentation, though, since the point was to try to de-clutter the\nformat-patch manpage. I wonder if we could say something like \"this\ncommand supports all the diff options; see git-diff[1] for the full\nlist\".\n\n-Peff\n"}]}