Public Access
twislaandClaude Opus 5.5
de8af6ed92
The editor held the whole note in memory and stopped at 16 KB. It now keeps a window of the file around the cursor, and the rest on the card as a list of pieces (notes::NoteDocument). Memory with a note open is what it was. Up to 64 KB a save rewrites the file, as before. Above, the five-second save appends what changed to <note>.edit, and the file is rewritten on leaving the note, with a progress bar. After a power cut, opening the note picks the edit up where it was saved; a rewrite cut short is finished or dropped, never half applied. Also: Ctrl with Fn+Up/Down go to the start and end of the note; the consoles' `key` command takes ctrl-, alt- and shift-; the Storage App's `e` no longer refuses a big file. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EhqxQ49eCju4CzKYNjZzwT
56 lines
3.0 KiB
Markdown
56 lines
3.0 KiB
Markdown
+++
|
|
title = "Notes"
|
|
description = "Plain text notes on the SD card, with no save key: the editor saves for you, and a power cut never costs the note."
|
|
weight = 7
|
|
[extra]
|
|
tag = "Notes"
|
|
screens = ["notes.png"]
|
|
+++
|
|
|
|
Notes are plain text files in `/notes` on the SD card. They are ordinary `.txt` files: you can read them on a computer too.
|
|
|
|
## The list
|
|
|
|
Each note shows its first line and its date, newest first. <kbd>s</kbd> switches to sorting by file name.
|
|
|
|
| Key | Does |
|
|
|---|---|
|
|
| <kbd>n</kbd> | Starts a new note |
|
|
| <kbd>Enter</kbd> | Opens the note |
|
|
| <kbd>r</kbd> | Renames its file |
|
|
| <kbd>d</kbd> | Deletes it, after asking |
|
|
|
|
## The editor
|
|
|
|
Type. <kbd>Enter</kbd> starts a line and <kbd>Del</kbd> deletes backwards. <kbd>Fn</kbd> with the arrow keys moves the cursor through the wrapped text, <kbd>Ctrl</kbd>+<kbd>A</kbd> and <kbd>Ctrl</kbd>+<kbd>E</kbd> go to the start and the end of the line, <kbd>Ctrl</kbd> with <kbd>Fn</kbd> and up or down to the start and the end of the note, <kbd>Tab</kbd> types two spaces, and the compose key gives accents as everywhere.
|
|
|
|
**There is no save key.** The note is written five seconds after your last key, when you press Back, when you leave the App, when the screen turns off and before the device powers off. The top line says `typing` or `saved`.
|
|
|
|
Each save writes a temporary file and then puts it in the note's place, so a power cut costs a few seconds of typing and never the note. If a save was cut short, opening the note offers its copy back.
|
|
|
|
## Names
|
|
|
|
A new note has no file until you type something. The file is then named after its first line (`shopping-list.txt`), or `note-<date>-<time>.txt` if that line gives no usable name.
|
|
|
|
## Long notes
|
|
|
|
**A note can be any size.** The editor keeps the part around the cursor in memory and the rest on the card, so a file of a megabyte opens as fast as a short one and uses no more memory.
|
|
|
|
What changes with size is how it is saved:
|
|
|
|
- **Up to 64 KB**, every save rewrites the file, as above.
|
|
- **Above**, the five-second save writes only what you changed, to a file next to the note (`<note>.edit`). The note itself is rewritten **when you leave it**, with a progress bar: about a second for each 450 KB.
|
|
- **After a power cut**, or if the device was switched off with the note open, opening the note again brings your saved changes back, and says so. Until then the file itself still has the old text, if you look at it from a computer.
|
|
|
|
Saving a long note needs room on the card for a second copy of it. If the file was replaced by something else while its changes were waiting, they can't be applied: they are kept as `<note>.edit.lost` and the editor tells you.
|
|
|
|
## Limits
|
|
|
|
In Storage, <kbd>e</kbd> on a text file opens it in the same editor, anywhere on the card, unless the file is read-only. Notes are never offered for deletion by the clean-up.
|
|
|
|
## The keys, as the device lists them
|
|
|
|
What <kbd>Fn</kbd> + <kbd>h</kbd> shows on these screens. These tables are generated from the firmware's own lists, so they are always the current ones.
|
|
|
|
{{ keys(scopes=["notes", "notes-editor", "notes-name"]) }}
|