From nobody Fri Aug 29 08:31: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 4cCs1y3zg6z66LDv for ; Fri, 29 Aug 2025 08:31:50 +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 4cCs1y3Cnsz46FZ; Fri, 29 Aug 2025 08:31:50 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756456310; 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=tjOzm+IqFaQK1FWaZmsePTxpCBWhjTgEb9iE09ePXls=; b=xMiZrbOKIzX10/yNrh7Bj9WgSWiUV8NwDduf5RXHgzHobCvgQknLBToakzH+z2xVD6Cqf/ VxJD7zUEWM3s6sLXTpl2R5nyVvGJ6uXT73u75WsDpk72tT8zX72/yOne5AGExni+3Xy1ZJ B1zowVlHw+9h5smdloRhZphdE5aEY6NS7IgK097lnWVgNIaM9EbsSEKVJRTY92XnqjKxeq D8vEVf8fIO7WMs1ttBpS+LZ9nPHcENhwK90e/OPAUjX92S42GhkAaYBV6y1NBTInNMQBUW VcNntDna2WHugWd6DgJHzVJvP4LvuEJBEIXlJSvEVi0qfxGI6xM4g1f4tylOUg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756456310; 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=tjOzm+IqFaQK1FWaZmsePTxpCBWhjTgEb9iE09ePXls=; b=VM5iDJRIr/T0+S4a0zZb+iZCzwgcVN4POFrJjpIRBmJdefP08tvcNjISfjJws6Uhzo6EvA MDOIIgck8YD3R7PR574EwOS7GolKkZv3IxSl5AHwY2XCBTVibZ4v3JxKZidDn6Yh/bhkvy L61D2eAeEyOMT167gH4pcnBAWXE2363urQlisEQEWj5sh4dCUr1uczbc8mPNowgUvVYAa+ 4B141tuq4me0Gl1zpYZKauZYt3WNDGdjUxeq4Dgi5Lxtd8EPjIS0LZPfUGABz5mNiCaHoW 15d6fhdpoHpkJCMEqzCFrszNnO/skfL9GtF9T0XYzEjuptTDNSsz2z9q/KK4EQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756456310; a=rsa-sha256; cv=none; b=DmvMypTiYEdppjIPu+Hqc2SmyO6OJQx9cjZaZO0nkrk+lT5hn5bXPPCB5SsQLpQ91QdNt9 8BgP9Z6lFICHdi65AHzFuHJxL1nbxJXOxksoKPjvFFLOggkLZ7EDn2Ay92zWunh04VXKR4 qEZxCkc8ZB570jjQ9reQT3siZIKGFxXgx1+0jSxa98HzogBHfMsyvJLbqK3zR8A3rUeBOD pTj/Oru2PP4sNSPa23btM+KXqseIXZKU9lFV3+fMF6djnH5dfyzlqDusJAI6mOEbHhAO0+ /Wvjz/fB7WEGlX7LV5JTbYfP6/1HsdKtMI+b4Mbs6KYjZr26deMTbtV+kHobmw== 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 4cCs1y2nJhzY2P; Fri, 29 Aug 2025 08:31: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 57T8VoOj041834; Fri, 29 Aug 2025 08:31:50 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57T8Voci041831; Fri, 29 Aug 2025 08:31:50 GMT (envelope-from git) Date: Fri, 29 Aug 2025 08:31:50 GMT Message-Id: <202508290831.57T8Voci041831@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: fd089bceb3 - main - Avoid the use of "you" in the serialcomms 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: fd089bceb3f9de4cb77e0a1973759d6dd49d8f2e Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=fd089bceb3f9de4cb77e0a1973759d6dd49d8f2e commit fd089bceb3f9de4cb77e0a1973759d6dd49d8f2e Author: Benedict Reuschling AuthorDate: 2025-08-28 15:53:35 +0000 Commit: Benedict Reuschling CommitDate: 2025-08-29 08:31:32 +0000 Avoid the use of "you" in the serialcomms 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 Reviewed by: carlavilla Differential Revision: https://reviews.freebsd.org/D52218 --- documentation/content/en/books/handbook/serialcomms/_index.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/documentation/content/en/books/handbook/serialcomms/_index.adoc b/documentation/content/en/books/handbook/serialcomms/_index.adoc index 18637f7d1c..e275e26ae6 100644 --- a/documentation/content/en/books/handbook/serialcomms/_index.adoc +++ b/documentation/content/en/books/handbook/serialcomms/_index.adoc @@ -56,14 +56,14 @@ UNIX(R) has always had support for serial communications as the very first UNIX( Things have changed a lot from the days when the average terminal consisted of a 10-character-per-second serial printer and a keyboard. This chapter covers some of the ways serial communications can be used on FreeBSD. -After reading this chapter, you will know: +Read this chapter to learn: * How to connect terminals to a FreeBSD system. * How to use a modem to dial out to remote hosts. * How to allow remote users to login to a FreeBSD system with a modem. * How to boot a FreeBSD system from a serial console. -Before reading this chapter, you should: +Before reading this chapter: * Know how to crossref:kernelconfig[kernelconfig, configure and install a custom kernel]. * Understand crossref:basics[basics, FreeBSD permissions and processes]. @@ -880,7 +880,7 @@ Put in an entry for `tip1200` or `cu1200`, but go ahead and use whatever bps rat === Accessing a Number of Hosts Through a Terminal Server Rather than waiting until connected and typing `CONNECT _host_` each time, use ``tip``'s `cm` capability. -For example, these entries in [.filename]#/etc/remote# will let you type `tip pain` or `tip muffin` to connect to the hosts `pain` or `muffin`, and `tip deep13` to connect to the terminal server. +For example, these entries in [.filename]#/etc/remote# allow typing `tip pain` or `tip muffin` to connect to the hosts `pain` or `muffin`, and `tip deep13` to connect to the terminal server. [.programlisting] ....