multi-pack-index: add format details
authorDerrick Stolee <stolee@gmail.com>
Thu, 12 Jul 2018 19:39:19 +0000 (15:39 -0400)
committerJunio C Hamano <gitster@pobox.com>
Thu, 12 Jul 2018 20:55:02 +0000 (13:55 -0700)
commite0d1bcf82590aea8ee007ab087772f1c82f6890b
treebd6f79b1b75a63a95c9a433fa32f7f513846cd37
parentceab693d1f19b9800958001d074b731a752d6bdd
multi-pack-index: add format details

The multi-pack-index feature generalizes the existing pack-index
feature by indexing objects across multiple pack-files.

Describe the basic file format, using a 12-byte header followed by
a lookup table for a list of "chunks" which will be described later.
The file ends with a footer containing a checksum using the hash
algorithm.

The header allows later versions to create breaking changes by
advancing the version number. We can also change the hash algorithm
using a different version value.

We will add the individual chunk format information as we introduce
the code that writes that information.

Signed-off-by: Derrick Stolee <dstolee@microsoft.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/technical/pack-format.txt