.\" generated with Ronn-NG/v0.9.1
.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
.TH "GIT\-FEATURE" "1" "November 2023" "" "Git Extras"
.SH "NAME"
\fBgit\-feature\fR \- Create/Merge feature branch
.SH "SYNOPSIS"
.TS
allbox;
\fBgit\-feature\fR [\-a	\-\-alias \fIPREFIX\fR] [\-s	\-\-separator \fISEPARATOR\fR] [\-r	\-\-remote [REMOTE_NAME]] [\-\-from START_POINT] \fINAME\fR\|\.\|\.\|\.
.TE
.TS
allbox;
\fBgit\-feature\fR [\-a	\-\-alias \fIPREFIX\fR] [\-s	\-\-separator \fISEPARATOR\fR] finish [\-\-squash] \fINAME\fR\|\.\|\.\|\.
.TE
.SH "DESCRIPTION"
Create or merge the given feature branch\. The feature branch name is made from the \fIPREFIX\fR, the \fISEPARATOR\fR, and the \fINAME\fR joined together\.
.P
The default \fIPREFIX\fR is \fBfeature\fR and \fISEPARATOR\fR is \fB/\fR, which can be changed (see OPTIONS and GIT CONFIG for details)\.
.P
The branch \fINAME\fR may be specified as multiple words which will be joined with \fB\-\fR\. If the branch name contains the word \fBfinish\fR or is another OPTION, \fB\-\-\fR should be passed to stop OPTION parsing\. See the EXAMPLES for details\.
.SH "OPTIONS"
.TP
\fB\-a\fR \fIPREFIX\fR, \fB\-\-alias\fR \fIPREFIX\fR:

.TP
\fB\-s\fR \fISEPARATOR\fR, \fB\-\-separator\fR \fISEPARATOR\fR:

.TP
\fB\-r\fR [REMOTE_NAME], \fB\-\-remote\fR [REMOTE_NAME]:

.TP
\fB\-\-from\fR START_POINT:

.TP
\fBfinish\fR:

.TP
\fB\-\-squash\fR:

.TP
\fINAME\fR:

.SH "GIT CONFIG"
You can configure the default branch prefix and separator via git config options\.
.TP
\fBgit\-extras\.feature\.prefix\fR:

.TP
\fBgit\-extras\.feature\.separator\fR:

.SH "EXAMPLES"
.TP
Start a new feature:

.TP
Finish a feature with \-\-no\-ff merge:

.TP
Finish a feature with \-\-squash merge:

.TP
Publish a feature upstream:

.TP
Use custom branch prefix:

.TP
Use custom branch separator:

.TP
Use custom branch prefix and separator from git config with multiple words:

.TP
Use a \fBgit\-feature\fR option or the \fBfinish\fR command as part of a branch name:

.SH "AUTHOR"
Written by Jesús Espino <\fIjespinog@gmail\.com\fR>
.br
Modified by Mark Pitman <\fImark\.pitman@gmail\.com\fR>
.br
Modified by Carlos Prado <\fIcarlos\.prado@cpradog\.com\fR>
.br
Modified by Austin Ziegler <\fIhalostatue@gmail\.com\fR>
.SH "REPORTING BUGS"
<\fIhttps://github\.com/tj/git\-extras/issues\fR>
.SH "SEE ALSO"
<\fIhttps://github\.com/tj/git\-extras\fR>, git\-create\-branch(1), git\-delete\-branch(1)