2018-03-26 21:51:52 +00:00
|
|
|
'\" t
|
2018-07-01 03:23:19 +00:00
|
|
|
.TH "YAY" "8" "2018\-07\-01" "Yay v7\&.887+" "Yay Manual"
|
2017-01-22 20:15:13 +00:00
|
|
|
.nh
|
|
|
|
.ad l
|
|
|
|
.SH "NAME"
|
2018-01-14 20:34:08 +00:00
|
|
|
yay \- AUR Helper written in go
|
2017-01-22 20:15:13 +00:00
|
|
|
.SH "SYNOPSIS"
|
|
|
|
.sp
|
2018-01-14 20:34:08 +00:00
|
|
|
\fIyay\fR <operation> [options] [targets]
|
|
|
|
.sp
|
|
|
|
\fIyay\fR <search pattern>
|
2018-04-08 14:36:44 +00:00
|
|
|
.sp
|
|
|
|
\fIyay\fR
|
2017-01-22 20:15:13 +00:00
|
|
|
.SH "DESCRIPTION"
|
|
|
|
.sp
|
2018-02-28 22:48:56 +00: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 20:34:08 +00:00
|
|
|
.sp
|
2018-02-28 22:48:56 +00:00
|
|
|
This manpage only covers options unique to Yay\&. For other options see
|
|
|
|
\fBpacman(8)\fR\&.
|
2018-01-14 20:34:08 +00:00
|
|
|
.SH "YAY OPERATIONS"
|
2017-01-22 20:15:13 +00:00
|
|
|
.PP
|
2018-06-04 19:00:01 +00:00
|
|
|
\fB\-Y, \-\-yay\fR
|
2017-01-22 20:15:13 +00:00
|
|
|
.RS 4
|
2018-02-28 22:48:56 +00:00
|
|
|
Perform yay specific operations\&. This is the default if no other operation is
|
|
|
|
selected\&.
|
2017-01-22 20:15:13 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
2018-06-04 19:00:01 +00:00
|
|
|
\fB\-P, \-\-print\fR
|
2018-01-31 10:25:46 +00:00
|
|
|
.RS 4
|
|
|
|
Perform yay specific print operations\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-06-04 19:00:01 +00:00
|
|
|
\fB\-G, \-\-getpkgbuild\fR
|
2017-02-15 01:50:26 +00:00
|
|
|
.RS 4
|
2018-01-14 20:34:08 +00:00
|
|
|
Downloads PKGBUILD from ABS or AUR\&.
|
2017-02-15 01:50:26 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
2018-06-04 19:00:01 +00:00
|
|
|
If no arguments are provided 'yay \-Syu' will be performed\&.
|
2018-04-08 14:36:44 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
2018-06-04 19:00:01 +00:00
|
|
|
If no operation is selected \-Y will be assumed\&.
|
2018-01-14 20:34:08 +00:00
|
|
|
.SH "EXTENDED PACMAN OPERATIONS"
|
2017-01-22 20:15:13 +00:00
|
|
|
.PP
|
2018-06-04 19:00:01 +00:00
|
|
|
\fB\-S, \-Si, \-Ss, \-Su, \-Sc, \-Qu\fR
|
2017-01-22 20:15:13 +00:00
|
|
|
.RS 4
|
2018-02-28 22:48:56 +00:00
|
|
|
These operations are extended to support both AUR and repo packages\&.
|
2017-01-22 20:15:13 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
2018-04-17 12:50:58 +00:00
|
|
|
\fB\-Sc\fR
|
|
|
|
.RS 4
|
|
|
|
Yay will also clean cached AUR package and any untracked Files in the
|
|
|
|
cache\&. Untracked files cleaning only works for packages downloaded
|
|
|
|
using gitclone\&. Cleaning untracked files will wipe any downloaded
|
|
|
|
sources or built packages but will keep already downloaded vcs sources\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-01-14 20:34:08 +00:00
|
|
|
\fB\-R\fR
|
2017-01-22 20:15:13 +00:00
|
|
|
.RS 4
|
2018-01-14 20:34:08 +00:00
|
|
|
Yay will also remove cached data about devel packages\&.
|
2018-06-04 19:00:01 +00:00
|
|
|
.RE
|
|
|
|
.SH "NEW OPTIONS"
|
|
|
|
.PP
|
|
|
|
\fB \-\-repo\fR
|
|
|
|
.RS 4
|
2018-06-04 19:12:26 +00:00
|
|
|
Assume all targets are from the repositories\&. Additionally Actions such as
|
2018-06-04 19:00:01 +00:00
|
|
|
sysupgrade will only act on repository packages\&.
|
|
|
|
.RE
|
|
|
|
\fB\-a \-\-aur\fR
|
|
|
|
.RS 4
|
2018-06-04 19:12:26 +00:00
|
|
|
Assume all targets are from the AUR\&. Additionally Actions such as
|
2018-06-04 19:00:01 +00:00
|
|
|
sysupgrade will only act on AUR packages\&.
|
2018-04-17 12:50:58 +00:00
|
|
|
|
2018-06-04 19:00:01 +00:00
|
|
|
Note that dependency resolving will still act as normal and include repository
|
|
|
|
packages\&.
|
2018-01-31 10:25:46 +00:00
|
|
|
.RE
|
2018-06-04 19:00:01 +00:00
|
|
|
.SH "YAY OPTIONS (APPLY TO \-Y AND \-\-YAY)"
|
2017-01-22 20:15:13 +00:00
|
|
|
.PP
|
2018-01-31 10:25:46 +00:00
|
|
|
\fB<NO OPTION>\fR
|
|
|
|
.RS 4
|
2018-02-28 22:48:56 +00:00
|
|
|
Displays a list of packages matching the search terms and prompts the user on
|
|
|
|
which packages to install (yogurt mode)\&.
|
2018-01-31 10:25:46 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
2018-02-28 22:48:56 +00:00
|
|
|
\fB \-\-gendb\fR
|
2018-01-31 10:25:46 +00:00
|
|
|
.RS 4
|
2018-03-31 06:33:14 +00:00
|
|
|
Generate development package database\&. Tracks the latest commit for each
|
2018-02-28 22:48:56 +00:00
|
|
|
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 10:25:46 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-c \-\-clean\fR
|
|
|
|
.RS 4
|
|
|
|
Remove unneeded dependencies\&.
|
|
|
|
.RE
|
2018-06-04 19:00:01 +00:00
|
|
|
.SH "PRINT OPTIONS (APPLY TO \-P AND \-\-PRINT)"
|
2018-02-28 22:48:56 +00: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 10:25:46 +00:00
|
|
|
\fB\-d \-\-defaultconfig\fR
|
2017-01-22 20:15:13 +00:00
|
|
|
.RS 4
|
2018-02-20 15:30:56 +00:00
|
|
|
Print default yay configuration\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-g \-\-config\fR
|
|
|
|
.RS 4
|
2018-01-31 10:25:46 +00:00
|
|
|
Print current yay configuration\&.
|
2017-01-22 20:15:13 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
2018-01-31 10:25:46 +00:00
|
|
|
\fB\-n \-\-numberupgrades\fR
|
|
|
|
.RS 4
|
2018-07-19 16:39:54 +00:00
|
|
|
Deprecated, use \fByay -Qu\fR and \fBwc -l\fR instead\%.
|
2018-01-31 10:25:46 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-s \-\-stats\fR
|
2017-01-22 20:15:13 +00:00
|
|
|
.RS 4
|
2018-02-28 22:48:56 +00:00
|
|
|
Displays information about installed packages and system health\&. If there are
|
2018-06-04 19:00:01 +00:00
|
|
|
orphaned, out\-of\-date or packages that no longer exist on the AUR warnings will
|
2018-02-28 22:48:56 +00:00
|
|
|
be displayed\&.
|
2017-01-22 20:15:13 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
2018-01-31 10:25:46 +00:00
|
|
|
\fB\-u \-\-upgrades\fR
|
2017-01-22 20:15:13 +00:00
|
|
|
.RS 4
|
2018-07-17 21:36:01 +00:00
|
|
|
Deprecated, use \fByay -Qu\fR instead\%.
|
2018-05-17 18:47:12 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
2018-06-04 19:00:01 +00:00
|
|
|
\fB\-w \-\-news\fR
|
2018-05-17 18:47:12 +00:00
|
|
|
.RS 4
|
|
|
|
Print new news from the Archlinux homepage\&. News is considered new if it is
|
|
|
|
newer than the build date of all native packages\&. Pass this twice to show all
|
2018-06-04 19:12:26 +00:00
|
|
|
available news\&.
|
2018-05-17 18:47:12 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
2018-06-04 19:00:01 +00:00
|
|
|
\fB\-q \-\-quiet\fR
|
2018-05-17 18:47:12 +00:00
|
|
|
.RS 4
|
|
|
|
Only show titles when printing news\&.
|
|
|
|
.RE
|
2018-01-31 10:25:46 +00:00
|
|
|
.PP
|
2018-01-14 20:34:08 +00:00
|
|
|
.SH "PERMANENT CONFIGURATION SETTINGS"
|
2017-01-22 20:15:13 +00:00
|
|
|
.PP
|
2018-03-07 22:37:44 +00:00
|
|
|
\fB\-\-save\fR
|
|
|
|
.RS 4
|
|
|
|
Causes the following options to be saved back to the config file\&. This
|
|
|
|
provides an easy way to change config options without directly editing the
|
|
|
|
file\&.
|
|
|
|
.RE
|
2017-01-22 20:15:13 +00:00
|
|
|
.PP
|
2018-03-08 01:36:06 +00:00
|
|
|
\fB\-\-builddir <dir>\fR
|
|
|
|
.RS 4
|
|
|
|
Directory to use for Building AUR Packages\&. This directory is also used as
|
|
|
|
the AUR cache when deciding if Yay should should skip builds\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-editor <file>\fR
|
|
|
|
.RS 4
|
|
|
|
Editor to use when editing PKGBUILDs\&. If this is not set the \fBEDITOR\fR
|
|
|
|
environment variable will be checked, followed by \fBVISUAL\fR\&. If none of
|
|
|
|
these are set Yay will prompt the user for an editor\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-04-23 00:42:58 +00:00
|
|
|
\fB\-\-editorflags <flags>\fR
|
|
|
|
.RS 4
|
|
|
|
Passes arguments to the editor\&. These flags get passed to every instance where
|
|
|
|
the editor is called by Yay. Arguments are split on whitespace before being
|
|
|
|
passed to gpg. Multiple arguments may be passed by supplying a space
|
|
|
|
separated list that is quoted by the shell.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-03-08 01:36:06 +00:00
|
|
|
\fB\-\-makepkg <file>\fR
|
|
|
|
.RS 4
|
|
|
|
The command to use for \fBmakepkg\fR calls. This can be a command in
|
|
|
|
\fBPATH\fR or an absolute path to the file\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-pacman <file>\fR
|
|
|
|
.RS 4
|
|
|
|
The command to use for \fBpacman\fR calls. This can be a command in
|
|
|
|
\fBPATH\fR or an absolute path to the file\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-tar <file>\fR
|
|
|
|
.RS 4
|
|
|
|
The command to use for \fBbsdtar\fR calls. This can be a command in
|
|
|
|
\fBPATH\fR or an absolute path to the file\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-git <file>\fR
|
|
|
|
.RS 4
|
|
|
|
The command to use for \fBgit\fR calls. This can be a command in
|
|
|
|
\fBPATH\fR or an absolute path to the file\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-03-17 20:40:24 +00:00
|
|
|
\fB\-\-gpg <file>\fR
|
|
|
|
.RS 4
|
|
|
|
The command to use for \fBgpg\fR calls. This can be a command in
|
|
|
|
\fBPATH\fR or an absolute path to the file\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-03-08 01:36:06 +00:00
|
|
|
\fB\-\-config <file>\fR
|
|
|
|
.RS 4
|
|
|
|
The pacman config file to use\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-07-28 03:01:55 +00:00
|
|
|
\fB\-\-makepkgconf <file>\fR
|
|
|
|
.RS 4
|
|
|
|
The config file for makepkg to use\%. If this is not set then the default
|
|
|
|
config file will be used\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-nomakepkgconf\fR
|
|
|
|
.RS 4
|
|
|
|
Reset the makepkg config file back to its default\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-03-08 01:36:06 +00:00
|
|
|
\fB\-\-requestsplitn <n>\fR
|
|
|
|
.RS 4
|
|
|
|
The maximum amount of packages to request per AUR query\&. The higher the
|
|
|
|
number the faster AUR requests will be\&. Requesting too many packages in one
|
2018-04-23 00:42:58 +00:00
|
|
|
AUR query will cause an error\&. This should only make a noticeable difference
|
2018-03-08 01:36:06 +00:00
|
|
|
with very large requests (>500) packages\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-07-28 03:01:55 +00:00
|
|
|
\fB\-\-completioninterval <days>\fR
|
|
|
|
.RS 4
|
|
|
|
Time in days to refresh the completion cache\&. Setting this to 0 will cause
|
|
|
|
the cache to be refreshed every time, while setting this to -1 will cause the
|
|
|
|
cache to never be refreshed\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-04-05 18:14:46 +00:00
|
|
|
\fB\-\-sortby <votes|popularity|id|baseid|name|base|submitted|modified>\fR
|
|
|
|
.RS 4
|
|
|
|
Sort AUR results by a specific field during search\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-answerclean <All|None|Installed|NotInstalled|...>\fR
|
|
|
|
.RS 4
|
|
|
|
Set a predetermined answer for the clean build menu question\&. This answer
|
2018-04-23 17:06:56 +00:00
|
|
|
will be used instead of reading from standard input but will be treated exactly
|
2018-04-05 18:14:46 +00:00
|
|
|
the same when parsed\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-06-11 18:38:53 +00:00
|
|
|
\fB\-\-answerdiff <All|None|Installed|NotInstalled|...>\fR
|
|
|
|
.RS 4
|
|
|
|
Set a predetermined answer for the edit diff menu question\&. This answer
|
|
|
|
will be used instead of reading from standard input but will be treated exactly
|
|
|
|
the same when parsed\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-04-05 18:14:46 +00:00
|
|
|
\fB\-\-answeredit <All|None|Installed|NotInstalled|...>\fR
|
|
|
|
.RS 4
|
2018-04-17 12:50:58 +00:00
|
|
|
Set a predetermined answer for the edit pkgbuild menu question\&. This answer
|
2018-04-23 17:06:56 +00:00
|
|
|
will be used instead of reading from standard input but will be treated exactly
|
2018-04-05 18:14:46 +00:00
|
|
|
the same when parsed\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-answerupgrade\fR <Repo|^Repo|None|...>
|
|
|
|
.RS 4
|
2018-04-23 17:43:17 +00:00
|
|
|
Set a predetermined answer for the upgrade menu question\&. Selects which package
|
|
|
|
ranges or repos to omit for updades\&. This answer will be used instead of
|
2018-04-23 17:06:56 +00:00
|
|
|
reading from standard input but will be treated exactly the same\&.
|
2018-04-05 18:14:46 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-noanswerclean\fR
|
|
|
|
.RS 4
|
|
|
|
Unset the answer for the clean build menu\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-06-11 18:38:53 +00:00
|
|
|
\fB\-\-noanswerdiff\fR
|
|
|
|
.RS 4
|
|
|
|
Unset the answer for the diff menu\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-04-05 18:14:46 +00:00
|
|
|
\fB\-\-noansweredit\fR
|
|
|
|
.RS 4
|
|
|
|
Unset the answer for the edit pkgbuild menu\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-noanswerupgrade\fR
|
|
|
|
.RS 4
|
|
|
|
Unset the answer for the upgrade menu\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-06-11 18:38:53 +00:00
|
|
|
\fB\-\-cleanmenu\fR
|
|
|
|
.RS 4
|
|
|
|
Show the clean menu\&. This menu gives you the chance to fully delete the
|
|
|
|
downloaded build files from Yay's cache before redownloing a fresh copy\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-diffmenu\fR
|
|
|
|
.RS 4
|
|
|
|
Show the diff menu\&. This menu gives you the option to view diffs from
|
|
|
|
build files before building\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-editmenu\fR
|
|
|
|
.RS 4
|
|
|
|
Show the edit menu\&. This menu gives you the option to edit or view PKGBUILDs
|
|
|
|
before building\&.
|
|
|
|
|
|
|
|
\fBWarning\fR: Yay resolves dependencies ahead of time via the RPC\&. It is not
|
|
|
|
recommended to edit pkgbuild variables unless you know what you are doing\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-06-11 19:09:29 +00:00
|
|
|
\fB\-\-upgrademenu\fR
|
|
|
|
.RS 4
|
|
|
|
Show a detailed list of updates in a similar format to VerbosePkgLists\&.
|
|
|
|
Upgrades can also be skipped using numbers, number ranges or repo names\&.
|
|
|
|
Adidionally ^ can be used to invert the selection\&.
|
|
|
|
|
|
|
|
\fBWarning\fR: It is not recommended to skip updates from the repositores as
|
|
|
|
this can lead to partial upgrades\&. This feature is intended to easily skip AUR
|
|
|
|
updates on the fly that may be broken or have a long compile time\&. Ultimately
|
|
|
|
it is up to the user what upgrades they skip\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-06-11 18:38:53 +00:00
|
|
|
\fB\-\-nocleanmenu\fR
|
|
|
|
.RS 4
|
|
|
|
Do not show the clean menu\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-nodiffmenu\fR
|
|
|
|
.RS 4
|
|
|
|
Do not show the diff menu\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-noeditmenu\fR
|
|
|
|
.RS 4
|
|
|
|
Do not show the edit menu\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-06-11 19:09:29 +00:00
|
|
|
\fB\-\-noupgrademenu\fR
|
|
|
|
.RS 4
|
|
|
|
Do not show the upgrade menu\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-07-28 03:01:55 +00:00
|
|
|
\fB\-\-askremovemake\fR
|
|
|
|
.RS 4
|
|
|
|
Ask to remove makedepends after installing packages\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-removemake\fR
|
|
|
|
.RS 4
|
|
|
|
Remove makedepends after installing packages\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-noremovemake\fR
|
|
|
|
.RS 4
|
|
|
|
Do not remove makedepends after installing packages\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2017-01-22 20:15:13 +00:00
|
|
|
\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 02:39:23 +00:00
|
|
|
\fB\-\-devel\fR
|
2017-01-22 20:15:13 +00:00
|
|
|
.RS 4
|
2018-02-28 22:48:56 +00:00
|
|
|
During sysupgrade also check AUR development packages for updates\&. Currently
|
|
|
|
only GitHub packages are supported\&.
|
2017-01-22 20:15:13 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
2017-12-04 02:39:23 +00:00
|
|
|
\fB\-\-nodevel\fR
|
|
|
|
.RS 4
|
2018-02-28 22:48:56 +00:00
|
|
|
Do not check for development packages updates during sysupgrade\&.
|
2017-12-04 02:39:23 +00:00
|
|
|
.RE
|
2017-01-22 20:15:13 +00:00
|
|
|
.PP
|
2018-04-23 00:42:58 +00:00
|
|
|
\fB\-\-gitclone\fR
|
|
|
|
.RS 4
|
|
|
|
Use git to download and update PKGBUILDs\&. PKGBUILDs previously downloaded
|
2018-06-04 19:00:01 +00:00
|
|
|
using tarball will continue to use tarballs until the package is clean
|
|
|
|
built\&. Similarly, PKGBUILDs managed with git will continue to use git until
|
|
|
|
the package is clean built.\&.
|
2018-04-23 00:42:58 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-nogitclone\fR
|
|
|
|
.RS 4
|
|
|
|
Download and update PKGBUILDs using tarballs\&. The above conditions about
|
|
|
|
previously installed packages still apply\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-06-04 19:00:01 +00:00
|
|
|
\fB\-\-showdiffs\fR
|
|
|
|
.RS 4
|
|
|
|
Show diffs for build files\&. Diffs are shown via \fBgit diff\fR which uses
|
|
|
|
less by default\&. This behaviour can be changed via git's config, the
|
2018-06-19 10:31:39 +00:00
|
|
|
\fB$GIT_PAGER\fR or \fB$PAGER\fR environment variables\&.
|
2018-06-04 19:00:01 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-noshowdiffs\fR
|
|
|
|
.RS 4
|
|
|
|
Show diffs for build files\&. Files will be opened by the editor\%.
|
|
|
|
.RE
|
|
|
|
.PP
|
2017-12-04 02:39:23 +00:00
|
|
|
\fB\-\-afterclean\fR
|
2017-01-22 20:15:13 +00:00
|
|
|
.RS 4
|
2018-02-28 22:48:56 +00:00
|
|
|
Remove package sources after successful Install\&.
|
2017-01-22 20:15:13 +00:00
|
|
|
.RE
|
2017-12-04 02:39:23 +00:00
|
|
|
.PP
|
|
|
|
\fB\-\-noafterclean\fR
|
2017-01-22 20:15:13 +00:00
|
|
|
.RS 4
|
2018-02-28 22:48:56 +00:00
|
|
|
Do not remove package sources after successful Install\&.
|
2017-01-22 20:15:13 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
2017-12-04 02:39:23 +00:00
|
|
|
\fB\-\-timeupdate\fR
|
2017-01-22 20:15:13 +00:00
|
|
|
.RS 4
|
2018-02-28 22:48:56 +00: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 20:15:13 +00:00
|
|
|
.RE
|
2017-12-04 02:39:23 +00:00
|
|
|
.PP
|
|
|
|
\fB\-\-notimeupdate\fR
|
2017-01-22 20:15:13 +00:00
|
|
|
.RS 4
|
2018-02-28 22:48:56 +00:00
|
|
|
Do not consider build times during sysupgrade\&.
|
2017-01-22 20:15:13 +00:00
|
|
|
.RE
|
2018-03-06 15:17:55 +00:00
|
|
|
.PP
|
|
|
|
\fB\-\-redownload\fR
|
|
|
|
.RS 4
|
2018-03-08 01:36:06 +00:00
|
|
|
Always download pkgbuilds of targets even when a copy is available in cache\&.
|
2018-03-07 21:32:55 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-redownloadall\fR
|
|
|
|
.RS 4
|
2018-03-08 01:36:06 +00:00
|
|
|
Always download pkgbuilds of all AUR packages even when a copy is available
|
2018-03-07 21:32:55 +00:00
|
|
|
in cache\&.
|
2018-03-06 15:17:55 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-noredownload\fR
|
|
|
|
.RS 4
|
2018-03-07 21:32:55 +00:00
|
|
|
When downloading pkgbuilds if the pkgbuild is found in cache and is equal or
|
|
|
|
newer than the AUR's version use that instead of downloading a new one\&.
|
2018-03-06 15:17:55 +00:00
|
|
|
.RE
|
2018-03-07 23:34:07 +00:00
|
|
|
.PP
|
2018-06-04 19:00:01 +00:00
|
|
|
\fB\-\-provides\fR
|
|
|
|
.RS 4
|
|
|
|
Look for matching providers when searching for AUR packages\&. When multiple
|
|
|
|
providers are found a menu will appear prompting you to pick one\&. This
|
2018-06-04 19:12:26 +00:00
|
|
|
increases dependency resolve time although this should not be noticeable\&.
|
2018-06-04 19:00:01 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-noprovides\fR
|
|
|
|
.RS 4
|
|
|
|
Do not look for matching providers when searching for AUR packages\&. If
|
2018-06-04 19:12:26 +00:00
|
|
|
multiple providers happen to be found the menu will still appear\&.
|
2018-06-04 19:00:01 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-pgpfetch\fR
|
|
|
|
.RS 4
|
|
|
|
Prompt to import unknown PGP keys from the \fBvalidpgpkeys\fR field of each
|
|
|
|
PKGBUILD.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-07-21 23:04:22 +00:00
|
|
|
\fB\-\-nopgpfetch\fR
|
2018-06-04 19:00:01 +00:00
|
|
|
.RS 4
|
|
|
|
Do not prompt to import unknown PGP keys\&. This is likley to cause a build
|
|
|
|
failiure unless using options such as \fB\-\-skippgpcheck\fR or a customized
|
|
|
|
gpg config\%.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-07-01 03:23:19 +00:00
|
|
|
\fB\-\-useask\fR
|
|
|
|
.RS 4
|
|
|
|
Use pacman's --ask flag to automatically confirm package conflicts\&. Yay lists
|
|
|
|
conflicts ahead of time\&. It is possible thay Yay does not detect
|
|
|
|
a conflict\&. Causing a package to be removed without the user's confimation\&.
|
|
|
|
Although this is very unlikley\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-nouseask\fR
|
|
|
|
.RS 4
|
|
|
|
Manually resolve package conflicts during the install. Packages which do not
|
|
|
|
conflict will not need to be confimed manually\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-combinedupgrade\fR
|
|
|
|
.RS 4
|
|
|
|
During sysupgrade, Yay will first perform a refresh, then show
|
|
|
|
its combined menu of repo and AUR packages that will be upgraded\&. Then after
|
|
|
|
reviewing the pkgbuilds, the repo and AUR upgrade will start with no need
|
|
|
|
for manual intervention\&.
|
|
|
|
|
|
|
|
If Yay exits for any reason After the refresh without upgrading\&. It is then
|
|
|
|
the user's responsibility to either resolve the reason Yay exited or run
|
|
|
|
a sysupgrade through pacman directly\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-nocombinedupgrade\fR
|
|
|
|
.RS 4
|
|
|
|
During sysupgrade, Pacman \-Syu will be called, then the AUR upgrade will
|
|
|
|
start\&. This means the upgrade menu and pkgbuild review will be performed
|
|
|
|
after the sysupgrade has finished\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-03-14 02:33:40 +00:00
|
|
|
\fB\-\-rebuild\fR
|
|
|
|
.RS 4
|
|
|
|
Always build target packages even when a copy is available in cache\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-rebuildall\fR
|
|
|
|
.RS 4
|
|
|
|
Always build all AUR packages even when a copy is available
|
|
|
|
in cache\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-rebuildtree\fR
|
|
|
|
.RS 4
|
|
|
|
When installing an AUR package rebuild and reinstall all of its AUR
|
|
|
|
dependencies recursivley, even the ones already installed. This flag allows
|
|
|
|
you to easily rebuild packages against your current system's libraries if they
|
|
|
|
have become incompatible.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fB\-\-norebuild\fR
|
|
|
|
.RS 4
|
|
|
|
When building packages if the package is found in cache and is an equal version
|
|
|
|
to the one wanted skip the package build and use the existing package\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-03-08 01:36:06 +00:00
|
|
|
\fB\-\-mflags <flags>\fR
|
2018-03-07 23:34:07 +00:00
|
|
|
.RS 4
|
|
|
|
Passes arguments to makepkg\&. These flags get passed to every instance where
|
|
|
|
makepkg is called by Yay. Arguments are split on whitespace before being
|
2018-03-08 01:36:06 +00:00
|
|
|
passed to makepkg. Multiple arguments may be passed by supplying a space
|
|
|
|
separated list that is quoted by the shell.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-03-17 20:40:24 +00:00
|
|
|
\fB\-\-gpgflags <flags>\fR
|
|
|
|
.RS 4
|
|
|
|
Passes arguments to gpg\&. These flags get passed to every instance where
|
|
|
|
gpg is called by Yay. Arguments are split on whitespace before being
|
|
|
|
passed to gpg. Multiple arguments may be passed by supplying a space
|
|
|
|
separated list that is quoted by the shell.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-03-08 01:36:06 +00:00
|
|
|
\fB\-\-sudoloop\fR
|
|
|
|
.RS 4
|
|
|
|
Loop sudo calls in the background to prevent sudo from timing out during long
|
|
|
|
builds\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-03-11 21:19:05 +00:00
|
|
|
\fB\-\-nosudoloop\fR
|
2018-03-08 01:36:06 +00:00
|
|
|
.RS 4
|
|
|
|
Do not loop sudo calls in the background\&.
|
2018-03-07 23:34:07 +00:00
|
|
|
.RE
|
2018-01-14 20:34:08 +00:00
|
|
|
.SH "EXAMPLES"
|
2017-12-04 02:39:23 +00:00
|
|
|
.PP
|
2018-01-14 20:34:08 +00:00
|
|
|
yay \fIfoo\fR
|
2017-12-04 02:39:23 +00:00
|
|
|
.RS 4
|
2018-01-14 20:34:08 +00:00
|
|
|
Search and install from the repos and the \fBAUR\fR\ using yogurt mode\&.
|
2017-12-04 02:39:23 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
2018-06-04 19:00:01 +00:00
|
|
|
yay \-Syu
|
2017-12-04 02:39:23 +00:00
|
|
|
.RS 4
|
2018-01-14 20:34:08 +00:00
|
|
|
Update package list and upgrade all currently installed repo and \fBAUR\fR\&.
|
2017-12-04 02:39:23 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
2018-06-04 19:00:01 +00:00
|
|
|
yay \-S \fIfoo\fR
|
2017-12-04 03:03:10 +00:00
|
|
|
.RS 4
|
2018-01-14 20:34:08 +00:00
|
|
|
Installs package \fIfoo\fR from the repos or the \fBAUR\fR\&.
|
2017-01-22 20:15:13 +00:00
|
|
|
.RE
|
2018-01-05 22:29:49 +00:00
|
|
|
.PP
|
2018-06-04 19:00:01 +00:00
|
|
|
yay \-Ss \fIfoo\fR
|
2017-01-22 20:15:13 +00:00
|
|
|
.RS 4
|
2018-01-14 20:34:08 +00:00
|
|
|
Searches for package \fIfoo\fR on the repos or the \fBAUR\fR\&.
|
2017-12-04 03:03:10 +00:00
|
|
|
.RE
|
2018-01-14 20:34:08 +00:00
|
|
|
.PP
|
2018-06-04 19:00:01 +00:00
|
|
|
yay \-Si \fIfoo\fR
|
2017-12-04 03:03:10 +00:00
|
|
|
.RS 4
|
2018-01-14 20:34:08 +00:00
|
|
|
Gets information about package \fIfoo\fR from the repos or the \fBAUR\fR\&.
|
2018-01-06 13:46:07 +00:00
|
|
|
.RE
|
2018-01-14 20:34:08 +00:00
|
|
|
.PP
|
2018-06-04 19:00:01 +00:00
|
|
|
yay \-S \fIfoo\fR \-\-mflags "\-\-skipchecksums \-\-skippgpcheck"
|
2018-01-06 13:46:07 +00:00
|
|
|
.RS 4
|
2018-03-07 23:34:07 +00:00
|
|
|
Installs \fIfoo\fR while skipping checksums and pgp checks\&.
|
2018-01-06 13:46:07 +00:00
|
|
|
.RE
|
2018-01-14 20:34:08 +00:00
|
|
|
.PP
|
2018-06-04 19:00:01 +00:00
|
|
|
yay \-\-devel \-\-save
|
2018-03-07 22:37:44 +00:00
|
|
|
.RS 4
|
|
|
|
Sets devel to true in the config\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2018-06-04 19:00:01 +00:00
|
|
|
yay \-P \-\-stats
|
2018-01-06 13:46:07 +00:00
|
|
|
.RS 4
|
2018-01-14 20:34:08 +00:00
|
|
|
Shows statistics for installed packages and system health\&.
|
2017-12-04 03:03:10 +00:00
|
|
|
.RE
|
2018-03-10 17:10:37 +00:00
|
|
|
.SH "FILES"
|
|
|
|
.sp
|
2018-03-10 22:01:27 +00:00
|
|
|
\fBCONFIG DIRECTORY\fR
|
|
|
|
.RS 4
|
|
|
|
The config directory is \fI$XDG_CONFIG_HOME/yay/\fR\&. if
|
|
|
|
\fB$XDG_CONFIG_HOME\fR is unset, the config directory will fall back to
|
2018-04-23 00:42:58 +00:00
|
|
|
\fI$HOME/.config/yay\fR\&.
|
2018-03-10 22:01:27 +00:00
|
|
|
.PP
|
|
|
|
\fIconfig.json\fR\& Is used to store all of Yay's config options\&. Editing
|
|
|
|
this file should be done through Yay, using the options
|
|
|
|
mentioned in \fBPERMANENT CONFIGURATION SETTINGS\fR\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fBCACHE DIRECTORY\fR
|
|
|
|
.RS 4
|
|
|
|
The cache directory is \fI$XDG_CACHE_HOME/yay/\fR\&. if
|
|
|
|
\fB$XDG_CACHE_HOME\fR is unset, the cache directory will fall back to
|
|
|
|
\fI$HOME/.cache/yay\fR\&.
|
|
|
|
.PP
|
2018-07-28 03:01:55 +00:00
|
|
|
\fIcompletion.cache\fR holds a list of of all packages, including the AUR,
|
|
|
|
for shell completion\&. By default the completion files are refreshed every
|
|
|
|
7 days\&.
|
2018-03-10 22:01:27 +00:00
|
|
|
.PP
|
|
|
|
\fIvcs.json\fR tracks VCS packages and the latest commit of each source. If
|
|
|
|
any of these commits change the package will be upgraded during a devel update.
|
2018-03-10 17:10:37 +00:00
|
|
|
.RE
|
2018-03-10 22:01:27 +00:00
|
|
|
.PP
|
|
|
|
\fBBUILD DIRECTORY\fR
|
|
|
|
.RS 4
|
|
|
|
Unless otherwise set this should be the same as \fBCACHE DIRECTORY\fR. This
|
|
|
|
directory is used to store downloaded AUR Packages as well as any source files
|
2018-04-17 12:50:58 +00:00
|
|
|
and built packages from those packages\&.
|
2018-03-10 22:01:27 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
\fBPACMAN.CONF\fR
|
|
|
|
.RS 4
|
|
|
|
Yay uses Pacman's config file to set certain pacman options either through
|
2018-06-04 19:00:01 +00:00
|
|
|
go\-alpm or Yay itself. Options inherited include most libalpm options and
|
2018-03-10 22:01:27 +00:00
|
|
|
pacman options\&.
|
|
|
|
.PP
|
|
|
|
Notably \fBDatabases\fR, \fBColor\fR and \fB*Path/*Dir\fR options are used\&.
|
|
|
|
.RE
|
|
|
|
.PP
|
2017-12-04 03:03:10 +00:00
|
|
|
.SH "SEE ALSO"
|
|
|
|
.sp
|
2017-01-22 20:15:13 +00:00
|
|
|
\fBmakepkg\fR(8)
|
2018-03-10 22:01:27 +00:00
|
|
|
\fBPKGBUILD\fR(5)
|
2017-01-22 20:15:13 +00:00
|
|
|
\fBpacman\fR(8)
|
2018-01-14 20:34:08 +00: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 03:03:10 +00:00
|
|
|
.SH "AUTHORS"
|
|
|
|
.sp
|
|
|
|
Jguer <joaogg3@gmail\&.com>
|
2018-02-28 22:48:56 +00:00
|
|
|
.br
|
|
|
|
Morgana <morganamilo@gmail\&.com>
|