Blame SOURCES/BZ-1052436-group-bundle-docs.patch

d2a170
commit 3fda2738b0c78df0454e72691a43b459c2e57c21
d2a170
Author: James Antill <james@and.org>
d2a170
Date:   Tue Mar 11 15:09:18 2014 -0400
d2a170
d2a170
    Change man page text for RHEL-7 group_command=object feedback.
d2a170
d2a170
diff --git a/docs/yum.8 b/docs/yum.8
d2a170
index 6794581..1ab8534 100644
d2a170
--- a/docs/yum.8
d2a170
+++ b/docs/yum.8
d2a170
@@ -250,20 +250,34 @@ Is used to download and make usable all the metadata for the currently enabled
d2a170
 sure the repos. are current (much like "yum clean expire-cache").
d2a170
 .IP 
d2a170
 .IP "\fBgroups\fP"
d2a170
-A command, new in 3.4.2, that collects all the subcommands that act on groups together.
d2a170
-
d2a170
-"\fBgroup install\fP" is used to install all of the individual packages in a group, of the specified
d2a170
-types (this works as if you'd taken each of those package names and put them on
d2a170
-the command line for a "yum install" command).
d2a170
+A command, new in 3.4.2, that collects all the subcommands that act on groups
d2a170
+together. Note that recent yum using distributions (Fedora-19+, RHEL-7+) have
d2a170
+configured group_command=objects which changes how group commands act in some
d2a170
+important ways.
d2a170
+
d2a170
+"\fBgroup install\fP" is used to install all of the individual packages in a
d2a170
+group, of the specified types (this works as if you'd taken each of those
d2a170
+package names and put them on the command line for a "yum install" command).
d2a170
  The group_package_types configuration option specifies which types will
d2a170
 be installed.
d2a170
-
d2a170
-"\fBgroup update\fP" is just an alias for groupinstall, which will do the right thing because
d2a170
-"yum install X" and "yum update X" do the same thing, when X is already
d2a170
-installed.
d2a170
-
d2a170
-"\fBgroup list\fP" is used to list the available groups from all \fByum\fP repos. Groups are marked
d2a170
-as "installed" if all mandatory packages are installed, or if a group doesn't
d2a170
+ If you wish to "reinstall" a group so that you get a package that is currently
d2a170
+blacklisted the easiest way to do that currently is to install the package
d2a170
+manually and then run "groups mark packages-sync mygroup mypackagename" (or
d2a170
+use yumdb to set the group_member of the package(s)).
d2a170
+
d2a170
+"\fBgroup update\fP" is just an alias for group install, when using
d2a170
+group_command=compat. This will install packages in the group not already
d2a170
+installed and upgrade existing packages. With group_command=simple it will just
d2a170
+upgrade already installed packages. With group_command=objects it will try to
d2a170
+upgrade the group object, installing any available packages not blacklisted
d2a170
+(marked '-' in group info) and will upgrade the installed packages.
d2a170
+
d2a170
+"\fBgroup list\fP" is used to list the available groups from all \fByum\fP
d2a170
+repos. When group_command=objects the group is installed if the user
d2a170
+explicitly installed it (or used the group mark* commands to mark it installed).
d2a170
+It does not need to have any packages installed.
d2a170
+When not using group_command=objects groups are shown as "installed" if all
d2a170
+mandatory packages are installed, or if a group doesn't
d2a170
 have any mandatory packages then it is installed if any of the optional or
d2a170
 default package are installed (when not in group_command=objects mode).
d2a170
 You can pass optional arguments to the list/summary commands: installed,
d2a170
@@ -300,6 +314,9 @@ meaning of these markers is:
d2a170
 .br
d2a170
 "=" = Package is installed, and was installed via the group.
d2a170
 
d2a170
+you can move an installed package into an installed group using either
d2a170
+"group mark package-sync/package-sync-forced" or "yumdb set group_member".
d2a170
+
d2a170
 "\fBgroup summary\fP" is used to give a quick summary of how many groups
d2a170
 are installed and available.
d2a170
 
d2a170
commit e15943868e2a05e4304247f1e19d2520701e9cca
d2a170
Author: James Antill <james@and.org>
d2a170
Date:   Tue Mar 25 00:12:26 2014 -0400
d2a170
d2a170
    Documentation tweak for group info and blacklisted packages.
d2a170
d2a170
diff --git a/docs/yum.8 b/docs/yum.8
d2a170
index 1ab8534..3f028f8 100644
d2a170
--- a/docs/yum.8
d2a170
+++ b/docs/yum.8
d2a170
@@ -306,7 +306,7 @@ to each package saying how that package relates to the group object. The
d2a170
 meaning of these markers is:
d2a170
 
d2a170
 .br
d2a170
-"-" = Package isn't installed, and won't be installed as part of the group (Eg. group install foo -pkgA … this will have pkgA marked as '-')
d2a170
+"-" = Package isn't installed, and won't be installed as part of the group (Eg.  "yum group install foo -pkgA" or "yum group install foo; yum remove pkgA" … this will have pkgA marked as '-')
d2a170
 .br
d2a170
 "+" = Package isn't installed, but will be the next time you run "yum upgrade" or "yum group upgrade foo"
d2a170
 .br