git-publish-branch \- publish a local branch to a remote repository
.SH SYNOPSIS
-\fBgit-publish-branch\fR [-d] [\fIBRANCH\fR] [\fIREPOSITORY\fR]
+\fBgit-publish-branch\fR [-d] [-f] [\fIBRANCH\fR] [\fIREPOSITORY\fR]
.SH "DESCRIPTION"
.PP
\fBgit-publish-branch\fR publishes a local branch to a remote repository. The
selected branch is pushed to the remote repository and the local branch is
-reset as a tracking branch for the new remote branch.
+reset as a tracking branch for the new remote branch. Subsequent calls to
+\fBgit-publish-branch\fR peform fast-forward updates of the remote branch by
+pushing new commits in the local branch.
If the -d option is specified, the branch is removed from the remote repository
and the local branch is unset as its tracking branch.
+If the -f option is specified, allows a non-fast forward update of the remote
+branch, as supported by adding a '+' to the refspec on a git push command.
+BE CAREFUL, as this command will lose history on the remote branch. The -f
+option is only suitable for pushing topic or temporary branches that are
+periodically rebased, and other users of the branch are aware of the
+consequences.
+
.SH "OPTIONS"
.TP
-d
-Include this switch to delete (unpublish) a branch.
+Include this switch to delete (unpublish) a remote branch.
+
+-f
+Force a non-fast-forward update of the remote branch.
.TP
\fIBRANCH\fR