.\"
.TH "git-publish-branch"
.SH NAME
git-publish-branch \- publish a local branch to a remote repository

.SH SYNOPSIS
\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.  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 remote branch.

-f
Force a non-fast-forward update of the remote branch.

.TP
\fIBRANCH\fR
The branch to publish or unpublish.  If not provided, meaning the repository
is also not provided, the branch defaults to the one currently checked out.

.TP
\fIREPOSITORY\fR
The name of the remote repository.  If not provided, the repository remote
defaults to origin.

This manual page was written by David Eriksson <twogood@users.sourceforge.net>.
.SH "SEE ALSO"
git-branch(1) git-checkout(1) git-remote(1)