|author||Ian Jackson <firstname.lastname@example.org>||2016-10-23 19:29:46 +0100|
|committer||Ian Jackson <email@example.com>||2016-10-30 19:50:47 +0000|
import dsc: Documentation
Signed-off-by: Ian Jackson <firstname.lastname@example.org>
2 files changed, 35 insertions, 0 deletions
diff --git a/debian/changelog b/debian/changelog
index 4d553f6..bcd50b0 100644
@@ -4,6 +4,7 @@ dgit (2.9~) unstable; urgency=low
* During push, automatically calculate which .origs are required,
so user never needs [--ch:]-sa or [--ch:]-sd. Closes:#829116.
* Properly look for .origs etc. in .., fetching them less often.
+ * New import-dsc feature.
@@ -240,6 +240,33 @@ 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.
+.BI "dgit import-dsc " ../path/to/.dsc branch
+Import a Debian-format source package,
+specified by its .dsc,
+the way dgit fetch would do.
+This does about half the work of dgit fetch:
+it will convert the .dsc into a new, orphan git branch.
+Since dgit has no access to a corresponding source package archive
+or knowledge of the history
+it does not consider whether this version is newer
+than any previous import
+or corresponding git branches;
+and it therefore does not
+make a pseudomerge to bind the import
+into any existing git history.
+does not start with refs/, refs/heads/ is prepended.
+The specified branch is unconditionally updated.
+If the specified .dsc contains a Dgit field,
+dgit will simply make a branch of that commit.
+If you cannot manage to find that commit anywhere,
.B dgit version
Prints version information and exits.
@@ -737,6 +764,13 @@ These options are provided as an escape hatch,
in case dgit is confused.
(They might also be useful for testing error cases.)
+Tell dgit import-dsc to treat a .dsc with a Dgit field
+like one without it.
+The result is a fresh import,
+discarding the git history
+that the person who pushed that .dsc was working with.
Carry on even if
dgit thinks that your git tree contains changes