.\" generated with Ronn-NG/v0.8.0
.\" http://github.com/apjanke/ronn-ng/tree/0.8.0
.TH "HUB\-PR" "1" "March 2019" "GITHUB" "Hub Manual"
.SH "NAME"
\fBhub\-pr\fR \- Manage GitHub pull requests for the current project\.
.SH "SYNOPSIS"
\fBhub pr\fR list [\-s \fISTATE\fR] [\-h \fIHEAD\fR] [\-b \fIBASE\fR] [\-o \fISORT_KEY\fR [\-^]] [\-f \fIFORMAT\fR] [\-L \fILIMIT\fR]
.br
\fBhub pr\fR checkout \fIPR\-NUMBER\fR [\fIBRANCH\fR]
.SH "COMMANDS"
.TP
\fIlist\fR
List pull requests in the current project\.
.TP
\fIcheckout\fR
Check out the head of a pull request in a new branch\.
.SH "OPTIONS"
.TP
\-s, \-\-state=\fISTATE\fR
Filter pull requests by \fISTATE\fR\. Supported values are: "open" (default), "closed", "merged", or "all"\.
.TP
\-h, \-\-head=\fIBRANCH\fR
Show pull requests started from the specified head \fIBRANCH\fR\. The "OWNER:BRANCH" format must be used for pull requests from forks\.
.TP
\-b, \-\-base=\fIBRANCH\fR
Show pull requests based off the specified \fIBRANCH\fR\.
.TP
\-f, \-\-format=\fIFORMAT\fR
Pretty print the list of pull requests using format \fIFORMAT\fR (default: "%sC%>(8)%i%Creset %t% l%n")\. See the "PRETTY FORMATS" section of git\-log(1) for some additional details on how placeholders are used in format\. The available placeholders are:
.IP
%I: pull request number
.IP
%i: pull request number prefixed with "#"
.IP
%U: the URL of this pull request
.IP
%S: state ("open" or "closed")
.IP
%sC: set color to red or green, depending on pull request state\.
.IP
%t: title
.IP
%l: colored labels
.IP
%L: raw, comma\-separated labels
.IP
%b: body
.IP
%B: base branch
.IP
%sB: base commit SHA
.IP
%H: head branch
.IP
%sH: head commit SHA
.IP
%sm: merge commit SHA
.IP
%au: login name of author
.IP
%as: comma\-separated list of assignees
.IP
%rs: comma\-separated list of requested reviewers
.IP
%Mn: milestone number
.IP
%Mt: milestone title
.IP
%NC: number of comments
.IP
%Nc: number of comments wrapped in parentheses, or blank string if zero\.
.IP
%cD: created date\-only (no time of day)
.IP
%cr: created date, relative
.IP
%ct: created date, UNIX timestamp
.IP
%cI: created date, ISO 8601 format
.IP
%uD: updated date\-only (no time of day)
.IP
%ur: updated date, relative
.IP
%ut: updated date, UNIX timestamp
.IP
%uI: updated date, ISO 8601 format
.IP
%mD: merged date\-only (no time of day)
.IP
%mr: merged date, relative
.IP
%mt: merged date, UNIX timestamp
.IP
%mI: merged date, ISO 8601 format
.IP
%n: newline
.IP
%%: a literal %
.TP
\-o, \-\-sort=\fISORT_KEY\fR
Sort displayed issues by "created" (default), "updated", "popularity", or "long\-running"\.
.TP
\-^ \-\-sort\-ascending
Sort by ascending dates instead of descending\.
.TP
\-L, \-\-limit=\fILIMIT\fR
Display only the first \fILIMIT\fR issues\.
.SH "SEE ALSO"
hub\-issue(1), hub\-pull\-request(1), hub(1)