From c20e6fb1df0b9049377b0050599d320dd3822150 Mon Sep 17 00:00:00 2001 From: "Jason St. John" Date: Wed, 13 Nov 2013 01:21:48 -0500 Subject: [PATCH] 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 --- Documentation/git-log.txt | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) 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 ::::