commit e19e72cd92d3e8ca6800a46a1c3d5992afc55ea4
from: Stefan Sperling <stsp@stsp.name>
date: Fri Sep 23 09:45:41 2022 UTC

improve documentation of the tog limit feature, previous doc was misleading

commit - 64ffece483cd67d1be7059657670ce1f90b53f2f
commit + e19e72cd92d3e8ca6800a46a1c3d5992afc55ea4
blob - 42e7a83ecb03b5864f54b8d755d9073ec0a182c7
blob + c3488dc79dfbff68596199641118d5f73ffdc650
--- tog/tog.1
+++ tog/tog.1
@@ -197,10 +197,22 @@ commit ID SHA1 hash.
 Regular expression syntax is documented in
 .Xr re_format 7 .
 .It Cm &
-Like
+Prompt for a pattern and limit the log view's list of commits to those
+which match the pattern.
+If no pattern is specified, i.e. the
+.Cm &
+prompt is immediately closed with the Enter key, then the pattern is
+cleared.
+Until the pattern is cleared, the limited list of commits replaces the
+full list of commits for all operations supported by the log view.
+For example, a search started with
 .Cm /
-but hides the non-matching commits.
-Use the empty string as a pattern to display all commits.
+will search the limited list of commits, rather than searching all commits.
+The pattern is an extended regular expression which is matched
+against a commit's author name, committer name, log message, and
+commit ID SHA1 hash.
+Regular expression syntax is documented in
+.Xr re_format 7 .
 .It Cm n
 Find the Nth next commit which matches the current search pattern (default: 1).
 .br