.\" generated with Ronn-NG/v0.8.0
.\" http://github.com/apjanke/ronn-ng/tree/0.8.0
.TH "HUB\-PULL\-REQUEST" "1" "March 2019" "GITHUB" "Hub Manual"
.SH "NAME"
\fBhub\-pull\-request\fR \- Create a GitHub pull request\.
.SH "SYNOPSIS"
\fBhub pull\-request\fR [\-focp] [\-b \fIBASE\fR] [\-h \fIHEAD\fR] [\-r \fIREVIEWERS\fR ] [\-a \fIASSIGNEES\fR] [\-M \fIMILESTONE\fR] [\-l \fILABELS\fR]
.br
\fBhub pull\-request\fR \-m \fIMESSAGE\fR [\-\-edit]
.br
\fBhub pull\-request\fR \-F \fIFILE\fR [\-\-edit]
.br
\fBhub pull\-request\fR \-i \fIISSUE\fR
.SH "OPTIONS"
.TP
\-f, \-\-force
Skip the check for unpushed commits\.
.TP
\-m, \-\-message=\fIMESSAGE\fR
The text up to the first blank line in \fIMESSAGE\fR is treated as the pull request title, and the rest is used as pull request description in Markdown format\.
.IP
If multiple \fIMESSAGE\fR options are given, their values are concatenated as separate paragraphs\.
.TP
\-\-no\-edit
Use the message from the first commit on the branch as pull request title and description without opening a text editor\.
.TP
\-F, \-\-file=\fIFILE\fR
Read the pull request title and description from \fIFILE\fR\.
.TP
\-e, \-\-edit
Further edit the contents of \fIFILE\fR in a text editor before submitting\.
.TP
\-i, \-\-issue=\fIISSUE\fR
Convert an issue to a pull request\. \fIISSUE\fR may be an issue number or a URL\.
.IP
You can only convert issues that you\fBve opened or that which you have admin rights over\. In most workflows it isn\fRt necessary to convert issues to pull requests; you can simply reference the original issue in the body of the new pull request\.
.TP
\-o, \-\-browse
Open the new pull request in a web browser\.
.TP
\-c, \-\-copy
Put the URL of the new pull request to clipboard instead of printing it\.
.TP
\-p, \-\-push
Push the current branch to \fIHEAD\fR before creating the pull request\.
.TP
\-b, \-\-base=\fIBASE\fR
The base branch in the "[\fIOWNER\fR:]\fIBRANCH\fR" format\. Defaults to the default branch of the upstream repository (usually "master")\.
.IP
See the "CONVENTIONS" section of hub(1) for more information on how hub selects the defaults in case of multiple git remotes\.
.TP
\-h, \-\-head=\fIHEAD\fR
The head branch in "[\fIOWNER\fR:]\fIBRANCH\fR" format\. Defaults to the currently checked out branch\.
.TP
\-r, \-\-reviewer=\fIUSERS\fR
A comma\-separated list of GitHub handles to request a review from\.
.TP
\-a, \-\-assign=\fIUSERS\fR
A comma\-separated list of GitHub handles to assign to this pull request\.
.TP
\-M, \-\-milestone=\fINAME\fR
The milestone name to add to this pull request\. Passing the milestone number is deprecated\.
.TP
\-l, \-\-labels=\fILABELS\fR
Add a comma\-separated list of labels to this pull request\. Labels will be created if they don`t already exist\.
.SH "EXAMPLES"
.nf
$ hub pull\-request
[ opens a text editor for writing title and message ]
[ creates a pull request for the current branch ]

$ hub pull\-request \-\-base OWNER:master \-\-head MYUSER:my\-branch
[ creates a pull request with explicit base and head branches ]

$ hub pull\-request \-\-browse \-m "My title"
[ creates a pull request with the given title and opens it in a browser ]

$ hub pull\-request \-F \- \-\-edit < path/to/message\-template\.md
[ further edit the title and message received on standard input ]
.fi
.SH "CONFIGURATION"
HUB_RETRY_TIMEOUT=\fISECONDS\fR The maximum time to keep retrying after HTTP 422 on \fB\-\-push\fR (default: 9)\.
.SH "SEE ALSO"
hub(1), hub\-merge(1), hub\-checkout(1)