Date: Thu, 22 May 2025 14:14:29 -0700 From: Billiam Crashkopf <resin-freebsd@g-cipher.net> To: freebsd-current <freebsd-current@freebsd.org>, doc <doc@freebsd.org> Cc: Alexander Ziaee <ziaee@freebsd.org>, Dave Cottlehuber <dch@freebsd.org>, emaste <emaste@freebsd.org> Subject: Re: Updating build and jail manual pages to include missing or obscure information Message-ID: <08e9057e-d741-49a8-a93d-7947f79179d3@g-cipher.net> In-Reply-To: <aC96jIHmVmUZkM0I@ragweed.eden.le-fay.org> References: <2d6ef406-2a4e-4876-b784-e9ad5a0e11be@app.fastmail.com> <E1uI68z-00029a-NI@rmmprod05.runbox> <CANCZdfq2saGd0TkNZnPW3u-FFznncQ4c8FLu2VjRHhwnAtpLqg@mail.gmail.com> <aC9N3AIpxZJXoHFN@ragweed.eden.le-fay.org> <2f6b255b-696c-44ed-9c32-b70daec0ff4f@g-cipher.net> <aC96jIHmVmUZkM0I@ragweed.eden.le-fay.org>
index | next in thread | previous in thread | raw e-mail
On 5/22/25 12:27, Lexi Winter wrote: > resin-freebsd@g-cipher.net: >> 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. Totally fair. I'm still unclear on the deprecated status of the 'world' target. Is it deprecated because it's dangerous for the running system? It clearly has some guard rails to prevent accidents (DESTDIR or HISTORICAL_MAKE_WORLD must be set). If it's truly deprecated then it shouldn't be used in the jail instructions. But it also has more functionality than buildworld + installworld because it has logic for optionally making pre-world and post-world targets. Options I see are: * Declare the 'world' target deprecated only for updating, but fine for other uses * Declare the 'world' target deprecated for all uses; update the jail build instructions with a more verbose invocation. * Declare the 'world' target deprecated for all uses; add an alias for the same recipe that doesn't have any legacy meaning.home | help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?08e9057e-d741-49a8-a93d-7947f79179d3>