euses(1)

NAME
euses - look up USE flag descriptions fast

SYNOPSIS
euses [OPTION]... [STRING]...

DESCRIPTION
euses searches for and returns any line in the USE flag description files use.desc and use.local.desc containing USE flags that match [STRING].... Additionally, euses optionally finds flag descriptions in other description files in the Portage tree (*.desc, just not by default). euses can also be used to find descriptions in other repositories, by setting the PORTDIR environment variable to the desired (overlay's) directory.

OPTIONS
-c, --colour
    Emphasise USE flags and cate-gory/package names and filenames in the output.
-v, --verbose
    Prefix the output for matching lines with the description filename::
-P, --pedantic
    Output more information about which files have no matches and print a modest summary when done.
-a, --allfields
    Search entire lines.
-A, --allfiles
    Search all description files in $PORTDIR/profiles/{,desc/}*.desc". This option clashes with --package because that field only exists in use.local.desc".
-d, --description
    Search only descriptions.
-f, --flag
    Search only USE flags.
-p, --package
    Search only cate-gory/package (in use.local.desc). Specifying both --package and --allfiles will yield an error as the package field is only present in use.local.desc anyhow. It's a feature...
-i, --ignorecase
    Disregard the case of characters in both the arguments and the contents of the USE description files while searching.
-s, --strict
    Match only complete fields. With this option set, matching the flag field `xv' will not yield `xvid', and matching the package field `sys-devel/gcc' will not match `sys-devel/gcc-mips64'.
-h, --help
    Show usage information and exit.
-v, --version
    Show euses version and exit.
--  Delimits the list of options. All further arguments are interpreted as STRINGs. Note that a single - is always interpreted as a STRING.

VARIABLES
PORTDIR
    If set in the environment, or in make.conf (and in that order), euses will use this instead of the value obtained from make.globals. If even the latter fails, euses will fall back on /usr/portage before giving up completely.
USE The USE environment variable is used by portage(5) to determine which additional features emerge(1) should or should not build packages with that any USE flag set using that variable applies to.
LINGUAS VIDEO_CARDS MISDN_CARDS ...
    portage(5) expands these environment variables as set in make.conf(5) to determine which features to support in the packages that it builds. Their meanings depend heavily on their implementation in ebuilds. For instance, LINGUAS determines what language / country combinations to provide in packages, and VIDEO_CARDS determines which types of graphics cards to build support for.

FILES
make.conf
    /etc/make.conf is a portage configuration file. euses tries to read the PORTDIR variable from this file.
make.globals
    /etc/make.globals is another portage configuration file. If euses cannot find a variable in make.conf, it will try this file instead.
$PORTDIR/profiles/use.desc
    use.desc is part of the portage tree. It describes all global USE flags.
$PORTDIR/profiles/use.local.desc
    $PORTDIR/profiles/use.local.desc is part of the portage tree. It describes USE flags as they apply to specific packages.
$PORTDIR/profiles/desc/*.desc
    These files mostly describe USE_EXPANDed flags. These might include VIDEO_CARDS (USE=videocards_radeon expanded from VIDEO_CARDS=radeon) or LINGUAS (USE=linguas_nl expanded from LINGUAS=nl).

SEE ALSO
emerge(1), make.conf(5), portage(5)

AUTHOR
Jeroen Roovers <jer@gentoo.org>