swift 05/04/07 17:58:39 Modified: xml/htdocs/doc/en gentoolkit.xml Log: #86937 - euse updates + warning about brokenness
Revision Changes Path 1.19 +178 -42 xml/htdocs/doc/en/gentoolkit.xml file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoolkit.xml?rev=1.19&content-type=text/x-cvsweb-markup&cvsroot=gentoo plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoolkit.xml?rev=1.19&content-type=text/plain&cvsroot=gentoo diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoolkit.xml.diff?r1=1.18&r2=1.19&cvsroot=gentoo Index: gentoolkit.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoolkit.xml,v retrieving revision 1.18 retrieving revision 1.19 diff -u -r1.18 -r1.19 --- gentoolkit.xml 27 Dec 2004 20:32:02 -0000 1.18 +++ gentoolkit.xml 7 Apr 2005 17:58:39 -0000 1.19 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="UTF-8"?> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoolkit.xml,v 1.18 2004/12/27 20:32:02 swift Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoolkit.xml,v 1.19 2005/04/07 17:58:39 swift Exp $ --> <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> <guide link="/doc/en/gentoolkit.xml"> @@ -28,8 +28,8 @@ This document covers the basics of some of the tools present in Gentoolkit. </abstract> -<version>1.5</version> -<date>2004-12-27</date> +<version>1.6</version> +<date>2005-04-07</date> <chapter> <title>Introduction</title> @@ -239,62 +239,198 @@ <title>Introduction</title> <body> +<warn> +<c>euse</c> is currently broken as it does not support cascading profiles well. +</warn> + <p> <c>euse</c> is a tool to see, set and unset USE flags at various places. For more information on USE flags, please refer to the <uri -link="/doc/en/handbook/handbook-x86.xml?part=2&chap=2">USE Flags</uri>. -<c>euse -i</c> lists all USE flags. +link="/doc/en/handbook/handbook-x86.xml?part=2&chap=2">USE Flags</uri>. +Please see <c>euse -h</c> for complete help and all options. </p> </body> </section> <section> -<title>Reading, Setting and Unsetting USE Flags</title> +<title>Viewing, Setting and Unsetting USE Flags</title> <body> <p> -The <c>euse --conf</c> command reads the current USE flags set/unset from -make.conf. +The <c>euse -a</c> command reads the current active USE flags and displays +them. </p> -<pre caption="Viewing Current flags from make.conf"> -# <i> euse --conf</i> -USE setting in make.conf: -alsa acpi apache2 cups cdr crypt cscope -doc ethereal fbcon gif gimpprint gnome -gpm gstreamer gtk2 gtkhtml imlib imlib2 innodb -java javascript jpeg libg++ libwww -mad md5sum mikmod mmx motif mozilla mpeg mpeg4 mysql ncurses oggvorbis odbc -offensive opengl pam pdflib perl png python quicktime readline sdl spell sse ssl -svga tcltk tiff truetype usb vanilla X xml2 xmms xosd xv xvid x86 zlib +<note> +There are 5 "columns" that <c>euse</c> now uses to show whether a +flag is set/unset and where all the flag has been set. The columns are as +follows -- +/-, set in the Environment, set in make.Conf, set in make.Defaults, +and set in make.Globals. The output looks like [+ECDG]. +</note> + +<pre caption="Viewing all active USE flags"> +# <i> euse -a</i> +X [+ CD ] +aalib [+ ] +acpi [+ C ] +alsa [+ C ] +apache2 [+ C ] +apm [+ D ] +avi [+ D ] +berkdb [+ D ] +bitmap-fonts [+ D ] +bonobo [+ ] +cdr [+ C ] +crypt [+ CD ] +cscope [+ C ] +cups [+ CD ] +curl [+ ] +emboss [+ D ] +encode [+ D ] +esd [+ ] +ethereal [+ C ] +fam [+ ] +fbcon [+ C ] +font-server [+ D ] +foomaticdb [+ D ] +fortran [+ D ] +gd [+ C ] +gdbm [+ D ] +gif [+ CD ] +gimpprint [+ C ] +gnome [+ CD ] +gphoto2 [+ ] +gpm [+ CD ] +gstreamer [+ C ] +gtk [+ D ] +gtk2 [+ CD ] +gtkhtml [+ C ] +guile [+ ] +imagemagick [+ ] +imlib [+ CD ] +imlib2 [+ ] +innodb [+ ] +ipv6 [+ D ] +javascript [+ C ] +jpeg [+ CD ] +kde [+ D ] +ldap [+ ] +libg++ [+ CD ] +libwww [+ CD ] +mad [+ CD ] +mbox [+ C ] +md5sum [+ C ] +mikmod [+ CD ] +mmx [+ C ] +motif [+ CD ] +mozilla [+ C ] +mp3 [+ ] +mpeg [+ CD ] +mpeg4 [+ C ] +mysql [+ C ] +ncurses [+ CD ] +nls [+ D ] +nvidia [+ C ] +odbc [+ ] +offensive [+ ] +oggvorbis [+ CD ] +opengl [+ CD ] +oss [+ D ] +pam [+ CD ] +pdflib [+ CD ] +perl [+ CD ] +png [+ CD ] +python [+ CD ] +qt [+ D ] +quicktime [+ CD ] +readline [+ CD ] +ruby [+ ] +sdl [+ CD ] +slang [+ D ] +spell [+ CD ] +sse [+ C ] +ssl [+ CD ] +svga [+ CD ] +tcltk [+ C ] +tcpd [+ D ] +tiff [+ C ] +truetype [+ CD ] +truetype-fonts [+ D ] +type1-fonts [+ D ] +usb [+ C ] +vanilla [+ C ] +x86 [+ C ] +xml [+ ] +xml2 [+ D ] +xmms [+ D ] +xosd [+ C ] +xv [+ CD ] +xvid [+ C ] +zlib [+ CD ] </pre> <p> -Setting a USE flag is done with the help of the <c>euse --enable</c> command -which requires a mandatory flag name argument. If the flag is not already set, -<c>euse</c> appends the USE flag to the end of the current USE flag settings. -In case the USE flag is invalid, there is a warning. Removing a USE flag is -done using the <c>euse --disable</c> command. If an invalid flag is specified, -the user is warned suitably. If the flag is present, it is unset with a -flag -in make.conf -</p> - -<pre caption="Setting a USE Flag, 3dfx"> -# <i>euse --enable 3dfx</i> -USE setting in make.conf after enabling: -alsa acpi apache2 cups cdr crypt cscope -doc ethereal fbcon gif gimpprint gnome -gpm gstreamer gtk2 gtkhtml imlib imlib2 innodb -java javascript jpeg libg++ libwww -mad md5sum mikmod mmx motif mozilla mpeg mpeg4 mysql ncurses oggvorbis odbc -offensive opengl pam pdflib perl png python quicktime readline sdl spell sse ssl -svga tcltk tiff truetype usb vanilla X xml2 xmms xosd xv xvid x86 zlib 3dfx +Similarly you can use the <c>euse -a -g</c> command to only view active global +USE flags. The <c>euse -a -l</c> command does the same for active local USE +flags.<c>-g</c> & <c>-l</c> are suboptions to <c>euse</c> and need an +option before them (like <c>-a</c>) to function correctly. +</p> + +<pre caption="Viewing active local USE flags"> +# <i>euse -a -l</i> <<Truncated>> -- [email protected] mailing list
