Provided by: yum-utils_1.1.31-4build1_all bug


       yum-groups-manager - create and edit yum's group metadata


       yum-groups-manager [options] [packages]


       yum-groups-manager  is  used to create or edit a group metadata file for a yum repository.
       This is often much easier than writing/editing the XML by  hand.   The  yum-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.


       -h, --help
              Display a help message, and then quit.

              Display a version message, and then quit.

       -n, --name
              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.

       --id   The  id  to  lookup/use for the group. If you don't specify an id, 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.

              The description to use for the group.

              Store  the  package  names  specified within the mandatory section of the specified
              group, the default is to use the  default  section.  This  overrides  the  optional

              Store  the  package  names  specified  within the optional section of the specified
              group, the default is to use the default section. This option is overridden by  the
              mandatory argument.

              Also include the names of the direct dependencies for each package specified.

              Make the group not visible in yum grouplist.

              Make the group visible in yum grouplist (this is the default).

              Change the integer which controls the order groups are presented in, for example in
              yum grouplist.

       --load Load the groups metadata information from the specified file, before performing any
              operations. This option can be specified multiple times.

       --save 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.

              This  is  the same as loading and saving a file, however the "merge" file is loaded
              before any others and saved last.

              Also print the result to stdout, if saving or merging.

              Instead of adding package, remove them. Note that the packages are removed from all
              sections (default, mandatory and optional).

              This  is  another  name  for  the  group  within  the  locale  given. The syntax is
              lang:text. Eg. en:my-group-name-in-english

              This is another description for the group within the locale given.  The  syntax  is
              lang:text. Eg. en:my-group-description-in-english.


       The following options are meant to be the same as those with the same name in yum.

       -c CONFIG, --config=CONFIG






       -C, --cache



       Create a new group metadata file, with a group called yum containing all the packages that
       start with yum:
               yum-groups-manager --name YUM --save groups.xml 'yum*'

       After the above command, load the groups.xml data, work with the yum group, make the group
       not user visible, and remove the yum-skip-broken and yum-priorities packages from it:
               yum-groups-manager   -n  YUM  --merge  groups.xml  --remove  yum-skip-broken  yum-
              priorities --not-user-visible

       After the above commands, add a description and a translated name to the yum group:
               yum-groups-manager -n YUM --merge groups.xml --description 'This is a  group  with
              most of the yum packages in it' --translated-name 'en:yum packages'


       yum-groups-manager  uses  the yum libraries for retrieving information and packages. If no
       configuration file is specified, the default yum configuration will be used.



       yum (8)
       yum.conf (5)


       See the Authors file included with this program.


       There are a couple of options you can't set, yet. Most notably you cannot put
       package names into the conditional section (where they are installed with
       groupinstall only if another package is installed).

       Other than that, there are no bugs, but should you find any, you should first
       consult the FAQ section on and if unsuccessful
       in finding a resolution contact the mailing list:
       To file a bug use for Fedora/RHEL/Centos
       related bugs and for all other bugs.

                                          23 August 2008                    yum-groups-manager(1)