From nobody Thu May 22 19:27:08 2025 X-Original-To: freebsd-current@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 4b3JFq0ZnQz5x44c; Thu, 22 May 2025 19:27:11 +0000 (UTC) (envelope-from ivy@FreeBSD.org) Received: from smtp.freebsd.org (smtp.freebsd.org [IPv6:2610:1c1:1:606c::24b:4]) (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 "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4b3JFq03N8z42GN; Thu, 22 May 2025 19:27:11 +0000 (UTC) (envelope-from ivy@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1747942031; 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=ncL6beIMIoX24rhbvxtgZZS+cINt+h9efGk1DnG2gV0=; b=O0FcHvFl7uoxrcSnfFQWLlxr1Usp0g95ndYe+lnzbqOFkgEOXnLRwDfkmIto7SlatjXskq uAUq4U7R9bauFXWzE6lax/gPmTh7QYy6gJnq7YK3nT2dczsERp7tsWbXVB5LQD7N33kFTT n0hRfW139vSNh2dIpyU/Uf2LU/2P1U0oBeg1mib0w8HE40Wh3zA3aIzXHYYCK1P2LU4pjh 1AAAFcfmTvM9tJNxNZ9vJpbpX2RicT8pNGazwIBWz96rp2ZfbAEXL0d+FCN5vG/pEarxVw i+Cy3uW+Bc8Ojw5TEoWvZt2jGMKU6+hUc1TTGy5MOdbxkYfcIoSUbHhyIRYcjA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1747942031; 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=ncL6beIMIoX24rhbvxtgZZS+cINt+h9efGk1DnG2gV0=; b=JjfRMY7UYXNiwFkOxGvX6hvnho6foH+4cEgrM7pcZ3JyC245giQ56E8nNyzeNT6kdH8lrF HHTCAi0lBYvQB/N4uom19bpeA8wZd0g4ToDT7rbvF0WaLaojqttOeeI2pH00z+kbiWr0zF KUU/PCEXnkB1O8+wQKL1GRG0TOLjvO3ZDIW1x027B3d1ltIeQojA3Uyb81SLiZIFJCuBws OYgHZYX9P/NbQpQmquPXyKGQY5wU9gU9r7sLaUHhDlW4ZzHnjlrbXPZKoQsCo8X9fInIcp /a8pTSD3ev79B4U9xWO69xq6p1Lw53uZt5WQxIINiql724pWFErTQBafWk+OsQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1747942031; a=rsa-sha256; cv=none; b=yw2nWnAiYqyRA2vDDwwLq6Nx75Mv2FVKAWVL+k4IvkSgk/EpDDXtYhn0xObF5fzpYRwU3Y hRXdZRFek+1M/IJQPtPfe4E+Q2s9Lf8MF3+tflm1n7cg/Wo+elC6HUhFxHs7uzOhcvJzfA u+JyboPva6F63eSm+JFxBmbty0j9pClmM0nbbza2j+HiXTS5bzWJL4lSJvuC6qKtHRb8l6 f3Js1Xzow0gX6ozrmT57mbaWjteWrmYD7qQYIDYTOrshQ1jvT6Wz8hvJnHl1532exOSVY3 TIvRwhQ+FxrYVL3fWM4vBMX5HamF3D1q2nADoms4M5FJSL7L3IRMUVbtEvMDwA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from ragweed.eden.le-fay.org (ragweed.eden.le-fay.org [IPv6:2001:8b0:aab5:c401:1::1]) (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) (Authenticated sender: ivy/mail) by smtp.freebsd.org (Postfix) with ESMTPSA id 4b3JFp306zz10cR; Thu, 22 May 2025 19:27:10 +0000 (UTC) (envelope-from ivy@FreeBSD.org) Date: Thu, 22 May 2025 20:27:08 +0100 From: Lexi Winter To: resin-freebsd@g-cipher.net Cc: freebsd-current , doc Subject: Re: Updating build and jail manual pages to include missing or obscure information Message-ID: Mail-Followup-To: resin-freebsd@g-cipher.net, freebsd-current , doc References: <2d6ef406-2a4e-4876-b784-e9ad5a0e11be@app.fastmail.com> <2f6b255b-696c-44ed-9c32-b70daec0ff4f@g-cipher.net> List-Id: Discussions about the use of FreeBSD-current List-Archive: https://lists.freebsd.org/archives/freebsd-current List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-current@FreeBSD.org MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="RSAiwcs4/A70kNPM" Content-Disposition: inline In-Reply-To: <2f6b255b-696c-44ed-9c32-b70daec0ff4f@g-cipher.net> --RSAiwcs4/A70kNPM Content-Type: text/plain; charset=us-ascii Content-Disposition: inline resin-freebsd@g-cipher.net: > On 5/22/25 09:16, Lexi Winter wrote: > > note that 'make world' already doesn't work unless you're using DESTDIR > > (or you set a special make knob) so it shouldn't be documented as a way > > of upgrading the system in general, e.g. in build(7). > Just to share my two cents: I think all available options should be > documented in the manual. i'm fine with having 'make world' documented somewhere, although such documentation should probably note that it's been deprecated for over 20 years. i'm just saying it can't be documented as a way of upgrading the host system since it won't do that -- it will refuse to run unless DESTDIR is set, so it can upgrade jails, but not hosts. --RSAiwcs4/A70kNPM Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iHUEABYKAB0WIQSyjTg96lp3RifySyn1nT63mIK/YAUCaC96iwAKCRD1nT63mIK/ YKpZAQCQEt2QH5O+ZoIs6V5K0ZU4M2Ibk06qirhfQEy7rSbBhgD/a/atQ4bYOX/2 m6np4y44B3c96/3gJiaEekXqFfe3mQM= =Povw -----END PGP SIGNATURE----- --RSAiwcs4/A70kNPM--