From 04836cfa9f62534e28df658acd6cca992e5cccb9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lubom=C3=ADr=20Sedl=C3=A1=C5=99?= Date: Thu, 14 Sep 2017 09:09:08 +0200 Subject: [PATCH] docs: Mention how input package list are interpreted MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit It's really just an RPM name, not any random provide or source package name. Fixes: https://pagure.io/pungi/issue/725 Signed-off-by: Lubomír Sedlář --- doc/configuration.rst | 6 ++++++ doc/gathering.rst | 4 ++++ 2 files changed, 10 insertions(+) diff --git a/doc/configuration.rst b/doc/configuration.rst index dcf6e6bb..55dccc40 100644 --- a/doc/configuration.rst +++ b/doc/configuration.rst @@ -603,10 +603,16 @@ Options (*list*) -- additional packages to be included in a variant and architecture; format: ``[(variant_uid_regex, {arch|*: [package_globs]})]`` + The packages specified here are matched against RPM names, not any other + provides in the package not the name of source package. + **filter_packages** (*list*) -- packages to be excluded from a variant and architecture; format: ``[(variant_uid_regex, {arch|*: [package_globs]})]`` + The packages specified here are matched against RPM names, not any other + provides in the package not the name of source package. + **filter_system_release_packages** (*bool*) -- for each variant, figure out the best system release package and filter out all others. This will not work if a variant needs more than diff --git a/doc/gathering.rst b/doc/gathering.rst index 244fa5c0..7a3b6803 100644 --- a/doc/gathering.rst +++ b/doc/gathering.rst @@ -12,6 +12,10 @@ The inputs for gathering are defined by the ``gather_source`` option. It provides a list of package names, comps groups names and a list of packages that should be filtered out. +.. note:: + The inputs for both explicit package list and comps file are interpreted as + RPM names, not any arbitrary provides nor source package name. + Next, ``gather_method`` defines how the list is processed. For ``nodeps``, the results from source are used pretty much as is [#]_. For ``deps`` method, a process will be launched to figure out what dependencies are needed and those