Skip to content

Commit 5f0e37b

Browse files
committed
doc: GIT_DEFAULT_HASH is and will be ignored during "clone"
The phrasing "is currently ignored" was prone to be misinterpreted as if we were wishing if it were honored. Rephrase it to make it clear that the experimental variable will be ignored. In the longer term, after/when we allow incremental/over-the-wire migration of the object-format, i.e. cloning from an SHA-1 repository to create an SHA-256 repository (or vice versa) and fetching and pushing between them would bidirectionally convert the object format on the fly, it is likely that we would teach a new option "--object-format" to "git clone" to say "you would use whatever object format the origin uses by default, but this time, I am telling you to use this format on our side, doing on-the-fly object format conversion as needed". So it is perfectly OK to ignore the settings of this experimental variable, even after such an extension happens that makes it necessary for us to have a way to create a new repository that uses different object format from the origin repository. Signed-off-by: Junio C Hamano <[email protected]>
1 parent ec58344 commit 5f0e37b

File tree

1 file changed

+3
-3
lines changed

1 file changed

+3
-3
lines changed

Documentation/git.txt

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -552,9 +552,9 @@ double-quotes and respecting backslash escapes. E.g., the value
552552

553553
`GIT_DEFAULT_HASH`::
554554
If this variable is set, the default hash algorithm for new
555-
repositories will be set to this value. This value is currently
556-
ignored when cloning; the setting of the remote repository
557-
is used instead. The default is "sha1". THIS VARIABLE IS
555+
repositories will be set to this value. This value is
556+
ignored when cloning and the setting of the remote repository
557+
is always used. The default is "sha1". THIS VARIABLE IS
558558
EXPERIMENTAL! See `--object-format` in linkgit:git-init[1].
559559

560560
Git Commits

0 commit comments

Comments
 (0)