24cb1709c7
keepconf is a boring option and is not needed in most situations. Make this more clear in the documentation, e.g. that it only affects *unchanged* configuration files, and that changed configuration files are unaffected by this option.
108 lines
3.7 KiB
Plaintext
108 lines
3.7 KiB
Plaintext
# Configuration file for XBPS.
|
|
#
|
|
# - Lines starting with # are ignored.
|
|
# - Values are set after the equal sign, and don't accept blanks nor newlines.
|
|
|
|
# Set root directory, by default set to /. This expects an absolute path.
|
|
#rootdir=/
|
|
|
|
# Set cache directory, if starts with / it's an absolute path,
|
|
# otherwise it's relative to rootdir.
|
|
#cachedir=var/cache/xbps
|
|
|
|
# Set it to false to disable syslog logging.
|
|
#syslog=true
|
|
|
|
# Enable package best matching (disabled by default). If enabled a package with
|
|
# the greatest version available in all repositories will be choosen, rather
|
|
# than on the first package matching the expression.
|
|
#
|
|
#bestmatching=true
|
|
|
|
## REPOSITORIES
|
|
#
|
|
# The `repository' keyword defines a repository. A complete URL or absolute
|
|
# path to a local directory can be used.
|
|
#
|
|
# Local or remote repositories are accepted.
|
|
#
|
|
# - Local repositories expect an absolute path to the directory that stores
|
|
# the <arch>-repodata file.
|
|
# - Accepted protocols for remote repositories: ftp, http or https.
|
|
# - Repositories are added in the order in which are specified (top->bottom).
|
|
# - Repositories declared in this file are added at the head of the list.
|
|
# - Repositories declared in the system or configuration directories are added
|
|
# to the tail of the list.
|
|
#
|
|
# The "repository" keyword can be used to include additional repositories in
|
|
# addition to the files available in /etc/xbps.d/*.conf and
|
|
# /usr/share/xbps.d/*.conf.
|
|
#
|
|
# syntax: <protocol>://<url>[:<port>]/<doc> [remote]
|
|
# syntax: <abspath> [local]
|
|
#
|
|
# Example:
|
|
# repository=http://foo.example.org/dir
|
|
# repository=https://foo.example.org:8080/dir
|
|
# repository=/hostdir/binpkgs
|
|
|
|
## REPOSITORY MIRRORS
|
|
#
|
|
# - https://beta.de.repo.voidlinux.org/current
|
|
# - https://beta.de.repo.voidlinux.org/current/nonfree
|
|
# - https://beta.de.repo.voidlinux.org/current/multilib
|
|
# - https://beta.de.repo.voidlinux.org/current/multilib/nonfree
|
|
#
|
|
# - http://alpha.us.repo.voidlinux.org/current
|
|
# - http://alpha.us.repo.voidlinux.org/current/nonfree
|
|
# - http://alpha.us.repo.voidlinux.org/current/multilib
|
|
# - http://alpha.us.repo.voidlinux.org/current/multilib/nonfree
|
|
|
|
## PRESERVING FILES
|
|
#
|
|
# The `preserve` keyword can be used to make xbps ignore changes to the
|
|
# specified files. Files must be specified with absolute pathnames or via
|
|
# file globbing.
|
|
#
|
|
# Files bearing the same name in the configuration directory override the
|
|
# ones from the system directory.
|
|
#
|
|
# Example:
|
|
# preserve=/etc/file
|
|
# preserve=/etc/dir/*.conf
|
|
|
|
## PRESERVING UNCHANGED CONFIGURATION FILES
|
|
#
|
|
# The `keepconf` (disabled by default) keyword can be used to prevent
|
|
# xbps from overwriting unchanged configuration files. Changed configuration
|
|
# files are unaffected by this keyword and are preserved by default.
|
|
#
|
|
# If set to false, xbps will overwrite configuration files that have not been
|
|
# changed since installation with their new version (if available).
|
|
#
|
|
# If set to true, xbps will not overwrite configuration files that have not
|
|
# been changed since installation. Instead, the new version (if available) is
|
|
# saved next to the configuration file as <name>.new-<version>.
|
|
#
|
|
#keepconf=true
|
|
|
|
## VIRTUAL PACKAGES
|
|
#
|
|
# Virtual package overrides. You can set your own list of preferred virtual
|
|
# packages for your system. This expects two arguments separated by a colon:
|
|
# <vpkgver>:<realpkgname>.
|
|
#
|
|
# - <vpkgver> means "virtual package name" and "version/revision"
|
|
# separated by a dash, i.e 'foo-1.0_1".
|
|
# - <realpkgname> means a real package name (without any version).
|
|
#
|
|
# Files bearing the same name in the configuration directory override the
|
|
# ones from the system directory.
|
|
#
|
|
# Example:
|
|
# virtualpkg=cron-daemon-0_1:dcron
|
|
|
|
# You can also include additional files by using the "include" keyword.
|
|
# This expects an absolute path to a file.
|
|
#include=/path/to/another/file.conf
|