.\" generated with Ronn-NG/v0.8.0
.\" http://github.com/apjanke/ronn-ng/tree/0.8.0
.TH "HUB\-RELEASE" "1" "March 2019" "GITHUB" "Hub Manual"
.SH "NAME"
\fBhub\-release\fR \- Manage GitHub releases\.
.SH "SYNOPSIS"
\fBhub release\fR [\-\-include\-drafts] [\-\-exclude\-prereleases] [\-L \fILIMIT\fR] [\-f \fIFORMAT\fR]
.br
\fBhub release\fR show [\-f \fIFORMAT\fR] \fITAG\fR
.br
\fBhub release\fR create [\-dpoc] [\-a \fIFILE\fR] [\-m \fIMESSAGE\fR|\-F \fIFILE\fR] [\-t \fITARGET\fR] \fITAG\fR
.br
\fBhub release\fR edit [\fIoptions\fR] \fITAG\fR
.br
\fBhub release\fR download \fITAG\fR
.br
\fBhub release\fR delete \fITAG\fR
.SH "COMMANDS"
With no arguments, shows a list of existing releases\.
.P
With \fB\-\-include\-drafts\fR, include draft releases in the listing\. With \fB\-\-exclude\-prereleases\fR, exclude non\-stable releases from the listing\.
.TP
\fIshow\fR
Show GitHub release notes for \fITAG\fR\.
.IP
With \fB\-\-show\-downloads\fR, include the "Downloads" section\.
.TP
\fIcreate\fR
Create a GitHub release for the specified \fITAG\fR name\. If git tag \fITAG\fR doesn`t exist, it will be created at \fITARGET\fR (default: current branch)\.
.TP
\fIedit\fR
Edit the GitHub release for the specified \fITAG\fR name\. Accepts the same options as \fIcreate\fR command\. Publish a draft with \fB\-\-draft=false\fR\.
.IP
When \fIMESSAGE\fR or \fIFILE\fR are not specified, a text editor will open pre\-populated with current release title and body\. To re\-use existing title and body unchanged, pass \fB\-m ""\fR\.
.TP
\fIdownload\fR
Download the assets attached to release for the specified \fITAG\fR\.
.TP
\fIdelete\fR
Delete the release and associated assets for the specified \fITAG\fR\.
.SH "OPTIONS"
.TP
\-L, \-\-limit
Display only the first \fILIMIT\fR releases\.
.TP
\-d, \-\-draft
Create a draft release\.
.TP
\-p, \-\-prerelease
Create a pre\-release\.
.TP
\-a, \-\-attach=\fIFILE\fR
Attach a file as an asset for this release\.
.IP
If \fIFILE\fR is in the "\fIfilename\fR#\fItext\fR" format, the text after the \fB#\fR character is taken as asset label\.
.TP
\-m, \-\-message=\fIMESSAGE\fR
The text up to the first blank line in \fIMESSAGE\fR is treated as the release title, and the rest is used as release description in Markdown format\.
.IP
If multiple \fIMESSAGE\fR options are given, their values are concatenated as separate paragraphs\.
.TP
\-F, \-\-file=\fIFILE\fR
Read the release title and description from \fIFILE\fR\.
.TP
\-e, \-\-edit
Further edit the contents of \fIFILE\fR in a text editor before submitting\.
.TP
\-o, \-\-browse
Open the new release in a web browser\.
.TP
\-c, \-\-copy
Put the URL of the new release to clipboard instead of printing it\.
.TP
\-t, \-\-commitish=\fITARGET\fR
A commit SHA or branch name to attach the release to, only used if \fITAG\fR doesn`t already exist (default: main branch)\.
.TP
\-f, \-\-format=\fIFORMAT\fR
Pretty print releases using \fIFORMAT\fR (default: "%T%n")\. See the "PRETTY FORMATS" section of git\-log(1) for some additional details on how placeholders are used in format\. The available placeholders for issues are:
.IP
%U: the URL of this release
.IP
%uT: tarball URL
.IP
%uZ: zipball URL
.IP
%uA: asset upload URL
.IP
%S: state (i\.e\. "draft", "pre\-release")
.IP
%sC: set color to yellow or red, depending on state
.IP
%t: release name
.IP
%T: release tag
.IP
%b: body
.IP
%as: the list of assets attached to this release
.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
%pD: published date\-only (no time of day)
.IP
%pr: published date, relative
.IP
%pt: published date, UNIX timestamp
.IP
%pI: published date, ISO 8601 format
.IP
%n: newline
.IP
%%: a literal %
.TP
\fITAG\fR
The git tag name for this release\.
.SH "SEE ALSO"
hub(1), git\-tag(1)