cpt

[ARCHIVED] Carbs Packaging Tools
git clone git://git.ckyln.com/~cem/cpt.git
Log | Files | Refs | README | LICENSE

commit 168513e822da07af9127534811cc78ae11c052d9
parent f73dc06a9b251d35c5bee7b0461933c0038e2088
Author: Cem Keylan <cem@ckyln.com>
Date:   Fri, 24 Jul 2020 16:46:06 +0300

replace manual pages

Diffstat:
Aman/cpt-alternatives.1 | 44++++++++++++++++++++++++++++++++++++++++++++
Aman/cpt-build.1 | 15+++++++++++++++
Aman/cpt-checksum.1 | 14++++++++++++++
Aman/cpt-contrib.1 | 126+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Aman/cpt-download.1 | 13+++++++++++++
Aman/cpt-fetch.1 | 11+++++++++++
Aman/cpt-install.1 | 20++++++++++++++++++++
Aman/cpt-list.1 | 13+++++++++++++
Aman/cpt-remove.1 | 20++++++++++++++++++++
Aman/cpt-search.1 | 15+++++++++++++++
Aman/cpt-update.1 | 22++++++++++++++++++++++
Aman/cpt.1 | 179+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Dman/kiss-contrib.1 | 126-------------------------------------------------------------------------------
Dman/kiss.1 | 271-------------------------------------------------------------------------------
14 files changed, 492 insertions(+), 397 deletions(-)

diff --git a/man/cpt-alternatives.1 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 @@ -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 @@ -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/cpt-contrib.1 b/man/cpt-contrib.1 @@ -0,0 +1,126 @@ +.TH CPT-CONTRIB 1 2020-04-04 "CARBS LINUX" "General Commands Manual" +.SH NAME +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 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 CPT-CHBUILD +.B cpt-chbuild + +cpt-chbuild, creates a temporary rootfs, and chroots into it. + +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 cpt-chroot +to it. It removes the temporary chroot after the user exits. +.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 CPT-DEPENDS +.B cpt-depends +<pkg> + +Checks the dependencies of an installed package. +.SH CPT-EXPORT +.B cpt-export +<pkg> + +Exports a package tarball of an installed package. +.SH CPT-FORK +.B cpt-fork +<pkg> + +Copies the repository directory of the given package to the current working +directory. +.SH CPT-LINK +.B cpt-link +[file] [file] + +Links files from a package in the repository. It looks for the package by +the directory name, but this can be overriden by getting a PKG environment +value. + +.IP \fBExample:\fR +.nf +$ cpt-fork git +forked package to /home/cem/.local/repositories/overrides/git +$ cd git +$ 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 CPT-MANIFEST +.B cpt-manifest +<pkg> + +Prints the manifest file. +.SH CPT-MANIFEST-TREE +.B cpt-manifest-tree +<pkg> + +Prints the manifest file in a tree view. +.SH CPT-NEW +.B cpt-new +<name> [version] [sources] + +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 CPT-OWNS +.B cpt-owns +<file> + +Checks which package has installed the given file. +.SH CPT-READLINK +.B cpt-readlink +<file> + +A 'readlink -f' replacement to be used inside the package manager. +.SH CPT-REPODEPENDS +.B cpt-repodepends +<pkg> + +Prints the dependencies of the given package as they are defined in the repository. +.SH CPT-RESET +.B cpt-reset + +Removes all packages except the base packages. +.SH CPT-REVDEPENDS +.B cpt-revdepends +<pkg> + +Prints the packages that depend on the given package. (Reverse dependencies) +.SH CPT-SIZE +.B cpt-size +<pkg> + +Prints the given package's size, and its individual files. +.SH CPT-STAT +.B cpt-stat +<file> + +Outputs the owner name of a file/directory +.SH CPT-WHICH +.B cpt-which +<pkg> + +A \fIwhich\fR-like utility for CPT packages. +.SH SEE ALSO +cpt(1) diff --git a/man/cpt-download.1 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 @@ -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 @@ -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 @@ -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 @@ -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 @@ -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 @@ -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 @@ -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-contrib.1 b/man/kiss-contrib.1 @@ -1,126 +0,0 @@ -.TH KISS-CONTRIB 1 2020-04-04 "CARBS LINUX" "General Commands Manual" -.SH NAME -kiss 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 -<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 - -kiss-chbuild, creates a temporary rootfs, and chroots into it. - -If it doesn't already exist, kiss-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 -to it. It removes the temporary chroot after the user exits. -.SH KISS-CHROOT -.B kiss-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 -<pkg> - -Checks the dependencies of an installed package. -.SH KISS-EXPORT -.B kiss-export -<pkg> - -Exports a package tarball of an installed package. -.SH KISS-FORK -.B kiss-fork -<pkg> - -Copies the repository directory of the given package to the current working -directory. -.SH KISS-LINK -.B kiss-link -[file] [file] - -Links files from a package in the repository. It looks for the package by -the directory name, but this can be overriden by getting a PKG environment -value. - -.IP \fBExample:\fR -.nf -$ kiss-fork git -forked package to /home/cem/.local/repositories/overrides/git -$ cd git -$ kiss-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 -<pkg> - -Prints the manifest file. -.SH KISS-MANIFEST-TREE -.B kiss-manifest-tree -<pkg> - -Prints the manifest file in a tree view. -.SH KISS-NEW -.B kiss-new -<name> [version] [sources] - -Creates a boilerplate KISS package. -.SH KISS-OUTDATED -.B kiss-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 -<file> - -Checks which package has installed the given file. -.SH KISS-READLINK -.B kiss-readlink -<file> - -A 'readlink -f' replacement to be used inside the package manager. -.SH KISS-REPODEPENDS -.B kiss-repodepends -<pkg> - -Prints the dependencies of the given package as they are defined in the repository. -.SH KISS-RESET -.B kiss-reset - -Removes all packages except the base packages. -.SH KISS-REVDEPENDS -.B kiss-revdepends -<pkg> - -Prints the packages that depend on the given package. (Reverse dependencies) -.SH KISS-SIZE -.B kiss-size -<pkg> - -Prints the given package's size, and its individual files. -.SH KISS-STAT -.B kiss-stat -<file> - -Outputs the owner name of a file/directory -.SH KISS-WHICH -.B kiss-which -<pkg> - -A \fIwhich\fR-like utility for KISS packages. -.SH SEE ALSO -kiss(1) diff --git a/man/kiss.1 b/man/kiss.1 @@ -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)