.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "DNF5-COMPS" "7" "Apr 18, 2025" "" "dnf5"
.SH NAME
dnf5-comps \- Comps Groups And Environments
.SH DESCRIPTION
.sp
Comps files are used for grouping of packages into functional groups. They are stored
in repository metadata files under the \fBcomps.xml\fP filename.
.sp
There are two types of structures that can be used for grouping. The first is a
\fIgroup\fP which is composed of lists of packages. The second one is an \fIenvironment\fP
that is composed from the groups.
.sp
Each \fIenvironment\fP is made of mandatory and optional groups. All mandatory groups have
to be installed, so the \fIenvironment\fP is marked as \fIinstalled\fP\&. Optional groups are
not installed by default, they have to be added using the \fB\-\-with\-optional\fP argument.
.sp
In the \fIgroup\fP, there are four levels of packages:
.INDENT 0.0
.TP
.B \fImandatory\fP
.nf
These are the essential packages for the functionality of the group.
These have to be installed for the group to be considered \fBinstalled\fP\&.
.fi
.sp
.TP
.B \fIdefault\fP
.nf
These are packages installed together with mandatory packages.
They can be excluded, f.e. using the \fB\-\-exclude=PACKAGE\-SPEC,...\fP argument.
.fi
.sp
.TP
.B \fIoptional\fP
.nf
These packages are not installed by default.
They can be included using the \fB\-\-with\-optional\fP argument.
.fi
.sp
.TP
.B \fIconditional\fP
.nf
These packages are brought in the transaction if their required package is to be installed.
.fi
.sp
.UNINDENT
.sp
For commands operating with groups and environments, see references below.
.SH SEE ALSO
.INDENT 0.0
.INDENT 3.5
.nf
\fBdnf5\-group(8)\fP, \fI\%Group command\fP
\fBdnf5\-environment(8)\fP, \fI\%Environment command\fP
.fi
.sp
.UNINDENT
.UNINDENT
.SH AUTHOR
See AUTHORS.md in dnf5 source distribution.
.SH COPYRIGHT
Contributors to the dnf5 project.
.\" Generated by docutils manpage writer.
.