Documentation / git-repack.txton commit gitweb: prepare for repositories with packed refs. (2172ce4)
   1git-repack(1)
   2=============
   3
   4NAME
   5----
   6git-repack - Script used to pack a repository from a collection of
   7objects into pack files.
   8
   9
  10SYNOPSIS
  11--------
  12'git-repack' [-a] [-d] [-f] [-l] [-n] [-q] [--window=N] [--depth=N]
  13
  14DESCRIPTION
  15-----------
  16
  17This script is used to combine all objects that do not currently
  18reside in a "pack", into a pack.
  19
  20A pack is a collection of objects, individually compressed, with
  21delta compression applied, stored in a single file, with an
  22associated index file.
  23
  24Packs are used to reduce the load on mirror systems, backup
  25engines, disk storage, etc.
  26
  27OPTIONS
  28-------
  29
  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'.
  37
  38-d::
  39        After packing, if the newly created packs make some
  40        existing packs redundant, remove the redundant packs.
  41        Also runs gitlink:git-prune-packed[1].
  42
  43-l::
  44        Pass the `--local` option to `git pack-objects`, see
  45        gitlink:git-pack-objects[1].
  46
  47-f::
  48        Pass the `--no-reuse-delta` option to `git pack-objects`, see
  49        gitlink:git-pack-objects[1].
  50
  51-q::
  52        Pass the `-q` option to `git pack-objects`, see
  53        gitlink:git-pack-objects[1].
  54
  55-n::
  56        Do not update the server information with
  57        `git update-server-info`.
  58
  59--window=[N], --depth=[N]::
  60        These two options affects how the objects contained in the pack are
  61        stored using delta compression. The objects are first internally
  62        sorted by type, size and optionally names and compared against the
  63        other objects within `--window` to see if using delta compression saves
  64        space. `--depth` limits the maximum delta depth; making it too deep
  65        affects the performance on the unpacker side, because delta data needs
  66        to be applied that many times to get to the necessary object.
  67
  68
  69Author
  70------
  71Written by Linus Torvalds <torvalds@osdl.org>
  72
  73Documentation
  74--------------
  75Documentation by Ryan Anderson <ryan@michonline.com>
  76
  77See Also
  78--------
  79gitlink:git-pack-objects[1]
  80gitlink:git-prune-packed[1]
  81
  82GIT
  83---
  84Part of the gitlink:git[7] suite
  85