git: grok 'help' to mean '--help'.
[alt-git.git] / Documentation / git-repack.txt
blob9060fe889724182e5478df72a8b9331f7411601c
1 git-repack(1)
2 =============
4 NAME
5 ----
6 git-repack - Script used to pack a repository from a collection of
7 objects into pack files.
10 SYNOPSIS
11 --------
12 'git-repack' [-a] [-d] [-l] [-n]
14 DESCRIPTION
15 -----------
17 This script is used to combine all objects that do not currently
18 reside in a "pack", into a pack.
20 A pack is a collection of objects, individually compressed, with
21 delta compression applied, stored in a single file, with an
22 associated index file.
24 Packs are used to reduce the load on mirror systems, backup
25 engines, disk storage, etc.
27 OPTIONS
28 -------
30 -a::
31         Instead of incrementally packing the unpacked objects,
32         pack everything available into a single pack.
33         Especially useful when packing a repository that is used
34         for a private development and there no need to worry
35         about people fetching via dumb protocols from it.  Use
36         with '-d'.
38 -d::
39         After packing, if the newly created packs make some
40         existing packs redundant, remove the redundant packs.
42 -l::
43         Pass the `--local` option to `git pack-objects`, see
44         gitlink:git-pack-objects[1].
46 -n::
47         Do not update the server information with
48         `git update-server-info`.
50 Author
51 ------
52 Written by Linus Torvalds <torvalds@osdl.org>
54 Documentation
55 --------------
56 Documentation by Ryan Anderson <ryan@michonline.com>
58 See-Also
59 --------
60 gitlink:git-pack-objects[1]
61 gitlink:git-prune-packed[1]
63 GIT
64 ---
65 Part of the gitlink:git[7] suite