Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 942133 - packages.gentoo.org: Add definition of 'global' USE flag and 'local' USE flag on relevant pages
Summary: packages.gentoo.org: Add definition of 'global' USE flag and 'local' USE flag...
Status: UNCONFIRMED
Alias: None
Product: Websites
Classification: Unclassified
Component: Packages (show other bugs)
Hardware: All Linux
: Normal normal
Assignee: Gentoo Packages Website
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2024-10-25 10:49 UTC by Alexis
Modified: 2024-10-25 10:59 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Alexis 2024-10-25 10:49:28 UTC
Following a discussion i've just had on #gentoo-chat, and based on my own experience when i was new to Gentoo, i'd like to suggest that a definition of "global USE flag" and "local USE flags" be added to the relevant pages on packages.gentoo.org.

For example, the top of https://packages.gentoo.org/useflags/global could say something like (as per https://devmanual.gentoo.org/general-concepts/use-flags/index.html):

"A global USE flag is one defined by Gentoo as applicable to many different packages - typically at least 5 - and has a general non-specific purpose."

While at the top of the https://packages.gentoo.org/useflags/local page, it could say something like:

"A local USE flag is one that is defined per-package by the maintainer, in the metadata.xml for the ebuild, and is not necessarily applicable to other packages."

The intent is to avoid users assuming that, for example, 'global' refers to USE flag settings they're applying system-wide, and that 'local' refers to USE flag settings they're applying per-package via package.use.

Reproducible: Always