Blame SOURCES/0003-repomanage-Enhance-repomanage-documentation-RhBug1898293.patch

237e18
From 1b432bada5a3627f729cb42b99b7a93f808e3a80 Mon Sep 17 00:00:00 2001
237e18
From: Aleš Matěj <amatej@redhat.com>
237e18
Date: Tue, 8 Jun 2021 11:48:07 +0200
237e18
Subject: [PATCH] [repomanage] Enhance repomanage documentation (RhBug:1898293)
237e18
237e18
= changelog =
237e18
msg: Enhance repomanage documentation
237e18
type: enhancement
237e18
resolves: https://bugzilla.redhat.com/show_bug.cgi?id=1898293
237e18
---
237e18
 doc/repomanage.rst | 7 ++++---
237e18
 1 file changed, 4 insertions(+), 3 deletions(-)
237e18
237e18
diff --git a/doc/repomanage.rst b/doc/repomanage.rst
237e18
index e4da441..e3171ef 100644
237e18
--- a/doc/repomanage.rst
237e18
+++ b/doc/repomanage.rst
237e18
@@ -31,9 +31,10 @@ Synopsis
237e18
 Description
237e18
 -----------
237e18
 
237e18
-`repomanage` prints newest or oldest packages in a repository specified by <path> for easy piping to xargs or similar programs. In case <path> doesn't contain a valid repository it is searched for rpm packages which are then used instead.
237e18
+`repomanage` prints newest or older packages in a repository specified by <path> for easy piping to xargs or similar programs. In case <path> doesn't contain a valid repodata, it is searched for rpm packages which are then used instead.
237e18
+If the repodata are present, `repomanage` uses them as the source of truth, it doesn't verify that they match the present rpm packages. In fact, `repomanage` can run with just the repodata, no rpm packages are needed.
237e18
 
237e18
-In order to work correctly with modular packages <path> has to contain repodata with modular metadata. If modular content is present `repomanage` prints packages from newest or oldest versions of each stream in addition to newest or oldest non-modular packages.
237e18
+In order to work correctly with modular packages, <path> has to contain repodata with modular metadata. If modular content is present, `repomanage` prints packages from newest or older stream versions in addition to newest or older non-modular packages.
237e18
 
237e18
 
237e18
 Options
237e18
@@ -44,7 +45,7 @@ All general DNF options are accepted, see `Options` in :manpage:`dnf(8)` for det
237e18
 The following options set what packages are displayed. These options are mutually exclusive, i.e. only one can be specified. If no option is specified, the newest packages are shown.
237e18
 
237e18
 ``--old``
237e18
-    Show older packages.
237e18
+    Show older packages (for a package or a stream show all versions except the newest one).
237e18
 
237e18
 ``--new``
237e18
     Show newest packages.
237e18
--
237e18
libgit2 1.0.1
237e18