8c64068fe2
Various groups used in comps-eln*.xml.in don't have descriptions. I assume that this is on purpose because they are marked as <uservisible>false</uservisible>. An alternative would be to add <_description>s everywhere, but then we'd also need to do translations. |
||
|---|---|---|
| po | ||
| .gitignore | ||
| check-missing | ||
| comps-cleanup.xsl | ||
| comps-el4.xml.in | ||
| comps-el5.xml.in | ||
| comps-el6.xml.in | ||
| comps-eln.xml.in | ||
| comps-epel7.xml.in | ||
| comps-epel8-next.xml.in | ||
| comps-epel8.xml.in | ||
| comps-epel9-next.xml.in | ||
| comps-epel9.xml.in | ||
| comps-f7.xml.in | ||
| comps-f8.xml.in | ||
| comps-f9.xml.in | ||
| comps-f10.xml.in | ||
| comps-f11.xml.in | ||
| comps-f12.xml.in | ||
| comps-f13.xml.in | ||
| comps-f14.xml.in | ||
| comps-f15.xml.in | ||
| comps-f16.xml.in | ||
| comps-f17.xml.in | ||
| comps-f18.xml.in | ||
| comps-f19.xml.in | ||
| comps-f20.xml.in | ||
| comps-f21.xml.in | ||
| comps-f22.xml.in | ||
| comps-f23.xml.in | ||
| comps-f24.xml.in | ||
| comps-f25.xml.in | ||
| comps-f26.xml.in | ||
| comps-f27.xml.in | ||
| comps-f28.xml.in | ||
| comps-f29.xml.in | ||
| comps-f30.xml.in | ||
| comps-f31.xml.in | ||
| comps-f32.xml.in | ||
| comps-f33.xml.in | ||
| comps-f34.xml.in | ||
| comps-f35.xml.in | ||
| comps-f36.xml.in | ||
| comps.dtd | ||
| comps.rng | ||
| Makefile | ||
| README.md | ||
| update-comps | ||
Fedora Comps
comps is a XML file used by various Fedora tools to perform grouping of packages into functional groups.
How comps is used
Installation
comps is used by the installer during package selection. At the Default Packages dialog , the user can choose to Customize Now, displaying the Category Selection dialog.
In the category selection dialog , categories (as defined by the category keyword in comps.xml) are listed down the left-hand side. If a category is selected, any groups in that category with uservisible set are displayed in the right-hand pane. Groups have an icon associated with them. These icons come from the comps-extras package; icons are read from /usr/share/pixmaps/comps/<group-id>.png. If an icon does not exist for a group id, the one for the category that the group is in is used.
Once a group is selected, clicking the Optional Packages button shows the Package Selection dialog.
In any group, there are four levels of packages: optional, default, mandatory, and conditional:
optionalare not automatic but can be checkeddefaultare, but can be unchecked in a gui toolmandatoryare always brought in (if group is selected), and not visible in the Package Selection dialog.conditionalare brought in if theirrequirespackage is installed
Usually optional is the way, however if you feel that your package deserves a default or required level bring it up for discussion on the development lists. Remember that this has effect on whether or not your package winds up on distribution media such as Live images and spins.
Running System
In dnf, groups are used by dnf group install and dnf group remove commands, and can be queried with dnf group list command.
In PackageKit (Add / Remove Software) the upper left quadrant shows Package collections. When this is clicked, the grouping information is loaded from the configured software repositories, and the complete list of groups, stripped from their categories, are shown in the right hand pane. Selecting a group for installation causes only the default packages within the group to be installed.
Developing comps
git clone ssh://git@pagure.io/fedora-comps.git
When changing the packages, make sure the file is sorted. This helps to make it more maintainable. Use make sort command to fix the sorting.
Tree, Release, and Image Composition
The kickstart files in fedora-kickstarts use the group definitions from comps to compose images and release trees.
For more info
For more information, including rules on how and when to edit comps, see the Fedora project wiki.
Bugs against comps can be filed in bugzilla.