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
