X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=dgit.git;a=blobdiff_plain;f=dgit.7;h=6ad6ecb8e0ff1ba944aa68ba0c8d69f8db529ca7;hp=1931b9ca259e29b91ae06d3e80b6a8cdacb7690f;hb=55efcfb95f9453c6a83f824988a523a26f688ee8;hpb=a1fb6b5478b7189452d1cd2e9098a69fe2db6825 diff --git a/dgit.7 b/dgit.7 index 1931b9ca..6ad6ecb8 100644 --- a/dgit.7 +++ b/dgit.7 @@ -264,7 +264,7 @@ is a patches-applied or patches-unapplied tree. Split view conversions are cached in the ref dgit-intern/quilt-cache. This should not be manipulated directly. -.SH FILES IN THE SOURCE PACKAGE BUT NOT IN GIT - AUTOTOOLS ETC. +.SH FILES IN THE ORIG TARBALL BUT NOT IN GIT - AUTOTOOLS ETC. This section is mainly of interest to maintainers who want to use dgit with their existing git history for the Debian package. @@ -294,14 +294,13 @@ the git repository finds the program just as easy to build as someone who uses the tarball. .TP \(bu -Have separate git branches which do contain the extra files, and after -regenerating the extra files (whenever you would have to anyway), -commit the result onto those branches. -.TP -\(bu -Provide source packages which lack the files you don't want -in git, and arrange for your package build to create them as needed. -This may mean not using upstream source tarballs and makes the Debian +Delete the files from your git branches, +and your Debian source packages, +and carry the deletion as a delta from upstream. +(With `3.0 (quilt)' this means represeting the deletions as patches. +You may need to pass --include-removal to dpkg-source --commit, +or pass corresponding options to other tools.) +This can make the Debian source package less useful for people without Debian build infrastructure. .LP @@ -327,7 +326,7 @@ to delete these files. .LP dpkg-source does not (with any of the commonly used source formats) -represent deletion of files (outside debian/) present in upstream. +represent deletion of binaries (outside debian/) present in upstream. Thus deleting such files in a dpkg-source working tree does not actually result in them being deleted from the source package. Thus