I'm testing out Plasma 6 on a fresh installation and I think there are a
few workarouds and notes worth adding to the pkg readme.
- Move screen locking to its own section and mention xlock as an
alternative
- Mention about increasing resource limits, the default login class is
too conservative and most plasma widgets would keep crashing
- Mention about touchscreen calibration
Please help me bump the right REVISION if needed.
diff --git a/meta/kde/pkg/README-plasma b/meta/kde/pkg/README-plasma
index bb5e9fd5ce3..51775a2c534 100644
--- a/meta/kde/pkg/README-plasma
+++ b/meta/kde/pkg/README-plasma
@@ -20,6 +20,26 @@ export XDG_CURRENT_DESKTOP=KDE
export DESKTOP_SESSION=plasma
${LOCALBASE}/bin/startplasma-x11 > ~/.startplasma-x11.log 2>&1
+Screen locking
+==============
+You can't unlock your session when the screensaver has locked it. I get the
+graphical message "Something wrong happened. Run # ck-unlock-session ...".
+So you will end up with a freezen session that you have to completely kill.
+
+As a workaround, you can disable the default screensaver via:
+ System Settings -> Security & Privacy -> Screen Locking
+then uncheck lock after waking from sleep and set locking interval to never
+
+Alternatively, xlock(1) works well with KDE, to bind it to a shortcut:
+ System Settings -> Keyboard -> Shortcuts
+
+Resource limits
+===============
+The default resource limits are too conservative for KDE Plasma. To raise your
+resource limits, increase the limits for your user's class in /etc/login.conf,
+then login again to apply. KDE widgets (such as Launchers) keep crashing can
+be a sign of insufficient resource limits.
+
Logging out and shutting down the computer
==========================================
If your user is part of the _shutdown group and thus can execute shutdown(8),
@@ -58,6 +78,12 @@ It is also possible to use a window manager other than KWin
with Plasma.
export KDEWM=${LOCALBASE}/bin/picom
+Touch screen calibration
+========================
+xtsscale(1) can be used for touch screen calibration, however it will not
+work under kwin, as a workaround, you can kill kwin first, calibrate your
+screen, then launch kwin_x11 again.
+
Desktop search
==============
Baloo file indexer is disabled by default on OpenBSD. To enable it go to
@@ -89,11 +115,10 @@ ${LOCALBASE}/bin/ck-launch-session dbus-run-session \
Known issues
============
-- You can't unlock your session when the screensaver has locked it. I get the
- graphical message "Something wrong happened. Run # ck-unlock-session ...".
- So you will end up with a freezen session that you have to completely kill.
- **It is recommended to disable KDE screen locking** for now.
+- The default screensaver does not work, see Screen Locking section for
+ workaround.
- The first start may take a little longer.
+- Touchscreen configuration does not work
- The sound mixer Kmix works only on the main channel.
Not yet ported Plasma applications/plugins
