commit 520f13aaa0a99266c9e80b9e147b92c5fea4879b
from: Stefan Sperling <stsp@stsp.name>
via: Thomas Adam <thomas@xteddy.org>
date: Thu Jun 22 13:10:34 2023 UTC

reorder paragraphs in gotadmin.1 cleanup section

All the special cases are now being explained last.

commit - 02eeca3a32a73e40e2d0ccff926f43e1cde22785
commit + 520f13aaa0a99266c9e80b9e147b92c5fea4879b
blob - 589df95695cc7e4162c6e2d0f8d3a9554bf4105b
blob + 4a87b9de36bae617e29bc256df50df5137f28702
--- gotadmin/gotadmin.1
+++ gotadmin/gotadmin.1
@@ -240,6 +240,14 @@ Unreferenced objects are present in the repository but
 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/
@@ -254,22 +262,6 @@ If redundant copies of packed objects exist in loose f
 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
@@ -305,6 +297,18 @@ deleted with
 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,
@@ -315,12 +319,6 @@ If restoring missing pack files is not possible, then 
 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: