Skip to content

Commit 311ca6b

Browse files
SempyosYaLTeR
andauthored
Docs: add a few notes and warnings (#2925)
* update docs. * Update Xwayland.md. * Apply suggestion from @YaLTeR --------- Co-authored-by: Ivan Molodetskikh <[email protected]>
1 parent b35bcae commit 311ca6b

File tree

3 files changed

+12
-0
lines changed

3 files changed

+12
-0
lines changed

docs/wiki/Application-Issues.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,12 @@ If you're having issues with some VSCode hotkeys, try starting `Xwayland` and se
2222
That is, still running VSCode with the Wayland backend, but with `DISPLAY` set to a running Xwayland instance.
2323
Apparently, VSCode currently unconditionally queries the X server for a keymap.
2424

25+
### JetBrains IDEs
26+
27+
JetBrains IDEs can run directly on Wayland, but it's not the default.
28+
29+
For JetBrainsRuntime > 17, you can set the flag `-Dawt.toolkit.name=WLToolkit` inside of `help -> edit custom vm options -> add`.
30+
2531
### WezTerm
2632

2733
> [!NOTE]

docs/wiki/Configuration:-Switch-Events.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,9 @@ switch-events {
3939
These events trigger when a convertible laptop goes into or out of tablet mode.
4040
In tablet mode, the keyboard and mouse are usually inaccessible, so you can use these events to activate the on-screen keyboard.
4141

42+
> [!NOTE]
43+
> The commands below are just examples, you will need to provide your own on-screen keyboard, such as [sysboard](https://github.com/System64fumo/sysboard) or [wvkbd](https://github.com/jjsullivan5196/wvkbd).
44+
4245
```kdl
4346
switch-events {
4447
tablet-mode-on { spawn "bash" "-c" "gsettings set org.gnome.desktop.a11y.applications screen-keyboard-enabled true"; }

docs/wiki/Important-Software.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,9 @@ Note that if you're using the provided `resources/niri-portals.conf`, you also n
2626

2727
If you do not want to install `nautilus` (say you use `nemo` instead), you can set `org.freedesktop.impl.portal.FileChooser=gtk;` in `niri-portals.conf` to use the GTK portal for file chooser dialogues.
2828

29+
> [!WARNING]
30+
> Do not set the `GDK_BACKEND` environment variable globally as this will break the screencast portal.
31+
2932
### Authentication Agent
3033

3134
Required when apps need to ask for root permissions. Something like `plasma-polkit-agent` works fine. Start it [with systemd](./Example-systemd-Setup.md) or with [`spawn-at-startup`](./Configuration:-Miscellaneous.md#spawn-at-startup).

0 commit comments

Comments
 (0)