man: Move BUGS sections before EXAMPLES and SEE ALSO sections

debian/changelog

@@ -13,6 +13,7 @@ dpkg (1.17.0) UNRELEASED; urgency=low
     - Do not use “header” when “format” or “field” is meant.
     - Move dangers of installing via dpkg-deb from BUGS to a NOTES section.
     - Remove BUGS sections containing obvious or misplaced information.
+    - Move BUGS sections before EXAMPLES and SEE ALSO sections.
   * Use colon instead of dot for user:group in dpkg debug output.
   * Remove support for obsolete DM-Upload-Allowed from Dpkg::Vendor::Debian.
   * Fix update-alternatives to use the current alternative link as the first

man/dpkg-name.1

@@ -75,6 +75,16 @@ Show the usage message and exit.
 .BR \-v ", " \-\-version
 Show the version and exit.
 .
+.SH BUGS
+Some packages don't follow the name structure
+.IB package _ version _ architecture .deb\fR.\fP
+Packages renamed by dpkg\-name
+will follow this structure. Generally this will have no impact on how
+packages are installed by
+.BR dselect (1)/ dpkg (1),
+but other installation tools
+might depend on this naming structure.
+.
 .SH EXAMPLES
 .TP
 .B dpkg\-name bar\-foo.deb
@@ -96,16 +106,6 @@ don't come with section information.
 .B dpkg\-deb \-\-build debian\-tmp && dpkg\-name \-o \-s .. debian\-tmp.deb
 This can be used when building new packages.
 .
-.SH BUGS
-Some packages don't follow the name structure
-.IB package _ version _ architecture .deb\fR.\fP
-Packages renamed by dpkg\-name
-will follow this structure. Generally this will have no impact on how
-packages are installed by
-.BR dselect (1)/ dpkg (1),
-but other installation tools
-might depend on this naming structure.
-.
 .SH SEE ALSO
 .BR deb (5),
 .BR deb\-control (5),

man/dpkg-split.1

@@ -213,13 +213,6 @@ Some kind of trouble happened, such as a system
 call failure, a file that looked like a package part file but was
 corrupted, a usage error or some other problem.
 .
-.SH BUGS
-Full details of the packages in the queue are impossible to get
-without digging into the queue directory yourself.
-
-There is no easy way to test whether a file that may be a binary
-package part is one.
-.
 .SH FILES
 .TP
 .I /var/lib/dpkg/parts
@@ -231,6 +224,13 @@ The filenames used in this directory are in a format internal to
 and are unlikely to be useful to other programs, and in any case the
 filename format should not be relied upon.
 .
+.SH BUGS
+Full details of the packages in the queue are impossible to get
+without digging into the queue directory yourself.
+
+There is no easy way to test whether a file that may be a binary
+package part is one.
+.
 .SH SEE ALSO
 .BR deb (5),
 .BR deb\-control (5),

man/dpkg.1

@@ -760,6 +760,9 @@ architecture the package got built for.
 Defined by \fBdpkg\fP on the maintainer script environment to the
 name of the script running (preinst, postinst, prerm, postrm).
 .
+.SH BUGS
+\fB\-\-no\-act\fP usually gives less information than might be helpful.
+.
 .SH EXAMPLES
 To list installed packages related to the editor \fBvi\fP(1) (note that
 \fBdpkg\-query\fP does not load the available file anymore by default, and
@@ -831,9 +834,6 @@ following packages: \fBapt\fR, \fBaptitude\fR and \fBdebsums\fR.
 and
 \fBdpkg\-reconfigure\fP(8).
 .
-.SH BUGS
-\fB\-\-no\-act\fP usually gives less information than might be helpful.
-.
 .SH AUTHORS
 See \fI/usr/share/doc/dpkg/THANKS\fP for the list of people who have
 contributed to \fBdpkg\fP.