COMMAND COMMENT
# apt update ... the output on screen will show the sources that are
being accessed by the system to provide the latest packages
for the system to download. The process refreshes the system's
listings of the most recent available packages.
# apt upgrade ... the output on screen shows the packages that will be upgraded
and the user can just press enter to start the process. The
apt command will not remove packages. It is wise to inspect
the listings to see what is being upgraded, and what may not
be being upgraded, since the output may list what it's not
upgrading as well.
If you add the -y option, the upgrade will assume "yes" and
not stop and ask to provide some information or questions
which it may do if the -y is not present. Personally, I don't
use -y for this but rather prefer to see if information does
appear. It doesn't always appear, so it may make no
difference at times.
# apt dist-upgrade ... This command is usually used when upgrading from
one release to another, like from debian bookworm to
trixie. Once trixie is set, often this command is
unnecessary and so not used until the next release
in a couple of years. However, it can be used if the
user wants some more recent versions of packages
and they are available. This command will remove
packages if it sees fit, for example when it thinks it
needs to remove an older package for a newer one
and there's some conflict that needs to be resolved.
The ordinary upgrade command will not remove
packages. So, with this command, when the output
appears on screen, it's useful to examine it to see
what will be removed and then not run the command
if one doesn't agree with the removal.