Content-type: text/html Manpage of euses

euses

Section: User Commands (1)
Updated: May 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.  

SEE ALSO

portage(5), make.conf(5)  

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>.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
FILES
BUGS
SEE ALSO
AUTHOR
LICENSE

This document was created by man2html, using the manual pages.
Time: 22:44:22 GMT, June 23, 2005