doc: pretty-formats describe use of ellipsis in truncation
Commit a7f01c6b4d (pretty: support truncating in %>, %< and %><, 2013-04-19) added the use of ellipsis when truncating placeholder values. Show our 'two dot' ellipsis, and examples for the left, middle and right truncation to avoid any confusion as to which end of the string is adjusted. (cf justification and sub-string). Signed-off-by: Philip Oakley <philipoakley@iee.email> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Philip Oakley committed
Jan 19, 2023 at 18:18 UTC
b5cd634d7a30074452c5aa3b0ce66ce794c4d565
1 file changed
+3
-3
Documentation/pretty-formats.txt
+3
-3
@@ -149,9 +149,9 @@ The placeholders are:
149
'%<( <N> [,trunc|ltrunc|mtrunc])':: make the next placeholder take at
150
least N column widths, padding spaces on
151
the right if necessary. Optionally
152
- truncate at the beginning (ltrunc),
153
- the middle (mtrunc) or the end
154
- (trunc) if the output is longer than
152
+ truncate (with ellipsis '..') at the left (ltrunc) `..ft`,
153
+ the middle (mtrunc) `mi..le`, or the end
154
+ (trunc) `rig..`, if the output is longer than
155
N columns.
156
Note 1: that truncating
157
only works correctly with N >= 2.