X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;ds=sidebyside;f=Documentation%2Fgit-blame.txt;h=9516914236bbfa675006994620b1c8f61855de1d;hb=b2cd17b925a43c232955a53276caf0e20bfd9095;hp=bb8edb4abc5adc8a7b9d46d839415997919871af;hpb=d6ad4ff1202bd79f6470e8699bbd16d6ceb6ae98;p=git.git

diff --git a/Documentation/git-blame.txt b/Documentation/git-blame.txt
index bb8edb4ab..951691423 100644
--- a/Documentation/git-blame.txt
+++ b/Documentation/git-blame.txt
@@ -105,6 +105,19 @@ The contents of the actual line is output after the above
 header, prefixed by a TAB. This is to allow adding more
 header elements later.
 
+The porcelain format generally suppresses commit information that has
+already been seen. For example, two lines that are blamed to the same
+commit will both be shown, but the details for that commit will be shown
+only once. This is more efficient, but may require more state be kept by
+the reader. The `--line-porcelain` option can be used to output full
+commit information for each line, allowing simpler (but less efficient)
+usage like:
+
+	# count the number of lines attributed to each author
+	git blame --line-porcelain file |
+	sed -n 's/^author //p' |
+	sort | uniq -c | sort -rn
+
 
 SPECIFYING RANGES
 -----------------