The following commit has been merged in the master branch:
commit 5406f5e54de2db2e00de5341062e3dde995e9cf0
Author: Eric S. Raymond <[email protected]>
Date: Tue Jun 18 16:29:52 2013 +0200
man: Fix formatting problems with list syntax
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.
Signed-off-by: Guillem Jover <[email protected]>
diff --git a/man/dpkg-source.1 b/man/dpkg-source.1
index 87b66d6..4da49d9 100644
--- a/man/dpkg-source.1
+++ b/man/dpkg-source.1
@@ -280,9 +280,8 @@ extracting the original tarball in a separate ".orig"
directory and
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
@@ -299,6 +298,7 @@ will not overwrite existing tarfiles or directories. If
this is
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
@@ -373,9 +373,8 @@ outside of the debian sub-directory. This option is not
allowed in
\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
@@ -701,6 +700,9 @@ directory), you will get this error message.
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
@@ -742,8 +744,7 @@ Exactly like \fBdebian/source/options\fP except that the
file is not
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/local\-patch\-header and debian/source/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.
diff --git a/man/dpkg.1 b/man/dpkg.1
index 8e3d705..c1bdd32 100644
--- a/man/dpkg.1
+++ b/man/dpkg.1
@@ -743,18 +743,16 @@ useful if it's lost or corrupted due to filesystems
troubles.
.P
The following files are components of a binary package. See \fBdeb\fP(5)
for more information about them:
-.TP
+.RS
+.nf
.I control
-.TP
.I conffiles
-.TP
.I preinst
-.TP
.I postinst
-.TP
.I prerm
-.TP
.I postrm
+.fi
+.RE
.
.SH BUGS
\fB\-\-no\-act\fP usually gives less information than might be helpful.
--
dpkg's main repository
--
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]
