git/Documentation/technical
Taylor Blau 2bfc24ecf6 Documentation/technical: describe pseudo-merge bitmaps format
Prepare to implement pseudo-merge bitmaps over the next several commits
by first describing the serialization format which will store the new
pseudo-merge bitmaps themselves.

This format is implemented as an optional extension within the bitmap v1
format, making it compatible with previous versions of Git, as well as
the original .bitmap implementation within JGit.

The format is described in detail in the patch contents below, but the
high-level description is as follows:

  - An array of pseudo-merge bitmaps, each containing a pair of EWAH
    bitmaps: one describing the set of pseudo-merge "parents", and
    another describing the set of object(s) reachable from those
    parents.

  - A lookup table to determine which pseudo-merge(s) a given commit
    appears in. An optional extended lookup table follows when there is
    at least one commit which appears in multiple pseudo-merge groups.

  - Trailing metadata, including the number of pseudo-merge(s), number
    of unique parents, the offset within the .bitmap file for the
    pseudo-merge commit lookup table, and the size of the optional
    extension itself.

Signed-off-by: Taylor Blau <me@ttaylorr.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2024-05-24 11:40:41 -07:00
..
.gitignore
api-error-handling.txt api docs: link to html version of api-trace2 2022-09-16 08:39:11 -07:00
api-index-skel.txt documentation: fix singular vs. plural 2023-10-09 12:06:29 -07:00
api-index.sh
api-merge.txt merge-ll: rename from ll-merge 2023-06-21 13:39:54 -07:00
api-parse-options.txt Documentation: clean up various typos in technical docs 2022-09-21 10:28:36 -07:00
api-simple-ipc.txt documentation: add some commas where they are helpful 2023-10-09 12:06:44 -07:00
api-trace2.txt trace2: add global counter mechanism 2022-10-24 12:45:26 -07:00
bitmap-format.txt Documentation/technical: describe pseudo-merge bitmaps format 2024-05-24 11:40:41 -07:00
bundle-uri.txt bundle-uri: drop bundle.flag from design doc 2023-01-31 08:57:48 -08:00
commit-graph.txt documentation: fix typos 2023-10-09 12:06:24 -07:00
directory-rename-detection.txt
hash-function-transition.txt Documentation: render dash correctly 2023-01-23 09:40:14 -08:00
long-running-process-protocol.txt docs: move protocol-related docs to man section 5 2022-08-04 14:12:23 -07:00
multi-pack-index.txt
pack-heuristics.txt
packfile-uri.txt docs: move protocol-related docs to man section 5 2022-08-04 14:12:23 -07:00
parallel-checkout.txt documentation: add missing quotes 2023-10-09 12:06:47 -07:00
partial-clone.txt documentation: add missing article 2023-10-09 12:06:29 -07:00
racy-git.txt documentation: fix singular vs. plural 2023-10-09 12:06:29 -07:00
reftable.txt documentation: add some commas where they are helpful 2023-10-09 12:06:44 -07:00
remembering-renames.txt docs: typofixes 2023-06-12 13:52:51 -07:00
repository-version.txt refs: introduce reftable backend 2024-02-07 08:28:37 -08:00
rerere.txt documentation: remove extraneous words 2023-10-09 12:06:29 -07:00
scalar.txt Documentation/technical: include Scalar technical doc 2022-09-02 10:02:56 -07:00
send-pack-pipeline.txt
shallow.txt
sparse-checkout.txt sparse-checkout.txt: new document with sparse-checkout directions 2022-11-07 18:15:45 -05:00
sparse-index.txt
trivial-merge.txt
unit-tests.txt unit tests: add a project plan document 2023-11-10 08:15:25 +09:00