aboutsummaryrefslogtreecommitdiff
path: root/man/krino.1
diff options
context:
space:
mode:
authorLukasz Kasprzak <lukas@labunix.xyz>2026-09-14 22:42:52 +0200
committerLukasz Kasprzak <lukas@labunix.xyz>2026-09-14 22:42:52 +0200
commitb013e5fb87580e4cab0d85a0d2c8bb402c610413 (patch)
tree84aefe0c6c3b91f6bbc51a329c143b9ef60f9de4 /man/krino.1
parent9e65644f473d75ceb7e3ef67302189eeaba0f922 (diff)
downloadkrino-b013e5fb87580e4cab0d85a0d2c8bb402c610413.tar.gz
krino-b013e5fb87580e4cab0d85a0d2c8bb402c610413.zip
plan 10: docs (-n, README version and scope, trash identity, --json U+FFFD, limitations, changelog)
Diffstat (limited to 'man/krino.1')
-rw-r--r--man/krino.112
1 files changed, 11 insertions, 1 deletions
diff --git a/man/krino.1 b/man/krino.1
index e9d41da..ecbadc2 100644
--- a/man/krino.1
+++ b/man/krino.1
@@ -85,7 +85,8 @@ Cannot be combined with
.Fl n .
.It Fl n
Dry run: print the plan and exit without changing any file.
-It may refresh the keyword cache, which only makes the next run faster.
+It may create krino's empty state directory, and refresh the keyword cache,
+which only makes the next run faster.
.It Fl v
Also list files that were skipped as unmatched, ignored or busy, and show
the full reason a test matched or not.
@@ -460,6 +461,15 @@ and a copy in progress can leave a temporary
.Pa .krino-*
file and an empty directory behind.
.Pp
+An undo recreates the directories it needs to move a file back, and removes
+them again only when that file's reversal completes; one interrupted or
+failed after recreating a directory, and never finished for that file,
+leaves the directory behind, empty.
+.Pp
+.Fl -json
+prints invalid UTF-8 in a file name as U+FFFD, so two such names can look
+the same in the JSON plan.
+.Pp
Undo identifies a file by its directory and its path within it.
A file one directory's rules move into another included directory, which
sorts it again in the same run, is two files to undo; the first may then be