aboutsummaryrefslogtreecommitdiff
path: root/documentation/content/en/books/handbook/wayland
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/content/en/books/handbook/wayland')
-rw-r--r--documentation/content/en/books/handbook/wayland/_index.adoc7
-rw-r--r--documentation/content/en/books/handbook/wayland/_index.po282
2 files changed, 145 insertions, 144 deletions
diff --git a/documentation/content/en/books/handbook/wayland/_index.adoc b/documentation/content/en/books/handbook/wayland/_index.adoc
index 48d9e4a4e1..aa402971ff 100644
--- a/documentation/content/en/books/handbook/wayland/_index.adoc
+++ b/documentation/content/en/books/handbook/wayland/_index.adoc
@@ -73,9 +73,10 @@ After reading this chapter, you will know:
[[wayland-overview]]
== Wayland Overview
-Wayland is a new display server, but it differs from Xorg in several important ways.
-First, Wayland is only a protocol that acts as an intermediary between clients using a different mechanism which removes the dependency on an X server.
-Xorg includes both the X11 protocol, used to run remote displays and the X server will accept connections and display windows.
+Wayland is a communication protocol that can replace a display server such as Xorg.
+It differs from Xorg in several important ways.
+First, Wayland is only a protocol that acts as an intermediary between clients using a mechanism which removes the dependency on an X server.
+Xorg includes both the X11 protocol, used to run remote displays, and the X server, used to accept connections and display windows.
Under Wayland, the compositor or window manager provides the display server instead of a traditional X server.
Since Wayland is not an X server, traditional X screen connections will need to utilize other methods such as VNC or RDP for remote desktop management.
diff --git a/documentation/content/en/books/handbook/wayland/_index.po b/documentation/content/en/books/handbook/wayland/_index.po
index cd578b4ea3..934a771112 100644
--- a/documentation/content/en/books/handbook/wayland/_index.po
+++ b/documentation/content/en/books/handbook/wayland/_index.po
@@ -7,7 +7,7 @@
msgid ""
msgstr ""
"Project-Id-Version: FreeBSD Documentation VERSION\n"
-"POT-Creation-Date: 2025-06-29 21:20+0100\n"
+"POT-Creation-Date: 2025-08-17 20:54+0100\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
@@ -105,19 +105,19 @@ msgid "Wayland Overview"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:80
+#: documentation/content/en/books/handbook/wayland/_index.adoc:81
msgid ""
-"Wayland is a new display server, but it differs from Xorg in several "
-"important ways. First, Wayland is only a protocol that acts as an "
-"intermediary between clients using a different mechanism which removes the "
-"dependency on an X server. Xorg includes both the X11 protocol, used to run "
-"remote displays and the X server will accept connections and display "
-"windows. Under Wayland, the compositor or window manager provides the "
-"display server instead of a traditional X server."
+"Wayland is a communication protocol that can replace a display server such "
+"as Xorg. It differs from Xorg in several important ways. First, Wayland is "
+"only a protocol that acts as an intermediary between clients using a "
+"mechanism which removes the dependency on an X server. Xorg includes both "
+"the X11 protocol, used to run remote displays, and the X server, used to "
+"accept connections and display windows. Under Wayland, the compositor or "
+"window manager provides the display server instead of a traditional X server."
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:83
+#: documentation/content/en/books/handbook/wayland/_index.adoc:84
msgid ""
"Since Wayland is not an X server, traditional X screen connections will need "
"to utilize other methods such as VNC or RDP for remote desktop management. "
@@ -127,7 +127,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:87
+#: documentation/content/en/books/handbook/wayland/_index.adoc:88
msgid ""
"Wayland is relatively new, and not all software has been updated to run "
"natively without `Xwayland` support. Because Wayland does not provide the X "
@@ -138,7 +138,7 @@ msgid ""
msgstr ""
#. type: delimited block = 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:92
+#: documentation/content/en/books/handbook/wayland/_index.adoc:93
msgid ""
"The current NVIDIA(R) driver should work with most wlroots compositors, but "
"it may be a little unstable and not support all features at this time. "
@@ -146,7 +146,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:96
+#: documentation/content/en/books/handbook/wayland/_index.adoc:97
msgid ""
"Currently, a lot of software will function with minimal issues on Wayland, "
"including Firefox. And a few desktops are also available, such as the "
@@ -155,7 +155,7 @@ msgid ""
msgstr ""
#. type: delimited block = 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:103
+#: documentation/content/en/books/handbook/wayland/_index.adoc:104
msgid ""
"As of May, 2021, plasma5-kwin does support Wayland on FreeBSD. To use "
"Plasma under Wayland, use the `startplasma-wayland` parameter to `ck-launch-"
@@ -164,7 +164,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:109
+#: documentation/content/en/books/handbook/wayland/_index.adoc:110
msgid ""
"For compositors, a kernel supporting the man:evdev[4] driver must exist to "
"utilize the keybinding functionality. This is built into the "
@@ -175,13 +175,13 @@ msgid ""
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:113
+#: documentation/content/en/books/handbook/wayland/_index.adoc:114
#, no-wrap
msgid "pw groupmod video -m user\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:118
+#: documentation/content/en/books/handbook/wayland/_index.adoc:119
msgid ""
"Installing Wayland is simple; there is not a great deal of configuration for "
"the protocol itself. Most of the composition will depend on the chosen "
@@ -191,7 +191,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:121
+#: documentation/content/en/books/handbook/wayland/_index.adoc:122
msgid ""
"All of the compositors described here should work with package:graphics/drm-"
"kmod[] open source drivers; however, the NVIDIA(R) graphics cards may have "
@@ -200,13 +200,13 @@ msgid ""
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:125
+#: documentation/content/en/books/handbook/wayland/_index.adoc:126
#, no-wrap
msgid "# pkg install wayland seatd\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:132
+#: documentation/content/en/books/handbook/wayland/_index.adoc:133
msgid ""
"Once the protocol and supporting packages have been installed, a compositor "
"must create the user interface. Several compositors will be covered in the "
@@ -217,13 +217,13 @@ msgid ""
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:136
+#: documentation/content/en/books/handbook/wayland/_index.adoc:137
#, no-wrap
msgid "% export XDG_RUNTIME_DIR=/var/run/user/`id -u`\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:141
+#: documentation/content/en/books/handbook/wayland/_index.adoc:142
msgid ""
"It is important to note that most compositors will search the "
"XDG_RUNTIME_DIR directory for the configuration files. In the examples "
@@ -234,7 +234,7 @@ msgid ""
msgstr ""
#. type: delimited block = 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:149
+#: documentation/content/en/books/handbook/wayland/_index.adoc:150
msgid ""
"It has been reported that ZFS users may experience issues with some Wayland "
"clients because they need access to `posix_fallocate()` in the runtime "
@@ -250,7 +250,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:154
+#: documentation/content/en/books/handbook/wayland/_index.adoc:155
msgid ""
"The seatd daemon helps manage access to shared system devices for non-root "
"users in compositors; this includes graphics cards. For traditional X11 "
@@ -261,7 +261,7 @@ msgid ""
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:159
+#: documentation/content/en/books/handbook/wayland/_index.adoc:160
#, no-wrap
msgid ""
"# sysrc seatd_enable=\"YES\"\n"
@@ -269,7 +269,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:163
+#: documentation/content/en/books/handbook/wayland/_index.adoc:164
msgid ""
"Afterward, a compositor, which is similar to an X11 desktop, will need to be "
"installed for the GUI environment. Three are discussed here, including "
@@ -278,13 +278,13 @@ msgid ""
msgstr ""
#. type: Title ==
-#: documentation/content/en/books/handbook/wayland/_index.adoc:165
+#: documentation/content/en/books/handbook/wayland/_index.adoc:166
#, no-wrap
msgid "The Wayfire Compositor"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:170
+#: documentation/content/en/books/handbook/wayland/_index.adoc:171
msgid ""
"Wayfire is a compositor that aims to be lightweight and customizable. "
"Several features are available, and it brings back several elements from the "
@@ -294,13 +294,13 @@ msgid ""
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:174
+#: documentation/content/en/books/handbook/wayland/_index.adoc:175
#, no-wrap
msgid "# pkg install wayfire wf-shell alacritty swaylock-effects swayidle wlogout kanshi mako wlsunset\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:180
+#: documentation/content/en/books/handbook/wayland/_index.adoc:181
msgid ""
"The `alacritty` package provides a terminal emulator. Still, it is not "
"completely required as other terminal emulators such as `kitty`, and XFCE-4 "
@@ -312,7 +312,7 @@ msgid ""
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:185
+#: documentation/content/en/books/handbook/wayland/_index.adoc:186
#, no-wrap
msgid ""
"% mkdir ~/.config/wayfire\n"
@@ -320,7 +320,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:190
+#: documentation/content/en/books/handbook/wayland/_index.adoc:191
msgid ""
"The defaults for most users should be fine. Within the configuration file, "
"items like the famous `cube` are pre-configured, and there are instructions "
@@ -328,7 +328,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:198
+#: documentation/content/en/books/handbook/wayland/_index.adoc:199
#, no-wrap
msgid ""
"[output]\n"
@@ -339,7 +339,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:206
+#: documentation/content/en/books/handbook/wayland/_index.adoc:207
msgid ""
"In this example, from the configuration file, the screen's output should be "
"the listed mode at the listed hertz. For example, the mode should be set to "
@@ -351,7 +351,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:210
+#: documentation/content/en/books/handbook/wayland/_index.adoc:211
msgid ""
"As mentioned, Wayland is new, and not all applications work with the "
"protocol yet. At this time, `sddm` does not appear to support starting and "
@@ -361,25 +361,25 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:212
+#: documentation/content/en/books/handbook/wayland/_index.adoc:213
msgid ""
"This option to define the action to take when the system is idle is listed "
"as:"
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:216
+#: documentation/content/en/books/handbook/wayland/_index.adoc:217
#, no-wrap
msgid "idle = swaylock\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:219
+#: documentation/content/en/books/handbook/wayland/_index.adoc:220
msgid "And the lock timeout is configured using the following lines:"
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:226
+#: documentation/content/en/books/handbook/wayland/_index.adoc:227
#, no-wrap
msgid ""
"[idle]\n"
@@ -389,14 +389,14 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:229
+#: documentation/content/en/books/handbook/wayland/_index.adoc:230
msgid ""
"The first option will lock the screen after 300 seconds, and after another "
"300, the screen will shut off through the `dpms_timeout` option."
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:237
+#: documentation/content/en/books/handbook/wayland/_index.adoc:238
msgid ""
"One final thing to note is the <super> key. Most of the configuration "
"mentions this key, and it is the traditional `Windows` key on the keyboard. "
@@ -412,13 +412,13 @@ msgid ""
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:241
+#: documentation/content/en/books/handbook/wayland/_index.adoc:242
#, no-wrap
msgid "% swaylock --effect-blur 7x5\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:247
+#: documentation/content/en/books/handbook/wayland/_index.adoc:248
msgid ""
"There is also the `--clock` parameter which will display a clock with the "
"date and time on the lock screen. When package:x11/swaylock-effects[] was "
@@ -429,20 +429,20 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:250
+#: documentation/content/en/books/handbook/wayland/_index.adoc:251
msgid ""
"At this point, it is time to test Wayfire and see if it can start up on the "
"system. Just type the following command:"
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:254
+#: documentation/content/en/books/handbook/wayland/_index.adoc:255
#, no-wrap
msgid "% wayfire -c ~/.config/wayfire/wayfire.ini\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:261
+#: documentation/content/en/books/handbook/wayland/_index.adoc:262
msgid ""
"The compositor should now start and display a background image along with a "
"menu bar at the top of the screen. Wayfire will attempt to list installed "
@@ -457,13 +457,13 @@ msgid ""
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:265
+#: documentation/content/en/books/handbook/wayland/_index.adoc:266
#, no-wrap
msgid "% wcm\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:269
+#: documentation/content/en/books/handbook/wayland/_index.adoc:270
msgid ""
"Various Wayfire configuration options, including the composite special "
"effects, maybe enabled, disabled, or configured through this application. "
@@ -472,7 +472,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:275
+#: documentation/content/en/books/handbook/wayland/_index.adoc:276
#, no-wrap
msgid ""
"panel = wf-panel\n"
@@ -481,7 +481,7 @@ msgid ""
msgstr ""
#. type: delimited block = 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:281
+#: documentation/content/en/books/handbook/wayland/_index.adoc:282
msgid ""
"Changes made through `wcm` will overwrite custom changes in the "
"[.filename]#wayfire.ini# configuration file. The [.filename]#wayfire.ini# "
@@ -490,7 +490,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:284
+#: documentation/content/en/books/handbook/wayland/_index.adoc:285
msgid ""
"Finally, the default launcher listed in the [.filename]#wayfire.ini# is "
"package:x11/wf-shell[] which may be replaced with other panels if desired by "
@@ -498,13 +498,13 @@ msgid ""
msgstr ""
#. type: Title ==
-#: documentation/content/en/books/handbook/wayland/_index.adoc:286
+#: documentation/content/en/books/handbook/wayland/_index.adoc:287
#, no-wrap
msgid "The Hikari Compositor"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:296
+#: documentation/content/en/books/handbook/wayland/_index.adoc:297
msgid ""
"The Hikari compositor uses several concepts centered around productivity, "
"such as sheets, workspaces, and more. In that way, it resembles a tiling "
@@ -523,13 +523,13 @@ msgid ""
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:300
+#: documentation/content/en/books/handbook/wayland/_index.adoc:301
#, no-wrap
msgid "# pkg install hikari alacritty\n"
msgstr ""
#. type: delimited block = 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:305
+#: documentation/content/en/books/handbook/wayland/_index.adoc:306
msgid ""
"Other shells, such as `kitty` or the Plasma `Terminal`, will function under "
"Wayland. Users should experiment with their favorite terminal editor to "
@@ -537,7 +537,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:310
+#: documentation/content/en/books/handbook/wayland/_index.adoc:311
msgid ""
"Hikari uses a configuration file, [.filename]#hikari.conf#, which could "
"either be placed in the XDG_RUNTIME_DIR or specified on startup using the `-"
@@ -548,7 +548,7 @@ msgid ""
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:315
+#: documentation/content/en/books/handbook/wayland/_index.adoc:316
#, no-wrap
msgid ""
"% mkdir ~/.config/hikari\n"
@@ -556,7 +556,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:321
+#: documentation/content/en/books/handbook/wayland/_index.adoc:322
msgid ""
"The configuration is broken out into various stanzas such as ui, outputs, "
"layouts, and more. For most users, the defaults will function fine; "
@@ -566,13 +566,13 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:325
+#: documentation/content/en/books/handbook/wayland/_index.adoc:326
#, no-wrap
msgid "terminal = \"/usr/local/bin/alacritty\"\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:333
+#: documentation/content/en/books/handbook/wayland/_index.adoc:334
msgid ""
"Will launch the `alacritty` terminal using the bound key press. While going "
"through the configuration file, it should be noted that the capital letters "
@@ -586,7 +586,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:340
+#: documentation/content/en/books/handbook/wayland/_index.adoc:341
#, no-wrap
msgid ""
"actions {\n"
@@ -596,14 +596,14 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:343
+#: documentation/content/en/books/handbook/wayland/_index.adoc:344
msgid ""
"Then an action may be mapped under the keyboard stanza, which is defined "
"within the bindings stanza:"
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:352
+#: documentation/content/en/books/handbook/wayland/_index.adoc:353
#, no-wrap
msgid ""
"bindings {\n"
@@ -615,7 +615,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:358
+#: documentation/content/en/books/handbook/wayland/_index.adoc:359
msgid ""
"After Hikari is restarted, holding the Windows logo button and pressing the "
"kbd:[b] key on the keyboard will start the web browser. The compositor does "
@@ -628,7 +628,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:365
+#: documentation/content/en/books/handbook/wayland/_index.adoc:366
msgid ""
"Locking the screen in Hikari is easy because a default [.filename]#pam.d# "
"configuration file and unlock utility are bundled with the package. The key "
@@ -641,19 +641,19 @@ msgid ""
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:369
+#: documentation/content/en/books/handbook/wayland/_index.adoc:370
#, no-wrap
msgid "% hikari -c ~/.config/hikari/hikari.conf\n"
msgstr ""
#. type: Title ==
-#: documentation/content/en/books/handbook/wayland/_index.adoc:372
+#: documentation/content/en/books/handbook/wayland/_index.adoc:373
#, no-wrap
msgid "The Sway Compositor"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:376
+#: documentation/content/en/books/handbook/wayland/_index.adoc:377
msgid ""
"The Sway compositor is a tiling compositor that attempts to replace the i3 "
"windows manager. It should work with the user's current i3 configuration; "
@@ -661,7 +661,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:380
+#: documentation/content/en/books/handbook/wayland/_index.adoc:381
msgid ""
"Before starting the Sway installation, ensure that a graphics card (GPU) is "
"installed and configured correctly. Refer to the section crossref:x11[x-"
@@ -670,7 +670,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:383
+#: documentation/content/en/books/handbook/wayland/_index.adoc:384
msgid ""
"In the forthcoming examples, a fresh installation without migrating any i3 "
"configuration will be assumed. To install Sway and valuable components, "
@@ -678,20 +678,20 @@ msgid ""
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:387
+#: documentation/content/en/books/handbook/wayland/_index.adoc:388
#, no-wrap
msgid "# pkg install sway swayidle swaylock-effects alacritty dmenu-wayland dmenu\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:390
+#: documentation/content/en/books/handbook/wayland/_index.adoc:391
msgid ""
"For a basic configuration file, issue the following commands and then edit "
"the configuration file after it is copied:"
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:395
+#: documentation/content/en/books/handbook/wayland/_index.adoc:396
#, no-wrap
msgid ""
"% mkdir ~/.config/sway\n"
@@ -699,14 +699,14 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:399
+#: documentation/content/en/books/handbook/wayland/_index.adoc:400
msgid ""
"The base configuration file has many defaults, which will be fine for most "
"users. Several important changes should be made like the following:"
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:415
+#: documentation/content/en/books/handbook/wayland/_index.adoc:416
#, no-wrap
msgid ""
"# Logo key. Use Mod1 for Alt.\n"
@@ -725,7 +725,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:425
+#: documentation/content/en/books/handbook/wayland/_index.adoc:426
msgid ""
"In the previous example, the `xkb` rules for man:evdev[4] events are loaded, "
"and the $mod key is set to the Windows logo key for the key bindings. Next, "
@@ -743,7 +743,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:433
+#: documentation/content/en/books/handbook/wayland/_index.adoc:434
msgid ""
"While in Sway, to bring up a menu of applications, hold the Windows logo key "
"(mod) and press the kbd:[d] key. The menu may be navigated using the arrow "
@@ -757,7 +757,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:438
+#: documentation/content/en/books/handbook/wayland/_index.adoc:439
#, no-wrap
msgid ""
"# Lock the screen manually\n"
@@ -765,7 +765,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:444
+#: documentation/content/en/books/handbook/wayland/_index.adoc:445
msgid ""
"Now the screen may be locked using the combination of holding the Windows "
"logo key, pressing and holding shift, and finally pressing return. When "
@@ -776,7 +776,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:450
+#: documentation/content/en/books/handbook/wayland/_index.adoc:451
msgid ""
"Finally, to exit Sway and return to the shell, hold the Windows logo key, "
"the shift key, and press the kbd:[e] key. A prompt will be displayed with "
@@ -787,19 +787,19 @@ msgid ""
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:454
+#: documentation/content/en/books/handbook/wayland/_index.adoc:455
#, no-wrap
msgid "% sway -c ~/.config/sway/config\n"
msgstr ""
#. type: Title ==
-#: documentation/content/en/books/handbook/wayland/_index.adoc:457
+#: documentation/content/en/books/handbook/wayland/_index.adoc:458
#, no-wrap
msgid "Using Xwayland"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:461
+#: documentation/content/en/books/handbook/wayland/_index.adoc:462
msgid ""
"When installing Wayland, the `Xwayland` binary should have been installed "
"unless Wayland was built without X11 support. If the [.filename]#/usr/local/"
@@ -807,13 +807,13 @@ msgid ""
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:465
+#: documentation/content/en/books/handbook/wayland/_index.adoc:466
#, no-wrap
msgid "# pkg install xwayland\n"
msgstr ""
#. type: delimited block = 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:471
+#: documentation/content/en/books/handbook/wayland/_index.adoc:472
msgid ""
"The development version of Xwayland is recommended and was most likely "
"installed with the Wayland package. Each compositor has a method of "
@@ -821,7 +821,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:475
+#: documentation/content/en/books/handbook/wayland/_index.adoc:476
msgid ""
"Once `Xwayland` has been installed, configure it within the chosen "
"compositor. For Wayfire, the following line is required in the "
@@ -829,13 +829,13 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:479
+#: documentation/content/en/books/handbook/wayland/_index.adoc:480
#, no-wrap
msgid "xwayland = true\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:483
+#: documentation/content/en/books/handbook/wayland/_index.adoc:484
msgid ""
"For the Sway compositor, `Xwayland` should be enabled by default. Even so, "
"it is recommended to manually add a configuration line in the "
@@ -843,13 +843,13 @@ msgid ""
msgstr ""
#. type: delimited block . 5
-#: documentation/content/en/books/handbook/wayland/_index.adoc:487
+#: documentation/content/en/books/handbook/wayland/_index.adoc:488
#, no-wrap
msgid "xwayland enable\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:492
+#: documentation/content/en/books/handbook/wayland/_index.adoc:493
msgid ""
"Finally, for Hikari, no changes are needed. Support for `Xwayland` is build "
"in by default. To disable that support, rebuild the package from the ports "
@@ -857,7 +857,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:496
+#: documentation/content/en/books/handbook/wayland/_index.adoc:497
msgid ""
"After these changes are made, start the compositor at the command line and "
"execute a terminal from the key bindings. Within this terminal, issue the "
@@ -867,14 +867,14 @@ msgid ""
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:500
-#: documentation/content/en/books/handbook/wayland/_index.adoc:530
+#: documentation/content/en/books/handbook/wayland/_index.adoc:501
+#: documentation/content/en/books/handbook/wayland/_index.adoc:531
#, no-wrap
msgid "% env | grep DISPLAY\n"
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:506
+#: documentation/content/en/books/handbook/wayland/_index.adoc:507
#, no-wrap
msgid ""
"WAYLAND_DISPLAY=wayland-1\n"
@@ -882,7 +882,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:512
+#: documentation/content/en/books/handbook/wayland/_index.adoc:513
msgid ""
"In this output, there is a default Wayland display and a display set for the "
"Xwayland server. Another method to verify that `Xwayland` is functioning "
@@ -894,13 +894,13 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:516
+#: documentation/content/en/books/handbook/wayland/_index.adoc:517
#, no-wrap
msgid "Error: Cannot open display wayland-0\n"
msgstr ""
#. type: delimited block = 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:522
+#: documentation/content/en/books/handbook/wayland/_index.adoc:523
msgid ""
"A security feature of Wayland is that, without running an X server, there is "
"not another network listener. Once `Xwayland` is enabled, this security "
@@ -908,7 +908,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:526
+#: documentation/content/en/books/handbook/wayland/_index.adoc:527
msgid ""
"For some compositors, such as Wayfire, `Xwayland` may not start properly. "
"As such, `env` will show the following information for the `DISPLAY` "
@@ -916,7 +916,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:536
+#: documentation/content/en/books/handbook/wayland/_index.adoc:537
#, no-wrap
msgid ""
"DISPLAY=wayland-1\n"
@@ -924,7 +924,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:541
+#: documentation/content/en/books/handbook/wayland/_index.adoc:542
msgid ""
"Even though `Xwayfire` was installed and configured, X11 applications will "
"not start giving a display issue. To work around this, verify that there is "
@@ -933,18 +933,18 @@ msgid ""
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:545
+#: documentation/content/en/books/handbook/wayland/_index.adoc:546
#, no-wrap
msgid "% sockstat | grep x11\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:548
+#: documentation/content/en/books/handbook/wayland/_index.adoc:549
msgid "There should be something similar to the following information:"
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:556
+#: documentation/content/en/books/handbook/wayland/_index.adoc:557
#, no-wrap
msgid ""
"trhodes Xwayland 2734 8 stream /tmp/.X11-unix/X0\n"
@@ -955,7 +955,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:560
+#: documentation/content/en/books/handbook/wayland/_index.adoc:561
msgid ""
"This suggests the existence of an X11 socket. This can be further verified "
"by attempting to execute `Xwayland` manually within a terminal emulator "
@@ -963,20 +963,20 @@ msgid ""
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:564
+#: documentation/content/en/books/handbook/wayland/_index.adoc:565
#, no-wrap
msgid "% Xwayland\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:567
+#: documentation/content/en/books/handbook/wayland/_index.adoc:568
msgid ""
"If an X11 socket is already available, the following error should be "
"presented to the user:"
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:576
+#: documentation/content/en/books/handbook/wayland/_index.adoc:577
#, no-wrap
msgid ""
"(EE)\n"
@@ -988,7 +988,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:580
+#: documentation/content/en/books/handbook/wayland/_index.adoc:581
msgid ""
"Since there is an active X display available using display zero, the "
"environment variable was just set improperly, to fix this, change the "
@@ -998,26 +998,26 @@ msgid ""
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:584
+#: documentation/content/en/books/handbook/wayland/_index.adoc:585
#, no-wrap
msgid "export DISPLAY=:0\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:587
+#: documentation/content/en/books/handbook/wayland/_index.adoc:588
msgid ""
"After this change, the package:mail/claws-mail[] application should now "
"start using `Xwayland` and function as expected."
msgstr ""
#. type: Title ==
-#: documentation/content/en/books/handbook/wayland/_index.adoc:589
+#: documentation/content/en/books/handbook/wayland/_index.adoc:590
#, no-wrap
msgid "Remote Desktop Using VNC"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:595
+#: documentation/content/en/books/handbook/wayland/_index.adoc:596
msgid ""
"Earlier in this document it was noted that Wayland does not provide the same "
"X server style access as Xorg provides. Instead, users are free to pick and "
@@ -1028,13 +1028,13 @@ msgid ""
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:599
+#: documentation/content/en/books/handbook/wayland/_index.adoc:600
#, no-wrap
msgid "# pkg install wayvnc\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:603
+#: documentation/content/en/books/handbook/wayland/_index.adoc:604
msgid ""
"Unlike some other packages, `wayvnc` does not come with a configuration "
"file. Thankfully, the manual page documents the important options and they "
@@ -1042,7 +1042,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:612
+#: documentation/content/en/books/handbook/wayland/_index.adoc:613
#, no-wrap
msgid ""
"address=0.0.0.0\n"
@@ -1054,7 +1054,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:618
+#: documentation/content/en/books/handbook/wayland/_index.adoc:619
msgid ""
"The key files will need to be generated, and it is highly recommended they "
"be used for increased security of the connection. When invoked, wayvnc will "
@@ -1065,13 +1065,13 @@ msgid ""
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:622
+#: documentation/content/en/books/handbook/wayland/_index.adoc:623
#, no-wrap
msgid "% wayvnc -C ~/.config/wayvnc/config\n"
msgstr ""
#. type: delimited block = 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:629
+#: documentation/content/en/books/handbook/wayland/_index.adoc:630
msgid ""
"At the time of this writing, there is no rc.d script to start `wayvnc` on "
"system initialization. If that functionality is desired, a local startup "
@@ -1080,13 +1080,13 @@ msgid ""
msgstr ""
#. type: Title ==
-#: documentation/content/en/books/handbook/wayland/_index.adoc:632
+#: documentation/content/en/books/handbook/wayland/_index.adoc:633
#, no-wrap
msgid "Wayland Login Manager"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:636
+#: documentation/content/en/books/handbook/wayland/_index.adoc:637
msgid ""
"While several login managers exist and are slowly migrating to Wayland, one "
"option is the package:x11/ly[] text user interface (TUI) manager. Needing "
@@ -1096,20 +1096,20 @@ msgid ""
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:640
+#: documentation/content/en/books/handbook/wayland/_index.adoc:641
#, no-wrap
msgid "# pkg install ly\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:643
+#: documentation/content/en/books/handbook/wayland/_index.adoc:644
msgid ""
"There will be some configuration hints presented, the import steps are to "
"add the following lines to [.filename]#/etc/gettytab#:"
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:649
+#: documentation/content/en/books/handbook/wayland/_index.adoc:650
#, no-wrap
msgid ""
"Ly:\\\n"
@@ -1118,20 +1118,20 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:652
+#: documentation/content/en/books/handbook/wayland/_index.adoc:653
msgid ""
"And then modify the ttyv1 line in [.filename]#/etc/ttys# to match the "
"following line:"
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:656
+#: documentation/content/en/books/handbook/wayland/_index.adoc:657
#, no-wrap
msgid "ttyv1 \"/usr/libexec/getty Ly\" xterm onifexists secure\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:661
+#: documentation/content/en/books/handbook/wayland/_index.adoc:662
msgid ""
"After a system reboot, a login should appear. To configure specific "
"settings, such as language and edit [.filename]#/usr/local/etc/ly/"
@@ -1140,27 +1140,27 @@ msgid ""
msgstr ""
#. type: delimited block = 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:665
+#: documentation/content/en/books/handbook/wayland/_index.adoc:666
msgid ""
"If setting ttyv0 up as the login terminal, it may be required to press the "
"kbd:[alt] and kbd:[F1] keys to properly see the login window."
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:668
+#: documentation/content/en/books/handbook/wayland/_index.adoc:669
msgid ""
"When the login window appears, using the left and right arrows will swap "
"through different, supported, window managers."
msgstr ""
#. type: Title ==
-#: documentation/content/en/books/handbook/wayland/_index.adoc:670
+#: documentation/content/en/books/handbook/wayland/_index.adoc:671
#, no-wrap
msgid "Useful Utilities"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:676
+#: documentation/content/en/books/handbook/wayland/_index.adoc:677
msgid ""
"One useful Wayland utility which all compositors can make use of is the "
"waybar. While Wayfire does come with a launch menu, an easy-to-use and fast "
@@ -1171,20 +1171,20 @@ msgid ""
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:680
+#: documentation/content/en/books/handbook/wayland/_index.adoc:681
#, no-wrap
msgid "# pkg install pavucontrol waybar\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:683
+#: documentation/content/en/books/handbook/wayland/_index.adoc:684
msgid ""
"To create the configuration directory and copy over a default configuration "
"file, execute the following commands:"
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:688
+#: documentation/content/en/books/handbook/wayland/_index.adoc:689
#, no-wrap
msgid ""
"% mkdir ~/.config/waybar\n"
@@ -1192,7 +1192,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:692
+#: documentation/content/en/books/handbook/wayland/_index.adoc:693
msgid ""
"The `lavalauncher` utility provides a launch bar for various applications. "
"There is no example configuration file provided with the package, so the "
@@ -1200,20 +1200,20 @@ msgid ""
msgstr ""
#. type: delimited block - 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:696
+#: documentation/content/en/books/handbook/wayland/_index.adoc:697
#, no-wrap
msgid "mkdir ~/.config/lavalauncher\n"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/handbook/wayland/_index.adoc:699
+#: documentation/content/en/books/handbook/wayland/_index.adoc:700
msgid ""
"An example configuration file that only includes Firefox, and is placed on "
"the right, is below:"
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:705
+#: documentation/content/en/books/handbook/wayland/_index.adoc:706
#, no-wrap
msgid ""
"global-settings {\n"
@@ -1222,7 +1222,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:710
+#: documentation/content/en/books/handbook/wayland/_index.adoc:711
#, no-wrap
msgid ""
"bar {\n"
@@ -1232,7 +1232,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:713
+#: documentation/content/en/books/handbook/wayland/_index.adoc:714
#, no-wrap
msgid ""
"\t# Condition for the default configuration set.\n"
@@ -1240,7 +1240,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:717
+#: documentation/content/en/books/handbook/wayland/_index.adoc:718
#, no-wrap
msgid ""
"\tconfig {\n"
@@ -1249,7 +1249,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/handbook/wayland/_index.adoc:726
+#: documentation/content/en/books/handbook/wayland/_index.adoc:727
#, no-wrap
msgid ""
"\tbutton {\n"