Problems in dpkg.1, dpkg-source.1
This is automatically generated email about markup problems in a man
page for which you appear to be responsible. If you are not the right
person or list, please tell me so I can correct my database.
See http://catb.org/~esr/doclifter/bugs.html for details on how and
why these patches were generated. Feel free to email me with any
questions. Note: These patches do not change the modification date of
any manual page. You may wish to do that by hand.
I apologize if this message seems spammy or impersonal. The volume of
markup bugs I am tracking is over five hundred - there is no real
alternative to generating bugmail from a database and template.
--
Eric S. Raymond
Problems with dpkg-source.1:
List syntax error. This means .IP, .TP or .RS/.RE markup is garbled.
Common causes include .TP just before a section header, .TP entries
with tags but no bodies, and mandoc lists with no trailing .El.
These confuse doclifter, and may also mess up stricter man-page
browsers like Xman and Rosetta.
--- dpkg-source.1-unpatched 2013-05-25 08:15:40.812805426 -0400
+++ dpkg-source.1 2013-05-25 08:15:40.456805432 -0400
@@ -279,9 +279,8 @@
regenerating the \fB.diff.gz\fP by comparing the source package
\fIdirectory\fP with the .orig directory.
-.TP
.B Build options (with \-b):
-.PP
+
If a second non-option argument is supplied it should be the name of the
original source directory or tarfile or the empty string if the package is
a Debian-specific one and so has no Debianisation diffs. If no second
@@ -298,6 +297,7 @@
desired then
.BR \-sA ", " \-sP ", " \-sK ", " \-sU " and " \-sR
should be used instead.
+.PP
.TP
.BR \-sk
Specifies to expect the original source as a tarfile, by default
@@ -372,9 +372,8 @@
\fBdebian/source/options\fP but can be used in
\fBdebian/source/local\-options\fP.
-.TP
.B Extract options (with \-x):
-.PP
+
In all cases any existing original source tree will be removed.
.TP
.B \-sp
@@ -699,6 +698,9 @@
Empty files can't be created with patch files. Thus this change is not
recorded in the source package and you are warned about it.
.SS executable mode \fIperms\fB of \fIfile\fB will not be represented in diff
+Patch files do not record permissions of files and thus executable
+permissions are not stored in the source package. This warning reminds you
+of that fact.
.SS special mode \fIperms\fB of \fIfile\fB will not be represented in diff
Patch files do not record permissions of files and thus modified
permissions are not stored in the source package. This warning reminds you
@@ -740,8 +742,7 @@
included in the generated source package. It can be useful to store
a preference tied to the maintainer or to the VCS repository where
the source package is maintained.
-.SS debian/source/local\-patch\-header
-.SS debian/source/patch\-header
+.SS debian/source/patch\-header and debian/source/local\-patch\-header
Free form text that is put on top of the automatic patch generated
in formats "2.0" or "3.0 (quilt)". \fBlocal\-patch\-header\fP is not
included in the generated source package while \fBpatch\-header\fP is.
Problems with dpkg.1:
List syntax error. This means .IP, .TP or .RS/.RE markup is garbled.
Common causes include .TP just before a section header, .TP entries
with tags but no bodies, and mandoc lists with no trailing .El.
These confuse doclifter, and may also mess up stricter man-page
browsers like Xman and Rosetta.
--- dpkg.1-unpatched 2012-08-09 17:25:07.533493975 -0400
+++ dpkg.1 2012-08-09 17:27:06.777491747 -0400
@@ -699,18 +699,18 @@
.P
The following files are components of a binary package. See \fBdeb\fP(5)
for more information about them:
-.TP
-.I control
-.TP
-.I conffiles
-.TP
-.I preinst
-.TP
-.I postinst
-.TP
-.I prerm
-.TP
-.I postrm
+.RS
+.nf
+.ft CW
+control
+conffiles
+preinst
+postinst
+prerm
+postrm
+.ft
+.fi
+.RE
.
.SH ENVIRONMENT
.TP
Reply to: