summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-09-28 19:41:44 -0300
committerGabriel Schneider <[email protected]>2026-10-01 00:12:15 -0300
commite0b3f11f008e54174d5169147b8cf5dac56e915a (patch)
tree888e1cfb21a381b599ae59f1b1942572aba54fa9 /docs
parentfb87946e09bf33c0fe663ccba6db14a63e7cfda4 (diff)
downloadpardes-e0b3f11f008e54174d5169147b8cf5dac56e915a.tar.gz
pardes-e0b3f11f008e54174d5169147b8cf5dac56e915a.zip
A tag no longer marks an unsaved file with *: the grip shows it
The grip button now shows a pane's unsaved text in every state, as acme's modbutton does, and acme's tag has no asterisk. The computed prefix is the name alone, so tag reads, event offsets that count the path and the tag's text lose the " *". dirty, index's flag and the refuse-once guards are unchanged; a dump from before still restores its tags past the old mark. Co-Authored-By: Claude Opus 5.5 <[email protected]>
Diffstat (limited to 'docs')
-rw-r--r--docs/fs.md5
-rw-r--r--docs/macos.md4
-rw-r--r--docs/tags.md8
3 files changed, 11 insertions, 6 deletions
diff --git a/docs/fs.md b/docs/fs.md
index 9a77beee..f6516ea1 100644
--- a/docs/fs.md
+++ b/docs/fs.md
@@ -458,8 +458,9 @@ The three flag files `dirty`, `mark` and `scroll` read `0` or `1` and take
an undo point (writing `1` pushes one now), and whether a write scrolls the
pane.
-`tag` reads the whole tag as the pane shows it: the computed path, dirty
-marker or PDF page, then the text you may edit. A write appends to that text,
+`tag` reads the whole tag as the pane shows it: the computed path or PDF
+page (no mark for unsaved text: the grip shows that, and `dirty` says it),
+then the text you may edit. A write appends to that text,
newlines included, and a tag with more than one line takes a row per line on
screen; truncating `tag` clears it, as acme's `cleartag` does -- the default
words (`Del`, `Put` and the rest) with it, since they are that text until
diff --git a/docs/macos.md b/docs/macos.md
index 5166e2d5..cf7091e6 100644
--- a/docs/macos.md
+++ b/docs/macos.md
@@ -355,8 +355,8 @@ The dirty half needed one core watermark. `File` counted `revision` but never
recorded which edit was last *written*, so no shell could derive "unsaved" —
`File.saved_revision` is that watermark, advanced by `Save` at the moment the
write is asked for and by a successful external-file reload whose bytes
-already came from disk. The core renders the same answer as ` *` after the
-path in every tagline, while this host also puts it in the native close button.
+already came from disk. The core shows the same answer on each pane's grip
+button, while this host also puts it in the native close button.
Save is marked at ask-time rather than on completion because `save_file`
carries none back, which makes both indicators exactly as honest as the Save
request.
diff --git a/docs/tags.md b/docs/tags.md
index 9b9a23c5..0339f1db 100644
--- a/docs/tags.md
+++ b/docs/tags.md
@@ -77,13 +77,13 @@ a collapsed pane shows only the first line. The column and workspace tags
are one line, as acme's (cols.c:244 gives a column tag one font height): a
newline typed, pasted or written into one becomes a space, and a dump that
holds a column or workspace tag of several lines, from before, comes back
-with its lines joined by spaces. The path, the dirty marker and a PDF's page at the start of a
+with its lines joined by spaces. The path and a PDF's page at the start of a
pane tag are computed, never stored, and read-only. The keyboard reaches
them as the mouse does: `0` goes to the line's start, the path's, as in
acme, and motions select and yank across the path and the commands. An edit
that would change them is refused and leaves the cursor where it was; typing
into a file's path instead drafts a new name, as clicking it does. When they
-grow or shrink (a rename, the dirty marker, a PDF's page) the cursor keeps
+grow or shrink (a rename, a PDF's page) the cursor keeps
its place in the text after them.
Left-click a tag or a header to type into it at the click, in insert mode;
@@ -169,3 +169,7 @@ and subtle pixel separators.
`FocusTint` controls active-column and active-pane emphasis. SDL also honors
the shared bold, underline, and strikethrough attributes, including diagnostic
underlines and the optional `SyntaxBold` keyword weight.
+
+Unsaved text shows on the pane's grip button, as acme's modbutton does,
+not in the tag: the tag names the file and nothing more. The `dirty` file
+and `index`'s flag say the same to a script.