From 5ed5646bca2beb663e5b748e36c6816fde89b139 Mon Sep 17 00:00:00 2001 From: Ken Dreyer Date: Fri, 15 May 2020 12:55:13 -0600 Subject: [PATCH] doc: explain tradeoffs with pkgset_allow_reuse Explain why someone would want to enable or disable the pkgset_allow_reuse option. Signed-off-by: Ken Dreyer --- doc/configuration.rst | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/doc/configuration.rst b/doc/configuration.rst index 08eba0d0..c8ec12d2 100644 --- a/doc/configuration.rst +++ b/doc/configuration.rst @@ -507,7 +507,11 @@ Options **pkgset_allow_reuse** = True (*bool*) -- When set to ``True``, *Pungi* will try to reuse pkgset data - from the old composes specified by ``--old-composes``. + from the old composes specified by ``--old-composes``. When enabled, this + option can speed up new composes because it does not need to calculate the + pkgset data from Koji. However, if you block or unblock a package in Koji + (for example) between composes, then Pungi may not respect those changes + in your new compose. Example