aboutsummaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
Diffstat (limited to 'man')
-rw-r--r--man/cpt-alternatives.144
-rw-r--r--man/cpt-build.115
-rw-r--r--man/cpt-checksum.114
-rw-r--r--man/cpt-contrib.1 (renamed from man/kiss-contrib.1)96
-rw-r--r--man/cpt-download.113
-rw-r--r--man/cpt-fetch.111
-rw-r--r--man/cpt-install.120
-rw-r--r--man/cpt-list.113
-rw-r--r--man/cpt-remove.120
-rw-r--r--man/cpt-search.115
-rw-r--r--man/cpt-update.122
-rw-r--r--man/cpt.1179
-rw-r--r--man/kiss.1271
13 files changed, 414 insertions, 319 deletions
diff --git a/man/cpt-alternatives.1 b/man/cpt-alternatives.1
new file mode 100644
index 0000000..16023a6
--- /dev/null
+++ b/man/cpt-alternatives.1
@@ -0,0 +1,44 @@
+.TH "cpt-alternatives" "1" "2020-07-24" "CARBS LINUX" "General Commands Manual"
+.SH NAME
+cpt-alternatives
+.SH DESCRIPTION
+List and swap to alternatives
+.PP
+.SH SYNOPSIS
+\fBcpt-alternatives\fR [-] [pkg file]
+
+.SH USAGE
+cpt-alternatives can be used to list alternatives (when run without arguments).
+It can read from standard input if ('-' is given as an argument). If you want to
+otherwise
+
+.SH EXAMPLES
+.nf
++-----------------------------------------------------------------------+
+| List alternatives |
++-----------------------------------------------------------------------+
+| |
+| $ kiss a |
+| ncurses /usr/bin/clear |
+| ncurses /usr/bin/reset |
+| |
++-----------------------------------------------------------------------+
+| Swap to 'clear' from ncurses. |
++-----------------------------------------------------------------------+
+| |
+| $ kiss a ncurses /usr/bin/clear |
+| -> Swapping '/usr/bin/clear' from 'busybox' to 'ncurses' |
+| |
++-----------------------------------------------------------------------+
+| Swap in bulk (all of sbase). |
++-----------------------------------------------------------------------+
+| |
+| $ kiss a | grep ^sbase | kiss a - |
+| |
++-----------------------------------------------------------------------+
+.fi
+
+.SH LICENSE
+See LICENSE for copyright information.
+.SH SEE ALSO
+cpt(1)
diff --git a/man/cpt-build.1 b/man/cpt-build.1
new file mode 100644
index 0000000..3abd44f
--- /dev/null
+++ b/man/cpt-build.1
@@ -0,0 +1,15 @@
+.TH "cpt-build" "1" "2020-07-24" "CARBS LINUX" "General Commands Manual"
+.SH NAME
+cpt-build
+.PP
+.SH SYNOPSIS
+\fBcpt-build\fR [pkg...]
+
+.SH DESCRIPTION
+cpt-build will build given packages and their dependencies. If multiple packages
+are specified, it will ask to install the packages as well.
+
+.SH LICENSE
+See LICENSE for copyright information.
+.SH SEE ALSO
+cpt(1)
diff --git a/man/cpt-checksum.1 b/man/cpt-checksum.1
new file mode 100644
index 0000000..5c16b36
--- /dev/null
+++ b/man/cpt-checksum.1
@@ -0,0 +1,14 @@
+.TH "cpt-checksum" "1" "2020-07-24" "CARBS LINUX" "General Commands Manual"
+.SH NAME
+cpt-checksum
+.SH SYNOPSIS
+\fBcpt-checksum\fR [pkg...]
+
+.SH DESCRIPTION
+cpt-checksum lints a package, downloads the sources, and creates a checksum file
+including the SHA256 digests of the sources.
+
+.SH LICENSE
+See LICENSE for copyright information.
+.SH SEE ALSO
+cpt(1)
diff --git a/man/kiss-contrib.1 b/man/cpt-contrib.1
index aeeab69..8a34364 100644
--- a/man/kiss-contrib.1
+++ b/man/cpt-contrib.1
@@ -1,51 +1,51 @@
-.TH KISS-CONTRIB 1 2020-04-04 "CARBS LINUX" "General Commands Manual"
+.TH CPT-CONTRIB 1 2020-04-04 "CARBS LINUX" "General Commands Manual"
.SH NAME
-kiss utilities
+cpt utilities
.SH DESCRIPTION
This manual page is not for a single program, but for multiple
utilities. Programs are explained in their own sections. They
are listed alphabetically.
-.SH KISS-CAT
-.B kiss-cat
+.SH CPT-CAT
+.B cpt-cat
<pkg> [file] [file]
Concatanates a package's files inside the system database. If no file is
specified, it looks for \fBbuild\fR, \fBdepends\fR, \fBsources\fR, and
\fBversion\fR.
-.SH KISS-CHBUILD
-.B kiss-chbuild
+.SH CPT-CHBUILD
+.B cpt-chbuild
-kiss-chbuild, creates a temporary rootfs, and chroots into it.
+cpt-chbuild, creates a temporary rootfs, and chroots into it.
-If it doesn't already exist, kiss-chbuild downloads the rootfs tarball to
+If it doesn't already exist, cpt-chbuild downloads the rootfs tarball to
your cache directory and extracts it into a \fBcarbs-chroot\fR directory.
-It then copies the chroot to a temporary directory, and runs kiss-chroot
+It then copies the chroot to a temporary directory, and runs cpt-chroot
to it. It removes the temporary chroot after the user exits.
-.SH KISS-CHROOT
-.B kiss-chroot
+.SH CPT-CHROOT
+.B cpt-chroot
<directory>
Mounts the required devices to the given directory, copies /etc/resolv.conf
from host, and chroots into the given directory. Cleans up after exit.
-.SH KISS-DEPENDS
-.B kiss-depends
+.SH CPT-DEPENDS
+.B cpt-depends
<pkg>
Checks the dependencies of an installed package.
-.SH KISS-EXPORT
-.B kiss-export
+.SH CPT-EXPORT
+.B cpt-export
<pkg>
Exports a package tarball of an installed package.
-.SH KISS-FORK
-.B kiss-fork
+.SH CPT-FORK
+.B cpt-fork
<pkg>
Copies the repository directory of the given package to the current working
directory.
-.SH KISS-LINK
-.B kiss-link
+.SH CPT-LINK
+.B cpt-link
[file] [file]
Links files from a package in the repository. It looks for the package by
@@ -54,73 +54,73 @@ value.
.IP \fBExample:\fR
.nf
-$ kiss-fork git
+$ cpt-fork git
forked package to /home/cem/.local/repositories/overrides/git
$ cd git
-$ kiss-link checksums version sources
+$ cpt-link checksums version sources
linked /home/cem/.local/repositories/main/core/git/version to /home/cem/.local/repositories/overrides/git/version
linked /home/cem/.local/repositories/main/core/git/sources to /home/cem/.local/repositories/overrides/git/sources
linked /home/cem/.local/repositories/main/core/git/checksums to /home/cem/.local/repositories/overrides/git/checksums
.fi
.PP
-.SH KISS-MANIFEST
-.B kiss-manifest
+.SH CPT-MANIFEST
+.B cpt-manifest
<pkg>
Prints the manifest file.
-.SH KISS-MANIFEST-TREE
-.B kiss-manifest-tree
+.SH CPT-MANIFEST-TREE
+.B cpt-manifest-tree
<pkg>
Prints the manifest file in a tree view.
-.SH KISS-NEW
-.B kiss-new
+.SH CPT-NEW
+.B cpt-new
<name> [version] [sources]
-Creates a boilerplate KISS package.
-.SH KISS-OUTDATED
-.B kiss-outdated
+Creates a boilerplate CPT package.
+.SH CPT-OUTDATED
+.B cpt-outdated
Checks \fIrepology.org\fR to see if any installed packages are outdated. This
can be used to check if personal packages are outdated.
-.SH KISS-OWNS
-.B kiss-owns
+.SH CPT-OWNS
+.B cpt-owns
<file>
Checks which package has installed the given file.
-.SH KISS-READLINK
-.B kiss-readlink
+.SH CPT-READLINK
+.B cpt-readlink
<file>
A 'readlink -f' replacement to be used inside the package manager.
-.SH KISS-REPODEPENDS
-.B kiss-repodepends
+.SH CPT-REPODEPENDS
+.B cpt-repodepends
<pkg>
Prints the dependencies of the given package as they are defined in the repository.
-.SH KISS-RESET
-.B kiss-reset
+.SH CPT-RESET
+.B cpt-reset
Removes all packages except the base packages.
-.SH KISS-REVDEPENDS
-.B kiss-revdepends
+.SH CPT-REVDEPENDS
+.B cpt-revdepends
<pkg>
Prints the packages that depend on the given package. (Reverse dependencies)
-.SH KISS-SIZE
-.B kiss-size
+.SH CPT-SIZE
+.B cpt-size
<pkg>
Prints the given package's size, and its individual files.
-.SH KISS-STAT
-.B kiss-stat
+.SH CPT-STAT
+.B cpt-stat
<file>
Outputs the owner name of a file/directory
-.SH KISS-WHICH
-.B kiss-which
+.SH CPT-WHICH
+.B cpt-which
<pkg>
-A \fIwhich\fR-like utility for KISS packages.
+A \fIwhich\fR-like utility for CPT packages.
.SH SEE ALSO
-kiss(1)
+cpt(1)
diff --git a/man/cpt-download.1 b/man/cpt-download.1
new file mode 100644
index 0000000..d940936
--- /dev/null
+++ b/man/cpt-download.1
@@ -0,0 +1,13 @@
+.TH "cpt-checksum" "1" "2020-07-24" "CARBS LINUX" "General Commands Manual"
+.SH NAME
+cpt-download
+.SH SYNOPSIS
+\fBcpt-download\fR [pkg...]
+
+.SH DESCRIPTION
+cpt-download downloads the sources of the given packages
+
+.SH LICENSE
+See LICENSE for copyright information.
+.SH SEE ALSO
+cpt(1)
diff --git a/man/cpt-fetch.1 b/man/cpt-fetch.1
new file mode 100644
index 0000000..b3336b5
--- /dev/null
+++ b/man/cpt-fetch.1
@@ -0,0 +1,11 @@
+.TH "cpt-fetch" "1" "2020-07-24" "CARBS LINUX" "General Commands Manual"
+.SH NAME
+cpt-fetch
+
+.SH DESCRIPTION
+cpt-fetch fetches the repositories stored under the \fI$CPT_PATH\fR variable.
+
+.SH LICENSE
+See LICENSE for copyright information.
+.SH SEE ALSO
+cpt(1)
diff --git a/man/cpt-install.1 b/man/cpt-install.1
new file mode 100644
index 0000000..27ff2c3
--- /dev/null
+++ b/man/cpt-install.1
@@ -0,0 +1,20 @@
+.TH "cpt-install" "1" "2020-07-24" "CARBS LINUX" "General Commands Manual"
+.SH NAME
+cpt-install
+.SH SYNOPSIS
+\fBcpt-install\fR [options] [pkg...]
+
+.SH OPTIONS
+.TP
+\fB--force\fR Force installation
+.TP
+\fB--root\fR [rootdir] Use an alternate root directory
+.PP
+
+.SH DESCRIPTION
+cpt-install installs the given packages.
+
+.SH LICENSE
+See LICENSE for copyright information.
+.SH SEE ALSO
+cpt(1)
diff --git a/man/cpt-list.1 b/man/cpt-list.1
new file mode 100644
index 0000000..8460e90
--- /dev/null
+++ b/man/cpt-list.1
@@ -0,0 +1,13 @@
+.TH "cpt-list" "1" "2020-07-24" "CARBS LINUX" "General Commands Manual"
+.SH NAME
+cpt-list
+.SH SYNOPSIS
+\fBcpt-list\fR [pkg...]
+.SH DESCRIPTION
+cpt-list can be used to list all packages or check if the given package is
+installed on the system.
+
+.SH LICENSE
+See LICENSE for copyright information.
+.SH SEE ALSO
+cpt(1)
diff --git a/man/cpt-remove.1 b/man/cpt-remove.1
new file mode 100644
index 0000000..78338e8
--- /dev/null
+++ b/man/cpt-remove.1
@@ -0,0 +1,20 @@
+.TH "cpt-remove" "1" "2020-07-24" "CARBS LINUX" "General Commands Manual"
+.SH NAME
+cpt-remove
+.SH SYNOPSIS
+\fBcpt-remove\fR [options] [pkg...]
+
+.SH OPTIONS
+.TP
+\fB--force\fR Force installation
+.TP
+\fB--root\fR [rootdir] Use an alternate root directory
+.PP
+
+.SH DESCRIPTION
+cpt-remove removes the given packages.
+
+.SH LICENSE
+See LICENSE for copyright information.
+.SH SEE ALSO
+cpt(1)
diff --git a/man/cpt-search.1 b/man/cpt-search.1
new file mode 100644
index 0000000..3a2f683
--- /dev/null
+++ b/man/cpt-search.1
@@ -0,0 +1,15 @@
+.TH "cpt-search" "1" "2020-07-24" "CARBS LINUX" "General Commands Manual"
+.SH NAME
+cpt-search
+.SH SYNOPSIS
+\fBcpt-search\fR [--single] [pkg...]
+
+.SH DESCRIPTION
+cpt-search can be used to search packages. Glob characters can be used in the
+search. If the \fI--single\fR option is specified cpt-search will only output
+the first match.
+
+.SH LICENSE
+See LICENSE for copyright information.
+.SH SEE ALSO
+cpt(1)
diff --git a/man/cpt-update.1 b/man/cpt-update.1
new file mode 100644
index 0000000..ec1acc6
--- /dev/null
+++ b/man/cpt-update.1
@@ -0,0 +1,22 @@
+.TH "cpt-update" "1" "2020-07-24" "CARBS LINUX" "General Commands Manual"
+.SH NAME
+cpt-update
+.SH SYNOPSIS
+\fBcpt-update\fR [options]
+
+.SH OPTIONS
+.TP
+\fB--download\fR Only download the updates
+.TP
+\fB--no-fetch\fR Do not refresh the repositories
+.TP
+\fB--root\fR [rootdir] Use an alternate root directory
+.PP
+
+.SH DESCRIPTION
+cpt-update checks for package updates.
+
+.SH LICENSE
+See LICENSE for copyright information.
+.SH SEE ALSO
+cpt(1)
diff --git a/man/cpt.1 b/man/cpt.1
new file mode 100644
index 0000000..3622db9
--- /dev/null
+++ b/man/cpt.1
@@ -0,0 +1,179 @@
+.TH "CPT" "1" "2020-04-19" "CARBS LINUX" "General Commands Manual"
+.SH NAME
+cpt
+.SH DESCRIPTION
+Package management toolchain for Carbs Linux.
+.PP
+.SH SYNOPSIS
+cpt [extension]
+.TP
+cpt will run the appropriate cpt-* command based on the arguments.
+
+.
+.fi
+.
+.SH CUSTOMIZATION
+.
+The package manager is controlled through environment variables.
+
+These can be set in your \fI~/.profile\fR or \fI/etc/profile.d\fR
+to have the options apply all the time.
+
+These can also be set in the current shell to have them apply
+only for the current session.
+
+\fBNOTE:\fR The values shown below are the defaults.
+
+.SS MANAGING REPOSITORIES
+.
+This works exactly like \fI$PATH\fR (Colon seperated).
+
+A list of repositories the package manager will use. You can
+add your own repositories or remove the default ones.
+.IP
+.nf
+export CPT_PATH=/var/db/cpt/repo/core:/var/db/cpt/repo/extra:/var/db/cpt/repo/xorg
+.fi
+.PP
+.SS FORCE PACKAGE INSTALLATION OR REMOVAL
+This can be used to bypass the dependency checks on installation
+and removal of packages.
+
+Set it to \fB'1'\fR to force.
+
+.IP
+.nf
+export CPT_FORCE=0
+.fi
+.PP
+.SS HOOK INTO CPT THROUGH A SCRIPT
+This can be used set custom CFLAGS per package, modify builds,
+etc. This environment variable must point to a shellscript.
+
+The script will have the following environment variables set.
+
+.TP
+.B $PKG:
+Name of the current package.
+.TP
+.B $TYPE:
+The type of hook (pre-build, post-build, build-fail, pre-install, post-install).
+.TP
+.B $DEST:
+The full path to where 'make install' will put the package.
+
+.PP
+.B SIMPLE EXAMPLE SCRIPT
+.nf
+
+case $TYPE in
+ pre-build)
+ case $PKG in
+ zlib) export CFLAGS="-Os -static" ;;
+ curl) export CFLAGS="-O3" ;;
+ esac
+ ;;
+
+ post-build)
+ : "${DEST:?DEST is unset}"
+
+ rm -rf "$DEST/usr/share/doc"
+ rm -rf "$DEST/usr/share/gettext"
+ ;;
+esac
+.fi
+
+export CPT_HOOK=/path/to/script
+.SS ROOT DIRECTORY
+
+Where installed packages will go. You won't ever need
+to touch this during normal usage.
+
+This can be used to have the package manager run in a "fake root".
+.IP
+export CPT_ROOT=/
+.PP
+
+.SS KEEPING LOGS
+Keep build logs around for successful builds and not just failing ones.
+Helpful when debugging.
+
+Set it to \fB'1'\fR to enable.
+.IP
+export CPT_KEEPLOG=0
+.PP
+.SS KEEPING BUILD FILES
+You can keep build, package and extraction cache directories for debugging
+purposes.
+
+Set it to \fB'1'\fR to enable.
+.IP
+export CPT_DEBUG=0
+.PP
+.SS CHANGING COMPRESSION METHOD
+\fBCPT\fR by default uses gzip for packaging, but it can be changed. Valid
+options are \fIbz2\fR, \fIgz\fR (default), \fIxz\fR, \fIzst\fR. If an unknown
+compression method is specified, it fallbacks to \fIgz\fR.
+.IP
+export CPT_COMPRESS=gz
+.PP
+.SS SUDO UTILITIES
+You can force the usage of a different \fB'sudo'\fR tool. Available options are
+\fIsu\fR, \fIsudo\fR, \fIdoas\fR.
+.IP
+export CPT_SU=
+.PP
+.SS USE A REPRODUCIBLE CACHE NAMING SCHEME
+
+The package manager builds packages inside \fIbuild-$PID/\fR with \fI$PID\fR
+being the package manager's process ID. This allows for multiple
+builds to happen at once.
+
+You can override this and \fIknow\fR the location beforehand with the
+below environment variable. \fICPT_PID=test\fR will build the package
+in \fIbuild-test\fR.
+
+Unset by default.
+.IP
+export CPT_PID=
+.PP
+.SS SPECIFYING BUILD DIRECTORY
+
+All build related files, by default, are stored in the cache directory. If the
+user specifies \fICPT_TMPDIR\fR, it will be used instead of the cache directory
+for building packages. This can be useful if you want to build a package on ram
+or a different filesystem.
+
+Unset by default.
+.IP
+export CPT_TMPDIR=
+.PP
+.SS ENABLING/DISABLING COLOUR
+
+If run in a subshell, \fBCPT\fR disables colour output. However, this behaviour
+can be overriden. If a user defines a \fICPT_COLOR\fR environment value, it will
+be enabled or disabled globally
+.IP
+export CPT_COLOR=1 # Enables globally
+.IP
+export CPT_COLOR=0 # Disables globally
+.PP
+.SS DISABLING PROMPTS
+User can disable prompts by setting a \fICPT_NOPROMPT\fR environment value. This
+can be useful for scripting purposes.
+
+.IP
+CPT_NOPROMPT=1 cpt-build pkg1 pkg2
+.PP
+
+.SH AUTHORS
+Cem Keylan, Fork Maintainer, Carbs Linux
+.br
+<cem@ckyln.com>
+.PP
+Dylan Araps, Original Author of the kiss package manager, KISS Linux
+
+.SH LICENSE
+See LICENSE for copyright information
+.SH SEE ALSO
+cpt-contrib(1) cpt-alternatives(1) cpt-install(1) rsync(1)
diff --git a/man/kiss.1 b/man/kiss.1
deleted file mode 100644
index 318eb20..0000000
--- a/man/kiss.1
+++ /dev/null
@@ -1,271 +0,0 @@
-.TH KISS "1" "2020-04-19" "CARBS LINUX" "General Commands Manual"
-.SH NAME
-kiss
-.SH DESCRIPTION
-Tiny and straightforward package manager for Carbs Linux
-written in POSIX sh. Forked from KISS Linux.
-.PP
-.SH SYNOPSIS
-.IP kiss
-[a|b|c|d|e|f|i|l|r|s|u|v] [pkg] [pkg] [pkg]
-.PP
-.SH OPTIONS
-.TP
-\fBalternatives\fR List and swap to alternatives
-.TP
-\fBbuild\fR Build a package
-.TP
-\fBchecksum\fR Generate checksums
-.TP
-\fBdownload\fR Download sources for the given package
-.TP
-\fBextension\fR List available kiss extensions
-.TP
-\fBfetch\fR Fetch repositories
-.TP
-\fBinstall\fR Install a package
-.TP
-\fBlist\fR List installed packages
-.TP
-\fBremove\fR Remove a package
-.TP
-\fBsearch\fR Search for a package
-.TP
-\fBupdate\fR Check for updates
-.TP
-\fBversion\fR Package manager version
-.PP
-
-.
-.fi
-.
-.SH CUSTOMIZATION
-.
-The package manager is controlled through environment variables.
-
-These can be set in your \fI~/.profile\fR or \fI/etc/profile.d\fR
-to have the options apply all the time.
-
-These can also be set in the current shell to have them apply
-only for the current session.
-
-\fBNOTE:\fR The values shown below are the defaults.
-
-.SS MANAGING REPOSITORIES
-.
-This works exactly like \fI$PATH\fR (Colon seperated).
-
-A list of repositories the package manager will use. You can
-add your own repositories or remove the default ones.
-.IP
-.nf
-export KISS_PATH=/var/db/kiss/repo/core:/var/db/kiss/repo/extra:/var/db/kiss/repo/xorg
-.fi
-.PP
-.SS FORCE PACKAGE INSTALLATION OR REMOVAL
-This can be used to bypass the dependency checks on installation
-and removal of packages.
-
-Set it to \fB'1'\fR to force.
-
-.IP
-.nf
-export KISS_FORCE=0
-.fi
-.PP
-.SS HOOK INTO KISS THROUGH A SCRIPT
-This can be used set custom CFLAGS per package, modify builds,
-etc. This environment variable must point to a shellscript.
-
-The script will have the following environment variables set.
-
-.TP
-.B $PKG:
-Name of the current package.
-.TP
-.B $TYPE:
-The type of hook (pre-build, post-build, build-fail, pre-install, post-install).
-.TP
-.B $DEST:
-The full path to where 'make install' will put the package.
-
-.PP
-.B SIMPLE EXAMPLE SCRIPT
-.nf
-
-case $TYPE in
- pre-build)
- case $PKG in
- zlib) export CFLAGS="-Os -static" ;;
- curl) export CFLAGS="-O3" ;;
- esac
- ;;
-
- post-build)
- : "${DEST:?DEST is unset}"
-
- rm -rf "$DEST/usr/share/doc"
- rm -rf "$DEST/usr/share/gettext"
- ;;
-esac
-.fi
-
-export KISS_HOOK=/path/to/script
-.SS ROOT DIRECTORY
-
-Where installed packages will go. You won't ever need
-to touch this during normal usage.
-
-This can be used to have the package manager run in a "fake root".
-.IP
-export KISS_ROOT=/
-.PP
-
-.SS KEEPING LOGS
-Keep build logs around for successful builds and not just failing ones.
-Helpful when debugging.
-
-Set it to \fB'1'\fR to enable.
-.IP
-export KISS_KEEPLOG=0
-.PP
-.SS KEEPING BUILD FILES
-You can keep build, package and extraction cache directories for debugging
-purposes.
-
-Set it to \fB'1'\fR to enable.
-.IP
-export KISS_DEBUG=0
-.PP
-.SS CHANGING COMPRESSION METHOD
-\fBKISS\fR by default uses gzip for packaging, but it can be changed. Valid
-options are \fIbz2\fR, \fIgz\fR (default), \fIxz\fR, \fIzst\fR. If an unknown
-compression method is specified, it fallbacks to \fIgz\fR.
-.IP
-export KISS_COMPRESS=gz
-.PP
-.SS SUDO UTILITIES
-You can force the usage of a different \fB'sudo'\fR tool. Available options are
-\fIsu\fR, \fIsudo\fR, \fIdoas\fR.
-.IP
-export KISS_SU=
-.PP
-.SS USE A REPRODUCIBLE CACHE NAMING SCHEME
-
-The package manager builds packages inside \fIbuild-$PID/\fR with \fI$PID\fR
-being the package manager's process ID. This allows for multiple
-builds to happen at once.
-
-You can override this and \fIknow\fR the location beforehand with the
-below environment variable. \fIKISS_PID=test\fR will build the package
-in \fIbuild-test\fR.
-
-Unset by default.
-.IP
-export KISS_PID=
-.PP
-.SS SPECIFYING BUILD DIRECTORY
-
-All build related files, by default, are stored in the cache directory. If the
-user specifies \fIKISS_TMPDIR\fR, it will be used instead of the cache directory
-for building packages. This can be useful if you want to build a package on ram
-or a different filesystem.
-
-Unset by default.
-.IP
-export KISS_TMPDIR=
-.PP
-.SS ENABLING/DISABLING COLOUR
-
-If run in a subshell, \fBKISS\fR disables colour output. However, this behaviour
-can be overriden. If a user defines a \fIKISS_COLOR\fR environment value, it will
-be enabled or disabled globally
-.IP
-export KISS_COLOR=1 # Enables globally
-.IP
-export KISS_COLOR=0 # Disables globally
-.PP
-.SS DISABLING PROMPTS
-User can disable prompts by setting a \fIKISS_NOPROMPT\fR environment value. This
-can be useful for scripting purposes.
-
-.IP
-KISS_NOPROMPT=1 kiss b pkg1 pkg2
-.PP
-.SH ALTERNATIVES SYSTEM
-When a package with conflicts is installed 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.
-
-\fBNOTE:\fR To disable this functionality, set 'KISS_CHOICE=0'.
-
-.SS EXAMPLE USAGE
-.nf
-# 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...
--> 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
-# 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
-# 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
-.fi
-
-.SH AUTHORS
-Cem Keylan, Fork Maintainer, Carbs Linux
-.br
-<cem@ckyln.com>
-.PP
-Dylan Araps, Original Author, KISS Linux
-
-.SH LICENSE
-See LICENSE for copyright information
-.SH SEE ALSO
-kiss-contrib(1)