changelog: start 9.14

[dgit.git] / git-debpush.1.pod

diff --git a/git-debpush.1.pod b/git-debpush.1.pod
index 242bf677ffdadfefdf022dc33278f2cb0a946526..3e065ab6dc4cc45e1060d93eebd519d07bb37cd7 100644 (file)
--- a/git-debpush.1.pod
+++ b/git-debpush.1.pod
@@ -109,6 +109,8 @@ You are using git-dpm(1)'s branch format.
 You are using the 'bare debian' branch format, with the upstream
 source in the form of an upstream tag.
 
 You are using the 'bare debian' branch format, with the upstream
 source in the form of an upstream tag.
 

+B<--quilt=baredebian+git> is an alias for B<--quilt=baredebian>.
+

 =item B<--quilt=linear>
 
 You are using the 'manually maintained applied' branch format or
 =item B<--quilt=linear>
 
 You are using the 'manually maintained applied' branch format or


@@ -146,10 +148,6 @@ upload your package.
 
 Just tag, don't push.
 
 
 Just tag, don't push.
 

-=item B<--force>|B<-f>
-
-Ignore the results of all checks designed to prevent broken uploads.
-

 =item B<-u> I<keyid>
 
 Passed on to git-tag(1).
 =item B<-u> I<keyid>
 
 Passed on to git-tag(1).


@@ -182,6 +180,82 @@ git would use if you typed "git push BRANCH".
 What distribution name to embed in the signed tag.  Defaults to
 "debian".
 
 What distribution name to embed in the signed tag.  Defaults to
 "debian".
 

+=item B<--force>|B<-f>
+
+Ignore the results of all checks designed to prevent broken uploads.
+
+=item B<--force>=I<check>[,I<check>] ...
+
+Override individual checks designed to prevent broken uploads.  May be
+specified more than once.
+
+Using B<--force> or B<--force=>I<check> might cause the upload to fail
+at some later point in the process.
+
+Valid values for I<check> are:
+
+=over 4
+
+=item B<suite>
+
+Permit uploading to a different suite than the target of the most
+recent upload made with B<git-debpush> (e.g. when uploading to
+Debian unstable after uploading to Debian experimental).
+
+=item B<upstream-nonancestor>
+
+Ignore the fact that the upstream tag is not an ancestor of the branch
+to be tagged (skipping this check is implied by B<--quilt=baredebian>).
+
+=item B<upstream-nonidentical>
+
+Ignore any differences between the upstream source in the upstream tag
+and the upstream source in the branch to be tagged (this check is only
+run when using B<--quilt=gbp> or B<--quilt=unapplied>).
+
+=item B<patches-applicable>
+
+Ignore any failures of the following two checks:
+
+=over 4
+
+=item
+
+With B<--quilt=gbp>, B<--quilt=unapplied>, B<--quilt=baredebian>,
+B<--quilt=dpm>, and B<--quilt=nofix>, the quilt patches should apply
+cleanly to the upstream source with git-apply(1).
+
+=item
+
+With B<--quilt=dpm> and B<--quilt=nofix>, applying the quilt patches
+to the upstream source should produce exactly the source tree to be
+tagged.
+
+=back
+
+=item B<unreleased>
+
+Permit upload to a suite called UNRELEASED.
+
+=item B<dgit-view>
+
+Ignore apparently pushing the dgit view of a package (as produced by
+B<dgit clone>) to the maintainer branch, where the dgit view and the
+maintainer view of the package are not identical.
+
+=item B<unstitched>
+
+Ignore the fact that the branch to be pushed seems to be a
+git-debrebase(1) branch in an unstitched state (see git-debrebase(5)).
+
+=back
+
+=item B<detached>
+
+Ignore the fact that HEAD is to be tagged, but HEAD is detached (this
+check is only run when B<--branch=HEAD> or no B<--branch> option is
+specified).
+

 =back
 
 =head1 SEE ALSO
 =back
 
 =head1 SEE ALSO