X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=dgit.git;a=blobdiff_plain;f=dgit.1;h=4ec02a732b35bccf1613232af83e24e6c42b879a;hp=5367c36adc5f4c2ad3e4e4c1f7032f5815eefe88;hb=4723806663cc562af68cb68a9f0c18548942bad8;hpb=1b99def96ddbaec91a0208916f257a1381e446b6 diff --git a/dgit.1 b/dgit.1 index 5367c36a..4ec02a73 100644 --- a/dgit.1 +++ b/dgit.1 @@ -429,6 +429,45 @@ git history, so that your push is a fast forward from the archive. implying a split between the dgit view and the maintainer view, the pseudo-merge will appear only in the dgit view.) .TP +.BR --delayed =\fIdays\fR +Upload to a DELAYED queue. + +.B WARNING: +If the maintainer responds by cancelling +your upload from the queue, +and does not make an upload of their own, +this will not rewind the git branch on the dgit git server. +Other dgit users will then see your push +(with a warning message from dgit) +even though the maintainer wanted to abolish it. +Such users might unwittingly reintroduce your changes. + +If this situation arises, +someone should make a suitable dgit push +to update the contents of dgit-repos +to a version without the controversial changes. +.TP +.BR --dgit-view-save= \fIbranch\fR|\fIref\fR +Specifies that when a split view quilt mode is in operation, +and dgit calculates +(or looks up in its cache) +a dgit view corresponding to your HEAD, +the dgit view will be left in +.IR ref . +The specified ref is unconditionally overwritten, +so don't specify a branch you want to keep. + +This option is effective only with the following operations: +quilt-fixup; push; all builds. +And it is only effective with +--[quilt=]gbp, +--[quilt=]dpm, +--quilt=unpatched. + +If ref does not start with refs/ +it is taken to to be a branch - +i.e. refs/heads/ is prepended. +.TP .BI --deliberately- something Declare that you are deliberately doing .IR something .