HUB-PULL-REQUEST(1) | Hub Manual | HUB-PULL-REQUEST(1) |
NAME¶
hub-pull-request - Create a GitHub pull request.SYNOPSIS¶
hub pull-request [-focp] [-b BASE] [-h HEAD] [-r REVIEWERS ] [-a ASSIGNEES] [-M MILESTONE] [-l LABELS]hub pull-request -m MESSAGE [--edit]
hub pull-request -F FILE [--edit]
hub pull-request -i ISSUE
OPTIONS¶
- -f, --force
- Skip the check for unpushed commits.
- -m, --message=MESSAGE
- The text up to the first blank line in MESSAGE is treated as the pull request title, and the rest is used as pull request description in Markdown format.
- If multiple MESSAGE options are given, their values are concatenated as separate paragraphs.
- --no-edit
- Use the message from the first commit on the branch as pull request title and description without opening a text editor.
- -F, --file=FILE
- Read the pull request title and description from FILE.
- -e, --edit
- Further edit the contents of FILE in a text editor before submitting.
- -i, --issue=ISSUE
- Convert an issue to a pull request. ISSUE may be an issue number or a URL.
- You can only convert issues that youve opened or that which you have admin rights over. In most workflows it isnt necessary to convert issues to pull requests; you can simply reference the original issue in the body of the new pull request.
- -o, --browse
- Open the new pull request in a web browser.
- -c, --copy
- Put the URL of the new pull request to clipboard instead of printing it.
- -p, --push
- Push the current branch to HEAD before creating the pull request.
- -b, --base=BASE
- The base branch in the "[OWNER:]BRANCH" format. Defaults to the default branch of the upstream repository (usually "master").
- See the "CONVENTIONS" section of hub(1) for more information on how hub selects the defaults in case of multiple git remotes.
- -h, --head=HEAD
- The head branch in "[OWNER:]BRANCH" format. Defaults to the currently checked out branch.
- -r, --reviewer=USERS
- A comma-separated list of GitHub handles to request a review from.
- -a, --assign=USERS
- A comma-separated list of GitHub handles to assign to this pull request.
- -M, --milestone=NAME
- The milestone name to add to this pull request. Passing the milestone number is deprecated.
- -l, --labels=LABELS
- Add a comma-separated list of labels to this pull request. Labels will be created if they don`t already exist.
EXAMPLES¶
$ 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 ]
CONFIGURATION¶
HUB_RETRY_TIMEOUT=SECONDS The maximum time to keep retrying after HTTP 422 on --push (default: 9).SEE ALSO¶
hub(1), hub-merge(1), hub-checkout(1)March 2019 | GITHUB |