A misspelled word is flagged where you typed it, in any host, in any sentence. One press replaces it with the correction, and one more press gives back exactly what you wrote.
No popup, no red underline, no dialog to dismiss.
You keep typing. A word that came back misspelled goes grey in place, and stays grey until you do something about it or edit it yourself.
Three words flagged, one line. The grey says there is something here; it does not yet say what. Nothing has changed in your text.
It appears when the cursor reaches the word, and only then.
Move the cursor off the word and the note goes with it. Only the word under the cursor can be changed by a press, so the other two are unaffected.
| You see | It means | |
|---|---|---|
| ✍️ | this word is a mistake. The mark is used for spelling and nothing else, so it never appears on a word that is merely open to improvement | |
| ✍️ | receive | one correction, so no count: the note names it, and the next press gives "receive" |
| was: recieve | after the press, what it was; one more press brings your word back | |
| (underscore to correct) | shown until you press once, then the hint reads revert | |
Which is why there is no undo to learn.
The rotation includes the word you typed, so pressing past the correction returns it character for character. Nothing is remembered, reverted or restored: your word never left the ring.
| Key | Does | When |
|---|---|---|
| _ | next stop | with the cursor on a flagged word. No _ character is typed |
| Ctrl+Alt+↑ | next stop | while the word is selected |
| Ctrl+Alt+↓ | previous stop | the only way back one step, since _ only goes forward |
Away from a flagged word, _ means what it always means: fill in the blank.
A spell checker that flags your own vocabulary is one you switch off.
The shipped instructions name the cases to skip by category, so a line that is already correct comes back empty and nothing goes grey.
| Left alone | Example |
|---|---|
| Proper nouns, place names, brand names | Tokyo |
| Acronyms, assumed intentional | API |
| Numbers, codes, hex | 200 |
| URLs and file paths | /usr/bin |
| Single-letter words | a, I |
| The blank character itself | _ |
Nothing in that line is flagged. Words your other cue files have claimed are left alone too, for a different reason: spelling never sees them.
One ordinary file, seeded at install and yours to edit.
opencues install <host> writes it to ~/.cues/cues/spelling/CUE.md. It is a cue file like any other, and it is switched on from the moment it is written.
| Setting | Value | Meaning |
|---|---|---|
| scope | words | it offers single words, not whole sentences |
| match | .* | every word in the line is a candidate |
| priority | 10 | the lowest of the shipped files, so it goes last |
Those two settings work as a pair. Matching everything is what catches a typo in any sentence, whatever it is about. Going last is what stops it reaching a word another file wants: your project's own vocabulary, a client's name, a term of art. Each word is claimed by exactly one file, and spelling takes only the leftovers.
A word you spell your own way stops being a typo when you give it a cue file, rather than by adding it to a list of exceptions.
The grey and the note are painted over your line, not inserted into it.
What you send is what you typed, up to the presses you made. The mark, the note and the correction cannot be submitted, copied or saved with the text, because they are not in it.
No word changes without a keypress. A line with three flagged words and no presses is the line you wrote.