From 1d5edddef7143dac6a7191b86290222586c895f9 Mon Sep 17 00:00:00 2001 From: Martin von Zweigbergk Date: Tue, 25 Apr 2023 10:25:46 -0700 Subject: [PATCH] docs: clarify that `file()` revsets match recursively --- docs/revsets.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/revsets.md b/docs/revsets.md index 2aceac64d..71a3d2d1e 100644 --- a/docs/revsets.md +++ b/docs/revsets.md @@ -119,7 +119,10 @@ revsets (expressions) as arguments. * `empty()`: Commits modifying no files. This also includes `merges()` without user modifications and `root`. * `file(pattern..)`: Commits modifying the paths specified by the `pattern..`. - Paths are relative to the directory `jj` was invoked from. + Paths are relative to the directory `jj` was invoked from. A directory name + will match all files in that directory and its subdirectories. For example, + `file(foo)` will match files `foo`, `foo/bar`, `foo/bar/baz`, but not file + `foobar`. * `conflict()`: Commits with conflicts. * `present(x)`: Same as `x`, but evaluated to `none()` if any of the commits in `x` doesn't exist (e.g. is an unknown branch name.)