--- xml/htdocs/proj/en/glep/glep-0029.html 2005/11/07 22:26:59 1.5 +++ xml/htdocs/proj/en/glep/glep-0029.html 2006/10/10 20:25:14 1.6 @@ -8,9 +8,252 @@ --> - + GLEP 29 -- USE flag groups - + @@ -32,17 +275,17 @@ - + - + - + @@ -51,8 +294,8 @@
Title:USE flag groups
Version:1.5
Version:1.6
Author:Ciaran McCreesh <ciaranm at gentoo.org>
Last-Modified:2005/06/24 21:36:04
Last-Modified:2005/11/07 22:26:59
Status:Draft
Type:Standards Track
Content-Type:text/x-rst
Content-Type:text/x-rst
Created:19-Aug-2004

-
-

Contents

+
+

Contents

-
-

Status

+
+

Status

Withdrawn by request of the author.

-
-

Abstract

+
+

Abstract

Currently, USE flags must be selected on a one-by-one basis, making it time-consuming to set up make.conf appropriately for a machine's role.

-
-

Motivation

+
+

Motivation

Many packages have optional support for other packages (for example, the Vim text editor can optionally support perl, python and ruby interpreters). In Gentoo, these optional dependencies can be selected by @@ -98,10 +341,10 @@ proposes a mechanism for grouping USE flags to simplify selection and to make USE="-" less dangerous.

-
-

Specification

-
-

Group Specification

+
+

Specification

+
+

Group Specification

A group shall consist of one or more tokens. Each token may be a USE flag, a -USE flag, a reference to another group or a negative reference to another group.

@@ -154,8 +397,8 @@ GROUP2 @GROUP1 bar
-
-

Group Descriptions

+
+

Group Descriptions

Groups shall have a textual description associated with them in the same way as USE flags. The file ${PORTDIR}/profiles/use.groups.desc contains these:

@@ -165,8 +408,8 @@ RECOMMENDED Flags which should be enabled on almost all systems
-
-

Using Groups

+
+

Using Groups

Groups may be used in /etc/make.conf, /etc/portage/package.use and other places where USE flags are normally specified. They may not be used inside IUSE`. As before, the @ symbol is used to indicate that a @@ -194,8 +437,8 @@ USE="-baz fnord -foo bar"

-
-

Issues with -flags and -@GROUPS

+
+

Issues with -flags and -@GROUPS

Earlier drafts of this GLEP did not allow -use flags or -@GROUPS. However, because of feedback along the lines of "we shouldn't disallow features just because some users won't understand them" (for example, [3]), these @@ -234,8 +477,8 @@

This is clearly not the desired effect.

-
-

Adding New Groups

+
+

Adding New Groups

The actual groups to be created is beyond the scope of this GLEP, and any group names contained herein should be treated as examples only. Creation of new groups and changing a group's flags should be discussed on the @@ -244,17 +487,17 @@ before implementation.

-
-

Rationale

+
+

Rationale

USE groups will simplify selecting an appropriate set of USE flags for a system.

-
-

Reference Implementation

+ -
-

Backwards Compatibility

+
+

Backwards Compatibility

The user will not need to make any changes to keep their current setup. Users who are not running a portage version which supports groups can carry on using current syntax with no side-effects.

@@ -264,8 +507,8 @@ website [2]. For consistency, a similar list will be needed for USE groups.

-
-

References

+
+

References

@@ -287,8 +530,8 @@
-