From 6d507b90727aa02fbe358d2bbe457e68121fcbd5 Mon Sep 17 00:00:00 2001 From: Drew DeVault Date: Mon, 6 Jan 2020 22:40:54 -0500 Subject: add apk-add(8) --- doc/Makefile | 1 + doc/apk-add.8.scd | 69 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 70 insertions(+) create mode 100644 doc/apk-add.8.scd diff --git a/doc/Makefile b/doc/Makefile index 310a4c3..b1fce65 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -5,6 +5,7 @@ $(obj)/%.8: $(src)/%.8.scd $(SCDOC) < $< > $@ docs: $(obj)/apk.8 \ + $(obj)/apk-add.8 \ $(obj)/apk-repositories.5 \ $(obj)/apk-world.5 targets += docs diff --git a/doc/apk-add.8.scd b/doc/apk-add.8.scd new file mode 100644 index 0000000..ab9ca49 --- /dev/null +++ b/doc/apk-add.8.scd @@ -0,0 +1,69 @@ +apk-add(8) + +# NAME + +apk add - add packages to _world_ and commit changes + +# SYNOPSIS + +*apk add* [<_options_>...] _packages_... + +# DESCRIPTION + +*apk add* adds the requested packages to _world_ and installs (or upgrades) +them if not already present, ensuring all dependencies are met. + +# OPTIONS + +## COMMIT OPTIONS + +*apk add* 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). + +## ADD OPTIONS + +The following options affect the *add* operation. + +*--initdb* + Initialize a new package database. + +*-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. + +*-u, --upgrade* + When adding packages which are already installed, upgrade them rather + than considering the requirement fulfilled by the current installation. + +*-t, --virtual* _NAME_ + Instead of adding the specified packages to _world_, create a new + virtual package with the listed packages as its dependencies, then add + that package to _world_. + + The packages requested are added as transitive dependencies of the + virtual package, and by deleting that package the *apk add* operation + may be easily reverted later. + +# AUTHORS + +Natanael Copa ++ +Timo Teräs <_timo.teras@iki.fi_> -- cgit v1.2.3