X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=dgit.7;h=d1e5c7ea579309a047ac495e1cef8da3256fd80b;hb=f6f6419eca67882b47632875d2ee7163f4d005c7;hp=8325c06b10aaeed869c49d41345d9e24b4ea4fd3;hpb=af383382f97e6ab687b209e9117fe50dac6d37c8;p=dgit.git diff --git a/dgit.7 b/dgit.7 index 8325c06b..d1e5c7ea 100644 --- a/dgit.7 +++ b/dgit.7 @@ -393,7 +393,7 @@ this problem can occur if you have provided Debian git tooling such as git-debrebase, git-dpm or git-buildpackage with upstream git commit(s) or tag(s) which are not 100% identical to your orig tarball(s). -.SH SPLIT VIEW QUILT MODE +.SH SPLIT VIEW AND SPLITTING QUILT MODES When working with git branches intended for use with the `3.0 (quilt)' source format dgit can automatically convert a suitable @@ -401,21 +401,33 @@ maintainer-provided git branch (in one of a variety of formats) into a dgit branch. -When a split view mode is engaged +When a splitting quilt mode is selected dgit build commands and dgit push will, on each invocation, convert the user's HEAD into the dgit view, so that it can be built and/or uploaded. -dgit push in split view mode will push the dgit view to the dgit +Split view mode can also be enabled explicitly +with +the --split-view command line option +and +the .split-view access configuration key. + +When split view is in operation, +regardless of the quilt mode, +any dgit-generated pseudomerges +and any quilt fixup commits +will appear only in the dgit view. +dgit push +will push the dgit view to the dgit git server. The dgit view is always a descendant of the maintainer view. dgit push will also make a maintainer view tag according to DEP-14 and push that to the dgit git server. -Split view mode must be enabled explicitly +Splitting quilt modes must be enabled explicitly (by the use of the applicable command line options, subcommands, or configuration). This is because it is not possible to reliably tell