From nobody Tue May 20 21:17:03 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 4b26nc6tSqz5w18Z for ; Tue, 20 May 2025 21:17:08 +0000 (UTC) (envelope-from resin-freebsd@g-cipher.net) Received: from g-cipher.net (leon.g-cipher.net [5.9.120.19]) (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 4b26nb45GPz3RGm for ; Tue, 20 May 2025 21:17:07 +0000 (UTC) (envelope-from resin-freebsd@g-cipher.net) Authentication-Results: mx1.freebsd.org; dkim=none; spf=pass (mx1.freebsd.org: domain of resin-freebsd@g-cipher.net designates 5.9.120.19 as permitted sender) smtp.mailfrom=resin-freebsd@g-cipher.net; dmarc=none Received: (qmail 60575 invoked from network); 20 May 2025 16:17:05 -0500 Received: from unknown (HELO ?192.168.7.176?) (resin@unknown) by g-cipher.net with ESMTPS (TLS_AES_128_GCM_SHA256 encrypted); 20 May 2025 16:17:05 -0500 Message-ID: Date: Tue, 20 May 2025 14:17:03 -0700 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 User-Agent: Mozilla Thunderbird Content-Language: en-US From: Billiam Crashkopf Subject: Updating build and jail manual pages to include missing or obscure information To: freebsd-current@freebsd.org Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit X-Rspamd-Queue-Id: 4b26nb45GPz3RGm X-Spamd-Bar: / X-Spamd-Result: default: False [-0.65 / 15.00]; NEURAL_HAM_SHORT(-0.98)[-0.981]; NEURAL_SPAM_LONG(0.33)[0.328]; ONCE_RECEIVED(0.20)[]; R_SPF_ALLOW(-0.20)[+a]; NEURAL_SPAM_MEDIUM(0.10)[0.102]; MIME_GOOD(-0.10)[text/plain]; ARC_NA(0.00)[]; ASN(0.00)[asn:24940, ipnet:5.9.0.0/16, country:DE]; MIME_TRACE(0.00)[0:+]; RCVD_COUNT_ONE(0.00)[1]; MID_RHS_MATCH_FROM(0.00)[]; R_DKIM_NA(0.00)[]; MLMMJ_DEST(0.00)[freebsd-current@freebsd.org]; FROM_EQ_ENVFROM(0.00)[]; FROM_HAS_DN(0.00)[]; RCPT_COUNT_ONE(0.00)[1]; TO_DN_NONE(0.00)[]; DMARC_NA(0.00)[g-cipher.net]; TO_MATCH_ENVRCPT_ALL(0.00)[]; RCVD_TLS_ALL(0.00)[] Hello all, I recently had a bit of trouble finding the proper make targets to build and install the base FreeBSD system from source into an empty directory for use in a jail.  I had scoured the build(7) manual trying to find the right workflow, but was unable to come up with a solution based solely on the information available. After some discussion on the forum it was discovered that the answer was in fact in the jail(8) manual, under the Examples section.  However, the make targets listed in the jail(8) manual are not documented in the build(7) manual.   I'd like to open a discussion around updating the documentation to make the correct information easier to find.  Specifically:   * Should the 'world' and 'distribution' targets, and examples of their use, be included in the build(7) manual?   * Is the workflow listed in the jail(8) manual currently correct?  Should it cross-reference the build(7) manual?  Is there a way to make the information more discoverable?   * Is it worth adding these instructions, or a reference to them, to the Handbook? For reference, the original discussion is here: https://forums.freebsd.org/threads/installing-world-into-an-empty-jail.97866/ My intent is to file PRs for any changes and, if it would be helpful, draft edits. Thanks, Bill