From: Ian Jackson <ijackson@chiark.greenend.org.uk>
Date: Sun, 1 Jul 2018 11:00:07 +0000 (+0100)
Subject: dgit(1): Document as-yet-unwritten `dgit checkout'
X-Git-Tag: archive/debian/5.7~16
X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=commitdiff_plain;h=441a1663d98b29d735e2d9392a5cfc84d7cf00f0;p=dgit.git

dgit(1): Document as-yet-unwritten `dgit checkout'

Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
---

diff --git a/dgit.1 b/dgit.1
index ae084163..d5ef9303 100644
--- a/dgit.1
+++ b/dgit.1
@@ -109,6 +109,22 @@ branch
 .BI remotes/dgit/dgit/ suite
 into the current branch.
 .TP
+\fBdgit checkout\fR \fIsuite\fR
+Checks out the local branch
+.BR dgit/ \fIsuite\fR.
+
+If the branch does not exist,
+dgit checkout creates it,
+and sets it up the same way as dgit clone would.
+In that case, if
+the archive remote tracking branch does not exist,
+dgit checkout will do a dgit fetch first.
+
+NB: dgit checkout will only do a fetch if it has to.
+If you already have the suite branch,
+and want to merge your branch with updates from the archive,
+use dgit pull.
+.TP
 \fBdgit build\fR ...
 Runs
 .B dpkg-buildpackage