mirror/ git
1
0
Fork 0
mirror of https://github.com/git/git.git synced 2024-06-08 17:06:11 +02:00
Code

doc: sha256 is no longer experimental 

Remove scary wording that basically stops people using sha256
repositories not because of interoperability issues with sha1
repositories, but from fear that their work will suddenly become
incompatible in some future version of git.

We should be clear that currently sha256 repositories will not work with
sha1 repositories but stop the scary words.

Signed-off-by: Adam Majer <adamm@zombino.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
Adam Majer 2023-07-31 15:42:02 +02:00 committed by Junio C Hamano
parent cba07a324d
commit 8e42eb0e9a
2 changed files with 11 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
Documentation/git.txt
View File

@ -553,8 +553,8 @@ double-quotes and respecting backslash escapes. E.g., the value
If this variable is set, the default hash algorithm for new If this variable is set, the default hash algorithm for new
repositories will be set to this value. This value is repositories will be set to this value. This value is
ignored when cloning and the setting of the remote repository ignored when cloning and the setting of the remote repository
is always used. The default is "sha1". THIS VARIABLE IS is always used. The default is "sha1".
EXPERIMENTAL! See `--object-format` in linkgit:git-init[1]. See `--object-format` in linkgit:git-init[1].
Git Commits Git Commits
~~~~~~~~~~~ ~~~~~~~~~~~

15
Documentation/object-format-disclaimer.txt
View File

@ -1,6 +1,9 @@
THIS OPTION IS EXPERIMENTAL! SHA-256 support is experimental and still Note: At present, there is no interoperability between SHA-256
in an early stage. A SHA-256 repository will in general not be able to repositories and SHA-1 repositories.
share work with "regular" SHA-1 repositories. It should be assumed
that, e.g., Git internal file formats in relation to SHA-256 Historically, we warned that SHA-256 repositories may later need
repositories may change in backwards-incompatible ways. Only use backward incompatible changes when we introduce such interoperability
`--object-format=sha256` for testing purposes. 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's Git will be usable by future versions of Git
without data loss.