chiark / gitweb /
import-dsc: Document new ff checks
authorIan Jackson <ijackson@chiark.greenend.org.uk>
Sun, 23 Oct 2016 19:26:40 +0000 (20:26 +0100)
committerIan Jackson <ijackson@chiark.greenend.org.uk>
Sun, 30 Oct 2016 19:50:47 +0000 (19:50 +0000)
Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
dgit.1

diff --git a/dgit.1 b/dgit.1
index c2541f0..2c583fe 100644 (file)
--- a/dgit.1
+++ b/dgit.1
@@ -240,7 +240,7 @@ other kinds of more exotic history.  If dgit can't find a suitable
 linearisation of your history, by default it will fail, but you can
 ask it to generate a single squashed patch instead.
 .TP
-.BI "dgit import-dsc " ../path/to/.dsc branch
+\fBdgit import-dsc\fR \fI../path/to/.dsc\fR [\fB+\fR|\fB..\fR]branch
 Import a Debian-format source package,
 specified by its .dsc,
 into git,
@@ -259,6 +259,25 @@ into any existing git history.
 
 If
 .I branch
+is prefixed with
+.B +
+then if it already exists, it will be simply ovewritten,
+no matter its existing contents.
+If
+.I branch
+is prefixed with
+.B ..
+then if it already exists
+and dgit actually imports the dsc
+(rather than simply reading the git commit out of the Dgit field),
+dgit will make a pseudomerge
+so that the result is necessarily fast forward
+from the existing branch.
+Otherwise, if branch already exists,
+dgit will stop with an error message.
+
+If
+.I branch
 does not start with refs/, refs/heads/ is prepended.
 The specified branch is unconditionally updated.