Content-type: text/html Manpage of euses

euses

Section: User Commands (1)
Updated: June 2005
Index Return to Main Contents

NAME

euses - look up USE flag descriptions fast

SYNOPSIS

euses [ <string>]

DESCRIPTION

euses finds the string <string> and returns any line in the USE flag description files use.desc and use.local.desc (which are part of Portage) in which <string> occurs.

OPTIONS

If no arguments are given, euses prints usage information. If euses is used non-interactively, no colours are applied to the output. Otherwise, output is colourised. euses searches the entire files for matches, thus entering `euses ftplo' will produce the following output:

* Found 'ftplo' in use.local.desc:
net-misc/openssh:sftplogging  - Enables sftplogging patch

In a non-interactive shell, output would look like this:

use.local.desc: net-misc/openssh:sftplogging - Enables sftplogging patch

euses ignores all command line arguments except the first, so if for whatever reason you want to look up whitespace in the USE flag files, quote the string you want to look up.

FILES

${PORTDIR}/profiles/use.desc: describes global USE flags.
${PORTDIR}/profiles/use.local.desc: describes USE flags that only apply to specific packages. In the documentation directory for this program, you'll find the annotated source.
/etc/make.conf: euses tries to read the PORTDIR variable from /etc/make.conf. If this fails because that variable is not set or because euses fails to parse it correctly, it expects Portage to be found in /usr/portage.

BUGS

Currently, euses is not very good at finding out where Portage is to be found. It parses /etc/make.conf in order to do that, but for instance, it can't handle escaped characters yet, which means it will fail spectaculary when it tries to use an incorrect value as part of the path to the USE description files.

AUTHOR

Jeroen Roovers <jer at xs4all dot nl>

LICENSE

This program is distributed under the General Public License (GPL) version 2, a copy of which may be found at <http://www.gnu.org/licenses/gpl.txt>.

This document was created by man2html, using the manual pages.
Time: 00:12:33 GMT, July 04, 2005