From b013e5fb87580e4cab0d85a0d2c8bb402c610413 Mon Sep 17 00:00:00 2001 From: Lukasz Kasprzak Date: Mon, 14 Sep 2026 22:42:52 +0200 Subject: plan 10: docs (-n, README version and scope, trash identity, --json U+FFFD, limitations, changelog) --- man/krino.1 | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) (limited to 'man/krino.1') 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 -- cgit v1.3