2018-02-28 23:48:56 +01:00
|
|
|
/n'\" t
|
|
|
|
.TH "YAY" "8" "2018-02-29" "Yay v3\&.411+" "Yay Manual"
|
2017-01-22 21:15:13 +01:00
|
|
|
.nh
|
|
|
|
.ad l
|
|
|
|
.SH "NAME"
|
2018-01-14 21:34:08 +01:00
|
|
|
yay \- AUR Helper written in go
|
2017-01-22 21:15:13 +01:00
|
|
|
.SH "SYNOPSIS"
|
|
|
|
.sp
|
2018-01-14 21:34:08 +01:00
|
|
|
\fIyay\fR <operation> [options] [targets]
|
|
|
|
.sp
|
|
|
|
\fIyay\fR <search pattern>
|
2017-01-22 21:15:13 +01:00
|
|
|
.SH "DESCRIPTION"
|
|
|
|
.sp
|
2018-02-28 23:48:56 +01:00
|
|
|
Yay is a Pacman wrapper with AUR support\&. It passes options to Makepkg and
|
|
|
|
Pacman after resolving packages to install/upgrade\&.
|
2018-01-14 21:34:08 +01:00
|
|
|
.sp
|
2018-02-28 23:48:56 +01:00
|
|
|
This manpage only covers options unique to Yay\&. For other options see
|
|
|
|
\fBpacman(8)\fR\&.
|
2018-01-14 21:34:08 +01:00
|
|
|
.SH "YAY OPERATIONS"
|
2017-01-22 21:15:13 +01:00
|
|
|
.PP
|
2018-01-14 21:34:08 +01:00
|
|
|
\fB\-Y, --yay\fR
|
2017-01-22 21:15:13 +01:00
|
|
|
.RS 4
|
2018-02-28 23:48:56 +01:00
|
|
|
Perform yay specific operations\&. This is the default if no other operation is
|
|
|
|
selected\&.
|
2017-01-22 21:15:13 +01:00
|
|
|
.RE
|
|
|
|
.PP
|
2018-01-31 11:25:46 +01:00
|
|
|
\fB\-P, --print\fR
|
|
|
|
.RS 4
|
|
|
|
Perform yay specific print operations\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-01-14 21:34:08 +01:00
|
|
|
\fB\-G, --getpkgbuild\fR
|
2017-02-15 02:50:26 +01:00
|
|
|
.RS 4
|
2018-01-14 21:34:08 +01:00
|
|
|
Downloads PKGBUILD from ABS or AUR\&.
|
2017-02-15 02:50:26 +01:00
|
|
|
.RE
|
|
|
|
.PP
|
2018-01-14 21:34:08 +01:00
|
|
|
If no operation is selected -Y will be assumed\&.
|
|
|
|
.SH "EXTENDED PACMAN OPERATIONS"
|
2017-01-22 21:15:13 +01:00
|
|
|
.PP
|
2018-01-14 21:34:08 +01:00
|
|
|
\fB\-S, -Si, -Ss, -Su\fR
|
2017-01-22 21:15:13 +01:00
|
|
|
.RS 4
|
2018-02-28 23:48:56 +01:00
|
|
|
These operations are extended to support both AUR and repo packages\&.
|
2017-01-22 21:15:13 +01:00
|
|
|
.RE
|
|
|
|
.PP
|
2018-01-14 21:34:08 +01:00
|
|
|
\fB\-R\fR
|
2017-01-22 21:15:13 +01:00
|
|
|
.RS 4
|
2018-01-14 21:34:08 +01:00
|
|
|
Yay will also remove cached data about devel packages\&.
|
2018-01-31 11:25:46 +01:00
|
|
|
.RE
|
2018-01-14 21:34:08 +01:00
|
|
|
.SH "YAY OPTIONS (APPLY TO -Y AND --YAY)"
|
2017-01-22 21:15:13 +01:00
|
|
|
.PP
|
2018-01-31 11:25:46 +01:00
|
|
|
\fB<NO OPTION>\fR
|
|
|
|
.RS 4
|
2018-02-28 23:48:56 +01:00
|
|
|
Displays a list of packages matching the search terms and prompts the user on
|
|
|
|
which packages to install (yogurt mode)\&.
|
2018-01-31 11:25:46 +01:00
|
|
|
.RE
|
|
|
|
.PP
|
2018-02-28 23:48:56 +01:00
|
|
|
\fB \-\-gendb\fR
|
2018-01-31 11:25:46 +01:00
|
|
|
.RS 4
|
2018-02-28 23:48:56 +01:00
|
|
|
Generate development package databse\&. Tracks the latest commit for each
|
|
|
|
development package, when there is a new commit Yay will know to update\&. This
|
|
|
|
is done per package whenever a package is synced. This option should only be
|
|
|
|
used when migrating to Yay from another AUR helper.
|
2018-01-31 11:25:46 +01:00
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-c \-\-clean\fR
|
|
|
|
.RS 4
|
|
|
|
Remove unneeded dependencies\&.
|
|
|
|
.RE
|
|
|
|
.SH "PRINT OPTIONS (APPLY TO -P AND --PRINT)"
|
2018-02-28 23:48:56 +01:00
|
|
|
\fB\-c \-\-complete\fR
|
|
|
|
.RS 4
|
|
|
|
Print a list of all AUR and repo packages\&. This is to allow shell completion
|
|
|
|
and is not intended to be used directly by the user\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-f \-\-fish\fR
|
|
|
|
.RS 4
|
|
|
|
During complete adjust the output for the fish shell\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-01-31 11:25:46 +01:00
|
|
|
\fB\-d \-\-defaultconfig\fR
|
2017-01-22 21:15:13 +01:00
|
|
|
.RS 4
|
2018-02-20 16:30:56 +01:00
|
|
|
Print default yay configuration\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-g \-\-config\fR
|
|
|
|
.RS 4
|
2018-01-31 11:25:46 +01:00
|
|
|
Print current yay configuration\&.
|
2017-01-22 21:15:13 +01:00
|
|
|
.RE
|
|
|
|
.PP
|
2018-01-31 11:25:46 +01:00
|
|
|
\fB\-n \-\-numberupgrades\fR
|
|
|
|
.RS 4
|
2018-02-28 23:48:56 +01:00
|
|
|
Print number of packages that need to be updated\&. Note this does not preform
|
|
|
|
a database refresh\&. Run \fByay -Sy\fR Before this for an up to date result\&.
|
2018-01-31 11:25:46 +01:00
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-s \-\-stats\fR
|
2017-01-22 21:15:13 +01:00
|
|
|
.RS 4
|
2018-02-28 23:48:56 +01:00
|
|
|
Displays information about installed packages and system health\&. If there are
|
|
|
|
orphaned, out-of-date or packages that no longer exist on the AUR warnings will
|
|
|
|
be displayed\&.
|
2017-01-22 21:15:13 +01:00
|
|
|
.RE
|
|
|
|
.PP
|
2018-01-31 11:25:46 +01:00
|
|
|
\fB\-u \-\-upgrades\fR
|
2017-01-22 21:15:13 +01:00
|
|
|
.RS 4
|
2018-02-28 23:48:56 +01:00
|
|
|
Print Names of packages that need to be updated\&. Note this does not preform
|
|
|
|
a database refresh\&. Run \fByay -Sy\fR Before this for an up to date result\&.
|
2018-01-31 11:25:46 +01:00
|
|
|
.PP
|
2018-01-14 21:34:08 +01:00
|
|
|
.SH "PERMANENT CONFIGURATION SETTINGS"
|
2017-01-22 21:15:13 +01:00
|
|
|
.PP
|
2018-01-14 21:34:08 +01:00
|
|
|
These options will be saved to disk and reapplied next time Yay is ran\&.
|
2017-01-22 21:15:13 +01:00
|
|
|
.PP
|
|
|
|
\fB\-\-topdown\fR
|
|
|
|
.RS 4
|
|
|
|
Display repository packages first and then AUR packages\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-bottomup\fR
|
|
|
|
.RS 4
|
|
|
|
Show AUR packages first and then repository packages\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2017-12-04 03:39:23 +01:00
|
|
|
\fB\-\-devel\fR
|
2017-01-22 21:15:13 +01:00
|
|
|
.RS 4
|
2018-02-28 23:48:56 +01:00
|
|
|
During sysupgrade also check AUR development packages for updates\&. Currently
|
|
|
|
only GitHub packages are supported\&.
|
2017-01-22 21:15:13 +01:00
|
|
|
.RE
|
|
|
|
.PP
|
2017-12-04 03:39:23 +01:00
|
|
|
\fB\-\-nodevel\fR
|
|
|
|
.RS 4
|
2018-02-28 23:48:56 +01:00
|
|
|
Do not check for development packages updates during sysupgrade\&.
|
2017-12-04 03:39:23 +01:00
|
|
|
.RE
|
2017-01-22 21:15:13 +01:00
|
|
|
.PP
|
2017-12-04 03:39:23 +01:00
|
|
|
\fB\-\-afterclean\fR
|
2017-01-22 21:15:13 +01:00
|
|
|
.RS 4
|
2018-02-28 23:48:56 +01:00
|
|
|
Remove package sources after successful Install\&.
|
2017-01-22 21:15:13 +01:00
|
|
|
.RE
|
2017-12-04 03:39:23 +01:00
|
|
|
.PP
|
|
|
|
\fB\-\-noafterclean\fR
|
2017-01-22 21:15:13 +01:00
|
|
|
.RS 4
|
2018-02-28 23:48:56 +01:00
|
|
|
Do not remove package sources after successful Install\&.
|
2017-01-22 21:15:13 +01:00
|
|
|
.RE
|
|
|
|
.PP
|
2017-12-04 03:39:23 +01:00
|
|
|
\fB\-\-timeupdate\fR
|
2017-01-22 21:15:13 +01:00
|
|
|
.RS 4
|
2018-02-28 23:48:56 +01:00
|
|
|
During sysupgrade also compare the build time of installed packages against
|
|
|
|
the last modification time of each package's AUR page\&.
|
2017-01-22 21:15:13 +01:00
|
|
|
.RE
|
2017-12-04 03:39:23 +01:00
|
|
|
.PP
|
|
|
|
\fB\-\-notimeupdate\fR
|
2017-01-22 21:15:13 +01:00
|
|
|
.RS 4
|
2018-02-28 23:48:56 +01:00
|
|
|
Do not consider build times during sysupgrade\&.
|
2017-01-22 21:15:13 +01:00
|
|
|
.RE
|
2018-01-14 21:34:08 +01:00
|
|
|
.SH "EXAMPLES"
|
2017-12-04 03:39:23 +01:00
|
|
|
.PP
|
2018-01-14 21:34:08 +01:00
|
|
|
yay \fIfoo\fR
|
2017-12-04 03:39:23 +01:00
|
|
|
.RS 4
|
2018-01-14 21:34:08 +01:00
|
|
|
Search and install from the repos and the \fBAUR\fR\ using yogurt mode\&.
|
2017-12-04 03:39:23 +01:00
|
|
|
.RE
|
|
|
|
.PP
|
2018-01-14 21:34:08 +01:00
|
|
|
yay -Syu
|
2017-12-04 03:39:23 +01:00
|
|
|
.RS 4
|
2018-01-14 21:34:08 +01:00
|
|
|
Update package list and upgrade all currently installed repo and \fBAUR\fR\&.
|
2017-12-04 03:39:23 +01:00
|
|
|
.RE
|
|
|
|
.PP
|
2018-01-14 21:34:08 +01:00
|
|
|
yay -S \fIfoo\fR
|
2017-12-04 04:03:10 +01:00
|
|
|
.RS 4
|
2018-01-14 21:34:08 +01:00
|
|
|
Installs package \fIfoo\fR from the repos or the \fBAUR\fR\&.
|
2017-01-22 21:15:13 +01:00
|
|
|
.RE
|
2018-01-05 23:29:49 +01:00
|
|
|
.PP
|
2018-01-14 21:34:08 +01:00
|
|
|
yay -Ss \fIfoo\fR
|
2017-01-22 21:15:13 +01:00
|
|
|
.RS 4
|
2018-01-14 21:34:08 +01:00
|
|
|
Searches for package \fIfoo\fR on the repos or the \fBAUR\fR\&.
|
2017-12-04 04:03:10 +01:00
|
|
|
.RE
|
2018-01-14 21:34:08 +01:00
|
|
|
.PP
|
|
|
|
yay -Si \fIfoo\fR
|
2017-12-04 04:03:10 +01:00
|
|
|
.RS 4
|
2018-01-14 21:34:08 +01:00
|
|
|
Gets information about package \fIfoo\fR from the repos or the \fBAUR\fR\&.
|
2018-01-06 14:46:07 +01:00
|
|
|
.RE
|
2018-01-14 21:34:08 +01:00
|
|
|
.PP
|
|
|
|
yay -S \fIfoo\fR
|
2018-01-06 14:46:07 +01:00
|
|
|
.RS 4
|
2018-01-14 21:34:08 +01:00
|
|
|
Installs package \fIfoo\fR from the repos or the \fBAUR\fR\&.
|
2018-01-06 14:46:07 +01:00
|
|
|
.RE
|
2018-01-14 21:34:08 +01:00
|
|
|
.PP
|
|
|
|
yay --stats
|
2018-01-06 14:46:07 +01:00
|
|
|
.RS 4
|
2018-01-14 21:34:08 +01:00
|
|
|
Shows statistics for installed packages and system health\&.
|
2017-12-04 04:03:10 +01:00
|
|
|
.RE
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
.sp
|
2017-01-22 21:15:13 +01:00
|
|
|
\fBmakepkg\fR(8)
|
|
|
|
\fBpacman\fR(8)
|
2018-01-14 21:34:08 +01:00
|
|
|
\fBpacman\&.conf\fR(5)
|
|
|
|
.PP
|
|
|
|
See the arch wiki at https://wiki\&.archlinux\&.org/index\&.php/Arch_User_Repository for more info on the \fBAUR\fR\&.
|
|
|
|
.SH "BUGS"
|
|
|
|
.PP
|
|
|
|
Please report bugs to our GitHub page https://github\&.com/Jguer/yay
|
2017-12-04 04:03:10 +01:00
|
|
|
.SH "AUTHORS"
|
|
|
|
.sp
|
|
|
|
Jguer <joaogg3@gmail\&.com>
|
2018-02-28 23:48:56 +01:00
|
|
|
.br
|
|
|
|
Morgana <morganamilo@gmail\&.com>
|