Add support for RPMDBI_BASENAMES on file queries

There are legitimate reasons (such as rhbz#1940895 or the included test)
for wanting the former behavior where all file states were considered in
file queries prior to commit 9ad57bda4a82b9847826daa766b4421d877bb3d9,
so celebrate the tenth anniversary of that commit by adding a CLI switch
(a new package selector --path), as contemplated back then.

Update the man page for --file to reflect it's current behavior and make
--path that more obvious.

Resolves: rhbz#1940895

1 files changed, 8 insertions, 2 deletions

diff --git a/docs/man/rpm.8.md b/docs/man/rpm.8.md
index e0cc97353..3a8e4a6b7 100644
--- a/docs/man/rpm.8.md
+++ b/docs/man/rpm.8.md
@@ -57,7 +57,7 @@ select-options
 --------------
 
 \[*PACKAGE\_NAME*\] \[**-a,\--all \[***SELECTOR*\]\] \[**-f,\--file
-***FILE*\] \[**-g,\--group ***GROUP*\] \[**-p,\--package
+***FILE*\] \[**\--path ***PATH*\] \[**-g,\--group ***GROUP*\] \[**-p,\--package
 ***PACKAGE\_FILE*\] \[**\--hdrid ***SHA1*\] \[**\--pkgid ***MD5*\]
 \[**\--tid ***TID*\] \[**\--querybynumber ***HDRNUM*\]
 \[**\--triggeredby ***PACKAGE\_NAME*\] \[**\--whatprovides
@@ -620,7 +620,7 @@ name starts with \"b\".
 
 **-f, \--file ***FILE*
 
-:   Query package owning *FILE*.
+:   Query package owning installed *FILE*.
 
 **\--filecaps**
 
@@ -667,6 +667,12 @@ name starts with \"b\".
     substituted in place of the package manifest as additional
     *PACKAGE\_FILE* arguments to the query.
 
+**\--path ***PATH*
+
+:   Query package(s) owning *PATH*, whether the file is installed or not.
+    Multiple packages may own a *PATH*, but the file is only owned by the
+    package installed last.
+
 **\--pkgid ***MD5*
 
 :   Query package that contains a given package identifier, i.e. the