From nobody Mon Apr 18 14:33:21 2022 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 10B0E11D73A8 for ; Mon, 18 Apr 2022 14:33:22 +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 "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4KhqDK47Bnz4bV6; Mon, 18 Apr 2022 14:33:21 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1650292401; 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=F4eqnffAa0I2Iu6/dXFugb7Ydyvu1QUxPowgVHdY42E=; b=yftXQ8p6CIfMA1BU1KZrkTgNpRL6niv8pLbdSjV9O1PgefQ82da/L7kZ1yKFfkaaWi9iQ4 v8eRzomyS7pLzwGUJLny51xmMuwwVp5j65TFNULlE8KniAvHSOFPd1stFvSlwAYfDqY3l3 /GjcDUjqdcIHK8GIg/HtVisYI7aaNAjwSPmWSr/Q1yp12pZa+xLNa73ijZOGSPZRdDi3w6 OvF+UCU5XWwrChzbbs+nKrNzattld1nrBFiSDbZ0/JQ98CrN5cPYmkh7TvcDPn4/bclKQR PragPECXu+7Ay/sAuq6OAiF5jNnUN7TPNQpMURRITAs11+qnUY5a4/wTO2hICQ== 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 2883F1465D; Mon, 18 Apr 2022 14:33:21 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 23IEXLFi023370; Mon, 18 Apr 2022 14:33:21 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 23IEXLol023369; Mon, 18 Apr 2022 14:33:21 GMT (envelope-from git) Date: Mon, 18 Apr 2022 14:33:21 GMT Message-Id: <202204181433.23IEXLol023369@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Daniel Ebdrup Jensen Subject: git: e8543cd9ce - main - arch-handbook: Fix a few nits 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: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: debdrup X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: e8543cd9ce71c51a10ba338d0b443b421d9a442a Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1650292401; 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=F4eqnffAa0I2Iu6/dXFugb7Ydyvu1QUxPowgVHdY42E=; b=GY7b+jAnIVLyKkKNQ41itCOnpi2eKWReA+a42tkvoqy8YEOlVjdDfF3X292+xYxjG/QeMA 2gMVSJeqgepK+FQZNzwvONtPO6XCNXlwr2lNniPnckJUV4XaNwFssfhp7+3jYgs/ubDJjb vz9WDggSMZdhO/KqkBT0Ue4bboBVg8OionlLfQNsKoTugUCJ5tYKQ3l8Geg8VLzfM7l/IO n/aOxC53Blcug3utd/2GFO0tZx4OlcQzQ/v7ZcYmUTlh0KUwpXJ9mWSPpl8XyShyxnJhuB aH7pIwP1IWvai1W0RPOEmszv/NbodFCusrWBbw/xkzm5TKotV79ejEUfEbEf/g== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1650292401; a=rsa-sha256; cv=none; b=WuFUSHBNYLDegt1D5HQRFMVsYsX4MKOtdFOYBlZP5Ai0iqsWCMkSLfBaYuK0rzEk9BW6bi O4I0R61sv8mQEgrYwIhcdBZo1iFSZU/WEmGHcWAWz2d6DJ4yDfq+BIb/HkzTZh9RX0zniw E8/ov3lZJmbnR8YhZxY7w3n5B3cGPC8He4NPr5J/NMXdJAYOj/GtaLnYFPPuaqYYjq82ur h5IO1VHS7VkgXyvFIYwZY19LropKovKtU9c0JZaKA7DO7zVAezWB7bawcPcYF0r0DXnt4Z 1k1yC32HH/ubS+dMo2CsCJEEUNPDTOwOGmPRGu4MCMMJ9GqwCfV/O4U7+cxc6A== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by debdrup: URL: https://cgit.FreeBSD.org/doc/commit/?id=e8543cd9ce71c51a10ba338d0b443b421d9a442a commit e8543cd9ce71c51a10ba338d0b443b421d9a442a Author: Daniel Ebdrup Jensen AuthorDate: 2022-04-18 13:57:40 +0000 Commit: Daniel Ebdrup Jensen CommitDate: 2022-04-18 13:57:40 +0000 arch-handbook: Fix a few nits A couple of typos were noticed during the conversion to one sentence per line, and have now been corrected. While here, move a manual page reference into the same line as the sentence that refers to it. --- documentation/content/en/books/arch-handbook/boot/_index.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/documentation/content/en/books/arch-handbook/boot/_index.adoc b/documentation/content/en/books/arch-handbook/boot/_index.adoc index 7f1aceddd3..cca516e445 100644 --- a/documentation/content/en/books/arch-handbook/boot/_index.adoc +++ b/documentation/content/en/books/arch-handbook/boot/_index.adoc @@ -69,7 +69,7 @@ FreeBSD supports the CSM boot standard (Compatibility Support Module). So CSM is supported (with both GPT and MBR partitioning support) and UEFI booting (GPT is totally supported, MBR is mostly supported). It also supports loading files from ext2fs, MSDOS, UFS and ZFS. FreeBSD also supports the boot environment feature of ZFS which allows the HOST OS to communicate details about what to boot that go beyond a simple partition as was possible in the past. -But UEFI is more relevant than the CMS these days. +But UEFI is more relevant than the CSM these days. The example that follows shows booting an x86 computer from an MBR-partitioned hard drive with the FreeBSD [.filename]#boot0# multi-boot loader stored in the very first sector. That boot code starts the FreeBSD three-stage boot process. @@ -706,7 +706,7 @@ Recall that `nread` uses memory address `0x8c00` as the transfer buffer to hold This address is conveniently chosen. Indeed, because [.filename]#boot1# belongs to the first 512 bytes, it ends up in the address range `0x8c00`-`0x8dff`. The 512 bytes that follows (range `0x8e00`-`0x8fff`) is used to store the _bsdlabel_ footnote:[Historically known as disklabel. -If you ever wondered where FreeBSD stored this information, it is in this region. See man:bsdlabel[8]]. +If you ever wondered where FreeBSD stored this information, it is in this region - see man:bsdlabel[8]]. Starting at address `0x9000` is the beginning of the BTX server, and immediately following is the [.filename]#boot2# client. The BTX server acts as a kernel, and executes in protected mode in the most privileged level. @@ -1394,7 +1394,7 @@ Additionally, these sysctls are set by `init_param1()`: `kern.maxswzone, kern.ma Then `init386()` prepares the Global Descriptors Table (GDT). Every task on an x86 is running in its own virtual address space, and this space is addressed by a segment:offset pair. Say, for instance, the current instruction to be executed by the processor lies at CS:EIP, then the linear virtual address for that instruction would be "the virtual address of code segment CS" + EIP. -For convenience, segments begin at virtual address 0 and end at a 4Gb boundary. +For convenience, segments begin at virtual address 0 and end at a 4GB boundary. Therefore, the instruction's linear virtual address for this example would just be the value of EIP. Segment registers such as CS, DS etc are the selectors, i.e., indexes, into GDT (to be more precise, an index is not a selector itself, but the INDEX field of a selector). FreeBSD's GDT holds descriptors for 15 selectors per CPU: