From 9b14290c97df62f6e7da91c90b8bd7bb6a4bec42 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Roman=20Smr=C5=BE?= <roman.smrz@seznam.cz>
Date: Sun, 1 Nov 2026 20:36:12 +0100
Subject: =?UTF-8?q?Add=20=E2=80=98upstream=E2=80=99=20revision=20expressio?=
 =?UTF-8?q?n?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

(limited to 'README.md')

diff --git a/README.md b/README.md
index e56fec3..dc85086 100644
--- a/README.md
+++ b/README.md
@@ -70,7 +70,13 @@ To run jobs for commits that are in local `<branch>`, but not yet in its upstrea
 minici run --since-upstream=<branch>
 ```
 
-For current branch, the name can be omitted:
+or equivalently:
+```
+minici run '<branch>..upstream(<branch>)'
+```
+
+This is the default action the `run` command will perform without any
+arguments, using the current branch as `<branch>` when executed as:
 ```
 minici run
 ```
@@ -132,6 +138,8 @@ Where `<commit-expr>` can be:
 * `lasttag(<pattern>)`, which from all the tags matching `<pattern>`, selects
   the last created one (as given by the `tagger` date in tag object);
 
+* `upstream(<branch>)` refers to the upstream (remote) branch of the given `<branch>`;
+
 * `watch(<commit-expr>)` is analogous to `watch` for `<range-expr>`.
 
 And `<pattern>` is a shell glob pattern, as implemented
-- 
cgit v1.2.3