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.
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
platforms.bash) and which may use the
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
- A simple
- 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.
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