git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH 0/4] Fix doc default hash algorithm in WITH_BREAKING_CHANGES mode

From
brian m. carlson <sandals@crustytoothpaste.net>
Date
Dec 2, 2025, 01:46 UTC
Message-ID
<20251202014605.52110-1-sandals@crustytoothpaste.net>

When WITH_BREAKING_CHANGES is defined, the default hash algorithm is not SHA-1, but SHA-256. However, our documentation was never updated to reflect this, and as a result, we end up misinforming users.

This series fixes four places where we indicate a default hash algorithm in our documentation such that they conditionally say that either SHA-1 or SHA-256 is the default, based on the the with-breaking-changes attribute. This both improves accuracy now and also makes it less likely that we'll forget to update these places when we hit Git 3.0.

brian m. carlson (4):
  docs: update git hash algorithm for breaking changes mode
  docs: update index-pack hash algorithm for breaking changes mode
  docs: update init hash algorithm for breaking changes mode
  docs: update show-index hash algorithm for breaking changes mode
 Documentation/git-index-pack.adoc | 14 +++++++++++---
 Documentation/git-init.adoc       |  8 +++++++-
 Documentation/git-show-index.adoc | 14 +++++++++++---
 Documentation/git.adoc            |  8 +++++++-
 4 files changed, 36 insertions(+), 8 deletions(-)
Next: brian m. carlson
Message 1 of 8 in “Fix doc default hash algorithm in WITH_BREAKING_CHANGES mode”
  1. 0/4 Fix doc default hash algorithm in WITH_BREAKING_CHANGES modebrian m. carlson, Dec 2, 2025
  2. 4/4 docs: update show-index hash algorithm for breaking changes modebrian m. carlson, Dec 2, 2025
  3. 1/4 docs: update git hash algorithm for breaking changes modebrian m. carlson, Dec 2, 2025
  4. Junio C HamanoDec 2, 2025
  5. 2/4 docs: update index-pack hash algorithm for breaking changes modebrian m. carlson, Dec 2, 2025
  6. 3/4 docs: update init hash algorithm for breaking changes modebrian m. carlson, Dec 2, 2025
  7. Patrick SteinhardtDec 2, 2025
  8. brian m. carlsonDec 2, 2025

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.