summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDrew DeVault <sir@cmpwn.com>2020-01-06 23:00:49 -0500
committerTimo Teräs <timo.teras@iki.fi>2020-01-26 09:01:26 +0200
commit77ab319958b00e0f972482286704185487577d25 (patch)
tree76174062a53bf130cff069ce42cb54b1f63c0985
parent9ce9cd2588bfb31592531b92fd757400d475b47d (diff)
downloadapk-tools-77ab319958b00e0f972482286704185487577d25.tar.gz
apk-tools-77ab319958b00e0f972482286704185487577d25.tar.bz2
apk-tools-77ab319958b00e0f972482286704185487577d25.tar.xz
apk-tools-77ab319958b00e0f972482286704185487577d25.zip
add apk-upgrade(8)
-rw-r--r--doc/Makefile1
-rw-r--r--doc/apk-upgrade.8.scd64
2 files changed, 65 insertions, 0 deletions
diff --git a/doc/Makefile b/doc/Makefile
index 06fe066..f74ae8c 100644
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -9,6 +9,7 @@ docs: $(obj)/apk.8 \
$(obj)/apk-del.8 \
$(obj)/apk-fix.8 \
$(obj)/apk-update.8 \
+ $(obj)/apk-upgrade.8 \
$(obj)/apk-repositories.5 \
$(obj)/apk-world.5
targets += docs
diff --git a/doc/apk-upgrade.8.scd b/doc/apk-upgrade.8.scd
new file mode 100644
index 0000000..f3f95b2
--- /dev/null
+++ b/doc/apk-upgrade.8.scd
@@ -0,0 +1,64 @@
+apk-upgrade(8)
+
+# NAME
+
+apk upgrade - upgrade installed packages
+
+# SYNOPSIS
+
+*apk upgrade* [<_options_>...]
+
+# DESCRIPTION
+
+*apk upgrade* upgrades installed packages to the latest version available from
+configured package repositories (see *apk-repositories*(5)).
+
+# OPTIONS
+
+## COMMIT OPTIONS
+
+*apk upgrade* commits the database, and supports the same options as other
+commit operations.
+
+*-s, --simulate*
+ Simulate the requested operation without making any changes.
+
+*--clean-protected*
+ Do not create .apk-new files in configuration directories.
+
+*--overlay-from-stdin*
+ Read list of overlay files from stdin.
+
+*--no-scripts*
+ Do not execute any scripts.
+
+*--no-commit-hooks*
+ Skip pre/post hook scripts (but not other scripts).
+
+*--initramfs-diskless-boot*
+ Enables options for diskless initramfs boot (e.g. skip hooks).
+
+## UPGRADE OPTIONS
+
+The following options affect the *upgrade* operation.
+
+*-a, --available*
+ Resets version constraints in _world_ (see *apk-world*(5)) and prefers
+ replacing or downgrading packages if the currently installed package is
+ no longer available from any repository (instead of holding them).
+
+*-l, --latest*
+ Disables normal heuristics for choosing which repository to install a
+ package from, preferring only repositories from which the latest
+ version is available. This has no effect on pinned packages.
+
+*--no-self-upgrade*
+ Do not do an early upgrade of the 'apk-tools' package.
+
+*--self-upgrade-only*
+ Only perform a self-upgrade of the 'apk-tools' package.
+
+# AUTHORS
+
+Natanael Copa <ncopa@alpinelinux.org>++
+Timo Teräs <_timo.teras@iki.fi_>