On 1/20/26 4:00 PM, D. Ben Knoble wrote:

> That seems to contradict the wiki:
> 
>> That is to say the @world set includes all packages installed on
>> the system: those defined by the system administrator and those
>> defined by the Gentoo development team.


The wiki is allowed to be tragically wrong every once in a while. :)

From emerge(1), we see:

--oneshot described as, "WARNING: This option should only be used for
packages that are reachable from the @world package set (those that
would not be removed by --depclean),"


--depclean described as, "Depclean works by creating the full dependency
tree from the @world set, then comparing it to installed packages.
Packages installed, but not part of the dependency tree, will be
uninstalled by depclean."


And of course under "set    A set is a convenient shorthand for a large
group of packages.", we see, "while world encompasses the selected,
system and profile sets."


No "that is to say", just a technical definition. Actually the same one
in the wiki *before* the "that is to say".

The "that is to say" explicitly contradicts the previous sentence: "The
@world set is the largest superset on a Gentoo system: a union of
@selected, @system, and @profile sets."

Because "all packages installed on the system" includes dependencies
that are not in either of the 3 items the union consists of. They are
*installed*, but neither *selected* nor system/profile.

Suggestions for better wording for the wiki? "installed" is wrong,
"explicitly installed" only applies to @selected as one doesn't
explicitly add @system/@profile to @selected-sets or anything, "all
packages not eligible for depclean" is accurate but not in theme, "all
required packages for the system" feels clumsy.


-- 
Eli Schwartz

Attachment: OpenPGP_signature.asc
Description: OpenPGP digital signature

Reply via email to