From nobody Fri Sep 26 10:32:50 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 4cY6Ng1PZ4z686MY for ; Fri, 26 Sep 2025 10:32:51 +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 4cY6Ng0C4sz3JXG; Fri, 26 Sep 2025 10:32:51 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1758882771; 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=n9VmnvL36Y4N8m0K7YCq3eZTMmgRLVxFXTfeOcNY930=; b=M6XFLvaxwGENDC9djsW52UdKwOCF453AZZmuCmyv/Rc9kVBZ+eXNCOcOs2A2+pgAuwGCR6 3bFoXH1b4Ql9TzwGKx5/CTXMvssfS6ppwxa+zoGzpj23IUvdnuvfevwGfCMlBzR+XbC0rm s7CxlFoFOpuuOSvrNuukNFERV2RYFjFSoG6KAtiwbAme+oYZscSSccYek8iETClkSqLkiz K9K354e7ger4UAJp6fWFQ09MgtTQiS5P+lUDgpxU34PxoFQa7m4Z39rKcjAzI4m3EG0RxF TxJzIz1GfKKaTuHlVoi8UASHBfJP1T6wPqc7xWpNm2c+xwX2rEQZTte5RSbIsg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1758882771; 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=n9VmnvL36Y4N8m0K7YCq3eZTMmgRLVxFXTfeOcNY930=; b=evg8XS3GBRLeERLbG061gX4+/gcmByiCkCWRsr18FvQKEUWddDlkaPIspT2cdNEUjVStEc XQcF2ggP/PeDO7o1UBekRp7sGd8dkX5peIPJ/43cPInpvzomYj8Ttij4LcWxReJx+yudEg Iguj9EQFHox6LyFvXnKG1vXOTI2MrVVr5isnY3Bfr8M1yTZW856BlJ0d5a35SXXfFU5c8N jNMIxjD0uXvLjLULcG+ac6SUB5TLYM8hisAEwuk/Cpw1JQ0XsEV1FOwOLj/rHK+qRZTELR 6WhZ6IyBFEDY+SFOHfP0o+7ltpoXegAjLaPGPIPNtKQwLNgTttWKdPxcJKeSCg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1758882771; a=rsa-sha256; cv=none; b=XkB4rmNR90AfctbNmDSsx4WJ1xDzrcw0uL1e919HhFJdIuZqZ/jSoNBUK+iXXSFNAM1dsl 60VXGeNpvlRC5aKhQv3bMcvmQhTt3KuBxgzBVeFAP+CHo+R3rwSmaCK37xIa3DV31HC9fd WwE5VTVcwCCXS6xrkIDk1qEQq50KhW1wtzPYle2E5/29QwtVhDdXCsFUK+sY57HWV0OstC y1aWrLZbiigZ2+wfjGE7x/cmoIwlRHIz+62xTBwSrdCmzOcC3m8bRtCz7CV+SkrQncY6vs BhmrFN2iL9ATjbxskTwf2ueiYDQuqWpTEvrMEiHJkMEk2g4QGBwvWUAFeSliQg== 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 4cY6Nf6q3wzkmD; Fri, 26 Sep 2025 10:32:50 +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 58QAWoH2052636; Fri, 26 Sep 2025 10:32:50 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 58QAWoo5052633; Fri, 26 Sep 2025 10:32:50 GMT (envelope-from git) Date: Fri, 26 Sep 2025 10:32:50 GMT Message-Id: <202509261032.58QAWoo5052633@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: edfc11ecd6 - main - Avoid the use of "you" in the X11 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: edfc11ecd68e998faee21a005e829116e0833757 Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=edfc11ecd68e998faee21a005e829116e0833757 commit edfc11ecd68e998faee21a005e829116e0833757 Author: Benedict Reuschling AuthorDate: 2025-08-28 16:05:57 +0000 Commit: Benedict Reuschling CommitDate: 2025-09-26 10:32:12 +0000 Avoid the use of "you" in the X11 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/D52223 --- .../content/en/books/handbook/x11/_index.adoc | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/documentation/content/en/books/handbook/x11/_index.adoc b/documentation/content/en/books/handbook/x11/_index.adoc index 0cefe7bbcd..46d9c3caad 100644 --- a/documentation/content/en/books/handbook/x11/_index.adoc +++ b/documentation/content/en/books/handbook/x11/_index.adoc @@ -59,14 +59,14 @@ This chapter describes how to install and configure the man:Xorg[1] server, which provides the open source X Window System (colloquially X11) used to provide a graphical environment. -Before reading this chapter, you should: +Before reading this chapter: * Know how to install additional third-party software as described in crossref:ports[ports,Installing Applications: Packages and Ports]. -After reading this chapter, you will know: +Read this chapter to learn: -* How to select and install drivers for your graphics processor (GPU). +* How to select and install drivers for the graphics processor (GPU). * The various components of the X Window System, and how they interoperate. * How to install and configure the X.org server. @@ -75,7 +75,7 @@ and how they interoperate. [[x-graphic-card-drivers]] == Graphics Drivers -_**abstract**: Identify your GPU, the port providing a driver for it, +_**abstract**: Identify the GPU, the port providing a driver for it, install it, then enable it to run at subsequent boot with man:sysrc[8]._ Before FreeBSD can render a graphical environment, @@ -403,7 +403,7 @@ Some applications require these additional components to function. [[x-config]] == X.org Configuration -_**abstract**: If the defaults for your monitor or input devices, +_**abstract**: If the defaults for the monitor or input devices, are not satisfactory, crossref:desktop[desktop-synopsis,desktops] include GUIs for configuring them, or they can be configured manually._ @@ -701,7 +701,7 @@ library, a cross-platform effort to support all touch, pointing, and keyboard devices under a unified library. Unless specified otherwise, this is loaded automatically. -Individual device settings for man:libinput[4] can be tuned in your +Individual device settings for man:libinput[4] can be tuned in the crossref:desktop[desktop-synopsis,desktop's] GUI, or manually with package:x11/xinput[xinput] and package:x11/setxkbmap[setxkbmap]. @@ -716,7 +716,7 @@ Both are described in this subsection. ==== Using Atomic Input Configuration Devices supported by man:libinput[4] can be configured -with graphical utilities included with your +with graphical utilities included with the crossref:desktop[desktop-synopsis,desktop] of choice, or manually and atomically at runtime with package:x11/xinput[] and package:x11/setxkbmap[]. @@ -751,9 +751,9 @@ All settings supported by these devices are provided as properties, which can be listed and set atomically. Pointing devices have many configurable properties, keyboards usually need none. -To customize your keyboard, take a look at man:setxkbmap[1]. +To customize the keyboard, take a look at man:setxkbmap[1]. -Once satisfied with your configuration, simply add the lines to your +Once satisfied with the configuration, simply add the lines to the X initialization script such as [.filename]#~/.Xsession# or [.filename]#~/.xinitrc#. [[x-config-input-file]]