The following commit has been merged in the master branch:
commit 695a94799dc54f03b2f535b85bb1d60bb3f30f02
Author: Raphaël Hertzog <[email protected]>
Date: Sun Mar 28 18:04:17 2010 +0200
dpkg-source(1): document more error messages and warnings
diff --git a/man/dpkg-source.1 b/man/dpkg-source.1
index 3aed42d..b81ae9d 100644
--- a/man/dpkg-source.1
+++ b/man/dpkg-source.1
@@ -543,7 +543,27 @@ you should usually pick one of the newer formats ("3.0
(quilt)", "3.0
(native)") but \fBdpkg-source\fP will not do this automatically for you.
If you want to continue using the old format, you should be explicit about
it and put "1.0" in \fBdebian/source/format\fP.
-
+.SS the diff modifies the following upstream files
+When using source format "1.0" it is usually a bad idea to modify
+upstream files directly as the changes end up hidden and mostly
+undocumented in the .diff.gz file. Instead you should store your changes
+as patches in the debian directory and apply them at build-time. To avoid
+this complexity you can also use the format "3.0 (quilt)" that offers this
+natively.
+.SS cannot represent change to \fIfile\fP
+Changes to upstream sources are usually stored with patch files, but not
+all changes can be represented with patches: they can only alter the
+content of plain text files. If you try replacing a file with something of
+a different type (for example replacing a plain file with a symlink or a
+directory), you will get this error message.
+.SS newly created empty file \fIfile\fB will not be represented in diff
+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
+.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
+of that fact.
.SH FILE FORMATS
.SS debian/source/format
This file contains on a single line the format that should be used to
@@ -599,7 +619,7 @@ Copyright \(co 1995-1996 Ian Jackson
.br
Copyright \(co 2000 Wichert Akkerman
.br
-Copyright \(co 2008-2009 Rapha\[:e]l Hertzog
+Copyright \(co 2008-2010 Rapha\[:e]l Hertzog
.sp
This is free software; see the GNU General Public Licence version 2 or later
for copying conditions. There is NO WARRANTY.
--
dpkg's main repository
--
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]
