Debian Codegraph @

upstream/debian-unstable/man7/dnf5-comps.7

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