From 0b5d0eb92c5be2f0ddb2fa73990f31e5654e57fe Mon Sep 17 00:00:00 2001
From: Lukasz Kasprzak <lukas@labunix.xyz>
Date: Mon, 14 Sep 2026 15:16:55 +0200
Subject: krino: 0.0.5 — keyword cache, t and d in review
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 man/krino.1 | 34 +++++++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

(limited to 'man/krino.1')

diff --git a/man/krino.1 b/man/krino.1
index 458bd56..cc4c2e1 100644
--- a/man/krino.1
+++ b/man/krino.1
@@ -244,11 +244,25 @@ each step, then the rule and the reason it matched:
        copy    \(-> ~/backup/invoices/2026/
        rule    backup
        because content "invoice"
-  [y] yes  [n] no  [a] yes to this and all remaining  [d] done, apply chosen so far  [q] quit, apply nothing
+  [y] yes  [n] no  [a] yes to this and all remaining  [t] trash  [d] delete permanently  [w] write, apply chosen so far  [q] quit, apply nothing
 .Ed
 .Pp
 Approval is per file: a file's whole chain runs, or none of it.
+.Ic t
+and
+.Ic d
+set aside what the rules planned for the file and approve one step on the
+file itself instead: to the Trash, or deleted permanently, logged under the
+rule name
+.Sy (review) .
 .Ic d
+first asks
+.Dq delete Ar name No permanently? [y/N] ;
+any key but
+.Ic y
+deletes nothing and asks about the file again.
+A permanent delete cannot be undone.
+.Ic w
 stops asking and applies whatever was already chosen, declining the rest.
 .Ic q
 here aborts the review for this directory entirely, discarding even a file
@@ -272,6 +286,13 @@ both apply nothing:
 [a] apply all  [c] choose per file  [s] skip  [q] quit
 .Ed
 .Pp
+Its per-file prompt is the one in
+.Sx REVIEW
+without
+.Ic t
+and
+.Ic d .
+.Pp
 An undo run cannot itself be undone: naming it to
 .Ic undo
 is refused.
@@ -320,6 +341,11 @@ step uses
 .Pq Pa $XDG_DATA_HOME/Trash ;
 default
 .Pa ~/.local/share .
+.It Ev XDG_CACHE_HOME
+Base of the keyword cache
+.Pq Pa $XDG_CACHE_HOME/krino ;
+default
+.Pa ~/.cache .
 .It Ev PAGER
 Used to show a plan taller than the terminal; default
 .Dq less -FRX .
@@ -355,6 +381,12 @@ against the same directory waits, or fails immediately with
 The freedesktop.org trash a
 .Sy (delete)
 step moves files into.
+.It Pa $XDG_CACHE_HOME/krino/ Ns Ar name Ns Pa .cache
+Which content keywords each extracted file of directory
+.Ar name
+contains, so an unchanged file is not extracted again; see
+.Xr krino.conf 5 , Sx CONTENT EXTRACTION .
+Safe to delete at any time.
 .El
 .Sh EXIT STATUS
 .Bl -tag -width Ds
-- 
cgit v1.3