commit - 02eeca3a32a73e40e2d0ccff926f43e1cde22785
commit + 520f13aaa0a99266c9e80b9e147b92c5fea4879b
blob - 589df95695cc7e4162c6e2d0f8d3a9554bf4105b
blob + 4a87b9de36bae617e29bc256df50df5137f28702
--- gotadmin/gotadmin.1
+++ gotadmin/gotadmin.1
reached via any reference in the entire
.Pa refs/
namespace.
+Objects will usually become unreferenced as a result of deleting
+branches or tags with
+.Cm got branch -d
+or
+.Cm got tag -d .
+Deleting arbitrary references with
+.Cm got ref -d
+may also leave unreferenced objects behind.
.Pp
Loose objects are stored as individual files beneath the repository's
.Pa objects/
redundant copies will be purged.
If all the objects of a pack file are present in other pack files,
the redundant pack file will be purged.
-.Pp
-For compatibility with Git, if a file with the extension
-.Pa .keep
-exists and corresponds to a pack file with the extension
-.Pa .pack
-then this pack file will not be removed.
-.Pp
-Objects will usually become unreferenced as a result of deleting
-branches or tags with
-.Cm got branch -d
-or
-.Cm got tag -d .
-Deleting arbitrary references with
-.Cm got ref -d
-may also leave unreferenced objects behind.
-.Pp
Pack files will usually become redundant as a result of repacking the
repository with
.Nm
or
.Cm got ref -d .
.Pp
+The
+.Dq preciousObjects
+Git extension is intended to prevent the removal of objects from a repository.
+.Cm gotadmin cleanup
+will refuse to operate on repositories where this extension is active.
+.Pp
+For compatibility with Git, if a file with the extension
+.Pa .keep
+exists and corresponds to a pack file with the extension
+.Pa .pack
+then this pack file will not be removed.
+.Pp
Some Git repositories contain pack index files which lack a corresponding
pack file, which is an inconsistent repository state.
In such cases,
files can be removed with
.Cm gotadmin cleanup -p .
.Pp
-The
-.Dq preciousObjects
-Git extension is intended to prevent the removal of objects from a repository.
-.Cm gotadmin cleanup
-will refuse to operate on repositories where this extension is active.
-.Pp
The options for
.Cm gotadmin cleanup
are as follows: