{"thread":{"id":"15318","subject":"[PATCH] Improve documentation for --dirstat diff option","startedAt":"2008-09-01T10:13:34Z","lastAt":"2008-09-01T10:18:01Z","messageCount":2,"participants":["Heikki Orsila","Abhijit Menon-Sen"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"89390","messageId":"20080901101334.GA4544@zakalwe.fi","threadId":"15318","inReplyTo":null,"subject":"[PATCH] Improve documentation for --dirstat diff option","fromName":"Heikki Orsila","fromEmail":"heikki.orsila@iki.fi","sentAt":"2008-09-01T10:13:34Z","receivedAt":"2008-09-01T10:13:34Z","isPatch":true,"sender":{"key":"heikki.orsila@iki.fi","avatar":null},"body":"Signed-off-by: Heikki Orsila <heikki.orsila@iki.fi>\n---\nMy earlier version of the patch already gave an example of use. This \nversion changes the word \"damage\" to \"impact\" (Jakub Narebski's \nsuggestion).\n\n Documentation/diff-options.txt |   11 +++++------\n 1 files changed, 5 insertions(+), 6 deletions(-)\n\ndiff --git a/Documentation/diff-options.txt b/Documentation/diff-options.txt\nindex 1759386..150debb 100644\n--- a/Documentation/diff-options.txt\n+++ b/Documentation/diff-options.txt\n@@ -59,12 +59,11 @@ endif::git-format-patch[]\n \tlines.\n \n --dirstat[=limit]::\n-\tOutput only the sub-directories that are impacted by a diff,\n-\tand to what degree they are impacted.  You can override the\n-\tdefault cut-off in percent (3) by \"--dirstat=limit\".  If you\n-\twant to enable \"cumulative\" directory statistics, you can use\n-\tthe \"--cumulative\" flag, which adds up percentages recursively\n-\teven when they have been already reported for a sub-directory.\n+\tOutput the distribution of relative impact (number of lines added or\n+\tremoved) for each sub-directory. Directories with impact below\n+\ta cut-off percent (3% by default) are not shown. The cut-off percent\n+\tcan be set with \"--dirstat=limit\". Child directory impact is not\n+\tcounted for the parent directory, unless \"--cumulative\" is used.\n \n --summary::\n \tOutput a condensed summary of extended header information\n-- \n1.6.0.1\n"},{"id":"89392","messageId":"20080901101801.GA9843@toroid.org","threadId":"15318","inReplyTo":"20080901101334.GA4544@zakalwe.fi","subject":"Re: [PATCH] Improve documentation for --dirstat diff option","fromName":"Abhijit Menon-Sen","fromEmail":"ams@toroid.org","sentAt":"2008-09-01T10:18:01Z","receivedAt":"2008-09-01T10:18:01Z","isPatch":true,"sender":{"key":"ams@toroid.org","avatar":null},"body":"At 2008-09-01 13:13:34 +0300, heikki.orsila@iki.fi wrote:\n>\n> My earlier version of the patch already gave an example of use. This \n> version changes the word \"damage\" to \"impact\" (Jakub Narebski's \n> suggestion).\n\nSorry, I didn't see the suggestion, but \"impacted\" sounds like you're\ndiscussing a tooth. \"Affected\" or even \"changed\" would be much better.\n\n-- ams\n"}]}