'\" t
.\"     Title: zplug-rename-to
.\"    Author: [see the "Authors" section]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\"      Date: 12/28/2016
.\"    Manual: ZPLUG Manual
.\"    Source: ZPLUG Manual
.\"  Language: English
.\"
.TH "ZPLUG\-RENAME\-TO" "5" "12/28/2016" "ZPLUG Manual" "ZPLUG Manual"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
zplug-rename-to \- Specify the filename you want to rename to
.SH "SYNOPSIS"
.sp
.nf
\fIzplug\fR \fI"username/reponame"\fR, \fIrename\-to:a\&.sh\fR
.fi
.sp
.nf
The word \'package\' refers to the string in the format: "username/reponame"\&.
.fi
.SH "DESCRIPTION"
.sp
By using rename\-to tag, you can rename the package to what you want to change\&. It\(cqs only valid with as:command\&.
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.B Table\ \&1.\ \&zplug rename-to tag
.TS
allbox tab(:);
ltB ltB.
T{
Possive Values
T}:T{
Default value
T}
.T&
lt lt.
T{
.sp
(rename)
T}:T{
.sp
(none)
T}
.TE
.sp 1
.sp
Besides, by using zstyle command, you can change default value but it\(cqs impractical\&.
.SH "EXAMPLES"
.sp
Rename fzf\-bin to fzf:
.sp
.if n \{\
.RS 4
.\}
.nf
$ zplug \'junegunn/fzf\-bin\', \e
    from:gh\-r, \e
    as:command, \e
    rename\-to:fzf, \e
    use:\'*darwin*amd64*\'
.fi
.if n \{\
.RE
.\}
.sp
Rename a command with the string captured with use tag
.sp
.if n \{\
.RS 4
.\}
.nf
zplug \'b4b4r07/httpstat\', \e
    as:command, \e
    use:\'(*)\&.sh\', \e
    rename\-to:\'$1\'
.fi
.if n \{\
.RE
.\}
.SH "SEE ALSO"
.sp
\fBzplug(1)\fR
.SH "FURTHER DOCUMENTATION"
.sp
See the references in official wiki page to get started using zplug\&. The wiki may perhaps be overwhelming for first\-time users\&.
.SH "AUTHORS"
.sp
zplug was originally written by Masaki Ishiyama (a\&.k\&.a @b4b4r07)\&. Many people have contributed to it\&.
.SH "COPYING"
.sp
Copyright (C) 2015\-2016 Masaki Ishiyama
.sp
MIT License
.SH "REPORTING BUGS"
.sp
Report bugs to the zplug issues