aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authordylan.araps@gmail.com <dylan.araps@gmail.com>2020-01-29 10:36:21 +0000
committerdylan.araps@gmail.com <dylan.araps@gmail.com>2020-01-29 10:36:21 +0000
commitccc8af1e35a9cad5b83d819662be27b4ea107fed (patch)
tree2ebd89968c794fdd682862da9240c7f2c05bab25
parentca69c5c03d6ac42da858cf93556799df59ce66bf (diff)
downloadcpt-ccc8af1e35a9cad5b83d819662be27b4ea107fed.tar.gz
docs: update
FossilOrigin-Name: a023f69c4c9e6872d426532f13c19d1a5570c48d92c8fe338e8100380a288a06
-rw-r--r--kiss.188
1 files changed, 88 insertions, 0 deletions
diff --git a/kiss.1 b/kiss.1
index 19e24cd..f9808f4 100644
--- a/kiss.1
+++ b/kiss.1
@@ -135,3 +135,91 @@ export CMAKE_GENERATOR=
.
.fi
.
+.SH "Alternatives System"
+.
+.nf
+
+When a package with conflicts is installed with KISS_CHOICE=1,
+the conflicting files will be added as "choices" to the
+alternatives system.
+
+Afterwards, running kiss a/kiss alternatives will list all of
+the choices you are able to make. Each line of output with this
+command is also usable directly as input.
+
+NOTE: If a package has fewer than 10 conflicting files, the
+conflicting files will automatically be added to the alternatives
+system.
+
+Example usage:
+
+# List alternatives.
+-> kiss a
+-> Alternatives:
+ncurses /usr/bin/clear
+ncurses /usr/bin/reset
+
+# Swap to ncurses 'clear'.
+-> kiss a ncurses /usr/bin/clear
+-> Swapping '/usr/bin/clear' from 'busybox' to 'ncurses'
+Password:
+
+# New listing (busybox clear was swapped out).
+-> kiss a
+-> Alternatives:
+busybox /usr/bin/clear
+ncurses /usr/bin/reset
+
+Example usage (complex):
+
+-> kiss i sbase
+# More lines...
+/var/db/kiss/installed/util-linux/manifest:/usr/bin/renice
+/var/db/kiss/installed/util-linux/manifest:/usr/bin/logger
+/var/db/kiss/installed/util-linux/manifest:/usr/bin/flock
+/var/db/kiss/installed/util-linux/manifest:/usr/bin/cal
+!> Package 'sbase' conflicts with another package
+!> Run 'KISS_CHOICE=1 kiss i sbase' to add conflicts
+!> as alternatives.
+
+# There were more than 10 conflicts so the alternatives system
+# must be manually enabled for this package.
+-> KISS_CHOICE=1 kiss i sbase
+# More lines...
+-> sbase Found conflict (/usr/bin/renice), adding choice
+-> sbase Found conflict (/usr/bin/logger), adding choice
+-> sbase Found conflict (/usr/bin/flock), adding choice
+-> sbase Found conflict (/usr/bin/cal), adding choice
+-> sbase Installing package incrementally
+-> sbase Installed successfully
+
+# List alternatives.
+-> kiss a
+-> Alternatives:
+# More lines...
+sbase /usr/bin/uuencode
+sbase /usr/bin/wc
+sbase /usr/bin/which
+sbase /usr/bin/whoami
+sbase /usr/bin/xargs
+sbase /usr/bin/yes
+
+# Swapping in bulk (all of sbase).
+# The 'kiss a' command with '-' as an argument will read
+# from stdin and use each line as arguments to 'kiss a'.
+kiss a | grep ^sbase | kiss a -
+
+# New listing, sbase has replaced busybox utilities.
+-> kiss a
+-> Alternatives:
+# More lines...
+busybox /usr/bin/uuencode
+busybox /usr/bin/wc
+busybox /usr/bin/which
+busybox /usr/bin/whoami
+busybox /usr/bin/xargs
+busybox /usr/bin/yes
+
+# NOTE: One sbase utility currently has issues with kiss.
+# 'tar'. You will need to be swapped back to 'busybox'
+kiss a busybox /usr/bin/tar