|author||Sean Whitton <email@example.com>||2018-04-18 14:29:24 -0700|
|committer||Sean Whitton <firstname.lastname@example.org>||2018-04-19 09:43:51 -0700|
dgit-maint-debrebase(7): first commit to new package must introduce debian/ and nothing else
Signed-off-by: Sean Whitton <email@example.com>
1 files changed, 12 insertions, 4 deletions
diff --git a/dgit-maint-debrebase.7.pod b/dgit-maint-debrebase.7.pod
index bdfdc8b..6c0cf17 100644
@@ -92,9 +92,12 @@ something like this:
-Now go ahead and Debianise your package. Just make commits on the
-master branch, adding things in the I<debian/> directory, or patching
-the upstream source.
+Now go ahead and Debianise your package. Make commits on the master
+branch, adding things in the I<debian/> directory, or patching the
+upstream source. For technical reasons, B<it is essential that your
+first commit introduces the debian/ directory containing at least one
+file, and does nothing else.> In other words, make a commit
+introducing I<debian/> before patching the upstream source.
Finally, you need an orig tarball:
@@ -189,7 +192,12 @@ it somewhere. The usual choice is B<salsa.debian.org>:
You are now ready to proceed as above, making commits to the
-I<debian/> directory and to the upstream source.
+I<debian/> directory and to the upstream source. As above, for
+technical reasons, B<it is essential that your first commit introduces
+the debian/ directory containing at least one file, and does nothing
+else.> In other words, make a commit introducing I<debian/> before
+patching the upstream source.
=head1 CONVERTING AN EXISTING PACKAGE