From 97b39c1fc1dda6082199dbcc2e77dfd90c7d61a7 Mon Sep 17 00:00:00 2001
From: genone <genone@gentoo.org>
Date: Sun, 17 Oct 2004 17:50:47 +0000
Subject: replace perl euse with bash euse

svn path=/; revision=156
---
 trunk/src/euse/euse.1 | 149 ++++++++++++++++++++++++++------------------------
 1 file changed, 79 insertions(+), 70 deletions(-)

(limited to 'trunk/src/euse/euse.1')

diff --git a/trunk/src/euse/euse.1 b/trunk/src/euse/euse.1
index f5c57e0..07bec3f 100644
--- a/trunk/src/euse/euse.1
+++ b/trunk/src/euse/euse.1
@@ -1,89 +1,98 @@
-.TH EUSE 1 2003-05-01 "Gentoo Linux" "Gentoo Toolkit"
-.SH NAME
+.TH "EUSE" "1" "2004-10-17" "Gentoo Linux" "Gentoo Toolkit"
+.SH "NAME"
 euse \- Gentoo: command line USE flag editor
-.SH SYNOPSIS
+.SH "SYNOPSIS"
 .B euse
-\fI[options]\fB
-.SH DESCRIPTION
-.PP
+\fI<option> [suboption] [useflaglist]\fB
+.SH "DESCRIPTION"
+.PP 
 .I euse
-is used to set(disable/enable) USE flags /etc/make.conf without having to edit
+is used to set(disable/enable) USE flags in /etc/make.conf without having to edit
 the file directly. It is also used to get detail information about use flags
 like description, status of flags(enabled/disabled), type of flag(global/local)
-etc. It can also be queried for viewing the current use flag settings in
-/etc/make.conf, /etc/make.defaults and environment.
-.SH OPTIONS 
-.TP
-\fB-c, --conf\fI
-Print the USE flag setting in /etc/make.conf
-.TP
-\fB-d, --defaults\fI
-Print the USE flag setting in /etc/make.profile/make.defaults
-.TP
-\fB-e, --env\fI
-Print the USE flag setting in environment
-.TP
-\fB-E, --enable\fI
-Enables USE flag(s) in make.conf. It accepts one or more USE flags space
-separted as parameters. Please read README for all the different cases it
-handles.
-.TP
-\fB-D, --disable\fI
-Disables USE flag(s) in make.conf. Puts a '-' sign infront of the use flag and
-appends to USE setting of make.conf. It accepts one or more USE flags space
-separted as parameters. Please read README for all the different cases it
-handles.
-.TP
-\fB-i, --info\fI
+etc.
+.SH "OPTIONS "
+.TP 
+\fB\-E, \-\-enable\fI
+Enables USE flag(s) in make.conf. It accepts one or more space seperated 
+USE flags as parameters.
+.TP 
+\fB\-D, \-\-disable\fI
+Disables USE flag(s) in make.conf. Puts a '\-' sign in front of the USE flag
+and appends it to the USE setting in make.conf. It accepts one or more 
+space seperated USE flags as parameters.
+.TP 
+\fB\-P, \-\-prune\fI
+Removes USE flag(s) in make.conf. Removes all positive and negative references to
+the given USE flags from make.conf.
+.TP 
+\fB\-i, \-\-info\fI
 Prints detail information about the USE flag(s). If no arguments are given then
-all the USE flag(global & local) information is printed. If one or more
-arguments are given(space separated) then information of only those flags are
+it assumes you want information for all USE flags. If one or more
+arguments are given (space separated) then only information for those flags is
 printed. 
 .sp
 .RS
 The output is in the following format:
-.br
-alpha         [-] [ ] [G] indicates that architecture ...
-.br
-moznocompose  [+] [C] [L] [net-www/mozilla] : If you  ... 
-.br
-The column descriptions are:
-.IP flag_name
-name of the use flag
-.IP flag_status
-indicates whether the USE flag is enabled or disabled. - indicates disabled, +
-indicates enabled.
-.IP flag_location
-indicates where the USE flag is enabled or disabled.
-C indicates make.conf, D indicates make.defaults, E indicates environment.
-.IP flag_type
-indicates if the flag is global USE flag or a local USE flag.If it is local USE
-flag, then the description column begins with the package which it belongs to
-in square brackets. See moznocompose example above.
-.IP description
-gives a short description of the USE flag
-.TP
-\fB-h, --help\fI
+.br 
+\fB[\- cD ]\fI alpha \- indicates that architecture ...
+.br 
+\fB[\-   ]\fI moznocompose (net\-www/mozilla):.br 
+Disable building of mozilla's web page composer 
+.br 
+The the indicators in the first column are:
+.IP is_active
++ if the flag is seen as active by portage, \- if not
+.IP is_in_env
+E if the flag is enabled in the environment, e if it is
+disabled in the environment, nothing if it's not affected
+by the environment
+.IP is_in_make_conf
+C if the flag is enabled in make.conf, c if it is
+disabled in make.conf, nothing if it's not affected
+by make.conf
+.IP is_in_make_defaults
+D if the flag is enabled in make.defaults, d if it is
+disabled in make.defaults, nothing if it's not affected
+by make.defaults
+.IP is_in_make_globals
+G if the flag is enabled in make.globals, g if it is
+disabled in make.globals, nothing if it's not affected
+by make.globals
+.br 
+Then follows the name of the flag, for local flags the
+package name and then the description (on a new line for
+local flags).
+.TP 
+\fB\-a, \-\-active\fI
+Shows all currently active USE flags and where they are activated (see 
+description for \fB\-\-info\fI).
+.TP 
+\fB\-h, \-\-help\fI
 Show the help message listing all the available flags and a short description
-.TP
-\fB-v, --version\fI
+.TP 
+\fB\-v, \-\-version\fI
 Show the version information
-.SH FILES
+.SH "FILES"
 /etc/make.conf
-.br
+.br 
 /etc/make.profile/make.defaults
-.br
+.br 
+/etc/make.globals
+.br 
 $PORTDIR/profiles/use.desc
-.br
+.br 
 $PORTDIR/profiles/use.local.desc
-.br
-/etc/make.profile/use.mask
-.SH AUTHOR
-Arun Bhanu <codebear@gentoo.org>
-.SH BUGS
-No reported bugs yet.
+.br 
+
+.SH "AUTHOR"
+Original version by Arun Bhanu <codebear@gentoo.org>
+.br 
+Updated for rewritten euse by Marius Mauch <genone@gentoo.org>
+.SH "BUGS"
+euse doesn't handle USE flags enabled or disabled by use.defaults, use.mask
+or package.use yet. It also doesn't completely understand the \-* flag.
 .SH "SEE ALSO"
 .BR ufed(8), 
-.BR README
-.TP
+.TP 
 The \fI/usr/bin/euse\fR script. 
-- 
cgit v1.2.3