X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=dgit.1;h=1bf4a2c767345d6a2036379993edccc5947e69ce;hb=625519607d0e5552d0e0372fc833e9def2f219c5;hp=88691496699a98de7fb0156e41adb4916aed4619;hpb=a738f98cb36e7f1dfe995d16426c475eced61ee2;p=dgit.git diff --git a/dgit.1 b/dgit.1 index 88691496..1bf4a2c7 100644 --- a/dgit.1 +++ b/dgit.1 @@ -30,6 +30,10 @@ dgit \- git integration with the Debian archive .B dgit allows you to treat the Debian archive as if it were a git repository. +Conversely, +it allows Debian to publish the source of its packages +as git branches, in a format which is directly useable +by ordinary people. This is the command line reference. Please read the tutorial(s): @@ -343,6 +347,13 @@ as actually being used on the dgit git server, as a git tree. Prints the url used by dgit clone-dgit-repos-server. This is hopefully suitable for use as a git remote url. It may not be useable in a browser. +.TP +.BI "dgit print-dpkg-source-ignores" +Prints the -i and -I arguments which must be passed to dpkg-souce +to cause it to exclude exactly the .git diredcory +and nothing else. +The separate arguments are unquoted, separated by spaces, +and do not contain spaces. .SH OPTIONS .TP .BR --dry-run " | " -n @@ -554,6 +565,17 @@ Declare that you are deliberately rewinding history. When pushing to Debian, use this when you are making a renewed upload of an entirely new source package whose previous version was not accepted for release from NEW because of problems with copyright or redistributibility. + +In split view quilt modes, +this also prevents the construction by dgit of a pseudomerge +to make the dgit view fast forwarding. +Normally only one of +--overwrite (which creates a suitable pseudomerge) +and +--deliberately-not-fast-forward +(which suppresses the pseudomerge and the fast forward checks) +should be needed; +--overwrite is usually better. .TP .BR --deliberately-include-questionable-history Declare that you are deliberately including, in the git history of @@ -1024,6 +1046,12 @@ Whether to setup a merge driver which uses dpkg-mergechangelogs for debian/changelog. True by default. Ignored for dgit setup-mergechangelogs, which does it anyway. .TP +.BI dgit-distro. distro .setup-gitattributes +Whether to configure .git/info/attributes +to suppress checkin/checkout file content transformations +in new git trees. +True by default. Ignored for dgit setup-gitattributes, which does it anyway. +.TP .BI dgit-distro. distro .cmd- cmd Program to use instead of .IR cmd .