From nobody Fri Sep 26 10:32:49 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 4cY6Nd74B6z686Jy for ; Fri, 26 Sep 2025 10:32:49 +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 4cY6Nd6JmFz3JZV; Fri, 26 Sep 2025 10:32:49 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1758882769; 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=7BA+am8UDaQIpenu9joAOiF59FbjTZrcb+TK2967CWQ=; b=hjX/daxoPWTUpSqym4DwaUWyc4Zy+bBIPEJpRNda5QyHK0GPdt3NSHZ9GQ82EFQBPJ/01a wIl1lY+8g5TeWn5MGAYryTXAvhByE8lgEJAlUn6M2FMzf+WbRtaI7JNvYOdiAOEJVY1wQE PQMJnf5kgKznFxhnxZsVh1iWk5OMpB/QYhNDiitdChPZlPL8cVkHsrf9fvwSeIElLv0ykT m8Ou7XpmUErAk42J/5zqHFfX5f1fJ1x48Hh3v617sC8Xq2NUbuOl0bCvifEM9bW12sSBO+ 7IyIMqdRo1YU92OgBSK3yfRpSKxPQZk9DLTd39iQrc5AEGVA7Ede9vKM7GgVVA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1758882769; 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=7BA+am8UDaQIpenu9joAOiF59FbjTZrcb+TK2967CWQ=; b=xLNLAbA3zEoGyeShtIAuxH48VagzMDztyIPULH4L05ncmXsdpF67nbUPl35JWkfaRwAV5+ w07Uw98noOFxFnZitTCE1JbX9c4QBR2fqYwPV8JiJKEm0R41/Lnni8Myt7R7fTDOTlqKb2 HXUwg5niAeSyym8kJurRKY38adHtPkXcgxpCBiRsW24+u85sQFp+qDFRP5UWGQMu5mCc7t iD11GQi3RXZ5ntNh2buEsYGv0atAzw+USQTDokn8eKe7GJh/Iv9fA0ideeSnYaZ3UjtNoq Vo2qO6iQpuqmriE7uXEMbLyrJTAmYkAYVBu/feQus0ylAbb0Huteo1TACSr6HA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1758882769; a=rsa-sha256; cv=none; b=bEAzu9KS8vn+rJLbn0j9g3Ge7oGD4Zd5WT+D+ojxoyILGe390yHg70uFH6Ml8gaewft145 xmwwJOuAlY5i/LKwR/fU2B+pvweHnpejaAkeIUDxSTKxqty1LyN05PJp1fjD/pWJOepwEc Ca6B96ZCCH4WzO6ERDpeA9x39uUlYfbWAfJ3kooswU6JZg5mJVFhyhQ8YGn3X9CohAzCAS qzWLLE1j9J4KQqnrBQOuQFGAzD5jJVQsOvDMTIvOfXZutcZQwpmoQQ3ZA1pkCGT30+ktNo sS0ulQm2gPZYDTaPKR6cMznSjKz4GzsvFdQfr+WcEV8wSapMxvrf5BaX9zlRqw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (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 did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4cY6Nd5sbJzkjk; Fri, 26 Sep 2025 10:32:49 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 58QAWnkC052602; Fri, 26 Sep 2025 10:32:49 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 58QAWnqB052599; Fri, 26 Sep 2025 10:32:49 GMT (envelope-from git) Date: Fri, 26 Sep 2025 10:32:49 GMT Message-Id: <202509261032.58QAWnqB052599@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: e912e36fe9 - main - Avoid the use of "you" in the wayland chapter 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: bcr X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: e912e36fe97573085fcae69a55f64194a84f2981 Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=e912e36fe97573085fcae69a55f64194a84f2981 commit e912e36fe97573085fcae69a55f64194a84f2981 Author: Benedict Reuschling AuthorDate: 2025-08-28 16:03:58 +0000 Commit: Benedict Reuschling CommitDate: 2025-09-26 10:32:12 +0000 Avoid the use of "you" in the wayland chapter Rewrite sentences that contain 'you', which should be avoided according to the FDP Primer. The resulting sentences are easier to understand and often shorter. I did not change programlistings and other output as these are from programs, which need to be changed first (out of scope of this change). Event: Oslo Hackathon 2025 Differential Revision: https://reviews.freebsd.org/D52221 --- documentation/content/en/books/handbook/wayland/_index.adoc | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/documentation/content/en/books/handbook/wayland/_index.adoc b/documentation/content/en/books/handbook/wayland/_index.adoc index aa402971ff..4d57d605c7 100644 --- a/documentation/content/en/books/handbook/wayland/_index.adoc +++ b/documentation/content/en/books/handbook/wayland/_index.adoc @@ -55,13 +55,13 @@ endif::[] An installation of FreeBSD using bsdinstall does not automatically install a graphical user interface. This chapter describes how to select, install, and configure a Wayland compositor, which provides a graphical environment. -Before reading this chapter, you should: +Before reading this chapter: * Know how to install crossref:ports[ports,additional third-party software]. -* How to identify and configure crossref:x11[x-graphic-card-drivers,drivers for your graphics hardware]. +* Know how to identify and configure crossref:x11[x-graphic-card-drivers,drivers for the graphics hardware]. -After reading this chapter, you will know: +Read this chapter to learn: * How to configure FreeBSD to host a Wayland graphical environment. @@ -376,7 +376,7 @@ The Sway compositor is a tiling compositor that attempts to replace the i3 windo It should work with the user's current i3 configuration; however, new features may require some additional setup. Before starting the Sway installation, ensure that a graphics card (GPU) is installed and configured correctly. -Refer to the section crossref:x11[x-graphic-card-drivers,drivers for your graphics hardware] for guidance. +Refer to the section crossref:x11[x-graphic-card-drivers,drivers for the graphics hardware] for guidance. This step is essential for the Sway compositor to function properly. In the forthcoming examples, a fresh installation without migrating any i3 configuration will be assumed. @@ -403,7 +403,7 @@ Several important changes should be made like the following: # Logo key. Use Mod1 for Alt. input * xkb_rules evdev set $mod Mod4 -# Your preferred terminal emulator +# The preferred terminal emulator set $term alacritty set $lock swaylock -f -c 000000 output "My Workstation" mode 1366x768@60Hz position 1366 0