From dcea043a7bca2b982d2dec6b639577a7aa087cb0 Mon Sep 17 00:00:00 2001 From: Michał Górny Date: Thu, 9 Jan 2020 16:44:12 +0100 Subject: USE=gui MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Michał Górny --- use-flags.rst | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) (limited to 'use-flags.rst') 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 +:Reference: https://archives.gentoo.org/gentoo-dev/message/cf3f5a59ac918335766632bd02438722 +: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 -- cgit v1.2.3-65-gdbad