Update docstring for listPackages

Related: https://pagure.io/koji/issue/3874
This commit is contained in:
Tomas Kopecek 2023-09-19 12:51:48 +02:00
parent 75a3cab1e8
commit c1925782b4

View file

@ -12865,6 +12865,15 @@ class RootExports(object):
Note that the returned data includes blocked entries
In the simple case (no tagID, userID, or pkgID option), the call simply queries
the package table. This will show all packages in the system. However, when any
of these options are given, the call will query the tag_packages table, showing
only packages that are included in some tag.
This can lead to the confusing situation where a call to listPackages() shows
a particular package, but a call to listPackages(pkgID=N) for said package reports
no results.
:param int|str tag: filter on tag ID or name
:param int|str userID: filter on package owner
:param int|str pkgID: filter on package