chiark / gitweb /
dgit-maint-debrebase(7): Avoid some uses of =item
authorSean Whitton <spwhitton@spwhitton.name>
Sun, 26 Aug 2018 16:24:13 +0000 (09:24 -0700)
committerIan Jackson <ijackson@chiark.greenend.org.uk>
Sun, 26 Aug 2018 18:09:42 +0000 (19:09 +0100)
Commands for the user to type into their shell should have empty lines
above and below them; this ensures that.  Admittedly while making the
POD source harder to read.

Signed-off-by: Sean Whitton <spwhitton@spwhitton.name>
dgit-maint-debrebase.7.pod

index 675e2f3b097a31890e268a1c22a55033d55990ca..cc393b579866c4e1762a012a44a390e9cf7ef1da 100644 (file)
@@ -629,23 +629,27 @@ The git history made by git-debrebase can seem complicated.
 Here are some suggestions for helpful invocations of gitk and git.
 They can be adapted for other tools like tig, git log, etc.
 
-=over
+History of package in Debian, disregarding history from upstream:
 
-=item History of package in Debian (disregarding history from upstream):
+=over
 
     % gitk --first-parent
 
 In a laundered branch, the delta queue is at the top.
 
-=item History of the packaging (excluding the delta queue)
+=back
+
+History of the packaging, excluding the delta queue:
 
     % gitk :/debian :!/debian/patches
 
-=item Just the delta queue (ie, Debian's changes to upstream):
+Just the delta queue (i.e. Debian's changes to upstream):
 
     % gitk --first-parent -- :/ :!/debian
 
-=item Full history including old versions of the delta queue:
+Full history including old versions of the delta queue:
+
+=over
 
     % gitk --date-order
 
@@ -654,18 +658,22 @@ The "Declare fast forward" commits you see have an older history
 and a newer history as the other.
 --date-order makes gitk show the delta queues in the right order.
 
-=item Show complete diff since the last upload:
+=back
+
+Complete diff since the last upload:
+
+=over
 
     % git diff dgit/dgit/sid..HEAD -- :/ :!/debian/patches
 (Includes changes to upstream files.)
 
-=item Interdiff of delta queue since last upload, if you really want that:
+=back
+
+Interdiff of delta queue since last upload, if you really want it:
 
     % git debrebase make-patches
     % git diff dgit/dgit/sid..HEAD -- debian/patches
 
-=back
-
 Also of course there is
 
     % git debrebase status