From nobody Thu Aug 28 16:41:16 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 4cCRx84vKmz66HXy for ; Thu, 28 Aug 2025 16:41:16 +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 4cCRx84Grdz3Jx5; Thu, 28 Aug 2025 16:41:16 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756399276; 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=BMulBhQoEVPkdhEupzVmkJBlGjeF+9I+Sa24VGiT5Jg=; b=Llnm31zgQEttksVUHXQFjxBfXBUiPcUeGMp3Mg7lv3kWrlAAdGR/4lN+eh/Eypw+ZQMDlx MHRk8fUz8ATqvVvo+qCU/5VZw4f1W47HrcfZodQVwbNBva1B4I5n42H3lKGvOa3S+GyaBR 40dvHnkplP2hs+ggGOqUxMO/WJy1Zi6/GHwyTwst++UMICvtLcEBUEKXv4FyNQFn/aXaq4 aq5A/hqR6Tp4E4Ltcca9Gww4/1RBIf4eYVSUfNKS5eNViNeC64QEtBw+weAJxE5xfgV6Pw 9maXLE2PUeVnGgNmYk0g5AMchTT4HxDgf6FRUPziQE8+G4BGmKiZvtnuRTcDJw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756399276; 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=BMulBhQoEVPkdhEupzVmkJBlGjeF+9I+Sa24VGiT5Jg=; b=LDPx+SIdQ7IXkeU+8nVw7OBrErAERsHatvrK6wYVj6Qzl5SA09/Km05Cs3Ayv/vVBdV1eF 8/tEGhynkh/ly+DLoyCT3Yu/jSg1vM50eZZkfrycLgOK6qib2UVMIvuOUYQpmyyOnGYG0r aC3eBcQNZ9s42tlqJtTq+S+jJIVdjqLWlDh78A8QLySrUQcZ1kndvxpoN70KY5jGHp/5pY HtxbN/WaGTo2q4h+aOLsRG2DWBHTz4o7NIYS2lB+qLHz/94KtZ2Ond0Q6kYbRCrvI5Du/D TWDSl7ldPWs7/zXzSuPwRU4HymZ1nuQj3HEB3FmcGBKleXSkn9gimoEUHowARw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756399276; a=rsa-sha256; cv=none; b=MoUXCeBSKNK227Lqcbx+3ClbPwnUiaq3iUJ4i4JpQuCobG+65ywWTU4NaeAQVEwQQiqfdR yeVUL8qVOU5/pyLWsi/Atmu+adOTb15br/aEM9p5EoYpNLzBcN5/j5Uv8oWcoPLsRH+v7+ B733gDF2FPDhKsR05pTG6hqpdm6g9CpSJ90rpMniu7amd4N4AdS9sfD+bpMi32op2/tLJa TZvBCJsl3dJml4R6QnXnTiADz3fwoiJbXUcS6N0b573PzEo8z1DJJx3KS44/uu5Fxty4+x 6Tpz6qz8f+/qdeoy4343PrYu18lyjSLUHI1mnpS6KjQPJlkwZR23Aq2RSIpBTQ== 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 4cCRx83lzyz1GJw; Thu, 28 Aug 2025 16:41:16 +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 57SGfGX8056258; Thu, 28 Aug 2025 16:41:16 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57SGfGk1056255; Thu, 28 Aug 2025 16:41:16 GMT (envelope-from git) Date: Thu, 28 Aug 2025 16:41:16 GMT Message-Id: <202508281641.57SGfGk1056255@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: 1f0e82bfa3 - main - Avoid the use of "you" in the Advanced Networking 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: 1f0e82bfa35e52e747765a17472a305b50bb3112 Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=1f0e82bfa35e52e747765a17472a305b50bb3112 commit 1f0e82bfa35e52e747765a17472a305b50bb3112 Author: Benedict Reuschling AuthorDate: 2025-08-28 14:21:29 +0000 Commit: Benedict Reuschling CommitDate: 2025-08-28 16:39:30 +0000 Avoid the use of "you" in the Advanced Networking 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/D52204 --- .../en/books/handbook/advanced-networking/_index.adoc | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/documentation/content/en/books/handbook/advanced-networking/_index.adoc b/documentation/content/en/books/handbook/advanced-networking/_index.adoc index 57ddfe3d75..33da0682cf 100644 --- a/documentation/content/en/books/handbook/advanced-networking/_index.adoc +++ b/documentation/content/en/books/handbook/advanced-networking/_index.adoc @@ -54,7 +54,7 @@ endif::[] This chapter covers a number of advanced networking topics. -After reading this chapter, you will know: +Read this chapter to learn: * The basics of gateways and routes. * How to set up USB tethering. @@ -63,9 +63,9 @@ After reading this chapter, you will know: * How to set up network PXE booting. * How to enable and utilize the features of the Common Address Redundancy Protocol (CARP) in FreeBSD. * How to configure multiple VLANs on FreeBSD. -* Configure bluetooth headset. +* How to configure a bluetooth headset. -Before reading this chapter, you should: +Before reading this chapter: * Understand the basics of the [.filename]#/etc/rc# scripts. * Be familiar with basic network terminology. @@ -1859,13 +1859,13 @@ We therefore recommend overriding the Ethernet MAC address for this purpose. [NOTE] **** If the driver for the wireless interface is not loaded in the `GENERIC` or custom kernel, and the computer is running FreeBSD {rel121-current}, load the corresponding [.filename]#.ko# in [.filename]#/boot/loader.conf# by adding `*driver_load="YES"*` to that file and rebooting. -Another, better way is to load the driver in [.filename]#/etc/rc.conf# by adding it to `kld_list` (see man:rc.conf[5] for details) in that file and rebooting. +Another, better way is to load the driver in [.filename]#/etc/rc.conf# by adding it to `kld_list` (see man:rc.conf[5] for details) in that file and rebooting. This is needed because otherwise the driver is not loaded yet at the time the man:lagg[4] interface is set up. **** In this example, the Ethernet interface, _re0_, is the master and the wireless interface, _wlan0_, is the failover. The _wlan0_ interface was created from the _ath0_ physical wireless interface, and the Ethernet interface will be configured with the MAC address of the wireless interface. -First, bring the wireless interface up (replacing _FR_ with your own 2-letter country code), but do not set an IP address. +First, bring the wireless interface up (replacing _FR_ with the local 2-letter country code), but do not set an IP address. Replace _wlan0_ to match the system's wireless interface name: [source,shell] @@ -1873,7 +1873,7 @@ Replace _wlan0_ to match the system's wireless interface name: # ifconfig wlan0 create wlandev ath0 country FR ssid my_router up .... -Now you can determine the MAC address of the wireless interface: +Determine the MAC address of the wireless interface like this: [source,shell] .... @@ -2095,7 +2095,7 @@ In this case, [.filename]#/etc# and [.filename]#/var# need to be memory backed f When the system boots, memory file systems for [.filename]#/etc# and [.filename]#/var# will be created and mounted and the contents of the [.filename]#cpio.gz# files will be copied into them. By default, these file systems have a maximum capacity of 5 megabytes. -If your archives do not fit, which is usually the case for [.filename]#/var# when binary packages have been installed, request a larger size by putting the number of 512 byte sectors needed (e.g., 5 megabytes is 10240 sectors) in [.filename]#${NFSROOTDIR}/conf/base/etc/md_size# and [.filename]#${NFSROOTDIR}/conf/base/var/md_size# files for [.filename]#/etc# and [.filename]#/var# file systems respectively. +If the archives do not fit, which is usually the case for [.filename]#/var# when binary packages have been installed, request a larger size by putting the number of 512 byte sectors needed (e.g., 5 megabytes is 10240 sectors) in [.filename]#${NFSROOTDIR}/conf/base/etc/md_size# and [.filename]#${NFSROOTDIR}/conf/base/var/md_size# files for [.filename]#/etc# and [.filename]#/var# file systems respectively. [[network-pxe-setting-up-dhcp]] === Configuring the DHCP Server