docs: No longer recommend single-debian-patch anywhere

See #1018984.

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>

1 files changed, 9 insertions, 0 deletions

diff --git a/dgit.1 b/dgit.1
index bc5649a..39649c0 100644
--- a/dgit.1
+++ b/dgit.1
@@ -862,6 +862,15 @@ When fixing up source format `3.0 (quilt)' metadata,
 delete all the existing patches, and then
 generate a single patch for all the changes made in git.
 This is not a good idea for an NMU in Debian.
+
+Use this instead of the
+.B single-debian-patch
+dpkg-source format option.
+That dpkg-source option cannot handle certain changes to the tree
+that dpkg-source otherwise permits,
+and in some cases it can generate strange source packages
+that dpkg-source appears to accept
+but which become corrupted when people later try to modify them.
 .TP
 .BR --quilt=nofix
 Check whether source format `3.0 (quilt)' metadata would need fixing