From nobody Wed Oct 18 15:14:57 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 4S9ZCf3sCGz4x8cd for ; Wed, 18 Oct 2023 15:15:10 +0000 (UTC) (envelope-from carlavilla@freebsd.org) Received: from smtp.freebsd.org (smtp.freebsd.org [96.47.72.83]) (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 "smtp.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4S9ZCf3NRHz3fRJ for ; Wed, 18 Oct 2023 15:15:10 +0000 (UTC) (envelope-from carlavilla@freebsd.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1697642110; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=GJuTz+P78xY48bm7sL4PSLl2oVeDCLH4xJGuRPPBetQ=; b=UUS+XU62dE6BHdy7/UOyYAlR6K4qHSb+Ouwx1Ntxbg6y2KxmNNpud2V1psayfyRgYLKTHD WmT3c28Gwd4JzFHvx7NivOz6y3L55DGn14fQOF0dOVWOjAJtGoQIY2dOaEuPgreI+AnSdi ttC1v7jKx8vqYv2+MZ7oZDyDmLiT21dZmuICCj3sNk8aNS0VYsVqrEeUnsssnAGDY+TvZ/ uAxiwptWBPezxatDomEA2uSsZvzl0Ke4ey49ac0RX+6++w60H6AVd5yJ/x+CRm8TOkOo8m kkWCfuP2K/JEwJAQTRpDlqDeb2kBRqvKUXG6F6dfR5fB1bTisvaUhlV/Sh2Tdw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1697642110; a=rsa-sha256; cv=none; b=ZpkrtokClafuxLOsryotW0SWDqZQ5lcvoQcSEIsADMDbQCGDdZZcgTX2L/ZIjdrneBDQIg ZR4+4js43i0jG+6deb4dh4TF6XL3CUD+hnl4zYFm9ycA04wuzuUrBI/aKkiEjOj+qnVak6 bo5H+SNmZhbbQyktM0P1sS2X/hOIGOPWZIBMxZ5bnLerDezBbD4mn/pBgU5jn3Nu6+am8m VHAg2+RscOreqDa4cN6ztRrXGD4bn0oRVgvo07mWHAWP0fH6pUYUQMs1lwC/7+EnrSPBlh ZK6mrLyblZpZvqtRsPxmfuMkIXt95u5yZh5xolUWiqF+Pu8a1jz5pPf/mBcLwg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1697642110; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=GJuTz+P78xY48bm7sL4PSLl2oVeDCLH4xJGuRPPBetQ=; b=w8kJV4FXhaTNui+eqdFbSmYM1egxOE8Oms9hSUcPcb2psCCg6QBA/6AZxPCownVvJ1PckZ esTB2uRpoPeQLhlhtevI7acz4KjTRT2aTfaWgl53epDLNeqWFt/MS1T0keNVgsn1AZpr4O V2Rpm2NIEOHUuJDIBX9WZBlJA2g/snAZGZUN/AdN3CzFTPVSF5lgTqUNIX2Z+T5B2ucfH+ wvoHzKdIC/5bxHATPTZ/Tuy4prOHq/ViFkjBewFfHSq5eU8BIEFbSDfUI4WfwHBJy+T7l9 AKs3AY/yldwZzJQjB0a2/GnoK95CRjGCs8rE70mhygFE2qzHSyz9wmKVr5Wyeg== Received: from mail-oa1-f52.google.com (mail-oa1-f52.google.com [209.85.160.52]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "GTS CA 1D4" (verified OK)) (Authenticated sender: carlavilla) by smtp.freebsd.org (Postfix) with ESMTPSA id 4S9ZCf2KKpz8dV for ; Wed, 18 Oct 2023 15:15:10 +0000 (UTC) (envelope-from carlavilla@freebsd.org) Received: by mail-oa1-f52.google.com with SMTP id 586e51a60fabf-1e59894d105so4112119fac.1 for ; Wed, 18 Oct 2023 08:15:10 -0700 (PDT) X-Gm-Message-State: AOJu0YykVuFFtEb0PhiisOigu3JvUtR6HAOdzOMu2mWrJk16hIjNVoHS fUryGY52qD1f+kaXybBQNvBWW/dFMzQr1vaxlpA= X-Google-Smtp-Source: AGHT+IGFE53dkky7T7nPNc7PAR4uPhojqM1s9sIaRUGKNWUUpwXwiUAVpwJeL3UJIh327QY9dGUnaKxapOBHJvWHIZA= X-Received: by 2002:a05:6870:bf85:b0:1ea:50ec:7087 with SMTP id av5-20020a056870bf8500b001ea50ec7087mr4514760oac.26.1697642109381; Wed, 18 Oct 2023 08:15:09 -0700 (PDT) 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 References: In-Reply-To: From: Sergio Carlavilla Date: Wed, 18 Oct 2023 17:14:57 +0200 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: Handbook - Chapter 26 - potentially misleading note To: Tomasz Kramkowski Cc: freebsd-doc@freebsd.org Content-Type: text/plain; charset="UTF-8" On Wed, 18 Oct 2023 at 16:18, Tomasz Kramkowski wrote: > > 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 > Hi, Yes, you can send a patch. We're working on the 4th version of the handbook, in the near future we'll upgrade this chapter. Thanks for the report.