summaryrefslogtreecommitdiffstats
path: root/upstream/debian-bookworm/man8/dnf-groups-manager.8
blob: 7b01e9b14df08bf603f47252c0731e4d3be0b59f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
.\" 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 "DNF-GROUPS-MANAGER" "8" "Jan 22, 2023" "4.3.1" "dnf-plugins-core"
.SH NAME
dnf-groups-manager \- DNF groups-manager Plugin
.sp
Create and edit groups repository metadata files.
.SH SYNOPSIS
.sp
\fBdnf groups\-manager [options] [package\-name\-spec [package\-name\-spec ...]]\fP
.SH DESCRIPTION
.sp
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.
.SH ARGUMENTS
.INDENT 0.0
.TP
.B \fB<package\-name\-spec>\fP
Package to add to a group or remove from a group.
.UNINDENT
.SH OPTIONS
.sp
All general DNF options are accepted, see \fIOptions\fP in \fBdnf(8)\fP for details.
.INDENT 0.0
.TP
.B \fB\-\-load=<path_to_comps.xml>\fP
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.
.TP
.B \fB\-\-save=<path_to_comps.xml>\fP
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.
.TP
.B \fB\-\-merge=<path_to_comps.xml>\fP
This is the same as loading and saving a file, however the “merge” file is loaded before any others and saved last.
.TP
.B \fB\-\-print\fP
Also print the result to stdout.
.TP
.B \fB\-\-id=<id>\fP
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.
.TP
.B \fB\-n <name>, \-\-name=<name>\fP
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.
.TP
.B \fB\-\-description=<description>\fP
The description to use for the group.
.TP
.B \fB\-\-display\-order=<display_order>\fP
Change the integer which controls the order groups are presented in, for example in \fBdnf grouplist\fP\&.
.TP
.B \fB\-\-translated\-name=<lang:text>\fP
A translation of the group name in the given language. The syntax is \fBlang:text\fP\&. Eg. \fBen:my\-group\-name\-in\-english\fP
.TP
.B \fB\-\-translated\-description=<lang:text>\fP
A translation of the group description in the given language. The syntax is \fBlang:text\fP\&. Eg. \fBen:my\-group\-description\-in\-english\fP\&.
.TP
.B \fB\-\-user\-visible\fP
Make the group visible in \fBdnf grouplist\fP (this is the default).
.TP
.B \fB\-\-not\-user\-visible\fP
Make the group not visible in \fBdnf grouplist\fP\&.
.TP
.B \fB\-\-mandatory\fP
Store the package names specified within the mandatory section of the specified group, the default is to use the default section.
.TP
.B \fB\-\-optional\fP
Store the package names specified within the optional section of the specified group, the default is to use the default section.
.TP
.B \fB\-\-remove\fP
Instead of adding packages remove them. Note that the packages are removed from all sections (default, mandatory and optional).
.TP
.B \fB\-\-dependencies\fP
Also include the names of the direct dependencies for each package specified.
.UNINDENT
.SH AUTHOR
See AUTHORS in your Core DNF Plugins distribution
.SH COPYRIGHT
2023, Red Hat, Licensed under GPLv2+
.\" Generated by docutils manpage writer.
.