From nobody Wed Dec 17 14:06:14 2025 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4dWbF7434Mz6L9qc for ; Wed, 17 Dec 2025 14:06:19 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4dWbF71Vlsz3JCd for ; Wed, 17 Dec 2025 14:06:19 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1765980379; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=nUVr4b9PShpzAz3pqH0IndNeyNyIYyi+gvMFoEgq0Ho=; b=PzWAlDsagVKwdUAMlzvKH5wOFDR+7CFbR3+gZQmRVAlXqRt85QY7YpwyXO3n6R5X6flJEY 6N25AnA4C5LJqSs1GktruUDCSq3Xit1efhPIfqmnr0oDfw918HF+SZd52CjecE5Q55MblQ n6X5dBcsPoXWxKyGnKuYkt/Yj4uS69jmncHGLJ7Gs4D8xM1E4vyNUCJxIf6ZviMGMnNs4b Kuf1iNx4f+o+co38K3DGqv0Iiv8BGjuJScm+VA1eS3GsXu5V1NLEeRZoLFdhzAHs6htwC2 n+Vxlj9j257ZhvMOqRmPMO1Ry0Kz6Cboq186Ya/9hQr0/j11vTwyqO1xnhSIhQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1765980379; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=nUVr4b9PShpzAz3pqH0IndNeyNyIYyi+gvMFoEgq0Ho=; b=FLk2ZdjR/hsqSb6d4kHT1s5txY9Ce/4mnBMhU8sEjPq+0CYi+BxLJIPdJzeekcXRp6Em5n eQiDcdc7IJ5On9gYy/Ho75j+pQkmG8XKI64JJ0Zj8unC+njhAqIebYTewn8GUc7REmBxRg SWD3rURONFnMA03tZydKCfWDEdSs2fTbC5ssX52kqVFl98H2WFFeb0ZPMeZZ8EhKK60ojE EDvHt3rCmkPRKby/BG5mVQ74oWK+qjogTdqxqGQrWk3vTGdxMduvGV9o1BbHRF5zPcsyKP V+owyHWL5ZjzcmFpNjeCgwKNfNGOPCivGCesKKMrq3HPm5TatQfa89TIQwW5IQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1765980379; a=rsa-sha256; cv=none; b=Ko7XFrNqunR4j1EMYgUOm9Ry4juAa2Z+F2EM2AY2RzRbARE05XCFkebwPXAgAfNmjnvIcp I5NYkh2HPu0S+JfsvbyXKDJikVIJbgLiS5NwgVTyNP/uIjY8t1Q5XvfTEzcPd8AUBuY62v bh72hsXfYmtN+/PH9nD8iRMraeLFk4cawEGimA22NsL9Ck2X1XfVJn/WEVZH3g4Eqj44e4 HRxJQDprCAiMIiTXEP9BgrctW1UStOv9dvQp3ozczKjsgeoQu77kpp9t7cp0ZY13bfkY4N 1Cj+MI4CT0IQxb0c65rkpQctGSrWb47m+dNrpFICWyQuJ0bMdpN1XcPEpeFcUQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4dWbF711BRzvds for ; Wed, 17 Dec 2025 14:06:19 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 38ee8 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Wed, 17 Dec 2025 14:06:14 +0000 To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Alexander Ziaee Subject: git: ece699d81a - main - handbook/desktop: Refresh Plasma List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ziaee X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: ece699d81aa16d5780c48139d78bb2ce26802d01 Auto-Submitted: auto-generated Date: Wed, 17 Dec 2025 14:06:14 +0000 Message-Id: <6942b8d6.38ee8.1383914d@gitrepo.freebsd.org> The branch main has been updated by ziaee: URL: https://cgit.FreeBSD.org/doc/commit/?id=ece699d81aa16d5780c48139d78bb2ce26802d01 commit ece699d81aa16d5780c48139d78bb2ce26802d01 Author: Alexander Ziaee AuthorDate: 2025-12-17 14:01:33 +0000 Commit: Alexander Ziaee CommitDate: 2025-12-17 14:06:13 +0000 handbook/desktop: Refresh Plasma I tried running plasma wayland on 15.0, it works great! CPU usage is a tad high, but I'm impressed! Freshen the branding and language in this chapter to highlight this. Remove a stale note about adjusting message sizes to what is now the default. Tell the reader how to search the kde-applications category. Add instructions to launch with wayland. Reviewed by: carlavilla (previous), makc Differential Revision: https://reviews.freebsd.org/D54207 --- .../content/en/books/handbook/desktop/_index.adoc | 71 +++++++++++----------- 1 file changed, 35 insertions(+), 36 deletions(-) diff --git a/documentation/content/en/books/handbook/desktop/_index.adoc b/documentation/content/en/books/handbook/desktop/_index.adoc index 4a9b53263d..9d16eb38bf 100644 --- a/documentation/content/en/books/handbook/desktop/_index.adoc +++ b/documentation/content/en/books/handbook/desktop/_index.adoc @@ -4,7 +4,7 @@ part: Part II. Common Tasks prev: books/handbook/partii next: books/handbook/multimedia description: This chapter demonstrates how to install numerous desktop environments, including web browsers, productivity software, document viewers, and financial software -tags: ["desktop", "KDE Plasma", "GNOME", "XFCE", "MATE", "Cinnamon", "LXQT", "browsers", "Firefox", "Chromium", "Iridium", "Falkon", "Konqueror", "Epiphany", "qutebrowser", "Dillo", "Links", "w3m", "Development tools", "Visual Studio Code", "Qt Creator", "Kdevelop", "Eclipse IDE", "Vim", "Neovim", "GNU Emacs", "Productivity", "LibreOffice", "Calligra", "AbiWord", "Viewers", "Okular", "Evince", "ePDFView", "Xpdf", "Finance", "KMyMoney", "GnuCash"] +tags: ["desktop", "KDE", "Plasma", "GNOME", "XFCE", "MATE", "Cinnamon", "LXQT", "browsers", "Firefox", "Chromium", "Iridium", "Falkon", "Konqueror", "Epiphany", "qutebrowser", "Dillo", "Links", "w3m", "Development tools", "Visual Studio Code", "Qt Creator", "Kdevelop", "Eclipse IDE", "Vim", "Neovim", "GNU Emacs", "Productivity", "LibreOffice", "Calligra", "AbiWord", "Viewers", "Okular", "Evince", "ePDFView", "Xpdf", "Finance", "KMyMoney", "GnuCash"] showBookMenu: true weight: 11 params: @@ -73,7 +73,7 @@ A desktop environment can range from a simple window manager to a complete suite |=== | Name | License | Package -| KDE Plasma +| Plasma | GPL 2.0 or later | package:x11/kde[] @@ -100,27 +100,36 @@ A desktop environment can range from a simple window manager to a complete suite |=== [[kde-environment]] -=== KDE Plasma +=== Plasma -KDE Plasma is an easy-to-use desktop environment. +Plasma is a easy-to-use desktop environment made by the KDE community. This desktop provides a suite of applications with a consistent look and feel, a standardized menu and toolbars, keybindings, color-schemes, internationalization, and a centralized, dialog-driven desktop configuration. -More information on KDE can be found at the link:https://kde.org/[KDE homepage]. + +More information on Plasma can be found at the link:https://kde.org/plasma-desktop[Plasma homepage]. For FreeBSD-specific information, consult the link:https://freebsd.kde.org/[FreeBSD homepage at KDE]. [[kde-meta-install]] -==== Install KDE Plasma meta package +==== Install Plasma meta package -To install the KDE Plasma meta package with KDE Frameworks, Plasma Desktop and Applications execute: +To install the Plasma desktop with a basic set of KDE Applications, execute: [source,shell] .... # pkg install kde .... +Additional KDE Applications are tagged with the `kde-applications` category. +Search for them by executing the following command: + +[source,shell] +.... +% pkg search -S origin kde-applications +.... + [[kde-minimal-install]] -==== Minimal KDE Plasma installation +==== Minimal Plasma installation -To install a minimal KDE Plasma execute: +To install a minimal Plasma desktop, execute: [source,shell] .... @@ -130,7 +139,7 @@ To install a minimal KDE Plasma execute: [TIP] ==== This installation is *really* minimal. -Konsole must be installed separately executing: +The Konsole terminal emulator must be installed separately executing: [source,shell] .... @@ -139,39 +148,22 @@ Konsole must be installed separately executing: ==== [[kde-configuration]] -==== Configure KDE Plasma +==== Configure Plasma -KDE Plasma uses man:dbus-daemon[1] for a message bus and hardware abstraction. -This application is automatically installed as a dependency of KDE Plasma. +Plasma uses man:dbus-daemon[1] for a message bus and hardware abstraction. +This application is automatically installed as a dependency of Plasma. -Enable D-BUS service in `/etc/rc.conf` to start at system boot: +Enable the D-Bus service in man:rc.conf[5] to start at system boot: [source,shell] .... # sysrc dbus_enable="YES" .... -KDE Plasma requires larger message sizes for optimal performance. - -Add the following lines to man:sysctl.conf[5]: - -[.programlisting] -.... -sysctl net.local.stream.recvspace=65536 -sysctl net.local.stream.sendspace=65536 -.... - -To apply the change, either run the following command as root or simply reboot the system: - -[source,shell] -.... -# sysctl -f /etc/sysctl.conf -.... - [[kde-start]] -==== Start KDE Plasma +==== Start Plasma -The preferred KDE Plasma display manager is package:x11/sddm[]. +The preferred way to start Plasma is automatically via the package:x11/sddm[] display manager. To install package:x11/sddm[], execute: [source,shell] @@ -179,21 +171,21 @@ To install package:x11/sddm[], execute: # pkg install sddm .... -Enable SDDM service in `/etc/rc.conf` to start at system boot: +Enable the SDDM service in man:rc.conf[5] to start at system boot: [source,shell] .... # sysrc sddm_enable="YES" .... -The keyboard language can be set in SDDM by running the following command (for Spanish, for example): +A keyboard language, in this case Spanish, can be set in SDDM with the following command: [source,shell] .... # sysrc sddm_lang="es_ES" .... -A second method to start KDE Plasma is by manually invoking man:startx[1]. +Alternatively, start Plasma in an Xorg session is by manually invoking man:startx[1]. For this to work, the following line is needed in ~/.xinitrc: [source,shell] @@ -201,6 +193,13 @@ For this to work, the following line is needed in ~/.xinitrc: % echo "exec dbus-launch --exit-with-x11 ck-launch-session startplasma-x11" > ~/.xinitrc .... +Experimentally, start Plasma manually in a Wayland session by executing the following command: + +[source,shell] +.... +% exec dbus-launch ck-launch-session startplasma-wayland +.... + [[gnome-environment]] === GNOME