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

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