Date: Thu, 22 May 2025 06:05:02 +0000 From: "Dave Cottlehuber" <dch@FreeBSD.org> To: freebsd-current <freebsd-current@freebsd.org> Cc: "Alexander Ziaee" <ziaee@freebsd.org> Subject: Re: Updating build and jail manual pages to include missing or obscure information Message-ID: <2d6ef406-2a4e-4876-b784-e9ad5a0e11be@app.fastmail.com> In-Reply-To: <c7ce0bcc-3d65-476d-9ffb-b9faec044489@g-cipher.net>
index | next in thread | previous in thread | raw e-mail
On Tue, 20 May 2025, at 21:17, Billiam Crashkopf wrote: > 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 Hi Bill yes to all of those I think. I believe Alex is doing some work in this area already, I'm happy to help as a reviewer btw despite my lack of knowledge of manpage macros. A+ Davehome | help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?2d6ef406-2a4e-4876-b784-e9ad5a0e11be>