aboutsummaryrefslogtreecommitdiffstats
path: root/desktop/modules/qtmaildir/README.md
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-10-17 11:34:07 +0200
committerDanilo M. <danix@danix.xyz>2026-10-17 11:34:07 +0200
commit080d3d9aaffa8848d6de8546511f096d8e7c30f5 (patch)
tree2663bd5c774d8db7fa024e82546f6cfa04c07e29 /desktop/modules/qtmaildir/README.md
parentb8c0f01f058c87db5924067dbb475aa241c71b46 (diff)
downloadquickshell-080d3d9aaffa8848d6de8546511f096d8e7c30f5.tar.gz
quickshell-080d3d9aaffa8848d6de8546511f096d8e7c30f5.zip
settings: pages edit a draft, and Save writes it
The qtmaildir, Assistant and Ask presets pages wrote a field on Enter, and a switch or chip the moment it was clicked, so a half-finished change reached the file and a slip could not be taken back. They now edit a draft as fields are typed, and a Save and Discard pair in the page header (SaveBar, through Page.actions) writes or drops it. Save waits while a field holds a value that cannot be written, and a draft over a file that changed on disk meanwhile is refused at Save rather than written over it. A dot in the sidebar marks a page with unsaved edits; drafts survive moving between pages. The four Mail pages share one draft, since they are one file. Tool switches are staged too and renamed on Save; model Load, Prefer and Restart stay immediate, being actions rather than settings. Live editing needed two rules. A field is no longer bound to its value, which would reset the cursor and eat a typed trailing space; it follows the value only when the draft moves under it. And a Repeater's model is now the set of row keys (or a count), assigned only when that set changes: an array rebuilt from the draft on each keystroke recreates every row, including the one being typed in, which loses its focus. Git, autostart's rows, HyprSunset, HyprIdle and User keep their own buttons. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Diffstat (limited to 'desktop/modules/qtmaildir/README.md')
-rw-r--r--desktop/modules/qtmaildir/README.md9
1 files changed, 6 insertions, 3 deletions
diff --git a/desktop/modules/qtmaildir/README.md b/desktop/modules/qtmaildir/README.md
index 250ceb3..e74d9cc 100644
--- a/desktop/modules/qtmaildir/README.md
+++ b/desktop/modules/qtmaildir/README.md
@@ -17,9 +17,12 @@ Four settings pages, under Mail, for qtmaildir's
qtmaildir reads the file at startup and never writes it, so editing it
under a running qtmaildir is safe; the pages say when it is running and a
-change waits for its restart. A field saves on Enter, and emptied it unsets
-the key, so qtmaildir's default applies; the placeholders name those
-defaults, from qtmaildir's README. Numbers are range-checked before writing.
+change waits for its restart. Every field, switch and row edits one draft
+shared by the four pages, and Save in any page's header writes it all;
+Discard drops it. Emptied, a field unsets the key, so qtmaildir's default
+applies; the placeholders name those defaults, from qtmaildir's README.
+Numbers are range-checked, and a refused one holds Save back. A save over a
+file changed on disk since the draft began is refused rather than lost.
`Ini.js` edits the file a line at a time so its comments and order survive:
a key unset is commented out with `;`, a commented key set again is