chiark / gitweb /
git-debrebase(5): Move TERMINOLOGY earlier
authorIan Jackson <ijackson@chiark.greenend.org.uk>
Sat, 14 Apr 2018 12:58:42 +0000 (13:58 +0100)
committerIan Jackson <ijackson@chiark.greenend.org.uk>
Sat, 16 Jun 2018 15:07:00 +0000 (16:07 +0100)
As suggested by Sean.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
git-debrebase.5.pod

index b9abba0..f749f62 100644 (file)
@@ -27,6 +27,58 @@ provided by your upstream.
 However, of git-debrebase in Debian does not make anything harder for
 derivatives, and it can make some things easier.
 
+=head1 TERMINOLOGY
+
+=over
+
+=item Pseudomerge
+
+A merge which does not actually merge the trees;
+instead, it takes its tree, by construction, from only one parent.
+These are used to make a rewritten history fast forward
+from a previous tip,
+so that it can be pushed and pulled normally.
+Manual construction of pseudomerges can be done with
+C<git merge -s ours>
+but is not normally needed when using git-debrebase.
+
+=item Packaging files
+
+Files in the source tree within B<debian/>,
+excluding anything in B<debian/patches/>.
+
+=item Upstream
+
+The version of the package without Debian's packaging.
+Typically provided by the actual upstream project,
+and sometimes tracked by Debian contributors in a branch C<upstream>.
+
+Upstream contains upstream files,
+but some upstreams also contain packaging files in B<debian/>.
+Any such non-upstream files found in upstream
+are thrown away by git-debrebase
+each time a new upstream version is incorporated.
+
+=item Upstream files
+
+Files in the source tree outside B<debian/>.
+These may include unmodified source from upstream,
+but also files which have been modified or created for Debian.
+
+=item Delta queue
+
+Debian's changes to upstream files:
+a series of git commits.
+
+=item Quilt patches
+
+Files in B<debian/patches/> generated for the benefit of
+dpkg-source's 3.0 (quilt) .dsc source package format.
+Not used, often deleted, and regenerated when needed,
+by git-debrebase.
+
+=back
+
 =head1 DIAGRAM
 
            ------/--A!----/--B3!--%--/--> interchange view
@@ -432,58 +484,6 @@ The C<split mixed commit> and C<convert dgit import>
 tags are added to the pre-existing commit message,
 when git-debrebase rewrites the commit.
 
-=head1 TERMINOLOGY
-
-=over
-
-=item Pseudomerge
-
-A merge which does not actually merge the trees;
-instead, it takes its tree, by construction, from only one parent.
-These are used to make a rewritten history fast forward
-from a previous tip,
-so that it can be pushed and pulled normally.
-Manual construction of pseudomerges can be done with
-C<git merge -s ours>
-but is not normally needed when using git-debrebase.
-
-=item Packaging files
-
-Files in the source tree within B<debian/>,
-excluding anything in B<debian/patches/>.
-
-=item Upstream
-
-The version of the package without Debian's packaging.
-Typically provided by the actual upstream project,
-and sometimes tracked by Debian contributors in a branch C<upstream>.
-
-Upstream contains upstream files,
-but some upstreams also contain packaging files in B<debian/>.
-Any such non-upstream files found in upstream
-are thrown away by git-debrebase
-each time a new upstream version is incorporated.
-
-=item Upstream files
-
-Files in the source tree outside B<debian/>.
-These may include unmodified source from upstream,
-but also files which have been modified or created for Debian.
-
-=item Delta queue
-
-Debian's changes to upstream files:
-a series of git commits.
-
-=item Quilt patches
-
-Files in B<debian/patches/> generated for the benefit of
-dpkg-source's 3.0 (quilt) .dsc source package format.
-Not used, often deleted, and regenerated when needed,
-by git-debrebase.
-
-=back
-
 =head1 APPENDIX - DGIT IMPORT HANDLING
 
 Consider a non-dgit NMU followed by a dgit NMU: