summaryrefslogtreecommitdiff
path: root/dgit.1
diff options
context:
space:
mode:
authorIan Jackson <ijackson@chiark.greenend.org.uk>2013-10-28 02:29:03 +0000
committerIan Jackson <ijackson@chiark.greenend.org.uk>2013-10-28 02:29:03 +0000
commita78bf8c39cf81580dab3cfed267203c1ec53952e (patch)
tree73cc29e6975f189c3f4ac04ad9ca84dd875dd442 /dgit.1
parent8827dd24808a199156a58276db82b928c3804783 (diff)
manpage: Make discussion of --existing-package less scary. The default archive access method no longer needs it. Closes:#720171.
Diffstat (limited to 'dgit.1')
-rw-r--r--dgit.111
1 files changed, 4 insertions, 7 deletions
diff --git a/dgit.1 b/dgit.1
index 5c171ed..7e74d5b 100644
--- a/dgit.1
+++ b/dgit.1
@@ -361,13 +361,14 @@ filename suggests it is for the right package and version - or,
if there is a _multi.changes file, dgit uses that.
.TP
.BI --existing-package= package
-dgit push needs to canonicalise the suite name. But currently
-there is no way to ask the archive to do this without knowing the
+dgit push needs to canonicalise the suite name. Sometimes, dgit
+lacks a way to ask the archive to do this without knowing the
name of an existing package. Without --new we can just use the
package we are trying to push. But with --new that will not work, so
we guess
.B dpkg
-or use the value of this option.
+or use the value of this option. This option is not needed with the
+default mechanisms for accessing the archive.
.TP
.BR -h | --help
Print a usage summary.
@@ -646,10 +647,6 @@ We should be using some kind of vhost/vpath setup for the git repos on
alioth, so that they can be moved later if and when this turns out to
be a good idea.
-The method of canonicalising suite names is bizarre. See the
-.B --existing-package
-option for one of the implications.
-
dgit push should perhaps do `git push origin', or something similar,
by default.