krz/orgstar

A native macOS editor for org-mode files. editor org-mode swift

guide/15-alongside-emacs.html

pages
orgstar/guide/15-alongside-emacs.html history · blame · raw

270 lines · 25693 bytes

  1<!DOCTYPE html>
  2<html lang="en">
  3<head>
  4<meta charset="utf-8">
  5<meta name="viewport" content="width=device-width, initial-scale=1">
  6<title>Working alongside Emacs and other tools &middot; Orgstar</title>
  7<meta name="description" content="How Orgstar reads and writes files shared with Emacs and sync tools, merges outside changes, keeps recovery versions, calls Emacs, and differs from…">
  8<link rel="icon" href="../favicon.svg" type="image/svg+xml">
  9<link rel="stylesheet" href="../theme.css">
 10<link rel="stylesheet" href="../syntax.css">
 11<link rel="stylesheet" href="../style.css">
 12</head>
 13<body>
 14<header class="site">
 15<a class="site-title" href="../index.html">Orgstar</a>
 16<nav>
 17<a href="../install.html">Install</a>
 18<a href="../quickstart.html">Quick start</a>
 19<a href="index.html">Manual</a>
 20</nav>
 21</header>
 22<main>
 23<h1>Working alongside Emacs and other tools</h1>
 24<p class="lede">Orgstar works on plain org files in ordinary folders, so Emacs, other apps and sync tools can work on the same files.</p>
 25<nav class="toc" aria-label="On this page">
 26<h2>On this page</h2>
 27<ul>
 28<li><a href="#how-orgstar-treats-files">How Orgstar treats files</a>
 29<ul>
 30<li><a href="#bytes-on-disk">Bytes on disk</a></li>
 31<li><a href="#encodings">Encodings</a></li>
 32<li><a href="#how-a-save-works">How a save works</a></li>
 33<li><a href="#automatic-and-explicit-saving">Automatic and explicit saving</a></li>
 34</ul></li>
 35<li><a href="#changes-made-outside-orgstar">Changes made outside Orgstar</a>
 36<ul>
 37<li><a href="#the-conflict-sheet">The conflict sheet</a></li>
 38</ul></li>
 39<li><a href="#sync-tools">Sync tools</a>
 40<ul>
 41<li><a href="#icloud-drive">iCloud Drive</a></li>
 42<li><a href="#syncthing">Syncthing</a></li>
 43<li><a href="#dropbox-and-other-tools">Dropbox and other tools</a></li>
 44<li><a href="#files-orgstar-ignores">Files Orgstar ignores</a></li>
 45</ul></li>
 46<li><a href="#recovery-versions">Recovery versions</a></li>
 47<li><a href="#features-that-use-emacs-on-the-mac">Features that use Emacs on the Mac</a>
 48<ul>
 49<li><a href="#how-emacs-is-found">How Emacs is found</a></li>
 50<li><a href="#what-emacs-sees">What Emacs sees</a></li>
 51</ul></li>
 52<li><a href="#quick-look">Quick Look</a></li>
 53<li><a href="#spotlight">Spotlight</a></li>
 54<li><a href="#finder">Finder</a></li>
 55<li><a href="#org-protocol-and-shortcuts">org-protocol and Shortcuts</a></li>
 56<li><a href="#compatibility-notes">Compatibility notes</a>
 57<ul>
 58<li><a href="#defaults-that-differ-from-emacs">Defaults that differ from Emacs</a></li>
 59<li><a href="#known-differences-from-emacs-org">Known differences from Emacs Org</a></li>
 60</ul></li>
 61</ul>
 62</nav>
 63<h2 id="how-orgstar-treats-files">How Orgstar treats files</h2>
 64<h3 id="bytes-on-disk">Bytes on disk</h3>
 65<p>Orgstar edits the file's text directly; there is no separate document format. When it saves, text you didn't change is written back exactly as it was read:</p>
 66<ul>
 67<li>A file with no changes is never rewritten.</li>
 68<li>Untouched lines keep their bytes, including trailing whitespace, tabs, and the presence or absence of a final newline.</li>
 69<li>Line endings are kept as they are. A file with CRLF line endings keeps them, and on the Mac the modeline shows <code class="verbatim">CRLF</code> for such a file. Orgstar doesn't convert line endings; new lines that Orgstar's commands insert end with LF.</li>
 70</ul>
 71<h3 id="encodings">Encodings</h3>
 72<p>Orgstar edits UTF-8 files, with or without a byte order mark. A file that starts with a BOM keeps it.</p>
 73<p>A file that isn't valid UTF-8 (UTF-16, Latin-1, or a file with invalid bytes) opens read-only. The window's subtitle says "Read-only: not UTF-8", undecodable bytes show as replacement characters, and commands that would change the file report that it "isn't UTF-8, so it can't be changed". Orgstar never converts such a file.</p>
 74<h3 id="how-a-save-works">How a save works</h3>
 75<p>Saving replaces the file through a temporary file in the same folder (named <code class="verbatim">.name.org.orgstar-…</code>), under the system's file coordination, so iCloud and other coordinating apps see a complete file. The steps are:</p>
 76<ol>
 77<li>Read the file on disk. If it changed since Orgstar last read or wrote it, keep both versions in the recovery folder and merge the change into your edits (see below).</li>
 78<li>Read the file again. If it changed in the meantime, start over, up to three times.</li>
 79<li>Replace the file. If another program replaced it between the check and the write, its version goes to the recovery folder and is merged into your edits.</li>
 80<li>Read the file back. If it changed right after the write, Orgstar's version goes to the recovery folder and the new disk version is merged in.</li>
 81</ol>
 82<p>Emacs and Syncthing don't use file coordination, so these checks can't lock them out. They narrow the window in which two writers can collide, and every version a save displaces is kept in the recovery folder.</p>
 83<p>If the file keeps changing through all three attempts, the save fails with an error and your edits stay unsaved.</p>
 84<h3 id="automatic-and-explicit-saving">Automatic and explicit saving</h3>
 85<p>With <code class="verbatim">save = "automatic"</code> (the default), Orgstar saves a file one second after you stop typing. With <code class="verbatim">"explicit"</code>, only <code class="verbatim">⌘S</code> (Save) and <code class="verbatim">⌥⌘S</code> (Save All) save. See <a href="13-configuration.html">Configuration</a>. The iOS app always saves automatically.</p>
 86<h2 id="changes-made-outside-orgstar">Changes made outside Orgstar</h2>
 87<p>Orgstar watches your folders. On the Mac it uses FSEvents; on iOS it is told of changes by file coordination and reads the folders again when you return to the app. When a file that is open in Orgstar changes on disk:</p>
 88<ul>
 89<li>If you have no unsaved edits in it, Orgstar reloads it. Undo history for the file is cleared.</li>
 90<li>If you have unsaved edits, Orgstar merges the disk version into them and saves the result.</li>
 91<li>If the changes conflict, nothing is saved and the conflict sheet opens.</li>
 92</ul>
 93<p>The merge is a line-based three-way merge between the version Orgstar last read or wrote, your edits, and the disk version. A run of lines changed on one side only takes that side; changed the same way on both, it is taken once; changed differently on both, it is a conflict. Lines keep their endings, so CRLF files and a missing final newline survive a merge. A disk version that isn't valid UTF-8 always conflicts.</p>
 94<p>After a reload or merge, Orgstar also reads the file's setup files again.</p>
 95<h3 id="the-conflict-sheet">The conflict sheet</h3>
 96<p>The sheet shows what differs, with lines marked - on disk and + in your version, and offers:</p>
 97<table>
 98<thead>
 99<tr><th>Button</th><th>Effect</th></tr>
