docs: add documentation for extensions.objectFormat

Git fork

Document the extensions.objectFormat config setting. Warn users not to
modify it themselves.

Signed-off-by: brian m. carlson <sandals@crustytoothpaste.net>
Reviewed-by: Eric Sunshine <sunshine@sunshineco.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>

authored by

brian m. carlson and committed by

Junio C Hamano 5 years ago 4feb562f 8a06d56c

+10

2 changed files

expand all

unified split

Documentation

config

extensions.txt

config.txt

Documentation/config.txt

··· 348 348 349 349 include::config/difftool.txt[] 350 350 351 + include::config/extensions.txt[] 352 + 351 353 include::config/fastimport.txt[] 352 354 353 355 include::config/feature.txt[]

Documentation/config/extensions.txt

··· 1 + extensions.objectFormat:: 2 + Specify the hash algorithm to use. The acceptable values are `sha1` and 3 + `sha256`. If not specified, `sha1` is assumed. It is an error to specify 4 + this key unless `core.repositoryFormatVersion` is 1. 5 + + 6 + Note that this setting should only be set by linkgit:git-init[1] or 7 + linkgit:git-clone[1]. Trying to change it after initialization will not 8 + work and will produce hard-to-diagnose issues.