summaryrefslogtreecommitdiffstats
path: root/git-rev-list.html
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2023-01-30 14:48:08 -0800
committerJunio C Hamano <gitster@pobox.com>2023-01-30 14:48:08 -0800
commit11f1df190fcc3ac9c3263a3eba8104cbdee4787d (patch)
treed502d6143db9bbb16ca8afac629ff1b4126c9482 /git-rev-list.html
parentd71eb7dd5b4fb3cafaa3d603f625c0a0f75373f4 (diff)
downloadgit-htmldocs-11f1df190fcc3ac9c3263a3eba8104cbdee4787d.tar.gz
Autogenerated HTML docs for v2.39.1-388-g2fc9e
Diffstat (limited to 'git-rev-list.html')
-rw-r--r--git-rev-list.html40
1 files changed, 25 insertions, 15 deletions
diff --git a/git-rev-list.html b/git-rev-list.html
index 3fa41daf3..68c72896e 100644
--- a/git-rev-list.html
+++ b/git-rev-list.html
@@ -2866,44 +2866,54 @@ switch line wrapping, like the -w option of
</p>
</dd>
<dt class="hdlist1">
-<em>%&lt;(&lt;N&gt;[,trunc|ltrunc|mtrunc])</em>
+<em>%&lt;( &lt;N&gt; [,trunc|ltrunc|mtrunc])</em>
</dt>
<dd>
<p>
make the next placeholder take at
- least N columns, padding spaces on
+ least N column widths, padding spaces on
the right if necessary. Optionally
- truncate at the beginning (ltrunc),
- the middle (mtrunc) or the end
- (trunc) if the output is longer than
- N columns. Note that truncating
+ truncate (with ellipsis <em>..</em>) at the left (ltrunc) <code>..ft</code>,
+ the middle (mtrunc) <code>mi..le</code>, or the end
+ (trunc) <code>rig..</code>, if the output is longer than
+ N columns.
+ Note 1: that truncating
only works correctly with N &gt;= 2.
+ Note 2: spaces around the N and M (see below)
+ values are optional.
+ Note 3: Emojis and other wide characters
+ will take two display columns, which may
+ over-run column boundaries.
+ Note 4: decomposed character combining marks
+ may be misplaced at padding boundaries.
</p>
</dd>
<dt class="hdlist1">
-<em>%&lt;|(&lt;N&gt;)</em>
+<em>%&lt;|( &lt;M&gt; )</em>
</dt>
<dd>
<p>
-make the next placeholder take at least until Nth
- columns, padding spaces on the right if necessary
+make the next placeholder take at least until Mth
+ display column, padding spaces on the right if necessary.
+ Use negative M values for column positions measured
+ from the right hand edge of the terminal window.
</p>
</dd>
<dt class="hdlist1">
-<em>%&gt;(&lt;N&gt;)</em>, <em>%&gt;|(&lt;N&gt;)</em>
+<em>%&gt;( &lt;N&gt; )</em>, <em>%&gt;|( &lt;M&gt; )</em>
</dt>
<dd>
<p>
-similar to <em>%&lt;(&lt;N&gt;)</em>, <em>%&lt;|(&lt;N&gt;)</em> respectively,
+similar to <em>%&lt;( &lt;N&gt; )</em>, <em>%&lt;|( &lt;M&gt; )</em> respectively,
but padding spaces on the left
</p>
</dd>
<dt class="hdlist1">
-<em>%&gt;&gt;(&lt;N&gt;)</em>, <em>%&gt;&gt;|(&lt;N&gt;)</em>
+<em>%&gt;&gt;( &lt;N&gt; )</em>, <em>%&gt;&gt;|( &lt;M&gt; )</em>
</dt>
<dd>
<p>
-similar to <em>%&gt;(&lt;N&gt;)</em>, <em>%&gt;|(&lt;N&gt;)</em>
+similar to <em>%&gt;( &lt;N&gt; )</em>, <em>%&gt;|( &lt;M&gt; )</em>
respectively, except that if the next
placeholder takes more spaces than given and
there are spaces on its left, use those
@@ -2911,11 +2921,11 @@ similar to <em>%&gt;(&lt;N&gt;)</em>, <em>%&gt;|(&lt;N&gt;)</em>
</p>
</dd>
<dt class="hdlist1">
-<em>%&gt;&lt;(&lt;N&gt;)</em>, <em>%&gt;&lt;|(&lt;N&gt;)</em>
+<em>%&gt;&lt;( &lt;N&gt; )</em>, <em>%&gt;&lt;|( &lt;M&gt; )</em>
</dt>
<dd>
<p>
-similar to <em>%&lt;(&lt;N&gt;)</em>, <em>%&lt;|(&lt;N&gt;)</em>
+similar to <em>%&lt;( &lt;N&gt; )</em>, <em>%&lt;|( &lt;M&gt; )</em>
respectively, but padding both sides
(i.e. the text is centered)
</p>