gui: syntax colours, a file preview, and a settings window

1 files changed, 40 insertions, 10 deletions

diff --git a/man/krino-gui.1 b/man/krino-gui.1
index 5f7b803..881637b 100644
--- a/man/krino-gui.1
+++ b/man/krino-gui.1
@@ -1,5 +1,5 @@
 .\" SPDX-License-Identifier: GPL-3.0-or-later
-.Dd September 16, 2026
+.Dd September 17, 2026
 .Dt KRINO-GUI 1
 .Os
 .Sh NAME
@@ -51,7 +51,9 @@ decide about - unreadable content, a failed duplicate check - is listed with
 the reason and cannot be selected.
 .Pp
 Selecting a row explains it: every step with its rule and reason, and any
-warning. The right button offers
+warning, and shows the file itself underneath: a picture for an image, the
+first page for a PDF, the first lines for anything that is text. Nothing
+else is opened, and the file is only read. The right button offers
 .Cm Trash instead
 and
 .Cm Delete permanently instead ,
@@ -77,11 +79,12 @@ as plain
 .Cm krino undo
 does.
 .Ss Rules
-Only a directory's own file,
-.Pa dirs/NAME.conf ,
-is edited;
+This tab edits a directory's own file,
+.Pa dirs/NAME.conf ;
+the includes and excludes of
 .Pa krino.conf
-is not.
+are edited by hand, and its defaults under
+.Cm Settings .
 .Pp
 .Cm Forms
 lists the directory itself, its excludes and its rules. A rule's form holds
@@ -102,13 +105,20 @@ and
 move a rule with the comment lines directly above it.
 .Pp
 .Cm Text
-is the whole file. Either way the configuration is checked as it is edited,
-about a second after typing stops: problems are listed with
+is the whole file, with line numbers and the forms coloured: comments,
+strings, the head of each form, and the actions that move or delete a file.
+.Pp
+Either way the configuration is checked as it is edited, about a second
+after typing stops, and
+.Cm Check
+asks for it at once. Problems are listed under both, with
 .Ar file : Ns Ar line : Ns Ar column ,
 and clicking one goes to that line.
 .Cm Test on file
 answers what the unsaved rules would do to one file, with the trace, the
-captures and the chain.
+captures and the chain;
+.Cm Test rule
+scans the directory and lists the files the selected rule would take.
 .Pp
 .Cm Save
 is refused while the check reports anything, so a window cannot leave krino
@@ -116,6 +126,22 @@ unable to run. It writes atomically, keeps what was there as
 .Pa NAME.conf.bak ,
 and, if the file changed on disk since it was opened, offers to reload,
 overwrite or cancel. Nothing on disk changes until Apply, Undo or Save.
+.Ss Settings
+.Cm Settings ,
+at the bottom of the window, holds two things. The first is krino's own
+defaults - case, fold, recursive, min-age, max-read, max-size, busy,
+on-conflict and the log path - which every directory inherits and its own
+file may override; they are written to
+.Pa krino.conf
+by the rules above: refused while the configuration would not load, the
+previous text kept as
+.Pa krino.conf.bak .
+The second is how this window behaves - the editor's font size, whether the
+configuration is coloured, whether the file behind a row is shown, and
+whether a scanned plan starts with every file checked. Those take effect as
+they are changed and are kept in
+.Pa gui.json ,
+which krino itself never reads.
 .Sh FILES
 .Bl -tag -width Ds
 .It Pa ~/.config/krino/krino.conf
@@ -124,7 +150,11 @@ The main configuration, as for
 .It Pa ~/.config/krino/dirs/NAME.conf
 A directory's rules, and what the Rules tab edits.
 .It Pa ~/.config/krino/dirs/NAME.conf.bak
-The text a save replaced.
+The text a save replaced;
+.Pa krino.conf.bak
+likewise for the main file.
+.It Pa ~/.config/krino/gui.json
+How this window behaves. Deleting it restores the defaults.
 .El
 .Sh EXIT STATUS
 .Ex -std