.\" 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-upgrade" "8" "09 Feb 2023" "0.12.2" "'Nala User Manual'"
.hy
.SH NAME
.PP
nala-upgrade - Update the package list and upgrade the system
.SH SYNOPSIS
.PP
\f[B]nala upgrade\f[R] [\f[I]--options\f[R]]
.SH DESCRIPTION
.PP
By default \f[B]nala\f[R] will run the equivalent of \f[B]apt update &&
apt full-upgrade --auto-remove\f[R].
.TP
If you are just looking to update the package cache and not actually perform an upgrade you can use:
\f[B]nala update\f[R]
.SH OPTIONS
.TP
\f[B]--exclude\f[R]
Specify packages to exclude during upgrade.
Accepts globs*
.RS
.TP
\f[I]--exclude\f[R] only takes one package as an argument, but can be specified multiple times:
\f[B]nala upgrade\f[R] \f[I]--exclude\f[R] \f[B]apt\f[R]
\f[I]--exclude\f[R] \f[B]dpkg\f[R]
.PP
NOTE: Due to the way that excusions are handled, you may want to
additionally supply \f[I]--no-full\f[R] to ensure \f[B]Nala\f[R]
doesn\[aq]t remove packages you plan to keep.
.RE
.TP
\f[B]--full\f[R], \f[B]--no-full\f[R]
.TP
\f[I]--full\f[R]
This will run the equivalent of \f[B]apt full-upgrade\f[R]
.RS
.PP
This variant is the \f[B]default\f[R]
.RE
.TP
\f[I]--no-full\f[R]
This will run the equivalent of \f[B]apt-get upgrade\f[R]
.TP
\f[B]--purge\f[R]
Purge any packages that would removed during the transaction.
.TP
\f[B]--debug\f[R]
Print helpful information for solving issues.
If you\[aq]re submitting a bug report try running the command again with
\f[I]--debug\f[R] and providing the output to the devs, it may be
helpful.
.TP
\f[B]--raw-dpkg\f[R]
Force \f[B]nala\f[R] not to format \f[B]dpkg\f[R] output.
.RS
.PP
This disables all formatting and it would look as if you were using
\f[B]apt\f[R].
.PP
A more indepth explanation for what this switch does, \f[B]nala\f[R]
will fork a tty instead of a pty for \f[B]dpkg\f[R].
.PP
\f[B]nala\f[R] will also not display a progress bar for \f[B]dpkg\f[R]
with this turned on.
Additionally the language of the output will not be forced into English
for this mode.
.RE
.TP
\f[B]-d\f[R], \f[B]--download-only\f[R]
Packages are only retrieved, not unpacked or installed.
.TP
\f[B]--remove-essential\f[R]
Allow the removal of essential packages.
.RS
.PP
This is very dangerous, but we thought you should have the option.
.RE
.PP
\f[B]--assume-yes\f[R], \f[B]--assume-no\f[R]
.RS
.PP
\f[I]-y\f[R], \f[I]--assume-yes\f[R]
.RS
.PP
Automatically select \f[I]yes\f[R] for any prompts which may need your
input.
.PP
If the configuration option \f[I]assume_yes\f[R] is true, this switch
will set it back to default behavior
.RE
.PP
\f[I]-n\f[R], \f[I]--assume-no\f[R]
.RS
.PP
Automatically select \f[I]no\f[R] for any prompts which may need your
input.
.RE
.RE
.PP
\f[B]--simple\f[R], \f[B]--no-simple\f[R]
.RS
.PP
\f[I]--simple\f[R]
.RS
.PP
Show a more simple and condensed transaction summary.
.RE
.PP
\f[I]--no-simple\f[R]
.RS
.PP
Show the standard table transatction summary with more information.
.PP
This variant is the \f[B]default\f[R]
.RE
.RE
.TP
\f[B]-o\f[R], \f[B]--option\f[R]
Set options to pass through to \f[B]apt\f[R], \f[B]nala\f[R], or
\f[B]dpkg\f[R].
.RS
.TP
Example:
Force \f[B]dpkg\f[R] to install new config files without prompting:
.RS
.RS
.PP
\f[B]nala install --option\f[R]
\f[I]Dpkg::Options::=\[dq]--force-confnew\[dq]\f[R]
.RE
.PP
Disable scrolling text for \f[B]nala\f[R]
.RS
.PP
\f[B]nala install --option\f[R]
\f[I]Nala::scrolling_text=\[dq]false\[dq]\f[R]
.RE
.PP
Allow \f[B]nala\f[R] to \f[B]update\f[R] unauthenticated repositories:
.RS
.PP
\f[B]nala install --option\f[R]*
\f[I]APT::Get::AllowUnauthenticated=\[dq]true\[dq]\f[R]
.RE
.RE
.RE
.TP
\f[B]-v\f[R], \f[B]--verbose\f[R]
Disable scrolling text and print extra information
.TP
\f[B]-h\f[R], \f[B]--help\f[R]
Shows this man page.
.TP
\f[B]--autoremove\f[R], \f[B]--no-autoremove\f[R]
\f[I]--autoremove\f[R]
.RS
.RS
.PP
Automatically remove any packages that are no longer needed.
.PP
This variant is the \f[B]default\f[R]
.RE
.PP
\f[I]--no-autoremove\f[R]
.RS
.PP
Do \f[B]NOT\f[R] Automatically remove any packages
.RE
.RE
.TP
\f[B]--update\f[R], \f[B]--no-update\f[R]
\f[I]--update\f[R]
.RS
.RS
.PP
Update the package list before the requested operation.
.PP
Example:
.RS
.PP
\f[B]nala install\f[R] \f[I]--update\f[R] \f[B]neofetch\f[R]
.PP
is equivalent to
.PP
\f[B]apt update\f[R] && \f[B]apt install neofetch\f[R]
.RE
.PP
[Default for: \f[B]upgrade\f[R]]
.RE
.PP
\f[I]--no-update\f[R]
.RS
.PP
Do \f[B]NOT\f[R] update the package list before the requested operation.
.PP
[Default for: \f[B]install\f[R], \f[B]remove\f[R], \f[B]purge\f[R],
\f[B]autoremove\f[R], \f[B]autopurge\f[R]]
.RE
.RE
.TP
\f[B]--install-recommends\f[R], \f[B]--no-install-recommends\f[R]
\f[I]--install-recommends\f[R]
.RS
.RS
.PP
Recommended packages will be installed.
.PP
This variant is the \f[B]default\f[R] unless changed with the
\f[B]apt\f[R] config.
.RE
.PP
\f[I]--no-install-recommends\f[R]
.RS
.PP
Recommended package will \f[B]NOT\f[R] be installed.
.PP
If this option is selected \f[B]nala\f[R] will display the recommended
packages that will not be installed.
.RE
.RE
.TP
\f[B]--install-suggests\f[R], \f[B]--no-install-suggests\f[R]
\f[I]--install-suggests\f[R]
.RS
.RS
.PP
Suggested packages will be installed.
.PP
This variant is the \f[B]default\f[R]
.RE
.PP
\f[I]--no-install-suggests\f[R]
.RS
.PP
This variant is the \f[B]default\f[R] unless changed with the
\f[B]apt\f[R] config.
.PP
If this option is selected \f[B]nala\f[R] will display the suggested
packages that will not be installed.
.RE
.RE
.TP
\f[B]--fix-broken\f[R], \f[B]--no-fix-broken\f[R]
\f[I]--fix-broken\f[R]
.RS
.RS
.PP
Attempts to fix broken packages.
.PP
This variant is the \f[B]default\f[R]
.RE
.PP
\f[I]--no-fix-broken\f[R]
.RS
.PP
Stops \f[B]nala\f[R] from performing extra checks.
.PP
\f[I]This can result in a broken install\f[R]!
.RE
.PP
If you just want to fix broken packages:
.RS
.PP
\f[B]nala install\f[R] \f[I]--fix-broken\f[R]
.RE
.RE
.SH COPYRIGHT
.PP
Copyright (C) 2021, 2022 Blake Lee