From b4a56a3966e3da8f8c369f8f5674233d34d94999 Mon Sep 17 00:00:00 2001 From: Junio C Hamano Date: Thu, 15 Jan 2015 17:32:57 -0800 Subject: "log --pretty" documentation: do not forget "tformat:" We forgot to list "tformat:" when enumerating possible values that "--pretty=" can take. It was not described that "--pretty='string with %s placeholder'" that is not understood is DWIMmed as "--pretty=tformat:". Further, it was unclear what "When omitted, defaults to 'medium'" was meant. Is it "When --pretty= was not given at all", or is it "When --pretty is given without ="? Clarify that it is the latter. Signed-off-by: Junio C Hamano diff --git a/Documentation/pretty-options.txt b/Documentation/pretty-options.txt index 8569e29..74aa01a 100644 --- a/Documentation/pretty-options.txt +++ b/Documentation/pretty-options.txt @@ -3,9 +3,13 @@ Pretty-print the contents of the commit logs in a given format, where '' can be one of 'oneline', 'short', 'medium', - 'full', 'fuller', 'email', 'raw' and 'format:'. See - the "PRETTY FORMATS" section for some additional details for each - format. When omitted, the format defaults to 'medium'. + 'full', 'fuller', 'email', 'raw', 'format:' + and 'tformat:'. When '' is none of the above, + and has '%placeholder' in it, it acts as if + '--pretty=tformat:' were given. ++ +See the "PRETTY FORMATS" section for some additional details for each +format. When '=' part is omitted, it defaults to 'medium'. + Note: you can specify the default pretty format in the repository configuration (see linkgit:git-config[1]). -- cgit v0.10.2-6-g49f6