From 47fd5c54535c9c3aacae8344e02f80cf37b0eebf Mon Sep 17 00:00:00 2001

From: Jaroslav Mracek <jmracek@redhat.com>

Date: Thu, 14 Feb 2019 09:58:14 +0100

Subject: [PATCH] Document the new behavior of module enable/install commands

---

 doc/command_ref.rst | 17 +++++++++++------

 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/doc/command_ref.rst b/doc/command_ref.rst

index 99f2fbd..c433d35 100644

--- a/doc/command_ref.rst

+++ b/doc/command_ref.rst

@@ -870,6 +870,11 @@ Module subcommands take :ref:`\<module-spec>\ <specifying_modules-label>` that s

     In case no profile was provided, all default profiles get installed.

     Module streams get enabled accordingly.

+    This command cannot be used for switching module streams. It is recommended to remove all

+    installed content from the module, and reset the module using

+    :ref:`reset <module_reset_command-label>` command. After you reset the module, you can install

+    the other stream.

+

 ``dnf [options] module update <module-spec>...``

     Update RPMs in installed module profiles.

     In case no profile was provided, all installed profiles get updated.

@@ -887,20 +892,20 @@ Module subcommands take :ref:`\<module-spec>\ <specifying_modules-label>` that s

     of modular dependency issue the operation will be rejected. To perform action anyway please use

     \-\ :ref:`-skip-broken option <skip-broken_option-label>`.

-    This command can also be used for switching module streams.

-    RPMs from the original stream become unavailable and RPMs from the new

-    stream become available in the package set.

-    The operation does not alter installed packages and their configuration.

-    It is suggested to use the ``dnf distro-sync`` command

-    to synchronize to the latest available RPMs from the new stream.

+    This command cannot be used for switching module streams. It is recommended to remove all

+    installed content from the module, and reset the module using

+    :ref:`reset <module_reset_command-label>` command. After you reset the module, you can enable

+    the other stream.

 .. _module_disable_command-label:

 ``dnf [options] module disable <module-spec>...``

     Disable a module. All related module streams will become unavailable. In case of modular

     dependency issue the operation will be rejected. To perform action anyway please use \-\

     :ref:`-skip-broken option <skip-broken_option-label>`.

+.. _module_reset_command-label:

+

 ``dnf [options] module reset <module-spec>...``

     Reset module state so it's no longer enabled or disabled.

--

libgit2 0.27.7