diff options
authorMichał Górny <>2020-01-09 16:44:12 +0100
committerMichał Górny <>2020-01-09 16:44:12 +0100
commitdcea043a7bca2b982d2dec6b639577a7aa087cb0 (patch)
parentHOMEPAGE and SRC_URI format (diff)
Signed-off-by: Michał Górny <>
1 files changed, 26 insertions, 0 deletions
diff --git a/use-flags.rst b/use-flags.rst
index 64b1987..c6a8b4a 100644
--- a/use-flags.rst
+++ b/use-flags.rst
@@ -31,6 +31,32 @@ with the QA team before introduction.
removed since.
+.. index::
+ single: USE flags; gui
+ single: gtk; gui flag
+ single: Qt; gui flag
+USE=gui flag
+:Source: QA
+:Reported: no
+Whenever a package offers an optional GUI support, the ``gui`` flag must
+be used to control that support rather than historically used ``X``
+or toolkit flags. Toolkit flags can still be used to choose between
+multiple available GUIs, or when the toolkit is used in a more
+specialized way than for GUI (e.g. to control installing widgets).
+*Rationale*: the historical use of toolkit flags to control building
+GUIs made it very hard for users to express the simple wish of 'I want
+*any* GUI'. Installing various packages made it necessary to either
+adjust flags per package (manually discovering which flags are necessary
+to obtain the GUI) or enabling multiple toolkits globally which
+afterwards caused issues with packages supporting a choice between
+multiple GUIs.
.. index:: USE flags; underscore
Underscores in USE flag names