Blame SOURCES/0008-Document-the-new-behavior-of-module-enableinstall-commands.patch

0f2fcc
From 47fd5c54535c9c3aacae8344e02f80cf37b0eebf Mon Sep 17 00:00:00 2001
0f2fcc
From: Jaroslav Mracek <jmracek@redhat.com>
0f2fcc
Date: Thu, 14 Feb 2019 09:58:14 +0100
0f2fcc
Subject: [PATCH] Document the new behavior of module enable/install commands
0f2fcc
0f2fcc
---
0f2fcc
 doc/command_ref.rst | 17 +++++++++++------
0f2fcc
 1 file changed, 11 insertions(+), 6 deletions(-)
0f2fcc
0f2fcc
diff --git a/doc/command_ref.rst b/doc/command_ref.rst
0f2fcc
index 99f2fbd..c433d35 100644
0f2fcc
--- a/doc/command_ref.rst
0f2fcc
+++ b/doc/command_ref.rst
0f2fcc
@@ -870,6 +870,11 @@ Module subcommands take :ref:`\<module-spec>\ <specifying_modules-label>` that s
0f2fcc
     In case no profile was provided, all default profiles get installed.
0f2fcc
     Module streams get enabled accordingly.
0f2fcc
 
0f2fcc
+    This command cannot be used for switching module streams. It is recommended to remove all
0f2fcc
+    installed content from the module, and reset the module using
0f2fcc
+    :ref:`reset <module_reset_command-label>` command. After you reset the module, you can install
0f2fcc
+    the other stream.
0f2fcc
+
0f2fcc
 ``dnf [options] module update <module-spec>...``
0f2fcc
     Update RPMs in installed module profiles.
0f2fcc
     In case no profile was provided, all installed profiles get updated.
0f2fcc
@@ -887,20 +892,20 @@ Module subcommands take :ref:`\<module-spec>\ <specifying_modules-label>` that s
0f2fcc
     of modular dependency issue the operation will be rejected. To perform action anyway please use
0f2fcc
     \-\ :ref:`-skip-broken option <skip-broken_option-label>`.
0f2fcc
 
0f2fcc
-    This command can also be used for switching module streams.
0f2fcc
-    RPMs from the original stream become unavailable and RPMs from the new
0f2fcc
-    stream become available in the package set.
0f2fcc
-    The operation does not alter installed packages and their configuration.
0f2fcc
-    It is suggested to use the ``dnf distro-sync`` command
0f2fcc
-    to synchronize to the latest available RPMs from the new stream.
0f2fcc
+    This command cannot be used for switching module streams. It is recommended to remove all
0f2fcc
+    installed content from the module, and reset the module using
0f2fcc
+    :ref:`reset <module_reset_command-label>` command. After you reset the module, you can enable
0f2fcc
+    the other stream.
0f2fcc
 
0f2fcc
 .. _module_disable_command-label:
0f2fcc
 
0f2fcc
 ``dnf [options] module disable <module-spec>...``
0f2fcc
     Disable a module. All related module streams will become unavailable. In case of modular
0f2fcc
     dependency issue the operation will be rejected. To perform action anyway please use \-\
0f2fcc
     :ref:`-skip-broken option <skip-broken_option-label>`.
0f2fcc
 
0f2fcc
+.. _module_reset_command-label:
0f2fcc
+
0f2fcc
 ``dnf [options] module reset <module-spec>...``
0f2fcc
     Reset module state so it's no longer enabled or disabled.
0f2fcc
 
0f2fcc
--
0f2fcc
libgit2 0.27.7
0f2fcc