100</thead>
101<tbody>
102<tr><td>Keep Mine</td><td>Writes your version over the disk version. The disk version goes to the recovery folder.</td></tr>
103<tr><td>Use Disk Version</td><td>Loads the disk version. Your version goes to the recovery folder.</td></tr>
104<tr><td>Merge with Markers</td><td>Puts both sets of changes in the buffer, with conflicting lines between <code class="verbatim">&lt;&lt;&lt;&lt;&lt;&lt;&lt; yours</code> and <code class="verbatim">&gt;&gt;&gt;&gt;&gt;&gt;&gt; disk</code> markers, as <code class="verbatim">git merge</code> leaves them. Edit and save. Your version as it was goes to the recovery folder.</td></tr>
105<tr><td>Decide Later</td><td>Closes the sheet. Automatic saving stops for the file until you decide; the Conflict button in the toolbar opens the sheet again.</td></tr>
106</tbody>
107</table>
108<p>On the Mac, Revert to File on Disk (in the command palette) loads the disk version at any time; unsaved changes go to the recovery folder.</p>
109<h2 id="sync-tools">Sync tools</h2>
110<h3 id="icloud-drive">iCloud Drive</h3>
111<p>Orgstar reads and writes files under file coordination, which is how iCloud expects apps to work. Files iCloud hasn't downloaded yet (<code class="verbatim">.name.org.icloud</code> placeholders) aren't indexed; Orgstar asks iCloud to download them and indexes them when they arrive. On iOS they appear in the Folders tab with a cloud icon until then.</p>
112<h3 id="syncthing">Syncthing</h3>
113<p>Syncthing writes files without file coordination. Orgstar sees its changes through file watching and merges them as described above.</p>
114<ul>
115<li>Syncthing's temporary files (<code class="verbatim">.syncthing.*</code>) are ignored.</li>
116<li>Its folders <code class="verbatim">.stfolder</code> and <code class="verbatim">.stversions</code> are in the default <code class="verbatim">ignored-folders</code>.</li>
117<li>Conflict copies (<code class="verbatim">name.sync-conflict-YYYYMMDD-HHMMSS-ID.org</code>) are listed in the sidebar but never indexed, so they don't appear in the agenda, search or ID links.</li>
118</ul>
119<p>When a file with conflict copies opens, a message says how many there are. Resolve Sync Conflicts… in the command palette (More ▸ Sync Conflict Copies on iOS) lists each copy against the file, with lines marked - in the file and + in the copy:</p>
120<table>
121<thead>
122<tr><th>Button</th><th>Effect</th></tr>
123</thead>
124<tbody>
125<tr><td>Keep File</td><td>Leaves the file as it is.</td></tr>
126<tr><td>Use Copy</td><td>Replaces the buffer's text with the copy's, as an edit you can undo.</td></tr>
127<tr><td>Merge with Markers</td><td>Puts every difference between the file and the copy between conflict markers in the buffer. There is no common base, so every difference is marked.</td></tr>
128</tbody>
129</table>
130<p>Each choice then moves the copy to the recovery folder and deletes it from the folder.</p>
131<h3 id="dropbox-and-other-tools">Dropbox and other tools</h3>
132<p>Any program that writes files in your folders is treated the same way: Orgstar sees the change, reloads or merges, and keeps displaced versions. Programs that write through file coordination (iCloud, File Provider apps on iOS) are seen as they write; others are seen through FSEvents on the Mac and when you return to the app on iOS.</p>
133<h3 id="files-orgstar-ignores">Files Orgstar ignores</h3>
134<p>When scanning folders, Orgstar skips Emacs lock files (<code class="verbatim">.#name</code>), backups (<code class="verbatim">name~</code>) and auto-save files (<code class="verbatim">#name#</code>), its own temporary and backup files (names containing <code class="verbatim">.orgstar-</code>), <code class="verbatim">.DS_Store</code>, <code class="verbatim">.localized</code>, and the folders in <code class="verbatim">ignored-folders</code>. With <code class="verbatim">show-hidden-files = false</code>, every dotfile and dot folder is skipped. Orgstar doesn't create or honour Emacs lock files.</p>
135<h2 id="recovery-versions">Recovery versions</h2>
136<p>Every version a save, a merge or a conflict resolution displaces is kept in the recovery folder:</p>
137<ul>
138<li>on the Mac, <code class="verbatim">~/Library/Application Support/Orgstar/Recovery</code> (or <code class="verbatim">$ORGSTAR_DATA_DIR/Recovery</code>),</li>
139<li>on iOS, the app's own Application Support folder.</li>
140</ul>
141<p>Each file has a subfolder named from a hash of its path, holding its last 20 kept versions. A version's file name has a timestamp, a label and the file's name. The labels are:</p>
142<table>
143<thead>
144<tr><th>Label</th><th>Kept when</th></tr>
145</thead>
146<tbody>
147<tr><td><code class="verbatim">external</code></td><td>A version written by another program was replaced or merged</td></tr>
148<tr><td><code class="verbatim">local</code></td><td>Orgstar's version was replaced, or set aside by Use Disk Version, Merge with Markers or Restore</td></tr>
149<tr><td><code class="verbatim">sync-conflict</code></td><td>A Syncthing conflict copy was resolved</td></tr>
150</tbody>
151</table>
152<p>Recovery Versions… in the command palette (More ▸ Recovered Versions on iOS) lists the open file's kept versions, newest first, each compared with the buffer (lines marked - in the buffer, + in the kept version). Restore puts a version's text in the buffer as an edit you can undo; the buffer as it was goes to the recovery folder first. On the Mac, Show in Finder selects the version's file.</p>
153<h2 id="features-that-use-emacs-on-the-mac">Features that use Emacs on the Mac</h2>
154<p>Some features run Emacs in batch mode on the Mac. Everything else works without Emacs installed.</p>
155<table>
156<thead>
157<tr><th>Feature</th><th>What runs</th></tr>
158</thead>
159<tbody>
160<tr><td>Emacs Lisp source blocks (<code class="verbatim">emacs-lisp</code>, <code class="verbatim">elisp</code>)</td><td>The block, in <code class="verbatim">emacs -Q --batch</code></td></tr>
161<tr><td>Table formulas outside what Orgstar computes itself</td><td><code class="verbatim">org-table-recalculate</code> on a copy of the file; the table's new text replaces the old one if the table didn't change meanwhile</td></tr>
162<tr><td>Lisp table formulas that Orgstar's Emacs Lisp interpreter can't evaluate</td><td>The same; Orgstar first asks whether to run Lisp (yes, no, always)</td></tr>
163<tr><td>Export to PDF, ODT, LaTeX and plain text</td><td><code class="verbatim">org-latex-export-to-pdf</code>, <code class="verbatim">org-odt-export-to-odt</code>, <code class="verbatim">org-latex-export-to-latex</code> or <code class="verbatim">org-ascii-export-to-ascii</code></td></tr>
164</tbody>
165</table>
166<p>HTML and Markdown export don't use Emacs. See <a href="11-code-blocks.html">Code blocks</a>, <a href="10-tables.html">Tables</a> and <a href="12-export.html">Export</a>.</p>
167<h3 id="how-emacs-is-found">How Emacs is found</h3>
168<p>Orgstar uses the first of these that is an executable file:</p>
169<ol>
170<li>the path in the environment variable <code class="verbatim">ORGSTAR_EMACS</code>,</li>
171<li><code class="verbatim">/opt/homebrew/bin/emacs</code>,</li>
172<li><code class="verbatim">/usr/local/bin/emacs</code>,</li>
173<li><code class="verbatim">/Applications/Emacs.app/Contents/MacOS/Emacs</code>,</li>
174<li><code class="verbatim">/run/current-system/sw/bin/emacs</code>,</li>
175<li><code class="verbatim">/usr/bin/emacs</code>.</li>
176</ol>
177<p>An app started from the Dock doesn't see your shell's <code class="verbatim">PATH</code>, which is why Orgstar looks in fixed places. Without Emacs, these features report "Emacs isn't installed, so …" and change nothing.</p>
178<h3 id="what-emacs-sees">What Emacs sees</h3>
179<ul>
180<li>Emacs runs with <code class="verbatim">-Q</code>: your <code class="verbatim">init.el</code>, packages and customizations aren't loaded. Org and the exporters are the versions bundled with that Emacs.</li>
181<li>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.</li>
182<li>File-local variables marked safe apply (<code class="verbatim">enable-local-variables</code> is <code class="verbatim">:safe</code>).</li>
183<li>Export doesn't run source blocks (<code class="verbatim">org-export-use-babel</code> is <code class="verbatim">nil</code>). The exported file is written next to the org file, as Emacs writes it, or moved to the place you chose.</li>
184<li>For export and table recalculation, Emacs gets your <code class="verbatim">PATH</code> with <code class="verbatim">/opt/homebrew/bin</code>, <code class="verbatim">/usr/local/bin</code>, <code class="verbatim">/Library/TeX/texbin</code>, <code class="verbatim">/usr/bin</code> and <code class="verbatim">/bin</code> added, as source blocks do, so the programs it starts, such as <code class="verbatim">pdflatex</code>, are found when Orgstar was opened from the Dock.</li>
185<li>PDF export needs a LaTeX installation that Org's LaTeX exporter can run.</li>
186<li>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. <code class="verbatim">⌘.</code> (Cancel Running Task) stops a running block, export or table recalculation sooner.</li>
187</ul>
188<h2 id="quick-look">Quick Look</h2>
189<p>Orgstar includes a Quick Look extension for org files (<code class="verbatim">.org</code> and <code class="verbatim">.org_archive</code>). Pressing Space on an org file in Finder, or in the Files app on iOS, shows the file as the HTML export renders it, with its <code class="verbatim">#+SETUPFILE</code> keywords applied. The preview reads only UTF-8 files.</p>
190<p>Inside Orgstar, selecting a file in the sidebar that isn't text shows a Quick Look preview, with Open with Default App and Show in Finder below it.</p>
191<h2 id="spotlight">Spotlight</h2>
192<p>On the Mac, Orgstar includes a Spotlight importer for org files. Spotlight indexes each file's text, its title (<code class="verbatim">#+TITLE</code>, else the file name), <code class="verbatim">#+AUTHOR</code>, <code class="verbatim">#+DESCRIPTION</code>, and its tags (<code class="verbatim">#+FILETAGS</code> and heading tags) and headings as keywords. The importer reads only UTF-8 files.</p>
193<p>On iOS, the app adds the files in your folders to Spotlight itself; see <a href="14-ios.html">iPhone and iPad</a>.</p>
194<h2 id="finder">Finder</h2>
195<p>Orgstar declares the <code class="verbatim">org.orgmode.org</code> file type for the extensions <code class="verbatim">.org</code> and <code class="verbatim">.org_archive</code>, and registers as an editor for it, and as an alternate editor for plain text. Double-clicking an org file in Finder, dropping files on Orgstar's Dock icon, or running <code class="verbatim">open -a Orgstar file.org</code> opens each file as a buffer. Files opened while Orgstar is starting open once its window is ready. To make Orgstar the app that opens org files, use Finder's Get Info ▸ Open with ▸ Change All.</p>
196<h2 id="org-protocol-and-shortcuts">org-protocol and Shortcuts</h2>
197<p>Orgstar registers the <code class="verbatim">org-protocol:</code> URL scheme on the Mac and iOS, and handles two sub-protocols, in both the <code class="verbatim">?key=value</code> form and the older <code class="verbatim">:/a/b/c</code> form:</p>
198<ul>
199<li><code class="verbatim">org-protocol://capture</code> opens Capture with the link's template, URL, title and body.</li>
200<li><code class="verbatim">org-protocol://store-link</code> stores the link for <code class="verbatim">C-c C-l</code> and copies it to the clipboard. This is Mac only; the iOS app handles only <code class="verbatim">capture</code>.</li>
201</ul>
202<p>Other sub-protocols, such as <code class="verbatim">open-source</code>, show "Orgstar handles org-protocol capture and store-link".</p>
203<p>The Shortcuts action Capture to Orgstar, on the Mac and iOS, files text with a capture template without opening the capture window. See <a href="08-capture.html">Capture</a>.</p>
204<h2 id="compatibility-notes">Compatibility notes</h2>
205<h3 id="defaults-that-differ-from-emacs">Defaults that differ from Emacs</h3>
206<p>Orgstar's defaults follow a common Doom Emacs setup rather than plain Emacs in several places. If you use plain Emacs on the same files, set these in <code class="verbatim">config.toml</code> to match your Emacs, or use Import from Emacs; see <a href="13-configuration.html">Configuration</a>.</p>
207<table>
208<thead>
209<tr><th>Setting</th><th>Orgstar default</th><th>Plain Emacs default</th></tr>
210</thead>
211<tbody>
212<tr><td><code class="verbatim">fill-column</code></td><td>80</td><td>70</td></tr>
213<tr><td><code class="verbatim">org-todo-keywords</code></td><td><code class="verbatim">TODO PROJ LOOP STRT WAIT HOLD IDEA</code>, done <code class="verbatim">DONE KILL</code></td><td><code class="verbatim">TODO</code>, done <code class="verbatim">DONE</code></td></tr>
214<tr><td><code class="verbatim">org-insert-heading-respect-content</code></td><td><code class="verbatim">true</code></td><td><code class="verbatim">nil</code></td></tr>
215<tr><td><code class="verbatim">org-M-RET-may-split-line</code></td><td><code class="verbatim">false</code></td><td><code class="verbatim">t</code></td></tr>
216<tr><td><code class="verbatim">org-list-allow-alphabetical</code></td><td><code class="verbatim">true</code></td><td><code class="verbatim">nil</code></td></tr>
217<tr><td><code class="verbatim">org-hide-emphasis-markers</code></td><td><code class="verbatim">true</code></td><td><code class="verbatim">nil</code></td></tr>
218<tr><td><code class="verbatim">org-pretty-entities</code></td><td><code class="verbatim">true</code></td><td><code class="verbatim">nil</code></td></tr>
219<tr><td><code class="verbatim">org-startup-indented</code></td><td><code class="verbatim">true</code></td><td><code class="verbatim">nil</code></td></tr>
220<tr><td><code class="verbatim">org-startup-truncated</code></td><td><code class="verbatim">false</code></td><td><code class="verbatim">t</code></td></tr>
221<tr><td><code class="verbatim">electric-pair-mode</code></td><td><code class="verbatim">true</code></td><td>off</td></tr>
222<tr><td><code class="verbatim">org-agenda-span</code></td><td>10 days</td><td>a week</td></tr>
223<tr><td><code class="verbatim">org-agenda-start-day</code></td><td><code class="verbatim">"-3d"</code></td><td>today</td></tr>
224</tbody>
225</table>
226<p><code class="verbatim">org-hide-emphasis-markers</code> and <code class="verbatim">org-pretty-entities</code> matter for files you also edit in Emacs: Orgstar aligns tags and tables, and fills paragraphs, by the width text has on screen in your Emacs. If they don't match your Emacs, tags and tables that Orgstar aligns look misaligned in Emacs.</p>
227<p>These behave as Emacs's defaults and can't be changed: <code class="verbatim">org-log-repeat</code> is <code class="verbatim">time</code>, fast TODO selection is on when keywords have keys, priorities are <code class="verbatim">A</code> to <code class="verbatim">C</code> with <code class="verbatim">B</code> as default unless <code class="verbatim">#+PRIORITIES</code> says otherwise, and <code class="verbatim">org-use-sub-superscripts</code> is <code class="verbatim">{}</code> for display (only <code class="verbatim">x_{1}</code> and <code class="verbatim">x^{2}</code> are lowered and raised).</p>
228<h3 id="known-differences-from-emacs-org">Known differences from Emacs Org</h3>
229<p>Orgstar refuses some things with a message rather than doing something different from Emacs. These are the ones found in the current version.</p>
230<p>Code blocks (see <a href="11-code-blocks.html">Code blocks</a>):</p>
231<ul>
232<li><code class="verbatim">:cmdline</code> is supported only for shells, <code class="verbatim">dot</code>, <code class="verbatim">plantuml</code> and <code class="verbatim">mermaid</code>.</li>
233<li><code class="verbatim">:prologue</code>, <code class="verbatim">:epilogue</code> and <code class="verbatim">:post</code> aren't supported; <code class="verbatim">:stdin</code> and <code class="verbatim">:shebang</code> only for shells.</li>
234<li><code class="verbatim">:session</code> is supported only for shells and Python.</li>
235<li><code class="verbatim">:var</code> isn't supported for some languages; references with arguments, as <code class="verbatim">block(x=1)</code>, and using another source block's result in <code class="verbatim">:var</code> aren't supported.</li>
236<li>Header arguments, <code class="verbatim">:var</code> values and <code class="verbatim">:cache</code> that need Lisp evaluated by Emacs are refused when Orgstar's interpreter can't evaluate them: "… is Lisp that only Emacs can evaluate; nothing was run."</li>
237<li>Noweb references that run a block aren't supported.</li>
238<li>Tangling refuses <code class="verbatim">:var</code> that would run a block, and tables and lists in <code class="verbatim">:var</code> for some languages.</li>
239<li>On iOS, only Emacs Lisp blocks run.</li>
240</ul>
241<p>Links (see <a href="09-links.html">Links</a>):</p>
242<ul>
243<li>Coderef links (<code class="verbatim">[[(ref)]]</code>) and regexp search links (<code class="verbatim">[[/regexp/]]</code>) aren't supported.</li>
244<li><code class="verbatim">shell:</code> and <code class="verbatim">elisp:</code> links aren't run.</li>
245</ul>
246<p>Capture templates (see <a href="08-capture.html">Capture</a>):</p>
247<ul>
248<li><code class="verbatim">%(</code> escapes, which run Emacs Lisp, aren't supported.</li>
249<li><code class="verbatim">%[file]</code> escapes aren't supported.</li>
250</ul>
251<p>Tables and dynamic blocks (see <a href="10-tables.html">Tables</a> and <a href="06-dates-and-clocking.html">Dates and clocking</a>):</p>
252<ul>
253<li>Formulas outside Orgstar's own calculator go to Emacs on the Mac and are refused on iOS.</li>
254<li>Clock tables support the scopes <code class="verbatim">nil</code>, <code class="verbatim">file</code>, <code class="verbatim">subtree</code> and <code class="verbatim">treeN</code>; other scopes, <code class="verbatim">:match</code> and <code class="verbatim">:step</code> aren't supported.</li>
255<li>Dynamic blocks other than <code class="verbatim">clocktable</code> and <code class="verbatim">columnview</code> aren't supported. Column views of other files aren't supported.</li>
256</ul>
257<p>Other:</p>
258<ul>
259<li><code class="verbatim">C-c C-q</code> before the first heading (setting file tags) isn't supported.</li>
260<li>Priority ranges that aren't letters or numbers are refused.</li>
261<li><code class="verbatim">#+SETUPFILE</code> URLs aren't fetched.</li>
262<li>Most <code class="verbatim">#+STARTUP</code> options for footnotes, entities, LaTeX previews, numbering and odd levels are accepted and ignored; see <a href="13-configuration.html">Configuration</a>.</li>
263<li><code class="verbatim">display-line-numbers-type</code> has no relative or visual mode.</li>
264</ul>
265</main>
266<footer class="site">
267Orgstar is 0BSD-licensed. Source: <a href="https://gitbay.org/krz/orgstar">gitbay.org/krz/orgstar</a>.
268</footer>
269</body>
270</html>