summaryrefslogtreecommitdiffstats
path: root/git-range-diff.html
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2018-11-18 21:44:26 +0900
committerJunio C Hamano <gitster@pobox.com>2018-11-18 21:44:26 +0900
commit69bb2b541d6b878a1bf72199f90b2e5dba140a56 (patch)
tree99cafeef63a6ff03379d08391072bf41fccb21e6 /git-range-diff.html
parent06ce83b0f83d238e1676b4adb708f142ab2f9cab (diff)
downloadgit-htmldocs-69bb2b541d6b878a1bf72199f90b2e5dba140a56.tar.gz
Autogenerated HTML docs for v2.20.0-rc0
Diffstat (limited to 'git-range-diff.html')
-rw-r--r--git-range-diff.html20
1 files changed, 19 insertions, 1 deletions
diff --git a/git-range-diff.html b/git-range-diff.html
index 5057f9277..457bfcbc6 100644
--- a/git-range-diff.html
+++ b/git-range-diff.html
@@ -848,6 +848,24 @@ diff options passed to <code>git log</code> when generating those patches.</p></
</div>
</div>
<div class="sect1">
+<h2 id="_output_stability">OUTPUT STABILITY</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>The output of the <code>range-diff</code> command is subject to change. It is
+intended to be human-readable porcelain output, not something that can
+be used across versions of Git to get a textually stable <code>range-diff</code>
+(as opposed to something like the <code>--stable</code> option to
+<a href="git-patch-id.html">git-patch-id(1)</a>). There&#8217;s also no equivalent of
+<a href="git-apply.html">git-apply(1)</a> for <code>range-diff</code>, the output is not intended to
+be machine-readable.</p></div>
+<div class="paragraph"><p>This is particularly true when passing in diff options. Currently some
+options like <code>--stat</code> can, as an emergent effect, produce output
+that&#8217;s quite useless in the context of <code>range-diff</code>. Future versions
+of <code>range-diff</code> may learn to interpret such options in a manner
+specific to <code>range-diff</code> (e.g. for <code>--stat</code> producing human-readable
+output which summarizes how the diffstat changed).</p></div>
+</div>
+</div>
+<div class="sect1">
<h2 id="_configuration">CONFIGURATION</h2>
<div class="sectionbody">
<div class="paragraph"><p>This command uses the <code>diff.color.*</code> and <code>pager.range-diff</code> settings
@@ -1014,7 +1032,7 @@ found in this case will look like this:</p></div>
<div id="footer">
<div id="footer-text">
Last updated
- 2018-08-20 13:12:02 PDT
+ 2018-11-18 21:41:21 JST
</div>
</div>
</body>