docs: Add better description for package globs

This is used in multiple places, but not defined anywhere.

Fixes: https://pagure.io/pungi/issue/1028
Signed-off-by: Lubomír Sedlář <lsedlar@redhat.com>
This commit is contained in:
Lubomír Sedlář 2018-08-28 13:49:14 +02:00
parent 5346e000f0
commit 19a42792db

View File

@ -668,19 +668,23 @@ Options
* ``yaboot`` -- only ``yaboot`` package on ``ppc`` arch matches this (only * ``yaboot`` -- only ``yaboot`` package on ``ppc`` arch matches this (only
in ``yum`` backend) in ``yum`` backend)
.. _additional_packages:
**additional_packages** **additional_packages**
(*list*) -- additional packages to be included in a variant and (*list*) -- additional packages to be included in a variant and
architecture; format: ``[(variant_uid_regex, {arch|*: [package_globs]})]`` architecture; format: ``[(variant_uid_regex, {arch|*: [package_globs]})]``
The packages specified here are matched against RPM names, not any other The packages specified here are matched against RPM names, not any other
provides in the package not the name of source package. provides in the package not the name of source package. Shell globbing is
used, so wildcards are possible. The package can be specified as name only
or ``name.arch``.
**filter_packages** **filter_packages**
(*list*) -- packages to be excluded from a variant and architecture; (*list*) -- packages to be excluded from a variant and architecture;
format: ``[(variant_uid_regex, {arch|*: [package_globs]})]`` format: ``[(variant_uid_regex, {arch|*: [package_globs]})]``
The packages specified here are matched against RPM names, not any other See :ref:`additional_packages <additional_packages>` for details about
provides in the package not the name of source package. package specification.
**filter_system_release_packages** **filter_system_release_packages**
(*bool*) -- for each variant, figure out the best system release package (*bool*) -- for each variant, figure out the best system release package
@ -694,9 +698,10 @@ Options
through this option can not be removed by ``filter_packages``. through this option can not be removed by ``filter_packages``.
**multilib_blacklist** **multilib_blacklist**
(*dict*) -- multilib blacklist; format: ``{arch|*: [package_globs]}``. The (*dict*) -- multilib blacklist; format: ``{arch|*: [package_globs]}``.
patterns are tested with ``fnmatch``, so shell globbing is used (not
regular expression). See :ref:`additional_packages <additional_packages>` for details about
package specification.
**multilib_whitelist** **multilib_whitelist**
(*dict*) -- multilib blacklist; format: ``{arch|*: [package_names]}``. The (*dict*) -- multilib blacklist; format: ``{arch|*: [package_names]}``. The