.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
.\" Instead of manually editing it, you probably should edit the DocBook XML
.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "GIT\-GC" "1" "01/17/2007" "" ""
+.TH "GIT\-GC" "1" "01/22/2007" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.SH "NAME"
git\-gc \- Cleanup unnecessary files and optimize the local repository
.SH "SYNOPSIS"
-\fIgit\-gc\fR
+\fIgit\-gc\fR [\-\-prune]
.SH "DESCRIPTION"
Runs a number of housekeeping tasks within the current repository, such as compressing file revisions (to reduce disk space and increase performance) and removing unreachable objects which may have been created from prior invocations of \fBgit\-add\fR(1).
Users are encouraged to run this task on a regular basis within each repository to maintain good disk space utilization and good operating performance.
+.SH "OPTIONS"
+.TP
+\-\-prune
+Usually git\-gc packs refs, expires old reflog entries, packs loose objects, and removes old \fIrerere\fR records. Removal of unreferenced loose objects is an unsafe operation while other git operations are in progress, so it is not done by default. Pass this option if you want it, and only when you know nobody else is creating new objects in the repository at the same time (e.g. never use this option in a cron script).
.SH "CONFIGURATION"
The optional configuration variable \fIgc.reflogExpire\fR can be set to indicate how long historical entries within each branch's reflog should remain available in this repository. The setting is expressed as a length of time, for example \fI90 days\fR or \fI3 months\fR. It defaults to \fI90 days\fR.
.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
.\" Instead of manually editing it, you probably should edit the DocBook XML
.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "GIT\-PRUNE" "1" "01/21/2007" "" ""
+.TH "GIT\-PRUNE" "1" "01/22/2007" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.SH "NAME"
git\-prune \- Prunes all unreachable objects from the object database
.SH "SYNOPSIS"
-\fIgit\-prune\fR [\-n] [\-\-grace=<time>]
+\fIgit\-prune\fR [\-n] [\-\-] [<head>\&...]
.SH "DESCRIPTION"
This runs git\-fsck\-objects \-\-unreachable using all the refs available in $GIT_DIR/refs, optionally with additional set of objects specified on the command line, and prunes all objects unreachable from any of these head objects from the object database. In addition, it prunes the unpacked objects that are also found in packs by running git prune\-packed.
.SH "OPTIONS"
\-n
Do not remove anything; just report what it would remove.
.TP
-\-\-grace=<time>
-Do not prune loose objects that are younger than the specified time. This gives a grace period to newly created objects from getting pruned.
+\-\-
+Do not interpret any more arguments as options.
+.TP
+<head>\&...
+In addition to objects reachable from any of our references, keep objects reachable from listed <head>s.
+.SH "EXAMPLE"
+To prune objects not used by your repository nor another that borrows from your repository via its .git/objects/info/alternates:
+.sp
+.nf
+$ git prune $(cd ../another && $(git\-rev\-parse \-\-all))
+.fi
.SH "AUTHOR"
Written by Linus Torvalds <torvalds@osdl.org>
.SH "DOCUMENTATION"
.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
.\" Instead of manually editing it, you probably should edit the DocBook XML
.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "GIT" "7" "01/21/2007" "" ""
+.TH "GIT" "7" "01/22/2007" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
projects / git.git / commitdiff