Commit `d4c76b8503`

d4c76b8503d7069cc3c2404db3cafc46defe1a9a

parent: 9c72646c0e

Verified · cmc

cmc <hello@cleberg.net> · 2026-10-08 04:40 UTC

Update the manual for the review fixes

Describe the current Mac preset keys (Set Tags C-s-g, Set Deadline
C-s-e), View menu shortcuts, Quick Open selection, capture key
sequences, keymap.toml validation, key hints, Doom's gj/gk, za/zo/zc,
H/M/L, C-d/C-u, ZZ/ZQ, gq/gw, M-q, snipe repeat and shared registers
and marks, C-c C-c in tables, formula storing and removal, @0,
attachment and radio links, lowercase IDs, backlinks before the first
heading, :eval no-export, inline calls, tangle extensions,
header-args:LANG, :exports resolution, Markdown export options, the
property macro, Emacs export PATH, config migration in place, theme
files in subfolders, agenda filter and %T, .+Nh repeaters, CLOCK
durations after shifts, TYP_TODO cycling and the iOS changes.

Layout: unified · split

docs/manual/guide/01-files-and-folders.org +4 −4

docs/manual/guide/02-the-editor.org +10 −5

 | Action                         | Emacs and Mac presets | Doom                                                 | Org command          |
 |--------------------------------+-----------------------+------------------------------------------------------+----------------------|
-| Cycle the heading or element at the caret | =TAB=      | =TAB=, =z a=, =z c=, =z o= in normal state; =TAB= in visual state | =org-cycle=          |
+| Cycle the heading or element at the caret | =TAB=      | =TAB= in normal and visual state                     | =org-cycle=          |
 | Cycle the whole file           | =S-TAB=               | =S-TAB=, =z A= in normal state; =S-TAB= in visual state | =org-global-cycle=   |
+| Open or fold the heading       |                       | =z a= in normal state                                | =+org/toggle-fold=   |
+| Open the heading one level     |                       | =z o= in normal state                                | =+org/open-fold=     |
+| Fold the subtree the caret is in |                     | =z c= in normal state                                | =outline-hide-subtree= |
-The palette titles are Cycle Visibility and Cycle Global Visibility; both are also in the Org menu.
+The titles in the palette and the Org menu are Cycle Visibility, Cycle Global Visibility, Toggle Fold, Open Fold and Close Fold.
+Toggle Fold and Open Fold act on a heading line: a folded heading opens one level, showing its body and its child headings, each folded. On an open heading, Toggle Fold folds it and Open Fold does nothing. Close Fold folds the subtree of the heading the caret is under, from anywhere in it.
 =TAB= on a heading line cycles that heading: folded, then its children, then the whole subtree, then folded again. A heading without children goes straight from folded to open. =TAB= on the first or last line of a drawer or block folds or opens it; drawer and block folds are kept apart from heading folds, so cycling a heading leaves them as they are. Elsewhere =TAB= does what it otherwise would: in a table it moves to the next field, and in plain text it inserts a tab.
 The line under the modeline is the echo area, as Emacs's minibuffer. It shows:
 - *Messages* from commands, such as =Stored: …= or =Not an org file=. A message stays for 4 seconds.
-- *A pending key prefix*. After =C-c= it shows =C-c-=. If you pause for about 0.6 seconds, a grid of the keys that can follow appears, each with the command it runs, or =+prefix= for a further prefix, as =which-key= shows them. =C-g= cancels the prefix and shows =Quit=. A sequence that isn't bound shows, for example, =C-c z is undefined=.
+- *A pending key prefix*. After =C-c= it shows =C-c-=. If you pause for about 0.6 seconds, a grid of the keys that can follow appears, each with the command it would run at the caret, or =+prefix= for a further prefix, as =which-key= shows them. =C-g= cancels the prefix and shows =Quit=. A sequence that isn't bound shows, for example, =C-c z is undefined=, and does nothing; in the Doom preset this includes sequences after =SPC=.
 - *Prompts*, when a command asks a question.
 ** Prompts
 Orgstar never corrects spelling on its own; automatic spelling correction, text replacement and smart quotes and dashes are off.
-On iOS, spell checking is always on.
+On iOS, spell checking follows =spell-check= in the synced =config.toml=, and is off by default.
 * Wrapping and filling
 To truncate lines in every file, set =org-startup-truncated = true= in =config.toml=. The default is to wrap, as Doom does; Emacs's own default is to truncate.
-Wrapping is display only. To rewrap the text of a paragraph, use Org ▸ Fill Paragraph (=org-fill-paragraph=), which breaks the paragraph's lines at the fill column: =M-q= in the Emacs preset, =⌃⌘P= in the Mac preset, the Org menu or palette in Doom. The fill column is Settings ▸ Editing ▸ "M-q fills to column N" (80 by default, 40 to 200), or =fill-column= in =config.toml=. Orgstar has no auto-fill: lines are not broken as you type.
+Wrapping is display only. To rewrap the text of a paragraph, use Org ▸ Fill Paragraph (=org-fill-paragraph=), which breaks the paragraph's lines at the fill column: =M-q= in the Emacs preset and in every Doom state, =⌃⌘P= in the Mac preset. In Doom's normal and visual states, =gq= and =gw= with a motion fill the paragraphs in the lines it covers (=gqq= and =gww= for the current lines); =gq= leaves the caret on the last line, =gw= where it was. See [[file:03-keys.org][Keys and commands]]. The fill column is Settings ▸ Editing ▸ "M-q fills to column N" (80 by default, 40 to 200), or =fill-column= in =config.toml=. Orgstar has no auto-fill: lines are not broken as you type.
 * View toggles

docs/manual/guide/03-keys.org +50 −43

 The Mac preset binds fewer commands than the others. It has no keys for links, export, agenda, capture, clocking, narrowing, sorting, properties, footnotes, code blocks or =C-c C-c=. Run those from the Org menu, from the command palette (=⇧⌘P=), from a menu shortcut (Agenda =⇧⌘A=, Capture =⇧⌘N=), or bind them yourself in =keymap.toml=.
-The Mac preset binds Set Tags to =⌃⌘Q=, which is also the macOS Lock Screen shortcut. macOS takes that key first, so give Set Tags another key in =keymap.toml= (for example =C-s-g= for =⌃⌘G=) or run it from the Org menu.
 In the Emacs and Mac presets, and in Doom's insert state, macOS's own text keys keep working where the preset does not bind the key: =⌥←=, =⌘←=, =⇧= with arrows to select, and the Control keys the macOS text system provides (=⌃A=, =⌃E=, =⌃K= and so on). Menu shortcuts such as =⌘S= and =⌘F= work in every preset; see [[*Menu shortcuts][Menu shortcuts]].
 * Option as Meta
 A prefix is a key that starts longer sequences, such as =C-c=, =C-c C-x=, =C-x n= or, in the Doom preset, =SPC= and =SPC m=. After a prefix, Orgstar waits for the next key and shows the keys typed so far in the echo area, followed by a dash: =C-c C-x-=.
-If you pause on a prefix for 0.6 seconds, a panel of key hints opens above the echo area. It lists each key that can follow, sorted by key, with the title of the command it runs, or =+prefix= when it leads to a longer sequence. This is Orgstar's version of =which-key=. The hints follow the current keymap, including your =keymap.toml=, and in the Doom preset the current evil state. A hint shows the highest-priority command for the key, which may not be the one that runs at the caret when the key has several contexts (=C-c C-c= is the common case).
+If you pause on a prefix for 0.6 seconds, a panel of key hints opens above the echo area. It lists each key that can follow, sorted by key, with the title of the command it runs, or =+prefix= when it leads to a longer sequence. This is Orgstar's version of =which-key=. The hints follow the current keymap, including your =keymap.toml=, and in the Doom preset the current evil state. When a key has several contexts (=C-c C-c= is the common case), the hint shows the command that would run at the caret; where none of them applies, it shows the highest-priority one.
-=C-g= during a prefix cancels it; in the Emacs and Mac presets the echo area shows =Quit=. A sequence that nothing binds shows, for example, =C-c z is undefined= in the Emacs and Mac presets.
+=C-g= during a prefix cancels it; in the Emacs and Mac presets the echo area shows =Quit=. A sequence that nothing binds shows, for example, =C-c z is undefined= and does nothing. In the Doom preset this holds for sequences that start with =SPC= or with a Control or Meta key; see [[*How keys are handled][How keys are handled]] for the others.
 A key bound by itself cannot also be a prefix. When a keymap binds both =C-c= and =C-c C-t=, =C-c= always waits for the next key, so the binding for =C-c= alone never runs.
 | Edit | Search Notes | =⇧⌘F= |
 | View | Show Markup | =⇧⌘M= |
 | View | Show Line Numbers | =⇧⌘L= |
