From nobody Wed Oct 18 14:18:49 2023 X-Original-To: freebsd-doc@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 4S9Xyg4VdDz4x4fG for ; Wed, 18 Oct 2023 14:18:51 +0000 (UTC) (envelope-from tomasz@kramkow.ski) Received: from erebus.slow.network (erebus.slow.network [109.74.205.187]) (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 mx1.freebsd.org (Postfix) with ESMTPS id 4S9Xyf6nvFz3KGn for ; Wed, 18 Oct 2023 14:18:50 +0000 (UTC) (envelope-from tomasz@kramkow.ski) Authentication-Results: mx1.freebsd.org; dkim=pass header.d=kramkow.ski header.s=20220506 header.b="LHs/HGcc"; spf=pass (mx1.freebsd.org: domain of tomasz@kramkow.ski designates 109.74.205.187 as permitted sender) smtp.mailfrom=tomasz@kramkow.ski; dmarc=pass (policy=quarantine) header.from=kramkow.ski DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; s=20220506; bh=iL5fJHSULBY i6JrxDbJqxUbt3JMqBDZGn3UNKSVjDr4=; h=to:subject:from:date; d=kramkow.ski; b=LHs/HGccMMUkhclpg65fmbVxsFIUMDjUZksJ69+cMYVzviBFO28aN VgXE5GPE40AjiQAIVIk94Eb72ylIa4oI/p0jTO+q1AMb4T6Q48InLV8itrBbCXowSASNpj iQ6uBYEdCAHpiYcu9oDroeB9zGnA3zpR+Mh1QZXuvdgW/n4K47x6cGtZl6GLjntuqCPh3O dVRmD8j48NNHo+VIQfpgA/FDuQztCrCJ4lB02fPTFIhzlFuBJVh4fDtiU8sPrnuZpFsJaJ 1kOCEWdhf0IvX5lWh+Jt2ZIla/iTQfwiymP6ginWvYKjd2Ivrn0RQSiKfK7Ew5Vjbhb+GH GmAoyRsVQ== Received: from [192.168.1.135] (cpc136054-flit4-2-0-cust264.know.cable.virginm.net [81.100.165.9]) by erebus.slow.network (OpenSMTPD) with ESMTPSA id 4757677e (TLSv1.3:TLS_AES_256_GCM_SHA384:256:NO); Wed, 18 Oct 2023 14:18:50 +0000 (UTC) Message-ID: Date: Wed, 18 Oct 2023 15:18:49 +0100 List-Id: Documentation project List-Archive: https://lists.freebsd.org/archives/freebsd-doc List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-doc@freebsd.org MIME-Version: 1.0 User-Agent: Mozilla Thunderbird From: Tomasz Kramkowski Subject: Handbook - Chapter 26 - potentially misleading note To: freebsd-doc@freebsd.org Content-Language: en-US Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Spamd-Bar: --- X-Spamd-Result: default: False [-3.99 / 15.00]; NEURAL_HAM_LONG(-1.00)[-1.000]; NEURAL_HAM_MEDIUM(-1.00)[-1.000]; NEURAL_HAM_SHORT(-1.00)[-1.000]; DMARC_POLICY_ALLOW(-0.50)[kramkow.ski,quarantine]; R_SPF_ALLOW(-0.20)[+mx:c]; R_DKIM_ALLOW(-0.20)[kramkow.ski:s=20220506]; RCVD_IN_DNSWL_LOW(-0.10)[109.74.205.187:from]; MIME_GOOD(-0.10)[text/plain]; ONCE_RECEIVED(0.10)[]; XM_UA_NO_VERSION(0.01)[]; FROM_EQ_ENVFROM(0.00)[]; TO_MATCH_ENVRCPT_ALL(0.00)[]; RCVD_COUNT_ONE(0.00)[1]; MIME_TRACE(0.00)[0:+]; RCVD_TLS_ALL(0.00)[]; ASN(0.00)[asn:63949, ipnet:109.74.192.0/20, country:SG]; TO_DN_NONE(0.00)[]; MLMMJ_DEST(0.00)[freebsd-doc@freebsd.org]; DKIM_TRACE(0.00)[kramkow.ski:+]; RCPT_COUNT_ONE(0.00)[1]; RCVD_VIA_SMTP_AUTH(0.00)[]; MID_RHS_MATCH_FROM(0.00)[]; FROM_HAS_DN(0.00)[]; ARC_NA(0.00)[] X-Rspamd-Queue-Id: 4S9Xyf6nvFz3KGn Hi, I was reviewing Chapter 26 of the handbook today in preparation for an upgrade and I was reading section 26.2.3 "Performing Minor and Major Version Upgrades" and noticed what may be a mistake. After running `freebsd-update -r 13.2-RELEASE upgrade` the documentation mentions running `freebsd-update install` but does so in a "Note". To me, the way this reads makes it seem like it's a side-note and not a core part of the updating process. I mentioned it in the #freebsd IRC channel and at least one other user agreed and suggested this part should either not be a note or be changed to a "Warning". When treating this paragraph as a side-note, the documentation makes it seem like the step following `freebsd-update -r 13.2-RELEASE upgrade` is a reboot followed by a `freebsd-update install` (which would not result in a complete upgrade). I'm happy to submit a patch addressing this if there is agreement that it should be changed. As an aside, it was also mentioned on IRC that this section should probably also more explicitly mention/reference updates to the ZFS version and how it may require bootloader updates. At the moment this is only mentioned in the ZFS chapter, and bootloader updates are only mentioned in passing in a different part of chapter 26. Although I don't think I know enough about what specifically it should say to suggest an amendment. Thanks, -- Tomasz Kramkowski