← Back to branch summary

~ubuntu-branches/ubuntu/intrepid/git-core/intrepid-updates

« back to all changes in this revision

Viewing changes to Documentation/git-pack-refs.txt

  • Committer: Package Import Robot
  • Author(s): Gerrit Pape
  • Date: 2007-04-22 13:31:05 UTC
  • mfrom: (1.1.14)
  • Revision ID: package-import@ubuntu.com-20070422133105-tkmhz328g2p0epz1
Tags: 1:1.5.1.2-1
* new upstream point release.
* debian/changelog.upstream: upstream changes taken from mailing list
  announcement.

Show diffs side-by-side

added added

removed removed

Lines of Context:
Documentation/git-pack-refs.txt
7
7
 
8
8
SYNOPSIS
9
9
--------
10
 
'git-pack-refs' [--all] [--prune]
 
10
'git-pack-refs' [--all] [--no-prune]
11
11
 
12
12
DESCRIPTION
13
13
-----------
29
29
Subsequent updates to branches always creates new file under
30
30
`$GIT_DIR/refs` hierarchy.
31
31
 
 
32
A recommended practice to deal with a repository with too many
 
33
refs is to pack its refs with `--all --prune` once, and
 
34
occasionally run `git-pack-refs \--prune`.  Tags are by
 
35
definition stationary and are not expected to change.  Branch
 
36
heads will be packed with the initial `pack-refs --all`, but
 
37
only the currently active branch heads will become unpacked,
 
38
and next `pack-refs` (without `--all`) will leave them
 
39
unpacked.
 
40
 
 
41
 
32
42
OPTIONS
33
43
-------
34
44
 
35
45
\--all::
36
46
 
37
 
The command by default packs all tags and leaves branch tips
 
47
The command by default packs all tags and refs that are already
 
48
packed, and leaves other refs
38
49
alone.  This is because branches are expected to be actively
39
50
developed and packing their tips does not help performance.
40
51
This option causes branch tips to be packed as well.  Useful for
41
52
a repository with many branches of historical interests.
42
53
 
43
 
\--prune::
44
 
 
45
 
After packing the refs, remove loose refs under `$GIT_DIR/refs`
46
 
hierarchy.  This should probably become default.
 
54
\--no-prune::
 
55
 
 
56
The command usually removes loose refs under `$GIT_DIR/refs`
 
57
hierarchy after packing them.  This option tells it not to.
 
58
 
47
59
 
48
60
Author
49
61
------