plan 9: docs and changelog describe what 0.0.7 does

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