Debian Codegraph @

upstream/mageia-cauldron/man7/dnf5-comps.7

raw
1 .\" Man page generated from reStructuredText.
2 .
3 .
4 .nr rst2man-indent-level 0
5 .
6 .de1 rstReportMargin
7 \\$1 \\n[an-margin]
8 level \\n[rst2man-indent-level]
9 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
10 -
11 \\n[rst2man-indent0]
12 \\n[rst2man-indent1]
13 \\n[rst2man-indent2]
14 ..
15 .de1 INDENT
16 .\" .rstReportMargin pre:
17 . RS \\$1
18 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
19 . nr rst2man-indent-level +1
20 .\" .rstReportMargin post:
21 ..
22 .de UNINDENT
23 . RE
24 .\" indent \\n[an-margin]
25 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
26 .nr rst2man-indent-level -1
27 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
28 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
29 ..
30 .TH "DNF5-COMPS" "7" "May 10, 2026" "" "dnf5"
31 .SH NAME
32 dnf5-comps \- Comps Groups And Environments
33 .SH DESCRIPTION
34 .sp
35 Comps files are used for grouping of packages into functional groups. They are stored
36 in repository metadata files under the \fBcomps.xml\fP filename.
37 .sp
38 There are two types of structures that can be used for grouping. The first is a
39 \fIgroup\fP which is composed of lists of packages. The second one is an \fIenvironment\fP
40 that is composed from the groups.
41 .sp
42 Each \fIenvironment\fP is made of mandatory and optional groups. All mandatory groups have
43 to be installed, so the \fIenvironment\fP is marked as \fIinstalled\fP\&. Optional groups are
44 not installed by default, they have to be added using the \fB\-\-with\-optional\fP argument.
45 .sp
46 In the \fIgroup\fP, there are four levels of packages:
47 .INDENT 0.0
48 .TP
49 .B \fImandatory\fP
50 .nf
51 These are the essential packages for the functionality of the group.
52 These have to be installed for the group to be considered \fBinstalled\fP\&.
53 .fi
54 .sp
55 .TP
56 .B \fIdefault\fP
57 .nf
58 These are packages installed together with mandatory packages.
59 They can be excluded, f.e. using the \fB\-\-exclude=PACKAGE\-SPEC\-N,...\fP argument.
60 .fi
61 .sp
62 .TP
63 .B \fIoptional\fP
64 .nf
65 These packages are not installed by default.
66 They can be included using the \fB\-\-with\-optional\fP argument.
67 .fi
68 .sp
69 .TP
70 .B \fIconditional\fP
71 .nf
72 These packages are brought in the transaction if their required package is to be installed.
73 .fi
74 .sp
75 .UNINDENT
76 .sp
77 For commands operating with groups and environments, see references below.
78 .SH SEE ALSO
79 .INDENT 0.0
80 .INDENT 3.5
81 .nf
82 \fBdnf5\-group(8)\fP, \fI\%Group command\fP
83 \fBdnf5\-environment(8)\fP, \fI\%Environment command\fP
84 \fBdnf5\-specs(7)\fP, \fI\%Patterns specification\fP
85 .fi
86 .sp
87 .UNINDENT
88 .UNINDENT
89 .SH AUTHOR
90 See AUTHORS.md in dnf5 source distribution.
91 .SH COPYRIGHT
92 Contributors to the dnf5 project.
93 .\" Generated by docutils manpage writer.
94 .