Applications menu for KDE apps in the Steam session

SteamOS only ships /etc/xdg/menus/plasma-applications.menu; the nested
desktop sets XDG_MENU_PREFIX=plasma-, the Steam session doesn't, so KDE
apps started there (Dolphin from the "+" menu) built an empty app
database: "no installed application can open" every file.

session.applicationsMenu (module applications-menu, on by default) links
~/.config/menus/applications.menu to Plasma's menu. Flake check: the link
is generated by default and absent when disabled.

docs/development.md

@@ -50,6 +50,8 @@ modules/
   cleanup/package.nix          build: install.sh as a command (cleanup, steamvr-debugger-arm)
   cleanup/check.nix            test: install.sh cleanup on fake home/runtime dirs
   portal.nix                   Steam session portal config (session.portalFix)
+  applications-menu.nix        applications.menu link for KDE apps (session.applicationsMenu)
+  applications-menu/check.nix  test: the link on by default, absent when disabled
   keyboard-layout.nix          gamescope-session drop-in with XKB_DEFAULT_* (keyboard.layout)
   clipboard-sync.nix           app: KDE autostart of clipboard-sync (clipboardSync)
   hidden-apps.nix              Hidden=true desktop entries (launcherMenu.hiddenApps)

docs/session.md

@@ -1,9 +1,10 @@
 # Session fixes
 
-Four fixes for the Frame's [two graphical sessions](../README.md#two-sessions):
-session settings and services, the portal, the keyboard layout and the
-clipboard. Options: [README, Options](../README.md#options) (`session.*`,
-`keyboard.layout`, `keyboard.variant`, `clipboardSync.*`).
+Five fixes for the Frame's [two graphical sessions](../README.md#two-sessions):
+session settings and services, the portal, the applications menu, the
+keyboard layout and the clipboard. Options:
+[README, Options](../README.md#options) (`session.*`, `keyboard.layout`,
+`keyboard.variant`, `clipboardSync.*`).
 
 ## Session settings and services
 
@@ -55,6 +56,29 @@ desktop's portal is unaffected.
 files plus a config (`default=holo;gamescope`), and a drop-in on
 `xdg-desktop-portal.service`.
 
+## Applications menu
+
+`session.applicationsMenu.enable`, module `applications-menu`. On by default;
+`false` turns it off.
+
+**Problem:** KDE apps build their app database (ksycoca) from
+`applications.menu`, but SteamOS only ships
+`/etc/xdg/menus/plasma-applications.menu`. The nested desktop sets
+`XDG_MENU_PREFIX=plasma-`, the Steam session doesn't: KDE apps started there
+(e.g. Dolphin from the "+" menu) know no apps at all ("no installed
+application can open …").
+
+**What you get:** KDE apps in the Steam session see every installed app,
+Flatpaks included, e.g. for "Open with". The nested desktop is unaffected (it
+reads Plasma's menu through its prefix).
+
+**Remove when** the Steam session sets `XDG_MENU_PREFIX` or SteamOS ships
+`applications.menu`.
+
+**How it works:** `~/.config/menus/applications.menu` is a Home Manager link
+to `/etc/xdg/menus/plasma-applications.menu`. If SteamOS drops that file,
+the link dangles, which is the same as no menu.
+
 ## Keyboard layout
 
 `keyboard.layout`, `keyboard.variant`, module `keyboard-layout`.