X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=dgit.7;h=8325c06b10aaeed869c49d41345d9e24b4ea4fd3;hb=d28467db161d0590469b5f8e1115f84858d66e06;hp=27d0998d8ef5e3bf0d820b4204d94de917c0aea0;hpb=b5332638ab5f8887bf69bc457f06c17c68e45ce2;p=dgit.git diff --git a/dgit.7 b/dgit.7 index 27d0998d..8325c06b 100644 --- a/dgit.7 +++ b/dgit.7 @@ -161,7 +161,7 @@ or to try to upload to it. When using this facility, it is important to always specify the same suites in the same order: -dgit will not be make a coherent fast-forwarding history +dgit will not make a coherent fast-forwarding history view otherwise. The history generated by this feature is not normally suitable @@ -249,6 +249,16 @@ See and .B dgit setup-gitattributes in dgit(1). + +Note that dgit does not disable gitattributes +unless they would actually interfere with your work on dgit branches. +In particular, gitattributes which affect +.B git archive +are not disabled, +so .origs you generate by hand can be wrong. +You should consider using +.B git-deborig (1) +which gets this right, suppressing the attributes. .SH PACKAGE SOURCE FORMATS If you are not the maintainer, you do not need to worry about the source format of the package. You can just make changes as you like @@ -284,7 +294,7 @@ pushing. The only thing you need to know is that dgit build, sbuild, etc., may make new commits on your HEAD. If you're not a quilt user this commit won't contain any changes to files you care about. -Simply commiting to source files +Simply committing to source files (whether in debian/ or not, but not to patches) will result in a branch that dgit quilt-fixup can linearise. Other kinds of changes, @@ -351,7 +361,7 @@ whose tree is identical to o+d/p in all upstream files. In the error message, 696c9bd5..84ae8f96 is the first commit child-parent edge -which cannot be sensibly be +which cannot sensibly be either ignored, or turned into a patch in debian/patches. In this example, this is because it itself changes files in debian/patches, @@ -437,7 +447,7 @@ As the maintainer you therefore have the following options: 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. +(With `3.0 (quilt)' this means representing 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