diff --git a/Documentation/user-search.txt b/Documentation/user-search.txt
index 8652c07..c335611 100644
--- a/Documentation/user-search.txt
+++ b/Documentation/user-search.txt
@@ -263,8 +263,8 @@
 
 is:reviewed::
 +
-True if there is at least one non-zero score on the change, in any
-approval category, by any user.
+True if any user has commented on the change more recently than the
+last update (comment or patch set) from the change owner.
 
 is:owner::
 +
@@ -306,8 +306,9 @@
 
 status:reviewed::
 +
-Same as 'is:reviewed', matches if there is at least one non-zero
-score on the change, in any approval category, by any user.
+Same as 'is:reviewed', matches if any user has commented on the change
+more recently than the last update (comment or patch set) from the
+change owner.
 
 status:submitted::
 +
@@ -350,6 +351,12 @@
 Changes containing a top-level or inline comment by 'USER', or owned by
 'USER'. Equivalent to `(owner:USER OR commentby:USER)`.
 
+[[reviewedby]]
+reviewedby:'USER'::
++
+Changes where 'USER' has commented on the change more recently than the
+last update (comment or patch set) from the change owner.
+
 
 == Argument Quoting