keywords.conf / platforms.conf

This document applies only to clients using PaludisEnvironment. Any standard client that supports a --environment command line option uses PaludisEnvironment unless overridden, either by explicitly selecting another environment (e.g. --environment portage) or, on distributions also supporting Portage, by lack of a Paludis configuration and presence of a Portage configuration.

The keywords.conf (Gentoo and derived distributions) or platforms.conf (Exherbo) file controls which keywords are and are not accepted. It is a standard configuration file which may be a bash file (keywords.bash or platforms.bash) and which may use the keywords.conf.d/ or platforms.conf.d/ directory.

Each line in the file consists of a specification followed by one or more accepted keywords or platforms. A specification may be any of:

The special specification */*, which matches all packages. Nearly all users will have at least one line using this specification.
A simple category/package name.
A simple set name.
A complex dependency specification.

Any token may be quoted using either single or double quotes.

Accepted keywords or platforms are one of:

keyword, which accepts any package containing that keyword.
~keyword, which accepts any package containing that ~keyword. This does not automatically accept the regular, non-tilde keyword.
*, which accepts any package, including one with empty keywords or platforms.
-*, which cancels any previously accepted match (see below).

Accepted keywords or platforms are usually cumulative, so if you have a */* arch ~arch line, you will need to use cat/pkg -* arch if you only wish to accept arch for a particular package.

Examples

For a system which is mostly stable:

# By default, only accept 'x86' packages
*/*                            x86

# For the repository named 'paludis-overlay', accept unstable too
*/*::paludis-overlay           x86 ~x86

# For these packages, accept unstable too
app-admin/eselect              ~x86
app-doc/doxygen                ~x86

# For packages in the 'kde' set, accept unstable
kde                            ~x86

# Accept gcc 4.3 from the toolchain overlay, even if it is unkeyworded
sys-devel/gcc:4.3::toolchain   *

For a system which is mostly unstable:

# By default, accept stable and unstable
*/*                             amd64 ~amd64

# For these packages, accept stable only
sys-devel/gcc                   -* amd64
sys-libs/glibc                  -* amd64

Introduction	Hooks	general.conf	bashrc
Bugs, Requests, Support	Syncers	keywords.conf / platforms.conf	suggestions.conf
Overview	Fetchers	use.conf / options.conf	sets/
FAQ	Env Vars	licenses.conf / licences.conf	repositories/
Clients	File Formats	mirrors.conf
Configuration	Dep Specs	output.conf
API	specpath.conf	package_mask.conf