diff --git a/bin/xbps-query/xbps-query.8 b/bin/xbps-query/xbps-query.8
index 51eb8aba..4579e565 100644
--- a/bin/xbps-query/xbps-query.8
+++ b/bin/xbps-query/xbps-query.8
@@ -114,12 +114,8 @@ Search for packages owning the files specified by
 .Ar PATTERN .
 The
 .Ar PATTERN
-can be a shell wildcard pattern (see
-.Xr fnmatch 3),
-a simple string, or a
-.Ar package pattern
-(i.e package name separated by any of the following version comparators:
-\'<' '>' '<=' '>=', 'foo>2.0').
+argument can be a simple string or a shell wildcard pattern as explained in
+.Xr fnmatch 3 .
 Multiple patterns may be specified.
 .It Fl s, Fl -search Ar PATTERN...
 Search for packages matching
@@ -127,10 +123,12 @@ Search for packages matching
 on its
 .Em pkgver
 and/or
-.Em description
+.Em short_desc
 properties. The same rules explained in the
 .Fl -ownedby
-option are applied.
+option are applied, but a
+.Sy PACKAGE EXPRESSION
+is also supported.
 .It Fl f, Fl -files Ar PKG
 Show the package files for
 .Ar PKG .