Documentation/gitpacking.txt: initial commit

Introduce a new manual page, gitpacking(7) to collect useful information about advanced packing concepts in Git. In future commits in this series, this manual page will expand to describe the new pseudo-merge bitmaps feature, as well as include examples, relevant configuration bits, use-cases, and so on. Outside of this series, this manual page may absorb similar pieces from other parts of Git's documentation about packing. Signed-off-by: Taylor Blau <me@ttaylorr.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>

Taylor Blau committed May 23, 2024 at 17:26 UTC 0074cc299493ff4567641e9af5492eb4799ca0ef
2 files changed +35
Documentation/Makefile
+1
@@ -51,6 +51,7 @@ MAN7_TXT += gitdiffcore.txt
51 MAN7_TXT += giteveryday.txt
52 MAN7_TXT += gitfaq.txt
53 MAN7_TXT += gitglossary.txt
54 +MAN7_TXT += gitpacking.txt
55 MAN7_TXT += gitnamespaces.txt
56 MAN7_TXT += gitremote-helpers.txt
57 MAN7_TXT += gitrevisions.txt
Documentation/gitpacking.txt new
+34
@@ -0,0 +1,34 @@
1 +gitpacking(7)
2 +=============
3 +
4 +NAME
5 +----
6 +gitpacking - Advanced concepts related to packing in Git
7 +
8 +SYNOPSIS
9 +--------
10 +gitpacking
11 +
12 +DESCRIPTION
13 +-----------
14 +
15 +This document aims to describe some advanced concepts related to packing
16 +in Git.
17 +
18 +Many concepts are currently described scattered between manual pages of
19 +various Git commands, including linkgit:git-pack-objects[1],
20 +linkgit:git-repack[1], and others, as well as linkgit:gitformat-pack[5],
21 +and parts of the `Documentation/technical` tree.
22 +
23 +There are many aspects of packing in Git that are not covered in this
24 +document that instead live in the aforementioned areas. Over time, those
25 +scattered bits may coalesce into this document.
26 +
27 +SEE ALSO
28 +--------
29 +linkgit:git-pack-objects[1]
30 +linkgit:git-repack[1]
31 +
32 +GIT
33 +---
34 +Part of the linkgit:git[1] suite