# [PATCH] diff-options.txt: document the new "--dirstat" option

1 messages from 2008-04-21 to 2008-04-21. Participants: Gerrit Pape.
Thread: https://gitlist.dev/t/13200

## Gerrit Pape, 2008-04-21 18:15

Subject: [PATCH] diff-options.txt: document the new "--dirstat" option
Message-ID: <20080421181552.22887.qmail@f15a5fb7994b18.315fe32.mid.smarden.org>
URL: https://gitlist.dev/e/20080421181552.22887.qmail%40f15a5fb7994b18.315fe32.mid.smarden.org

```
7df7c01 Adds "--dirstat" for some directory statistics,
this commit adds the documentation for the new option.

Noticed by Clint Adams, reported through
 http://bugs.debian.org/476437

Signed-off-by: Gerrit Pape <pape@smarden.org>
---
 Documentation/diff-options.txt |    8 ++++++++
 1 files changed, 8 insertions(+), 0 deletions(-)

diff --git a/Documentation/diff-options.txt b/Documentation/diff-options.txt
index 8dc5b00..01e7a57 100644
--- a/Documentation/diff-options.txt
+++ b/Documentation/diff-options.txt
@@ -58,6 +58,14 @@ endif::git-format-patch[]
 	number of modified files, as well as number of added and deleted
 	lines.
 
+--dirstat[=limit]::
+	Output only the sub-directories that are impacted by a diff,
+	and to what degree they are impacted.  You can override the
+	default cut-off in percent (3) by "--dirstat=limit".  If you
+	want to enable "cumulative" directory statistics, you can use
+	the "--cumulative" flag, which adds up percentages recursively
+	even when they have been already reported for a sub-directory.
+
 --summary::
 	Output a condensed summary of extended header information
 	such as creations, renames and mode changes.
-- 
1.5.5

```