.\" Automatically generated by Pandoc 2.17.1.1
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "Nala" "8" "09 Feb 2023" "0.12.2" "'Nala User Manual'"
.hy
.SH NAME
.PP
Nala - Front-end for libapt-pkg
.SH SYNOPSIS
.PP
\f[B]nala\f[R] <\f[I]command\f[R]> [\f[I]--options\f[R]] PKGS ...
.SH DESCRIPTION
.PP
\f[B]nala\f[R] is a prettier front-end for libapt-pkg.
.PP
The goals of \f[B]nala\f[R] are to be similar to \f[B]apt\f[R] but add
quality of life changes, and improve the output to make it more reader
friendly.
.SH COMMANDS
.PP
\f[B]install\f[R]
.RS
.PP
\f[B]nala\f[R] takes multiple packages as arguments and will install all
of them just like \f[B]apt\f[R].
.PP
\f[B]nala\f[R] downloads packages in parallel.
Along with this \f[B]nala\f[R] can download packages from multiple
mirrors concurrently to speed up downloads further.
We put in place a limit to 3 packages per mirror so we don\[aq]t put too
much pressure on them.
This caps out at a maximum of 16.
.PP
For more information and options run \f[B]nala install\f[R]
\f[I]--help\f[R]
.RE
.PP
\f[B]remove\f[R]
.RS
.PP
\f[B]remove\f[R] works similar to the way it does in \f[B]apt\f[R], but
\f[B]nala\f[R] will also autoremove packages.
.PP
For more information and options run \f[B]nala remove\f[R]
\f[I]--help\f[R]
.RE
.PP
\f[B]purge\f[R]
.RS
.PP
\f[B]purge\f[R] works similar to \f[B]remove\f[R], but also gets rid of
configuration files.
.PP
For more information and options run \f[B]nala purge\f[R]
\f[I]--help\f[R]
.RE
.PP
\f[B]update\f[R]
.RS
.PP
\f[B]update\f[R] updates the package list.
Works exactly like \f[B]apt update\f[R] with better formatting.
.RE
.PP
\f[B]upgrade\f[R]
.RS
.PP
\f[B]upgrade\f[R] upgrades packages installed on the system.
.PP
By default \f[B]nala\f[R] will run the equivalent of \f[B]apt update &&
apt full-upgrade\f[R] \f[I]--auto-remove\f[R].
.PP
This behavior can be changed in the configuration file or you can use
\f[B]nala upgrade\f[R] \f[I]--no-update\f[R].
.PP
For more information and options run \f[B]nala upgrade\f[R]
\f[I]--help\f[R]
.RE
.PP
\f[B]autoremove\f[R]
.RS
.PP
\f[B]autoremove\f[R] removes any packages that are no longer needed.
.PP
For more information and options run \f[B]nala autoremove\f[R]
\f[I]--help\f[R]
.RE
.PP
\f[B]autopurge\f[R]
.RS
.PP
\f[B]autopurge\f[R] purges any packages that are no longer needed.
.PP
For more information and options run \f[B]nala autopurge\f[R]
\f[I]--help\f[R]
.RE
.PP
\f[B]clean\f[R]
.RS
.PP
\f[B]clean\f[R] will remove any \f[I].deb\f[R] files in the archive
directory, typically \f[I]/var/cache/apt/archives\f[R]
.PP
For more information and options run \f[B]nala clean\f[R]
\f[I]--help\f[R]
.RE
.PP
\f[B]fetch\f[R]
.RS
.PP
\f[B]fetch\f[R] is the first command that doesn\[aq]t have an
\f[B]apt\f[R] counterpart.
.TP
\f[B]nala\f[R] will parse either:
the \f[B]Debian\f[R] mirror list from
\f[I]https://mirror-master.debian.org/status/Mirrors.masterlist\f[R],
.RS
.PP
or the \f[B]Ubuntu\f[R] mirror list from
\f[I]https://launchpad.net/ubuntu/+archivemirrors-rss\f[R]
.RE
.PP
\f[B]nala\f[R] will then select the mirrors that it has determined are
the fastest.
.PP
This is done by downloading the Release file and timing how long it
takes.
.PP
For more information and options run \f[B]nala fetch\f[R]
\f[I]--help\f[R]
.RE
.PP
\f[B]show\f[R]
.RS
.PP
\f[B]show\f[R] information about the given package(s) highlighted with
color to improve readability.
.PP
For more information and options run \f[B]nala show\f[R]
\f[I]--help\f[R]
.RE
.PP
\f[B]search\f[R]
.RS
.PP
\f[B]search\f[R] all packages in the cache with a regex string.
By default searches package names, source names, and descriptions.
.PP
For more information and options run \f[B]nala search\f[R]
\f[I]--help\f[R]
.RE
.PP
\f[B]list\f[R]
.RS
.PP
\f[B]list\f[R] packages in the cache.
.PP
For more information and options run \f[B]nala list\f[R]
\f[I]--help\f[R]
.RE
.PP
\f[B]history\f[R]
.RS
.PP
\f[B]history\f[R] is another command not found in \f[B]apt\f[R].
Every \f[B]install\f[R], \f[B]remove\f[R], or \f[B]upgrade\f[R] command
is stored with an id.
You can use \f[B]history\f[R] to view these in a summary style view, and
even go more in depth with \f[B]history info [id]\f[R].
If you\[aq]re familiar with how \f[I]Fedora\f[R]\[aq]s \f[B]dnf
history\f[R] command works, then you\[aq]ll feel right at home.
.PP
This command is inspired by \f[B]dnf\f[R]\[aq]s history functionality.
.PP
For more information and options run \f[B]nala history\f[R]
\f[I]--help\f[R]
.RE
.SH EXAMPLES
.TP
\f[B]nala install\f[R] \f[I]--update\f[R] \f[B]wine\f[R]
downloads and installs wine, updating the package cache first.
.TP
\f[B]nala upgrade\f[R] \f[I]--no-update\f[R]
upgrades the system without updating the package cache.
.TP
\f[B]nala fetch\f[R] \f[I]--auto --fetches\f[R] \f[B]8\f[R] \f[I]--country\f[R] \f[B]US\f[R]
fetches 8 mirrors in the United States uninteractively.
.SH BUGS
.PP
Submit bug reports and feature requests online at:
.RS
.PP
<\f[I]https://gitlab.com/volian/nala/-/issues\f[R]>
.RE
.SH SEE ALSO
.PP
Sources at: <\f[I]https://gitlab.com/volian/nala\f[R]>
.SH AUTHORS
.PP
Blake Lee <\f[I]https://gitlab.com/volitank\f[R]>
<\f[I]blake\[at]volian.org\f[R]>
.PP
volian-team <\f[I]https://gitlab.com/volian\f[R]>
<\f[I]volian-devel\[at]volian.org\f[R]>
.SH COPYRIGHT
.PP
Copyright (C) 2021, 2022 Blake Lee