From: Jason St. John Date: Wed, 13 Nov 2013 06:21:48 +0000 (-0500) Subject: Documentation/git-log: update "--log-size" description X-Git-Tag: v1.8.5.2~6^2~1 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=c20e6fb1df0b9049377b0050599d320dd3822150;p=git Documentation/git-log: update "--log-size" description "--log-size" was added in commit 9fa3465, and the commit message contained a satisfactory explanation; however, the man page entry for it did not describe the actual output format, what the output meant and what the option was meant to be used for. Helped-by: Jonathan Nieder Signed-off-by: Jason St. John Signed-off-by: Junio C Hamano --- diff --git a/Documentation/git-log.txt b/Documentation/git-log.txt index ac2694d04c..da1c2c6fd7 100644 --- a/Documentation/git-log.txt +++ b/Documentation/git-log.txt @@ -56,11 +56,11 @@ Note that this affects all diff-based output types, e.g. those produced by --stat etc. --log-size:: - Before the log message print out its size in bytes. Intended - mainly for porcelain tools consumption. If Git is unable to - produce a valid value size is set to zero. - Note that only message is considered, if also a diff is shown - its size is not included. + + Include a line ``log size '' in the output for each commit, + where is the length of that commit's message in bytes. + Intended to speed up tools that read log messages from `git log` + output by allowing them to allocate space in advance. -L ,:, -L ::::