Docs: the automation-roots section names the app-folder commands that are confined

The Confining file access bullet said the app's own folders are not
confined. It now names the commands that check the roots for a file
there: the arrowheads edit, reload and list commands, the New Document
profile commands and file.new, and the Scripts folder listing and run,
each linked to its section.
This commit is contained in:
dotCooCoo
2026-11-14 03:15:13 -08:00
parent edb228ac33
commit e04fa72959
+7 -1
View File
@@ -289,7 +289,13 @@ the suite) keep the agent to the folders you give it:
- The preferences that move folders the app reads or writes on its own (`fontsFolder`,
`pluginsFolder`, `recoveryFolder`, `templatesFolder`) can only be set inside the roots. The app's own folders
(preferences, Data Recovery, the User Defined library folders, VectorCraft's Fonts folder) are not
confined: no agent names a path there.
confined. These commands that act on a file there are confined: `stroke.arrowheads.edit` and
`stroke.arrowheads.reload` refuse an arrowheads file outside the read roots, and `stroke.arrowheads.list` gives its
`file` as `null` there (see [Arrowheads](#arrowheads)); `file.newProfiles.edit` needs read and write access to the
New Document profile's file, `file.newProfiles.reset` needs write access, and `file.new` starts with the defaults
when the read roots leave out the profiles folder (see [New Document profiles](#new-document-profiles));
`script.listInstalled` lists the Scripts folder and `ui.runInstalledScript` runs a script only inside a read root
(see [Script engines](#script-engines)).
- The roots must be existing folders; a missing one stops the server with an error. Each flag takes one
folder per use (`--flag <dir>` or `--flag=<dir>`) and may be used again for more.