Reorganize top-level directories with clearer naming convention

app -> app-desktop-macos, presets -> app-presets, server -> remote-server, daw-config-reaper -> osc-config-daw, plugin-reaper-realearn -> plugin-reaper-relearn. Updated run.py and presets.py path references accordingly. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-15 17:51:05 -04:00
parent e58f06d9fa
commit 7ecc718f5d
2256 changed files with 11 additions and 5 deletions
@@ -0,0 +1,53 @@
+= Preset section
+
+image:realearn/screenshots/main-panel-preset.png[Screenshot]
+
+== Preset menu
+
+This menu makes it possible to load compartment presets for the currently shown compartment.
+If you select a preset in this list, its corresponding mappings will be loaded and immediately get active.
+
+The following menu entries are available:
+
+[[none-preset]] <None>::
+This entry is selected by default.
+It means that no particular preset is active.
+
+Selecting this will always clear the complete compartment, including all mappings!
+
+Factory:: Contains available xref:further-concepts/compartment.adoc#factory-compartment-preset[factory presets].
+
+User (...):: Contains available xref:further-concepts/compartment.adoc#user-compartment-preset[user presets].
+Multiple of such submenus may exist.
+Each one represents a different preset namespace/workspace.
+The namespace named after you (macOS/Linux/Windows username) is your personal user namespace.
+
+For more information about preset workspaces/namespaces, see
+xref:further-concepts/compartment.adoc#writing-presets-with-luau[].
+
+User (Unsorted)::
+This submenu contains top-level presets which are not part of a particular preset namespace/workspace.
+This was common in older versions of ReaLearn, when namespaces/workspaces were not yet available.
+
+== Save button
+
+If you made changes to a user preset, you can save them by pressing this button.
+
+== Save as… button
+
+This allows you to save all currently visible mappings as a new preset.
+Please choose a descriptive name.
+
+== Delete button
+
+This permanently deletes the currently chosen user preset.
+
+== Auto-load button
+
+Activates or deactivates xref:further-concepts/unit.adoc#auto-load[] mode for this ReaLearn unit.
+This button is only available for the xref:key-concepts.adoc#main-compartment[] because auto-load is only about loading xref:further-concepts/compartment.adoc#main-preset[main presets].
+
+Off:: Disables auto-load mode (the default).
+
+[[auto-load-based-on-unit-fx,Auto-load based on unit FX]] Based on unit FX::
+Switches auto-load mode on, letting ReaLearn decide about which main preset to load depending on the currently active xref:further-concepts/unit.adoc#unit-fx[].