-| View | Show or Hide Columns and Clock | =⌥⌘I= or =⌥⌘O= (see below) |
+| View | Show or Hide Outline | =⌥⌘O= |
+| View | Show or Hide Columns and Clock | =⌥⌘I= |
 | Window | Agenda | =⇧⌘A= |
 | Window | Board | =⇧⌘B= |
 | Window | Next Buffer | =⇧⌘]= |
 | Window | Previous Buffer | =⇧⌘[= |
-View ▸ Show or Hide Outline, Show or Hide Backlinks and Show Tab Bar, Window ▸ Switch to Buffer…, and the items of File ▸ Export have no shortcut. The Columns and Clock item declares both =⌥⌘I= and =⌥⌘O=, and only one of them takes effect.
+View ▸ Show or Hide Backlinks and Show Tab Bar, Window ▸ Switch to Buffer…, and the items of File ▸ Export have no shortcut.
 With Settings ▸ Capture ▸ "⌃⌥Space opens Capture from any app" on (the default), =⌃⌥Space= opens the Capture window from any application (see [[file:08-capture.org][Capture]]).
 * Customizing keys: keymap.toml
-Your own bindings go in =keymap.toml= in the configuration folder: =$XDG_CONFIG_HOME/orgstar/keymap.toml= when =XDG_CONFIG_HOME= is set, otherwise =~/.config/orgstar/keymap.toml=. Settings ▸ General shows the path under the Keys picker. The file does not exist until you create it. If you used an earlier version that kept it in =~/Library/Application Support/Orgstar/=, that copy is read until one exists in the configuration folder; changes to it are not picked up automatically, so run Reload Keymap after editing it.
+Your own bindings go in =keymap.toml= in the configuration folder: =$XDG_CONFIG_HOME/orgstar/keymap.toml= when =XDG_CONFIG_HOME= is set, otherwise =~/.config/orgstar/keymap.toml=. Settings ▸ General shows the path under the Keys picker. The file does not exist until you create it. If you used an earlier version that kept it in =~/Library/Application Support/Orgstar/=, that copy is read, and reloaded when you save it, until one exists in the configuration folder.
 The bindings in the file are layered on top of the chosen preset. They apply to whichever preset is chosen, so a file written for the Emacs preset does nothing useful under Doom unless its bindings name a =mode=.
 | =when= | no | A context from the table in [[*Contexts][Contexts]]. Without it the binding holds everywhere. |
 | =mode= | no | An evil state for the Doom preset: ="normal"=, ="insert"= or ="visual"=. |
-The [[*Key reference][key reference]] gives each command's id after its title. Commands no preset binds are listed under [[*Unbound commands][Unbound commands]]. A typo in a command id is not caught when the file loads; pressing the key shows =Unknown command= and the id.
+The [[*Key reference][key reference]] gives each command's id after its title. Commands no preset binds are listed under [[*Unbound commands][Unbound commands]]. A binding whose command id Orgstar does not know is skipped and reported when the file loads (see [[*Reloading and errors][Reloading and errors]]).
 Orgstar reads a subset of TOML: =[[bind]]= headers, =key = value= lines, basic ="..."= and literal ='...'= strings, =true= and =false=, integers, and =#= comments. Arrays, inline tables and multi-line strings are not supported.
 mode = "insert"
 #+END_SRC
-=mode= is not checked when the file loads. Any value other than =normal=, =insert= or =visual= (including =visual-line=) makes a binding that never runs.
+A =mode= other than =normal=, =insert= or =visual= (including =visual-line=) is reported when the file loads, and the binding is skipped.
 ** More examples
 #+BEGIN_SRC toml
-# Mac preset: ⌃⌘L inserts a link, ⌃⌘E opens the export sheet, ⌃⌘X runs C-c C-c.
+# Mac preset: ⌃⌘L inserts a link, ⌃⌘O opens the export sheet, ⌃⌘X runs C-c C-c.
 [[bind]]
 keys = "C-s-l"
 command = "org.link.insert"
 [[bind]]
-keys = "C-s-e"
+keys = "C-s-o"
 command = "app.export-dialog"
 [[bind]]
 keys = "C-s-x"
 Orgstar watches the configuration folder and reloads =keymap.toml= when you save it. It also reloads when you change the preset, and when you run Reload Keymap (=app.reload-keymap=, in the palette, and =SPC h r r= in Doom normal state), which shows =Keymap reloaded=.
-Problems are reported in the echo area with the line number, for example =keymap.toml: line 12: unknown context tabel (and 1 more)=. A binding with bad or missing =keys=, a missing =command=, an unknown =when=, or a table other than =[[bind]]= is skipped; the rest of the file still applies. A file that is not valid TOML is ignored as a whole and the error is shown; the preset alone applies until you fix it.
+Problems are reported in the echo area with the line number, for example =keymap.toml: line 12: unknown context tabel (and 1 more)=. A binding with bad or missing =keys=, a missing =command=, a command id Orgstar does not know, an unknown =when= or =mode=, or a table other than =[[bind]]= is skipped; the rest of the file still applies. A file that is not valid TOML is ignored as a whole and the error is shown; the preset alone applies until you fix it.
 ** Importing from Emacs
-Settings ▸ General ▸ Import from Emacs… reads your Emacs or Doom configuration and offers, among other things, the key bindings it finds: =global-set-key=, =keymap-global-set=, =define-key=, =keymap-set=, =evil-define-key= and Doom's =map!= with =:leader=, =:localleader=, state keywords and =:prefix=. Bindings to commands Orgstar has are appended to =keymap.toml= under a =# Imported from Emacs.= comment. See [[file:15-alongside-emacs.org][Alongside Emacs]].
+Settings ▸ General ▸ Import from Emacs… reads your Emacs or Doom configuration and offers, among other things, the key bindings it finds: =global-set-key=, =keymap-global-set=, =define-key=, =keymap-set=, =evil-define-key= and Doom's =map!= with =:leader=, =:localleader=, state keywords and =:prefix=. Bindings to commands Orgstar has are appended to =keymap.toml= under a =# Imported from Emacs.= comment, leaving out bindings the file already has. Keys written as vectors, such as =[f5]=, are skipped. See [[file:15-alongside-emacs.org][Alongside Emacs]].
 * Vim editing (Doom preset)
 Two consequences:
-- Keymap commands do not take counts or registers. Once you type a count or a register, the following keys go straight to Vim, so =3gj= moves three screen lines even in an Org file, where =gj= alone moves by headings.
+- Keymap commands do not take counts or registers. Once you type a count or a register, the following keys go straight to Vim.
-- A sequence the keymap does not complete is replayed into Vim. =SPC= followed by a key the leader does not bind runs Vim's =SPC= (move right) and then that key, instead of reporting the sequence as undefined.
+- A sequence the keymap does not complete after =SPC=, =C-c=, =C-x= or another Control or Meta prefix is undefined: the echo area shows, for example, =SPC j is undefined=, and nothing runs. After =g=, =z=, =[= or =]=, which are Vim prefixes too, the keys are replayed into Vim, so =gu= and =gq= reach the Vim engine although the keymap binds other =g= keys.
 ** States
 |-+-|
 | =h=, =l=, =<left>=, =<right>=, =DEL= | Left, right; =DEL= is =h=. Stays on the line. |
 | =j=, =k=, =<down>=, =<up>= | Down, up, keeping the column. |
-| =gj=, =gk= | Down, up by screen lines in wrapped text. In Org files the keymap takes =g j= and =g k= first; see below. |
+| =gj=, =gk= | In Org files, to the next or previous Org element (=org-forward-element=, =org-backward-element=, as evil-org binds them); counts are ignored. On a heading, =gj= goes to the next heading after the subtree and =gk= to the previous heading at the same level or higher. In other files, down and up by screen lines in wrapped text. |
 | =+=, =-=, =RET= | First non-blank of the next or previous line. In Org files =RET= runs Act at Point instead. |
 | =w=, =b=, =e=, =ge= | Next word start, previous word start, word end, previous word end. |
 | =W=, =B=, =E=, =gE= | The same for blank-separated WORDs. |
 | =g_= | Last non-blank of the line. |
 | =gg=, =G= | First line, last line; with a count, that line. The column is kept (=evil-start-of-line= nil). |
 | =f= /x/, =F= /x/, =t= /x/, =T= /x/ | To, or to just before, the next or previous /x/ on the line. |
-| =;=, =,= | Repeats the last =f=, =F=, =t= or =T=, forward or reversed. |
+| =;=, =,= | Repeats the last =f=, =F=, =t=, =T=, =s= or =S=, forward or reversed. A snipe repeated this way searches all the text the window shows, not only the caret's line (=evil-snipe-repeat-scope=, as Doom sets it). |
 | =s= /xy/, =S= /xy/ | evil-snipe: to the next or previous /xy/ on the line. All-lowercase /xy/ matches case-insensitively. Not available after an operator. |
 | =%= | The bracket matching the next =()=, =[]= or ={}= on the line. |
 | ={=, =}= | Previous, next blank line. |
 | =/=, =?= | Asks in the echo area for a regular expression and searches forward or backward, wrapping around the file. |
 | =n=, =N= | Repeats the last search in the same or the opposite direction. |
 | =*=, =#= | Searches forward or backward for the whole word under the caret. |
-| =C-d=, =C-u= | Down, up 15 lines; with a count, that many lines. |
+| =C-d=, =C-u= | Down, up half the window's height; with a count, that many lines. |
+| =H=, =M=, =L= | First non-blank of the top, middle or bottom line the window shows. With a count, =H= goes to that line from the top and =L= from the bottom. Lines are text lines, not wrapped screen lines. Linewise after an operator. |
 | ='= /a/, =`= /a/ | To mark /a/: its line's first non-blank, or its exact position. See [[*Marks and jumps][Marks and jumps]]. |
 Search patterns are ICU regular expressions as macOS uses them, close to PCRE; Emacs and Vim regexp syntax such as =\(...\)= or =\<= does not work. =:noh= is accepted and does nothing; searches are not highlighted.
-=H=, =M= and =L= are not implemented.
 ** Operators
 | Keys | Does |
 | =>= /motion/, =<= /motion/ | Indents or outdents lines by 8 spaces (=evil-shift-width=, which Doom sets to Org's =tab-width=). =>>= and =<<= act on lines. |
 | =g~= /motion/, =gu= /motion/, =gU= /motion/ | Toggles case, lowercases, uppercases. =g~~=, =guu=, =gUU= act on lines. |
 | =gc= /motion/ | Comments or uncomments lines with =#= (=evilnc-comment-operator=). =gcc= acts on lines. See [[*Commenting][Commenting]]. |
+| =gq= /motion/, =gw= /motion/ | Fills the paragraphs in the motion's lines to the fill column, as Fill Paragraph does; other elements in the lines are left alone. =gq= leaves the caret on the first non-blank of the last line, =gw= where it was. =gqq= and =gww= act on lines. |
+=M-q= runs Fill Paragraph in normal, insert and visual state.
 Counts multiply: =2d3w= deletes six words. Doubling an operator with a count acts on that many lines: =3dd=.
 | =r= /x/ | Replaces the character under the caret (count: that many) with /x/; =r RET= splits the line. |
 | =u=, =C-r= | Undo, redo, with counts. |
 | =.= | Repeats the last change. |
-| =ZZ= | Saves the file. It does not close anything. |
+| =ZZ= | Saves the file and closes the window, as =:wq=. |
-| =ZQ= | Not available; shows a message. |
+| =ZQ= | Closes the window, as =:q!=. |
 =o= and =O= open a line below or above with Org's indentation: under a list item, aligned with the item's text; under a heading, none; otherwise the line's own indentation.
 Pasting from the clipboard is linewise when its text is what the last linewise yank or delete put there; text copied in another app pastes as characters. Numbered registers ="1= to ="9=, and the read-only registers such as ="%=, are not available.
-Named registers, the yank register, marks, macros and the jump list belong to the buffer: each open file has its own set, and they are gone when the buffer closes or Orgstar quits. Only the clipboard is shared.
+Registers and macros are shared by every buffer, as in evil: a yank into ="a= in one file pastes with ="ap= in another. Lowercase marks and the jump list belong to the buffer and are gone when it closes. Nothing is kept when Orgstar quits.
 ** Repeat
 =m= /a/ sets mark /a/ (any letter) at the caret. Marks move with the text as you edit. ='= /a/ goes to the first non-blank of the mark's line, =`= /a/ to its exact position. =''= and =``= go back to where the last jump started.
-Jumps are =G=, =gg=, =%=, ={=, =}=, =n=, =N=, =*=, =#=, ='=, =`=, and searches with =/= and =?=. Each jump adds its starting point to the jump list, which keeps the last 100. =C-o= goes back through the list and =C-i= forward again. A new jump after =C-o= drops the places you went back past.
+Jumps are =G=, =gg=, =%=, ={=, =}=, =n=, =N=, =*=, =#=, ='=, =`=, =H=, =M=, =L=, and searches with =/= and =?=. Each jump adds its starting point to the jump list, which keeps the last 100. =C-o= goes back through the list and =C-i= forward again. A new jump after =C-o= drops the places you went back past.
-Uppercase marks are per buffer like lowercase ones; there are no file marks.
+Lowercase marks belong to the buffer, and so do =C-o= and =C-i=. Uppercase marks (=mA= to =mZ=) are file marks, shared by every buffer: ='A= or =`A= in another buffer shows the buffer the mark was set in, at the mark. A file mark goes away when its buffer closes.
 ** Visual states
 | =>=, =<= | Indents or outdents its lines. |
 | =~=, =u=, =U=, =g~=, =gu=, =gU= | Toggles case, lowercases, uppercases. |
 | =gc= | Comments or uncomments its lines. |
+| =gq=, =gw= | Fills the paragraphs in its lines. |
 | =J= | Joins its lines. |
 | =p=, =P= | Replaces it with the clipboard or a register; the replaced text goes to the clipboard. |
 | =S= /x/ | Surrounds it with /x/ (see below). Linewise selections get the delimiters on lines of their own. |
 ** Org keys in normal state
-Besides the leader, the preset binds these evil-org and Doom keys in normal state. =TAB=, =S-TAB= and =RET= in normal state, and the Emacs preset's Org keys in every state, are listed in the [[*Key reference][key reference]].
+Besides the leader, the preset binds these evil-org and Doom keys in normal state. =TAB=, =S-TAB= and =RET= in normal state, and the Emacs preset's Org keys in every state, are listed in the [[*Key reference][key reference]]. =gj= and =gk= move by Org element; see [[*Motions][Motions]].
 | Keys | Command |
 |-+-|
 | =TAB= | Cycle Visibility (=org-cycle=). Also in visual state. |
 | =S-TAB= | Cycle Global Visibility. Also in visual and insert state. |
 | =RET= | Act at Point (=+org/dwim-at-point=). |
-| =z a=, =z c=, =z o= | Cycle Visibility. All three cycle; there is no separate open and close. |
+| =z a= | Toggle Fold (=+org/toggle-fold=). On a heading line: a folded heading opens one level, showing its body and its child headings folded; an open one folds. |
+| =z o= | Open Fold (=+org/open-fold=). On a heading line, a folded heading opens one level; an open one stays as it is. |
+| =z c= | Close Fold (=outline-hide-subtree=). Folds the subtree the caret is in, from anywhere inside it. |
 | =z A= | Cycle Global Visibility. |
 | =g h= | Up to Parent Heading. |
-| =g j=, =g k= | Next or previous heading at the same level. evil-org moves by element here; Orgstar moves by heading only. In files that are not Org files these keys fall through to Vim's screen-line motions. |
 | =] h=, =[ h= | Next or previous heading at the same level. |
 | =] b=, =[ b= | Next or previous buffer. |
 | =M-h=, =M-j=, =M-k=, =M-l= | =M-<left>=, =M-<down>=, =M-<up>=, =M-<right>=: promote, move down, move up, demote on headings; the same for items; move columns and rows in tables. Also in insert and visual state. |
 ** Not available
-Things evil users may reach for that Orgstar does not have: =H=, =M=, =L=, =zz=, =zt= and the other scroll and fold =z= commands except =za=, =zc=, =zo= and =zA=; =C-a= and =C-x= to increment numbers; =gi=, =g;=, =gJ=; replace state (=R=); =&=; =q:=; the numbered and read-only registers; repeating evil-snipe with =;= or =,=; tag and sentence text objects. =C-d= and =C-u= move a fixed 15 lines rather than half the window.
+Things evil users may reach for that Orgstar does not have: =zz=, =zt= and the other scroll and fold =z= commands except =za=, =zc=, =zo= and =zA=; =C-a= and =C-x= to increment numbers; =gi=, =g;=, =gJ=; replace state (=R=); =&=; =q:=; the numbered and read-only registers; tag and sentence text objects.
 * Keys in other windows
 - Option acts as Meta when the key starts a binding (=M-RET=, =M-<left>=); otherwise Option types characters as usual.
 - Keys with =⌘= are left to iOS.
 - Movement and editing keys bound to =edit.= commands (=C-a=, =C-e=, =C-k= and so on) are left to the iOS text system, except undo.
-- Of the =app.= commands only clock in, clock out, cancel clock and go to clocked entry run from keys. Other =app.= keys, and editor commands such as narrowing, do nothing.
+- Of the =app.= commands only clock in, clock out, cancel clock and go to clocked entry run from keys. Other =app.= keys, and editor commands such as narrowing, show =Not available on iOS yet=.
+- A sequence of two or more keys whose command cannot run at the caret runs it anyway and shows its message, as on the Mac (for example =Not on a heading=).
 - A pending prefix shows as a message, without key hints.
 The on-screen key bar's buttons run what their Emacs keys run at the caret (Fold is =TAB=, Promote is =M-<left>=, TODO is =C-c C-t=). See [[file:14-ios.org][iOS]].
 - *Emacs* lists the Emacs preset's keys.
 - *Mac* lists the Mac preset's keys, with macOS symbols. =⇥= is Tab and =↩= Return.
-- *Doom* lists the keys the Doom preset adds. Every Emacs-preset key that starts with =C-c= or =C-x=, the =M-= and =S-= arrow keys, =M-RET=, =M-S-RET=, =C-RET= and =M-x= also work in the Doom preset, in normal, insert and visual states, so they are not repeated in the Doom column. Doom keys marked (N), (I) or (V) work only in normal, insert or visual state; unmarked ones work in all three.
+- *Doom* lists the keys the Doom preset adds. Every Emacs-preset key that starts with =C-c= or =C-x=, the =M-= and =S-= arrow keys, =M-RET=, =M-S-RET=, =C-RET=, =M-x= and =M-q= also work in the Doom preset, in normal, insert and visual states, so they are not repeated in the Doom column. Doom keys marked (N), (I) or (V) work only in normal, insert or visual state; unmarked ones work in all three.
 When a key appears in several rows, it runs the command whose condition holds at the caret: for example =M-<right>= demotes a heading, indents a list item and moves a table column. The descriptions say where each one applies. Movement and text editing in the Doom preset are the Vim keys above, so the Doom column is empty for those rows.
 | Find Previous (=edit.find-previous=) | — | — | — | Goes to the previous match. |
 | Use Selection for Find (=edit.use-selection-for-find=) | — | — | — | Puts the selection in the find bar. |
 | Complete at Point (=editor.complete=) | =C-M-i= | — | =C-SPC= (I), =C-@= (I) | Completes what is typed at the caret: =#+= keywords and their values, link types, entities, tags, TODO keywords, headings, drawers, properties, src languages and header arguments, and =<s=-style templates (=completion-at-point=). One candidate is inserted; several open a list. |
-| Fill Paragraph (=org.fill-paragraph=) | =M-q= | =⌃⌘P= | — | Refills the paragraph or list item to the fill column (=org-fill-paragraph=). |
+| Fill Paragraph (=org.fill-paragraph=) | =M-q= | =⌃⌘P= | — | Refills the paragraph or list item to the fill column (=org-fill-paragraph=). In the Doom preset, =gq= and =gw= fill the lines a motion covers; see [[*Operators][Operators]]. |
 ** Outline: visibility and narrowing
 | Command | Emacs | Mac | Doom | What it does |
 |-+-+-+-+-|
-| Cycle Visibility (=org.cycle=) | =TAB= | =⇥= | =TAB= (N, V), =z a= (N), =z c= (N), =z o= (N) | On a heading, cycles its subtree through folded, children and everything; on the first or last line of a drawer or block, folds or unfolds it (=org-cycle=). Elsewhere, =TAB= types a tab in the Emacs and Mac presets. |
+| Cycle Visibility (=org.cycle=) | =TAB= | =⇥= | =TAB= (N, V) | On a heading, cycles its subtree through folded, children and everything; on the first or last line of a drawer or block, folds or unfolds it (=org-cycle=). Elsewhere, =TAB= types a tab in the Emacs and Mac presets. |
+| Toggle Fold (=org.fold.toggle=) | — | — | =z a= (N) | On a heading line, opens a folded heading one level or folds an open one (=+org/toggle-fold=). |
+| Open Fold (=org.fold.open=) | — | — | =z o= (N) | On a heading line, opens a folded heading one level (=+org/open-fold=). |
+| Close Fold (=org.fold.close=) | — | — | =z c= (N) | Folds the subtree the caret is in (=outline-hide-subtree=). |
 | Cycle Global Visibility (=org.cycle-global=) | =S-TAB= | =⇧⇥= | =S-TAB=, =z A= (N) | Cycles the whole file through overview, contents and everything (=org-global-cycle=). |
 | Narrow to Subtree (=org.narrow.subtree=) | =C-x n s= | — | =SPC m s n= (N) | Shows only the current subtree (=org-narrow-to-subtree=). |
 | Narrow to Block (=org.narrow.block=) | =C-x n b= | — | — | Shows only the current block (=org-narrow-to-block=). |
 |-+-+-+-+-|
 | Next Heading (=org.heading.next=) | =C-c C-n= | =⌥⌘↓= | — | Moves to the next heading (=org-next-visible-heading=). |
 | Previous Heading (=org.heading.previous=) | =C-c C-p= | =⌥⌘↑= | — | Moves to the previous heading (=org-previous-visible-heading=). |
-| Next Heading at Same Level (=org.heading.forward-same-level=) | =C-c C-f= | — | =g j= (N), =] h= (N) | Moves to the next heading at the same level (=org-forward-heading-same-level=). |
+| Next Heading at Same Level (=org.heading.forward-same-level=) | =C-c C-f= | — | =] h= (N) | Moves to the next heading at the same level (=org-forward-heading-same-level=). |
-| Previous Heading at Same Level (=org.heading.backward-same-level=) | =C-c C-b= | — | =g k= (N), =[ h= (N) | Moves to the previous heading at the same level (=org-backward-heading-same-level=). |
+| Previous Heading at Same Level (=org.heading.backward-same-level=) | =C-c C-b= | — | =[ h= (N) | Moves to the previous heading at the same level (=org-backward-heading-same-level=). |
 | Up to Parent Heading (=org.heading.up=) | =C-c C-u= | — | =g h= (N) | Moves to the parent heading (=outline-up-heading=). |
 | Go to Heading… (=org.goto=) | =C-c C-j= | — | =SPC m .= (N) | Asks for a heading of this file by its outline path and jumps to it (=org-goto=). |
 | Insert Heading (=org.heading.insert=) | =M-RET= | =⌘↩= | — | Inserts a heading at the current level; on a list item, see Insert Item (=org-meta-return=, =org-insert-heading=). |
 | Set Priority B (=org.priority.set-b=) | — | — | — | Sets priority B. Bound only as a speed key. |
 | Set Priority C (=org.priority.set-c=) | — | — | — | Sets priority C. Bound only as a speed key. |
 | Remove Priority (=org.priority.remove=) | — | — | — | Removes the priority. Bound only as a speed key. |
-| Set Tags (=org.tags.set=) | =C-c C-q= | =⌃⌘Q= | =SPC m q= (N) | Sets the heading's tags, with fast selection when =#+TAGS= has keys (=org-set-tags-command=). |
+| Set Tags (=org.tags.set=) | =C-c C-q= | =⌃⌘G= | =SPC m q= (N) | Sets the heading's tags, with fast selection when =#+TAGS= has keys (=org-set-tags-command=). |
 ** Properties and column view
 | Insert Timestamp (=org.timestamp.active=) | =C-c .= | =⌃⌘.= | =SPC m d t= (N) | Asks for a date and inserts an active timestamp, or changes the one at point (=org-timestamp=). |
 | Insert Inactive Timestamp (=org.timestamp.inactive=) | =C-c != | =⌃⌥⌘.= | =SPC m d T= (N) | Same, inactive (=org-timestamp-inactive=). |
 | Schedule (=org.schedule=) | =C-c C-s= | =⌃⌘S= | =SPC m d s= (N) | Asks for a date and sets =SCHEDULED= (=org-schedule=). |
-| Set Deadline (=org.deadline=) | =C-c C-d= | =⌃⌘D= | =SPC m d d= (N) | Asks for a date and sets =DEADLINE= (=org-deadline=). |
+| Set Deadline (=org.deadline=) | =C-c C-d= | =⌃⌘E= | =SPC m d d= (N) | Asks for a date and sets =DEADLINE= (=org-deadline=). |
 | Increase Timestamp Part (=org.timestamp.up=) | =S-<up>= | =⌃⌘↑= | =C-S-k= (N, I) | On a timestamp, increases the part under the caret: year, month, day, hour or minute (=org-timestamp-up=). |
 | Decrease Timestamp Part (=org.timestamp.down=) | =S-<down>= | =⌃⌘↓= | =C-S-j= (N, I) | On a timestamp, decreases the part under the caret (=org-timestamp-down=). |
 | Timestamp One Day Later (=org.timestamp.day-later=) | =S-<right>= | =⌃⌘→= | =C-S-l= (N, I) | On a timestamp, moves it one day later (=org-timestamp-up-day=). |
 | Next Table Field (=org.table.next-field=) | =TAB= | =⇥= | =TAB= (I) | In a table, aligns it and moves to the next field, adding a row at the end (=org-table-next-field=). |
 | Previous Table Field (=org.table.previous-field=) | =S-TAB= | =⇧⇥= | =S-TAB= (I) | In a table, moves to the previous field (=org-table-previous-field=). |
 | Next Table Row (=org.table.next-row=) | =RET= | =↩= | =RET= (I) | In a table, moves to the same field in the next row, adding a row at the end (=org-table-next-row=). |
-| Align Table (=org.table.align=) | =C-c C-c= | — | =SPC m b a= (N) | In a table, aligns it (=org-table-align=). |
+| Align Table (=org.table.align=) | — | — | =SPC m b a= (N) | In a table, aligns it (=org-table-align=). =C-c C-c= in a table also aligns it; see Act at Point. |
 | Move Table Row Up (=org.table.row-up=) | =M-<up>= | =⌃⌘↑= | =M-k= | In a table, moves the row up (=org-table-move-row-up=). |
 | Move Table Row Down (=org.table.row-down=) | =M-<down>= | =⌃⌘↓= | =M-j= | In a table, moves the row down (=org-table-move-row-down=). |
 | Move Table Column Left (=org.table.column-left=) | =M-<left>= | =⌃⌘←= | =M-h=, =C-d= (I) | In a table, moves the column left (=org-table-move-column-left=). |
 | Command | Emacs | Mac | Doom | What it does |
 |-+-+-+-+-|
-| Act at Point (C-c C-c) (=org.ctrl-c-ctrl-c=) | =C-c C-c= | — | — | Does what fits the context: sets tags on a heading, toggles an item's checkbox, follows a footnote, offers the property menu in a property drawer, updates a clock line, statistics cookie or timestamp, and refreshes the setup on a =#+= keyword line (=org-ctrl-c-ctrl-c=). After a sparse tree, the first =C-c C-c= only clears the highlights. More specific bindings take =C-c C-c= in tables, src blocks, =#+TBLFM= lines and dynamic blocks. |
+| Act at Point (C-c C-c) (=org.ctrl-c-ctrl-c=) | =C-c C-c= | — | — | Does what fits the context: sets tags on a heading, toggles an item's checkbox, follows a footnote, offers the property menu in a property drawer, updates a clock line, statistics cookie or timestamp, runs a =#+CALL:= line, inline =call_= or inline =src_= block, and refreshes the setup on a =#+= keyword line (=org-ctrl-c-ctrl-c=). In a table it evaluates a formula typed in the field (starting with ~=~ or ~:=~), then recalculates the row when it is marked =#= and otherwise aligns the table; at the table's first character it recalculates the whole table. After a sparse tree, the first =C-c C-c= only clears the highlights. More specific bindings take =C-c C-c= in src blocks, =#+TBLFM= lines and dynamic blocks. |
 | Act at Point (=org.dwim=) | — | — | =RET= (N) | Doom's =+org/dwim-at-point=: follows a link, runs a src block, recalculates or aligns a table, toggles a checkbox, or switches a heading between TODO and done. |
 | Run Source Block (=org.babel.execute=) | =C-c C-c= | — | — | In a src block, runs it and inserts the results (=org-babel-execute-src-block=). |
 | Tangle File (=org.babel.tangle=) | =C-c C-v t=, =C-c C-v C-t= | — | — | Writes the file's src blocks to their tangle targets (=org-babel-tangle=). |
 | Command | Emacs | Mac | Doom | What it does |
 |-+-+-+-+-|
-| Export… (=app.export-dialog=) | =C-c C-e= | — | — | Opens the export sheet (=org-export-dispatch=). |
 | Export to HTML (=app.export.html=) | =C-c C-e h h= | — | =SPC m e h h= (N) | Exports to HTML (=org-html-export-to-html=). |
 | Export to HTML and Open (=app.export.html-open=) | =C-c C-e h o= | — | =SPC m e h o= (N) | Exports to HTML and opens the result. |
 | Export to Markdown (=app.export.markdown=) | =C-c C-e m m= | — | =SPC m e m m= (N) | Exports to Markdown (=org-md-export-to-markdown=). |
 | Board (=app.board=) | Opens the Board window. Window ▸ Board, =⇧⌘B=. |
 | Cancel Running Block (=app.babel.cancel=) | Stops the src block that is running. Edit ▸ Cancel Running Block, =⌘.=. |
 | Edit Config File (=app.edit-config=) | Opens =config.toml= in the editor. =⌥⌘,=. |
+| Export… (=app.export-dialog=) | Opens the export sheet. In the Emacs and Doom presets =C-c C-e= is a prefix for the export keys only; pausing after it lists them in the key hints. |
 | Import from Emacs… (=app.import-emacs=) | Opens Import from Emacs…. |
 | Revert to File on Disk (=app.revert=) | Replaces the buffer with the file on disk; unsaved changes go to recovery (=revert-buffer=). |
 | Recovery Versions… (=app.recovery=) | Shows the recovery versions of the file. |
 | Resolve Sync Conflicts… (=app.sync-conflicts=) | Shows the file's sync conflict copies to resolve them. |
 | Import Table from File… (=app.table-import=) | Asks for a CSV, TSV or space-separated file and inserts it as a table (=org-table-import=). |
 | Export Table to File… (=app.table-export=) | Writes the table at point to a CSV or TSV file (=org-table-export=). |
-| Show or Hide Outline (=app.toggle-outline=) | Shows or hides the outline pane. View ▸ Show or Hide Outline. |
+| Show or Hide Outline (=app.toggle-outline=) | Shows or hides the outline pane. View ▸ Show or Hide Outline, =⌥⌘O=. |
 | Show or Hide Backlinks (=app.toggle-backlinks=) | Shows or hides the backlinks pane. View ▸ Show or Hide Backlinks. |
-| Show or Hide Columns and Clock (=app.toggle-inspector=) | Shows or hides the columns and clock inspector. |
+| Show or Hide Columns and Clock (=app.toggle-inspector=) | Shows or hides the columns and clock inspector. View ▸ Show or Hide Columns and Clock, =⌥⌘I=. |
 | Show or Hide Markup (=app.toggle-markup=) | Shows or hides link brackets and emphasis markers. View ▸ Show Markup, =⇧⌘M=. |
 | Show or Hide Line Numbers (=app.toggle-line-numbers=) | Shows or hides line numbers. View ▸ Show Line Numbers, =⇧⌘L=. |
 | Show or Hide Tab Bar (=app.toggle-tab-bar=) | Shows or hides the tab bar. View ▸ Show Tab Bar. |
 | Column View of File (=org.columns.global=) | Shows the column view of the whole file (=org-columns= with =C-u=). |
 | Remove Schedule (=org.schedule.remove=) | Removes =SCHEDULED= (=org-schedule= with =C-u=). |
 | Remove Deadline (=org.deadline.remove=) | Removes =DEADLINE= (=org-deadline= with =C-u=). |
-| Create ID (=org.id.create=) | Gives the entry an =ID= property unless it has one (=org-id-get-create=). |
+| Create ID (=org.id.create=) | Gives the entry an =ID= property, a lowercase UUID, unless it has one (=org-id-get-create=). |
 | Delete Property… (=org.property.delete=) | Asks for a property of the entry and deletes it (=org-delete-property=). |
 | Delete Property Everywhere… (=org.property.delete-globally=) | Asks for a property and deletes it from every entry in the file (=org-delete-property-globally=). |
 | Property Action… (=org.property.action=) | Offers set, delete and delete globally for the property at point (=org-property-action=). =C-c C-c= in a property drawer runs it. |

docs/manual/guide/04-outlines.org +9 −4

 |--------------------------------+-----------------------------------+-----------+--------+-------------------|
 | Next Heading                   | =org-next-visible-heading=        | =C-c C-n= | =⌥⌘↓=  | =C-c C-n=         |
 | Previous Heading               | =org-previous-visible-heading=    | =C-c C-p= | =⌥⌘↑=  | =C-c C-p=         |
-| Next Heading at Same Level     | =org-forward-heading-same-level=  | =C-c C-f= | menu   | =g j=, =] h=      |
+| Next Heading at Same Level     | =org-forward-heading-same-level=  | =C-c C-f= | menu   | =] h=             |
-| Previous Heading at Same Level | =org-backward-heading-same-level= | =C-c C-b= | menu   | =g k=, =[ h=      |
+| Previous Heading at Same Level | =org-backward-heading-same-level= | =C-c C-b= | menu   | =[ h=             |
 | Up to Parent Heading           | =outline-up-heading=              | =C-c C-u= | menu   | =g h=             |
 | Go to Heading…                 | =org-goto=                        | =C-c C-j= | menu   | =SPC m .=         |
 Next and Previous Heading skip headings that are folded out of sight. The same-level
-commands stop at the parent's boundary. Go to Heading asks for a heading by its outline
+commands stop at the parent's boundary. In Doom's normal state, =gj= and =gk= move by
+Org element, as evil-org's =org-forward-element= and =org-backward-element=: on a
+heading line, to the next heading after its subtree, or to the previous heading at the
+same level or higher (see [[file:03-keys.org][Keys and commands]]). Go to Heading asks for a heading by its outline
 path (=Project/Meetings/Kickoff=) with completion, as =org-goto= does with
 =outline-path-completion=.
   number and creates its definition.
 - Where a footnote can't go, it shows the footnote menu.
-=C-c C-c= on a reference or a definition's label does the same jumps.
+=C-c C-c= on a reference or a definition's label does the same jumps. After a jump to a
+definition, the echo area says how to get back:
+=Edit definition and go back with `C-c C-c' or `C-c C-x f' on its label.=
 New definitions go in a level 1 heading named =Footnotes= at the end of the file, which
 is created when needed (Org's =org-footnote-section=):

docs/manual/guide/05-todos-and-tags.org +3 −3

docs/manual/guide/06-dates-and-clocking.org +6 −4

 Every command that asks for a date shows the same prompt (=org-read-date=): a text field, the date the text reads as, and a month calendar.
-- Type a date in any of the forms below. The line above the field shows the result, such as =<2026-10-09 Fri 15:00>=, as you type.
+- Type a date in any of the forms below. The line above the field shows the result, such as =<2026-10-09 Fri 15:00>=, as you type; for an inactive timestamp it is in square brackets, =[2026-10-09 Fri 15:00]=.
 - Click a day in the calendar to answer with that day. A time you typed is kept.
 - =S-<left>= and =S-<right>= in the field move the answer one day; =S-<up>= and =S-<down>= move it one week.
 - =RET= accepts. An empty answer takes the default: the date of the timestamp being changed, or today.
 | Command          | Org command      | Emacs, Doom | Mac  | Doom leader |
 |------------------+------------------+-------------+------+-------------|
 | Schedule         | =org-schedule=   | =C-c C-s=   | ⌃⌘S  | =SPC m d s= |
-| Set Deadline     | =org-deadline=   | =C-c C-d=   | ⌃⌘D  | =SPC m d d= |
+| Set Deadline     | =org-deadline=   | =C-c C-d=   | ⌃⌘E  | =SPC m d d= |
 | Remove Schedule  | =C-u C-c C-s=    |             |      |             |
 | Remove Deadline  | =C-u C-c C-d=    |             |      |             |
 5. Every active timestamp with a repeater in the entry moves forward:
    - =+N= moves it by N once, which may leave it in the past.
    - =++N= moves it by N until it is after today (for hours, after now).
-   - =.+N= sets it to today and then moves it by N.
+   - =.+N= sets it to today and then moves it by N. With hours, =.+Nh=, the new time is N hours after the current time, to the minute, and a time range loses its end time.
 6. =--= delays in those timestamps are removed.
 #+BEGIN_SRC org
 ** Editing clock lines
-You can edit clock lines by hand. =S-<up>= and =S-<down>= change their timestamps as anywhere else, but do not update the duration after ~=>~. Press =C-c C-c= (or =C-c C-y=) on the line afterwards: Orgstar fixes both day names and writes the duration again (=org-clock-update-time-maybe=).
+You can edit clock lines by hand. =S-<up>=, =S-<down>=, =S-<left>= and =S-<right>= change their timestamps as anywhere else, and then write the duration after ~=>~ again, as =H:MM=. After typing changes yourself, press =C-c C-c= (or =C-c C-y=) on the line: Orgstar fixes both day names and writes the duration again (=org-clock-update-time-maybe=).
+=C-c .= with the caret on the =--= between the two timestamps of a clock line inserts a new timestamp there. Emacs replaces the second timestamp instead.
 A line of the form ~CLOCK: => 1:15~, with only a duration, counts towards clock tables.

docs/manual/guide/07-agenda.org +5 −2

 | Setting                      | Default | =config.toml=                     | Range in Settings |
 |------------------------------+---------+-----------------------------------+-------------------|
-| Days shown                   | 10      | =org-agenda-span = 10=            | 1 to 31           |
+| Days shown                   | 10      | =org-agenda-span = 10=            | 1 to 366          |
 | First day, relative to today | 3 days before | =org-agenda-start-day = "-3d"= | 0 to 14 days before |
 Both mirror the Emacs variables of the same name. The defaults are Doom's values, not plain Emacs's (a week starting today). =org-agenda-start-day= takes only day offsets such as ="-3d"= or ="+0d"=. There are no day, week or month view keys (=d=, =w=, =m= in Emacs) and no =org-agenda-start-on-weekday=: the span is a number of days and always begins at the configured offset.
 With two or more =+= categories, a line may have any of them. Tag terms all have to hold.
+The =/= prompt starts with the whole current filter written in this form, every term with its sign: categories, then tags, efforts and regexps, with categories that contain =-= in quotes. Pressing =Return= on it unchanged keeps the same filter.
 The =\= prompt reads every word as a tag, whether or not a line has it; there, ={regexp}= matches any tag that matches the regexp. The === prompt takes one regexp, with a leading =-= to drop matches. The =_= prompt takes one comparison such as =<0:30=.
 * The prefix and line layout
 | =%e=  | The =Effort= property                                                 |
 | =%l=  | One space per heading level                                           |
 | =%b=  | The outline path above the heading, each title followed by =->=       |
+| =%T=  | The item's last tag, counting inherited tags                          |
 | =%i=  | The category icon; always empty in Orgstar                            |
 Each field takes Org's modifiers: =%-12c= pads to 12 columns on the right (=%12c= on the left); =%-12.6c= limits a category to 5 characters; =%?t= leaves the field out entirely when empty; a punctuation character after the width (=%-12:c=) is added after a non-empty value. When the format contains =%t=, times move out of the heading text into the prefix, as =org-agenda-remove-times-when-in-prefix= does. =%(…)= Lisp forms are accepted but always empty.
 - The Views menu lists the built-in views, your saved views, and Tags and Properties…, which asks for a match string. There is no TODO-only match from the menu; use =/!= in the match or a =todo-match= view. Today, Earlier and Later are in the same menu.
 - Pull down to refresh.
 - The Filter button opens a sheet: type a filter as for =/=, or tap a tag or category to cycle between Keep, Leave out and no filter.
-- Tap an entry to open it. Swipe left on an open TODO to mark it done with the first done keyword of its sequence.
+- Tap an entry to open it. Swipe left on an open TODO to mark it done with the first done keyword of its sequence, as the file defines its keywords: the default keywords from =config.toml=, the file's own =#+TODO= lines, and those of its setup files, with unsaved edits in an open buffer included.
 - Touch and hold an entry for TODO State…, Schedule…, Deadline…, Tags…, Priority…, Clock In, Refile… and Archive….
 - There are no keyboard commands, time grid lines, habit graphs, log mode, bulk marks or custom prefix formats.
 - Reminders are set while the app is open. iOS allows at most 64 pending notifications and the app can't add more while it isn't running, so the agenda's footer says how far ahead they go and asks you to open Orgstar to set later ones.

docs/manual/guide/08-capture.org +5 −5

docs/manual/guide/09-links.org +29 −12

 | =http=, =https=, =ftp=, =news=, =mailto=     | =[[mailto:me@example.com]]=          | Opened by macOS in your default browser or mail app.                                       |
 | =doi=                                        | =[[doi:10.1000/182]]=                | Opens =https://doi.org/= followed by the DOI.                                              |
 | =file= (also =file+sys:=, =file+emacs:=)     | =[[file:notes.org::*Ideas]]=         | See /File links/ below.                                                                 |
-| =id=                                         | =[[id:6A3C…]]=                       | Opens the file with the heading whose =ID= property matches, and moves to the heading.     |
+| =id=                                         | =[[id:6a3c…]]=                       | Opens the file with the heading whose =ID= property matches, and moves to the heading.     |
 | Custom ID                                    | =[[#setup]]=                         | Moves to the heading in this file whose =CUSTOM_ID= property is =setup=.                   |
 | Heading                                      | =[[*Weekly review]]=                 | Moves to the heading in this file with that title.                                         |
 | Text                                         | =[[budget table]]=                   | Searches this file: a =<<budget table>>= target, then =#+NAME: budget table=, then a heading. |
 | Coderef                                      | =[[(ref)]]=                          | Not supported. The echo area says so.                                                      |
 | =shell=, =elisp=                             | =[[shell:ls]]=                       | Not run. Orgstar never executes these links.                                               |
-| =attachment=, =info=, =help=, others         |                                      | Not followed. The echo area says Orgstar can't open the type.                              |
+| =attachment=                                 | =[[attachment:scan.pdf]]=            | Opens the file in the entry's attachment folder; see /Attachment links/ below.             |
+| Radio link                                   | Text matching a =<<<radio target>>>= | Moves to the radio target.                                                                 |
+| =info=, =help=, others                       |                                      | Not followed. The echo area says Orgstar can't open the type.                              |
 The text search follows =org-link-search=. A dedicated =<<target>>= matches its words
 case-insensitively, with any run of blanks between them. A heading matches when its
 same words as the link, ignoring case. A search that starts with =*= looks at headings
 only. Regular-expression searches (=/re/=) are not supported.
-Following a radio link looks for a dedicated target, a name or a heading with the same
+Following a radio link moves to its =<<<radio target>>>=, matching the words without
-text. It does not jump to the =<<<radio target>>>= itself.
+regard to case, as =org-link--search-radio-target= does. When the target is gone, the
+echo area shows =No match for radio target:= and the text.
 ** File links
 | =#custom-id=    | =[[file:notes.org::#setup]]=     | The heading with that =CUSTOM_ID=.          |
 | Other text      | =[[file:notes.org::budget]]=     | A target, a =#+NAME= or a heading, as above. |
+** Attachment links
+An =attachment:= link names a file in the attachment folder of the entry that holds
+the link, with org-attach's default settings. Relative folders are resolved against
+the folder of the file that holds the link:
+1. When the entry has a =DIR= property, or the older =ATTACH_DIR=, that folder.
+2. Otherwise, for an entry with an =ID=, the first of these folders that exists:
+   =data/= followed by the ID's first two characters, =/= and the rest of the ID;
+   =data/= followed by its first six characters, =/= and the rest;
+   =data/__/=, the ID's first character, =/= and the whole ID.
+When the folder does not exist, the path is relative to the file's own folder. The file then opens as a =file:= link would, and
+a search option after =::= works the same way.
 ** id links
 =id:= links are resolved through the index, so the target heading must be in a file
 - your stored links, most recent first, and their descriptions;
 - the link abbreviations defined in the file (see /Link abbreviations/);
-- the link types =id=, =eww=, =rmail=, =mhe=, =irc=, =info=, =gnus=, =docview=,
+- the link types =attachment=, =id=, =eww=, =rmail=, =mhe=, =irc=, =info=, =gnus=, =docview=,
   =bibtex=, =bbdb=, =w3m=, =doi=, =file+sys=, =file+emacs=, =shell=, =news=, =mailto=,
   =https=, =http=, =ftp=, =shortdoc=, =help=, =file= and =elisp=, each followed by =:=.
 | Org ▸ Store ID Link   | =org-id-get-create= + =org-id-store-link= | Doom =SPC m l i=; no key in Emacs or Mac |
 Create ID gives the heading at the caret an =ID= property if it doesn't have one. The
-ID is a new UUID in upper case, for example =6A3C2F9E-…=. Before the first heading,
+ID is a new UUID in lower case, for example =6a3c2f9e-…=, as =org-id-uuid= makes them. Before the first heading,
 the property goes into the file-level property drawer.
 Store ID Link does the same, then stores an =id:= link to the heading with its title
 =<<<radio target>>>= makes every other occurrence of its words in the file a link,
 matched case-insensitively and between non-word characters. Radio links are
 highlighted as links and exported as links to the target (see
-[[file:12-export.org][Export]]). Following one in the editor does not reach the
+[[file:12-export.org][Export]]). Following one moves to the radio target.
-radio target; see /What each link type does/.
 * Link abbreviations
 - *Links to* the heading at the caret, named after that heading.
 - *Links to this file*.
-Each row shows the linking heading and its file name. Click a row to open it. The
+Each row shows the linking heading and its file name; a link in the text before a
+file's first heading is listed under the file's name. Click a row to open it. The
 pane is shown by default and updates as you move the caret and edit.
 The pane looks at every org file in your sidebar folders, including unsaved changes
   heading;
 - within the same file, =[[*Title]]=, =[[#custom-id]]= and =[[Title]]=.
-Links to targets, names and line numbers are not counted. Only links inside a heading's
+Links to targets, names and line numbers are not counted. A heading's links to itself
-entry are indexed, so links in the text before a file's first heading don't appear.
+are left out.
-A heading's links to itself are left out.
 * Inline images

docs/manual/guide/10-tables.org +20 −11

 | Mac    | Org ▸ Align Table            |
 | Doom   | =C-c C-c=, or =SPC m b a=    |
+=C-c C-c= in a table is =org-ctrl-c-ctrl-c=, as in Emacs. It first evaluates a formula
+typed in the current field (see /Entering formulas/). Then, in a row marked =#= (see
+/Names, parameters and constants/), it recalculates that row, which also aligns the
+table; in any other row it aligns the table. With the caret at the table's very first
+character, it recalculates the whole table instead.
 To align every table when a file opens, set =org-startup-align-all-tables= to =true=
 in the config file (default =false=), or put =#+STARTUP: align= in the file;
 =#+STARTUP: noalign= turns it off for that file. See
 | =@I+2=               | Two data rows after the first rule.                                  |
 | =@2$3=               | Row 2, column 3.                                                     |
 | =$0=                 | The current column.                                                  |
+| =@0=                 | The current row: =@0$2= is =$2=.                                     |
 | =@#=, =$#=           | The current row's or column's number, as a value.                    |
 | =@2$1..@4$3=         | A range: the fields of the rectangle, as a vector.                   |
 | =$1..$3=             | Columns 1 to 3 of the current row.                                   |
    folders, read from the file on disk.
 =REF= may use spreadsheet-style references such as =B3= (column B, row 3), which
-become =@3$2=.
+become =@3$2=. A =REF= without a row, such as =$1..$2=, reads the row of the other
+table that has the current row's number. =NAME= can itself be a reference: in
+=remote($1,@1$1)=, the current row's first field holds the table's name.
 ** Calc expressions
 *With a prompt.* =org-table-eval-formula= asks for the formula (~Column formula $N=~
 or ~Field formula @R$C=~) with the stored one filled in, stores it and evaluates it in
-the current field. An empty answer keeps the stored formula and evaluates it again,
+the current field. Clearing the prompt and pressing =Return= removes the stored
-unlike Emacs, where an empty answer removes it. To remove a formula, delete it in the
+formula, as in Emacs, and the echo area shows =Formula removed=. You can also delete a
-formula editor below or from the =#+TBLFM:= line.
+formula in the formula editor below or from the =#+TBLFM:= line.
 | Command                       | Emacs    | Mac                         | Doom     |
 |-------------------------------+----------+-----------------------------+----------|
 grouped under =# Column Formulas=, =# Field and Range Formulas= and
 =# Named Field Formulas=. A formula can continue on indented lines. =C-c '= or
 =⌘Return= installs the formulas; =Escape= or =C-c C-k= leaves them unchanged.
-Installing doesn't recalculate; do that next with =C-c C-c= on the =#+TBLFM:= line, or
+Installing doesn't recalculate. The echo area says so and points to Recalculate Table:
-Org ▸ Recalculate Table in the Mac preset.
+=C-c C-c= on the =#+TBLFM:= line, or Org ▸ Recalculate Table in the Mac preset.
 The formulas are stored sorted the way =org-table-formula-less-p= sorts them.
 Tables are not recalculated automatically. Rows marked =#= are not recalculated when
 you press =TAB= or =RET= in them, as =org-table-maybe-recalculate-line= would do in
-Emacs; recalculate with one of the commands above.
+Emacs; recalculate with one of the commands above, or with =C-c C-c= in the row.
 * When Emacs is needed
 table's text in this file, so the question isn't asked again until the text changes.
 Entering a formula that needs Emacs with ~C-c =~, Set Field Formula or ~=~ in a field
-is not handed to Emacs. The echo area shows =The formula was stored; recalculating it
+is not handed to Emacs. The formula is stored in the =#+TBLFM:= line and the field is
-needs Emacs= and the reason, but the table and its =#+TBLFM:= line stay unchanged.
+left as it was; the echo area shows =The formula was stored; recalculating it needs
-Add such a formula in the formula editor or by editing the =#+TBLFM:= line, then
+Emacs= and the reason. =TAB= and =RET= still move to the next field. Recalculate the
-recalculate the table, which runs it in Emacs.
+table to run the formula in Emacs.
 For how Orgstar and Emacs share files, see
 [[file:15-alongside-emacs.org][Using Orgstar alongside Emacs]].

docs/manual/guide/11-code-blocks.org +6 −6

	@@ -82,7 +82,7 @@ The block's text is remembered when the run starts. If you edit the block while
82		82
83	** Languages that run	83	** Languages that run
84		84
85	On the Mac, Orgstar starts each interpreter through =/usr/bin/env=. Because an app opened from the Dock does not see your shell's =PATH=, Orgstar adds =/opt/homebrew/bin=, =/usr/local/bin=, =/usr/bin= and =/bin= to the end of it.	85	On the Mac, Orgstar starts each interpreter through =/usr/bin/env=. Because an app opened from the Dock does not see your shell's =PATH=, Orgstar adds =/opt/homebrew/bin=, =/usr/local/bin=, =/Library/TeX/texbin=, =/usr/bin= and =/bin= to the end of it.
86		86
87	\| Language \| Program run \|	87	\| Language \| Program run \|
88	\|------------------------------------------------------------------+-----------------------------------------------------\|	88	\|------------------------------------------------------------------+-----------------------------------------------------\|
	@@ -118,11 +118,11 @@ When a block's =:var= or =:stdin= refers to other blocks that have to run first,
118		118
119	\| Value \| Effect \|	119	\| Value \| Effect \|
120	\|------------------------------------------+------------------------------------------------------------\|	120	\|------------------------------------------+------------------------------------------------------------\|
121	\| =never=, =no=, =never-export=, =no-export= \| The block does not run: "Evaluation of this /language/ code block is disabled." \|	121	\| =never=, =no= \| The block does not run: "Evaluation of this /language/ code block is disabled." \|
122	\| =query= \| Asks every time, with only =yes= and =no=. A block reached through =:var= with =:eval query= makes the whole chain ask every time. \|	122	\| =query= \| Asks every time, with only =yes= and =no=. A block reached through =:var= with =:eval query= makes the whole chain ask every time. \|
123	\| anything else, or absent \| Runs after the trust prompt. \|	123	\| anything else, or absent \| Runs after the trust prompt. \|
124		124
125	Orgstar does not export by running blocks, so =never-export= and =no-export= also stop the block from running interactively. In Org these two values only stop evaluation during export.	125	=never-export= and =no-export= only stop evaluation during export in Org. Orgstar does not run blocks during export, so with these values the block runs from =C-c C-c= like any other.
126		126
127	** Cancelling a run	127	** Cancelling a run
128		128
	@@ -257,7 +257,7 @@ Orgstar merges header arguments in this order, each layer overriding the ones be
257	4. =#+HEADER:= lines above the block.	257	4. =#+HEADER:= lines above the block.
258	5. For a call, the call's arguments (see Calls below).	258	5. For a call, the call's arguments (see Calls below).
259		259
260	A property written with a =+=, such as =header-args+=, adds to the value inherited from above instead of replacing it.	260	A property written with a =+=, such as =header-args+=, adds to the value inherited from above instead of replacing it. In a property drawer, =:header-args:sh:= is one property name, so its value applies only to =sh= blocks.
261		261
262	#+BEGIN_SRC org	262	#+BEGIN_SRC org
263	,#+PROPERTY: header-args :results output	263	,#+PROPERTY: header-args :results output
	@@ -522,7 +522,7 @@ Text src_sh{echo hi} {{{results(=hi=)}}} end.
522		522
523	Running again replaces the macro. With =:results raw= the result goes in as it is, without the macro. An inline result must be one line, and a table result must be a single cell.	523	Running again replaces the macro. With =:results raw= the result goes in as it is, without the macro. An inline result must be one line, and a table result must be a single cell.
524		524
525	An inline call, =call_double(n=6)=, has the same parts as a =#+CALL:= line: =call_name[inside](arguments)[end]=. Orgstar reads inline calls and writes their results the same way as inline blocks, but =C-c C-c= on an inline call does not run it. Use a =#+CALL:= line instead.	525	An inline call, =call_double(n=6)=, has the same parts as a =#+CALL:= line: =call_name[inside](arguments)[end]=. =C-c C-c= on an inline call runs it, and its result is written after it as a =results= macro, as for inline blocks.
526		526
527	* Emacs Lisp blocks	527	* Emacs Lisp blocks
528		528
	@@ -570,7 +570,7 @@ All three are in the Org menu and the command palette. The Mac preset has no key
570	\| =:tangle= \| Target \|	570	\| =:tangle= \| Target \|
571	\|-------------------+-------------------------------------------------------------------------------------------------\|	571	\|-------------------+-------------------------------------------------------------------------------------------------\|
572	\| =no= (default) \| Not tangled. \|	572	\| =no= (default) \| Not tangled. \|
573	\| =yes= \| The Org file's name with the language as extension: =el= for =emacs-lisp= and =elisp=, =bib= for =bibtex=, otherwise the language name itself (=notes.sh= for =sh=, =notes.python= for =python=). \|	573	\| =yes= \| The Org file's name with the language's extension, as Org's language files define it (=org-babel-tangle-lang-exts=): =py= for =python=, =rb= for =ruby=, =pl= for =perl=, =cpp= for =C++=, =d= for =D=, =awk=, =sed=, =lua=, =hs= for =haskell=, =java=, =tex= for =latex=, =ly= for =LilyPond=, =F90= for =fortran=, =clj= for =clojure=, =cljs= for =clojurescript=, =cs= for =csharp=, =groovy=, =jl= for =julia=, =lisp=, =max= for =maxima=, =ml= for =ocaml=, =pde= for =processing=, =el= for =emacs-lisp= and =elisp=, and =bib= for =bibtex=. Any other language is its own extension (=notes.sh= for =sh=). \|
574	\| a path \| That file, relative to the Org file's folder. =~= is expanded. \|	574	\| a path \| That file, relative to the Org file's folder. =~= is expanded. \|
575	\| Lisp \| Evaluated as described under Lisp in header values, with =buffer-file-name= set to the Org file. \|	575	\| Lisp \| Evaluated as described under Lisp in header values, with =buffer-file-name= set to the Org file. \|
576		576

docs/manual/guide/12-export.org +11 −9

 | ODT                | Export to ODT with Emacs         | =C-c C-e o o= | =C-c C-e o o=                 | yes         |
 | Plain text         | Export to Plain Text with Emacs  | =C-c C-e t u= | =C-c C-e t u=                 | yes         |
-The keys follow Emacs's export dispatcher (=org-export-dispatch=). The =SPC m e= keys work in normal state; the =C-c C-e= keys work in every Doom state. The Mac preset has no export keys.
+The keys follow Emacs's export dispatcher (=org-export-dispatch=). =C-c C-e= on its own is only a prefix: pause after it and the key hints list the formats. The =SPC m e= keys work in normal state; the =C-c C-e= keys work in every Doom state. The Mac preset has no export keys.
 All seven commands are in File ▸ Export and in the command palette. They write the export beside the Org file, with the same name and the format's extension: =.html=, =.md=, =.pdf=, =.tex=, =.odt= or =.txt=. A file already there is replaced. The message area shows "Exported to /name/".
 ** The export dialog
-The command palette's *Export…* opens a dialog with:
+*Export…* in the command palette opens a dialog. No preset binds it to a key; bind =app.export-dialog= in =keymap.toml= if you want one (see [[file:03-keys.org][Keys and commands]]). The dialog has:
 - *Format*: HTML, Markdown, PDF (Emacs), ODT (Emacs), LaTeX (Emacs) or Plain text (Emacs).
 - *Destination*: beside the Org file by default. *Choose…* picks another place and name. Changing the format changes the extension.
 | ={{{title}}}=, ={{{author}}}=, ={{{date}}}=, ={{{email}}}= | That keyword's value.                     |
 | ={{{keyword(NAME)}}}=        | The value of =#+NAME:=.                                               |
 | ={{{input-file}}}=           | The Org file's name.                                                  |
+| ={{{property(NAME)}}}=       | The value of property =NAME= of the entry the macro is in; =ITEM= gives the heading's title. Empty before the first heading. |
+| ={{{property(NAME,SEARCH)}}}= | The same for the entry =SEARCH= finds in this file: =*Title=, =#custom-id= or a title. |
 | ={{{n}}}=, ={{{n(name)}}}=   | A counter, increased at each use. =n(name,-)= repeats the current value; =n(name,5)= sets it to 5. |
 | ={{{time(format)}}}=         | The current time, formatted as =format-time-string= does.             |
 A source block is exported as =<pre><code class="language-LANG">=, with the code escaped and its common indentation removed. Orgstar does not color the code; the class lets a script or stylesheet in =#+HTML_HEAD= highlight it. Noweb references are shown as written. Line-number switches are ignored.
-The block's =:exports= argument decides what appears. Orgstar reads it from the =#+begin_src= line only.
+The block's =:exports= header argument decides what appears. Orgstar resolves it as running the block would: from the =#+begin_src= line, =#+HEADER:= lines, =header-args= properties and =#+PROPERTY:= lines (see [[file:11-code-blocks.org][Code blocks]]). Without one, it is =results= for =dot=, =plantuml=, =ditaa=, =gnuplot=, =latex= and =lilypond= blocks, as their Org defaults set it, and =code= for other languages.
 | =:exports=       | Exported                                  |
 |------------------+-------------------------------------------|
-| =code= (default) | The code.                                 |
+| =code=           | The code.                                 |
 | =results=        | The block's existing =#+RESULTS:=.        |
 | =both=           | The code, then the results.               |
 | =none=           | Nothing.                                  |
-An inline =src_= block is exported as its code in =<code>=. Results of =#+CALL:= lines and inline blocks are not exported.
+A =#+CALL:= line exports its existing results, never the call itself; =:exports code= or =none= on the call exports nothing. An inline =src_= block has =:exports results= by default: the ={{{results(…)}}}= after it is exported and its code is not. With =:exports code= the code is exported in =<code>= and the results are not; with =both=, both. An inline =call_= exports its results the same way, and the call itself never appears.
 ** Other blocks and elements
 Markdown export writes GitHub-flavored Markdown:
-- =#+TITLE:= becomes a top =#= heading. Org headings are one level down: =*= is =##=. TODO keywords and priorities stay in the heading text, and tags are shown as inline code.
+- =#+TITLE:= becomes a top =#= heading. Org headings are one level down: =*= is =##=. TODO keywords stay in the heading text, and tags are shown as inline code. Priority cookies are left out unless =#+OPTIONS= has =pri:t=.
 - Source blocks become fenced code blocks with the language; example blocks, =: = lines and table.el tables become fenced blocks without one.
 - Tables become pipe tables. A rule after the first row makes it the header; otherwise the header row is empty.
 - Checkboxes become task-list items (=- [x]=, =- [ ]=).
 - Footnotes become =[^1]= references with the notes at the end.
 - Quotes become =>= blocks. Verse lines end with two spaces.
-- Images become =![](path)=. Links to =.org= files written without =file:= point to the =.md= file of the same name.
+- Images become =![](path)=. Links to =.org= files, with or without =file:=, point to the =.md= file of the same name; a search option after =::= is dropped.
 - =#+begin_export= blocks for =markdown=, =md= or =html=, and =@@html:…@@= snippets, are copied as they are.
 - Underline, subscripts and superscripts are written as HTML tags.
 - =:exports= is handled as in HTML export.
 - Citations are handled as in HTML export.
-Markdown export is simpler than HTML export. It does not read =#+OPTIONS=, =#+EXCLUDE_TAGS= or =#+SELECT_TAGS=, does not leave out =noexport= or =COMMENT= headings, does not expand =#+INCLUDE:=, and drops macros. It writes no author or date.
+As in HTML export, =#+INCLUDE:= lines are expanded and macros replaced first, and =#+EXCLUDE_TAGS=, =#+SELECT_TAGS=, =COMMENT= headings and =ARCHIVE= tags decide which headings are exported (see /Which headings are exported/). Of the =#+OPTIONS=, Markdown export reads =todo=, =pri=, =tags=, =^= and =title=; the others do not apply. It writes no author or date.
 * Exporting through Emacs
 What you need:
 - Emacs, at =ORGSTAR_EMACS= or one of =/opt/homebrew/bin/emacs=, =/usr/local/bin/emacs=, =/Applications/Emacs.app/Contents/MacOS/Emacs=, =/run/current-system/sw/bin/emacs= or =/usr/bin/emacs=. Without it the export fails with "Emacs isn't installed, so this format can't be exported."
-- For PDF, a TeX installation that Emacs's LaTeX export can run.
+- For PDF, a TeX installation that Emacs's LaTeX export can run. Emacs runs with your =PATH= plus =/opt/homebrew/bin=, =/usr/local/bin=, =/Library/TeX/texbin=, =/usr/bin= and =/bin=, the same as code blocks get, so =latexmk= and =pdflatex= from MacTeX or Homebrew are found when Orgstar was opened from the Dock.
 Things to know:

docs/manual/guide/13-configuration.org +8 −8

	@@ -9,7 +9,7 @@ Orgstar keeps its settings in a configuration folder:
9	- =$XDG_CONFIG_HOME/orgstar= when =XDG_CONFIG_HOME= is set and not empty,	9	- =$XDG_CONFIG_HOME/orgstar= when =XDG_CONFIG_HOME= is set and not empty,
10	- otherwise =~/.config/orgstar=.	10	- otherwise =~/.config/orgstar=.
11		11
12	The environment variable =ORGSTAR_CONFIG_DIR= overrides both. If a file is missing from the configuration folder but exists in =~/Library/Application Support/Orgstar= (where earlier versions kept it), Orgstar reads it from there.	12	The environment variable =ORGSTAR_CONFIG_DIR= overrides both. If a file is missing from the configuration folder but exists in =~/Library/Application Support/Orgstar= (where earlier versions kept it), Orgstar reads it from there, and reloads it when you edit it there.
13		13
14	The folder holds these files:	14	The folder holds these files:
15		15
	@@ -98,7 +98,7 @@ See Themes and Fonts below.
98		98
99	\| Control \| Range \| Default \| Key \|	99	\| Control \| Range \| Default \| Key \|
100	\|-------------------------------------+------------------------+--------------+-----------------------------\|	100	\|-------------------------------------+------------------------+--------------+-----------------------------\|
101	\| Agenda shows N days \| 1 to 31 \| 10 \| =org-agenda-span= \|	101	\| Agenda shows N days \| 1 to 366 \| 10 \| =org-agenda-span= \|
102	\| Agenda starts N days before today \| 0 to 14 days before \| 3 days \| =org-agenda-start-day= \|	102	\| Agenda starts N days before today \| 0 to 14 days before \| 3 days \| =org-agenda-start-day= \|
103	\| Include files in subfolders \| On or off \| Off \| =agenda-include-subfolders= \|	103	\| Include files in subfolders \| On or off \| Off \| =agenda-include-subfolders= \|
104	\| Notify before timed agenda entries \| On or off \| On \| =reminders= \|	104	\| Notify before timed agenda entries \| On or off \| On \| =reminders= \|
	@@ -194,7 +194,7 @@ The startup settings (=org-startup-*=, =org-hide-leading-stars=, =org-cycle-hide
194	\| =todo= \| string \| =" %i %-12:c"= \| Prefix of lines in the TODO list \|	194	\| =todo= \| string \| =" %i %-12:c"= \| Prefix of lines in the TODO list \|
195	\| =tags= \| string \| =" %i %-12:c"= \| Prefix of tag and property matches \|	195	\| =tags= \| string \| =" %i %-12:c"= \| Prefix of tag and property matches \|
196		196
197	These mirror the entries of =org-agenda-prefix-format=. In the format, =%c= is the category, =%t= the time, =%s= the scheduled or deadline note, =%e= the effort, =%l= the level, =%b= the outline path, and a number such as =%-12= pads. See [[file:07-agenda.org][The agenda]].	197	These mirror the entries of =org-agenda-prefix-format=. In the format, =%c= is the category, =%t= the time, =%s= the scheduled or deadline note, =%e= the effort, =%l= the level, =%b= the outline path, =%T= the item's last tag (inherited tags included), and a number such as =%-12= pads. See [[file:07-agenda.org][The agenda]].
198		198
199	** [theme]	199	** [theme]
200		200
	@@ -256,7 +256,7 @@ save = "explicit"
256		256
257	** Names from earlier versions	257	** Names from earlier versions
258		258
259	Earlier versions used keys such as =editor.fill-column= and =agenda.span=. Orgstar still reads them. At launch, a file that uses any of them is rewritten with the current names and every setting at its current value; comments you added are not kept. A file that lacks a whole section (such as =[theme]=) gets that section added at the end.	259	Earlier versions used keys such as =editor.fill-column= and =agenda.span=. Orgstar still reads them. At launch, each such key in the file is renamed in place to its current name and moved to its current section; the rest of the file, and the comments on those lines, stay as they are. When a setting is in the file under both names, the current name wins and the old line is removed. A section the move leaves empty is removed. A file that lacks a whole section (such as =[theme]=) gets that section added at the end.
260		260
261	* keymap.toml and capture.toml	261	* keymap.toml and capture.toml
262		262
	@@ -274,7 +274,7 @@ command = "app.agenda"
274		274
275	* In-file settings	275	* In-file settings
276		276
277	Keyword lines in a file set options for that file, as in Emacs. Orgstar reads them outside blocks; for =#+STARTUP= only lines at the element level count, so a =#+STARTUP= line inside a paragraph or a block doesn't change folding.	277	Keyword lines in a file set options for that file, as in Emacs. Orgstar reads them outside blocks; for =#+STARTUP= only keyword lines count, so a =#+STARTUP= line inside a paragraph or a block changes nothing: not folding, logging or inline images.
278		278
279	** Keywords Orgstar reads	279	** Keywords Orgstar reads
280		280
	@@ -360,7 +360,7 @@ What Import does with each kind of item:
360	- Settings are written to =config.toml=.	360	- Settings are written to =config.toml=.
361	- Folders are added to the sidebar if they exist and aren't there already.	361	- Folders are added to the sidebar if they exist and aren't there already.
362	- Capture templates are appended to =capture.toml=, except those whose key is already in the file.	362	- Capture templates are appended to =capture.toml=, except those whose key is already in the file.
363	- Key bindings are appended to =keymap.toml=. Running the import again appends them again.	363	- Key bindings are appended to =keymap.toml=, except those already in the file with the same keys, command and state. Running the import again adds no duplicates.
364		364
365	The Not imported section lists what Orgstar read but can't use, with the reason: settings it has no equivalent for, values it can't work out without running Emacs, bindings to code rather than a command, and files it couldn't read. The footer counts variables that aren't about org, which are left alone.	365	The Not imported section lists what Orgstar read but can't use, with the reason: settings it has no equivalent for, values it can't work out without running Emacs, bindings to code rather than a command, and files it couldn't read. The footer counts variables that aren't about org, which are left alone.
366		366
	@@ -421,7 +421,7 @@ Any other =org-= or =appt-= variable is listed as having no equivalent.
421		421
422	Capture templates are imported when their type is =entry=, =item=, =checkitem=, =plain= or =table-line=, their template is a string, and their target is =file=, =file+headline=, =file+olp=, =file+olp+datetree=, =file+datetree=, =file+weektree=, =id= or =clock=. The properties =:prepend=, =:immediate-finish=, =:jump-to-captured=, =:clock-in=, =:clock-keep=, =:clock-resume=, =:empty-lines=, =:empty-lines-before=, =:empty-lines-after=, =:tree-type= (=day=, =week=, =month=) and =:table-line-pos= carry over; others are listed as left out. Template groups (a key and a name only) are skipped.	422	Capture templates are imported when their type is =entry=, =item=, =checkitem=, =plain= or =table-line=, their template is a string, and their target is =file=, =file+headline=, =file+olp=, =file+olp+datetree=, =file+datetree=, =file+weektree=, =id= or =clock=. The properties =:prepend=, =:immediate-finish=, =:jump-to-captured=, =:clock-in=, =:clock-keep=, =:clock-resume=, =:empty-lines=, =:empty-lines-before=, =:empty-lines-after=, =:tree-type= (=day=, =week=, =month=) and =:table-line-pos= carry over; others are listed as left out. Template groups (a key and a name only) are skipped.
423		423
424	Key bindings are imported when the command is one Orgstar has a counterpart for, such as =org-todo=, =org-schedule=, =org-refile=, =org-capture= or =save-buffer=. Keys must be a string or =(kbd "…")=. In a Doom configuration, bindings without a state go to the =normal= state.	424	Key bindings are imported when the command is one Orgstar has a counterpart for, such as =org-todo=, =org-schedule=, =org-refile=, =org-capture= or =save-buffer=. Keys must be a string or =(kbd "…")=; bindings with key vectors such as =[f5]= are skipped. In a Doom configuration, bindings without a state go to the =normal= state.
425		425
426	** Limits of the Lisp reader	426	** Limits of the Lisp reader
427		427
	@@ -469,7 +469,7 @@ To keep a theme in its own file, put it in the configuration folder with the sam
469	theme-file = "solarized.toml"	469	theme-file = "solarized.toml"
470	#+END_SRC	470	#+END_SRC
471		471
472	The colors stack in this order, each over the one before: the default theme, the theme file, then the colors in =config.toml=. Orgstar reloads the theme file when it changes. Only colors are read from a theme file; =font= and the other type keys in its =[theme]= table are ignored.	472	The colors stack in this order, each over the one before: the default theme, the theme file, then the colors in =config.toml=. The path is relative to the configuration folder and may name a subfolder, as =themes/solarized.toml=. Orgstar reloads the theme file when it changes. Only colors are read from a theme file; =font= and the other type keys in its =[theme]= table are ignored.
473		473
474	** Color keys	474	** Color keys
475		475

docs/manual/guide/14-ios.org +11 −8

 Tap Edit in the reader. The title shows the buffer name, with =•= while there are unsaved changes. The tab bar is hidden while you edit.
-The editor folds headings, drawers and blocks, styles text with the default theme, and runs the same Org commands as the Mac. Autocorrection, smart quotes and smart dashes are off; spell checking is on.
+The editor folds headings, drawers and blocks, styles text with the default theme, and runs the same Org commands as the Mac. Autocorrection, smart quotes and smart dashes are off; spell checking follows =spell-check= in =config.toml= and is off by default.
 The toolbar has:
 - Command shortcuts are the system's.
 - Keys the keymap leaves to the text system stay with iOS. These include the editing keys =C-a=, =C-e=, =C-k= and similar, which iOS handles itself.
 - After a prefix such as =C-c=, the message line shows =C-c-= while it waits for the next key. An unbound sequence shows =… is undefined=.
+- A sequence bound to a command that can't run at the caret, or that the iOS app doesn't have, shows why, as on the Mac: the command's own message (such as =Not on a heading=), or =Not available on iOS yet=.
 See [[file:03-keys.org][Keys and commands]] for the Emacs bindings.
 - Views (the calendar icon) :: the built-in views and those in =views.toml=, Tags and Properties… (a match such as =+work-home= or =TODO="WAIT"=), and in the day view, Today, Earlier and Later.
 - Filter :: keep or leave out tags and categories of the entries shown, or type a filter as Org's =/= takes it: =+keep= and =-drop= tags or categories, =<0:30= for effort, =/regexp/=. The status line shows the filter in use.
 - Tap an entry to read it, at its heading.
-- Swipe a TODO entry to the left to mark it done with the first done keyword of its sequence.
+- Swipe a TODO entry to the left to mark it done with the first done keyword of its sequence, as the file defines its keywords (with the default keywords, its =#+TODO= lines and its setup files).
 - Touch and hold an entry for TODO State…, Schedule…, Deadline…, Tags…, Priority…, Clock In, Refile…, and Archive….
 Commands from the agenda change the file directly when it isn't open, and through the editor when it is. If the heading changed since the agenda was built, nothing runs.
 Templates come from =capture.toml= in the configuration folder (see Settings below). Without one, the two default templates apply. A template with =immediate-finish= files as soon as its questions are answered, and one with =jump-to-captured= opens the captured entry. =%^g= offers the target file's tags as choices.
-=org-protocol://capture= links opened on the device open the capture sheet with the link's template, URL, title and text.
+=org-protocol://capture= links opened on the device open the capture sheet with the link's template, URL, title and text. When the link names a template key that =capture.toml= doesn't have, the sheet starts on the first template and shows =No capture template "x"= with the key.
 ** From the share sheet
 Stop Using This Folder returns every setting to its default.
-The In use section shows the TODO keywords, the agenda span and start, the reminder lead time, and the capture template keys in effect.
+The In use section shows the TODO keywords, the agenda span and start (for example =10 days, starting 3 days before today=), the reminder lead time, and the capture template keys in effect.
 These settings from =config.toml= apply on iOS:
 - =org-todo-keywords=, =org-list-allow-alphabetical=
-- =org-tags-column=, =org-insert-heading-respect-content=, =fill-column=
+- =org-tags-column=, =org-insert-heading-respect-content=, =org-M-RET-may-split-line=, =fill-column=
+- =org-hide-emphasis-markers= and =org-pretty-entities=, for how tag and table alignment and filling measure text, as on the Mac
 - =org-log-done=, =org-log-reschedule=, =org-log-redeadline=, =org-log-into-drawer=
-- =electric-pair-mode=
+- =org-use-speed-commands=, with a hardware keyboard
+- =electric-pair-mode=, =spell-check=
 - =org-agenda-span=, =org-agenda-start-day=, =agenda-include-subfolders=
 - =reminders=, =appt-message-warning-time=
-=capture.toml= and =views.toml= in the folder apply too. Other settings, including =keymap=, =save=, the theme and font, and the startup settings, don't apply on iOS. See [[file:13-configuration.org][Configuration]].
+=capture.toml= and =views.toml= in the folder apply too. Other settings, including =keymap=, =save=, the theme and font, and the startup settings (=org-startup-*=, =org-hide-leading-stars=, =org-cycle-hide-*-startup=), don't change what the iOS reader and editor show. See [[file:13-configuration.org][Configuration]].
 * Spotlight and Quick Look
 - The global capture hotkey and the Settings window.
 - Explicit saving.
-Commands the iOS app can't carry out show a message instead, such as "Not available on iOS yet". Commands that only appear on the Mac, such as Refile from the editor, aren't listed in Commands; refile and archive from the agenda instead.
+Commands the iOS app can't carry out show a message instead, such as "Not available on iOS yet" or "/Command/ isn't available on iPhone and iPad." Only tables that need Emacs say that Emacs is needed. Commands that only appear on the Mac, such as Refile from the editor, aren't listed in Commands; refile and archive from the agenda instead.

docs/manual/guide/15-alongside-emacs.org +2 −1

 - Orgstar writes a snapshot of the buffer to a temporary folder and runs Emacs on it, so unsaved edits are included. The working directory is the file's folder.
 - File-local variables marked safe apply (=enable-local-variables= is =:safe=).
 - Export doesn't run source blocks (=org-export-use-babel= is =nil=). The exported file is written next to the org file, as Emacs writes it, or moved to the place you chose.
+- For export, Emacs gets your =PATH= with =/opt/homebrew/bin=, =/usr/local/bin=, =/Library/TeX/texbin=, =/usr/bin= and =/bin= added, as source blocks do, so the programs it starts, such as =pdflatex=, are found when Orgstar was opened from the Dock.
 - PDF export needs a LaTeX installation that Org's LaTeX exporter can run.
 - A table recalculation that takes more than 60 seconds, or an export that takes more than 120 seconds, is stopped. Source blocks have a limit of 300 seconds, and =⌘.= (Cancel Running Block) stops one.
 - =#+SETUPFILE= URLs aren't fetched.
 - Most =#+STARTUP= options for footnotes, entities, LaTeX previews, numbering and odd levels are accepted and ignored; see [[file:13-configuration.org][Configuration]].
 - =display-line-numbers-type= has no relative or visual mode.
-- In the Doom preset, =ZQ= isn't available; use the window's close button.
+- =C-c .= with the caret on the =--= of a clock line's range inserts a new timestamp; Emacs replaces the second timestamp.

	@@ -31,7 +31,7 @@ Several commands in this chapter are only in the palette, not in a menu: Close O
31		31
32	\| Menu item \| Shortcut \| Palette title \|	32	\| Menu item \| Shortcut \| Palette title \|
33	\|------------------------------------------+----------+----------------------------------\|	33	\|------------------------------------------+----------+----------------------------------\|
34	\| View ▸ Show or Hide Outline \| \| Show or Hide Outline \|	34	\| View ▸ Show or Hide Outline \| =⌥⌘O= \| Show or Hide Outline \|
35	\| View ▸ Show or Hide Backlinks \| \| Show or Hide Backlinks \|	35	\| View ▸ Show or Hide Backlinks \| \| Show or Hide Backlinks \|
36	\| View ▸ Show or Hide Columns and Clock \| =⌥⌘I= \| Show or Hide Columns and Clock \|	36	\| View ▸ Show or Hide Columns and Clock \| =⌥⌘I= \| Show or Hide Columns and Clock \|
37	\| View ▸ Show Tab Bar \| \| Show or Hide Tab Bar \|	37	\| View ▸ Show Tab Bar \| \| Show or Hide Tab Bar \|
	@@ -99,7 +99,7 @@ Right-click a file or folder in the sidebar for:
99	- New File… — creates a file in that folder (for a file, in the folder holding it). A name without an extension gets =.org=. A name like =projects/house= creates the =projects= folder too. Names can't start with =/= or contain =..=. The new file opens.	99	- New File… — creates a file in that folder (for a file, in the folder holding it). A name without an extension gets =.org=. A name like =projects/house= creates the =projects= folder too. Names can't start with =/= or contain =..=. The new file opens.
100	- Rename… — renames the file or folder in place. The new name can't contain =/=. Open buffers of the file, or of files inside the folder, are saved first (in explicit save mode you are asked) and reopened under the new path.	100	- Rename… — renames the file or folder in place. The new name can't contain =/=. Open buffers of the file, or of files inside the folder, are saved first (in explicit save mode you are asked) and reopened under the new path.
101	- Show in Finder.	101	- Show in Finder.
102	- Move to Trash… — moves the file or folder to the Trash after you confirm. Open buffers of it close without saving. You can put it back from the Trash in Finder.	102	- Move to Trash… — moves the file or folder to the Trash after you confirm. Open buffers of it close without saving; the confirmation warns you when the file, or an open file inside the folder, has unsaved changes. You can put it back from the Trash in Finder.
103		103
104	Right-click a root's header for New File…, Expand or Collapse, Show in Finder and Remove from Sidebar….	104	Right-click a root's header for New File…, Expand or Collapse, Show in Finder and Remove from Sidebar….
105		105
	@@ -107,7 +107,7 @@ Right-click a root's header for New File…, Expand or Collapse, Show in Finder
107		107
108	Click a file in the sidebar to open it. Other ways:	108	Click a file in the sidebar to open it. Other ways:
109		109
110	- Quick Open: File ▸ Quick Open… (=⌘P=; =C-x C-f= in the Emacs and Doom presets; =SPC SPC=, =SPC .= or =SPC f f= in Doom normal state). Type part of a file's path below its root. Characters match in order, not necessarily next to each other; matches at the start of a word and runs of consecutive characters rank higher, and shorter paths win ties. Up to 50 matches show, with each file's name and path. Press =Return= to open the top match or click any match; =Escape= closes the list. Syncthing conflict copies are left out.	110	- Quick Open: File ▸ Quick Open… (=⌘P=; =C-x C-f= in the Emacs and Doom presets; =SPC SPC=, =SPC .= or =SPC f f= in Doom normal state). Type part of a file's path below its root. Characters match in order, not necessarily next to each other; matches at the start of a word and runs of consecutive characters rank higher, and shorter paths win ties. Up to 50 matches show, with each file's name and path. The top match is selected; =↑= and =↓=, or =C-p= and =C-n=, move the selection. Press =Return= to open the selected match or click any match; =Escape= closes the list. Syncthing conflict copies are left out.
111	- Finder: open an org file from Finder, with =open file.org= in Terminal, or by dropping it on Orgstar's Dock icon. Orgstar registers as the default app for org files and as an alternative editor for plain text. Each file opens as a buffer.	111	- Finder: open an org file from Finder, with =open file.org= in Terminal, or by dropping it on Orgstar's Dock icon. Orgstar registers as the default app for org files and as an alternative editor for plain text. Each file opens as a buffer.
112	- Links: following a =file:= link or an ID link opens the target file; see [[file:09-links.org][Links]].	112	- Links: following a =file:= link or an ID link opens the target file; see [[file:09-links.org][Links]].
113	- Doom ex command: =:e FILE= opens =FILE=, relative to the current file's folder; =~= is expanded. A file that doesn't exist is reported as =No file FILE=.	113	- Doom ex command: =:e FILE= opens =FILE=, relative to the current file's folder; =~= is expanded. A file that doesn't exist is reported as =No file FILE=.
	@@ -195,7 +195,7 @@ The outline follows your edits after a short pause in typing.
195		195
196	** Backlinks	196	** Backlinks
197		197
198	Under the outline, the backlinks pane lists headings in your folders that link to the current file (=Links to this file=) and to the heading at the caret (=Links to= followed by the heading's title). It updates as you move the caret. Click an entry to open it. Turn the pane off with View ▸ Show or Hide Backlinks. Which links count is covered in [[file:09-links.org][Links]].	198	Under the outline, the backlinks pane lists headings in your folders that link to the current file (a link before a file's first heading is listed under the file's name) (=Links to this file=) and to the heading at the caret (=Links to= followed by the heading's title). It updates as you move the caret. Click an entry to open it. Turn the pane off with View ▸ Show or Hide Backlinks. Which links count is covered in [[file:09-links.org][Links]].
199		199
200	** Inspector	200	** Inspector
201		201

	@@ -36,7 +36,7 @@ A file can set its own keywords, which replace the default ones for that file:
36		36
37	- Each line is one sequence. =#+SEQ_TODO= means the same as =#+TODO=.	37	- Each line is one sequence. =#+SEQ_TODO= means the same as =#+TODO=.
38	- Without a =\|=, the last word is the done keyword.	38	- Without a =\|=, the last word is the done keyword.
39	- =#+TYP_TODO= marks a sequence of types (=org-todo-interpretation= =type=). The only difference Orgstar makes is in repeating tasks: a repeating entry returns to the keyword it had before it was done, instead of to the first keyword of the sequence.	39	- =#+TYP_TODO= marks a sequence of types (=org-todo-interpretation= =type=). Cycling with =C-c C-t= from a type keyword goes to the sequence's first done keyword (see /Cycling/), and a repeating entry returns to the keyword it had before it was done, instead of to the first keyword of the sequence.
40	- The order of sequences is the order Org uses: =#+TYP_TODO= lines first, then =#+TODO=, then =#+SEQ_TODO=.	40	- The order of sequences is the order Org uses: =#+TYP_TODO= lines first, then =#+TODO=, then =#+SEQ_TODO=.
41	- Lines inside blocks are ignored. Lines from a =#+SETUPFILE= count as if they came first in the file.	41	- Lines inside blocks are ignored. Lines from a =#+SETUPFILE= count as if they came first in the file.
42		42
	@@ -73,7 +73,7 @@ With speed commands on (=org-use-speed-commands=), =t= at the start of a heading
73	=C-c C-t= behaves in one of two ways:	73	=C-c C-t= behaves in one of two ways:
74		74
75	- If any keyword in the file has a fast-selection key, it opens fast selection (=org-use-fast-todo-selection= =auto=). The default keywords all have keys, so this is what you get unless you define keywords without keys.	75	- If any keyword in the file has a fast-selection key, it opens fast selection (=org-use-fast-todo-selection= =auto=). The default keywords all have keys, so this is what you get unless you define keywords without keys.
76	- Otherwise it cycles: no keyword, then each keyword of the first sequence in order, then no keyword again. From a keyword in another sequence it moves through that sequence and then to no keyword.	76	- Otherwise it cycles: no keyword, then each keyword of the first sequence in order, then no keyword again. From a keyword in another sequence it moves through that sequence and then to no keyword. From a =#+TYP_TODO= keyword it goes straight to the sequence's first done keyword, as Org does; pressing =C-c C-t= again right away moves to the next type keyword instead. In the iOS app and the agenda, each press on a type keyword goes to the done keyword.
77		77
78	=S-<right>= and =S-<left>= never use fast selection. They step through every keyword of every sequence in order, then to no keyword, and wrap around.	78	=S-<right>= and =S-<left>= never use fast selection. They step through every keyword of every sequence in order, then to no keyword, and wrap around.
79		79
	@@ -224,7 +224,7 @@ A tag consists of letters, digits, =_=, =@=, =#= and =%=.
224		224
225	\| Command \| Org command \| Emacs, Doom \| Mac \| Doom leader \|	225	\| Command \| Org command \| Emacs, Doom \| Mac \| Doom leader \|
226	\|-----------+---------------------------+---------------+-------+-------------\|	226	\|-----------+---------------------------+---------------+-------+-------------\|
227	\| Set Tags \| =org-set-tags-command= \| =C-c C-q= \| ⌃⌘Q \| =SPC m q= \|	227	\| Set Tags \| =org-set-tags-command= \| =C-c C-q= \| ⌃⌘G \| =SPC m q= \|
228		228
229	=C-c C-c= on a heading line also runs Set Tags, and so does =:= as a speed command.	229	=C-c C-c= on a heading line also runs Set Tags, and so does =:= as a speed command.
230		230

	@@ -27,7 +27,7 @@ Captures can also arrive from a browser through org-protocol, from Shortcuts, an
27		27
28	A capture goes through up to three steps.	28	A capture goes through up to three steps.
29		29
30	1. Choose a template. The window lists your templates with their keys and targets. Press a template's key, or click it.	30	1. Choose a template. The window lists your templates with their keys and targets. Type a template's key, or click it. For a key of several characters, such as =wb=, each character you type narrows the list to the templates whose keys start with what you typed, and the header shows the keys so far (=Capture: w=). =Delete= removes the last key typed. The template is chosen as soon as the keys match one.
31	2. Answer its questions. If the template has prompts (=%^{…}=, =%^g=, =%^t= and the others below), they appear as a form. Leave a field empty for its default. Press Return (Continue) to go on.	31	2. Answer its questions. If the template has prompts (=%^{…}=, =%^g=, =%^t= and the others below), they appear as a form. Leave a field empty for its default. Press Return (Continue) to go on.
32	3. Edit and file. The filled template appears in an editor, headed with the template's name and target, with the cursor where =%?= was. Press =⌘Return= (File It) to file it.	32	3. Edit and file. The filled template appears in an editor, headed with the template's name and target, with the cursor where =%?= was. Press =⌘Return= (File It) to file it.
33		33
	@@ -35,7 +35,7 @@ Press Esc (Cancel) at any step to close the window without filing anything, as =
35		35
36	Filing, the equivalent of =org-capture-finalize=, places the text in its target and saves it through the open buffer if the file is open, or into the file otherwise. A target file that doesn't exist is created, with its folders. The status line in the main window then says where the entry went.	36	Filing, the equivalent of =org-capture-finalize=, places the text in its target and saves it through the open buffer if the file is open, or into the file otherwise. A target file that doesn't exist is created, with its folders. The status line in the main window then says where the entry went.
37		37
38	If filing fails, for example because a heading on an =olp= path is missing, the window stays open with your text, so you can try again after fixing the file or cancel.	38	If filing fails, for example because a heading on an =olp= path is missing, the window stays open with your text and shows the error in red below it, so you can try again after fixing the file or cancel.
39		39
40	Limits compared with Emacs:	40	Limits compared with Emacs:
41		41
	@@ -65,9 +65,9 @@ The file is read each time the capture window opens. If it doesn't exist, or non
65	\| =t= \| Personal todo \| =todo.org=, heading =Inbox= \| =* TODO %?\n%i\n%a= \|	65	\| =t= \| Personal todo \| =todo.org=, heading =Inbox= \| =* TODO %?\n%i\n%a= \|
66	\| =n= \| Personal notes \| =notes.org=, heading =Inbox= \| =* %u %?\n%i\n%a= \|	66	\| =n= \| Personal notes \| =notes.org=, heading =Inbox= \| =* %u %?\n%i\n%a= \|
67		67
68	A problem in the file, such as a table without a key, shows in red under the template list; the other templates still load.	68	A problem in the file, such as a table without a key, shows in red at the bottom of the window; the other templates still load.
69		69
70	Templates are a flat list. A key is matched against a single key press, so a key longer than one character can only be chosen by clicking. Emacs's template groups (an entry with only a key and a description) have no equivalent.	70	Templates are a flat list. Keys of several characters are typed one character at a time, as in Emacs, but Emacs's template groups (an entry with only a key and a description) have no equivalent: the list shows every template whose key starts with what you typed.
71		71
72	** Keys	72	** Keys
73		73
	@@ -295,7 +295,7 @@ The sheet works as on the Mac, in a form:
295	- Prompts appear as fields. Date prompts have a date picker; choices and tags appear as buttons, and tapping a tag adds it.	295	- Prompts appear as fields. Date prompts have a date picker; choices and tags appear as buttons, and tapping a tag adds it.
296	- Continue fills the template and shows the text to edit; File files it; Cancel discards it.	296	- Continue fills the template and shows the text to edit; File files it; Cancel discards it.
297		297
298	Differences from the Mac: there is no selection, clipboard, current file, user name or clock link to insert, so =%i= and =%a= are empty unless the capture came from a link or the share sheet, and =%c=, =%x=, =%f=, =%F=, =%n=, =%k= and =%K= are empty. An org-protocol link naming a template key that doesn't exist opens the sheet on the first template instead of reporting an error.	298	Differences from the Mac: there is no selection, clipboard, current file, user name or clock link to insert, so =%i= and =%a= are empty unless the capture came from a link or the share sheet, and =%c=, =%x=, =%f=, =%F=, =%n=, =%k= and =%K= are empty. An org-protocol link naming a template key that doesn't exist opens the sheet on the first template and shows =No capture template "x"= with the key.
299		299
300	** The share sheet	300	** The share sheet
301		301

Commit d4c76b8503

Commit `d4c76b8503`