From 319955900ccee4ea5d97bf59ab0fca43334b3bf6 Mon Sep 17 00:00:00 2001
From: Tomas Kopecek <tkopecek@redhat.com>
Date: Sep 19 2023 10:51:48 +0000
Subject: Update docstring for listPackages


Related: https://pagure.io/koji/issue/3874

---

diff --git a/kojihub/kojihub.py b/kojihub/kojihub.py
index 20e72fb..6bb07f3 100644
--- a/kojihub/kojihub.py
+++ b/kojihub/kojihub.py
@@ -12551,6 +12551,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