Message Log
The status bar’s echo line shows one message and replaces it with the next; the Message Log keeps them, so nothing the app said is lost because it scrolled past.
Every app keeps one, session-only and bounded, newest first, with Esc to close and Clear to empty it: DIAG-01. A click on the status bar’s echo area opens it: WIN-01. This page is what the log looks like and how it behaves beyond that.
Rules on this page 6
| ID | Level | Rule |
|---|---|---|
| MLOG-02 | SHOULD | A click on the unread-error count opens the log too, and so does the view.messageLog
command.
|
| MLOG-03 | SHOULD | C-g or a click outside closes the log too, as Esc does.
|
| MLOG-04 | SHOULD | Ctrl+C (Cmd+C on macOS) copies the selected entries.
|
| MLOG-05 | SHOULD | A message’s severity comes from its key: a status.* key whose last segment contains fail
or error is an error, one containing cannot or invalid a warning. Name new keys accordingly, or report through
the error channel directly.
|
| MLOG-06 | SHOULD | Opening the log, or clearing it, resets the unread-error count.
|
| MLOG-07 | SHOULD | An unread error is never evicted silently: the count keeps it even when the entry drops off
the end.
|
Anatomy
Section titled “Anatomy”Messages1
Filter messages…
214:32:07Saved Shelf.java3
14:31:52Language server for Java failed to start: jdtls was not found4
14:30:18Settings sync: not connected, retrying
14:29:40Line numbers: on
14:29:05Opened ~/workspace/shelf/src/main/java/com/example/shelf/Shelf.java
- 1Title "Messages", 14 px bold.
- 2Filter, focused on open. Filters as you type; ↓ or Enter moves into the results without leaving the field.
- 3Entry. The time as
HH:mm:ss(11 px, monospace, muted) and the message as it appeared in the echo line. Newest first. - 4Severity colors the message, not the row: errors red, warnings amber, information in the default color. The time stays muted.
- 5Actions: Copy (the visible entries as text), Clear (empties the session log and its unread count), and Open Doctor: messages carry no actions of their own, and a missing tool or a server that would not start is where Doctor helps.
- 6Key hint, muted, 11 px.
- 7Echo line. The status bar's latest message; a click opens the log.
- 8Unread errors. A red count beside the echo line while errors have arrived since the log was last opened; a click opens the log.
| Property | Value | Reference |
|---|---|---|
| Kind | A card in the shared in-scene overlay host, anchored just above the status bar’s echo area, over the window | MessageLogPopup.show, OverlayHost |
| Size | 773 px wide; the list 336 px high, scrolling past that | WIDTH, LIST_HEIGHT |
| Card | -color-bg-overlay, radius 12, like the palette | .message-log |
| Rows | Padding 2 4, radius 5; selected row -state-sel | .message-log-list .list-cell |
| Capacity | The newest 200 messages; older ones drop off | MessageLog.MAX_ENTRIES |
| Repeats | A message repeated within 2 s moves to the top as one entry, unread once | REPEAT_MILLIS |
| Lifetime | This session only, in memory. Not written to disk: the Debug Log is the persistent record | MessageLog |
| Blank messages | Not recorded (a blank message only clears the echo line) | MessageLog.add |
Behavior
Section titled “Behavior”- MLOG-02 SHOULD A click on the unread-error count opens the log too, and so does the
view.messageLogcommand.- Check (code): the unread-error count runs
view.messageLogon a click, and the command is registered. - Reference: Editora
StatusBar(echo,unreadErrors),StatusBar.showMessageLog.
- Check (code): the unread-error count runs
- MLOG-03 SHOULD
C-gor a click outside closes the log too, as Esc does.- Check (code): the card’s key handler hides it on
C-g; the overlay’s backdrop hides it on a press. - Reference: Editora
MessageLogPopup,OverlayHost.
- Check (code): the card’s key handler hides it on
- MLOG-04 SHOULD
Ctrl+C(Cmd+Con macOS) copies the selected entries.- Check (code): the card’s key handler copies the selection on the shortcut-down C.
- Reference: Editora
MessageLogPopup.copySelection.
- MLOG-05 SHOULD A message’s severity comes from its key: a
status.*key whose last segment containsfailorerroris an error, one containingcannotorinvalida warning. Name new keys accordingly, or report through the error channel directly.- Check (test): a severity test classifies keys by those rules.
- Reference: Editora
ui/StatusSeverity.java(ofKey),StatusSeverityTest.
- MLOG-06 SHOULD Opening the log, or clearing it, resets the unread-error count.
- Check (code): opening the log marks it read, and
clearzeroes the count. - Reference: Editora
MessageLog.markRead,MessageLog.clear,StatusBar.showMessageLog.
- Check (code): opening the log marks it read, and
- MLOG-07 SHOULD An unread error is never evicted silently: the count keeps it even when the entry drops off
the end.
- Check (test): an error pushed past the capacity still counts as unread.
- Reference: Editora
MessageLogSeverityTest(anEvictedErrorStillCounts).
| Key | English |
|---|---|
messagelog.title | Messages |
messagelog.filter | Filter messages… |
messagelog.empty | No messages yet |
messagelog.copy / messagelog.clear | Copy / Clear |
messagelog.doctor | Open Doctor |
messagelog.hint | Esc to close |
In the apps
Section titled “In the apps”
Pauta 4.5.0 · · Changelog · This page in the latest edition