summaryrefslogtreecommitdiffstats
path: root/git-show-index.html
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2023-08-07 14:10:43 -0700
committerJunio C Hamano <gitster@pobox.com>2023-08-07 14:10:43 -0700
commitc237f228006138eb7f67f07a4022c7d1d2472d1b (patch)
treec16b5543f10d6e8487ddb8d94fae38a0fe682db9 /git-show-index.html
parent62908fd797899ccb5145cff3b16cc206d83b9b3f (diff)
downloadgit-htmldocs-c237f228006138eb7f67f07a4022c7d1d2472d1b.tar.gz
Autogenerated HTML docs for v2.42.0-rc0-25-ga82fb6
Diffstat (limited to 'git-show-index.html')
-rw-r--r--git-show-index.html14
1 files changed, 8 insertions, 6 deletions
diff --git a/git-show-index.html b/git-show-index.html
index 8fae1c11a..4e2a48cde 100644
--- a/git-show-index.html
+++ b/git-show-index.html
@@ -803,14 +803,16 @@ index file itself, it&#8217;s both faster and more flexible.</p></div>
algorithm for the current repository (set by <code>extensions.objectFormat</code>), or
<em>sha1</em> if no value is set or outside a repository..
</p>
-<div class="paragraph"><p>THIS OPTION IS EXPERIMENTAL! SHA-256 support is experimental and still
-in an early stage. A SHA-256 repository will in general not be able to
-share work with "regular" SHA-1 repositories. It should be assumed
-that, e.g., Git internal file formats in relation to SHA-256
-repositories may change in backwards-incompatible ways. Only use
-<code>--object-format=sha256</code> for testing purposes.</p></div>
+<div class="paragraph"><p>Note: At present, there is no interoperability between SHA-256
+repositories and SHA-1 repositories.</p></div>
</dd>
</dl></div>
+<div class="paragraph"><p>Historically, we warned that SHA-256 repositories may later need
+backward incompatible changes when we introduce such interoperability
+features. Today, we only expect compatible changes. Furthermore, if such
+changes prove to be necessary, it can be expected that SHA-256 repositories
+created with today&#8217;s Git will be usable by future versions of Git
+without data loss.</p></div>
</div>
</div>
<div class="sect1">