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

62b887
From 1b432bada5a3627f729cb42b99b7a93f808e3a80 Mon Sep 17 00:00:00 2001
62b887
From: Aleš Matěj <amatej@redhat.com>
62b887
Date: Tue, 8 Jun 2021 11:48:07 +0200
62b887
Subject: [PATCH] [repomanage] Enhance repomanage documentation (RhBug:1898293)
62b887
62b887
= changelog =
62b887
msg: Enhance repomanage documentation
62b887
type: enhancement
62b887
resolves: https://bugzilla.redhat.com/show_bug.cgi?id=1898293
62b887
---
62b887
 doc/repomanage.rst | 7 ++++---
62b887
 1 file changed, 4 insertions(+), 3 deletions(-)
62b887
62b887
diff --git a/doc/repomanage.rst b/doc/repomanage.rst
62b887
index e4da441..e3171ef 100644
62b887
--- a/doc/repomanage.rst
62b887
+++ b/doc/repomanage.rst
62b887
@@ -31,9 +31,10 @@ Synopsis
62b887
 Description
62b887
 -----------
62b887
 
62b887
-`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.
62b887
+`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.
62b887
+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.
62b887
 
62b887
-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.
62b887
+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.
62b887
 
62b887
 
62b887
 Options
62b887
@@ -44,7 +45,7 @@ All general DNF options are accepted, see `Options` in :manpage:`dnf(8)` for det
62b887
 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.
62b887
 
62b887
 ``--old``
62b887
-    Show older packages.
62b887
+    Show older packages (for a package or a stream show all versions except the newest one).
62b887
 
62b887
 ``--new``
62b887
     Show newest packages.
62b887
--
62b887
libgit2 1.0.1
62b887