Options

-F, --format FORMAT [ATOM ...]

Specify a custom output format.

Conversion specifiers start with a % symbol and are followed by either { or [. Next is the name of the field to expand, followed by a matching } or ].

The difference between { and [ is that the latter is only printed if the field referred is set, while the former prints <unset> in that case.

The following fields are supported:

CATEGORY

The category of the package.

PACKAGE

The package name.

VERSION

The package version without the ebuild revision.

FULLVER

The package name, version and revision when not zero. Thus, a zero revision -r0 is not printed.

REVISION

The ebuild revision.

SLOT

The package slot, if exists in atom, otherwise empty.

SUBSLOT

The package sub slot, if exists in atom, otherwise empty.

REPO_ID

The package repository.

OP

The package prefixes, that is version specifiers.

-c, --compare ATOM ATOM

Compare two atoms

Base Options

-h, --help

Show this help message and exit. To get more information see the related man page.

--version

Show this program’s version information and exit.

When running from within a git repo or a version installed from git the latest commit hash and date will be shown.

--debug

Enable debug checks and show verbose debug output.

-q, --quiet

Suppress non-error, informational messages.

-v, --verbose

Increase the verbosity of various output.

--color BOOLEAN

Toggle colored output support. This can be used to forcibly enable color support when piping output or other situations where stdout is not a tty.