1 files changed, 10 insertions, 6 deletions

diff --git a/git-init.html b/git-init.html
index 743f0cf01..dd7e1f351 100644
--- a/git-init.html
+++ b/git-init.html
@@ -809,13 +809,17 @@ current working directory.
 Specify the given object format (hash algorithm) for the repository.  The valid

 values are <em>sha1</em> and (if enabled) <em>sha256</em>.  <em>sha1</em> is the default.

 </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 class="dlist"><dl>

 <dt class="hdlist1">

 --template=&lt;template-directory&gt;

 </dt>