aboutsummaryrefslogtreecommitdiff
path: root/man/krino.1
diff options
context:
space:
mode:
Diffstat (limited to 'man/krino.1')
-rw-r--r--man/krino.119
1 files changed, 17 insertions, 2 deletions
diff --git a/man/krino.1 b/man/krino.1
index fb6731f..246184b 100644
--- a/man/krino.1
+++ b/man/krino.1
@@ -73,7 +73,7 @@ prints the plan and asks how to proceed
.Fl y
applies the plan without asking;
.Fl n
-prints it and changes nothing.
+prints it and changes no file.
If standard input is not a terminal and neither is given,
.Nm
refuses rather than guess.
@@ -84,7 +84,8 @@ Apply the plan without asking.
Cannot be combined with
.Fl n .
.It Fl n
-Dry run: print the plan and exit without changing anything.
+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 Fl v
Also list files that were skipped as unmatched, ignored or busy, and show
the full reason a test matched or not.
@@ -445,6 +446,20 @@ cheaper test in the same condition already decided the rule did not match.
is a full trace of every test, not a cost-faithful preview of what
.Fl n
would actually spend time on.
+.Pp
+Unicode format characters that are invisible but not controls (a zero-width
+space, U+FEFF, a soft hyphen) are printed as they are, so two names can look
+the same.
+Wrapping counts characters, not terminal columns: a name in a wide script
+(CJK) or with many combining marks can run past the terminal's width.
+.Pp
+A second interrupt exits at once: every step completed so far is logged
+and can be undone, but the step in flight when it arrived is not logged.
+.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
+refused as missing.
.Sh SEE ALSO
.Xr krino.conf 5
.Pp