tj.git-extras/man/git-pull-request.1
spacewander adce717843 Fix man page usage docs
Correct stale command usage details in the affected man pages
2026-03-23 19:35:13 +08:00

42 lines
1.6 KiB
Groff

.\" generated with Ronn-NG/v0.10.1
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
.TH "GIT\-PULL\-REQUEST" "1" "March 2026" "" "Git Extras"
.SH "NAME"
\fBgit\-pull\-request\fR \- Create pull request for GitHub project
.SH "SYNOPSIS"
\fBgit\-pull\-request\fR [<branch>]
.SH "DESCRIPTION"
Create pull request for a project on GitHub via command line\.
.P
A personal access token is required for making the API call to open the pull request(s) in GitHub\. API Documentation here \fIhttps://docs\.github\.com/en/rest/reference/pulls#create\-a\-pull\-request\fR
.P
Make sure the personal access token has the right \fBOAuth\fR scopes for the repo(s)
.P
Use \fBGITHUB_TOKEN\fR environment variable, or \fBgit config \-\-global \-\-add git\-extras\.github\-personal\-access\-token <your\-personal\-access\-token>\fR
.P
If using multiple accounts, override the global value in the specific repo using \fBgit config git\-extras\.github\-personal\-access\-token <other\-acc\-personal\-access\-token>\fR
.SH "OPTIONS"
<branch>
.P
The local branch to push and use as the pull request head\. The base branch is prompted separately\.
.SH "EXAMPLES"
.nf
$ git pull\-request master
Everything up\-to\-date
create pull\-request for spacewander/spacewander\-toolbox 'master'
title: test
body:
base [master]:
GitHub two\-factor authentication code (leave blank if not set up):
\|\.\|\.\|\.
.fi
.SH "AUTHOR"
Written by Tj Holowaychuk <\fItj@vision\-media\.ca\fR>
.SH "REPORTING BUGS"
<\fIhttps://github\.com/tj/git\-extras/issues\fR>
.SH "SEE ALSO"
<\fIhttps://github\.com/tj/git\-extras\fR>