From nobody Fri Aug 29 08:33:37 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 4cCs415MGCz66LHc for ; Fri, 29 Aug 2025 08:33:37 +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 4cCs414Y17z46VQ; Fri, 29 Aug 2025 08:33:37 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756456417; 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=Ws/VqRx/ni+sKh0jn4IQvuxfNX+2ppHoac+ZsQScPP4=; b=M0u+csVVOAk9oR/FA4KRulyYfzCrIBUSgYp5UMyeR9TEdcj6LeT8+Uwofu4WX5TTSE8DcM yJUX575DySyptr4oUkjbHuq1SEVK/A8uLjrJhHA4AO6HnSMsdWqspwosP4YrarKZOW0j8q 14VN3YsmGmV6qvlKO37eDfySyQaQ5aZxxS7v+nJ6OGTo8PXv1q4eixtVGV+QfVHcbxOw7j NPoiGVx8PTIkLdsAHqa3zrBBC+lNMtYgP7xYcIojZCikGFor7rwBt+mNfdJhrP5tvYt9kz gGEFhNTW1zLg5OyjBvmeSdRl5nct3iJMwHvjvbWUY1f2wN2kHG4Hj6R/67Tzxg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1756456417; 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=Ws/VqRx/ni+sKh0jn4IQvuxfNX+2ppHoac+ZsQScPP4=; b=xNAQszfigF8j2EqFCR1weWXRwHXR9Vt3Qy1Emlx2lDeEaZAVnYyiR9Viln+C/mfnjOZ1Ov s+e9kzInJ3jBCL1W1tgbvrHEc/PXfoRLRHFEEM+svU/sekPv2joO9oGEOBnlnZ++6kHT2Q 3lI/fPeUEXQ5qjO6LlC1hq9jxhWkWRnG7MZeUcIvxY3u9jL6XunMyIcg16ZmjD+3r7Qeg6 Rh8R0FRPtpa/MYqbX8ZW4pe5eJxc6O1Lsv2P0w51ERjrNnISGe+IOnX/eDf20vAXLxrA50 CskmMZccDyX4t6uPRgB6p9mT3V9xgR8ft91wBZpXmlu6HwHbNDdV/JpwZ5p3hQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1756456417; a=rsa-sha256; cv=none; b=CEcvZsUBnucJ/VkPtchnIKx72zrs959R0/ea6LD2ExpCj24C0sjyioM7XJzxwTDmjgYRNr x5H81oAWBJyczDzP/LJnrp+sXDL/oEnt7SFBgIm14Co+gYEczkYLWKY0MEq45B83y+MJKt TwR1s2XEajo5oPnByy5cE982p+WFEwQuIODYBmoOYI5Hog/8HKjUgDOPrx4z2ubbT3g8Jd 6aJt9+bceK8ihqPHahXj+D3HL32u6ri6ZVRr3GqQF7IL76rVnKBJYXSkwFBeXiZWyJ042k ELwl1zip2iaoTtovUNzZBT07M7m3BWLClzc845njk7Y7pGgruVq0EarBxVQnvg== 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 4cCs413wtvzY9W; Fri, 29 Aug 2025 08:33:37 +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 57T8XbQs047122; Fri, 29 Aug 2025 08:33:37 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 57T8Xbeb047119; Fri, 29 Aug 2025 08:33:37 GMT (envelope-from git) Date: Fri, 29 Aug 2025 08:33:37 GMT Message-Id: <202508290833.57T8Xbeb047119@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Benedict Reuschling Subject: git: 9785a09c52 - main - Avoid the use of "you" in the USB device mode 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: 9785a09c52236fdf3772a23f7b9079b166a8c69a Auto-Submitted: auto-generated The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/doc/commit/?id=9785a09c52236fdf3772a23f7b9079b166a8c69a commit 9785a09c52236fdf3772a23f7b9079b166a8c69a Author: Benedict Reuschling AuthorDate: 2025-08-28 15:56:46 +0000 Commit: Benedict Reuschling CommitDate: 2025-08-29 08:33:13 +0000 Avoid the use of "you" in the USB device mode 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/D52219 --- .../content/en/books/handbook/usb-device-mode/_index.adoc | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/documentation/content/en/books/handbook/usb-device-mode/_index.adoc b/documentation/content/en/books/handbook/usb-device-mode/_index.adoc index 224412d35f..1ca78d5dfd 100644 --- a/documentation/content/en/books/handbook/usb-device-mode/_index.adoc +++ b/documentation/content/en/books/handbook/usb-device-mode/_index.adoc @@ -75,7 +75,7 @@ Note that in some cases, depending on the hardware and the hosts operating syste When FreeBSD is running on the host, man:usbconfig[8] `reset` can be used. This also must be done after loading [.filename]#usb_template.ko# if the USB host was already connected to the USBOTG socket. -After reading this chapter, you will know: +Read this chapter to learn: * How to set up USB Device Mode functionality on FreeBSD. * How to configure the virtual serial port on FreeBSD. @@ -141,7 +141,7 @@ To load the module and set the template without rebooting use: To connect to a board configured to provide USB device mode serial ports, connect the USB host, such as a laptop, to the boards USB OTG or USB client port. Use `pstat -t` on the host to list the terminal lines. -Near the end of the list you should see a USB serial port, e.g. "ttyU0". +Near the end of the list a USB serial port is shown, e.g. "ttyU0". To open the connection, use: [source,shell] @@ -149,7 +149,7 @@ To open the connection, use: # cu -l /dev/ttyU0 .... -After pressing the kbd:[Enter] key a few times you will see a login prompt. +After pressing the kbd:[Enter] key a few times a login prompt appears. === Connecting to USB Device Mode Serial Ports from macOS @@ -174,10 +174,10 @@ To open the connection, use: === Connecting to USB Device Mode Serial Ports from Microsoft Windows 10 To connect to a board configured to provide USB device mode serial ports, connect the USB host, such as a laptop, to the boards USB OTG or USB client port. -To open a connection you will need a serial terminal program, such as PuTTY. +To open a connection a serial terminal program is needed, such as PuTTY. To check the COM port name used by Windows, run Device Manager, expand "Ports (COM & LPT)". -You will see a name similar to "USB Serial Device (COM4)". -Run serial terminal program of your choice, for example PuTTY. +A name similar to "USB Serial Device (COM4)" appears. +Run the serial terminal program of choice, for example PuTTY. In the PuTTY dialog set "Connection type" to "Serial", type the COMx obtained from Device Manager in the "Serial line" dialog box and click Open. [[usb-device-mode-network]]