| 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 "DNF4-GROUPS-MANAGER" "8" "Sep 27, 2025" "4.10.1" "dnf-plugins-core" |
| 31 |
.SH NAME |
| 32 |
dnf4-groups-manager \- DNF groups-manager Plugin |
| 33 |
.sp |
| 34 |
Create and edit groups repository metadata files. |
| 35 |
.SH SYNOPSIS |
| 36 |
.sp |
| 37 |
\fBdnf groups\-manager [options] [package\-name\-spec [package\-name\-spec ...]]\fP |
| 38 |
.SH DESCRIPTION |
| 39 |
.sp |
| 40 |
groups\-manager plugin is used to create or edit a group metadata file for a repository. This is often much easier than writing/editing the XML by hand. The groups\-manager can load an entire file of groups metadata and either create a new group or edit an existing group and then write all of the groups metadata back out. |
| 41 |
.SH ARGUMENTS |
| 42 |
.INDENT 0.0 |
| 43 |
.TP |
| 44 |
.B \fB<package\-name\-spec>\fP |
| 45 |
Package to add to a group or remove from a group. |
| 46 |
.UNINDENT |
| 47 |
.SH OPTIONS |
| 48 |
.sp |
| 49 |
All general DNF options are accepted, see \fIOptions\fP in \fBdnf(8)\fP for details. |
| 50 |
.INDENT 0.0 |
| 51 |
.TP |
| 52 |
.B \fB\-\-load=<path_to_comps.xml>\fP |
| 53 |
Load the groups metadata information from the specified file before performing any operations. Metadata from all files are merged together if the option is specified multiple times. |
| 54 |
.TP |
| 55 |
.B \fB\-\-save=<path_to_comps.xml>\fP |
| 56 |
Save the result to this file. You can specify the name of a file you are loading from as the data will only be saved when all the operations have been performed. This option can also be specified multiple times. |
| 57 |
.TP |
| 58 |
.B \fB\-\-merge=<path_to_comps.xml>\fP |
| 59 |
This is the same as loading and saving a file, however the “merge” file is loaded before any others and saved last. |
| 60 |
.TP |
| 61 |
.B \fB\-\-print\fP |
| 62 |
Also print the result to stdout. |
| 63 |
.TP |
| 64 |
.B \fB\-\-id=<id>\fP |
| 65 |
The id to lookup/use for the group. If you don’t specify an \fB<id>\fP, but do specify a name that doesn’t refer to an existing group, then an id for the group is generated based on the name. |
| 66 |
.TP |
| 67 |
.B \fB\-n <name>, \-\-name=<name>\fP |
| 68 |
The name to lookup/use for the group. If you specify an existing group id, then the group with that id will have it’s name changed to this value. |
| 69 |
.TP |
| 70 |
.B \fB\-\-description=<description>\fP |
| 71 |
The description to use for the group. |
| 72 |
.TP |
| 73 |
.B \fB\-\-display\-order=<display_order>\fP |
| 74 |
Change the integer which controls the order groups are presented in, for example in \fBdnf grouplist\fP\&. |
| 75 |
.TP |
| 76 |
.B \fB\-\-translated\-name=<lang:text>\fP |
| 77 |
A translation of the group name in the given language. The syntax is \fBlang:text\fP\&. Eg. \fBen:my\-group\-name\-in\-english\fP |
| 78 |
.TP |
| 79 |
.B \fB\-\-translated\-description=<lang:text>\fP |
| 80 |
A translation of the group description in the given language. The syntax is \fBlang:text\fP\&. Eg. \fBen:my\-group\-description\-in\-english\fP\&. |
| 81 |
.TP |
| 82 |
.B \fB\-\-user\-visible\fP |
| 83 |
Make the group visible in \fBdnf grouplist\fP (this is the default). |
| 84 |
.TP |
| 85 |
.B \fB\-\-not\-user\-visible\fP |
| 86 |
Make the group not visible in \fBdnf grouplist\fP\&. |
| 87 |
.TP |
| 88 |
.B \fB\-\-mandatory\fP |
| 89 |
Store the package names specified within the mandatory section of the specified group, the default is to use the default section. |
| 90 |
.TP |
| 91 |
.B \fB\-\-optional\fP |
| 92 |
Store the package names specified within the optional section of the specified group, the default is to use the default section. |
| 93 |
.TP |
| 94 |
.B \fB\-\-remove\fP |
| 95 |
Instead of adding packages remove them. Note that the packages are removed from all sections (default, mandatory and optional). |
| 96 |
.TP |
| 97 |
.B \fB\-\-dependencies\fP |
| 98 |
Also include the names of the direct dependencies for each package specified. |
| 99 |
.UNINDENT |
| 100 |
.SH AUTHOR |
| 101 |
See AUTHORS in your Core DNF Plugins distribution |
| 102 |
.SH COPYRIGHT |
| 103 |
2014, Red Hat, Licensed under GPLv2+ |
| 104 |
.\" Generated by docutils manpage writer. |
| 105 |
. |